universal-dev-standards 6.6.0 → 6.7.1

package/bundled/locales/zh-CN/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-TW/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-CN/skills/ac-coverage/SKILL.md

@@ -2,12 +2,16 @@
 name: ac-coverage
 source: ../../../../skills/ac-coverage/SKILL.md
 source_version: 1.1.0
-translation_version: 1.1.0
-last_synced: 2026-07-09
-source_hash: eac0755fd844
+translation_version: 1.2.0
+last_synced: 2026-08-17
+source_hash: 168298f3a994
 scope: universal
 status: current
-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-CN/skills/adr-assistant/SKILL.md

@@ -1,14 +1,15 @@
 ---
 source: ../../../../skills/adr-assistant/SKILL.md
 source_version: 1.0.0
-source_hash: 900a9a7b5b04
-translation_version: 1.0.0
-last_synced: 2026-07-09
+source_hash: a5c79c6a04fe
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
 description: |
-  [UDS] 创建、管理和追踪架构决策记录（ADR）。
-  使用时机：架构决策、技术选型、设计取舍、模式选择。
-  关键字：ADR, architecture decision, decision record, 架构决策, 决策记录。
+  [UDS] 创建、管理并追踪架构决策记录（ADR）。
+  Use when: 架构决策、技术选型、设计取舍、模式选择。
+  Not for: 不改变架构的决策——记在规格或 commit 里即可；想法还没成形到足以下决定——请用 /brainstorm。
+  Keywords: ADR, architecture decision, decision record, trade-off, 架构决策, 决策记录, 设计取舍.
 ---
 
 # 架构决策记录助手

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

@@ -1,9 +1,14 @@
 ---
 source: ../../../../skills/ai-collaboration-standards/SKILL.md
 source_version: 1.1.0
-translation_version: 1.1.0
-last_synced: 2026-01-25
+translation_version: 1.2.0
+last_synced: 2026-08-17
 status: current
+description: |
+  防止 AI 幻觉，确保分析代码或提出建议时给出以证据为基础的回应。
+  Use when: 分析代码、提出建议、提供选项，或用户询问把握度／确定性时。
+  Not for: 编写 AI 指令文件本身——请用 /ai-instruction-standards；审查具体的 diff——请用 /code-review。
+  Keywords: certainty, assumption, inference, evidence, source, 证据, 假设, 推论, 确定性, 反幻觉.
 ---
 
 # AI 协作标准

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

@@ -1,14 +1,15 @@
 ---
 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: |
-  设计 AI 友善架构，包含明确模式、分层文档和语义边界。
-  使用时机：为 AI 协作规划项目结构、优化代码库以利 AI 分析、设置 AI 上下文。
-  关键字：architecture, AI-friendly, context, modules, documentation layers, .ai-context.yaml, 架构, AI 友善, 上下文.
+  设计 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-CN/skills/ai-instruction-standards/SKILL.md

@@ -1,14 +1,15 @@
 ---
 source: ../../../../skills/ai-instruction-standards/SKILL.md
 source_version: 2.0.0
-translation_version: 2.0.0
-last_synced: 2026-05-05
+translation_version: 2.1.0
+last_synced: 2026-08-17
 status: current
 scope: partial
 description: |
-  创建和维护 AI 指令文件（CLAUDE.md、.cursorrules 等）并采用适当结构。
-  使用时机：创建 AI 指令文件、区分通用与项目特定规则、配置 AI 工具。
-  关键字：CLAUDE.md, cursorrules, windsurfrules, clinerules, AI instructions, system prompt, 指令文件, AI 设定.
+  创建并维护 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-CN/skills/api-design-assistant/SKILL.md

@@ -1,13 +1,14 @@
 ---
 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: |
-  引导 API 设计，遵循 REST、GraphQL 和 gRPC 最佳实践。
-  使用时机：设计 API、审查端点、API 版本决策。
-  关键字：API, REST, GraphQL, gRPC, endpoint, versioning, 接口设计。
+  引导 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-CN/skills/atdd-assistant/SKILL.md

@@ -1,13 +1,14 @@
 ---
 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: |
