universal-dev-standards 5.5.0 → 5.7.0

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/release-readiness-gate.md

@@ -0,0 +1,11 @@
+---
+source: ../../../core/release-readiness-gate.md
+source_version: 1.0.0
+translation_version: 0.0.0
+last_synced: 2026-05-05
+---
+
+<!-- TODO: 待完整繁體中文翻譯 — Translation pending -->
+<!-- See source: core/release-readiness-gate.md -->
+
+> 此標準尚未完整翻譯。請參閱英文原文：[English](../../../core/release-readiness-gate.md)

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 助手

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

@@ -6,12 +6,10 @@ allowed-tools: Read, Grep, Glob, Bash(git diff:*), Bash(git status:*), Bash(npm
 disable-model-invocation: true
 ---
 <!-- DEPRECATION NOTICE (XSPEC-086 Phase 4, 2026-04-28):
-  Checkin workflow orchestration (gate execution sequence, abort logic) extracted to:
-  - DevAP flow: dev-autopilot/.devap/flows/checkin.flow.yaml
-  - DevAP CLI:  devap checkin (packages/cli/src/commands/checkin.ts)
-  - Flow spec:  dev-autopilot/standards/flow/checkin-gate-sequence.ai.yaml
-  This Skill retains: quality gate definitions, checklist items, never-commit rules.
-  Use `devap checkin` for enforced execution; this Skill for activity reference.
+  Checkin workflow orchestration (gate execution sequence, abort logic) relocated to adoption layer
+  (XSPEC-095, 2026-04-28). This Skill retains: quality gate definitions, checklist items,
+  never-commit rules.
+  For enforced execution, use your adoption layer's toolchain.
 -->
 
 # Check-in Assistant | 簽入助手

package/bundled/skills/code-review-assistant/SKILL.md

@@ -7,11 +7,10 @@ argument-hint: "[file path or branch | 檔案路徑或分支名稱]"
 disable-model-invocation: true
 ---
 <!-- DEPRECATION NOTICE (XSPEC-086 Phase 4, 2026-04-28):
-  Code review workflow orchestration (4-step sequence, outcome gating) extracted to:
-  - DevAP flow: dev-autopilot/.devap/flows/review.flow.yaml
-  - DevAP CLI:  devap review (packages/cli/src/commands/review.ts)
-  This Skill retains: 8 review category definitions, BLOCKING/IMPORTANT/SUGGESTION/QUESTION/NOTE prefix semantics.
-  Use `devap review` for enforced execution; this Skill for category and prefix reference.
+  Code review workflow orchestration (4-step sequence, outcome gating) relocated to adoption layer
+  (XSPEC-095, 2026-04-28). This Skill retains: 8 review category definitions,
+  BLOCKING/IMPORTANT/SUGGESTION/QUESTION/NOTE prefix semantics.
+  For enforced execution, use your adoption layer's toolchain.
 -->
 
 # Code Review Assistant | 程式碼審查助手

package/bundled/skills/commands/observability.md

@@ -9,3 +9,45 @@ argument-hint: "[--checklist | --maturity | --alerting | service name | 服務
 See [SKILL.md](../observability-assistant/SKILL.md) for full documentation.
 
 詳見 [SKILL.md](../observability-assistant/SKILL.md)。
+
+## AI Agent Behavior | AI 代理行為
+
+> Follows [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 進入路由
+
+| Input | AI Action |
+|-------|-----------|
+| `/observability` | 詢問目標服務，進行整體可觀測性評估 |
+| `/observability --checklist` | 直接執行可觀測性檢查清單 |
+| `/observability --maturity` | 執行成熟度評估並給出改善建議 |
+| `/observability --alerting` | 進入告警規則設計與審查流程 |
+| `/observability <service>` | 針對指定服務進行可觀測性分析 |
+
+### Interaction Script | 互動腳本
+
+1. 確認目標服務與現有可觀測性工具（Prometheus、Grafana、Datadog 等）
+2. 依選定模式執行評估或設計流程
+3. 展示現況分析與缺口報告
+
+**Decision: 可觀測性缺口**
+- IF 缺少 Metrics → 建議關鍵指標清單（RED/USE method）
+- IF 缺少 Tracing → 建議分散式追蹤導入步驟
+- IF 缺少 Logging → 建議結構化日誌規範
+- IF 告警規則不完整 → 建議補齊 SLO-based alerting
+
+🛑 **STOP**: 缺口分析完成後等待使用者確認優先補齊項目
+
+### Stop Points | 停止點
+
+| Stop Point | 等待內容 |
+|-----------|---------|
+| 現況評估報告後 | 使用者確認分析正確性 |
+| 改善建議展示後 | 使用者決定優先實施項目 |
+
+### Error Handling | 錯誤處理
+
+| Error Condition | AI Action |
+|-----------------|-----------|
+| 無法識別監控工具 | 詢問工具名稱或改以通用建議進行 |
+| 服務不存在或名稱不明 | 請使用者確認服務名稱或列出已知服務 |

package/bundled/skills/commands/runbook.md

@@ -9,3 +9,47 @@ argument-hint: "[create | drill | coverage] [alert name | 告警名稱]"
 See [SKILL.md](../runbook-assistant/SKILL.md) for full documentation.
 
 詳見 [SKILL.md](../runbook-assistant/SKILL.md)。
+
+## AI Agent Behavior | AI 代理行為
+
+> Follows [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 進入路由
+
+| Input | AI Action |
+|-------|-----------|
+| `/runbook` | 詢問目標告警或服務，進入 runbook 導覽選單 |
+| `/runbook create` | 啟動 runbook 建立流程 |
+| `/runbook create <alert>` | 針對指定告警直接建立 runbook |
+| `/runbook drill` | 啟動 runbook 演練模擬流程 |
+| `/runbook coverage` | 產生 runbook 覆蓋率報告 |
+
+### Interaction Script | 互動腳本
+
+1. 確認操作模式（建立 / 演練 / 覆蓋率）
+2. 依模式執行對應流程，收集必要資訊
+3. 輸出 runbook 草稿或報告
+
+**Decision: 建立模式**
+- IF 告警名稱已提供 → 直接填入模板並產生草稿
+- IF 告警名稱未提供 → 詢問告警名稱、嚴重程度、負責團隊
+
+**Decision: 演練模式**
+- 逐步模擬告警觸發情境，確認執行步驟可行性
+- IF 步驟有疑義 → 停止並請使用者確認或修正
+
+🛑 **STOP**: runbook 草稿產生後等待使用者審查與修正
+
+### Stop Points | 停止點
+
+| Stop Point | 等待內容 |
+|-----------|---------|
+| 草稿產生後 | 使用者審查並確認內容正確 |
+| 演練每個關鍵步驟後 | 使用者確認步驟可執行 |
+
+### Error Handling | 錯誤處理
+
+| Error Condition | AI Action |
+|-----------------|-----------|
+| 告警名稱不明確 | 請使用者提供告警名稱或描述觸發條件 |
+| 無現有 runbook 可演練 | 提示先執行 `create` 建立 runbook |

package/bundled/skills/commands/slo.md

@@ -9,3 +9,48 @@ argument-hint: "[create | review | budget] [service name | 服務名稱]"
 See [SKILL.md](../slo-assistant/SKILL.md) for full documentation.
 
 詳見 [SKILL.md](../slo-assistant/SKILL.md)。
+
+## AI Agent Behavior | AI 代理行為
+
+> Follows [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 進入路由
+
+| Input | AI Action |
+|-------|-----------|
+| `/slo` | 詢問目標服務，進入 SLO 設計導覽 |
+| `/slo create` | 啟動新 SLO 建立流程 |
+| `/slo create <service>` | 針對指定服務直接啟動 SLO 建立 |
+| `/slo review` | 審查現有 SLO 設定合理性 |
+| `/slo budget` | 查看 Error Budget 消耗狀況與建議 |
+
+### Interaction Script | 互動腳本
+
+1. 確認操作模式（建立 / 審查 / Error Budget）
+2. 依模式引導使用者完成 SLI 選擇、目標設定或現況分析
+3. 輸出 SLO 定義草稿或 Error Budget 報告
+
+**Decision: 建立模式**
+- 引導選擇 SLI 類型（Availability / Latency / Quality）
+- 詢問目標值（如 99.9%）與測量窗口（rolling 28d）
+- IF 目標值過高（>99.99%）→ 警告工程成本，建議先設較保守目標
+
+**Decision: Error Budget 模式**
+- IF budget 剩餘 < 10% → 建議暫停非必要發布
+- IF budget 已燒盡 → 提示凍結發布，優先處理可靠性
+
+🛑 **STOP**: SLO 草稿完成後等待使用者確認目標值與告警閾值
+
+### Stop Points | 停止點
+
+| Stop Point | 等待內容 |
+|-----------|---------|
+| SLI 選擇完成後 | 使用者確認選定的可靠性指標 |
+| SLO 草稿產生後 | 使用者審查目標值與告警設定 |
+
+### Error Handling | 錯誤處理
+
+| Error Condition | AI Action |
+|-----------------|-----------|
+| 服務無監控資料 | 建議先導入基礎 metrics，再設定 SLO |
+| 目標值格式錯誤 | 提示正確格式（如 `99.9%` 或 `0.999`） |

package/bundled/skills/journey-test-assistant/SKILL.md

@@ -199,5 +199,5 @@ describe.skipIf(!BASE_URL)("Platform Admin Journey — T-001 → T-010", () => {
 ## 參考
 
 - 標準：[user-journey-testing.ai.yaml](../../.standards/user-journey-testing.ai.yaml)
-- 相關 XSPEC：XSPEC-128（UDS 標準定義）、XSPEC-129（VibeOps 實作範例）
+- 相關 XSPEC：XSPEC-128（UDS 標準定義）
 - 相關 Skill：`/e2e`（AC 層測試）、`/atdd`（驗收條件定義）

package/bundled/skills/orchestrate/SKILL.md

@@ -164,4 +164,4 @@ After completing the task, run: {task.verify_command}
 | 版本 | 日期 | 變更 |
 |------|------|------|
 | 2.0.0 | 2026-04-28 | 升格為 UDS 正式 Skill；Step 1 改為 Claude-native 解析（移除 plan-resolver-cli.js 依賴）；新增 Quality Gate / Fix Loop 章節（XSPEC-097 Phase 3） |
-| 1.0.0 | 2026-04-09 | 初始發布（DevAP packages/cli/skills/） |
+| 1.0.0 | 2026-04-09 | 初始發布（從上游遷移） |

package/bundled/skills/plan/SKILL.md

@@ -231,4 +231,4 @@ Claude 對 plan.json 執行以下驗證（無需外部引擎）：
 | 版本 | 日期 | 變更 |
 |------|------|------|
 | 2.0.0 | 2026-04-28 | 升格為 UDS 正式 Skill；移除 [DEVAP] 標記；Step 9 改為 Claude-native 驗證（XSPEC-097 Phase 3） |
-| 1.0.0 | 2026-04-09 | 初始發布（DevAP packages/cli/skills/） |
+| 1.0.0 | 2026-04-09 | 初始發布（從上游遷移） |

package/bundled/skills/pr-automation-assistant/SKILL.md

@@ -10,11 +10,10 @@ argument-hint: "[branch name or PR number | 分支名稱或 PR 編號]"
 ---
 <!-- DEPRECATION NOTICE (XSPEC-086 Phase 4, 2026-04-28):
   PR lifecycle orchestration (5-step: CREATE→REVIEW→APPROVE→MERGE→CLEANUP,
-  size gate >400 lines block, CI gate, squash/merge strategy, gh CLI integration) extracted to:
-  - DevAP flow: dev-autopilot/.devap/flows/pr.flow.yaml
-  - DevAP CLI:  devap pr (packages/cli/src/commands/pr.ts)
-  This Skill retains: PR description template, merge strategy decision matrix, auto-review trigger rules.
-  Use `devap pr` for enforced lifecycle; this Skill for template and rule reference.
+  size gate >400 lines block, CI gate, squash/merge strategy, gh CLI integration) relocated to
+  adoption layer (XSPEC-095, 2026-04-28). This Skill retains: PR description template,
+  merge strategy decision matrix, auto-review trigger rules.
+  For enforced lifecycle execution, use your adoption layer's toolchain.
 -->
 
 # PR Automation Assistant | PR 自動化助手

package/bundled/skills/push/SKILL.md

@@ -238,7 +238,7 @@ After `/push` completes, the AI assistant should suggest:
 
 | Version | Date | Changes |
 |---------|------|---------|
-| 2.0.0 | 2026-04-28 | Restore workflow execution steps (DevAP decomposition XSPEC-097); remove deprecation notice |
+| 2.0.0 | 2026-04-28 | Restore workflow execution steps (XSPEC-097 採用層解耦); remove deprecation notice |
 | 1.0.0 | 2026-04-23 | Initial release — XSPEC-081 Phase 1 |
 
 ---

package/bundled/skills/spec-driven-dev/SKILL.md

@@ -6,11 +6,10 @@ allowed-tools: Read, Write, Grep, Glob, Bash(git:*)
 argument-hint: "[spec name or feature | 規格名稱或功能]"
 ---
 <!-- DEPRECATION NOTICE (XSPEC-086 Phase 4, 2026-04-28):
-  SDD lifecycle orchestration (7-phase state machine, phase transitions, gate checks) extracted to:
-  - DevAP flow: dev-autopilot/.devap/flows/sdd.flow.yaml
-  - DevAP CLI:  devap sdd (packages/cli/src/commands/sdd.ts) with --phase jump support
-  This Skill retains: spec format definition, state descriptions, delta operations, decision tree.
-  Use `devap sdd` for enforced lifecycle; this Skill for spec structure reference.
+  SDD lifecycle orchestration (7-phase state machine, phase transitions, gate checks) relocated to
+  adoption layer (XSPEC-095, 2026-04-28). This Skill retains: spec format definition, state
+  descriptions, delta operations, decision tree.
+  For enforced lifecycle execution, use your adoption layer's toolchain.
 -->
 
 # Spec-Driven Development Assistant | 規格驅動開發助手