Skip to main content
Glama

My PM Tools

English · v5.4.0 — AI 時代の PM Operator Stance 搭載

GitHub Projects V2 の PM 支援スキル。環境構築・日常運用・Sprint 分析・移行を統合サポート。「Issue を作成して」「ステータスを変更」「Sprint レポート出して」等の自然言語で gh CLI + GraphQL + Notion + Google Workspace を束ねて実行します。

31 MCP ツール / 9 shell scripts / 536 tests / 6 references docs (12 principles + 30 anti-patterns + Cynefin + Premortem + Spec Quality Gate + CALM self-evaluation)

Product Vision

JTBD: PM が GitHub Projects V2 の管理と Notion・Google Workspace の読み書きを自然言語で即実行する

Field

Definition

Target User

個人〜小規模チーム(1-10人)の PM / テックリード。特に並行 AI コーディングエージェントを束ねる PM。

Core Value

GraphQL API + Notion API + Google APIs の複雑さを吸収し、CLI で完結。外部ドキュメント・スプレッドシート・カレンダーの双方向連携

Scope

Mode A(Setup), Mode B(Daily Ops), Mode C(Analytics), Migration, Workspace Bridge(Read+Write), PM Operator Stance

Non-Goals

GUI構築, マルチOrg対応, Slack連携自前実装, Jira/Linear完全代替, Gmail送信

Suite内の位置づけ: requirements_designer → speckit-bridge → **my_pm_tools** → pm-data-analysis。仕様が固まった後の実行管理レイヤー。


🛡️ PM Operator Stance — AI 時代の PM 自己規律(12 原則 / v5.4.0)

並行 AI コーディングエージェント(Claude Code / Cursor / Devin / Aider 等)を束ねる運用では、PM の役割は「ロードマップ責任者」よりも 最後の砦としての coordinator(インシデントコマンダーに近い) に寄ります。Multi-Agent System Taxonomy (MAST, UC Berkeley 2025) は multi-agent failures のうち 41.77% が spec 層、36.94% が coordination 層、21.30% が verification 層 で起きると報告しています。古典 PM 正典は必要だが、この 3 層攻略には不十分です。

12 原則は Amazon / Google SRE / DORA / Cagan / Perri / Torres / Klein / Snowden / Taleb / Meadows / Anthropic / MAST / CALM 等 200+ 文献の統合から導出され、各原則が (a) 出典 / (b) 適用しない条件 (reversal) / (c) 測定方法 を持ちます。reversal 無き原則はドグマ。

