universal-dev-standards 5.17.0 → 6.1.0

package/bundled/locales/zh-CN/skills/workflows/README.md

@@ -0,0 +1,451 @@
+---
+source: skills/workflows/README.md
+source_version: 1.0.0
+translation_version: 1.0.0
+status: current
+---
+
+# UDS Workflows
+
+> **语言**: [English](../../../../skills/workflows/README.md) | 简体中文
+
+**Version**: 1.1.0
+**Last Updated**: 2026-01-21
+**Status**: Experimental
+
+---
+
+## 概览
+
+UDS Workflows 通过 orchestrate 多个 agent 来完成复杂的开发任务。每个 workflow 定义一连串步骤，其中每个步骤可由 agent 执行，或需要人工介入。
+
+## Workflow YAML 格式
+
+### Schema
+
+```yaml
+name: workflow-name          # Unique identifier (kebab-case)
+version: 1.0.0               # Semantic version
+description: |               # Multi-line description
+  Brief description of the workflow.
+
+# Workflow metadata
+metadata:
+  author: universal-dev-standards
+  category: development       # development | review | testing | documentation
+  difficulty: intermediate    # beginner | intermediate | advanced
+  estimated_steps: 6          # Approximate number of steps
+
+# Prerequisites
+prerequisites:
+  - Project initialized with UDS
+  - Git repository configured
+  - AI tool with Task support (recommended)
+
+# Steps definition
+steps:
+  - id: step-1
+    name: Step Name
+    description: What this step does
+    type: agent               # agent | manual | conditional
+    agent: agent-name         # Required if type=agent
+    inputs:                   # Optional: what this step needs
+      - user_requirements
+    outputs:                  # Optional: what this step produces
+      - analysis_report
+
+  - id: step-2
+    name: Manual Step
+    type: manual
+    description: Human intervention required
+    instructions: |
+      Detailed instructions for the manual step.
+    checklist:
+      - [ ] Item 1
+      - [ ] Item 2
+
+  - id: step-3
+    name: Conditional Step
+    type: conditional
+    condition: analysis_report.has_issues
+    then:
+      agent: reviewer
+      task: Review and fix issues
+    else:
+      skip: true
+
+# Output artifacts
+outputs:
+  - name: final_report
+    description: Generated documentation
+    format: markdown
+```
+
+### RLM Context 配置 (v1.1.0)
+
+Workflow 可纳入受 RLM 启发的 context 处理机制，以应对大型代码库：
+
+```yaml
+# === RLM CONTEXT CONFIGURATION ===
+context-strategy:
+  enable-rlm: true                    # Enable RLM-aware processing
+  max-context-per-step: 100000        # Maximum tokens per step
+  context-inheritance: selective      # full | selective | summary
+
+steps:
+  - id: parallel-analysis
+    type: parallel-agents             # NEW: Execute agent on multiple inputs
+    agent: code-architect
+    foreach: ${modules}               # Dynamic iteration variable
+    context-mode: focused             # minimal | focused | full
+    merge-strategy: aggregate         # aggregate | sequential | summary
+    outputs: [analysis_results]
+```
+
+#### Context 继承模式
+
+| 模式 | 说明 | 使用场景 |
+|------|-------------|----------|
+| `full` | 将所有先前的 output 传递给下一个步骤 | 顺序分析 |
+| `selective` | 仅传递指定的 output | 内存效率高的 pipeline |
+| `summary` | 传递 output 的摘要版本 | 大规模处理 |
+
+#### 步骤的 Context 模式
+
+| 模式 | 说明 | Token 用量 |
+|------|-------------|-------------|
+| `minimal` | 仅必要的 context | 低 |
+| `focused` | 与当前项目相关的 context | 中 |
+| `full` | 完整可用的 context | 高 |
+
+#### 并行结果的 Merge 策略
+
+| 策略 | 说明 | Output 格式 |
+|----------|-------------|---------------|
+| `aggregate` | 将所有结果合并为数组 | 结果数组 |
+| `sequential` | 维持处理顺序 | 有序列表 |
+| `summary` | AI 生成的所有结果摘要 | 单一摘要 |
+
+### 步骤类型
+
+| 类型 | 说明 | 执行方式 |
+|------|-------------|-----------|
+| `agent` | 由 UDS agent 执行 | 自动 |
+| `manual` | 需要人工介入 | 交互式 |
+| `conditional` | 依条件分支 | 视条件而定 |
+| `parallel-agents` | 对多个输入并行执行 agent | 并行 (v1.1.0) |
+
+#### Parallel-Agents 步骤配置 (v1.1.0)
+
+```yaml
+- id: parallel-module-analysis
+  name: Analyze Modules in Parallel
+  type: parallel-agents
+  agent: code-architect
+  foreach: ${modules}           # Variable containing items to iterate
+  context-mode: focused         # minimal | focused | full
+  merge-strategy: aggregate     # How to combine results
+  max-concurrent: 3             # Optional: limit concurrent executions
+  timeout: 300                  # Optional: timeout per item (seconds)
+  inputs:                       # Optional: additional inputs
+    - project_context
+  outputs:
+    - module_analysis_results
+```
+
+## 内置 Workflows
+
+| Workflow | 步骤数 | 说明 |
+|----------|-------|-------------|
+| [integrated-flow](../../../../skills/workflows/integrated-flow.workflow.yaml) | 8 | 完整的 ATDD → SDD → BDD → TDD 循环 |
+| [feature-dev](../../../../skills/workflows/feature-dev.workflow.yaml) | 6 | 功能开发 workflow |
+| [code-review](../../../../skills/workflows/code-review.workflow.yaml) | 4 | 全面性 code review workflow |
+| [large-codebase-analysis](../../../../skills/workflows/large-codebase-analysis.workflow.yaml) | 4 | 针对 50+ 文件项目的 RLM 强化 workflow |
+
+## 用法
+
+### CLI 安装
+
+```bash
+# List available workflows
+uds workflow list
+
+# Install specific workflow
+uds workflow install integrated-flow
+
+# Install all workflows
+uds workflow install --all
+```
+
+### 执行
+
+Workflow 采逐步执行。对于支持 Task tool 的工具（Claude Code、OpenCode）：
+
+```
+User: Start the integrated-flow workflow for user authentication
+
+AI: Starting Integrated Development Flow...
+
+Step 1/8: Specification Workshop (spec-analyst)
+[Agent executes analysis...]
+
+Step 2/8: Spec Proposal (spec-analyst)
+[Agent drafts proposal...]
+
+Step 3/8: Spec Review (manual)
+Please review the specification:
+- [ ] Requirements are clear
+- [ ] Acceptance criteria defined
+- [ ] Risks identified
+
+[User confirms...]
+
+Step 4/8: Discovery (test-specialist)
+[Agent identifies test scenarios...]
+
+...continues...
+```
+
+### 不支持 Task 的工具
+
+Workflow 会转换为引导式检查清单：
+
+```markdown
+## Integrated Development Flow
+
+### Step 1: Specification Workshop
+**Agent**: spec-analyst
+**Task**: Analyze requirements and identify acceptance criteria
+
+[Copy this to your AI assistant]
+
+### Step 2: Spec Proposal
+...
+```
+
+## 创建自定义 Workflow
+
+### 1. 创建 Workflow 文件
+
+```bash
+mkdir -p .claude/workflows
+touch .claude/workflows/my-workflow.workflow.yaml
+```
+
+### 2. 定义 Workflow
+
+```yaml
+name: my-custom-workflow
+version: 1.0.0
+description: Custom workflow for my project
+
+steps:
+  - id: analyze
+    name: Analyze Requirements
+    type: agent
+    agent: spec-analyst
+    outputs: [requirements_doc]
+
+  - id: implement
+    name: Implementation
+    type: manual
+    description: Implement based on analysis
+
+  - id: review
+    name: Code Review
+    type: agent
+    agent: reviewer
+    inputs: [code_changes]
+```
+
+## Workflow vs Agent vs Skill
+
+| 维度 | Workflow | Agent | Skill |
+|--------|----------|-------|-------|
+| **目的** | orchestrate 多步骤流程 | 执行自主任务 | 提供知识／context |
+| **组成** | 包含多个 agent | 使用 skill 作为 context | 独立运作 |
+| **状态** | 追踪跨步骤的进度 | 单一任务状态 | 无状态 |
+| **用户参与** | 可包含人工步骤 | 最少 | 无 |
+
+## 以 Wave 为基础的并行执行 (v1.2.0)
+
+Workflow 中的步骤可分组为 **wave** 以进行并行执行。同一 wave 中的步骤彼此独立，可由不同的 sub-agent 并行执行。Wave 之间顺序执行——wave N 中的所有步骤都必须完成，wave N+1 才会开始。
+
+### Wave 配置
+
+```yaml
+steps:
+  # Wave 1: Independent analysis steps (run in parallel)
+  - id: analyze-requirements
+    name: Analyze Requirements
+    type: agent
+    agent: spec-analyst
+    wave: 1
+    outputs: [requirements_analysis]
+
+  - id: analyze-architecture
+    name: Analyze Architecture
+    type: agent
+    agent: code-architect
+    wave: 1
+    outputs: [architecture_analysis]
+
+  # Wave 2: Depends on wave 1 outputs (barrier point)
+  - id: design
+    name: Design Solution
+    type: agent
+    agent: code-architect
+    wave: 2
+    inputs: [requirements_analysis, architecture_analysis]
+    outputs: [design_doc]
+
+  # Manual steps are automatic barrier points
+  - id: review
+    name: Review Design
+    type: manual
+    wave: 3
+```
+
+### Wave 规则
+
+| 规则 | 说明 |
+|------|-------------|
+| **独立性** | 同一 wave 中的步骤不得彼此相依 |
+| **Barrier** | wave N 中的所有步骤必须完成，wave N+1 才会开始 |
+| **Manual barrier** | `manual` 类型步骤为自动 barrier 点 |
+| **选填字段** | `wave` 字段为选填；若未指定，步骤将顺序执行 |
+| **向后兼容** | 没有 wave 字段的 workflow 仍如以往运作 |
+
+---
+
+## 步骤验证 Pipeline (v1.2.0)
+
+每个 workflow 步骤可包含两层验证，灵感来自 CrewAI 的验证 pipeline 与 DSPy 的 metric 函数。
+
+### 两层验证
+
+```yaml
+steps:
+  - id: generate-spec
+    name: Generate Specification
+    type: agent
+    agent: spec-analyst
+    outputs: [spec_document]
+    validation:
+      # Layer 1: Deterministic (always runs first)
+      deterministic:
+        - check: file_exists
+          path: "docs/specs/{{spec_id}}.md"
+        - check: contains_sections
+          sections: [Summary, Motivation, "Acceptance Criteria"]
+        - check: ac_format
+          pattern: "Given .+, When .+, Then .+"
+
+      # Layer 2: Semantic (only runs if Layer 1 passes)
+      semantic:
+        - check: consistency
+          description: AC covers all requirements mentioned in Motivation
+        - check: completeness
+          description: No TODO or placeholder sections remain
+```
+
+### 验证规则
+
+| Layer | 类型 | 执行时机 | 失败时 |
+|-------|------|-------------|------------|
+| **Layer 1** | Deterministic | 永远最先执行 | 立即停止，显示修正选项 |
+| **Layer 2** | Semantic | Layer 1 通过后 | 警告，建议改善 |
+
+**Fail-fast 原则**：若 deterministic 验证失败，semantic 检查将完全跳过。这可避免在根本上已损坏的 output 上浪费时间进行质量评估。
+
+---
+
+## Agent Communication Protocol (v1.2.0)
+
+定义 agent 在 workflow 内如何交换数据。
+
+### 三个通信层
+
+| Layer | 机制 | 说明 |
+|-------|-----------|-------------|
+| **Artifact passing** | 以文件为基础 | 步骤产生文件作为 output；下游步骤通过文件路径读取 |
+| **Reducer patterns** | append / replace / merge | 多个 output 如何合并 |
+| **Context isolation** | 每步骤干净启动 | 每个 agent 步骤以干净 context 启动，仅接收指定的 input |
+
+### Reducer 模式
+
+```yaml
+steps:
+  - id: collect-reviews
+    type: parallel-agents
+    agent: reviewer
+    foreach: ${modules}
+    outputs: [review_results]
+    reducer: append        # Collect all results into array
+
+  - id: merge-configs
+    type: agent
+    agent: code-architect
+    inputs: [review_results]
+    reducer: merge         # Deep merge results into single object
+```
+
+| 模式 | 说明 | 使用场景 |
+|---------|-------------|----------|
+| `append` | 将所有结果收集为有序列表 | 并行 review、多模块分析 |
+| `replace` | 后到的 output 覆写先前的 | Config 覆写、最新者胜 |
+| `merge` | 将结果深度合并为单一对象 | 结合部分分析 |
+
+### Context Isolation
+
+每个 agent 步骤以**干净 context** 启动，仅包含：
+1. 该步骤声明的 `inputs`（来自前一步骤的 output）
+2. 该 agent 的 skill（来自 AGENT.md 的 `skills` 字段）
+3. Workflow 共享的 `prerequisites`
+
+这可防止 context 污染，并确保 agent 行为可重现。
+
+---
+
+## 最佳实践
+
+### 该做的
+
+- 将复杂任务拆解为离散步骤
+- 为关键决策纳入人工检查点
+- 为每个步骤定义清楚的 input／output
+- 使用 conditional 步骤进行错误处理
+- 清楚记录 prerequisites
+
+### 不该做的
+
+- 不要创建过长的 workflow（>10 步骤）
+- 不要跳过 review／verification 步骤
+- 不要假设所有工具都支持自动执行
+- 不要把步骤切得太细
+
+---
+
+## 相关资源
+
+- [Agents 文档](../agents/README.md)
+- [Skills 文档](../README.md)
+- [方法论系统](../dev-methodology/SKILL.md)
+
+---
+
+## 版本历史
+
+| Version | Date | Changes |
+|---------|------|---------|
+| 1.2.0 | 2026-03-17 | Added wave-based parallel execution, step validation pipeline, agent communication protocol |
+| 1.1.0 | 2026-01-21 | Added RLM context configuration, parallel-agents step type, large-codebase-analysis workflow |
+| 1.0.0 | 2026-01-20 | Initial release |
+
+---
+
+## License
+
+本文档以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 释出。
+
+**来源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)

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

