universal-dev-standards 5.1.0-beta.7 → 5.1.0

package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md

@@ -0,0 +1,159 @@
+---
+source: ../../../core/translation-lifecycle-standards.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-04-20
+status: current
+---
+
+# 翻译生命周期标准
+
+> **语言**: [English](../../../core/translation-lifecycle-standards.md) | 简体中文
+
+**版本**: 1.0.0
+**最后更新**: 2026-04-20
+**状态**: Trial（到期 2026-10-20）
+**适用范围**: 所有具备多语言文档的项目
+**来源**: UDS BUG-A06 事后分析（2026-04-20）
+**父标准**: [documentation-lifecycle](documentation-lifecycle.md)
+
+---
+
+## 目的
+
+翻译生命周期标准：MISSING 与 OUTDATED 的区别、Semver 严重度分级，以及自动化整合（pre-commit hook、release gate）。
+
+`documentation-lifecycle` 标准提到翻译同步是 release gate 的一环，但未定义如何分类或响应不同程度的漂移。本标准填补这个缺口：翻译文件不存在与略微过时有本质区别，major 版本落差与 patch 升版也有本质区别。若不作区分，团队要么过度阻塞（任何过时都 fail），要么阻塞不足（忽略所有过时直到成为用户可见的问题）。
+
+**证据（BUG-A06 事后分析）**：
+1. UDS 在 3 个月内新增 32 个标准时，因缺乏 MISSING gate，翻译全部缺失，直到 Q2 audit 才发现。
+2. `anti-hallucination.md` zh-CN 停在 1.5.0，来源已升至 1.5.1——新的 Agent 认识论校准框架段落在 zh-CN 版本中完全缺失，用户看不到。
+
+---
+
+## 核心规范
+
+- `MISSING`（翻译文件不存在）永远是 release blocker — `exit 1`
+- `MAJOR` 版本落差（来源 X > 翻译 x，X > x）是 release blocker — `exit 1`
+- `MINOR` 版本落差是 advisory — 醒目警告，不阻塞
+- `PATCH` 版本落差是 advisory — 柔和警告，不阻塞
+- 严重度由翻译 frontmatter 的 `source_version` 与当前来源版本的 semver 比较决定
+- 每个翻译文件必须有 YAML frontmatter，包含 `source`、`source_version`、`translation_version`、`last_synced`、`status`
+- 来源标准被修改后，翻译的 `source_version` 立即过时——这种漂移可在 commit 时通过 pre-commit hook 检测
+
+---
+
+## 严重度分级
+
+| 等级 | 条件 | Exit Code | 行动 |
+|------|------|-----------|------|
+| `MISSING` | 翻译文件不存在 | 1 | 发布前创建 |
+| `MAJOR` | 来源 MAJOR > 翻译 MAJOR | 1 | 正式版发布前更新 |
+| `MINOR` | 来源 MINOR > 翻译 MINOR（同 MAJOR）| 0 | 下次发布前更新（advisory）|
+| `PATCH` | 来源 PATCH > 翻译 PATCH（同 MAJOR.MINOR）| 0 | 方便时更新（advisory）|
+| `CURRENT` | source_version == 当前来源版本 | 0 | 无需行动 |
+
+### Semver 差异公式
+
+```
+diff_level = compare(
+  strip_prerelease(current_source_version),
+  strip_prerelease(translation.source_version)
+)
+
+其中：major 不同 → MAJOR，minor 不同 → MINOR，其他 → PATCH
+```
+
+---
+
+## 触发条件
+
+| 事件 | 必要行动 |
+|------|---------|
+| 新增标准到 `core/` | 在所有支持的语言创建翻译（MISSING check 阻塞发布）|
+| 标准 PATCH 升版 | 方便时更新翻译的 `source_version` + `last_synced` |
+| 标准 MINOR 升版（含新段落）| 更新翻译内容 + frontmatter，下次发布前完成 |
+| 标准 MAJOR 升版（大改写）| 更新翻译内容 + frontmatter，当前发布前完成（阻塞）|
+| 手动更新翻译 | 升版 `translation_version` + `last_synced` |
+
+---
+
+## 翻译 Frontmatter 协议
+
+每个翻译文件必须以以下格式开头：
+
+```yaml
+---
+source: ../../../core/<filename>.md          # 指向来源的相对路径
+source_version: <X.Y.Z>                      # 最后同步时的来源版本
+translation_version: <X.Y.Z>                 # 翻译自身的版本
+last_synced: <YYYY-MM-DD>                    # 最后同步日期
+status: current | outdated | draft           # 人类可读状态
+---
+```
+
+更新翻译时：
+1. 翻译新增或修改的内容
+2. 设定 `source_version` = 新的来源版本
+3. 设定 `translation_version` = 与 `source_version` 相同（或独立升版）
+4. 设定 `last_synced` = 今天日期
+5. 设定 `status: current`
+
+---
+
+## 自动化整合
+
+### Pre-Commit Hook
+
+当 `core/*.md` 文件被暂存时，pre-commit hook 执行 `check-translation-sync.sh` 并显示 OUTDATED 警告。Hook **永不阻塞** commit（在 commit 时阻塞过于干扰）——纯提醒用途。
+
+设置方式：`./scripts/install-hooks.sh`（clone 后执行一次）
+
+### Release Gate（`check-translation-sync.sh`）
+
+在 `npm publish` 前或作为 `pre-release-check.sh` 的一部分执行：
+
+```bash
+bash scripts/check-translation-sync.sh
+# MISSING 或 MAJOR 落差 → exit 1
+# 仅 MINOR/PATCH 落差 → exit 0（附 advisory 输出）
+```
+
+### Version Bump 整合（`bump-version.sh`）
+
+`bump-version.sh` 在更新版本文件后自动执行 `check-translation-sync.sh`，在升版时即时显示翻译健康状态快照——让作者立即知道发布前需要更新什么。
+
+---
+
+## 情境示例
+
+**情境 1 — 标准 patch 升版（1.0.0 → 1.0.1）**
+- 翻译 `source_version: 1.0.0`，来源现在是 `1.0.1`
+- 严重度：`PATCH` — advisory，exit 0
+- 行动：下次方便时更新，不阻塞发布
+
+**情境 2 — 标准 minor 升版含新段落（1.0.0 → 1.1.0）**
+- 翻译 `source_version: 1.0.0`，来源现在是 `1.1.0`
+- 严重度：`MINOR` — advisory，exit 0
+- 行动：下次发布前更新；zh-CN 用户缺少新内容
+
+**情境 3 — 标准 major 大改写（1.x.x → 2.0.0）**
+- 翻译 `source_version: 1.5.0`，来源现在是 `2.0.0`
+- 严重度：`MAJOR` — 阻塞，exit 1
+- 行动：正式版发布前必须更新
+
+**情境 4 — 新标准，无翻译文件**
+- `locales/zh-CN/core/new-standard.md` 不存在
+- 严重度：`MISSING` — 阻塞，exit 1
+- 行动：发布前创建翻译文件
+
+---
+
+## 错误码
+
+| 代码 | 说明 |
+|------|------|
+| `TRANS-001` | `MISSING_TRANSLATION` — 来源标准的翻译文件不存在 |
+| `TRANS-002` | `MAJOR_VERSION_GAP` — 翻译的 source_version 落后当前来源 MAJOR 版本 |
+| `TRANS-003` | `MISSING_FRONTMATTER` — 翻译文件缺少必要的 YAML frontmatter |
+| `TRANS-004` | `STALE_SOURCE_REF` — frontmatter 的 `source` 路径指向不存在的文件 |

