universal-dev-standards 5.6.0 → 5.7.0

package/bundled/locales/zh-CN/core/token-budget.md

@@ -20,7 +20,7 @@ status: current
 
 ## 目的
 
-Token 阈值四区模型（SAFE/WARNING/DANGER/BLOCKING），统一 DevAP/VibeOps 的 token 用量管控行为。
+Token 阈值四区模型（SAFE/WARNING/DANGER/BLOCKING），统一各采用层的 token 用量管控行为。
 
 各 Agent 对于「快用完 token 了」的处理方式各异（有的直接截断、有的无警告、有的在最后才通知）。本标准定义四个阈值区间，确保所有 Agent 在进入不同区间时采取一致的行为（警告、简化输出、阻塞）。
 

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

@@ -1,8 +1,8 @@
 ---
 source: ../../CHANGELOG.md
-source_version: 5.6.0
-translation_version: 5.6.0
-last_synced: 2026-05-06
+source_version: 5.7.0
+translation_version: 5.7.0
+last_synced: 2026-05-08
 status: current
 ---
 
@@ -17,6 +17,52 @@ status: current
 
 ## [Unreleased]
 
+## [5.7.0] - 2026-05-08
+
+> **跨平台腳本遷移**（XSPEC-179 + XSPEC-180）：bash 腳本逐步被單一來源的
+> TypeScript / Node.js ESM 等價實作取代，可在 macOS / Linux / Windows 上以
+> 相同方式執行。原 `.sh` 檔保留並加上 `DEPRECATED` 警告以維持向後相容。
+
+### 新增
+
+- **AI 工具表格補全**（`README.md`、`locales/zh-TW/README.md`、`locales/zh-CN/README.md`）：補上五個遺漏工具——GitHub Copilot、OpenAI Codex、Aider、Continue、Google Antigravity。新增 ⚠ Minimal 狀態圖例。（`1b588e1`）
+- **`scripts/bump-version.mjs`**（XSPEC-179 Phase 1）：跨平台版本升版實作，與原 `.sh` 對等。（`1a44e14`）
+- **`scripts/install-hooks.mjs`**（XSPEC-179 Phase 1）：跨平台 git hooks 安裝程式；於 Windows 自動跳過 `chmod`。（`1a44e14`）
+- **`scripts/pre-commit.mjs`**（XSPEC-180）：pre-commit hook 的 Node.js ESM 實作，平台分支於 Windows 呼叫 `check-translation-sync.ps1`，其他平台呼叫 `.sh`。（`1572869`）
+- **7 個 TypeScript 檢查腳本**（XSPEC-179 Phase 2，`0a26d14`）：從 bash 遷移至單一 TypeScript 來源，透過 `tsx` 執行：
+  - `scripts/check-ai-behavior-sync.ts`
+  - `scripts/check-commit-spec-reference.ts`
+  - `scripts/check-flow-gate-report.ts`
+  - `scripts/check-integration-commands-sync.ts`
+  - `scripts/check-registry-completeness.ts`
+  - `scripts/check-release-readiness-signoff.ts`
+  - `scripts/check-workflow-compliance.ts`
+- **`tsx@^4.20.0`** 加入 root `devDependencies`（XSPEC-179 Phase 2，`0a26d14`）。
+- **7 個 npm scripts** 串接 TypeScript 檢查腳本（`0a26d14`）：`check:ai-behavior`、`check:commit-spec`、`check:flow-gate`、`check:integration-commands`、`check:registry`、`check:release-signoff`、`check:workflow-compliance`。
+
+### 變更
+
+- **下游專案解耦**（6 批次，`ebe716c`–`2392c0f`）：所有公開敘述中對特定下游產品（DevAP / VibeOps）的直接引用已替換為採用層中性術語，涵蓋 130+ 個檔案。UDS 重申為純 MIT + CC BY 4.0 標準庫，與任何特定採用層無依賴關係。
+- **REGISTRY**：`roo-code` integration tier 從 `planned` 升為 `partial`；AI 工具表格中將 Roo Code 獨立成列（不再與 Cline 合併）。（`1b588e1`）
+- **`.githooks/pre-commit`**（XSPEC-180，`1572869`）：從 51 行 bash 縮減為 16 行 POSIX `sh` 薄殼層，將實際邏輯委派給 `scripts/pre-commit.mjs`。
+- **`scripts/bump-version.mjs`**（`19ad314`）：新增 `buildCmd()` 輔助函式，於 Windows 自動切換為 PowerShell + `.ps1` 來呼叫 `check-version-sync` / `check-translation-sync`，恢復 Windows 平台對等性。
+- **XSPEC-179 Phase 2 策略修訂**（`0a26d14`）：放棄先前的 `.sh` + `.ps1` 雙軌方案，改採**單一 TypeScript 來源**策略。單一 `.ts` 透過 `tsx` 在所有平台上行為一致，消除「只能在 Windows 驗證」的反饋落差。
+
+### 棄用
+
+- **`scripts/bump-version.sh`**（`1a44e14`）：標記為 DEPRECATED，由 `bump-version.mjs` 取代。
+- **`scripts/install-hooks.sh`**（`1a44e14`）：標記為 DEPRECATED，由 `install-hooks.mjs` 取代。
+- **7 個 legacy `check-*.sh` 腳本**（`0a26d14`）：對應的 `.ts` 版本（如上）已成為 canonical 實作。`.sh` 檔保留供 legacy Linux/macOS 環境使用，但不應再新增功能。
+
+### 移除
+
+- **`.devap/` 目錄**（`2392c0f`）：移除孤兒 DevAP dogfooding 安裝目錄。DevAP 已於 2026-04-28 退場（XSPEC-086/095）；UDS 現使用原生 `flows/commit.flow.yaml` 與 `scripts/bump-version.mjs`。
+
+### 修復
+
+- **`scripts/check-release-readiness-signoff.sh`**（`0a26d14`，於 TypeScript 移植時順帶修復的潛伏 bug）：原本錯誤的 `grep -c "0\n0"` 樣式（永遠無法比對到字面 `\n`）已修正，現在能可靠偵測缺漏的 sign-off 訊號。
+- **`scripts/check-integration-commands-sync.sh`**（`0a26d14`，於 TypeScript 移植時順帶修復的潛伏 bug）：消除 `find` 與下游 consumer 之間 broken pipe 引發的 SIGPIPE 噪音。
+
 ## [5.3.2] - 2026-04-27
 
 > **修補版本發布**：Bug 修復 —— `uds update -y` 現在會自動安裝/更新 Skills 和 Commands，不再只顯示提示訊息。
