universal-dev-standards 6.6.0 → 6.7.1

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

@@ -1,14 +1,15 @@
 ---
 source: ../../../../skills/dev-workflow-guide/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-07-09
-source_hash: bb3068d840d8
+translation_version: 1.1.0
+last_synced: 2026-08-17
+source_hash: f90f1fe1f6f2
 status: current
 description: |
-  将软件开发阶段对应到 UDS 命令与技能。
-  使用时机：查找适用的 UDS 命令、规划开发流程、新手入门。
-  关键字：workflow, development-phases, commands, 工作流程, 开发阶段。
+  [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-CN/skills/docs-generator/SKILL.md

@@ -1,13 +1,14 @@
 ---
 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: |
-  从项目源文件生成使用文档（速查表、参考手册、使用指南）。
-  使用时机：生成文档、建立速查表、生成参考手册。
-  关键字：docgen, documentation, cheatsheet, reference, 文档生成, 速查表, 参考手册。
+  [UDS] 从项目源文件生成使用文档（速查表、参考手册、使用指南）。
+  Use when: 从 CLI 与 Skill 定义产出速查表或功能参考手册、命令变更后重新生成文档、确认生成的文档是否为最新。
+  Not for: 决定项目需要哪些文档或手写叙述性内容——请用 /documentation-guide；变更日志条目——请用 /changelog。
+  Keywords: docgen, usage docs, cheatsheet, feature reference, generated documentation, 使用文档, 速查表, 文档生成, 参考手册.
 ---
 
 # 文档生成器

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

@@ -1,13 +1,14 @@
 ---
 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: |
-  引導文件结构、内容需求和项目文件最佳实踐。
-  使用时机：建立 README、文件、docs 目录、项目设置、技術文件。
-  关鍵字：README, docs, documentation, CONTRIBUTING, CHANGELOG, ARCHITECTURE, API docs, 文件, 说明文件, 技術文件.
+  引导文档结构、内容需求与项目文档的最佳实践。
+  Use when: 创建 README、撰写文档、规划 docs 目录、项目初始设置、技术文档。
+  Not for: 从源代码机械式生成文档——请用 /docgen；变更日志条目——请用 /changelog。
+  Keywords: README, docs, documentation, CONTRIBUTING, CHANGELOG, ARCHITECTURE, API docs, 文档, 说明文档, 技术文档.
 ---
 
 # 文件指南

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

@@ -1,13 +1,14 @@
 ---
 source: ../../../../skills/durable-execution-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: |
-  引导工作流程故障恢复，包含检查点、重试与回滚策略。
-  使用时机：工作流中途失败、需要重试逻辑、设计容错流程。
-  关键字：durable, execution, checkpoint, retry, rollback, recovery, 持久执行, 恢复。
+  [UDS] 引导容错工作流设计，包含检查点、重试策略与回滚计划。
+  Use when: 长时间运行的工作流总是中途失败、设计检查点的粒度、选择重试或退避策略。
+  Not for: 处理正在发生中的线上事故——请用 /incident；部署回滚的实现机制——请用 /deploy。
+  Keywords: durable execution, checkpoint, retry, backoff, idempotency, rollback, 持久执行, 检查点, 重试策略, 幂等.
 ---
 
 # 持久执行助手

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

@@ -1,10 +1,14 @@
 ---
 source: ../../../../skills/e2e-assistant/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-04-10
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
-description: "[UDS] 从 BDD 场景生成 E2E 测试骨架，支持框架检测与覆盖差距分析"
+description: |
+  [UDS] 从 BDD 的 .feature 场景生成 E2E 测试骨架，并支持框架检测与覆盖缺口分析。
+  Use when: 把已完成的 .feature 场景转成可运行的 E2E 骨架、检测项目使用的 E2E 框架、找出没有 E2E 覆盖的 AC。
+  Not for: 跨多个故事且带有共享状态的旅程——请用 journey-test Skill；编写 .feature 场景本身——请用 /bdd。
+  Keywords: E2E, end-to-end test, feature file, test skeleton, framework detection, 端对端测试, 测试骨架, 场景转测试, 覆盖缺口.
 ---
 
 # E2E 助手

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

@@ -2,12 +2,13 @@
 name: errors
 description: |
   设计一致的错误码，遵循 PREFIX_CATEGORY_NUMBER 格式。
-  使用时机：定義错误码、建立错误处理、设计 API。
-  关鍵字：error code, error handling, error format, API errors, 错误码, 错误处理。
+  Use when: 定义错误码、建立错误处理机制、设计 API。
+  Not for: 日志格式与级别——请用 /logging-guide；处理已经到达生产环境的错误——请用 /incident。
+  Keywords: error code, error handling, error format, API errors, 错误码, 错误处理, 错误格式.
 source: ../../../../skills/error-code-guide/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-01-08
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
 ---
 

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

@@ -1,14 +1,15 @@
 ---
 source: ../../../../skills/git-workflow-guide/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2025-12-25
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
 name: git-flow
 description: |
-  指導 Git 分支策略、分支命名与合併操作。
-  使用时机：建立分支、合併、Pull Request、Git 工作流程問題。
-  关鍵字：branch, merge, PR, pull request, GitFlow, GitHub Flow, 分支, 合併, 工作流程。
+  引导 Git 分支策略、分支命名与合并操作。
+  Use when: 创建分支、合并、pull request、Git 工作流程相关问题。
+  Not for: 撰写 commit message——请用 /commit；推送前的安全检查——请用 /push。
+  Keywords: branch, merge, PR, pull request, GitFlow, GitHub Flow, 分支, 合并, 工作流程, 分支命名.
 ---
 
 # Git 工作流程指南

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

@@ -1,13 +1,14 @@
 ---
 source: ../../../../skills/incident-response-assistant/SKILL.md
 source_version: 1.1.0
-translation_version: 1.1.0
-last_synced: 2026-03-26
+translation_version: 1.2.0
+last_synced: 2026-08-17
 status: current
 description: |
-  引导事故回应、根因分析和事后复盘文档撰写。
-  使用时机：生产事故、故障响应、事后复盘撰写、根因分析。
-  关键字：incident, outage, post-mortem, RCA, root cause, 事故, 故障, 根因分析。
+  引导事故响应、根因分析与事后复盘文档撰写。
+  Use when: 生产环境事故、服务中断响应、撰写事后复盘、根因分析（RCA）。
+  Not for: 在故障发生前设计重试与检查点——请用 /durable；设置告警阈值与 Error Budget 策略——请用 /slo。
+  Keywords: incident, outage, post-mortem, RCA, root cause, 事故, 服务中断, 事后复盘, 根因分析.
 ---
 
 # 事故回应助手

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

@@ -2,13 +2,16 @@
 name: journey-test-assistant
 source: ../../../../skills/journey-test-assistant/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-07-09
-source_hash: 9230eb251afd
+translation_version: 1.1.0
+last_synced: 2026-08-17
+source_hash: 62c9c1574b9f
 status: current
 scope: partial
 description: |
-  [UDS] 从项目描述生成连贯的用户旅程测试计划（TESTPLAN）与 E2E 骨架。
+  [UDS] 从项目描述生成连贯的用户旅程测试计划（TESTPLAN）与旅程 E2E 骨架。
+  Use when: 新项目从第一天就需要一条测试旅程、测试跨多个故事延续的状态、建立以用户画像驱动的旅程计划。
+  Not for: 单一 AC 的独立 E2E 骨架——请用 /e2e；测量实际达成的代码覆盖率——请用 /coverage。
+  Keywords: user journey, TESTPLAN, journey test, persona, cross-story state, 用户旅程, 旅程测试, 测试计划, 用户画像.
 allowed-tools: Read, Write, Grep, Glob
 argument-hint: "[项目描述 | --analyze | --archetype A1|A2|A3]"
 ---

package/bundled/locales/zh-CN/skills/knowledge-graph/SKILL.md

@@ -2,12 +2,15 @@
 name: knowledge-graph
 source: ../../../../skills/knowledge-graph/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-07-09
-source_hash: 2a10faf2dd4c
+translation_version: 1.1.0
+last_synced: 2026-08-17
+source_hash: 3059eb465844
 status: current
 description: |
-  [UDS] 通过知识图追踪规格／决策／代码的影响链（引擎或 Markdown 后备）
+  [UDS] 通过知识图谱追踪规格、决策与代码之间的影响链；没有引擎时以 Markdown 后备方案运作。
+  Use when: 想知道某份规格或决策会影响到什么、找出哪些代码实现了某个产物、追踪规格、ADR 与模块之间的依赖关系。
+  Not for: 没有规格或决策锚点的纯文本搜索——请用 Grep；撰写规格本身——请用 /sdd。
+  Keywords: knowledge graph, impact chain, traceability, spec impact, decision graph, 知识图谱, 影响链, 规格追踪, 依赖关系.
 ---
 
 # 知识图

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

@@ -1,14 +1,15 @@
 ---
 name: logging
 description: |
-  实现结构化日志，包含正确的日志级别和敏感数据处理。
-  使用时机：新增日志、调试、设置可观测性。
-  关键字：logging, log level, structured logging, observability, 日志, 记录, 结构化日志。
+  实现结构化日志，包含适当的日志级别与敏感数据处理。
+  Use when: 加入日志、调试、建立可观测性。
+  Not for: 指标、追踪与告警设计——请用 /observability；错误码分类体系——请用 /error-code-guide。
+  Keywords: logging, log level, structured logging, observability, 日志, 结构化日志, 日志级别, 敏感数据.
 source: ../../../../skills/logging-guide/SKILL.md
 source_version: 1.4.0
-translation_version: 1.4.0
-last_synced: 2026-07-08
-source_hash: cf114de1df86
+translation_version: 1.5.0
+last_synced: 2026-08-17
+source_hash: ca969fdf7847
 status: current
 ---
 

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

@@ -1,13 +1,14 @@
 ---
 source: ../../../../skills/metrics-dashboard-assistant/SKILL.md
 source_version: 1.1.0
-translation_version: 1.1.0
-last_synced: 2026-03-26
+translation_version: 1.2.0
+last_synced: 2026-08-17
 status: current
 description: |
-  追踪开发指标、代码品质指示器与专案健康状态。
-  使用时机：评估专案健康、追踪技术债、监控品质趋势。
-  关键字：metrics, dashboard, quality, coverage, complexity, debt, 指标, 品质, 技术债。
+  [UDS] 长期追踪开发指标、代码质量指标与技术债。
+  Use when: 评估项目的持续健康状态、分类技术债并观察其趋势、向团队汇报代码质量。
+  Not for: 初次评估一个不熟悉的代码库——请用 /discover；单看测试覆盖率——请用 /coverage 或 /ac-coverage。
+  Keywords: metrics, code quality, technical debt, project health, debt trend, 开发指标, 技术债, 项目健康度, 质量趋势.
 ---
 
 # 开发指标助手

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

@@ -1,14 +1,15 @@
 ---
 source: ../../../../skills/migration-assistant/SKILL.md
 source_version: 1.0.0
-source_hash: 5d58f55f3f68
-translation_version: 1.0.0
-last_synced: 2026-07-09
+source_hash: 317e388b2b82
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
 description: |
-  引导代码迁移、框架升级与技术现代化。
-  使用时机：框架升级、语言迁移、API 版本更新、依赖现代化。
-  关键字：migration, upgrade, modernize, framework, dependency, 迁移, 升级, 现代化。
+  [UDS] 引导系统性的代码迁移、框架升级与技术现代化。
+  Use when: 规划框架或主版本升级、评估迁移风险、在 API 迁移前先抓取契约测试的固定样本。
+  Not for: 维持同一套框架的原地改善——请用 /refactor；数据库 schema 设计——请用 /database。
+  Keywords: migration, framework upgrade, modernization, breaking change, dependency upgrade, 迁移, 升级, 技术现代化, 破坏性变更.
 ---
 
 # 迁移助手

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

@@ -1,10 +1,14 @@
 ---
 source: ../../../../skills/observability-assistant/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-04-10
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
-description: "[UDS] 引导可观测性设置、指标设计和告警配置"
+description: |
+  引导可观测性建设、指标设计与告警配置。
+  Use when: 新服务的埋点、SLO 定义、告警设计、成熟度评估。
+  Not for: 设置数值目标与 Error Budget 策略——请用 /slo；日志格式与级别——请用 /logging-guide。
+  Keywords: observability, metrics, traces, golden signals, alerting, SLO, 可观测性, 指标, 追踪, 告警.
 ---
 
 # 可观测性助手

package/bundled/locales/zh-CN/skills/orchestrate/SKILL.md

@@ -2,14 +2,15 @@
 name: orchestrate
 source: ../../../../skills/orchestrate/SKILL.md
 source_version: 2.0.0
-translation_version: 2.0.0
-last_synced: 2026-07-16
-source_hash: e66c388ce04a
+translation_version: 2.1.0
+last_synced: 2026-08-17
+source_hash: 357586a2f4d0
 scope: universal
 description: |
-  [UDS] 以 Claude 原生 Agent tool 编排多任务执行计划（DAG-based，无外部引擎）。
-  Use when: executing a plan.json file with parallel/sequential task dependencies.
-  Keywords: orchestrate, plan, execute, DAG, task plan, 编排, 执行计划, 并行.
+  以 Claude 原生 Agent tool 编排多任务执行计划（以 DAG 为基础，不需外部引擎）。
+  Use when: 执行带有并行／顺序任务依赖关系的 plan.json 文件。
+  Not for: 一开始生成计划——请用 /plan；彼此之间没有依赖关系的单一任务。
+  Keywords: orchestrate, plan, execute, DAG, task plan, 编排, 执行计划, 并行, 任务依赖.
 argument-hint: "<plan.json> [--dry-run]"
 ---
 

package/bundled/locales/zh-CN/skills/plan/SKILL.md

@@ -2,14 +2,15 @@
 name: plan
 source: ../../../../skills/plan/SKILL.md
 source_version: 2.0.0
-translation_version: 2.0.0
-last_synced: 2026-07-16
-source_hash: 375b1ddb3613
+translation_version: 2.1.0
+last_synced: 2026-08-17
+source_hash: 208202753de4
 scope: universal
 description: |
-  [UDS] 从 Spec 文档、OpenSpec 变更或自由文本需求生成 plan.json。
-  Use when: converting specifications into executable task plans for /orchestrate.
-  Keywords: plan, spec, task plan, 计划, 规格, 任务, plan.json, DAG.
+  从 Spec 文档、OpenSpec 变更或自由文本需求生成 plan.json。
+  Use when: 把规格转换成可供 /orchestrate 执行的任务计划。
+  Not for: 执行产出的计划——请用 /orchestrate；判断这个想法值不值得做——请用 /brainstorm。
+  Keywords: plan, spec, task plan, plan.json, DAG, 计划, 规格, 任务, 任务计划.
 argument-hint: "[spec-file.md | openspec-dir/ | \"需求描述文本\" | (交互模式)]"
 ---
 

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

@@ -1,13 +1,14 @@
 ---
 source: ../../../../skills/pr-automation-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: |
-  引导 Pull Request 创建、审查自动化和合并策略。
-  使用时机：创建 PR、自动化审查、配置合并策略。
-  关键字：pull request, PR, merge, review, GitHub, GitLab, 合并请求, 审查。
+  引导 pull request 创建、审查自动化与合并策略。
+  Use when: 创建 PR、自动化审查流程、配置合并策略。
+  Not for: 审查本身的内容实质——请用 /code-review；分支命名与合并策略——请用 /git-workflow-guide。
+  Keywords: pull request, PR, merge, review, GitHub, GitLab, 合并请求, 审查自动化, 合并策略.
 ---
 
 # PR 自动化助手

package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md

@@ -1,13 +1,14 @@
 ---
 source: ../../../../skills/project-discovery/SKILL.md
 source_version: 1.1.0
-translation_version: 1.1.0
-last_synced: 2026-03-26
+translation_version: 1.2.0
+last_synced: 2026-08-17
 status: current
 description: |
-  在既有代码库新增功能前的 Phase 0 评估，评估项目健康度、架构与风险。
-  使用时机：新增功能前、项目健康度检查、风险评估。
-  关键字：discover, assessment, health, risk, 评估, 健康度, 风险, 架构。
+  [UDS] 在既有代码库新增功能之前，评估项目健康度、架构与风险。
+  Use when: 接手不熟悉或老旧的项目、动工前先估算风险、建立风险登记簿。
+  Not for: 对已经熟悉的代码库做持续指标追踪——请用 /metrics；从代码回推规格——请用 /reverse。
+  Keywords: discovery, project assessment, legacy onboarding, risk register, technical debt, 现状评估, 项目盘点, 风险登记簿, 老旧系统.
 ---
 
 # 项目现况评估

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

@@ -1,9 +1,14 @@
 ---
 source: ../../../../skills/project-structure-guide/SKILL.md
 source_version: 1.1.0
-translation_version: 1.1.0
-last_synced: 2026-03-04
+translation_version: 1.2.0
+last_synced: 2026-08-17
 status: current
+description: |
+  依各语言的最佳实践组织项目目录结构的指南。
+  Use when: 创建项目、重整结构、新增模块、配置构建流程、决定文件该放哪里。
+  Not for: 专门为 AI 导览而设计的结构——请用 /ai-friendly-architecture；原地重整既有代码——请用 /refactor。
+  Keywords: project, structure, directory, layout, gitignore, scaffold, file placement, utils, helpers, shared, 项目结构, 目录布局, 文件摆放.
 ---
 
 # 项目结构指南

package/bundled/locales/zh-CN/skills/push/SKILL.md

@@ -2,14 +2,15 @@
 name: push
 source: ../../../../skills/push/SKILL.md
 source_version: 2.0.0
-translation_version: 2.0.0
-last_synced: 2026-07-16
-source_hash: cb3cc9fb2313
+translation_version: 2.1.0
+last_synced: 2026-08-17
+source_hash: 3242aa64fe0d
 scope: universal
 description: |
-  [UDS] AI 辅助 git push 安全层：质量门禁 + 协作护栏。
-  Use when: pushing commits, force pushing, pushing to protected branches, pushing feature branches.
-  Keywords: git push, force push, protected branch, quality gate, push receipt, PR automation, 推送, 保护分支, 质量门禁.
+  AI 辅助的 git push 安全层，提供质量关卡与协作护栏。
+  Use when: 推送 commit、强制推送、推送到受保护分支、推送 feature 分支。
+  Not for: 撰写 commit 内容——请用 /commit；分支与合并策略的决策——请用 /git-workflow-guide。
+  Keywords: git push, force push, protected branch, quality gate, push receipt, PR automation, 推送, 保护分支, 质量门禁, 强制推送.
 allowed-tools: Read, Bash(git:*), Bash(npm:*), Bash(pnpm:*), Bash(yarn:*), Bash(bun:*)
 argument-hint: "[--force] [--target <branch>] [--skip-gates] [--no-pr]"
 ---

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

@@ -1,13 +1,14 @@
 ---
 source: ../../../../skills/refactoring-assistant/SKILL.md
 source_version: 2.0.0
-translation_version: 2.0.0
-last_synced: 2026-02-10
+translation_version: 2.1.0
+last_synced: 2026-08-17
 status: current
 description: |
-  引导重构决策、推荐策略，并提供逐步执行工作流程。
-  使用时机：重构代码、评估重构 vs 重写、处理遗留代码。
-  关键字：refactor, strategy, legacy, technical debt, 重构, 策略, 遗留代码, 技术债。
+  [UDS] 引导重构决策与策略选择，包含「重构还是重写」这个判断。
+  Use when: 代码已经难以修改、在战术性与架构性重构之间做选择、要在老旧代码里安全地动手。
+  Not for: 换到不同框架或主版本——请用 /migrate；清除调试残留与死代码——请用 /sweep。
+  Keywords: refactor, rewrite, strangler, legacy code, technical debt, code smell, 重构, 重写, 技术债, 坏味道.
 ---
 
 # 重构助手

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

@@ -1,13 +1,14 @@
 ---
 source: ../../../../skills/release-standards/SKILL.md
 source_version: 1.1.0
-translation_version: 1.1.0
-last_synced: 2026-02-10
+translation_version: 1.2.0
+last_synced: 2026-08-17
 status: current
 description: |
-  引导遵循语义化版本和变更日志最佳实践的发布流程。
-  使用时机：版本发布、版本管理、变更日志更新。
-  关键字：release, version, semver, changelog, 发布, 版本, 语义化。
+  [UDS] 引导发布流程——语义化版本、发布模式，以及 start/finish/promote/deploy 的顺序。
+  Use when: 切一个发布版本、决定语义化版本要升哪一位、把 release candidate 晋级为稳定版、记录一次部署。
+  Not for: 撰写变更日志条目本身——请用 /changelog；部署的实现机制——请用 /deploy。
+  Keywords: release, semantic versioning, version bump, release candidate, promote, 发布, 语义化版本, 发版流程, 版本晋级.
 ---
 
 # 发布助手

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

@@ -1,13 +1,14 @@
 ---
 source: ../../../../skills/requirement-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: |
-  编写结构良好的用户故事和需求文件，遵循 INVEST 准则。
-  使用时机：编写需求、定义用户故事、验收条件。
-  关键字：requirement, user story, INVEST, acceptance criteria, 需求, 用户故事, 验收条件。
+  [UDS] 撰写符合 INVEST 准则的用户故事与需求。
+  Use when: 把一个功能构想转成用户故事、定义可测试的验收条件、检视待办项目的质量。
+  Not for: 带有设计与差异操作的完整规格文档——请用 /sdd；判断这个构想本身对不对——请用 /brainstorm。
+  Keywords: requirement, user story, INVEST, acceptance criteria, backlog refinement, 需求, 用户故事, 验收条件, 待办梳理.
 ---
 
 # 需求助手

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

@@ -1,14 +1,15 @@
 ---
 source: ../../../../skills/retrospective-assistant/SKILL.md
 source_version: 1.0.0
-source_hash: e9de3576878e
-translation_version: 1.0.0
-last_synced: 2026-07-16
+source_hash: 3efae30b9297
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
 description: |
   [UDS] 引导 Sprint 与 Release 周期的结构化团队回顾。
-  使用时机：迭代结束、发布复盘、流程改善。
-  关键字：retrospective, retro, 回顾, 复盘, 持续改善。
+  Use when: Sprint 结束、发布后复盘、迭代审视、流程改善。
+  Not for: 生产环境事故的事后复盘——请用 /incident；追踪两次回顾之间的指标趋势——请用 /metrics。
+  Keywords: retrospective, retro, sprint review, lessons learned, action items, 回顾, 复盘, 迭代审视, 流程改善.
 ---
 
 # 回顾助手

package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md

@@ -1,14 +1,15 @@
 ---
 source: ../../../../skills/reverse-engineer/SKILL.md
 source_version: 1.2.0
-source_hash: 469dcdc76a83
-translation_version: 1.2.0
-last_synced: 2026-07-16
+source_hash: 4645517162ab
+translation_version: 1.3.0
+last_synced: 2026-08-17
 status: current
 description: |
-  系统考古——跨逻辑、数据、运行时三维度逆向工程代码。
-  使用时机：从代码提取规格、分析数据模型、分析运行时基准、生成 Gherkin 场景、分析测试覆盖率。
-  关键字：reverse engineering, spec, data, runtime, bdd, tdd, 逆向工程, 规格, 覆盖率。
+  [UDS] 系统考古——从逻辑、数据、运行时三个维度对既有系统做逆向工程。
+  Use when: 为没有文档的系统补上文档、从既有代码回推规格、绘制未知的数据模型或运行时拓扑。
+  Not for: 动工前评估健康度与风险——请用 /discover；从已批准的规格正向推导测试——请用 /spec-derive。
+  Keywords: reverse engineering, system archeology, legacy code, spec extraction, data model, runtime, 逆向工程, 系统考古, 规格提取, 数据模型.
 ---
 
 # 逆向工程助手

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

@@ -1,10 +1,14 @@
 ---
 source: ../../../../skills/runbook-assistant/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-04-10
+translation_version: 1.1.0
+last_synced: 2026-08-17
 status: current
-description: "[UDS] 引导 Runbook 撰写、维护、演练和覆盖率报告"
+description: |
+  引导 Runbook 的撰写、维护与演练。
+  Use when: 撰写 Runbook、规划演练、审计 Runbook 覆盖范围、事故后更新 Runbook。
+  Not for: 处理正在进行中的事故——请用 /incident；部署流程本身——请用 /deploy。
+  Keywords: runbook, operations, drill, on-call, procedure, 运维手册, 演练, 值班, 标准流程.
 ---
 
 # Runbook 助手

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

@@ -1,13 +1,14 @@
 ---
 source: ../../../../skills/security-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: |
-  引导安全审查和漏洞评估，遵循 OWASP 标准。
-  使用时机：安全审计、漏洞检查、安全编码审查、威胁建模。
-  关键字：security, OWASP, vulnerability, authentication, authorization, 安全, 漏洞, 认证。
+  引导安全审查与漏洞评估，遵循 OWASP 标准。
+  Use when: 安全审计、漏洞检查、安全编码审查、威胁建模。
+  Not for: 自动化的依赖包、CVE 与密钥扫描——请用 /scan；处理正在发生的安全事件——请用 /incident。
+  Keywords: security, OWASP, vulnerability, authentication, authorization, 信息安全, 漏洞, 认证, 授权, 威胁建模.
 ---
 
 # 安全审计助手

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

@@ -1,13 +1,14 @@
 ---
 source: ../../../../skills/security-scan-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: |
-  引导自动化安全扫描、依赖包审计和机密检测。
-  使用时机：依赖审计、CVE 扫描、机密检测、许可证合规。
-  关键字：scan, audit, CVE, dependency, secret, SBOM, vulnerability, 扫描, 漏洞。
+  引导自动化安全扫描、依赖包审计与密钥检测。
+  Use when: 依赖包审计、CVE 扫描、密钥检测、许可证合规。
+  Not for: 人工的威胁建模与安全设计审查——请用 /security；一般的代码整洁度——请用 /sweep。
+  Keywords: scan, audit, CVE, dependency, secret, SBOM, vulnerability, 扫描, 审计, 依赖包, 密钥检测.
 ---
 
 # 安全扫描助手

package/bundled/locales/zh-CN/skills/skill-builder/SKILL.md

@@ -2,13 +2,16 @@
 name: skill-builder
 source: ../../../../skills/skill-builder/SKILL.md
 source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-07-16
-source_hash: 1c5f079e0851
+translation_version: 1.1.0
+last_synced: 2026-08-17
+source_hash: 8eee581c49c4
 status: current
 scope: universal
 description: |
-  [UDS] 识别重复流程并以正确的开发深度构建 Skill
+  [UDS] 把重复的手动流程转成范围界定得宜的 Skill，过程中拿捏恰当的流程分量。
+  Use when: 同一段多步骤流程已经手动做过三次以上、把临时凑出来的 Skill 正式化、决定某个 Skill 该放在哪一层。
+  Not for: 记录历史事实或项目状态——那属于记忆，不是 Skill；不会再发生的一次性任务。
+  Keywords: skill, skill builder, process knowledge, repeated process, automation, 技能建立, 流程知识, 自动化, 重复流程.
 allowed-tools: Read, Glob, Grep, Write, Edit, Bash
 argument-hint: "[process description | 流程描述]"
 ---