完整安装 + 使用指南

部署 // 运行

装好 pm-incubator 只要 4 步、约 5 分钟，装完就能跑第一次 /oneshot。
Telegram 随手收想法、定时自动讨论是进阶可选——不配也不影响核心功能。

[▷ 4 步安装] [→ 使用流程] [⚙ 进阶 · TG 自动化]
// 安装

4 步装好 · 跑出第一次

逐步复制粘贴即可。嫌麻烦？也可以去主页复制 v4 完整提示词 粘贴到 Claude Code——AI 自动装齐一切（含进阶的 TG 自动化），全程只问你 2 次。

01

开启 Agent Teams 环境变量（多角色并行讨论必需）

RC=$([ -n "$ZSH_VERSION" ] || [ "$(basename "$SHELL")" = "zsh" ] && echo ~/.zshrc || echo ~/.bashrc); grep -q CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS "$RC" 2>/dev/null || echo 'export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1' >> "$RC"; export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1; echo "OK -> $RC"

输出 OK（自动判断你的 shell，不用管 bash 还是 zsh）

02

装 pm-incubator plugin

claude plugin marketplace add hongnono-wdh/pm-workflow-landing
claude plugin marketplace update pm-workflow-landing    # 必跑：add 不会自动拉最新
claude plugin install pm-incubator@pm-workflow-landing

36 skills + 6 slash commands（/oneshot /council /council-add /marks /synthesize /doctor）启用

03

跑 /doctor 自检

claude -p '/doctor'

16 项检测。只跑 /oneshot 的话，Hermes / cron / inbox.db / deanpeters 相关 ✗ 都可忽略——必须 ✓ 的只有：claude 版本、AGENT_TEAMS 环境变量、pm-incubator 已装

04

跑你的第一次 /oneshot（或 /council）

cd ~ && claude

进入 Claude Code 后输入（写得越具体越好：谁用 / 多少人 / 干什么 / 想要什么输出）：

/oneshot 5 个朋友每周打篮球，需要 app 签到 + 拍照 + 月底自动出"谁最积极"报告

10-15 分钟出 proposal.md（完整方案 + 16 条决策）。PM 想看多角色讨论：输入 /council 我想做 AI 周报工具，60 秒出 5 角色纪要

// 使用流程

核心 4 步 // 纯 Claude Code

不需要 TG、不需要 cron。点开任意步骤看对话样例。

01
出方案
/oneshot 一句愿景 → 完整方案（小白主路径）
/oneshot 5 个朋友每周打篮球，需要 app 签到 + 拍照 + 月底报告

5 个 AI 角色并行做默认决策，10-15 分钟出 proposal.md：①AI 理解的终态（不对就重跑）②16 条决策表（每条注明确信度 + 错了多贵）③完整方案（技术栈 / 工期 / 月成本）④必须你回答的 3 个问题。

/oneshot 5 个朋友每周打篮球…
✓ proposal.md 就绪（slug: bball-checkin）
16 条决策已拍板，3 个问题等你确认
想改某条 → /oneshot bball-checkin --revise "决策 #4 改成要做防作弊"

满意后想出 PRD → /develop {slug}（需先装 deanpeters，见进阶区）。

02
多角色讨论
/council 5 个 AI 专家替你吵一架（PM 路径）
/council 我想做 AI 周报工具 /council-add growth

产品经理 / 用户研究 / 技术架构 / 交互设计 / 红队批判 5 个角色：先并行各自表态，再互相点评（每人至少挑战一条别人的观点），最后汇总出共识与 Top 5 分歧。议题需要时 /council-add 随时召唤战略 / 竞品 / 商业 / 增长 / 风险角色。

/council 我想做 AI 周报工具
🏛 5 角色讨论完成（共 12 条发言）
📌 Top 5 关键分歧（D-1..D-5）
✅ 已达成共识（C-1..C-3）
📝 下一步：/marks weekly 标记你认同的观点

并行讨论需要步骤 01 的 AGENT_TEAMS 环境变量；没配会自动降级串行（慢 5-10 倍，会明确提示 ⚠ 不会装没事）。

03
标记 + 产物
/marks 标记观点 → /synthesize 出导图和证据包
/marks weekly s_007 feature,key /synthesize weekly

把你认同的发言标上类型（关键 / 功能 / 商业 / 技术 / 假设 / 入图）。配了 TG 的话是 8 按钮点选；没配 TG 用上面的命令式写法一样标。标完 /synthesize 并行出 3 个产物：

✅ mindmap.md（mermaid 思维导图，GitHub/Notion 直接渲染）
✅ logic.md（产品逻辑流程图）
✅ evidence_pack.md（PRD 证据包，每条观点带角色背书）
📝 下一步：/develop weekly
04
出 PRD
/develop 写 PRD（4 个角色投票评审）
/develop weekly

PM 角色主笔、自动吃进证据包，其余 4 角色做评审投票，≥3 票通过才算定稿（防自说自话）。PRD 强制带北极星指标、可证伪假设、成功指标三要素。