@@ -865,7 +911,8 @@ status: current
 - 範本：需求文件範本
 - 整合：OpenSpec 框架
 
-[Unreleased]: https://github.com/AsiaOstrich/universal-dev-standards/compare/v3.4.0...HEAD
+[Unreleased]: https://github.com/AsiaOstrich/universal-dev-standards/compare/v5.7.0...HEAD
+[5.7.0]: https://github.com/AsiaOstrich/universal-dev-standards/compare/v5.6.0...v5.7.0
 [3.4.0]: https://github.com/AsiaOstrich/universal-dev-standards/compare/v3.3.0...v3.4.0
 [3.3.0]: https://github.com/AsiaOstrich/universal-dev-standards/compare/v3.0.0...v3.3.0
 [3.0.0]: https://github.com/AsiaOstrich/universal-dev-standards/compare/v2.3.0...v3.0.0

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

@@ -14,7 +14,7 @@ status: current
 
 > **語言**: [English](../../README.md) | 繁體中文 | [简体中文](../zh-CN/README.md)
 
-**版本**: 5.6.0 | **發布日期**: 2026-04-13 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
+**版本**: 5.7.0 | **發布日期**: 2026-04-13 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
 
 語言無關、框架無關的軟體專案文件標準。透過 AI 原生工作流，確保不同技術堆疊之間的一致性、品質和可維護性。
 
@@ -106,12 +106,18 @@ graph TD
 | :--- | :--- | :---: | :---: | :--- |
 | **Claude Code** | ✅ 完整支援 | **29** | **33** | `CLAUDE.md` |
 | **OpenCode** | ✅ 完整支援 | **29** | **33** | `AGENTS.md` |