package/bundled/locales/zh-TW/CHANGELOG.md

@@ -1,8 +1,8 @@
 ---
 source: ../../CHANGELOG.md
-source_version: 5.1.0-beta.7
-translation_version: 5.1.0-beta.7
-last_synced: 2026-04-17
+source_version: 5.1.0
+translation_version: 5.1.0
+last_synced: 2026-04-20
 status: current
 ---
 
@@ -17,6 +17,35 @@ status: current
 
 ## [Unreleased]
 
+## [5.1.0] - 2026-04-20
+
+> **正式版**：BUG-A06 i18n 完整性 — 新增 32 份缺失翻譯、Semver 感知翻譯閘門、新增 `translation-lifecycle-standards` UDS 標準。BUG-A07 Shell 測試覆蓋 — 20+ 腳本的 bats smoke tests。BUG-A08 假通過測試稽核 — 修正 22 個測試。Pre-release Batch 0：6 個標準從 Trial 升至 Adopt（DEC-021/025/031/035/038/040）。標準總數：106 個。
+
+### 新增
+- **`translation-lifecycle-standards`**（Trial，到期 2026-10-20）：新 UDS 標準，定義 MISSING 與 OUTDATED 的區別、Semver 嚴重度分級（MISSING/MAJOR = 發布阻塞器，MINOR/PATCH = advisory），以及自動化整合（pre-commit hook、release gate、bump-version 整合）。來源：BUG-A06 事後分析。
+- **`.githooks/pre-commit`** + **`scripts/install-hooks.sh`**：commit 時若暫存 `core/*.md` 檔案則顯示 OUTDATED 警告，永不阻塞 commit。透過 `./scripts/install-hooks.sh` 啟用。
+- **32 份 zh-TW 與 zh-CN 翻譯**（BUG-A06）：所有核心標準現已有完整 zh-TW 和 zh-CN 翻譯，包含 `circuit-breaker`、`token-budget`、`dual-phase-output`、`failure-source-taxonomy`、`immutability-first`、`security-decision`、`capability-declaration`、`recovery-recipe-registry`、`retry-standards`、`health-check-standards`、`timeout-standards`、`skill-standard-alignment-check`、`standard-admission-criteria`、`standard-lifecycle-management`、`packaging-standards`、`frontend-design-standards`、`translation-lifecycle-standards` 等。
+- **bats smoke tests**（BUG-A07）：`tests/scripts/` — 20+ 個 Shell 腳本的 smoke tests，涵蓋 `check-translation-sync.sh`、`check-version-sync.sh`、`bump-version.sh`、`install-hooks.sh` 等。
+
+### 變更
+- **`check-translation-sync.sh`**：Semver 感知嚴重度 — MAJOR 版本落差現在 exit 1（發布阻塞器）；MINOR/PATCH 落差 exit 0 附 advisory 警告。新增 `semver_diff()` 函式與 `[MAJOR]`/`[MINOR]`/`[PATCH]` 嚴重度標籤。
+- **`bump-version.sh`**：更新版本檔案後自動執行 `check-translation-sync.sh`，在升版時提供翻譯健康狀態快照。
+- **`scripts/pre-release-check.sh`**：更新為將 `check-translation-sync.sh` 作為硬閘門（MISSING + MAJOR = exit 1）。
+
+### 修正
+- **zh-CN `anti-hallucination.md`**（BUG-A06）：從 1.5.0 更新至 1.5.1 — 補上缺失的「Agent 认识论校准」章節（Answer/Ask/Abstain 框架，XSPEC-008）。該章節自 2026-04-13 起在 zh-CN 中完全缺失。
+- **22 個假通過測試**（BUG-A08）：修正未正確驗證行為的測試，加入真實斷言。
+
+### 升至 Adopt（Pre-release Batch 0）
+- `circuit-breaker`（DEC-021）：Trial 6 個月後升至 Adopt
+- `token-budget`（DEC-025）：Trial 6 個月後升至 Adopt
+- `dual-phase-output`（DEC-031）：Trial 6 個月後升至 Adopt
+- `security-decision`（DEC-035）：Trial 6 個月後升至 Adopt
+- `immutability-first`（DEC-038）：Trial 6 個月後升至 Adopt
+- `failure-source-taxonomy`（DEC-040）：Trial 6 個月後升至 Adopt
+
+[5.1.0]: https://github.com/AsiaOstrich/universal-dev-standards/compare/v5.1.0-beta.7...v5.1.0
+
 ## [5.1.0-beta.7] - 2026-04-17
 
 > **Beta Release**：DEC-043 Wave 1 — 六個 Trial 狀態標準，涵蓋可靠性模式與治理 Meta 框架。

