bmad-architecture-design

架构设计技能

何时调用

在用户出现以下情况时自动激活：

• 询问“我们应该如何构建这个？”、“架构是什么？”
• 询问“技术栈是什么？”、“系统设计？”、“如何设计架构？”
• 提及“架构”、“技术决策”、“技术栈”
• PRD 和史诗已获批准（第 3 阶段）
• 使用“架构”、“技术栈”、“设计”、“系统”、“构建”、“技术”等词语

具体触发短语：

• “我们应该如何构建这个？”
• “架构是什么？”
• “选择技术栈”
• “[项目] 的系统设计”
• “技术架构”
• “如何为[功能]设计架构”

前置条件：

• PRD 已存在并获批准
• 史诗已定义

以下情况不要调用：

• PRD 尚未准备就绪（先使用 bmad-product-planning）
• 已有架构（跳转至用户故事）
• 简单的 Level 0-1 项目（可能不需要正式架构）

使命

将已批准的产品需求转化为决策架构，向实施团队说明组件结构、技术选择及其依据。

所需输入

• prd：最新 PRD，以及来自 product-requirements 技能的史诗路线图
• constraints：非功能性需求、合规规则和集成
• existing_assets：代码仓库、现有架构图或技术标准
• project_level：BMAD 级别划分，用于指导设计深度

缺少输入时，必须先向编排器或发起的技能升级处理，再继续工作。

输出

• 使用 assets/decision-architecture-template.md.template 编写的 ARCHITECTURE.md
• 更新风险和决策日志条目，并为利益相关方汇总

交付物应突出说明决策、被否决的选项和实施护栏。

流程

1. 通过 CHECKLIST.md 验证前置条件，并确认规划材料已获批准。
2. 识别架构驱动因素（质量属性、约束、集成）。
3. 设计组件拓扑、数据流和技术选型，并确保可追溯至需求。
4. 记录关键决策、备选方案和缓解策略。
5. 如果有结构化数据，使用 scripts/generate_architecture.py 生成或更新架构文档。
6. 审查质量清单，并为交付规划和开发执行技能发布摘要及后续行动。

质量关卡

遵循 CHECKLIST.md，确保内容完整、可行，并与利益相关方达成一致。如果未能通过护栏检查，则停止。

错误处理

出现矛盾或缺漏时：

• 指明导致冲突的具体需求或假设。
• 请求 product-requirements、UX 或 discovery-analysis 技能进行澄清。
• 建议在记录解决方案之前暂缓实施。