@@ -1,8 +1,8 @@
 ---
 source: ../../CHANGELOG.md
-source_version: 5.17.0
-translation_version: 5.17.0
-last_synced: 2026-06-08
+source_version: 6.1.0
+translation_version: 6.1.0
+last_synced: 2026-07-17
 status: current
 ---
 
@@ -17,6 +17,94 @@ status: current
 
 ## [Unreleased]
 
+## [6.1.0] - 2026-07-17
+
+> **同一種形狀的兩個失敗，一個在標準裡、一個在 CLI 裡**：一道檢查跑了、回傳了、回報成功，卻什麼都沒量到。`verification-evidence` 補上了為它命名的那一層；`uds init` 則不再是它的一個實例。
+
+### 修正
+
+- **`uds init` 不再覆蓋既有的 `prepare` script**（XSPEC-341）。自 2026-02-04 起，`uds init` 會對任何沒有 `.husky/` 目錄的 Node 專案執行 `npx husky init`。該指令是為**全新**專案設計的一次性 bootstrap：它會無條件把 `"prepare"` 設成 `"husky"`。若你的專案原本就有 `prepare`——而對一個要發布的套件而言，`prepare` 通常就是 build 步驟——**它會被靜默取代**，而 CLI 回報成功。`uds init` 現在改為串接而非覆寫（`"tsup"` → `"tsup && husky"`），會印出它所修改的每一個 `package.json` 欄位，也不再丟棄 husky 的 stderr。
+
+  > **⚠️ 若你曾在原本就有 `prepare` script 的專案上跑過 `uds init`，請立即檢查。** 這次修正保護的是往後的執行；它無法還原一個已經被改寫的 `package.json`。症狀是：你預期看到自己的 build 指令，實際看到的卻是 `"prepare": "husky"`——而如果你的套件會發布建置產物（`files: ["dist"]`、`main` 指向 `dist/`）且沒有 `prepack`／`prepublishOnly`，那麼你下一次 `npm publish` 送出去的將是一個未建置或過期的目錄。請以串接方式復原：`"prepare": "<你原本的指令> && husky"`。
+
+- **`uds init` 不再把 `npm test` 塞進 `.husky/pre-commit`**（XSPEC-341）。那一行來自 husky 的 init 範本，不是來自 UDS——它等於在每一次 commit 上架了一道採用者從未選擇加入的完整測試套件閘門。UDS 現在只附加自己的 `npx uds check`，而且是附加到既有 hook 之後，而不是改寫它們。
+
+- **新建的 husky hook 改以 v9 格式寫入**（XSPEC-341）。fallback 的 hook 範本仍在輸出 v8 的 `#!/usr/bin/env sh` + `. "$(dirname -- "$0")/_/husky.sh"` 前導段，該寫法在 husky v9 已棄用、v10 已移除——而 `uds init` 安裝的正是 husky `^9`。這原本是潛伏問題（過去 hook 是由 husky init 寫出的）；移除 `husky init` 後，fallback 升為主要路徑，因此一併修正。
+
+### 變更
+
+- **`verification-evidence` 1.1.0 → 1.2.0 —— 證據有效性**（XSPEC-340）。本標準原本把 `exit_code` 當成事實真相：`trust_rules` 寫著「`exit_code ≠ 0` → 驗證失敗」、`physical_spec.checks` 問的是「`exit_code` 是否為 0（成功）？」、VE-002 只要非零就觸發修復迴圈。**這三處現已全數加上限定條件**，因為一道驗證指令可以跑完、可以回傳，卻什麼意義都沒有：
+  - **新增 `evidence_validity` 層次與規則 VE-007 – VE-010**：只有在「成功時回傳 0」的工具上，`exit_code = 0` 才代表成功（VE-007）；在證明查詢工具確實執行過之前，「空／查無／0」不等於不存在（VE-008）；存在性檢查不得丟棄 stderr（VE-009）；pipeline 的 exit code 不屬於其中任何單一階段（VE-010）。
+  - **新增 `non_evidence_claims`**：「已完成」／「應該可以了」／「我改了程式碼」／「測試應該會通過」／「指令回傳 0」。
+  - 有別於 `anti-hallucination`——後者的禁令全都是「不要斷言你沒查過的事」的變形。這裡是相反的失敗：**確實查了，而查詢工具靜默地沒有運作**。`core/verification-evidence.md` 收錄了十筆真實案例作為證據。
+- **`verification-evidence` 的人類文件補上了 v1.1.0 的落差。** v1.1.0 的 `environment_layer` 工作（XSPEC-204）已落地於全部三份 `.ai.yaml`，卻**一份 `.md` 都沒有更新**（共四份）——人類文件自 2026-05-13 起就一直在錯誤地描述這個標準。`core/*.md` 現已載明 `environment_layer`、Environment Layers 章節，以及 VE-005 / VE-006。
+- **`verification-evidence` 新增三個先前只存在於 zh-TW 譯文的章節**：非證據的聲明（Non-Evidence Claims）、證據類型（Evidence Types）、相關標準（Related Standards）。譯文比它的來源更完整；這些章節現已上溯至英文來源，並同時存在於兩個語系。
+
+## [6.0.0] - 2026-07-06
+
+> ⚠️ **重大版本（Major release）。** 包含一項 breaking 更名，並移除 8 個已棄用的機器可讀標準與 4 個已棄用的 CLI 命令（皆自 5.4.0 起帶有「將於 6.0.0 移除」告示）。**請參閱 [v6 遷移指南](docs/MIGRATION-v6.md)**（[English](../../docs/MIGRATION-v6.md) | [简体中文](../zh-CN/docs/MIGRATION-v6.md)）。
+
+### 變更 — BREAKING
+
+- **`review` 命令／skill 更名為 `code-review`**（T1）。`/review` 的呼叫端必須遷移至 `/code-review`；flow-id `review-flow` → `code-review-flow`。見遷移指南 §1。
+
+### 移除 — BREAKING（自 5.4.0 起排定）
+
+- **移除 8 個已棄用的 `.ai.yaml` 標準 stub**（runtime 已依 XSPEC-086/095 / DEC-049 於 5.4.0 移至 adoption layer）：`agent-communication-protocol`、`agent-dispatch`、`branch-completion`、`change-batching-standards`、`execution-history`、`pipeline-integration-standards`、`workflow-enforcement`、`workflow-state-protocol`。人類可讀的 `core/*.md` 文件保留作為參考（現列於 registry-check 的 REFERENCE_ONLY 清單）；registry 條目已移除。見遷移指南 §2。
+- **移除 4 個已棄用的 CLI 命令**：`uds start` / `uds mission:*`、`uds workflow:*`、`uds flow:*`、`uds sweep`（orchestration 屬 adoption layer 職責；`/sweep` skill 取代 `uds sweep`）。並清理引用已移除命令的死 i18n 鍵與過時的 in-CLI 提示（`config` next-steps、`quickstart` recipes）。見遷移指南 §3。
+
+### 新增 — 新標準（coverage-roadmap waves + 旗艦標準）
+
+- **領域與生命週期標準補齊**：product — `prd-standards`、`product-metrics`、`user-story-mapping`（XSPEC-069）；infra — `container-image`、`secret-management`、`iac-design`（XSPEC-065）；SRE — `incident-response`、`slo-sli`、`runbook`（XSPEC-063）；data engineering — `data-pipeline`、`schema-evolution`、`data-contract`（XSPEC-068）；compliance — `audit-trail`、`pii-classification`（XSPEC-066）。
+- **旗艦標準**：`verification-oracle`（XSPEC-256）、`model-provenance`（XSPEC-255）、`resource-cost-boundary`（XSPEC-277）。
+- **`user-journey-testing`** 以一級標準（first-class standard）身分發布（ai/standards + core + zh-TW + registry）。
+- **`logging-standards` 強制事件目錄（mandatory events catalog）**（XSPEC-234）。
+
+### 新增 — UDS Stage 2 硬化（T5–T16）
+
+- **Canonical AC 註記**（T5）：涵蓋 `acceptance-criteria-traceability` 與 worked examples。
+- **附出處的量化門檻**（T8）：`browser-compatibility` 95%/90% gate、`checkin` code-smell、`accessibility` session-timeout、`code-review` PR 大小／回應時間 + 大量變更例外、`project-context-memory` 7 天陳舊度、`developer-memory` 退役、`privacy` DPIA「large scale」。
+- **Failure Handling 章節**（T7）：`git-worktree` 暫時性失敗重試、`reverse-engineering` 升級（escalation）、`forward-derivation` 復原。
+- **跨職能交接**（T16）：`security-testing` finding-remediation 生命週期、`pii-classification` 發現與交接契約。
+- **Glossary 術語正規化**：作為 canonical 真實來源（T6）。
+- **CLI 硬化**（T11/T12）：Mission `FAILED` 終止狀態 + resume 防護、具 rollback 的 transactional `init`、`hitl`/`run`/`release`/config 的輸入驗證。
+
+### 新增 — 遷移與重構完整性家族
+
+- `migration-assistant` 切換後（post-cutover）資料對帳（XSPEC-284 P0）、狀態機與時序對等（XSPEC-287）；`full-coverage-testing` 遷移錯誤路徑完整性（XSPEC-288）；`performance-standards` 遷移非功能對等（XSPEC-286）。
+
+### 新增 — 工具與工作流程
+
+- **`/brainstorm` v4 的 BQS v1 品質契約**（XSPEC-296）。
+- **`ci-cd-assistant` skill 新增 CI Job Orchestration Patterns** — trigger 分離、共用資源序列化、change-detection gating、advisory vs gating、`npm ci` `EUSAGE` 疑難排解（UDS #126 / XSPEC-300）。
+- **`pipeline-security-gates` 新增部署前 attestation 驗證閘門**。
+- **release 流程新增發版前 issue/PR triage 閘門**（XSPEC-265）。
+- `release verify` 現在使用已記錄的 manifest checksum。
+- `/journey-test` 與 `/skill-builder` 註冊為正式命令。
+- 可選的 model-tier 註記（R6，XSPEC-270 Work Package A）。
+- `sync-standard` 四層同步工具；Phase 2 內容覆蓋稽核 metadata。
+
+### 新增 — 事故驅動的防漂移與可測試性
+
+- **`refactoring-standards` Semantic Duplication 與 Copy-Drift**（#142）：命名 Copy-Drift 反模式（同一領域事實在多處重複實作，或儲存的衍生彙總值與其來源之間沒有強制綁定——文字型重複度量測不到），以及 Single-Source-of-Truth / Derive-Don't-Duplicate 對策（每個事實一個單元、以推導取代儲存、儲存的彙總值在單一收斂點重算、以 golden + architecture 測試鎖住），另加遷移用的 Intentional-Divergence Registry。
+- **`mock-boundary` 可注入的背景執行**（#143）：將 in-process fire-and-forget 工作（`Task.Run`、未 await 的 promise、`setTimeout`、goroutine、executor）視為如同時鐘般的可注入接縫——production 保留真實 fire-and-forget，測試 dispatcher 則 inline 執行並追蹤 task 以達成確定性完成；新增 Poll/Sleep-for-Background-Result 反模式與 no-poll/sleep 規則。
+
+### 變更
+
+- **API versioning 與 deprecation 整併為單一真實來源** — producer 端的 API-versioning 內容併入 `api-design-standards`；不一致的 deprecation 時程已調和（XSPEC-298 R8）。
+- **`versioning` 新增 Deployment Version Identity 章節**，含 build-metadata 判別符（discriminator）注意事項（XSPEC-298 R1）。
+- **`versioning` 建置身分與多語言 versioning**（XSPEC-298 R2/R3）：.NET／JVM／多語言專案的 git-height 推導 versioning（MinVer / Nerdbank.GitVersioning / GitVersion）；建置身分升級為需求——已部署服務 MUST 經由 `/version`|`/health` 揭露 `version + commit sha + build time`，且 Phase-5 驗證 MUST 斷言 sha 與已部署 artifact 相符（#138）。
+
+### 棄用
+
+- **6 個 workflow skill** 標記為 `reference` 並附可見的棄用告示；已棄用的 runtime 命令加上結構化 `@superseded-by` 指標（XSPEC-291 §4）。
+
+### 修正
+
+- **`uds audit` 假陽性**：`options/` 檔案被誤報 missing（health check 現在會遞迴進子目錄）、CP950 主控台亂碼、非 TTY 崩潰（#115）；unused-standard 偵測改以 canonical id 而非檔名比對（#125）。
+- **Bundle ⇄ source 對等已恢復** — 25 個標準已同步進 `.standards/` self-adoption tree。
+- 多項 docs/i18n 完整性修正：過時的標準／skill／命令數量、壞掉的 locale 交叉連結、command/skill 索引重新產生、anchor-slugger 與 table-parity 路徑。
+
 ## [5.17.0] - 2026-06-08
 
 ### 新增 — 可執行 SDD 一致性與 AC 格式擴充（XSPEC-262/263/264）
