用途:将任意意图输入(模糊想法、头脑风暴、PRD、GDD、RFC、简报、聊天记录、客户邮件、会议转录、原型图、多来源混合内容)转化为机器可读的规范契约,产出 SPEC.md 与配套文件,供下游 BMad 技能构建使用。同一规范可被多个技能多次调用更新。
主要能力:SPEC.md 承载五字段内核(Why、Capabilities、Constraints、Non-goals、Success signal);不适合内核的承重内容放入 companion 文件(如 glossary.md、架构图、约定等),由 SPEC.md frontmatter 的 companions 数组引用。.memlog.md 是仅追加的权威记忆日志,SPEC.md 与规范作者编写的 companion 每次从中派生,不手工编辑。能力 ID(CAP-N)稳定且不复用。可选 Story Breakdown(仅交互模式)生成 stories.yaml。
使用方式:激活时先解析定制与配置(uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow;uv run {project-root}/_bmad/scripts/resolve_config.py --project-root {project-root}),再检测模式。创建时初始化日志:uv run {project-root}/_bmad/scripts/memlog.py init --workspace {spec-folder} --field topic="<what is being specced>";随后逐条追加条目:uv run {project-root}/_bmad/scripts/memlog.py append --workspace {spec-folder} --type <类型> --text "<一行摘要>"。规范输出至 {output_folder}/specs/spec-{slug}/。
适用场景:需要把零散或结构化意图整理为统一规范、供 PRD、UX、架构、史诗等环节按任意顺序消费且不发生合并漂移的团队流程。
限制:无输入时交互模式询问来源,无头模式返回 error_code: insufficient_intent;无法推导 slug 时无头模式返回 missing_slug。输入过薄时建议改用 bmad-prd,本技能只做提炼不做指导。外部手工编辑 SPEC.md 不被支持,下次派生会被覆盖。stories.yaml 不列入 companions。具体收费、平台与效果资料暂未提供。