-| **Gemini CLI** | 🧪 預覽版 | **18+** | **20+** | `GEMINI.md` |
 | **Cursor** | ✅ 完整支援 | **核心** | **模擬支援** | `.cursorrules` |
-| **Cline / Roo Code**| 🔶 部分支援 | **核心** | **工作流** | `.clinerules` |
-| **Windsurf** | 🔶 部分支援 | ✅ | **規則書** | `.windsurfrules` |
+| **Roo Code** | ✅ 完整支援 | **核心** | **工作流** | `.roo/rules/` |
+| **Gemini CLI** | 🧪 預覽版 | **18+** | **20+** | `GEMINI.md` |
+| **Cline** | 🔶 部分支援 | **核心** | **工作流** | `.clinerules` |
+| **Windsurf** | 🔶 部分支援 | **核心** | **規則書** | `.windsurfrules` |
+| **GitHub Copilot** | 🔶 部分支援 | **核心** | **提示詞** | `.github/copilot-instructions.md` |
+| **OpenAI Codex** | 🔶 部分支援 | **核心** | — | `AGENTS.md` |
+| **Aider** | 🔶 部分支援 | — | — | `AGENTS.md` |
+| **Continue** | 🔶 部分支援 | — | — | `.continue/config.json` |
+| **Google Antigravity** | ⚠️ 最低限度 | — | — | `.antigravity/rules.md` |
 
-> **狀態圖例**：✅ 完整支援 | 🧪 預覽版 | 🔶 部分支援 | ⏳ 計畫中
+> **狀態圖例**：✅ 完整支援 | 🧪 預覽版 | 🔶 部分支援 | ⚠️ 最低限度 | ⏳ 計畫中
 
 ---
 
@@ -153,28 +159,6 @@ uds uninstall   # 從專案移除標準
 
 ---
 
