软件架构指南

SKILL.md

---
name: 软件架构指南
description: 在分析系统边界、质量需求、通信、风格、决策、风险或演进时，应用上下文相关的软件架构指导。
---

# 软件架构指南

使用此便携草案支持跨软件领域的架构工作。它不会全局安装。本书提供概念和权衡；本指南将其操作化为条件检查。它们不是项目命令，也不能替代用户意图、本地治理或已知系统证据。

## 工作流程

1. **建立上下文和权限。** 确定领域、系统边界、业务成果、部署和数据约束、团队能力、已知证据、未知因素和决策权限。尊重已委托的权限。仅询问可能改变结果的缺失事实；否则给出条件性建议。
2. **排序驱动因素。** 将利益相关者的成果转化为架构特性。根据三部分定义测试每个候选项，分解复合质量，并优先排序少数特性。
3. **映射边界和数据。** 确定功能职责、依赖关系、事务、数据所有权、静态耦合、运行时调用及每个相关边界的特性。
4. **按比例比较。** 对于重要选择，至少比较两个可行选项，依据已陈述的优先级、成本、风险和证据。对于小且可逆的变更，不强制正式比较。
5. **带理由做决定。** 陈述建议或状态，说明其适用原因、接受的成本、假设及可能导致重新考虑的证据。遵循委托权限；不要自行设定审批关卡。
6. **指定检查。** 选择与风险成比例的度量或适应性函数。说明其范围、信号、限制和响应。

## 核心规则

- 基于上下文（[上下文和优先级规则](references/rulebook.md#context-priorities)：F01）提出建议，尊重委托权限（[决策、风险和演进规则](references/rulebook.md#decisions-risk-evolution)：D03）。
- 从可测量的利益相关者成果推导并排序特性（[上下文和优先级规则](references/rulebook.md#context-priorities)：F05、F06、F07、F08、F18）。
- 保持职责内聚，边界对依赖和耦合保持诚实（[边界规则](references/rulebook.md#boundaries-coupling-data)：F11–F17、S03、S08；[术语表](references/glossary.md)）。
- 为工作选择通信方式；区分请求、命令和事件，并设计容错（[通信规则](references/rulebook.md#communication-reliability)：S06、S09–S13、S15、D08）。
- 将架构风格视为条件选项，比较其成本（[风格规则](references/rulebook.md#style-choice)：S01、S16、D06；[风格指南](references/style-selection.md)）。
- 记录重要决策存在的原因及其可能改变的条件（[权衡](references/rulebook.md#context-priorities)：F02；[决策记录](references/rulebook.md#decisions-risk-evolution)：F03）。
- 使风险、不确定性和实施一致性可见（[风险和演进规则](references/rulebook.md#decisions-risk-evolution)：D10、D11、D12、D13）。
- 用人们理解的检查治理重要约束（[治理规则](references/rulebook.md#decisions-risk-evolution)：F09、F10）。
- 在实际权限和约束内保留团队选择权（[团队和通信规则](references/rulebook.md#communication-teams)：S04、D16、D17、D18）。
- 仅当项目包含模型提供者时，应用特定提供者指导（[rules.json 中的 D15](references/rules.json)）。

## 输出契约

返回：上下文和未知因素；建议和状态；备选方案和成本；边界、数据和通信影响；证据和检查；以及重新考虑触发器。根据选择的重要性调整细节。

## 参考资料

针对任务，仅加载 [rules.json](references/rules.json) 中相关类别或阅读其在 [rulebook.md](references/rulebook.md) 中的章节，不要两者或全部加载。加载 [style-selection.md](references/style-selection.md) 了解九种风格，加载 [glossary.md](references/glossary.md) 获取基于来源的术语，加载 [source-map.json](references/source-map.json) 定位引用章节。合成评估提示见 [evaluation-cases.json](references/evaluation-cases.json)；尚未运行。方法和限制见 [method-and-validation.md](references/method-and-validation.md)。