universal-dev-standards 6.6.0 → 6.7.1

package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md

@@ -1,7 +1,7 @@
 # UDS 功能參考手冊
 
 > Universal Development Standards - 完整功能文件
-> Auto-generated | Last updated: 2026-08-12
+> Auto-generated | Last updated: 2026-08-17
 
 **Language**: [English](../../../docs/reference/FEATURE-REFERENCE.md) | 繁體中文 | [简体中文](../../zh-CN/docs/FEATURE-REFERENCE.md)
 
@@ -201,61 +201,61 @@
 
 | Skill | 說明 |
 |-------|-------------|
-| `ac-coverage` | "[UDS] Analyze AC-to-test traceability and coverage" |
-| `adr-assistant` | [UDS] Create, manage, and track Architecture Decision Records (ADR). |
-| `ai-collaboration-standards` | Prevent AI hallucination and ensure evidence-based responses when analyzing code or making suggestions. |
-| `ai-friendly-architecture` | Design AI-friendly architecture with explicit patterns, layered documentation, and semantic boundaries. |
-| `ai-instruction-standards` | Create and maintain AI instruction files (CLAUDE.md, AGENTS.md, .cursor/rules/, etc.) with proper structure. |
-| `api-design-assistant` | Guide API design following REST, GraphQL, and gRPC best practices. |
-| `atdd-assistant` | "[UDS] Guide through Acceptance Test-Driven Development workflow" |
-| `audit-assistant` | "[UDS] UDS Health & Feedback System" |
-| `bdd-assistant` | "[UDS] Guide through Behavior-Driven Development workflow" |
-| `brainstorm-assistant` | "[UDS] Structured AI-assisted brainstorming before spec creation" |
-| `changelog-guide` | "[UDS] Generate and maintain CHANGELOG.md entries" |
-| `checkin-assistant` | "[UDS] Pre-commit quality gates verification" |
-| `ci-cd-assistant` | Guide CI/CD pipeline design, configuration, and optimization. |
-| `code-review-assistant` | "[UDS] Perform systematic code review with checklist" |
-| `commit-standards` | "[UDS] Generate commit messages following Conventional Commits standard" |
-| `contract-test-assistant` | [UDS] Guide contract testing strategy for APIs and microservices. |
-| `database-assistant` | Guide database design, migration, and query optimization. |
-| `deploy-assistant` | Guide reliable deployments without CI/CD platforms (GitHub Actions / GitLab CI). |
-| `dev-methodology` | "[UDS] Manage development methodology workflow" |
-| `dev-workflow-guide` | "[UDS] Guide for mapping software development phases to UDS commands and features" |
-| `docs-generator` | "[UDS] Generate usage documentation from project sources" |
-| `documentation-guide` | Guide documentation structure, content requirements, and project documentation best practices. |
-| `durable-execution-assistant` | "[UDS] Guide workflow failure recovery with checkpoints, retries, and rollback" |
-| `e2e-assistant` | "[UDS] Generate E2E test skeletons from BDD scenarios" |
-| `error-code-guide` | Design consistent error codes following the PREFIX_CATEGORY_NUMBER format. |
-| `git-workflow-guide` | Guide Git branching strategies, branch naming, and merge operations. |
-| `incident-response-assistant` | Guide incident response, root cause analysis, and post-mortem documentation. |
-| `journey-test-assistant` | "[UDS] Generate coherent user journey test plans (TESTPLAN) and E2E skeletons from project description." |
-| `knowledge-graph` | "[UDS] Trace spec/decision/code impact chains via a knowledge graph (engine or Markdown fallback)" |
-| `logging-guide` | Implement structured logging with proper log levels and sensitive data handling. |
-| `metrics-dashboard-assistant` | "[UDS] Track development metrics, code quality indicators, and project health" |
-| `migration-assistant` | "[UDS] Guide code migration, framework upgrades, and technology modernization" |
-| `observability-assistant` | Guide observability setup, metrics design, and alerting configuration. |
-| `orchestrate` | Orchestrate multi-task execution plans using Claude's native Agent tool (DAG-based, no external engine). |
-| `plan` | Generate plan.json from Spec documents, OpenSpec changes, or free-text requirements. |
-| `pr-automation-assistant` | Guide pull request creation, review automation, and merge strategies. |
-| `project-discovery` | "[UDS] Assess project health, architecture, and risks before adding features" |
-| `project-structure-guide` | Guide for organizing project directories following language-specific best practices. |
-| `push` | AI-assisted safety layer for git push operations with quality gates and collaboration guardrails. |
-| `refactoring-assistant` | "[UDS] Guide refactoring decisions and strategy selection" |
-| `release-standards` | "[UDS] Guide release process and changelogs" |
-| `requirement-assistant` | "[UDS] Write user stories and requirements following INVEST criteria" |
-| `retrospective-assistant` | [UDS] Guide structured team retrospectives for Sprint and Release cycles. |
-| `reverse-engineer` | "[UDS] System archeology - reverse engineer code across Logic, Data, and Runtime dimensions" |
-| `runbook-assistant` | Guide runbook creation, maintenance, and drill exercises. |
-| `security-assistant` | Guide security review and vulnerability assessment following OWASP standards. |
-| `security-scan-assistant` | Guide automated security scanning, dependency auditing, and secret detection. |
-| `skill-builder` | "[UDS] Identify repeated processes and build Skills with the right development depth" |
-| `slo-assistant` | Guide SLI selection, SLO setting, and Error Budget management. |
-| `spec-derivation` | "[UDS] Derive BDD scenarios, TDD skeletons, or ATDD tables from specifications" |
-| `spec-driven-dev` | "[UDS] Create or review specification documents for Spec-Driven Development" |
-| `sweep` | Scan codebase for debug artifacts and code quality issues; optionally auto-fix safe patterns. |
-| `tdd-assistant` | "[UDS] Guide through Test-Driven Development workflow" |
-| `test-coverage-assistant` | "[UDS] Analyze test coverage and provide recommendations" |
-| `testing-guide` | Testing pyramid and test writing standards for UT/IT/ST/E2E. |
+| `ac-coverage` | [UDS] 分析驗收條件（AC）與測試之間的追蹤關係，並產生需求層級的覆蓋率報告。 |
+| `adr-assistant` | [UDS] 建立、管理並追蹤架構決策記錄（ADR）。 |
+| `ai-collaboration-standards` | 防止 AI 幻覺，確保分析程式碼或提出建議時給出以證據為基礎的回應。 |
+| `ai-friendly-architecture` | 設計 AI 友善架構，包含明確的模式、分層文件與語意邊界。 |
+| `ai-instruction-standards` | 建立並維護 AI 指令檔（CLAUDE.md、AGENTS.md、.cursor/rules/ 等），並採用適當結構。 |
+| `api-design-assistant` | 引導 API 設計，遵循 REST、GraphQL 與 gRPC 最佳實踐。 |
+| `atdd-assistant` | [UDS] 驗收測試驅動開發（ATDD）的參考資料：INVEST 準則、Gherkin 驗收條件格式與 Three Amigos 結構。 |
+| `audit-assistant` | [UDS] 診斷 UDS 安裝的健康狀態，並向上游提交結構化回饋。 |
+| `bdd-assistant` | [UDS] 行為驅動開發（BDD）的參考資料：Gherkin 的 Given-When-Then 格式與 Three Amigos 結構。 |
+| `brainstorm-assistant` | [UDS] 在規格出現之前執行的結構化多角色腦力激盪，並附帶評分品質關卡。 |
+| `changelog-guide` | [UDS] 以 Keep a Changelog 格式產生並維護 CHANGELOG.md 條目。 |
+| `checkin-assistant` | [UDS] 提交前品質關卡的參考資料：關卡定義、檢查清單項目，以及絕不可提交的規則。 |
+| `ci-cd-assistant` | 引導 CI/CD 管線的設計、設定與最佳化。 |
+| `code-review-assistant` | [UDS] 系統性程式碼審查的參考資料：八大審查類別，以及 BLOCKING/IMPORTANT/SUGGESTION 評論前綴。 |
+| `commit-standards` | [UDS] 產生符合 Conventional Commits 規範的 commit message，包含雙語格式。 |
+| `contract-test-assistant` | [UDS] 引導 API 與微服務的合約測試策略。 |
+| `database-assistant` | 引導資料庫設計、遷移與查詢最佳化。 |
+| `deploy-assistant` | 引導在沒有 CI/CD 平台（GitHub Actions／GitLab CI）的情況下完成可靠部署。 |
+| `dev-methodology` | [UDS] 為專案選擇並追蹤當前採用的開發方法論（SDD、BDD、TDD）。 |
+| `dev-workflow-guide` | [UDS] 把目前的軟體開發階段對應到正確的 UDS 指令與 Skill。 |
+| `docs-generator` | [UDS] 從專案原始檔產生使用文件（速查表、參考手冊、使用指南）。 |
+| `documentation-guide` | 引導文件結構、內容需求與專案文件的最佳實踐。 |
+| `durable-execution-assistant` | [UDS] 引導容錯工作流程設計，包含檢查點、重試策略與回滾計畫。 |
+| `e2e-assistant` | [UDS] 從 BDD 的 .feature 場景產生 E2E 測試骨架，並支援框架偵測與覆蓋缺口分析。 |
+| `error-code-guide` | 設計一致的錯誤碼，遵循 PREFIX_CATEGORY_NUMBER 格式。 |
+| `git-workflow-guide` | 引導 Git 分支策略、分支命名與合併操作。 |
+| `incident-response-assistant` | 引導事故回應、根因分析與事後檢討文件撰寫。 |
+| `journey-test-assistant` | [UDS] 從專案描述產生連貫的使用者旅程測試計畫（TESTPLAN）與旅程 E2E 骨架。 |
+| `knowledge-graph` | [UDS] 透過知識圖追蹤規格、決策與程式碼之間的影響鏈；沒有引擎時以 Markdown 後備方案運作。 |
+| `logging-guide` | 實作結構化日誌，包含適當的日誌層級與敏感資料處理。 |
+| `metrics-dashboard-assistant` | [UDS] 長期追蹤開發指標、程式碼品質指標與技術債。 |
+| `migration-assistant` | [UDS] 引導系統性的程式碼遷移、框架升級與技術現代化。 |
+| `observability-assistant` | 引導可觀測性建置、指標設計與告警設定。 |
+| `orchestrate` | 以 Claude 原生 Agent tool 編排多任務執行計畫（以 DAG 為基礎，不需外部引擎）。 |
+| `plan` | 從 Spec 文件、OpenSpec 變更或自由文字需求生成 plan.json。 |
+| `pr-automation-assistant` | 引導 pull request 建立、審查自動化與合併策略。 |
+| `project-discovery` | [UDS] 在既有程式碼庫新增功能之前，評估專案健康度、架構與風險。 |
+| `project-structure-guide` | 依各語言的最佳實踐組織專案目錄結構的指南。 |
+| `push` | AI 輔助的 git push 安全層，提供品質關卡與協作護欄。 |
+| `refactoring-assistant` | [UDS] 引導重構決策與策略選擇，包含「重構還是重寫」這個判斷。 |
+| `release-standards` | [UDS] 引導發布流程——語意化版本、發布模式，以及 start/finish/promote/deploy 的順序。 |
+| `requirement-assistant` | [UDS] 撰寫符合 INVEST 準則的使用者故事與需求。 |
+| `retrospective-assistant` | [UDS] 引導 Sprint 與 Release 週期的結構化團隊回顧。 |
+| `reverse-engineer` | [UDS] 系統考古——從邏輯、資料、執行環境三個維度對既有系統做反向工程。 |
+| `runbook-assistant` | 引導 Runbook 的撰寫、維護與演練。 |
+| `security-assistant` | 引導安全審查與弱點評估，遵循 OWASP 標準。 |
+| `security-scan-assistant` | 引導自動化安全掃描、相依套件稽核與機密偵測。 |
+| `skill-builder` | [UDS] 把重複的手動流程轉成範圍界定得宜的 Skill，過程中拿捏恰當的流程份量。 |
+| `slo-assistant` | 引導 SLI 選取、SLO 設定與 Error Budget 管理。 |
+| `spec-derivation` | [UDS] 從已核准的規格推導出 BDD 場景、TDD 骨架、整合與 E2E 測試，以及 ATDD 表格。 |
+| `spec-driven-dev` | [UDS] 在寫程式碼之前建立並審查規格文件——規格格式、狀態與差異操作。 |
+| `sweep` | 掃描程式碼庫中的除錯殘留與程式碼品質問題；可選擇自動修正安全的模式。 |
+| `tdd-assistant` | [UDS] 測試驅動開發（TDD）的參考資料：紅-綠-重構循環、FIRST 原則與 Arrange-Act-Assert 結構。 |
+| `test-coverage-assistant` | [UDS] 以八維度框架分析程式碼層級的測試覆蓋率，並建議該優先補上哪些缺口。 |
+| `testing-guide` | 測試金字塔，以及 UT/IT/ST/E2E 的測試撰寫標準。 |
 
 ---
 