📝 PRD.md 草稿就绪，4 reviewer 投票：
· 用户研究 ✅ · 技术架构 ⚠ 反对（"维护成本被低估"）· 交互 ✅ · 红队 ✅
3/4 通过，PRD 定稿。

前置：deanpeters 的 5 个 PM skill + v4 提示词（/develop 由提示词定义），见下方进阶区第一条。

// 进阶 · 可选

TG 随手收想法 + 定时自动化

想要"路上想到点子发个 TG 消息就归档、每周自动讨论自动推结果"？配下面这套。推荐方式：复制 v4 提示词让 AI 自动配——以下手动步骤给想看细节的人。

A1
写 PRD 前置
装 deanpeters 的 5 个 PM skill（/develop 用）
 
claude plugin marketplace add deanpeters/Product-Manager-Skills
claude plugin marketplace update pm-skills
claude plugin install prd-development@pm-skills
claude plugin install discovery-interview-prep@pm-skills
claude plugin install jobs-to-be-done@pm-skills
claude plugin install customer-journey-map@pm-skills
claude plugin install prioritization-advisor@pm-skills

deanpeters 共 ~47 个独立 skill plugin，其余按需装。phuryn/pm-skills 与 deanpeters 的 marketplace 同名会冲突且 v0.3 起已非依赖——默认跳过，详见 pm-incubator/README。

A2
TG 采集
配 Hermes 采集器（TG bot 随手收想法）

分工：Hermes = 采集 + 调度（TG 入口 / cron），Claude Code = 分析 + 产物。Hermes 不装 plugin，只挂一份轻量采集器提示词。

mkdir -p ~/code/pmbot ~/.hermes/profiles/pmbot
curl -fsSL https://raw.githubusercontent.com/hongnono-wdh/pm-workflow-landing/main/prompts/pmbot-collector.prompt.md \
  -o ~/.hermes/profiles/pmbot/SOUL.md
claude login                            # CC 端 OAuth（不写 .env）
hermes setup --profile pmbot            # Hermes 真需要 API key 时交互式配
hermes setup gateway --profile pmbot    # 想 TG 推送时（BotFather token + chat_id）
hermes gateway test telegram

永远不手写 .env——凭证一律走 claude login / hermes setup 交互式流程。

A3
定时自动化
cron 桥接（每周自动讨论 + 推 TG 一条结果）

语法的唯一权威是 collector 提示词的 Group 6（prompt 模式——hermes 把命令喂给 agent，跑完只推一条 TG，不刷屏）。核心 4 条：

hermes cron add --schedule "0 14 * * 2" --profile pmbot "/digest weekly"      # 周二 算成熟度
hermes cron add --schedule "0 14 * * 3" --profile pmbot "/council weekly"     # 周三 5 角色议事
hermes cron add --schedule "0 14 * * 5" --profile pmbot "/synthesize weekly"  # 周五 出导图+证据包
hermes cron add --schedule "0 */6 * * *" --profile pmbot "/iterate weekly"    # 每 6h 巡查
hermes start --profile pmbot

每日 doctor 自检与 auto-update 两条可选 cron、prompt 模式不可用时的 wrapper 备选方案，见 v4 提示词 Group 7。验证：hermes cron list。

A4
TG 闭环长什么样
配好后的日常：发想法 → 自动讨论 → 推结果
想做一个给独立开发者的 AI 周报工具 #weekly
✓ #weekly（落库，文字/语音/链接都行）
[周二 14:00] 📊 #weekly 攒了 12 条，6 条够火候，已生成 digest
[周三 14:00] 🏛 5 角色讨论完成 · Top 5 分歧已推送 · 下一步 /marks weekly
（逐条点 8 按钮标记：🔑 关键 / 🛠 功能 / 💰 商业 / 🌳 入图…）
[周五 14:00] ✅ mindmap + evidence_pack 已生成，预览图已推送

想法攒够火候（AI 自动评分 ≥4）才会进入讨论，碎片多但价值低会被压住——避免拍脑袋立项。

// 故障排查

FAQ // 常见问题

?1
// 帮助
/oneshot 跑超过 20 分钟还没出 proposal？

20 分钟会自动中止并落日志 oneshot_fail_{ts}.log。重跑加 --roles=3 fast mode（6 分钟，省掉 2 个角色但核心质量保留）。

?2
// 帮助
/council 跑了一半超时 / 提示降级？

每个角色 90 秒超时，超时不卡其他角色。看到 ⚠ council 降级为串行模式 说明并行模式没起来——最常见原因是 CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS 没配（回安装步骤 01），其次是 API 限流。降级后功能不变，只是慢。

?3
// 帮助
环境哪里不对 / 装坏了？

跑 /doctor——16 项自检，每个 ✗ 附修复命令。plugin 装到旧版本？大概率是漏跑了 claude plugin marketplace update pm-workflow-landing（add 不会自动拉最新）。