安装与使用指南 // 4 步安装 · 8 阶段流程
完整安装 + 使用指南

部署 // 运行

30 秒装好 pm-incubator + 8 阶段使用流程。
每段含命令 + TG 对话样例 + 你做什么 / bot 做什么。

一键安装 + 自检

两条路任选:A 复制 v4 提示词让 Claude 帮你装齐;B 下面 6 步手动跑。

// 路径 B · 手动 · 6 步分别跑
01

装 deanpeters PM Skills(必装)

⚠ phuryn 和 deanpeters 的 marketplace 都叫 pm-skills,CC 2.1.x 不支持别名 —— 同时装会冲突。默认只装 deanpeters(提供 /develop 依赖的 prd-development),phuryn 标可选见下方注释。

claude plugin marketplace add deanpeters/Product-Manager-Skills
claude plugin marketplace update pm-skills    # 强制拉最新源,防 cache 过期

# pm-incubator role-* 调用的 5 个核心 skill
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

# 还有 ~40 个独立 skill plugin 按需装:
# claude plugin install product-strategy-session@pm-skills
# claude plugin install discovery-process@pm-skills
# claude plugin install lean-ux-canvas@pm-skills

5 个 deanpeters skill 启用;按 description 自动触发

02

装 pm-incubator(必装)

必须先 update marketplace:CC 的 add 命令在 marketplace 已存在时不会自动 git pull,所以 install 时可能用 cache 过期版本(踩到 plugin.json author 类型旧 bug)。

claude plugin marketplace add hongnono-wdh/pm-workflow-landing
claude plugin marketplace update pm-workflow-landing    # 强制拉最新源
claude plugin install pm-incubator@pm-workflow-landing

33 skills + 4 slash commands(/council /council-add /marks /synthesize)启用

03

phuryn/pm-skills(可选 - 会冲突)

如果你想要 phuryn 的 8 个大 plugin(pm-product-strategy / pm-execution / pre-mortem 等),必须先 remove deanpeters marketplace(会卸载已装 plugin),再走 phuryn → 再重 add deanpeters。否则跳过本步。

# 1. 临时移除 deanpeters marketplace(注意:会卸载已装 plugin)
claude plugin marketplace remove pm-skills

# 2. 装 phuryn 全套(一次性)
claude plugin marketplace add phuryn/pm-skills
claude plugin install pm-product-strategy@pm-skills
claude plugin install pm-execution@pm-skills
# ... 其他 6 个 sub-plugin 按需装

# 3. 重新 add deanpeters + 重装 5 个核心
claude plugin marketplace add deanpeters/Product-Manager-Skills
claude plugin install prd-development@pm-skills
# ... 上面 step 01 的 5 条

phuryn 的 plugin 在 plugin list 显示 failed to load(marketplace 引用被 deanpeters 顶替),SKILL 文件保留在 cache 中

04

配置 hermes pmbot 采集器

⚠ 分工:Hermes = 采集 + 调度(TG 入口 / cron),Claude Code = 分析 + 产物(33 skills 跑议事)。 所以 Hermes 不装 plugin,而是链接一个**轻量采集器提示词**(只跑 PHASE A 5-Gate + /marks callback + cron 触发调 cc)。

# 0. 提前建好 cron 工作目录(hermes 调 claude 的 cwd)
mkdir -p ~/code/pmbot

# 1. curl 拉 collector 提示词到 SOUL.md(不需要 clone 仓库)
mkdir -p ~/.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

# 2. 凭证 — 用工具自带流程,不要手写 .env
# CC 端登录(OAuth):
claude login

# Hermes 端如果真需要 API key:
hermes setup --profile pmbot       # 交互式配 API key

# TG gateway(可选 - 想 TG 推送时):
hermes setup gateway --profile pmbot   # 交互式问 BotFather token + chat_id
hermes gateway test telegram

# 3. pmbot 性能调优(强烈推荐)
hermes --profile pmbot
# 进入 interactive 后逐个跑:
#   /fast fast        # fast mode
#   /think xhigh      # 推理强度最高
#   /yolo on          # 自动确认 tool 调用
# 退出:Ctrl+D 或 /exit

# 4. 加 MCP servers(仅 mac STAGE 2 桌面自动化用)
hermes mcp add macos-automator npx -y @steipete/macos-automator-mcp
# AdsPower MCP 见官方:https://www.adspower.com/blog/adspower-local-api-mcp-server

SOUL.md curl 下载到 ~/.hermes/profiles/pmbot/(普通文件,不软链) / ~/code/pmbot/ 已建

05

配置 hermes → claude code 桥(cron 调度 · 防 TG 刷屏)

核心 bug 修复claude -p 是 streaming 输出,每个 sub-agent 完成都吐一段 → 不重定向 hermes 会把每段当独立 TG 消息(council 会推 7+ 条)。
正确架构:wrapper 把 claude stdout 静默到 log,只在最后 echo 一次 final summary → hermes 推一条 TG。

