SuperAPI AI 工具集

bonfire-strategic

写作与研究

查看项目

更新于 10-16 06:10

技能介绍

用途

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

使用方式

所有文档类型都遵循相同的“研究 → 访谈 → 撰写”流程:

  1. 研究阶段(子代理):提示用户“正在研究代码库以获取上下文……”,使用 Task 工具调用 Explore 代理。研究问题因类型而异:RFC 关注先前方案、架构、约束、相关方;PRD 关注相关功能、用户流程、数据模型、技术约束;POC 关注相关功能、集成点、配置、限制。需等待研究结果后再继续。

  2. 访谈阶段(主上下文):提示用户“开始访谈……”,从 references/ 读取相应模板以获取访谈轮次,使用 AskUserQuestion 提出基于研究结果的问题。

  3. 撰写阶段(子代理):提示用户“正在撰写文档……”,使用 Task 工具调用通用代理,并提供文档类型、研究发现、访谈问答、输出路径以及来自 references/ 的模板结构。

  4. 验证与确认:读取模板以获取必需章节,然后验证这些章节是否存在。如果不完整,提供选项:继续 / 重试 / 中止。

文件位置

配置文件位于 <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)

当文档被批准或决定后:创建后续产物(规格、议题、计划),并附上结果说明进行归档。

适用场景

适用于需要产出结构化战略文档的团队场景,例如技术架构决策、产品功能定义、客户概念验证计划等。

限制

资料中未提供关于收费、价格、平台支持范围、具体效果或性能的说明。