software-architecture

软件架构

使用此技能做出系统级设计决策，并留下从驱动因素到证据的可审查路径。它负责架构决策工作流，不负责实现任何子系统。

工作流

1. 明确决策。 确定预期结果、利益相关方、约束、决策期限、可逆性、受影响的系统和证据缺口。不要臆造规模、监管、延迟或所有权方面的事实。
2. 将质量属性转化为场景。 指明重要的架构特征，将每项特征表述为可观察的场景，确定其优先级，并揭示相互冲突之处。加载 references/architecture-characteristics-and-tradeoffs.md。
3. 选择边界和形态。 根据这些场景和团队的运维能力，对比架构风格、拓扑和部署粒度。加载 references/styles-topologies-and-granularity.md。
4. 检验所有权和耦合。 识别策略、数据、变更、运行时和团队边界。将服务拆分视为假设，而非默认做法。加载 references/coupling-modularity-and-data-ownership.md。
5. 明确运行时行为。 对于异步或分布式流程，明确权威来源、一致性、顺序、重试、重复、超时、部分故障、恢复和对账。加载 references/distributed-workflows-and-consistency.md。
6. 记录并验证。 在 templates/architecture-design-brief.md 和 templates/tradeoff-record.md 中记录决策和被否决的替代方案；使用 templates/architecture-review.md 进行质疑和签署。使用 references/evolution-fitness-functions-and-drift.md 定义适配度证据和偏离响应。
7. 规划变更，同时明确执行责任归属。 确定渐进演进的阶段、共存假设和交接条件。加载 references/migration-and-coexistence.md；将已批准的过渡交由 migration-engineering 负责。
8. 按比例开展评审。 根据影响范围、不可逆性、不确定性和跨团队影响，确定评审深度。加载 references/architecture-practice-and-facilitation.md。

输出约定

产出架构决策简报或评审，其中包括驱动因素、利益相关方、约束、优先级场景、候选方案、明确的权衡、边界和所有权、运行时及故障行为、运维影响、决策、证据缺口、适配度检查、演进阶段和明确的负责人。说明已做出的决策、尚未解决的问题，以及由哪位专家负责后续工作。

所有权边界

• 使用 software-architecture-analysis 逆向分析现有代码库，或根据代码仓库证据推断架构。
• 使用 api-design-and-evolution 设计接口契约、架构、兼容性或 API 拓扑。
• 使用 data-architect 设计数据平台、数据产品、数据模型或数据治理。
• 使用 backend-engineering 和相关工程负责人实现服务、集成、事务或应用代码。
• 使用 platform-engineering 及其工具负责人配置或运维云、网络、CI/CD、容器、机密信息或可观测性基础设施。
• 使用 secure-software-engineering 定义安全要求、威胁模型、授权、机密信息或安全证据。
• 使用 adr-authoring 编写持久化的 ADR；此技能提供架构决策背景和权衡分析。
• 使用 migration-engineering 执行已批准的跨系统过渡；此技能负责判断目标形态和边界是否合理。
• 使用 capacity-and-cost-engineering 建模容量、单位成本、负载证据或 SLO 与成本之间的权衡。
• 使用 resilience-and-recovery 设计并演练降级、故障切换、恢复或恢复证据。
• 使用 c4-diagramming 或 mermaid-diagrams 创建结构图。
• 使用 technology-radar 管理技术组合、技术雷达或适度的技术治理路径。

不适用场景

不要将此技能用作专业负责人的替代方案、代码审查工作流或供应商／工具操作手册。如果请求仅涉及某个接口、数据平台、实现、基础设施、安全、容量、图表、ADR 或迁移问题，请直接加载范围更窄的负责人技能。如果架构问题依赖现有系统的事实，请先从 software-architecture-analysis 开始，再回到此处做目标决策。

参考指南

加载时机	参考资料
对质量属性进行优先级排序并比较相互冲突的结果	references/architecture-characteristics-and-tradeoffs.md
比较风格、部署拓扑或粒度	references/styles-topologies-and-granularity.md
检验模块化、耦合、边界和数据权威性	references/coupling-modularity-and-data-ownership.md
设计分布式工作流、一致性或故障行为	references/distributed-workflows-and-consistency.md
选择复制、分区、协调、排序或事务隔离机制	references/distributed-workflows-and-consistency.md，然后查看 DDIA 精简参考；仅在需要更深入的机制分析时加载完整参考
定义适应度证据、漂移应对或演进式变更	references/evolution-fitness-functions-and-drift.md
规划共存，并将执行工作交接给迁移工程	references/migration-and-coexistence.md
开展架构研讨会、评审和决策引导	references/architecture-practice-and-facilitation.md
检查来源出处及授权图书的转换边界	references/source-index.md

加载 DDIA 时，请明确划分职责：此技能负责系统级架构决策及其权衡；programming-principles 提供分布式数据原则和机制细节。将消息处理器实现交给 backend-engineering，将 API 或事件契约交给 api-design-and-evolution，将数据平台设计交给 data-architect，将经过实际演练的恢复证据交给 resilience-and-recovery。

完成条件

当架构决策已有明确负责人、列出清晰的备选方案及其后果、每项重要主张都有证据或明确指出证据缺口、已为优先级较高的特性确定验证路径，并完成专业交接时，即可停止。如果权限、安全、数据所有权或运维证据缺失，应升级处理，而不是默默自行解决。