package/bundled/locales/zh-TW/README.md

@@ -6,7 +6,7 @@
 
 > **語言**: [English](../../README.md) | 繁體中文 | [简体中文](../zh-CN/README.md)
 
-**版本**: 5.1.0-beta.7 (Pre-release) | **發布日期**: 2026-04-13 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
+**版本**: 5.1.0 | **發布日期**: 2026-04-13 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
 
 語言無關、框架無關的軟體專案文件標準。透過 AI 原生工作流，確保不同技術堆疊之間的一致性、品質和可維護性。
 

package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md

@@ -1,3 +1,11 @@
+---
+source: ../../../core/anti-sycophancy-prompting.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-04-20
+status: current
+---
+
 # 防迎合提示詞設計標準
 
 > **語言**: [English](../../../core/anti-sycophancy-prompting.md) | 繁體中文

package/bundled/locales/zh-TW/core/capability-declaration.md

@@ -0,0 +1,111 @@
+---
+source: ../../../core/capability-declaration.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-04-20
+status: current
+---
+
+# 能力聲明標準
+
+> **語言**: [English](../../../core/capability-declaration.md) | 繁體中文
+
+**版本**: 1.0.0
+**最後更新**: 2026-04-15
+**適用範圍**: 所有工具、Adapter、Agent 組件
+**Scope**: universal
+**來源**: XSPEC-037（claude-code-book Ch.3 Fail-Closed buildTool factory）
+
+---
+
+## 目的
+
+Fail-Closed 能力聲明：工具／Adapter／Agent 必須顯式聲明安全性，缺省為最保守預設。
+
+所有工具、Adapter 和 Agent 能力預設為「不安全、需授權」。開發者必須顯式聲明 `isConcurrencySafe: true` 才能享受並行優化。「忘記設權限」的結果是保守行為而非危險行為。
+
+---
+
+## 核心規範
+
+- 所有工具、Adapter、Agent 必須實作 `CapabilityDeclaration`（即使使用預設值）
+- `isConcurrencySafe` 和 `isReadOnly` 預設為 `false` — 必須顯式聲明才能解鎖優化路徑
+- 框架必須在缺少聲明時使用 `FAIL_CLOSED_DEFAULTS`，並記錄警告
+- 聲明必須反映實際能力，虛假聲明（如謊稱 `isReadOnly`）視為安全漏洞
+- `trustLevel` 影響沙箱隔離強度，不可降低至低於 `userSettings` 允許的等級
+
+---
+
+## CapabilityDeclaration 介面
+
+| 欄位 | 類型 | 預設值 | 說明 |
+|------|------|--------|------|
+| `isConcurrencySafe` | `boolean` | `false` | 是否對並行執行安全（無競態、無共享可變狀態）。設為 `true` 後可加入並行批次執行 |
+| `isReadOnly` | `boolean` | `false` | 是否為純讀取操作（不修改任何持久化狀態）。設為 `true` 後可跳過寫入相關的 Safety Hook 階段 |
+| `requiresUserConfirmation` | `boolean` | `true` | 執行前是否需要使用者明確確認。設為 `false` 後進入自動執行模式（需 `userSettings` 允許） |
+| `trustLevel` | enum | `untrusted` | 工具的信任等級，影響沙箱隔離強度 |
+
+### trustLevel 值對應
+
+| 值 | 說明 |
+|----|------|
+| `trusted` | 內建工具或已審核插件，無沙箱限制 |
+| `sandboxed` | 第三方工具，在受限環境中執行 |
+| `untrusted` | 未知來源，最嚴格限制（預設） |
+
+---
+
+## Fail-Closed 預設值
+
+缺少聲明時使用的保守預設：
+
+| 欄位 | 值 |
+|------|-----|
+| `isConcurrencySafe` | `false` |
+| `isReadOnly` | `false` |
+| `requiresUserConfirmation` | `true` |
+| `trustLevel` | `untrusted` |
+
+使用預設時記錄警告：`[WARN] Capability not declared, using Fail-Closed defaults for: {component_name}`
+
+---
+
+## 常見工具聲明範例
+
+| 工具 | `isConcurrencySafe` | `isReadOnly` | `requiresUserConfirmation` | `trustLevel` |
+|------|--------------------|--------------|-----------------------------|-------------|
+| GrepTool | `true` | `true` | `false` | `trusted` |
+| GlobTool | `true` | `true` | `false` | `trusted` |
+| FileReadTool | `true` | `true` | `false` | `trusted` |
+| FileEditTool | `false` | `false` | `true` | `trusted` |
+| BashTool | `false` | `false` | `true` | `sandboxed` |
+
+---
+
+## 執行規範
+
+| 情況 | 行動 |
+|------|------|
+| 缺少聲明 | 使用 `FAIL_CLOSED_DEFAULTS`，記錄警告 |
+| 虛假聲明（聲明 `isReadOnly: true` 但實際執行了寫入） | 記錄 `CAPABILITY_MISMATCH` 事件，降級至 `FAIL_CLOSED_DEFAULTS` |
+
+---
+
+## 適用組件
+
+- DevAP AgentAdapter（ClaudeAdapter / OpenCodeAdapter / CliAdapter）
+- DevAP Tool 呼叫系統
+- VibeOps ToolExecutor
+- VibeOps Agent（planner / builder / evaluator 等）
+- 所有 MCP 工具插件
+
+---
+
+## 錯誤碼
+
+| 代碼 | 說明 |
+|------|------|
+| `CAP-001` | `CAPABILITY_NOT_DECLARED` — 使用 Fail-Closed 預設 |
+| `CAP-002` | `CAPABILITY_MISMATCH` — 實際行為與聲明不符 |
+| `CAP-003` | `TRUST_LEVEL_INSUFFICIENT` — `trustLevel` 低於場景要求 |
+| `CAP-004` | `CONCURRENT_UNSAFE` — 嘗試並行執行 `isConcurrencySafe: false` 的組件 |