# 1. 建包装脚本(每个 wrapper 静默 claude streaming,只输出 final summary)
mkdir -p ~/.hermes/scripts ~/code/pmbot/logs

# 示例:pmbot_council.sh(其他 3 个同模式,按 cmd 类型组装 summary)
cat > ~/.hermes/scripts/pmbot_council.sh <<'EOF'
#!/bin/bash
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
cd ~/code/pmbot
LOG=~/code/pmbot/logs/council_$(date +%Y%m%d_%H%M%S).log
if claude -p '/council weekly' --dangerously-skip-permissions > "$LOG" 2>&1; then
  echo "✓ /council weekly 完成 · $(date +%H:%M)"
  CON=~/code/pmbot/projects/weekly/council/consensus.md
  [ -f "$CON" ] && { echo ""; echo "Top 5 关键分歧:"; grep -A 1 '^## D-' "$CON" | head -15; }
  echo ""; echo "下一步: /marks weekly"
else
  echo "❌ /council 失败"; tail -10 "$LOG"
fi
EOF
chmod +x ~/.hermes/scripts/pmbot_council.sh

# 同样模式建 digest / synthesize / iterate(按 cmd 类型组装 summary)
# 完整 4 个 wrapper 模板见 v4 提示词 Group 7

# 2. 加 4 条 cron(v0.13+ 语法)
hermes cron add --schedule "0 14 * * 2" --script ~/.hermes/scripts/pmbot_digest.sh --no-agent      # 周二
hermes cron add --schedule "0 14 * * 3" --script ~/.hermes/scripts/pmbot_council.sh --no-agent     # 周三
hermes cron add --schedule "0 14 * * 5" --script ~/.hermes/scripts/pmbot_synthesize.sh --no-agent  # 周五
hermes cron add --schedule "0 */6 * * *" --script ~/.hermes/scripts/pmbot_iterate.sh --no-agent    # 每 6h

hermes cron list 看到 4 条;触发后 hermes 收到一次 final summary → TG 推一条消息(不再刷屏)

06

启动 + 下一步引导

Hermes 后台监听 + 3 选 1 试用

# 1. 启动 Hermes daemon
hermes start --profile pmbot

# 2. 验证连通(不是 grep .env,是真调用)
echo "hi" | claude -p "say one word" --max-turns 1     # 看到回复 → CC ✓
hermes profile show pmbot                              # 看到 profile info → Hermes ✓

# 3a. 想 TG 推送 → 配 gateway
hermes setup gateway              # v0.13+ 交互式
hermes gateway test telegram      # 测推送

# 3b. 不用 TG → 直接试跑 /council
cd ~/code/pmbot && claude
# 进入后输入:/council 想做一个 AI 周报工具
# 30-60s 看到 5 角色议事 + Top 5 分歧

# 3c. 跳过 TG,直接看 markdown 产物
cat ~/code/pmbot/projects/{slug}/council/consensus.md

a) TG 配好 → "测试 #demo" 回 "✓ #demo";或 b) 直接 /council 跑出 mindmap;或 c) 命令行读 ~/code/pmbot/projects/...

完整使用流程 // 8 阶段

TG 里就能完成大部分。点开任意阶段看完整对话样例。第一次走完约 30-60 分钟。

01
阶段 A · 收纳
同步零散想法(最高频)

就 1 件事:在 TG 跟 pmbot 聊天。文字、语音、图片、链接都行。5 个 Gate 在背后自动工作,你不用关心。

