SuperAPI AI 工具集

bmad-spec

通用与其它

查看项目

更新于 10-15 17:27

技能介绍

用途:将任意意图输入——模糊想法、脑暴、PRD、GDD、RFC、简报、聊天记录、客户邮件、会议转录、原型图或多来源混合内容——压缩为一份简短规范。核心产物是 SPEC.md,承载五字段内核(Why、Capabilities、Constraints、Non-goals、Success signal),以及若干配套文件(companion),用于放置不适合放进内核的重量级内容。它们共同构成下游 BMad 技能消费的机器契约。

主要能力:支持创建与更新同一 spec;以追加式记忆文件 .memlog.md 为权威记录,SPEC.md 与配套文件每次由 memlog 重新派生,从不手工修补;能力 ID(CAP-N)保持稳定、不复用;按 Spec Law 八条规则自检(内聚与保全两轮);可选生成 stories.yaml 做故事拆分。

使用方式:激活时先解析自定义与配置,命令如 uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-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 和 append。自动检测交互或无头模式;无输入时交互提示补充,无头返回 error_code: "insufficient_intent";缺少 slug 时无头返回 missing_slug。结果默认落在 {output_folder}/specs/spec-{slug}/。

适用场景:上游有 PRD、UX、架构、epic 等产物需要统一契约时;输入混杂需要人工归类时;同一主题需多次迭代更新 spec 时。

限制:本技能只做提炼,不做引导或补全答案;输入过薄会建议改用 bmad-prd。域相关缺口记为 open_questions[],不臆造答案。手改 SPEC.md 不受支持,下次派生会被覆盖。无头模式不执行故事拆分。具体收费、平台与效果暂未提供。