SuperAPI AI 工具集

bmad-spec

通用与其它

查看项目

更新于 10-15 19:53

技能介绍

用途:把任意杂乱、冗长或非结构化输入提炼为一份五字段的 SPEC.md 内核,作为下游规划工作的范围基准。它是规划技能,不编写应用代码、不运行测试、不构建产物。

产物:在配置的输出目录(默认 bmad-output/)生成 bmad-output/SPEC.md。SPEC 不是 PRD、简报或架构文档,而是对“做什么、为什么做”的共同定义。

五个字段:Problem(当下痛点及重要性);Capabilities(方案应能做到什么,以结果表述);Constraints(不可协商的硬限制,如预算、技术、时间、合规);Non-Goals(明确排除的范围);Success Metrics(确认问题解决的可观察信号)。模板见 ${CLAUDE_PLUGIN_ROOT}/skills/bmad-spec/templates/spec.template.md。

工作流程:1) 接收输入——粘贴原始文本、笔记、转录,或已有文件路径,或聊天中的口述描述;超过几百词先简要确认收到,不要求用户重排格式。2) 静默分析,逐字段提取信号。3) 先在聊天中呈现草稿(Problem 2–5 句;Capabilities 3–7 条;Constraints 2–6 条;Non-Goals 2–6 条;Success Metrics 2–5 条且可度量),并问一个针对性问题:写入 SPEC.md 前是否需要修改。4) 确认后按模板写入 <outputFolder>/SPEC.md(若存在 bmad-output/config.yaml 则读取其配置的输出目录,否则回退 bmad-output/),并向 bmad-output/decision-log.md 追加记录(含 ISO 日期、来源一行描述、最关键的范围决策)。5) 交接:Quick Flow 轨道交给 bmad-tech-spec;BMad Method / Enterprise 轨道交给 bmad-product-brief 或 PM 角色(bmad-prfaq);若尚无工作区,建议先运行 /bmad-planning-orchestrator:bmad-init 选择轨道。

三种意图:Create(常见,从新输入提炼);Update(读取现有 SPEC.md、应用变更、呈现差异式摘要、确认后覆盖,并记录到 decision-log.md);Validate(对照五字段契约检查是否完整非空、Problem 是否一致、Capabilities 是否以结果表述、Non-Goals 是否无歧义,标出缺口并提出修复)。

提炼启发式:如“需要修复/用户抱怨/坏了”映射 Problem;“应该/用户可以/系统支持”映射 Capabilities;“不能/没预算/必须用/截止”映射 Constraints;“不在范围/以后/不做”映射 Non-Goals;“如果 X%/何时算成功/目标”映射 Success Metrics。愿望式约束应移入 Non-Goals 或标注为软约束;功能式描述改写成结果(“加搜索框”→“用户可在 3 次击键内找到任意记录”);无指标时从 Problem 推导代理指标。

限制与护栏:刻意精简,不加第六字段;不做方案设计(不写架构、技术栈、实现选择);不出现故事点、速率或燃尽图;最后产物只有 SPEC.md,不创建用户故事、不写代码、不产出验收标准,这些交给下游技能。方法论归属 BMAD Code Organization。其他收费、平台等细节资料未提供。