@@ -299,7 +299,7 @@
 | `ai-command-behavior` | 1.0.0 | This standard defines a structure for specifying AI Agent runtime behavior in co |
 | `ai-friendly-architecture` | 1.0.0 | This standard defines architecture and documentation practices that maximize the |
 | `ai-instruction-standards` | 1.1.0 | This standard defines best practices for creating and maintaining AI instruction |
-| `ai-response-navigation` | 1.1.0 | This standard defines navigation behavior for AI responses: every substantive AI |
+| `ai-response-navigation` | 1.3.0 | This standard defines navigation behavior for AI responses: every substantive AI |
 | `alerting-standards` | 1.0.0 |  |
 | `anti-hallucination` | 1.5.1 | This standard defines strict guidelines for AI assistants to prevent hallucinati |
 | `anti-sycophancy-prompting` | 1.0.0 | This standard defines techniques and rules for designing prompts that elicit gen |
@@ -317,7 +317,7 @@
 | `chaos-injection-tests` | - |  |
 | `checkin-standards` | 1.8.0 | This standard defines quality gates that MUST be passed before committing code t |
 | `circuit-breaker` | - |  |
-| `class-level-fix` | 1.0.0 | A defect is almost never alone. It is one member of a set — one flag in a dispat |
+| `class-level-fix` | 1.1.0 | A defect is almost never alone. It is one member of a set — one flag in a dispat |
 | `code-review-checklist` | 1.4.0 | This standard provides a comprehensive checklist for reviewing code changes, ens |
 | `commit-message-guide` | 1.3.0 | Standardized commit messages improve code review efficiency, facilitate automate |
 | `container-image-standards` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 |  |
