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/）

• references/ai-pm-principles-research.md — 論文本体（Part 1-9 + 40+ 引用）
• references/anti-patterns.md — 30 アンチパターン watchlist（spec/coordination/verification/cognitive/process）
• references/cynefin-guide.md — 5 ドメイン判別と orchestration マッピング
• references/premortem-template.md — 5 分ルーチン + Devil's Advocate
• references/spec-quality-gate.md — 5 項目 Boolean ゲート
• references/self-evaluation-protocol.md — CALM 12 バイアス checklist + Reflexion 儀式

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

Recommended Install Order

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.