my pm tools

我的PM工具

英语

产品愿景

待完成的工作：PM立即使用自然语言管理GitHub ProjectsV2和读写Notion Google Workspace

在套件中定位: requirements_designer → speckit-bridge → **my_pm_tools** → pm-data-analysis。规格固定后的执行管理层。

______________________________________________________________________

🛡️ PM操作员Stance—作为最后堡垒的自我纪律（最重要）

在并行Claude Code会话运营（多个session并行分担任务）中，每个session都是在scope discipline中集中在自己范围内的设计。结果，与其他session的一致性、scope波及、launch blocker横向串管理都集中在PM会话中。

PM作为最后的堡垒比全session更严格、更勤奋地继续追求全artifact（代码/两个报告/docs/worktree/PR）的责任承担。

7原则（详情见 技能.md 参考开头部分）

1. MVP价值×工时成本判断 — 技術的正当性 ≠ 着手価値、工数 ≫ MVP 価値なら却下 or Post-MVP 延期
2. “基本慎重”是baseline —不盲信session自我报告gh pr checks / git diff 实测cross-check
3. 比全session更勤奋的俯瞰 —每回合运行7点监视查询
4. 自我验证 —自问是否存在未设置完整性间隙/私有/孤立工作树/migration编号冲突
5. 明确介入判断 —介入完整性风险、scope脱离、HARD门违规，不介入实施详细判断
6. 沟通质量 —SSOT为Issue body/Project field，提示仅为orchestration，较薄
7. 自我批评的习惯 —立即纠正错误判断，将user critique memory化，防止再次发生

相关文档

• 技能.md -PM Operator Stance正文（开头部分）
• 博奇备忘录： ~/.claude/bochi-data/memos/2026-04-21-pm-last-line-of-defense-stance.md（包括网罗版、判断模板+反模式）

______________________________________________________________________

GitHub Projects V2的PM支援技能。集成支持环境构建、日常操作、Sprint分析和迁移

“Issue制作”、“改变状态”、“Sprint报告”—在CLI中执行PM的日常操作。从统一构建新的项目到从Jira/Linear迁移。

三种模式

模式｜用途｜主要操作｜ | ---------------------- | --------------------------------------------- | ------------------------------------------------------------------- | | 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  
 --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经典PAT(ghp_ 标记）—Fine-grained PAT不支持Projects V2GraphQL 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  

日常运用（Mode B）

# Issue/PR をプロジェクトに追加
./scripts/project-ops.sh   add-issue  
./scripts/project-ops.sh   add-pr  

# ステータス変更（カード移動）
./scripts/project-ops.sh   move  "開発中"

# Priority 設定
./scripts/project-ops.sh   set-priority  P1

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

分析报告

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

也可以通过MCP Server sprint 在动态输入提示中 current / previous /可指定Sprint标题。200+项目的项目在光标页面（最多20页）中全部获取。

从其他工具迁移

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

构建的环境

脚本列表

｜脚本｜模式｜用途｜ | -------------------- | ------ | ------------------------------------------ | | setup-all.sh | A |全环境一括构筑| | setup-labels.sh ｜A｜统一制作13种标签｜ | setup-fields.sh 设置自定义字段 | setup-status.sh 设置选项 | setup-views.sh 5视图创建（Lite:3视图） | setup-templates.sh ｜A｜模板＆工作流自动部署｜ | project-ops.sh B/Issue/PR添加状态更改优先级设置 | migrate-import.sh | A | Jira/Linear/Notion CSV 移行 | | sprint-report.sh 速度报告（速度完成率）

MCP服务器

可以通过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_..." }
    }
  }
}

刀具列表

工具｜方式｜说明｜ | -------------------------- | ----------------- | -------------------------------------------------------------------- | | project_list_fields 字段选项列表 | project_list_items 项目列表（启用状态/优先级筛选器，分页） | project_add_item 将图形QL/Issue/PR添加到项目中 | project_move_status 状态更改（别名对应：“dev”→“开发中”） | project_set_priority | GraphQL |优先度设定（P0-P4）| | project_sprint_report 图形QL生成Sprint报告 | project_get_issue 获取详细信息（标题、正文、标签、分配、里程碑） | project_create_issue 新建（日语标题、正文对应） | project_edit_issue 编辑标题和正文 | project_manage_labels 添加/删除标签 | project_manage_assignees 添加/删除签名 | project_set_issue_state 关闭并重新打开gh CLI | notion_search ｜Notion API｜Notion页数据库搜索｜ | notion_get_page ｜Notion API｜获取页面内容（Markdown转换）｜ | notion_query_database 否API：数据库查询（筛选器排序） | notion_create_page ｜Notion API｜创建页面｜ | notion_append_blocks ｜Notion API｜块追记｜ | workspace_search_drive ｜驱动器API｜驱动器文件搜索｜ | workspace_get_doc 谷歌文档获取（Markdown） | workspace_get_sheet 表格API获取电子表格数据 | workspace_get_slides ｜驱动器API｜获取幻灯片（文本）｜ | workspace_list_events ｜日历API｜获取日历事件｜ | workspace_search_gmail ｜Gmail API｜邮件搜索｜ | workspace_update_sheet 表格API电子表格单元格写入 | workspace_append_sheet 表格API添加电子表格行 | workspace_create_event 日历API：创建日历事件 | notion_update_page 更新页面属性 | notion_archive_page \\u0026##Notion API \\u0026#页面存档（删除）\\u0026# | project_scan_zombies 僵尸Issue检测（已安装但仍为Open的Issue候选人提供证据） | project_scan_todos 收集代码中的TODO/FIXME/HACK/XXX，并建议Issue化 | project_backlog_report 积压运行状况分数（0-100）和报告生成

状态别名（11种）：可以用英语的省略形式操作日语状态。

解决顺序：完全匹配-别名匹配-部分匹配（忽略大小写）。

文档

文档｜内容｜ | --------------------------------------------------- | ------------------------------------ | | 操作指南（USAGE.md） ｜日常操作视图快速迁移常见问题解答｜ | 工作流定义 14状态的详细规格 | 视图设计 5视图的设置规格 | 自动化指南 设置工作流脚本的步骤 | 工作区桥 《Notion+Google Workspace协作指南》

开发人员

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

前提条件：Node.js20+，ShellCheck（可选）。了解更多信息 贡献.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工具套件

此存储库是Claude Code中可自动化PM工作流的5个工具套件的一部分。

管道

requirements_designer → speckit-bridge → my_pm_tools (project tracking)
                              |
                    pm-data-analysis ← pm-ad-analysis

推荐安装顺序

1. my_pm_tools （基盘—GitHub Projects环境构筑）
2. 需求_设计者 （上流—要件定义）
3. speckit电桥 （变换—要件→仕样）
4. pm数据分析 （分析-数据驱动决策）
5. pm广告分析 （广告-多渠道优化）

许可证

ISC许可证。看 许可证 了解详情。