@@ -369,7 +369,7 @@
 | `model-provenance` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 |  |
 | `model-selection` | 2.1.0 | Define how to choose **which model** and **how deeply it should think** — two in |
 | `multi-environment-e2e-testing` | 1.0.0 | **Status**: Active | **Updated**: 2026-05-13 |  |
-| `mutation-testing` | 1.0.0 | Mutation testing evaluates test suite effectiveness by injecting artificial bugs |
+| `mutation-testing` | 1.1.0 | Mutation testing evaluates test suite effectiveness by injecting artificial bugs |
 | `no-cicd-deployment` | - |  |
 | `observability-standards` | 1.0.0 |  |
 | `packaging-standards` | 1.1.0 | This standard defines a Recipe-based packaging framework that enables user proje |
@@ -413,7 +413,7 @@
 | `slo-sli` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 |  |
 | `slo-standards` | 1.0.0 |  |
 | `smoke-test` | - |  |
-| `spec-driven-development` | 2.3.0 |  |
+| `spec-driven-development` | 2.4.0 |  |
 | `standard-admission-criteria` | - |  |
 | `standard-lifecycle-management` | - |  |
 | `structured-task-definition` | 1.0.0 |  |
@@ -424,14 +424,14 @@
 | `test-completeness-dimensions` | 1.1.0 | This document defines a systematic framework for evaluating test completeness. I |
 | `test-data-standards` | 1.0.0 |  |
 | `test-driven-development` | 1.2.0 |  |
