用途:把模糊想法、头脑倾倒、PRD、GDD、RFC、简报、Slack 讨论、客户邮件、会议转录、原型等任意意图输入,浓缩为机器可读的规格契约。核心产物是 spec-{slug}.md,承载 Why、Capabilities、Constraints、Non-goals、Success signal 五字段内核,以及容纳不适合内核的承重内容的配套文件;两者共同构成下游 BMad 技能消费的契约。
主要能力:同一 slug 的多次调用会在原文件夹就地更新并保留能力编号;.memlog.md 为只追加的权威记忆,记录决策、约束、能力(稳定 CAP-N)、假设、问题和用户指示,spec 与配套文件每次由 memlog 重新派生,不手工编辑,避免多技能并行时的合并漂移。承重内容可放入 spec-authored 配套或引用上游技能产出的 adopted 配套;图表一律进配套。每次创建或更新后进行一致性与保全两轮自检,并将结论写入 memlog。
使用方式:需先安装 bmad(npx skills add bmad-code-org/BMAD-METHOD --skill bmad)并完成 setup,解析配置使用 uv run {project-root}/_bmad/scripts/resolve_customization.py 与 resolve_config.py,记忆写入使用 uv run {project-root}/_bmad/scripts/memlog.py init/append。交互模式会询问 slug、逐步走查字段;无头模式默认 express 提炼并返回 JSON。输入过薄时建议改用 bmad-prd。
适用场景:为 PRD、UX、架构、epics 等步骤提供统一规格;把多来源混乱输入整理为规范契约;与 bmad-ticket 交接,由其以 CAP-N 规划 epic 与工单。
限制:不负责撰写或指导需求,只做提炼;无输入时交互询问、无头返回 insufficient_intent;无法推导 slug 时无头返回 missing_slug;域隐含问题只记录为 open_questions,不代答;外部手工编辑 spec 不受支持,会在下次派生时被覆盖。详细模式判定、frontmatter 约定等以官方文档为准,此处资料未全部展开。