軟體架構指導方針

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)。