-| `test-governance` | 1.1.0 |  |
+| `test-governance` | 1.2.0 |  |
 | `testing-standards` | 3.2.0 | This standard defines actionable testing rules and conventions for AI agents and |
 | `timeout-standards` | - |  |
 | `token-budget` | - |  |
 | `translation-lifecycle-standards` | 1.0.1 | Translation lifecycle standards: MISSING vs OUTDATED distinction, semver-aware s |
 | `user-journey-testing` | - |  |
 | `user-story-mapping` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 |  |
-| `verification-evidence` | 1.2.0 | Establish an "Iron Law" that no task can be claimed as complete without verifica |
+| `verification-evidence` | 1.3.0 | Establish an "Iron Law" that no task can be claimed as complete without verifica |
 | `verification-oracle` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 |  |
 | `versioning` | 1.5.0 | This standard defines how to version software releases using Semantic Versioning |
 | `virtual-organization-standards` | 1.0.0 | This standard treats the AI ecosystem as a "Virtual Organization." It defines ho |

package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md

@@ -2,10 +2,14 @@
 name: ac-coverage
 source: ../../../../skills/ac-coverage/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-05-28
+translation_version: 1.1.0
+last_synced: 2026-08-17
 scope: universal
-description: "[UDS] 分析驗收條件（AC）與測試之間的追蹤關係並產生覆蓋率報告"
+description: |
+  [UDS] 分析驗收條件（AC）與測試之間的追蹤關係，並產生需求層級的覆蓋率報告。
+  Use when: 稽核哪些驗收條件已有測試、從 SPEC 檔建立追蹤矩陣、發布前找出尚未被覆蓋的 AC。
+  Not for: 程式碼層級的行／分支／函式覆蓋率——請用 /coverage；補寫缺少的測試——請用 /tdd 或 /spec-derive。
+  Keywords: AC coverage, traceability, acceptance criteria, SPEC, traceability matrix, 驗收條件, 需求追蹤, 覆蓋率矩陣, 追蹤矩陣.
 allowed-tools: Read, Grep, Glob
 argument-hint: "[規格檔案路徑]"
 ---

package/bundled/locales/zh-TW/skills/adr-assistant/SKILL.md

@@ -3,10 +3,14 @@ name: adr-assistant
 source: ../../../../skills/adr-assistant/SKILL.md
 source_version: 1.0.0
 source_hash: 7d8bf5944cf4