-  引导验收测试驱动开发（ATDD）流程，用于定义和验证用户故事。
-  使用时机：定义验收条件、用户故事验证、ATDD 流程。
-  关键字：atdd, acceptance, user story, INVEST, 验收测试, 用户故事, 验收条件。
+  [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-CN/skills/audit-assistant/SKILL.md

@@ -1,13 +1,14 @@
 ---
 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 安装、报告问题、发现规范化机会。
-  关键字：audit, health, pattern, friction, feedback, 审计, 健康, 模式, 摩擦, 反馈。
+  [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-CN/skills/bdd-assistant/SKILL.md

@@ -1,13 +1,14 @@
 ---
 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: |
-  引导行为驱动开发（BDD）流程，使用 Given-When-Then 格式撰写场景。
-  使用时机：定义行为场景、撰写 Gherkin、三剑客会议、BDD 流程。
-  关键字：bdd, gherkin, given-when-then, scenario, feature, 行为驱动, 场景, 验收。
+  [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-CN/skills/brainstorm-assistant/SKILL.md

@@ -2,14 +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: |
-  在编写规格前进行结构化 AI 辅助头脑风暴。
-  使用时机：功能规划、创意发想、问题定义。
-  关键字：brainstorm, persona, multi-critic, HMW, SCAMPER, 头脑风暴, 发想。
+  [UDS] 在规格出现之前执行的结构化多角色头脑风暴，并附带评分质量关卡。
+  Use when: 想法还很模糊、在敲定方向前探索替代方案、需要多样性而不是第一个看似合理的答案。
+  Not for: 方向已经定了的工作规划——请用 /plan 或 /sdd；记录已经做成的决策——请用 /adr。
+  Keywords: brainstorm, ideation, divergence, convergence, persona ensemble, devil advocate, 头脑风暴, 发想, 发散收敛, 多角色.
 ---
 
 # 头脑风暴助手

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

@@ -1,13 +1,14 @@
 ---
 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: |
-  根据 Keep a Changelog 格式产生和维护 CHANGELOG.md 条目。
-  使用时机：更新变更日志、版本发布、记录变更。
-  关键字：changelog, CHANGELOG.md, keep a changelog, 变更日志, 版本记录。
+  [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-CN/skills/checkin-assistant/SKILL.md

@@ -1,13 +1,14 @@
 ---
 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: |
-  在提交代码前验证品质关卡，确保代码库稳定性。
-  使用时机：提交前检查、品质验证、pre-commit 检查。
-  关键字：checkin, pre-commit, quality gate, 签入, 品质关卡, 验证。
+  [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-CN/skills/ci-cd-assistant/SKILL.md

@@ -1,13 +1,14 @@
 ---
 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: |
-  引导 CI/CD 管线设计、配置和优化。
-  使用时机：设置管线、优化构建时间、配置部署阶段。
-  关键字：CI/CD, pipeline, GitHub Actions, deployment, build, 持续集成, 持续部署。
+  引导 CI/CD 流水线的设计、配置与优化。
+  Use when: 搭建流水线、缩短构建时间、配置部署阶段。
+  Not for: 没有 CI/CD 平台的部署——请用 /deploy；版本号递增与晋级——请用 /release。
+  Keywords: CI/CD, pipeline, GitHub Actions, deployment, build, 持续集成, 持续部署, 流水线.
 ---
 
 # CI/CD 管线助手

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

@@ -1,13 +1,14 @@
 ---
 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: |
-  使用标准化检查清单执行系统性代码审查。
-  使用时机：审查代码、PR 审查、代码品质检查。
-  关键字：review, code review, PR, checklist, 审查, 代码, 品质。
+  [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-CN/skills/commit-standards/SKILL.md

@@ -1,14 +1,15 @@
 ---
 source: ../../../../skills/commit-standards/SKILL.md
 source_version: 1.0.0
-source_hash: bc13c6166e8d
-translation_version: 1.0.0
-last_synced: 2026-07-09
+source_hash: 4a341b634146
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
 description: |
-  [UDS] 根据 Conventional Commits 规范产生格式正确的 commit message。
-  使用时机：提交代码、撰写 commit message、检查提交格式。
-  关键字：commit, conventional commits, 提交, 消息, feat, fix, refactor。
+  [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-CN/skills/contract-test-assistant/SKILL.md

@@ -1,14 +1,15 @@
 ---
 source: ../../../../skills/contract-test-assistant/SKILL.md
 source_version: 1.0.0
-source_hash: c8b082114d48
-translation_version: 1.0.0
-last_synced: 2026-07-09
+source_hash: 35b654f0b277
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
 description: |
-  [UDS] 引导 API 和微服务的契约测试策略。
-  使用时机：API 契约、微服务、消费者驱动测试。
-  关键字：contract test, Pact, OpenAPI, 契约测试。
+  [UDS] 引导 API 与微服务的契约测试策略。
+  Use when: API 契约、微服务、消费者驱动测试、提供者验证。
+  Not for: 一开始的 API 接口设计——请用 /api-design；经由 UI 的用户可见流程——请用 /e2e。
+  Keywords: contract test, Pact, OpenAPI, consumer-driven, provider, 契约测试, 消费者驱动, 提供者验证.
 ---
 
 # 契约测试助手

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

@@ -1,13 +1,14 @@
 ---
 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: |
-  引导数据库设计、迁移规划和查询优化。
-  使用时机：schema 设计、迁移规划、查询优化、索引策略。
-  关键字：database, schema, migration, SQL, index, query, 数据库, 迁移, 查询。
+  引导数据库设计、迁移与查询优化。
+  Use when: schema 设计、迁移规划、查询优化、索引策略。
+  Not for: 应用程序代码迁移或框架升级——请用 /migrate；数据之上的 API 契约——请用 /api-design。
+  Keywords: database, schema, migration, SQL, index, query, 数据库, 迁移, 查询, 索引策略.
 ---
 
 # 数据库助手

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

@@ -2,15 +2,16 @@
 name: deploy
 source: ../../../../skills/deploy-assistant/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-07-09
-source_hash: fc0996a2853c
+translation_version: 1.1.0
+last_synced: 2026-08-17
+source_hash: d84c8caee08d
 status: current
 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-CN/skills/dev-methodology/SKILL.md

@@ -2,15 +2,16 @@
 name: methodology
 source: ../../../../skills/dev-methodology/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-07-09
-source_hash: e7e6aae82545
+translation_version: 1.1.0
+last_synced: 2026-08-17
+source_hash: bc54ca1f49d5
 status: current
 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: "[动作] [参数]"
 ---