package/bundled/locales/zh-TW/core/circuit-breaker.md

@@ -0,0 +1,111 @@
+---
+source: ../../../core/circuit-breaker.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-04-20
+status: current
+---
+
+# 斷路器標準
+
+> **語言**: [English](../../../core/circuit-breaker.md) | 繁體中文
+
+**版本**: 1.0.0
+**最後更新**: 2026-04-15
+**適用範圍**: 所有依賴外部 API 或具備重試機制的 Agent 組件
+**Scope**: universal
+**來源**: XSPEC-036（claude-code-book Ch.2 MAX_CONSECUTIVE_AUTOCOMPACT_FAILURES）
+
+---
+
+## 目的
+
+通用斷路器模式：連續失敗後開路，防止 API 呼叫雪崩。
+
+任何依賴外部 API 或重試機制的 Agent 組件都應使用斷路器保護。實測：引入斷路器前每日浪費約 250K API 呼叫（1279 個 session 各超過 50 次連續失敗）。
+
+---
+
+## 核心規範
+
+- 任何重試機制必須使用斷路器包裝，不得直接無限重試
+- 斷路器狀態必須透過遙測可觀測（`circuit_breaker_state_change` 事件）
+- OPEN 狀態下的請求必須立即失敗（fail fast），不等待 timeout
+- `failureThreshold` 預設值為 3，與 claude-code-book 及 DevAP Fix Loop 一致
+- 斷路器必須按照「功能單元」建立，不得全域共享單一斷路器
+
+---
+
+## 三態模型
+
+| 狀態 | 描述 | 轉換條件 |
+|------|------|----------|
+| **CLOSED**（閉路） | 正常運作，請求正常轉發 | 連續失敗次數 >= `failureThreshold` → OPEN |
+| **OPEN**（開路） | 立即拒絕所有請求，回傳 `CircuitOpenError` | 等待 `cooldownMs` 後 → HALF_OPEN |
+| **HALF_OPEN**（半開） | 允許一次探針呼叫 | 成功 → CLOSED；失敗 → OPEN |
+
+---
+
+## 介面定義
+
+### CircuitBreaker
+
+| 欄位／方法 | 類型 | 說明 |
+|-----------|------|------|
+| `name` | `string` | 斷路器識別名稱 |
+| `state` | `CLOSED \| HALF_OPEN \| OPEN` | 目前狀態 |
+| `execute<T>(fn)` | `async () => Promise<T>` | 受保護的執行入口 |
+| `getState()` | `() => CircuitBreakerState` | 查詢目前狀態 |
+| `reset()` | `() => void` | 手動重設（管理員用） |
+
+### CircuitBreakerConfig
+
+| 欄位 | 類型 | 預設值 | 說明 |
+|------|------|--------|------|
+| `failureThreshold` | `number` | `3` | 連續失敗 N 次後開路 |
+| `cooldownMs` | `number` | `30000` | OPEN → HALF_OPEN 等待時間（毫秒） |
+| `successThreshold` | `number` | `1` | HALF_OPEN → CLOSED 需要的連續成功次數 |
+
+### CircuitOpenError
+
+| 欄位 | 類型 |
+|------|------|
+| `code` | `"CIRCUIT_OPEN"` |
+| `breakerName` | `string` |
+| `state` | `"OPEN"` |
+| `cooldownRemainingMs` | `number` |
+
+---
+
+## 遙測事件
+
+**`circuit_breaker_state_change`**（每次狀態轉換時上傳）
+
+| 欄位 | 類型 |
+|------|------|
+| `breaker_name` | `string` |
+| `from_state` | `CLOSED \| HALF_OPEN \| OPEN` |
+| `to_state` | `CLOSED \| HALF_OPEN \| OPEN` |
+| `failure_count` | `number` |
+| `timestamp` | `string` |
+
+---
+
+## 適用場景
+
+- DevAP Fix Loop Agent 呼叫重試
+- DevAP Judge / Quality Gate 重試
+- DevAP API 呼叫（LLM API 不穩定保護）
+- VibeOps Feedback Loop 重試
+- VibeOps FLARE 主動檢索重試
+- VibeOps AutoCompact（原始靈感來源）
+
+---
+
+## 錯誤碼
+
+| 代碼 | 說明 |
+|------|------|
+| `CB-001` | `CIRCUIT_OPEN` — 斷路器開路，請求被拒絕 |
+| `CB-002` | `PROBE_FAILED` — HALF_OPEN 探針失敗，重新開路 |
+| `CB-003` | `INVALID_CONFIG` — `failureThreshold` 必須 >= 1 |