@@ -494,9 +582,9 @@ status: current
   - `docs/CLI-INIT-OPTIONS.md`
   - `skills/commands/bdd.md`
   - `skills/commands/methodology.md`
-  - `skills/methodology-system/SKILL.md`
-  - `skills/methodology-system/create-methodology.md`
-  - `skills/methodology-system/runtime.md`
+  - `skills/dev-methodology/SKILL.md`
+  - `skills/dev-methodology/create-methodology.md`
+  - `skills/dev-methodology/runtime.md`
 - **文件**：更新穩定版本參考從 3.3.0 至 3.4.2
 
 ## [3.5.0-beta.10] - 2026-01-12

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

@@ -14,7 +14,7 @@ status: current
 
 Universal Development Standards 是一個語言無關、框架無關的文件化標準框架。它提供：
 
-- **核心規範** (`core/`)：125 個基礎開發標準
+- **核心規範** (`core/`)：149 個基礎開發標準
 - **AI 技能** (`skills/`)：用於 AI 輔助開發的 Claude Code 技能
 - **CLI 工具** (`cli/`)：用於採用標準的 Node.js CLI
 - **整合** (`integrations/`)：各種 AI 工具的配置

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

@@ -1,8 +1,9 @@
 ---
 source: ../../MAINTENANCE.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-04-22
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-07-08
+source_hash: 5d0adbbf7d63
 status: current
 ---
 
