SuperAPI AI 工具集

bmad-architecture

编程与开发

查看项目

更新于 10-15 23:58

技能介绍

用途:把 prd.md 转化为单一连贯的 architecture.md,作为语义冲突预防层。后续编排器会把多个并行开发智能体分配到各故事,若各自发明 API 风格、数据形态、认证模型或命名,合并将混乱;本技能提前统一这些决策。

主要能力:提取 PRD 中每个 FR 与 NFR;运行 NFR 清单脚本发现遗漏类别;识别架构驱动因素;按轨道/规模选择架构模式;以 ADR 锁定横切决策(API 风格、数据模型、状态管理、命名约定、安全方案);建立 FR/NFR 覆盖矩阵,无孤儿项;填充模板生成 bmad-output/architecture.md;将 ADR 摘要追加到 decision-log.md。

三种意图:Create(新建)、Update(读取现有架构与变更 PRD,新增 ADR 而非静默修改旧 ADR,用带日期的 Superseded 标注保留历史)、Validate(校验)。

必要命令: bash ${CLAUDE_PLUGIN_ROOT}/skills/bmad-architecture/scripts/nfr-checklist.sh bash ${CLAUDE_PLUGIN_ROOT}/skills/bmad-architecture/scripts/validate-architecture.sh bmad-output/architecture.md

输入:prd.md(BMad/Enterprise 轨道必需)、project-context.md、decision-log.md,可选 ux-design.md。默认输出目录 bmad-output/。

ADR 核心要素:标题、状态、Context、Decision、Consequences、Alternatives。BMad Method 项目最小 ADR 集:API 风格、数据/持久化模型、AuthN/AuthZ、状态管理、错误/响应约定、命名约定。

适用场景:BMad Method 与 Enterprise 轨道;Quick Flow 通常改用 tech-spec,很少需要完整架构。

限制:本技能只产出文档,不写应用代码、不运行测试、不做 lint、不检查覆盖率、不构建。验收标准、测试策略与开发笔记可作为规划内容,但执行超出范围。校验失败时报告缺口清单,修计划而非改代码。详细 NFR 类别、常见 ADR 主题与技术选型准则见 REFERENCE.md。