用途 该技能用于把业务探索过程中业务专家(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 等)仅被引用,其内容暂未提供。