12 原則(要約 — 詳細は SKILL.md 「PM Operator Stance」章、および references/

#

原則

主な attack 先

P1

Outcomes over outputs

velocity 盲信

P2

Cynefin-aware routing

過剰/過小エンジニアリング

P3

Chain-of-Verification over self-report trust

MAST verification layer

P4

Premortem before commit

盲点リスク

P5

Blameless postmortem + Just Culture

再発・second victim

P6

Working Backwards artifact as SSOT

MAST spec layer / prompt bloat

P7

Error Budget / SLO-first

over-shipping / freeze discipline

P8

Trunk-Based + small PRs + fast CI

merge race / long branches

P9

Leverage-point prioritization

parameter 癒着修正

P10

Antifragile posture, convex bets

irreversible risk

P11

Continuous Discovery (human cadence)

AI が delivery 加速→ discovery 枯渇

P12

LNO triage + CALM bias audit

PM 自身の 12 認知バイアス

関連ドキュメント(references/)

Non-destructive upgrade note

v5.3.0 の 7 原則は 精神的に保存 され、12 原則に包摂されています。7 原則を既に内面化していれば、12 原則は同じ理念に citation / reversal / measurement を追加したもので、リセットではありません。詳細は SKILL.md の「Non-destructive upgrade note」参照。


3つのモード

モード

用途

主な操作

Mode A: 環境構築

新規プロジェクトのセットアップ

14ステータス・5ビュー・13ラベル・テンプレート・ワークフロー一括構築

Mode B: 日常運用

Issue/PR 作成、ステータス変更、バックログ管理

project-ops.sh + 自然言語対話

Mode C: 分析

Sprint レポート、ベロシティ追跡

sprint-report.sh

Lite モード(小〜中規模チーム向け)

--lite フラグで、1-3人チーム向けの簡素構成を構築できます:

./scripts/setup-all.sh <OWNER/REPO> <PROJECT_NUMBER> --lite

構成

ステータス

ビュー

ラベル

推奨チーム規模

Lite

8

3

5

1-3人

Full (デフォルト)

14

5

13

4人以上

Lite → Full への移行はいつでも可能(setup-all.sh--lite なしで再実行)。

初回起動時にプロジェクト状態を自動検出し、未構築なら Mode A、構築済みなら Mode B で起動します。プロジェクト情報は .github-project-config.json に保存され、2回目以降は即座に操作可能です。

前提条件

  • gh CLI がインストール済み&認証済み

  • GitHub Classic PAT(ghp_ トークン)— Fine-grained PAT は Projects V2 GraphQL API 非対応

  • PAT スコープ: project, repo, read:org

インストール

git clone git@github.com:fideguch/my_pm_tools.git
cd my_pm_tools
./install.sh    # ~/.claude/skills/my_pm_tools/ にインストール

Claude Code または Devin で以下のように起動:

「Issue を作成して」「プロジェクト環境を構築して」「Sprint レポートを出して」

クイックスタート

新規プロジェクト構築(Mode A)

./scripts/setup-all.sh <OWNER/REPO> <PROJECT_NUMBER>

日常運用(Mode B)

# Issue/PR をプロジェクトに追加
./scripts/project-ops.sh <OWNER> <NUMBER> add-issue <REPO> <ISSUE_NUM>
./scripts/project-ops.sh <OWNER> <NUMBER> add-pr <REPO> <PR_NUM>

# ステータス変更(カード移動)
./scripts/project-ops.sh <OWNER> <NUMBER> move <ITEM_ID> "開発中"

# Priority 設定
./scripts/project-ops.sh <OWNER> <NUMBER> set-priority <ITEM_ID> P1

# アイテム一覧
./scripts/project-ops.sh <OWNER> <NUMBER> list-items

分析・レポート(Mode C)

./scripts/sprint-report.sh <OWNER> <NUMBER>                        # 現在の Sprint
./scripts/sprint-report.sh <OWNER> <NUMBER> --sprint previous      # 前回の Sprint
./scripts/sprint-report.sh <OWNER> <NUMBER> --sprint "Sprint 3"    # タイトルで指定
./scripts/sprint-report.sh <OWNER> <NUMBER> --json                 # JSON 出力

MCP Server 経由の場合も sprint パラメータで current / previous / Sprint タイトルを指定可能。200+ アイテムのプロジェクトはカーソルページネーション(最大20ページ)で全件取得。

他ツールからの移行

./scripts/migrate-import.sh <OWNER/REPO> <NUMBER> export.csv --format jira     # Jira
./scripts/migrate-import.sh <OWNER/REPO> <NUMBER> export.csv --format linear   # Linear
./scripts/migrate-import.sh <OWNER/REPO> <NUMBER> export.csv --format notion   # Notion
./scripts/migrate-import.sh <OWNER/REPO> <NUMBER> tasks.csv --dry-run          # プレビュー

構築される環境

要素

内容

ステータス

14段階(Icebox → Planning → Design → Dev → Release → Done)

ビュー

5種(Product Backlog, Sprint Board, Sprint Table, Roadmap, My Items)

カスタムフィールド

Priority (P0-P4), Sprint (1w Iteration), Estimate (Number), Target (Text)

ラベル

13種(Type 6 + Area 4 + Ops 3)

テンプレート

Issue (feature/bug) + PR テンプレート

自動化

Built-in Workflows 5 + GitHub Actions 5

スクリプト一覧

スクリプト

モード

用途

setup-all.sh

A

全環境一括構築

setup-labels.sh

A

ラベル13種一括作成

setup-fields.sh

A

カスタムフィールド作成

setup-status.sh

A

Status 14オプション設定

setup-views.sh

A

5ビュー作成(Lite: 3ビュー)

setup-templates.sh

A

テンプレート&ワークフロー自動配置

project-ops.sh

B

Issue/PR追加・ステータス変更・Priority設定

migrate-import.sh

A

Jira/Linear/Notion CSV 移行

sprint-report.sh

C

Sprint レポート(ベロシティ・完了率)

MCP Server

AI エージェント(Claude Code, GitHub Copilot 等)から MCP 経由でプロジェクト操作を実行できます。

セットアップ

npm install && npm run build

Claude Desktop の設定 (~/.claude/settings.json または MCP 設定):

{
  "mcpServers": {
    "my_pm_tools": {
      "command": "node",
      "args": ["/path/to/my_pm_tools/dist/index.js"],
      "env": { "GITHUB_TOKEN": "ghp_..." }
    }
  }
}

MCP ツール一覧

ツール

方式

説明

project_list_fields

GraphQL

フィールド・オプション一覧

project_list_items

GraphQL

アイテム一覧(ステータス/優先度フィルタ対応、ページネーション)

project_add_item

GraphQL

Issue/PR をプロジェクトに追加

project_move_status

GraphQL

ステータス変更(別名対応: "dev"→"開発中")

project_set_priority

GraphQL

優先度設定(P0-P4)

project_sprint_report

GraphQL

Sprint レポート生成

project_get_issue

GraphQL

Issue 詳細取得(タイトル、本文、ラベル、アサイン、マイルストーン)

project_create_issue

gh CLI

Issue 新規作成(日本語タイトル・本文対応)

project_edit_issue

gh CLI

Issue のタイトル・本文を編集

project_manage_labels

gh CLI

Issue のラベル追加・削除

project_manage_assignees

gh CLI

Issue のアサイン追加・削除

project_set_issue_state

gh CLI

Issue のクローズ・リオープン

notion_search

Notion API

Notionページ・DB検索

notion_get_page

Notion API

ページ内容取得(Markdown変換)

notion_query_database

Notion API

データベースクエリ(フィルタ・ソート)

notion_create_page

Notion API

ページ作成

notion_append_blocks

Notion API

ブロック追記

workspace_search_drive

Drive API

Driveファイル検索

workspace_get_doc

Drive API

Googleドキュメント取得(Markdown)

workspace_get_sheet

Sheets API

スプレッドシートデータ取得

workspace_get_slides

Drive API

スライド取得(テキスト)

workspace_list_events

Calendar API

カレンダーイベント取得

workspace_search_gmail

Gmail API

メール検索

workspace_update_sheet

Sheets API

スプレッドシートセル書き込み

workspace_append_sheet

Sheets API

スプレッドシート行追加

workspace_create_event

Calendar API

カレンダーイベント作成

notion_update_page

Notion API

ページプロパティ更新

notion_archive_page

Notion API

ページアーカイブ(削除)

project_scan_zombies

gh CLI + grep/git

ゾンビIssue検出(実装済みだがOpenのままのIssue候補を証拠付きで提示)

project_scan_todos

gh CLI + grep

コード内TODO/FIXME/HACK/XXXを収集し、Issue化を提案

project_backlog_report

gh CLI + grep/git

バックログ健全性スコア(0-100)とレポート生成

ステータス別名(11種): 英語の省略形で日本語ステータスを操作可能。

Alias

解決先

Alias

解決先

dev

開発中

testing

テスト中

review

コードレビュー

done

Done

backlog

Backlog

icebox

Icebox

test-failed

テスト落ち

released

リリース済み

waiting

進行待ち

design

デザイン作成中

ready

開発待ち

解決順序: 完全一致 → エイリアス一致 → 部分一致(大文字小文字無視)。

ドキュメント

ドキュメント

内容

運用ガイド (USAGE.md)

日常運用・ビュー・Sprint・移行・FAQ

ワークフロー定義

14ステータスの詳細仕様

ビュー設計

5ビューの設定仕様

自動化ガイド

ワークフロー・スクリプトの設定手順

Workspace Bridge

Notion + Google Workspace 連携ガイド

開発者向け

npm install
npm test            # リグレッションテスト (502件)
npm run build       # MCP Server ビルド
npm run quality     # lint + typecheck + format:check

前提: Node.js 20+, ShellCheck(オプション)。詳細は CONTRIBUTING.md を参照。

サブスキル

スキル

用途

code-quality

ESLint + Prettier + Husky 導入

ci-cd-pipeline

GitHub Actions CI/CD パイプライン構築

typescript-best-practices

TypeScript 初期設定

git-workflow

ブランチ戦略 + Conventional Commits

project-setup-automation

プロジェクトセットアップ自動化

workspace-bridge

Notion + Google Workspace MCP 連携

pm-figjam-diagrams

FigJam ダイアグラム生成

speckit-bridge

要件→仕様変換ブリッジ

PM Tool Suite

このリポジトリは、Claude Code で PM ワークフローを自動化する5つのツールスイートの一部です。

#

Skill

Purpose

Repo

1

my_pm_tools

GitHub Projects V2 管理

this repo

2

requirements_designer

要件定義 + Figma UI生成

fideguch/requirements_designer

3

speckit-bridge

要件→仕様変換(品質ゲート≥70)

fideguch/speckit-bridge

4

pm-data-analysis

GAFA品質データ分析

fideguch/pm_data_analysis

5

pm-ad-operations

広告CSV分析(Google/Meta)

fideguch/pm_ad_operations

Pipeline

requirements_designer → speckit-bridge → my_pm_tools (project tracking)
                              |
                    pm-data-analysis ← pm-ad-analysis
  1. my_pm_tools (基盤 — GitHub Projects 環境構築)

  2. requirements_designer (上流 — 要件定義)

  3. speckit-bridge (変換 — 要件→仕様)

  4. pm-data-analysis (分析 — データ駆動意思決定)

  5. pm-ad-analysis (広告 — マルチチャネル最適化)

License

ISC License. See LICENSE for details.

A
license - permissive license
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
1dRelease cycle
2Releases (12mo)
Issues opened vs closed

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/fideguch/my_pm_tools'

If you have feedback or need assistance with the MCP directory API, please join our Discord server