-translation_version: 1.0.0
-last_synced: 2026-06-01
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
-description: "[UDS] 建立、管理和追蹤架構決策記錄（ADR）"
+description: |
+  [UDS] 建立、管理並追蹤架構決策記錄（ADR）。
+  Use when: 架構決策、技術選型、設計取捨、模式選擇。
+  Not for: 不改變架構的決策——記在規格或 commit 裡即可；想法還沒成形到足以下決定——請用 /brainstorm。
+  Keywords: ADR, architecture decision, decision record, trade-off, 架構決策, 決策記錄, 設計取捨.
 ---
 
 # 架構決策記錄助手

package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md

@@ -2,13 +2,14 @@
 name: ai-collaboration-standards
 source: ../../../../skills/ai-collaboration-standards/SKILL.md
 source_version: 1.1.0
-translation_version: 1.1.0
-last_synced: 2026-05-28
+translation_version: 1.2.0
+last_synced: 2026-08-17
 status: current
 description: |
-  [UDS] 防止 AI 幻覺、確保分析程式碼或提建議時以證據為基礎的回應。
-  Use when: analyzing code, making recommendations, providing options, or when user asks about confidence/certainty.
-  Keywords: certainty, assumption, inference, evidence, source, 證據, 假設, 推論.
+  防止 AI 幻覺，確保分析程式碼或提出建議時給出以證據為基礎的回應。
+  Use when: 分析程式碼、提出建議、提供選項，或使用者詢問把握度／確定性時。
+  Not for: 撰寫 AI 指令檔本身——請用 /ai-instruction-standards；審查具體的 diff——請用 /code-review。
+  Keywords: certainty, assumption, inference, evidence, source, 證據, 假設, 推論, 確定性, 反幻覺.
 ---
 
 # AI 協作標準

package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md

@@ -2,11 +2,15 @@
 name: ai-friendly-architecture
 source: ../../../../skills/ai-friendly-architecture/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-02-05
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
 scope: universal
-description: "[UDS] 設計 AI 友善架構，包含明確模式、分層文件和語義邊界"
+description: |
+  設計 AI 友善架構，包含明確的模式、分層文件與語意邊界。
+  Use when: 為 AI 協作規劃專案結構、最佳化程式碼庫以利 AI 分析、建立 AI 上下文。
+  Not for: 撰寫指令檔本身——請用 /ai-instruction-standards；依語言慣例安排目錄配置——請用 /project-structure-guide。
+  Keywords: architecture, AI-friendly, context, modules, documentation layers, .ai-context.yaml, 架構, AI 友善, 上下文, 語意邊界.
 ---
 
 # AI 友善架構指南

package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md

@@ -2,11 +2,15 @@
 name: ai-instruction-standards
 source: ../../../../skills/ai-instruction-standards/SKILL.md
 source_version: 2.0.0
-translation_version: 2.0.0
-last_synced: 2026-04-28
+translation_version: 2.1.0
+last_synced: 2026-08-17
 status: current
 scope: partial
-description: "[UDS] 建立和維護 AI 指令檔案（CLAUDE.md、AGENTS.md、.cursor/rules/ 等）並採用適當結構"
+description: |
+  建立並維護 AI 指令檔（CLAUDE.md、AGENTS.md、.cursor/rules/ 等），並採用適當結構。
+  Use when: 建立 AI 指令檔、區分通用規則與專案特定規則、設定 AI 工具。
+  Not for: 調整程式碼庫結構讓 AI 好導覽——請用 /ai-friendly-architecture；要求以證據為基礎的回答——請用 /ai-collaboration-standards。
+  Keywords: CLAUDE.md, AGENTS.md, cursorrules, windsurfrules, clinerules, AI instructions, system prompt, 指令檔, AI 設定, 系統提示詞.
 ---
 
 # AI 指令檔案標準指南

package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md

@@ -2,10 +2,14 @@
 name: api-design-assistant
 source: ../../../../skills/api-design-assistant/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-03-23
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
-description: "[UDS] 引導 API 設計，遵循 REST、GraphQL 和 gRPC 最佳實踐"
+description: |
+  引導 API 設計，遵循 REST、GraphQL 與 gRPC 最佳實踐。
+  Use when: 設計 API、審查端點、API 版本策略決策。
+  Not for: 驗證運行中的 API 是否符合消費端期待——請用 /contract-test；API 背後的 schema 設計——請用 /database。
+  Keywords: API, REST, GraphQL, gRPC, endpoint, versioning, 介面設計, 端點, 版本策略.
 ---
 
 # API 設計助手

package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md