@@ -20,4 +21,50 @@ status: current
 
 日常維護請遵循 `CLAUDE.md` 中的驗證步驟（§Post-Modification Verification）。
 
-- [歸檔版本 v1.1.0](../../docs/archive/MAINTENANCE-v1.md) — 原始獨立指南
+- 歸檔版本 v1.1.0 — 原始獨立指南（歷史檔案已移除）
+
+## Bundle-Source 一致性（XSPEC-072 / DEC-045）
+
+npm bundle 標準（`cli/bundled/`，由 `ai/` 產生）必須是真實來源 `.standards/`
+的**子集**。布局契約定義於 DEC-045 §6.2。
+
+### 發版時強制（自動 — XSPEC-072 Phase 4.2）
+
+`scripts/bump-version.mjs`（及舊版 `bump-version.sh`）會在改動任何版本檔
+**之前**先跑 pre-flight 一致性閘門，一致性漂移即**中止發版**。等效手動指令：
+
+```bash
+cd cli
+npm run prepack                # 從 ai/ 重新產生 cli/bundled/
+npm run check:bundle-parity    # 必須以 exit 0 結束（source == bundled，扣除排除項）
+```
+
+Break-glass：`SKIP_BUNDLE_PARITY=1 node scripts/bump-version.mjs <version>`
+可跳過閘門（會大聲警告）——僅在工具鏈壞損**且**你已用其他方式確認一致性時使用。
+
+GHA 工作流程 `bundle-parity.yml` 會在 PR 和推送至 `main` 時，對任何不符獨立
+強制失敗。這兩點（發版閘門 + CI）即強制面；本地 pre-commit/pre-push hook
+（XSPEC-072 Phase 3.2）**刻意不加**——它會在每次 push 重跑 `prepack`，相較上述
+兩道閘門邊際效益太低。
+
+### 新增標準時的 bundle 決策流程（DEC-045 §6.2）
+
+在 `.standards/` 新增 `.ai.yaml` 時，決定其 bundle 範圍：
+
+1. **Bundle ⊂ Source** — 每個 bundle 檔案都須在 `.standards/` 有對應；不允許 bundle-only。
+2. **預設啟發式（規則 5）：** **level ≤ 2** 的 core 標準也進 bundle → 加入 `ai/standards/<name>.ai.yaml`（供採用者使用）。**level ≥ 3** 或治理／AI 協作類標準維持 source-only → 將其路徑加入 `cli/scripts/bundle-exclude.json`，格式 `{ "path", "reason" }`（可推翻）。
+3. **選項檔** → 一律採巢狀布局 `options/<category>/<choice>.ai.yaml`；禁止平坦路徑。
+4. **禁止歧義重複** — 兩個同 basename 但不同路徑的檔案必須歸一，不能並存。
+
+之後執行 `cd cli && npm run prepack && npm run check:bundle-parity`，確認 exit 0。
+
+### 若一致性檢查失敗
+
+1. **`.standards/` 中的新檔案不在 `ai/`** → 複製至 `ai/standards/`（若供採用者使用），或加入 `cli/scripts/bundle-exclude.json`（若僅供 UDS 內部使用）
+2. **`ai/` 中的新檔案不在 `.standards/`** → 複製至 `.standards/`
+3. **新選項檔案** → 確保同時存在於 `ai/options/<cat>/` 與 `.standards/options/<cat>/`
+
+## 翻譯版本
+
+- [繁體中文](./MAINTENANCE.md)
+- [简体中文](../zh-CN/MAINTENANCE.md)