package/bundled/locales/zh-TW/core/dual-phase-output.md

@@ -0,0 +1,132 @@
+---
+source: ../../../core/dual-phase-output.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-04-20
+status: current
+---
+
+# 雙階段 LLM 輸出標準
+
+> **語言**: [English](../../../core/dual-phase-output.md) | 繁體中文
+
+**版本**: 1.0.0
+**最後更新**: 2026-04-15
+**適用範圍**: 所有需要 LLM 審查的場景（Judge、Evaluator、Guardian、AutoCompact）
+**Scope**: universal
+**來源**: XSPEC-035（claude-code-book Ch.7 formatCompactSummary dual-phase output）
+
+---
+
+## 目的
+
+雙階段 LLM 輸出模式：`<analysis>` 思考丟棄，`<summary>` 結構化保留。
+
+讓 LLM 充分推理的同時，避免思考過程累積在上下文中消耗 token 預算。
+
+---
+
+## 核心規範
+
+- 所有 LLM 審查 Agent 必須要求雙階段輸出格式（`<analysis>` + `<summary>`）
+- `<analysis>` 在後處理時必須丟棄，不得寫入持久化上下文或對話歷史
+- `<summary>` 必須包含結構化結論欄位（`decision`、`confidence`、`findings`、`next_action`）
+- 若回應缺少雙階段格式，後處理器必須降級相容（完整回應視為 summary）並記錄警告
+- `summary` 欄位命名需遵循本標準，各應用場景可擴充但不可刪減核心欄位
+
+---
+
+## 輸出格式
+
+### `<analysis>` 標籤
+
+- **用途**：LLM 思考草稿 — 後處理時丟棄
+- **內容指引**：
+  - 逐條審查邏輯
+  - 邊界情境考量
+  - 替代方案比較
+
+### `<summary>` 標籤
+
+- **用途**：結構化結論 — 後處理時保留
+
+**核心欄位**（必填）：
+
+| 欄位 | 類型 | 值 |
+|------|------|-----|
+| `decision` | enum | `approved \| rejected \| needs_revision` |
+| `confidence` | enum | `high \| medium \| low` |
+| `findings` | array | `[type] description` 格式 |
+| `next_action` | string | 建議的後續行動 |
+
+**擴充欄位**（依場景新增，不可刪減核心欄位）：
+
+| 場景 | 額外欄位範例 |
+|------|------------|
+| 安全審查 | `severity: critical \| high \| medium \| low`, `cwe_ids: [CWE-NNN]` |
+| 品質審查 | `test_coverage: number`, `tech_debt_score: number` |
+
+---
+
+## Prompt 模板
+
+```
+You MUST respond using EXACTLY this two-phase XML structure:
+
+<analysis>
+[Your reasoning process — will be DISCARDED after processing]
+- Step-by-step evaluation
+- Edge case considerations
+- Alternative comparisons
+</analysis>
+
+<summary>
+decision: approved | rejected | needs_revision
+confidence: high | medium | low
+findings:
+  - [type] description
+next_action: [recommended follow-up action]
+</summary>
+
+IMPORTANT: The <analysis> block is your scratchpad. Only <summary> persists.
+```
+
+---
+
+## 後處理規則
+
+| 步驟 | 動作 |
+|------|------|
+| 提取 summary | 用正則 `<summary>([\s\S]*?)</summary>` 擷取 |
+| 丟棄 analysis | 用正則 `<analysis>([\s\S]*?)</analysis>` 移除 |
+| 降級相容 | 若缺少 `<summary>` 標籤，完整回應視為 summary 內容，記錄 `warn` 日誌 |
+
+---
+
+## Token 節省估算
+
+| 指標 | 數值 |
+|------|------|
+| `<analysis>` 佔一般審查回應比例 | 50–70% |
+| 每次審查節省 token | 1,000–3,500 |
+| Fix Loop 3 輪累計節省 | 3,000–10,500 |
+| 備註 | 節省效果在重複審查場景（Fix Loop、Feedback Loop）中累積 |
+
+---
+
+## 適用 Agent
+
+- DevAP Judge Agent
+- VibeOps Evaluator Agent
+- VibeOps Guardian Agent
+- 任何 LLM 驅動的 AutoCompact／摘要組件
+
+---
+
+## 錯誤碼
+
+| 代碼 | 說明 |
+|------|------|
+| `DPO-001` | `summary` 標籤缺失 — 降級相容已啟用 |
+| `DPO-002` | `analysis` 標籤缺失 — 完整回應照常處理 |
+| `DPO-003` | `summary` 必填欄位缺失 — 解析錯誤 |