---
source: ../../../core/governance-layer.md
source_version: 1.0.0
translation_version: 1.0.0
last_synced: 2026-05-07
status: current
---

# 治理層標準

> **語言**: [English](../../../core/governance-layer.md) | 繁體中文

**版本**: 1.0.0
**最後更新**: 2026-05-07
**適用範圍**: 所有具有多 Agent 或多角色 AI 工作流程的軟體專案
**範疇**: universal
**產業標準**: 無（UDS 原創）

---

## 目的

治理層為專案中所有 Agent 與角色提供共同錨點：
Vision（方向）→ Mission（邊界 + 紅線）→ Goals（可量測的 KPI）。

它是 **Standard #0**：在所有其他標準之前評估。當本標準與其他領域標準發生衝突時，本標準優先。

---

## 三層架構

### Vision（願景）

| 欄位 | 要求 |
|------|------|
| 格式 | 單一句子，≤ 50 tokens |
| 內容 | 長期方向；永恆不變；不含量測指標 |
| 變更頻率 | 每年審查 |

**範例**：
> "成為全球軟體團隊最值得信賴的 AI 開發工作流程標準。"

---

### Mission（使命）

| 欄位 | 要求 |
|------|------|
| 格式 | 3–5 項承諾陳述 + 紅線清單（合計 ≤ 300 tokens） |
| 內容 | 我們做什麼 / 不做什麼；含觸發條件與處置動作的紅線 |
| 變更頻率 | 每季審查 |

**紅線必備欄位**：

| 欄位 | 型別 | 說明 |
|------|------|------|
| `id` | 字串 | 唯一識別碼（例如：R1、GUARD-001） |
| `category` | 字串 | 分類（quality / safety / compliance / ethics） |
| `clause` | 字串 | 人類可讀的禁止或要求陳述 |
| `action` | 列舉 | `block` \| `warn` \| `escalate_to_human` 之一 |

---

### Goals（目標）

| 欄位 | 要求 |
|------|------|
| 格式 | KPI 清單，≤ 500 tokens |
| 變更頻率 | 每個 Sprint 校準 |
| 可否證性 | 每個 KPI 必須可量測——禁止使用「改善」、「提升」等模糊詞彙 |

**KPI 必備欄位**：

| 欄位 | 型別 | 說明 |
|------|------|------|
| `id` | 字串 | 唯一識別碼（例如：KPI-01） |
| `metric_name` | 字串 | 追蹤的指標名稱 |
| `threshold` | 字串 | 量化目標（例如：≥ 95%、< 200 ms） |
| `measurement_method` | 字串 | 量測方式與時機 |

---

## 優先順序

治理層對所有其他標準具有**更高優先權**。衝突時的解析順序：

1. **治理層**（本標準）— 方向、紅線、KPI
2. **領域標準**（測試、提交訊息、部署等）
3. **專案特定覆寫**（本地 `.standards/` 客製化）

---

## 紅線格式

每條紅線必須包含所有必備欄位。執行動作說明：

| 動作 | 行為 |
|------|------|
| `block` | 立即停止 pipeline；不繼續執行 |
| `warn` | 記錄違規並繼續；超過閾值時升級 |
| `escalate_to_human` | 暫停並要求人類決策後才繼續 |

此外，每條紅線應包含 `mission_clause_ref` 欄位，參照其所強制執行的使命承諾。

---

## 評估器整合

當專案使用 AI 評估器 Agent 時，治理層提供評分錨點：

| 評估軸 | 權重 | 否決閾值 |
|--------|------|----------|
| 正確性 | 0.4 | < 0.3 → 不通過 |
| 使命對齊度 | 0.3 | < 0.3 → 不通過 |
| 目標達成度 | 0.3 | < 0.3 → 不通過 |

- **mission_alignment_score**：輸出與使命承諾的對齊程度
- **goal_achievement_score**：輸出推進目標 KPI 的程度
- 任何單一評估軸低於 0.3 即觸發不通過，無論加權總分為何

---

## 風險接受（trace_only 模式）

若專案放寬人工閘門（例如 `gate.mode = trace_only`），必須在 `mission.md` 中明確撰寫**風險接受條款**，包含：

| 必填欄位 | 說明 |
|----------|------|
| `date` | 接受風險的日期 |
| `signatory` | 接受風險的人員或角色 |
| `gates_bypassed` | 列舉所有繞過的人工閘門 |
| `risks_accepted` | 明確描述已接受的風險 |

若無有效的風險接受條款，pipeline **必須拒絕啟動（fail-closed）**。

---

## 治理檔案結構

採用本標準的專案應維護以下檔案：

```
governance/
├── vision.md          # 單一句子願景陳述
├── mission.md         # 承諾 + 紅線清單
└── goals.md           # KPI 清單（每個 Sprint 更新）
```

---

## 合規檢查清單

- [ ] Vision 為單一句子且 ≤ 50 tokens，不含量測指標
- [ ] Mission 有 3–5 項承諾及含所有必備欄位的紅線清單
- [ ] 每條紅線均有：id、category、clause、action
- [ ] Goals 清單存在，每個 KPI 均含：id、metric_name、threshold、measurement_method
- [ ] 沒有任何 KPI 使用模糊詞彙（「改善」、「提升」、「更好」）
- [ ] 若 `gate.mode = trace_only`，`mission.md` 中存在風險接受條款
- [ ] 所有 AI 評估器以 0.4/0.3/0.3 權重評分，且任一軸 < 0.3 即不通過
