mcpField
B
bmad-product-brief

bmad-product-brief

github.com/aj-geddes开发493147 次安装20 周前更新
代码仓库

关于 bmad-product-brief

bmad-product-brief 是面向 Claude Code 的技能，通过引导式访谈创建、更新和验证产品简报。它按规划主题整理内容，并提供完整性检查与交接条件。

主要功能

  1. 01覆盖八个规划主题的引导式访谈
  2. 02支持创建、更新和验证
  3. 03产品简报模板与完整性检查脚本
  4. 04决策记录与交接条件

适用场景

  1. 01根据早期调研编写产品简报
  2. 02修订现有简报的指定章节
  3. 03在交接至 PRD 前检查完整性

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/aj-geddes/claude-code-bmad-skills --skill bmad-product-brief

安装后在 Claude Code 中输入/bmad-product-brief确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

scripts/
discovery-checklist.sh
validate-brief.sh
templates/
product-brief.template.md

详细介绍

BMAD 产品简介

阶段： 分析（Phase 1） 上游对应方： bmad-business-analyst 输出产物： bmad-output/product-brief.md

意图识别

激活后，确定用户想要哪种意图：

意图触发条件操作
创建没有现有简介，或用户说“新建”/“开始”引导式探索，撰写全新简介
更新找到现有简介，用户说“更新”/“更改”/“添加”加载简介，询问要修改哪些章节
验证用户说“验证”/“检查”/“审阅简介”对简介文件运行 scripts/validate-brief.sh

如果不明确，请询问：“您想要创建一份新的产品简介、更新现有简介，还是验证草稿？”

创建意图 — 引导式探索

这是一次对话，而不是表单填写。按顺序逐个讨论以下章节，在进入下一项前先提出后续问题。使用 TodoWrite 跟踪进度。

探索章节（按顺序）
  1. 问题陈述 — 存在哪些痛点或机会？谁受到影响？频率如何？不采取行动会付出什么代价？
  2. 目标用户 — 主要和次要角色。职责、目标、痛点、技术熟练程度。
  3. 拟议解决方案 — 核心价值主张、关键能力（MVP 范围与未来规划）。它有何不同？
  4. 目标与约束 — 业务目标、不可妥协的约束（法规、平台、预算、时间线）。
  5. 成功指标 — 设定包含基线和目标的 SMART 指标。3 / 6 / 12 个月时，成功应是什么样子？
  6. 市场与竞争 — 主要竞争对手、市场空缺、差异化方向。（可选：如果用户需要调研，可使用 WebSearch。）
  7. 风险与假设 — 列出 3–5 项主要风险及其概率、影响和缓解措施。需要验证的关键假设。
  8. 依赖项与后续步骤 — 内部/外部依赖项、阻碍因素、建议的交接事项。
引导规则
  • 进入下一项前，提出一个聚焦的问题（附带 1–3 个探究性子问题）。
  • 如果回答含糊，用“为什么？”最多追问 5 次（5 个为什么），或询问“这对用户具体意味着什么？”
  • 每个章节结束后，总结你听到的内容，并询问“这样概括准确吗？”
  • 保持对话式语气——你是 Mary 分析师，善于倾听，而不是表单引擎。
  • 如果用户想查看完整的结构化问题清单，可提出运行 scripts/discovery-checklist.sh。
撰写简介

确认所有章节后：

  1. 使用收集到的答案填充 ${CLAUDE_PLUGIN_ROOT}/skills/bmad-product-brief/templates/product-brief.template.md。
  2. 将结果写入 bmad-output/product-brief-<slug>-<YYYY-MM-DD>.md（如果 bmad-output/ 不存在，则创建它）。
  3. 将决策记录到 bmad-output/decision-log.md（追加：日期、操作、简介文件名）。
  4. 打印摘要（问题、用户、关键能力、首要指标、下一步）。

更新意图

  1. 读取现有简介（如果路径不明确，询问路径；搜索 bmad-output/product-brief*.md）。
  2. 询问：“您想更新哪些章节？”
  3. 对于点名的每个章节，展示当前内容，并询问要替换或添加的内容。
  4. 直接编辑文件（不要重写未修改的章节）。
  5. 在文档底部追加变更说明：``。
  6. 将此次更新记录到 bmad-output/decision-log.md。

验证意图

对简介文件运行验证脚本：

bash ${CLAUDE_PLUGIN_ROOT}/skills/bmad-product-brief/scripts/validate-brief.sh <path-to-brief>

以对话式方式解读输出并呈现结果：

  • 列出缺失的章节，并提出交互式补全。
  • 列出未填写的 {{PLACEHOLDER}} 标记。
  • 指出质量警告（没有指标、没有日期等）。
  • 如果简介已完整（100% 且没有占位符），建议交接给产品经理。

输出文件夹约定

所有产物都放在用户配置的输出文件夹中，默认为 bmad-output/：

文件描述
bmad-output/product-brief-<slug>-<YYYY-MM-DD>.md产品简报本身
bmad-output/decision-log.md持续记录规划决策的日志

交接标准

满足以下条件时，产品简报即可交接给产品经理（创建 PRD）：

  • 已包含并填写全部 8 个部分。
  • 已定义至少一项 SMART 成功指标。
  • 已区分 MVP 范围与未来范围。
  • 已记录主要风险和假设。
  • validate-brief.sh 的退出代码为 0。

请明确说明：“产品简报已完成。建议交接给产品经理，以创建 PRD。”

子 Agent 策略

对于创建任务（可选进行市场调研），请在需求探索对话结束后分派任务：

Agent任务输出
Agent 1（可选）通过 WebSearch 调研竞争格局bmad-output/competitive-snapshot.md
Agent 2（可选）根据笔记综合用户需求和用户画像bmad-output/persona-notes.md

主上下文根据子 Agent 的输出和对话笔记整理最终简报。只有当用户要求的调研深度超出其口头提供的信息时，才启动子 Agent。

可用资源

  • ${CLAUDE_PLUGIN_ROOT}/skills/bmad-product-brief/templates/product-brief.template.md — 简报模板
  • ${CLAUDE_PLUGIN_ROOT}/skills/bmad-product-brief/scripts/validate-brief.sh — 完整性校验器
  • ${CLAUDE_PLUGIN_ROOT}/skills/bmad-product-brief/scripts/discovery-checklist.sh — 完整问题清单（可打印）

BMAD 规划与编排插件的一部分——由 BMAD Code Organization（https://github.com/bmad-code-org/BMAD-METHOD）开发、用于 Claude Code 的 harness。体现了 bmad-business-analyst 的理念。所有方法论相关的致谢均归 BMAD Code Organization 所有。

评论

支持 Markdown