SuperAPI AI 工具集

capturing-business-requirements

写作与研究

查看项目

更新于 10-27 13:02

技能介绍

用途 该技能用于把业务探索过程中业务专家(SME)已知的信息,沉淀为可交接的结构化文档。它运行在探索流程的第 1 阶段(原型走查之后),并作为第 4 阶段的记录环节。

主要能力

  • 业务需求文档(BRD):捕获业务规则、约束与假设。
  • 用户故事:生成带验收标准的故事,支持 Gherkin 等格式。
  • 工作流文档:生成流程图等工作流图。
  • 问题与机会、问题框架、原型观察记录等多种捕获模式(每次调用仅使用一种模式)。
  • 缺口检查:使用固定标记 [NEEDS HUMAN INPUT](括号内注明原因)标记缺失信息,由 check_gaps.py 统计;若单次捕获中缺口超过 3 个,则退回简报阶段。

使用方式 在该技能目录下执行,例如:

  • python3 scripts/business_requirements_capture_execute.py --input <capture.md> --mode brd --output exploration/captures/brd-draft.md
  • python3 scripts/user_story_capture_execute.py --input <brd-draft.md> --format gherkin --output exploration/captures/user-stories-draft.md
  • python3 scripts/generate_workflow.py --input <brd-draft.md> --output exploration/captures/workflow-map.md --type flowchart 验证命令:python3 ../running-exploration-cycle/scripts/check_gaps.py --files exploration/captures/*.md --threshold 3

约束与规则

  • 不得臆造,只记录捕获材料或业务专家的陈述;推断标记 [UNCONFIRMED],明确陈述标记 [CONFIRMED],未经业务专家签核不得升级。
  • 缺口标记必须使用精确字符串 [NEEDS HUMAN INPUT] 的任何变体都会漏计,且不得出现在最终交接文档中。
  • 每个待定决策只在 ## Consolidated Gaps 下记录一次;简报中的 Decision Pre-fills 视为已确认。
  • 每条故事和规则须引用来源文件。
  • prototype-notes.md 仅由原型观察提取环节写入。
  • 低成本多轮处理通过 cli-agent 技能配合提供的提示模板执行,不指定具体模型。

适用场景 需要把业务探索访谈、原型走查等原始材料整理为 BRD、用户故事、流程图并保持可追溯性与缺口可见性的团队工作流。

限制 资料未提供具体产品平台、收费方式、效果指标及脚本实现细节;部分脚本与模板文件(如 acceptance-criteria.md、requirements-doc-agent.md 等)仅被引用,其内容暂未提供。