用途
bonfire-strategic 用于创建战略类文档,帮助团队在技术决策、产品规划和客户验证等场景下产出结构化文档。它支持三种文档类型:
- rfc(Request for Comments):用于技术决策、架构提案。
- prd(Product Requirements Document):用于产品规格、功能定义。
- poc(Proof of Concept Plan):用于客户评估、技术验证。
主要能力
命令通过解析参数确定文档类型和主题。第一个词为文档类型(rfc、prd、poc),其余部分为主题或对象。示例:
- /bonfire-strategic rfc authentication → 关于认证的 RFC
- /bonfire-strategic prd dark-mode → 关于深色模式功能的 PRD
- /bonfire-strategic poc acme-corp → 面向 Acme Corp 的 POC 计划
如果类型无法识别或缺失,会要求用户指定。
每种类型对应一个模板文件:
- rfc → references/rfc-template.md
- prd → references/prd-template.md
- poc → references/poc-template.md
使用方式
所有文档类型都遵循相同的“研究 → 访谈 → 撰写”流程:
-
研究阶段(子代理):提示用户“正在研究代码库以获取上下文……”,使用 Task 工具调用 Explore 代理。研究问题因类型而异:RFC 关注先前方案、架构、约束、相关方;PRD 关注相关功能、用户流程、数据模型、技术约束;POC 关注相关功能、集成点、配置、限制。需等待研究结果后再继续。
-
访谈阶段(主上下文):提示用户“开始访谈……”,从 references/ 读取相应模板以获取访谈轮次,使用 AskUserQuestion 提出基于研究结果的问题。
-
撰写阶段(子代理):提示用户“正在撰写文档……”,使用 Task 工具调用通用代理,并提供文档类型、研究发现、访谈问答、输出路径以及来自 references/ 的模板结构。
-
验证与确认:读取模板以获取必需章节,然后验证这些章节是否存在。如果不完整,提供选项:继续 / 重试 / 中止。
文件位置
配置文件位于 <git-root>/.bonfire/config.json,其中包含 docsLocation。如果未配置,默认使用 .bonfire/docs/。
撰写后处理
- 验证文档是否包含模板要求的必需章节。
- 在 <git-root>/.bonfire/index.md 中链接到会话上下文。
- 与用户确认并提供后续步骤:与评审人/相关方分享、细化特定章节、根据 RFC/PRD 创建实现规格、创建相关议题。
文档生命周期
所有战略文档都会经历状态流转(详见模板):
- RFC:Draft → In Review → Approved → Rejected
- PRD:Draft → In Review → Approved → In Development → Shipped
- POC:Draft → Prep → Active → Review → Decided(Go/No-go/Extend)
当文档被批准或决定后:创建后续产物(规格、议题、计划),并附上结果说明进行归档。
适用场景
适用于需要产出结构化战略文档的团队场景,例如技术架构决策、产品功能定义、客户概念验证计划等。
限制
资料中未提供关于收费、价格、平台支持范围、具体效果或性能的说明。