@@ -2,10 +2,14 @@
 name: atdd-assistant
 source: ../../../../skills/atdd-assistant/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-02-10
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
-description: "[UDS] 引導驗收測試驅動開發（ATDD）流程，用於定義和驗證使用者故事"
+description: |
+  [UDS] 驗收測試驅動開發（ATDD）的參考資料：INVEST 準則、Gherkin 驗收條件格式與 Three Amigos 結構。
+  Use when: 與 Product Owner 一起定義驗收條件、進行規格工作坊、用 INVEST 檢視使用者故事。
+  Not for: 執行 ATDD 生命週期或強制 PO 簽核關卡——該部分已移至採用層（XSPEC-095）；撰寫單元測試——請用 /tdd。
+  Keywords: ATDD, acceptance test, acceptance criteria, INVEST, specification workshop, Three Amigos, 驗收測試驅動開發, 驗收條件, 規格工作坊.
 ---
 
 # ATDD 助手

package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md

@@ -2,10 +2,14 @@
 name: audit-assistant
 source: ../../../../skills/audit-assistant/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-03-04
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
-description: "[UDS] UDS 健康檢查與回饋系統，診斷安裝完整性與偵測開發模式"
+description: |
+  [UDS] 診斷 UDS 安裝的健康狀態，並向上游提交結構化回饋。
+  Use when: .standards/ 看起來壞掉或不同步、驗證 manifest 完整性、回報既有 UDS 標準用起來的摩擦點。
+  Not for: 稽核你自己應用程式的程式碼品質——請用 /metrics 或 /code-review；相依套件與機密掃描——請用 /scan。
+  Keywords: UDS audit, health check, manifest integrity, standards feedback, friction, 安裝健康, 標準稽核, 回饋, 完整性檢查.
 ---
 
 # 審計助手

package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md

@@ -2,10 +2,14 @@
 name: bdd-assistant
 source: ../../../../skills/bdd-assistant/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-02-10
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
-description: "[UDS] 引導行為驅動開發（BDD）流程，使用 Given-When-Then 格式撰寫場景"
+description: |
+  [UDS] 行為驅動開發（BDD）的參考資料：Gherkin 的 Given-When-Then 格式與 Three Amigos 結構。
+  Use when: 撰寫或審查 .feature 場景、選定通用語言、針對行為進行探索式對話。
+  Not for: 執行 BDD 生命週期或 RED/GREEN 自動化——該部分已移至採用層（XSPEC-095）；把 .feature 檔轉成 E2E 骨架——請用 /e2e。
+  Keywords: BDD, Gherkin, Given When Then, feature file, scenario, Three Amigos, 行為驅動開發, 場景, 特性檔, 通用語言.
 ---
 
 # BDD 助手

package/bundled/locales/zh-TW/skills/brainstorm-assistant/SKILL.md

@@ -2,11 +2,15 @@
 name: brainstorm-assistant
 source: ../../../../skills/brainstorm-assistant/SKILL.md
 source_version: 4.1.0
-source_hash: 0c1fa3392232
-translation_version: 4.1.0
-last_synced: 2026-07-09
+source_hash: 711404f2c4af
+translation_version: 4.2.0
+last_synced: 2026-08-17
 status: current
-description: "[UDS] 在撰寫規格前進行結構化 AI 輔助腦力激盪"
+description: |
+  [UDS] 在規格出現之前執行的結構化多角色腦力激盪，並附帶評分品質關卡。
+  Use when: 想法還很模糊、在敲定方向前探索替代方案、需要多樣性而不是第一個看似合理的答案。
+  Not for: 方向已經定了的工作規劃——請用 /plan 或 /sdd；記錄已經做成的決策——請用 /adr。
+  Keywords: brainstorm, ideation, divergence, convergence, persona ensemble, devil advocate, 腦力激盪, 發想, 發散收斂, 多角色.
 ---
 
 # 腦力激盪助手

package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md

@@ -2,10 +2,14 @@
 name: changelog-guide
 source: ../../../../skills/changelog-guide/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-02-10
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
-description: "[UDS] 根據 Keep a Changelog 格式產生和維護 CHANGELOG.md 條目"
+description: |
+  [UDS] 以 Keep a Changelog 格式產生並維護 CHANGELOG.md 條目。
+  Use when: 從 commit 歷史撰寫變更日誌條目、填寫 Unreleased 區段、將變更分類為 Added/Changed/Fixed。
+  Not for: 決定下一個版本號或執行發版——請用 /release；撰寫 commit message 本身——請用 /commit。
+  Keywords: changelog, CHANGELOG.md, Keep a Changelog, release notes, unreleased, 變更日誌, 發布說明, 版本紀錄.
 ---
 
 # 變更日誌助手

package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md

@@ -2,10 +2,14 @@
 name: checkin-assistant
 source: ../../../../skills/checkin-assistant/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-02-10
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
-description: "[UDS] 在提交程式碼前驗證品質關卡，確保程式碼庫穩定性"
+description: |
+  [UDS] 提交前品質關卡的參考資料：關卡定義、檢查清單項目，以及絕不可提交的規則。
+  Use when: 決定 commit 前必須通過哪些檢查、稽核專案實際強制了哪些品質關卡、確認是否已可簽入。
+  Not for: 執行關卡流程或中止 commit——該部分已移至採用層（XSPEC-095）；找出並清除除錯殘留——請用 /sweep。
+  Keywords: check-in, pre-commit, quality gate, commit readiness, never commit, 簽入, 提交前檢查, 品質關卡, 檢查清單.
 ---
 
 # 簽入助手

