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)
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。仕様が固まった後の実行管理レイヤー。
並行 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/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 Advocatereferences/spec-quality-gate.md— 5 項目 Boolean ゲートreferences/self-evaluation-protocol.md— CALM 12 バイアス checklist + Reflexion 儀式
v5.3.0 の 7 原則は 精神的に保存 され、12 原則に包摂されています。7 原則を既に内面化していれば、12 原則は同じ理念に citation / reversal / measurement を追加したもので、リセットではありません。詳細は SKILL.md の「Non-destructive upgrade note」参照。
| モード | 用途 | 主な操作 |
|---|---|---|
| Mode A: 環境構築 | 新規プロジェクトのセットアップ | 14ステータス・5ビュー・13ラベル・テンプレート・ワークフロー一括構築 |
| Mode B: 日常運用 ★ | Issue/PR 作成、ステータス変更、バックログ管理 | project-ops.sh + 自然言語対話 |
| Mode C: 分析 | Sprint レポート、ベロシティ追跡 | sprint-report.sh |
--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回目以降は即座に操作可能です。
ghCLI がインストール済み＆認証済み- 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 レポートを出して」
./scripts/setup-all.sh <OWNER/REPO> <PROJECT_NUMBER># 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./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 レポート（ベロシティ・完了率） |
AI エージェント（Claude Code, GitHub Copilot 等）から MCP 経由でプロジェクト操作を実行できます。
npm install && npm run buildClaude Desktop の設定 (~/.claude/settings.json または MCP 設定):
{
"mcpServers": {
"my_pm_tools": {
"command": "node",
"args": ["/path/to/my_pm_tools/dist/index.js"],
"env": { "GITHUB_TOKEN": "ghp_..." }
}
}
}| ツール | 方式 | 説明 |
|---|---|---|
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 |
要件→仕様変換ブリッジ |
このリポジトリは、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 |
requirements_designer → speckit-bridge → my_pm_tools (project tracking)
|
pm-data-analysis ← pm-ad-analysis
- my_pm_tools (基盤 — GitHub Projects 環境構築)
- requirements_designer (上流 — 要件定義)
- speckit-bridge (変換 — 要件→仕様)
- pm-data-analysis (分析 — データ駆動意思決定)
- pm-ad-analysis (広告 — マルチチャネル最適化)
ISC License. See LICENSE for details.