-## 🌐 生態系統
-
-UDS 是 AsiaOstrich 三層產品架構中的**標準定義層**：
-
-```
-UDS（定義什麼） → DevAP（代理人如何執行） → VibeOps（完整生命週期）
-```
-
-| 層級 | 產品 | 角色 | 授權 |
-|------|------|------|------|
-| 標準 | **UDS** | 開發方法論框架 | MIT + CC BY 4.0 |
-| 編排 | [DevAP](https://github.com/AsiaOstrich/dev-autopilot) | 代理人無關的編排引擎 | MIT |
-| 生命週期 | [VibeOps](https://github.com/AsiaOstrich/vibeops360) | AI 驅動的軟體工廠 | AGPL-3.0-only |
-
-- **UDS** 定義開發標準 → 供 DevAP（品質 Gate）和 VibeOps（代理人管線）使用
-- **DevAP** 使用 UDS 標準編排 AI 代理人 → VibeOps 是其消費者之一
-- **VibeOps** 提供完整軟體生命週期 → 透過 `uds init` 整合 UDS（一次複製）
-
-UDS 保持**工具無關性**：支援 Claude Code、OpenCode、Gemini CLI、Cursor、Cline 和 Windsurf。DevAP 和 VibeOps 是消費者，並非必要依賴。
-
----
-
 ## 📄 授權
 
 | 元件 | 授權 |

package/bundled/locales/zh-TW/core/agent-communication-protocol.md

@@ -12,7 +12,7 @@ status: current
 
 **版本**: 1.0.0
 **最後更新**: 2026-03-30
-**適用性**: 跨專案 AI Agent 編排（UDS / DevAP / VibeOps）
+**適用性**: 跨採用層 AI Agent 編排（任意 Adapter / Pipeline / Agent runtime 消費 UDS 標準）
 **範圍**: 通用 (Universal)
 **相關標準**: [代理派遣](./agent-dispatch.md)、[AI 模型選擇策略](./model-selection.md)
 **規格**: [SPEC-AGENT-COMM-001](../../../docs/specs/SPEC-AGENT-COMM-001-agent-communication-protocol.md)
@@ -60,12 +60,12 @@ status: current
 | `timeout` | 任務超時 |
 | `unknown` | 無法識別的狀態（降級） |
 
-### 1.2 跨專案映射
+### 1.2 跨採用層映射
 
-跨專案狀態碼映射表：
+跨採用層狀態碼對映表（informative example，採用層自訂自己的對映）：
 
-| 統一狀態 | UDS | DevAP | VibeOps |
-|----------|-----|-------|---------|
+| 統一狀態 | UDS | Adapter Example A | Adapter Example B |
+|----------|-----|-------------------|-------------------|
 | `success` | DONE | success | success |
 | `success_partial` | DONE_WITH_CONCERNS | done_with_concerns | partial |
 | `failed` | — | failed | failure |

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

@@ -93,10 +93,10 @@ Fail-Closed 能力聲明：工具／Adapter／Agent 必須顯式聲明安全性
 
 ## 適用組件
 
-- DevAP AgentAdapter（ClaudeAdapter / OpenCodeAdapter / CliAdapter）
-- DevAP Tool 呼叫系統
-- VibeOps ToolExecutor
-- VibeOps Agent（planner / builder / evaluator 等）
+- AgentAdapter 實作（採用層；如 ClaudeAdapter / OpenCodeAdapter / CliAdapter）
+- Tool 呼叫系統（採用層）
+- ToolExecutor 實作（採用層）
+- Agent（採用層；planner / builder / evaluator 等）
 - 所有 MCP 工具插件
 
 ---

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

@@ -31,7 +31,7 @@ status: current
 - 任何重試機制必須使用斷路器包裝，不得直接無限重試
 - 斷路器狀態必須透過遙測可觀測（`circuit_breaker_state_change` 事件）
 - OPEN 狀態下的請求必須立即失敗（fail fast），不等待 timeout
-- `failureThreshold` 預設值為 3，與 claude-code-book 及 DevAP Fix Loop 一致
+- `failureThreshold` 預設值為 3，與 claude-code-book 及常見 Fix Loop 實作慣例一致
 - 斷路器必須按照「功能單元」建立，不得全域共享單一斷路器
 
 ---
@@ -93,12 +93,12 @@ status: current
 
 ## 適用場景
 
-- DevAP Fix Loop Agent 呼叫重試
-- DevAP Judge / Quality Gate 重試
-- DevAP API 呼叫（LLM API 不穩定保護）
-- VibeOps Feedback Loop 重試
-- VibeOps FLARE 主動檢索重試
-- VibeOps AutoCompact（原始靈感來源）
+- Fix Loop Agent 呼叫重試（採用層）
+- Judge / Quality Gate 重試（採用層）
+- LLM API 呼叫（不穩定保護；採用層）
+- Feedback Loop 重試（採用層）
+- FLARE 主動檢索重試（採用層）
+- AutoCompact 風格的對話壓縮（claude-code-book 為原始靈感來源）
 
 ---
 

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

@@ -116,9 +116,9 @@ IMPORTANT: The <analysis> block is your scratchpad. Only <summary> persists.
 
 ## 適用 Agent
 
-- DevAP Judge Agent
-- VibeOps Evaluator Agent
-- VibeOps Guardian Agent
+- Judge Agent（採用層）
+- Evaluator Agent（採用層）
+- Guardian Agent（採用層）
 - 任何 LLM 驅動的 AutoCompact／摘要組件
 
 ---

package/bundled/locales/zh-TW/core/failure-source-taxonomy.md

@@ -32,7 +32,7 @@ status: current
 - `failureSource` 為 optional 欄位，不得破壞現有不含此欄位的程式碼
 - 在同一失敗事件中，選擇最根本的來源作為 `failureSource`（例如 `branch_divergence` 比 `compilation` 更根本）
 - `failureSource` 應由偵測到失敗的元件設定（QualityGate / Adapter / SafetyHook / BranchDriftChecker）
-- 跨專案（DevAP / VibeOps）各自獨立定義 `FailureSource` type，語義保持一致
+- 各採用層各自獨立定義 `FailureSource` type，語義保持一致
 
 ---
 
@@ -134,13 +134,11 @@ test_failure | tool_failure | policy_violation | resource_exhaustion
 
 ## 整合點
 
-### DevAP
+> 整合指引（informative；具體檔案路徑屬於採用層自訂範圍）。
 
-- `packages/core/src/types.ts` — `TaskResult.failureSource` / `FailureSource` type
-- `packages/core/src/quality-gate.ts` — `QualityGateResult.failureSource` 推斷
-- `packages/adapter-claude/src/claude-adapter.ts` — `resource_exhaustion` 映射
+### 預期呼叫點
 
-### VibeOps
-
-- `src/types/index.ts` — `IterationRecord.failureSource`（獨立定義，AGPL 隔離）
-- `src/runner/pipeline-runner.ts` — `agent:error` 事件 payload
+- 核心型別模組 — `TaskResult.failureSource` / `FailureSource` type
+- quality-gate 模組 — `QualityGateResult.failureSource` 推斷
+- agent adapter — `resource_exhaustion` / `network_error` 映射
+- pipeline runner — `agent:error` / `agent:retry` 事件 payload

package/bundled/locales/zh-TW/core/governance-layer.md

@@ -0,0 +1,159 @@
+---
+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 即不通過

package/bundled/locales/zh-TW/core/packaging-standards.md

@@ -12,19 +12,19 @@ status: current
 
 **版本**: 1.0.0
 **最後更新**: 2026-04-15
-**適用性**: 使用 UDS/DevAP 工具鏈的專案
+**適用性**: 使用 UDS-aware 工具鏈的專案
 **範圍**: 通用 (Universal)
 
 ---
 
 ## 目的
 
-本標準定義一套基於 Recipe 的打包框架，讓使用者專案可在 `.devap/packaging.yaml` 中宣告打包目標（target）。UDS 負責提供 Recipe 定義與內建 Recipe 函式庫；DevAP 則在 pipeline 中執行編排。
+本標準定義一套基於 Recipe 的打包框架，讓使用者專案可在 專案 packaging 配置（路徑由採用層決定） 中宣告打包目標（target）。UDS 負責提供 Recipe 定義與內建 Recipe 函式庫；採用層 runtime 在 pipeline 中執行編排。
 
 框架的關注點分離如下：
 - **使用者專案**：宣告「打包什麼」（targets + 設定覆蓋）
 - **UDS**：定義「如何打包」（Recipe 結構 + 內建 Recipes）
-- **DevAP**：執行「何時打包」（在 Review 與 Deploy 之間的 pipeline 階段）
+- **採用層 pipeline**：執行「何時打包」（在 Review 與 Deploy 之間的 pipeline 階段）
 
 ---
 
@@ -33,9 +33,9 @@ status: current
 | 原則 | 說明 |
 |------|------|
 | **Recipe-based** | 每個打包目標都參照一個具名 Recipe；不在 pipeline YAML 中撰寫臨時腳本 |
-| **宣告式 targets** | 專案在 `.devap/packaging.yaml` 中宣告 targets；DevAP 負責解析與執行 |
+| **宣告式 targets** | 專案在 專案 packaging 配置（路徑由採用層決定） 中宣告 targets；採用層 runtime 負責解析與執行 |
 | **可客製化** | 四個客製化層允許設定覆蓋、Hook 注入、自訂 Recipe 及 Escape Hatch |
-| **整合至 Pipeline** | 打包作為獨立階段運行於 VibeOps pipeline 的 Review 與 Deploy 之間 |
+| **整合至 Pipeline** | 打包作為獨立階段運行於 採用層 pipeline 的 Review 與 Deploy 之間 |
 
 ---
 
@@ -119,15 +119,15 @@ UDS 隨附四個內建 Recipe，位於 `recipes/` 目錄：
 
 | 層級 | 機制 | 使用時機 |
 |------|------|----------|
-| **L1 — 設定覆蓋** | `.devap/packaging.yaml` 中的 `config:` 區塊 | 更改預設值（registry URL、tag、輸出目錄）|
-| **L2 — Hook 注入** | `.devap/packaging.yaml` 中的 `hooks:` 區塊 | 在建置或發佈前後執行額外指令 |
-| **L3 — 自訂 Recipe** | 專案 `.devap/recipes/` 中的新 `.yaml` 檔案 | 完全不同的建置流程；內建 Recipe 不適用 |
+| **L1 — 設定覆蓋** | 專案 packaging 配置（路徑由採用層決定） 中的 `config:` 區塊 | 更改預設值（registry URL、tag、輸出目錄）|
+| **L2 — Hook 注入** | 專案 packaging 配置（路徑由採用層決定） 中的 `hooks:` 區塊 | 在建置或發佈前後執行額外指令 |
+| **L3 — 自訂 Recipe** | 專案 `.uds/recipes/` 中的新 `.yaml` 檔案 | 完全不同的建置流程；內建 Recipe 不適用 |
 | **L4 — Escape Hatch** | target 定義中以 `script:` 取代 `recipe:` | 原始 shell 腳本，無適合的 Recipe 抽象 |
 
 ### L1 範例 — 設定覆蓋
 
 ```yaml
-# .devap/packaging.yaml
+# .uds/packaging.yaml
 targets:
   - name: publish-npm
     recipe: npm-library
@@ -140,7 +140,7 @@ targets:
 ### L2 範例 — Hook 注入
 
 ```yaml
-# .devap/packaging.yaml
+# .uds/packaging.yaml
 targets:
   - name: docker-push
     recipe: docker-service
@@ -153,7 +153,7 @@ targets:
 ### L3 範例 — 自訂 Recipe
 
 ```yaml
-# .devap/recipes/electron-app.yaml
+# .uds/recipes/electron-app.yaml
 name: electron-app
 description: 建置 Electron 桌面應用程式
 requires:
@@ -169,7 +169,7 @@ config:
 ### L4 範例 — Escape Hatch
 
 ```yaml
-# .devap/packaging.yaml
+# .uds/packaging.yaml
 targets:
   - name: legacy-bundle
     script: |
@@ -187,9 +187,9 @@ targets:
 |------|------|------|
 | 所有 `requires` 檔案存在 | 100% | 在任何步驟執行前檢查 |
 | 所有步驟以 exit code 0 結束 | 100% | 任何非零 exit 使執行失敗 |
-| `postBuild` 產出物存在 | 存在於預期路徑 | 建置步驟後由 DevAP 驗證 |
+| `postBuild` 產出物存在 | 存在於預期路徑 | 建置步驟後由採用層 runtime 驗證 |
 | Hook 指令以 exit code 0 結束 | 100% | Hook 失敗會傳播為步驟失敗 |
-| 已發佈產出物可被取回 | HTTP 200 / registry 查詢成功 | 由 DevAP 在發佈後進行 smoke check |
+| 已發佈產出物可被取回 | HTTP 200 / registry 查詢成功 | 由採用層 runtime 在發佈後進行 smoke check |
 
 ### 失敗處理
 

package/bundled/locales/zh-TW/core/recovery-recipe-registry.md

@@ -133,14 +133,11 @@ fix_loop | circuit_breaker | rebase_and_retry | model_switch | degraded_mode | h
 
 ## 整合點
 
-### DevAP
+> 整合指引（informative；具體檔案路徑屬於採用層自訂範圍）。
 
-- `packages/core/src/types.ts` — `RecoveryRecipe` / `RecoveryStrategy` type
-- `packages/core/src/recovery-registry.ts` — Registry 實作與預設 recipe
-- `packages/core/src/orchestrator.ts` — fix loop 前查詢 Registry
+### 預期呼叫點
 
-### VibeOps
-
-- `src/types/index.ts` — 獨立定義 `RecoveryRecipe`（AGPL 隔離）
-- `src/runner/recovery-registry.ts` — 獨立實作
-- `recovery-recipes.yaml` — 預設 recipe 配置
+- 核心型別模組 — `RecoveryRecipe` / `RecoveryStrategy` type
+- recovery-registry 模組 — Registry 實作與預設 recipe
+- orchestrator 模組 — fix loop 前查詢 Registry
+- recovery-recipes 配置檔 — 預設 recipe 配置（檔名由採用層決定）

package/bundled/locales/zh-TW/core/security-decision.md

@@ -104,9 +104,9 @@ deny | ask | allow
 
 ## 適用組件
 
-- DevAP Safety Hook
-- VibeOps CommandPolicy
-- VibeOps Governance Framework（SPEC-049）
+- Safety Hook（採用層）
+- CommandPolicy（採用層）
+- Governance Framework（採用層；OPA / Cedar / 自訂 policy engine 皆可）
 - 任何多來源規則合併的安全仲裁場景
 
 ---

package/bundled/locales/zh-TW/core/standard-admission-criteria.md

@@ -66,7 +66,7 @@ status: current
 
 ### 4. AI-executable（AI 可消費）
 
-至少一個 DevAP QualityGate / VibeOps Agent prompt / Skill 能消費：
+至少一個採用層元件（Quality Gate / Agent prompt / Skill / IDE rule）能消費：
 
 - 定義清楚的 guidelines（每條可驗證）
 - 至少 2 個 Given-When-Then scenarios

package/bundled/locales/zh-TW/core/standard-lifecycle-management.md

@@ -85,7 +85,7 @@ Deprecated ──(遷移完成)────────→ Archived
 
 ## 情境範例
 
-- **情境 1 — Trial → Active**：`retry-standards` 處於 trial。2026-08-01 審視發現 DevAP Fix Loop 和 VibeOps Builder 均採用且無重大缺陷 → 轉 Active，`since=2026-08-01`，移除 `expires`
+- **情境 1 — Trial → Active**：`retry-standards` 處於 trial。2026-08-01 審視發現多個採用層（Fix Loop / Builder Agent 等）均採用且無重大缺陷 → 轉 Active，`since=2026-08-01`，移除 `expires`
 - **情境 2 — Trial 逾期自動 Archived**：某標準 trial 期限 2026-10-17 到期未通過驗證 → 狀態轉 Archived，記錄原因
 - **情境 3 — Deprecated 帶遷移**：`legacy-retry-logic` 被 `retry-standards` 取代 → `status=deprecated, supersedes=retry-standards, migration_guide=docs/migrations/retry-v1-to-v2.md`；Skill 使用時顯示警告
 

package/bundled/locales/zh-TW/core/token-budget.md

@@ -127,9 +127,9 @@ safe | warning | danger | blocking
 
 ## 適用場景
 
-- DevAP 任務執行（Task token 預算監控）
-- VibeOps 9-Agent Pipeline（跨 Agent 累積上下文監控）
-- VibeOps PipelineMemory Snip 觸發條件
+- Task 執行（Token 預算監控；採用層）
+- 多 Agent Pipeline（跨 Agent 累積上下文監控；採用層）
+- PipelineMemory Snip 觸發條件（採用層）
 - 任何有 `maxTotalTokens` 限制的 Agent 執行環境
 
 ---

package/bundled/skills/README.md

@@ -67,6 +67,29 @@ These skills provide standard guidance and workflows. They can be accessed via s
 
 > **Note**: For reference guides (e.g., Git Workflow, Logging, Error Codes), use the `/guide` command.
 
+## Skill Tiers (Listing Budget Optimization)
+
+> Background: Claude Code reserves a fraction of context (default 1%) for skill listings via `skillListingBudgetFraction`. With 40+ UDS skills and adopter-installed plugins, descriptions can be truncated. UDS organizes skills into three tiers so adopters can optionally suppress less-used descriptions while keeping skills callable via `/<name>`.
+>
+> See [DEC-061](https://github.com/AsiaOstrich/dev-platform/blob/main/cross-project/decisions/DEC-061-uds-skill-listing-budget.md) for the decision and tradeoffs. Reference settings live in [`examples/skill-overrides-recommended.json`](../examples/skill-overrides-recommended.json). Detailed tuning: [`docs/skill-budget-tuning.md`](../docs/skill-budget-tuning.md).
+
+### Tier 1 — Core (daily use)
+**Listing default**: `"on"` (full description shown). Always auto-discoverable.
+
+`commit-standards`, `push`, `git-workflow-guide`, `tdd-assistant`, `bdd-assistant`, `testing-guide`, `code-review-assistant`, `refactoring-assistant`, `requirement-assistant`, `spec-driven-dev`, `adr-assistant`, `dev-workflow-guide`, `checkin-assistant`
+
+### Tier 2 — Advanced (weekly use)
+**Listing default**: `"on"` (full description shown).
+
+`atdd-assistant`, `e2e-assistant`, `journey-test-assistant`, `contract-test-assistant`, `security-assistant`, `deploy-assistant`, `ci-cd-assistant`, `error-code-guide`, `logging-guide`, `documentation-guide`, `api-design-assistant`, `database-assistant`, `project-structure-guide`, `ai-instruction-standards`, `release-standards`, `changelog-guide`, `test-coverage-assistant`, `pr-automation-assistant`, `spec-derivation`, `reverse-engineer`, `project-discovery`, `dev-methodology`, `audit-assistant`, `docs-generator`
+
+### Tier 3 — Specialist (monthly or event-driven)
+**Listing default**: `"name-only"` in reference overrides — saves tokens; **still callable via `/<name>`**.
+
+`incident-response-assistant`, `observability-assistant`, `slo-assistant`, `runbook-assistant`, `retrospective-assistant`, `durable-execution-assistant`, `metrics-dashboard-assistant`, `migration-assistant`, `security-scan-assistant`, `brainstorm-assistant`, `skill-builder`
+
+> Tier rationale & criteria: [`flows/skill-tiering-rationale.md`](../flows/skill-tiering-rationale.md). Adopters may freely override the reference (promote a Tier 3 skill to `"on"` if they use it daily, or demote any to `"name-only"`).
+
 ## Tool Adapters
 
 Specific configurations for various AI tools are located in `skills/tools/`.

package/bundled/skills/atdd-assistant/SKILL.md

@@ -7,11 +7,10 @@ argument-hint: "[feature or spec | 功能或規格]"
 ---
 <!-- DEPRECATION NOTICE (XSPEC-086 Phase 4, 2026-04-28):
   ATDD lifecycle orchestration (5-phase: WORKSHOP→DISTILLATION→DEVELOPMENT→DEMO→DONE,
-  INVEST validation, AC→Gherkin conversion, RED/GREEN execution, PO sign-off gates) extracted to:
-  - DevAP flow: dev-autopilot/.devap/flows/atdd.flow.yaml
-  - DevAP CLI:  devap atdd (packages/cli/src/commands/atdd.ts)
-  This Skill retains: INVEST criteria table, ATDD cycle diagram, Gherkin AC format, Three Amigos structure.
-  Use `devap atdd` for enforced lifecycle; this Skill for format and principle reference.
+  INVEST validation, AC→Gherkin conversion, RED/GREEN execution, PO sign-off gates) relocated to
+  adoption layer (XSPEC-095, 2026-04-28). This Skill retains: INVEST criteria table, ATDD cycle
+  diagram, Gherkin AC format, Three Amigos structure.
+  For enforced lifecycle execution, use your adoption layer's toolchain.
 -->
 
 # ATDD Assistant | ATDD 助手

package/bundled/skills/bdd-assistant/SKILL.md

@@ -6,11 +6,10 @@ allowed-tools: Read, Write, Grep, Glob
 argument-hint: "[feature or spec | 功能或規格]"
 ---
 <!-- DEPRECATION NOTICE (XSPEC-086 Phase 4, 2026-04-28):
-  BDD lifecycle orchestration (4-phase cycle, Gherkin scaffolding, RED/GREEN execution) extracted to:
-  - DevAP flow: dev-autopilot/.devap/flows/bdd.flow.yaml
-  - DevAP CLI:  devap bdd (packages/cli/src/commands/bdd.ts)
-  This Skill retains: Gherkin format definition, Three Amigos structure, BDD cycle diagram.
-  Use `devap bdd` for enforced cycle; this Skill for format and principle reference.
+  BDD lifecycle orchestration (4-phase cycle, Gherkin scaffolding, RED/GREEN execution) relocated to
+  adoption layer (XSPEC-095, 2026-04-28). This Skill retains: Gherkin format definition, Three
+  Amigos structure, BDD cycle diagram.
+  For enforced lifecycle execution, use your adoption layer's toolchain.
 -->
 
 # BDD Assistant | BDD 助手