package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md

@@ -2,10 +2,14 @@
 name: ci-cd-assistant
 source: ../../../../skills/ci-cd-assistant/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-03-24
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
-description: "[UDS] 引導 CI/CD 管線設計、配置和優化"
+description: |
+  引導 CI/CD 管線的設計、設定與最佳化。
+  Use when: 建置管線、縮短建置時間、設定部署階段。
+  Not for: 沒有 CI/CD 平台的部署——請用 /deploy；版本號遞增與晉級——請用 /release。
+  Keywords: CI/CD, pipeline, GitHub Actions, deployment, build, 持續整合, 持續部署, 管線.
 ---
 
 # CI/CD 管線助手

package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md

@@ -2,10 +2,14 @@
 name: code-review-assistant
 source: ../../../../skills/code-review-assistant/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-02-10
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
-description: "[UDS] 使用標準化檢查清單執行系統性程式碼審查"
+description: |
+  [UDS] 系統性程式碼審查的參考資料：八大審查類別，以及 BLOCKING/IMPORTANT/SUGGESTION 評論前綴。
+  Use when: 審查 pull request 或 diff、決定審查意見的措辭與優先序、與團隊議定審查範圍。
+  Not for: 執行有關卡的審查流程——該部分已移至採用層（XSPEC-095）；提交前的關卡驗證——請用 /checkin。
+  Keywords: code review, pull request review, review checklist, BLOCKING, comment prefix, 程式碼審查, 審查類別, 評論前綴, 審查清單.
 ---
 
 # 程式碼審查助手

package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md

@@ -3,10 +3,14 @@ name: commit-standards
 source: ../../../../skills/commit-standards/SKILL.md
 source_version: 1.0.0
 source_hash: 8535f438ced8
-translation_version: 1.0.0
-last_synced: 2026-06-01
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
-description: "[UDS] 根據 Conventional Commits 規範產生格式正確的 commit message"
+description: |
+  [UDS] 產生符合 Conventional Commits 規範的 commit message，包含雙語格式。
+  Use when: 為已暫存的變更撰寫 commit message、選擇 type 與 scope、產出英文與中文並列的主旨與內文。
+  Not for: 判斷這份變更是否已可提交——請用 /checkin；把多個 commit 彙整成發布說明——請用 /changelog。
+  Keywords: commit message, Conventional Commits, feat, fix, refactor, scope, bilingual, 提交訊息, 雙語 commit, 提交規範.
 ---
 
 # Commit Message 助手

package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md

@@ -3,10 +3,14 @@ name: contract-test-assistant
 source: ../../../../skills/contract-test-assistant/SKILL.md
 source_version: 1.0.0
 source_hash: f67623eb913a
-translation_version: 1.0.0
-last_synced: 2026-06-01
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
-description: "[UDS] 引導 API 和微服務的合約測試策略"
+description: |
+  [UDS] 引導 API 與微服務的合約測試策略。
+  Use when: API 合約、微服務、消費者驅動測試、提供者驗證。
+  Not for: 一開始的 API 介面設計——請用 /api-design；經由 UI 的使用者可見流程——請用 /e2e。
+  Keywords: contract test, Pact, OpenAPI, consumer-driven, provider, 合約測試, 消費者驅動, 提供者驗證.
 ---
 
 # 合約測試助手

package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md

@@ -2,10 +2,14 @@
 name: database-assistant
 source: ../../../../skills/database-assistant/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-03-23
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
-description: "[UDS] 引導資料庫設計、遷移規劃和查詢最佳化"
+description: |
+  引導資料庫設計、遷移與查詢最佳化。
+  Use when: schema 設計、遷移規劃、查詢最佳化、索引策略。
+  Not for: 應用程式碼遷移或框架升級——請用 /migrate；資料之上的 API 合約——請用 /api-design。
+  Keywords: database, schema, migration, SQL, index, query, 資料庫, 遷移, 查詢, 索引策略.
 ---
 
 # 資料庫助手

package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md

@@ -2,13 +2,14 @@
 name: deploy
 source: ../../../../skills/deploy-assistant/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-05-28
+translation_version: 1.1.0
+last_synced: 2026-08-17
 scope: universal
 description: |