想做一个给独立开发者的 AI 周报工具 #proj-weekly
#weekly
(语音)每周复盘是痛点,但 Notion 写不下去
#weekly(Whisper 转文字 + 落库)
怕 Substack 已经做了
#weekly polarity=negative(不进 digest)
今天天气真好哈哈
✓(识别为闲聊,落 __inbox__

想到就说,30 秒不到完成一条。落库到 ~/code/pmbot/inbox.db

02
阶段 B · 临界判定
让 LLM 判断"够熟没"
/digest weekly

LLM 自动扫 inbox.db 排除 noise → 算 value × confidence / cost → ≥4 推给你。3-4 分边界带 AskUser。

/digest weekly
📊 #weekly 攒了 12 条,6 条达 ripeness ≥4:
O-1 用户痛点:每周复盘但 Notion 写不下去 (3×3/1 = 9)
O-3 商业假设:免费给周报,付费拉历史 (2×2/2 = 2,未到 4)
...
边界带 2 条要你拍:
· 是否做"自动从 GitHub 抓 commit + PR" → keep / skip ?
03
阶段 C · 多角色议事 // v4 新增
召集 5 角色虚拟产品部门
/council weekly /council add growth

5 角色(PM / 用研 / 工程 / 设计 / 红队)Agent Teams 真辩论:Round 1 TeamCreate + 单 message 并行 Agent spawn 5 个 agent → Round 2 SendMessage 真互通交叉点评(agent 持久化记得上轮)→ Round 3 summarizer 汇总 → TeamDelete。议题需要时随时 /council add 召唤额外角色。

/council weekly
🏛 council 启动 #weekly

📡 TeamCreate council-weekly
⚡ Round 1:单 message 并行 Agent spawn 5 个 → 30-60s 并行立场
💬 Round 2:SendMessage 真互通交叉点评(agent 复用上下文)
🧠 Round 3:summarizer 汇总
🧹 TeamDelete 清理

完成(共 12 条发言)
📌 Top 5 关键分歧(D-1..D-5)
✅ 已达成共识(C-1..C-3)
📝 下一步:/marks weekly

team mode 失败自动降级串行,必推 ⚠ 降级 不静默。

04
阶段 C · 标记观点
TG 里逐条标记关键观点
/marks weekly

bot 逐条推发言,每条挂 8 按钮: 关键 功能 商业 技术 假设 入图

[s_1_001] role-pm 立场:
"我判断这个想法值得做..."

[👍][⭐][🔑][🛠][💰][⚙][❓][🌳]
点 [🔑] [🌳]
✓ s_1_001 标记:key, mindmap
/mark s_1_007 feature,key
✓ s_1_007 标记:feature, key
/marks weekly done
✅ 标记完成(共标 23 处)
📝 下一步:/synthesize weekly
05
阶段 C · 产物
自动出思维导图 + PRD 证据包
/synthesize weekly

3 个生成器并行(无相互依赖),通常 30 秒内出完。devil-advocate 的发言自动加 ⚠ 前缀方便扫雷。

⚙ 3 生成器并行...
mindmap.md(mermaid mindmap)
logic.md(mermaid flowchart)
evidence_pack.md(5 段 markdown 喂给 /develop)

📊 mindmap 预览:[PNG]
📁 ~/code/pmbot/projects/weekly/council/
📝 下一步:/develop weekly
06
阶段 1 · PRD
PM 主笔写 PRD(吃证据包)
/develop weekly

PM agent 主笔,evidence_pack.md 作为 --context。其他 4 角色做 reviewer 投票,≥3 票通过才进 STAGE 2。

📝 PM agent 主笔,吃 evidence_pack 写 PRD...
PRD.md 草稿就绪,4 reviewer 投票:
· user-need:✅ 通过
· tech-arch:⚠ 反对("vector db 维护成本被低估")
· interaction:✅
· devil-advocate:✅

3/4 通过,已过 Gate 5 schema,进入 STAGE 2。

v4 schema 强制 north_star + hypothesis[](带 falsification)+ success_metric

07
阶段 2 · 原型
出原型图(claude.design)
/handoff weekly

AdsPower MCP 启动已登录 Chrome profile + macos-automator AppleScript 控制 Chrome 上传 design-brief.md → claude.design 出原型 → verify URL → 推 TG。

🎨 启动 AdsPower 已登录 profile...
🤖 AppleScript 控 Chrome 打开 claude.design...
📤 上传 design-brief.md...
✅ verify URL = claude.design/artifact/abc123 ✓
🔗 已发到 TG,转发开发同事即可

selector 抽 yaml 配置;URL 不匹配视为失败,自动告警。

08
阶段 3 · 持续迭代
Hermes cron 自动巡查
hermes schedule create "0 */6 * * *" "pm-iterate weekly"

每 6 小时自动跑:外部巡查(竞品/社区)+ 内部数据(自家埋点)→ 异常自动写回 inbox。PRD 改动必先 AskUser,不静默改。

[02:00] 🌙 cron 跑 weekly:
· Substack 上周新增 weekly digest 功能(外部,注意)
· 自家 GitHub repo weekly engagement 上涨 8%(内部)
已写回 #weekly inbox 2 条 → /digest 时合并考虑

完整 ADR 落 decisions.md,决策可追溯。

FAQ // 常见问题

?1
// 帮助
/council 跑了一半超时怎么办?

每个角色 90 秒超时,超时不卡其他 agent。如果 TeamCreate / Agent / SendMessage 任一抛错 → 自动降级为串行模式(一次 council 内只降级一次)。bot 会推 ⚠ council 降级为串行模式,沿用 §灵魂"失败必显性"。常见原因:CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS 未配 / Anthropic API 429 / 配额。

?2
// 帮助
/digest 总说"还不够熟" 怎么办?

说明 value × confidence / cost < 4。可以:(a) 多收集证据(提 confidence);(b) 找成本更低的验证方式(降 cost);(c) 边界带(≥3)AskUser 时直接 keep。

?3
// 帮助
非 macOS 用户 STAGE 2 怎么办?

macos-automator + AppleScript 是 macOS-only。Linux/Windows 用户需手动拖 design-brief.md 到 claude.design。/handoff 改为只输出 design-brief.md,不调用桌面自动化。

装好了?回主页看看 PM_WORKFLOW 全貌

主页有评分对照、工作流四阶段、AI Council 5 角色等概念介绍。