-  [UDS] 無 CI/CD 平台環境下的可靠部署指引（不依賴 GitHub Actions / GitLab CI）。
-  Use when: deploying to VPS, air-gapped servers, or environments without CI/CD infrastructure.
-  Keywords: deployment, no-cicd, shell script, blue-green, smoke test, rollback, 無CI/CD, 部署.
+  引導在沒有 CI/CD 平台（GitHub Actions／GitLab CI）的情況下完成可靠部署。
+  Use when: 部署到 VPS、離線隔離的伺服器，或任何沒有 CI/CD 基礎設施的環境。
+  Not for: 建立在 GitHub Actions 或 GitLab CI 上的管線——請用 /ci-cd；版本號遞增與發布晉級——請用 /release。
+  Keywords: deployment, no-cicd, shell script, blue-green, smoke test, rollback, 無 CI/CD, 部署, 藍綠部署, 回滾.
 allowed-tools: Read, Bash(cat VERSION:*), Bash(git describe:*), Bash(which nginx:*), Bash(which rsync:*)
 argument-hint: "[專案類型: node/python/docker/go]"
 ---

package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md

@@ -2,13 +2,14 @@
 name: methodology
 source: ../../../../skills/dev-methodology/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-05-28
+translation_version: 1.1.0
+last_synced: 2026-08-17
 scope: partial
 description: |
-  [UDS] /methodology: 選擇並追蹤開發方法論（SDD/BDD/TDD）。
-  Use when: 選擇方法論、切換開發模式、查詢當前方法論狀態。
-  若要查詢各階段對應指令請用 /dev-workflow。
+  [UDS] 為專案選擇並追蹤當前採用的開發方法論（SDD、BDD、TDD）。
+  Use when: 決定專案該遵循哪一套方法論、切換方法論、查詢目前方法論處於哪個階段。
+  Not for: 查詢某個開發階段該執行哪個指令——請用 /dev-workflow；執行方法論本身——請用 /sdd、/bdd 或 /tdd。
+  Keywords: methodology, SDD, BDD, TDD, phase tracking, methodology selection, 方法論, 開發方法選擇, 階段追蹤.
 allowed-tools: Read, Write, Grep, Glob
 argument-hint: "[動作] [參數]"
 ---

package/bundled/locales/zh-TW/skills/dev-workflow-guide/SKILL.md

@@ -2,11 +2,15 @@
 name: dev-workflow-guide
 source: ../../../../skills/dev-workflow-guide/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-06-02
+translation_version: 1.1.0
+last_synced: 2026-08-17
 source_hash: 5bf83f0db544
 status: current
-description: "[UDS] 將軟體開發階段對應到 UDS 指令與功能的指南"
+description: |
+  [UDS] 把目前的軟體開發階段對應到正確的 UDS 指令與 Skill。
+  Use when: 不確定手上的任務該用哪個 UDS 指令、初次上手 UDS、帶著一個功能從規劃走到發布。
+  Not for: 選擇或切換方法論——請用 /methodology；實際執行某階段的工作——請用該階段自己的 Skill。
+  Keywords: workflow, development phase, command routing, which command, UDS guide, 開發階段, 指令對照, 流程指南.
 ---
 
 # 開發工作流程指南

package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md

@@ -2,10 +2,14 @@
 name: docs-generator
 source: ../../../../skills/docs-generator/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-02-10
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
-description: "[UDS] 從專案原始檔案產生使用文件（速查表、參考手冊、使用指南）"
+description: |
+  [UDS] 從專案原始檔產生使用文件（速查表、參考手冊、使用指南）。
+  Use when: 從 CLI 與 Skill 定義產出速查表或功能參考手冊、指令變更後重新產生文件、確認產生的文件是否為最新。
+  Not for: 決定專案需要哪些文件或手寫敘述性內容——請用 /documentation-guide；變更日誌條目——請用 /changelog。
+  Keywords: docgen, usage docs, cheatsheet, feature reference, generated documentation, 使用文件, 速查表, 文件產生, 參考手冊.
 ---
 
 # 文件產生器

package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md

@@ -2,10 +2,14 @@
 name: documentation-guide
 source: ../../../../skills/documentation-guide/SKILL.md
 source_version: 2.1.0
-translation_version: 2.1.0
-last_synced: 2026-03-17
+translation_version: 2.2.0
+last_synced: 2026-08-17
 status: current
-description: "[UDS] 引導文件結構、內容需求和專案文件最佳實踐"
+description: |
+  引導文件結構、內容需求與專案文件的最佳實踐。
+  Use when: 建立 README、撰寫文件、規劃 docs 目錄、專案初始設定、技術文件。
+  Not for: 從原始碼機械式產生文件——請用 /docgen；變更日誌條目——請用 /changelog。
+  Keywords: README, docs, documentation, CONTRIBUTING, CHANGELOG, ARCHITECTURE, API docs, 文件, 說明文件, 技術文件.
 ---
 
 # 文件指南