universal-dev-standards 6.5.0 → 6.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (181) hide show
  1. package/bundled/ai/standards/ai-response-navigation.ai.yaml +70 -3
  2. package/bundled/ai/standards/spec-driven-development.ai.yaml +28 -1
  3. package/bundled/core/ai-response-navigation.md +128 -2
  4. package/bundled/core/spec-driven-development.md +57 -2
  5. package/bundled/locales/zh-CN/CHANGELOG.md +34 -3
  6. package/bundled/locales/zh-CN/README.md +1 -1
  7. package/bundled/locales/zh-CN/SECURITY.md +1 -1
  8. package/bundled/locales/zh-CN/core/ai-response-navigation.md +115 -5
  9. package/bundled/locales/zh-CN/core/spec-driven-development.md +1 -1
  10. package/bundled/locales/zh-CN/skills/ac-coverage/SKILL.md +8 -4
  11. package/bundled/locales/zh-CN/skills/adr-assistant/SKILL.md +7 -6
  12. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +7 -2
  13. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +6 -5
  14. package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +6 -5
  15. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +6 -5
  16. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +6 -5
  17. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +6 -5
  18. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +6 -5
  19. package/bundled/locales/zh-CN/skills/brainstorm-assistant/SKILL.md +7 -6
  20. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +6 -5
  21. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +6 -5
  22. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +6 -5
  23. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +6 -5
  24. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +7 -6
  25. package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +7 -6
  26. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +6 -5
  27. package/bundled/locales/zh-CN/skills/deploy-assistant/SKILL.md +7 -6
  28. package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +7 -6
  29. package/bundled/locales/zh-CN/skills/dev-workflow-guide/SKILL.md +7 -6
  30. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +6 -5
  31. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +6 -5
  32. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +6 -5
  33. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +7 -3
  34. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +5 -4
  35. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +6 -5
  36. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +6 -5
  37. package/bundled/locales/zh-CN/skills/journey-test-assistant/SKILL.md +7 -4
  38. package/bundled/locales/zh-CN/skills/knowledge-graph/SKILL.md +7 -4
  39. package/bundled/locales/zh-CN/skills/logging-guide/SKILL.md +7 -6
  40. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +6 -5
  41. package/bundled/locales/zh-CN/skills/migration-assistant/SKILL.md +7 -6
  42. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +7 -3
  43. package/bundled/locales/zh-CN/skills/orchestrate/SKILL.md +7 -6
  44. package/bundled/locales/zh-CN/skills/plan/SKILL.md +7 -6
  45. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +6 -5
  46. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +6 -5
  47. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +7 -2
  48. package/bundled/locales/zh-CN/skills/push/SKILL.md +7 -6
  49. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +6 -5
  50. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +6 -5
  51. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +6 -5
  52. package/bundled/locales/zh-CN/skills/retrospective-assistant/SKILL.md +6 -5
  53. package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +7 -6
  54. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +7 -3
  55. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +6 -5
  56. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +6 -5
  57. package/bundled/locales/zh-CN/skills/skill-builder/SKILL.md +7 -4
  58. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +7 -3
  59. package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +7 -4
  60. package/bundled/locales/zh-CN/skills/spec-driven-dev/SKILL.md +7 -6
  61. package/bundled/locales/zh-CN/skills/sweep/SKILL.md +7 -6
  62. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +6 -5
  63. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +6 -5
  64. package/bundled/locales/zh-CN/skills/testing-guide/SKILL.md +7 -6
  65. package/bundled/locales/zh-TW/CHANGELOG.md +34 -3
  66. package/bundled/locales/zh-TW/README.md +1 -1
  67. package/bundled/locales/zh-TW/SECURITY.md +1 -1
  68. package/bundled/locales/zh-TW/core/ai-response-navigation.md +115 -5
  69. package/bundled/locales/zh-TW/core/spec-driven-development.md +1 -1
  70. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +7 -3
  71. package/bundled/locales/zh-TW/skills/adr-assistant/SKILL.md +7 -3
  72. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +6 -5
  73. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +7 -3
  74. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +7 -3
  75. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +7 -3
  76. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +7 -3
  77. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +7 -3
  78. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +7 -3
  79. package/bundled/locales/zh-TW/skills/brainstorm-assistant/SKILL.md +8 -4
  80. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +7 -3
  81. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +7 -3
  82. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +7 -3
  83. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +7 -3
  84. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +7 -3
  85. package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +7 -3
  86. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +7 -3
  87. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +6 -5
  88. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +6 -5
  89. package/bundled/locales/zh-TW/skills/dev-workflow-guide/SKILL.md +7 -3
  90. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +7 -3
  91. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +7 -3
  92. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +7 -3
  93. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +7 -3
  94. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +7 -3
  95. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +7 -3
  96. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +7 -3
  97. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +7 -3
  98. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +7 -3
  99. package/bundled/locales/zh-TW/skills/logging-guide/SKILL.md +8 -4
  100. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +7 -3
  101. package/bundled/locales/zh-TW/skills/migration-assistant/SKILL.md +7 -3
  102. package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +7 -3
  103. package/bundled/locales/zh-TW/skills/orchestrate/SKILL.md +6 -5
  104. package/bundled/locales/zh-TW/skills/plan/SKILL.md +6 -5
  105. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +7 -3
  106. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +7 -3
  107. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +6 -5
  108. package/bundled/locales/zh-TW/skills/push/SKILL.md +6 -5
  109. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +7 -3
  110. package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +7 -3
  111. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +7 -3
  112. package/bundled/locales/zh-TW/skills/retrospective-assistant/SKILL.md +7 -3
  113. package/bundled/locales/zh-TW/skills/reverse-engineer/SKILL.md +7 -3
  114. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +7 -3
  115. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +7 -3
  116. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +7 -3
  117. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +7 -3
  118. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +7 -3
  119. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +7 -3
  120. package/bundled/locales/zh-TW/skills/spec-driven-dev/SKILL.md +7 -3
  121. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +6 -5
  122. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +7 -3
  123. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +7 -3
  124. package/bundled/locales/zh-TW/skills/testing-guide/SKILL.md +8 -3
  125. package/bundled/skills/ac-coverage/SKILL.md +5 -1
  126. package/bundled/skills/adr-assistant/SKILL.md +1 -0
  127. package/bundled/skills/ai-collaboration-standards/SKILL.md +1 -0
  128. package/bundled/skills/ai-friendly-architecture/SKILL.md +1 -0
  129. package/bundled/skills/ai-instruction-standards/SKILL.md +1 -0
  130. package/bundled/skills/api-design-assistant/SKILL.md +1 -0
  131. package/bundled/skills/atdd-assistant/SKILL.md +5 -1
  132. package/bundled/skills/audit-assistant/SKILL.md +5 -1
  133. package/bundled/skills/bdd-assistant/SKILL.md +5 -1
  134. package/bundled/skills/brainstorm-assistant/SKILL.md +5 -1
  135. package/bundled/skills/changelog-guide/SKILL.md +5 -1
  136. package/bundled/skills/checkin-assistant/SKILL.md +5 -1
  137. package/bundled/skills/ci-cd-assistant/SKILL.md +1 -0
  138. package/bundled/skills/code-review-assistant/SKILL.md +5 -1
  139. package/bundled/skills/commit-standards/SKILL.md +5 -1
  140. package/bundled/skills/contract-test-assistant/SKILL.md +1 -0
  141. package/bundled/skills/database-assistant/SKILL.md +1 -0
  142. package/bundled/skills/deploy-assistant/SKILL.md +1 -0
  143. package/bundled/skills/dev-methodology/SKILL.md +5 -1
  144. package/bundled/skills/dev-workflow-guide/SKILL.md +5 -1
  145. package/bundled/skills/docs-generator/SKILL.md +5 -1
  146. package/bundled/skills/documentation-guide/SKILL.md +1 -0
  147. package/bundled/skills/durable-execution-assistant/SKILL.md +5 -1
  148. package/bundled/skills/e2e-assistant/SKILL.md +5 -1
  149. package/bundled/skills/error-code-guide/SKILL.md +1 -0
  150. package/bundled/skills/git-workflow-guide/SKILL.md +1 -0
  151. package/bundled/skills/incident-response-assistant/SKILL.md +1 -0
  152. package/bundled/skills/journey-test-assistant/SKILL.md +5 -1
  153. package/bundled/skills/knowledge-graph/SKILL.md +5 -1
  154. package/bundled/skills/logging-guide/SKILL.md +1 -0
  155. package/bundled/skills/metrics-dashboard-assistant/SKILL.md +5 -1
  156. package/bundled/skills/migration-assistant/SKILL.md +5 -1
  157. package/bundled/skills/observability-assistant/SKILL.md +1 -0
  158. package/bundled/skills/orchestrate/SKILL.md +1 -0
  159. package/bundled/skills/plan/SKILL.md +1 -0
  160. package/bundled/skills/pr-automation-assistant/SKILL.md +1 -0
  161. package/bundled/skills/project-discovery/SKILL.md +5 -1
  162. package/bundled/skills/project-structure-guide/SKILL.md +1 -0
  163. package/bundled/skills/push/SKILL.md +1 -0
  164. package/bundled/skills/refactoring-assistant/SKILL.md +5 -1
  165. package/bundled/skills/release-standards/SKILL.md +5 -1
  166. package/bundled/skills/requirement-assistant/SKILL.md +5 -1
  167. package/bundled/skills/retrospective-assistant/SKILL.md +1 -0
  168. package/bundled/skills/reverse-engineer/SKILL.md +5 -1
  169. package/bundled/skills/runbook-assistant/SKILL.md +1 -0
  170. package/bundled/skills/security-assistant/SKILL.md +1 -0
  171. package/bundled/skills/security-scan-assistant/SKILL.md +1 -0
  172. package/bundled/skills/skill-builder/SKILL.md +5 -1
  173. package/bundled/skills/slo-assistant/SKILL.md +1 -0
  174. package/bundled/skills/spec-derivation/SKILL.md +5 -1
  175. package/bundled/skills/spec-driven-dev/SKILL.md +5 -1
  176. package/bundled/skills/sweep/SKILL.md +1 -0
  177. package/bundled/skills/tdd-assistant/SKILL.md +5 -1
  178. package/bundled/skills/test-coverage-assistant/SKILL.md +5 -1
  179. package/bundled/skills/testing-guide/SKILL.md +1 -0
  180. package/package.json +1 -1
  181. package/standards-registry.json +7 -7
@@ -1,14 +1,15 @@
1
1
  ---
2
2
  name: logging
3
3
  description: |
4
- 实现结构化日志,包含正确的日志级别和敏感数据处理。
5
- 使用时机:新增日志、调试、设置可观测性。
6
- 关键字:logging, log level, structured logging, observability, 日志, 记录, 结构化日志。
4
+ 实现结构化日志,包含适当的日志级别与敏感数据处理。
5
+ Use when: 加入日志、调试、建立可观测性。
6
+ Not for: 指标、追踪与告警设计——请用 /observability;错误码分类体系——请用 /error-code-guide。
7
+ Keywords: logging, log level, structured logging, observability, 日志, 结构化日志, 日志级别, 敏感数据.
7
8
  source: ../../../../skills/logging-guide/SKILL.md
8
9
  source_version: 1.4.0
9
- translation_version: 1.4.0
10
- last_synced: 2026-07-08
11
- source_hash: cf114de1df86
10
+ translation_version: 1.5.0
11
+ last_synced: 2026-08-17
12
+ source_hash: ca969fdf7847
12
13
  status: current
13
14
  ---
14
15
 
@@ -1,13 +1,14 @@
1
1
  ---
2
2
  source: ../../../../skills/metrics-dashboard-assistant/SKILL.md
3
3
  source_version: 1.1.0
4
- translation_version: 1.1.0
5
- last_synced: 2026-03-26
4
+ translation_version: 1.2.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
7
  description: |
8
- 追踪开发指标、代码品质指示器与专案健康状态。
9
- 使用时机:评估专案健康、追踪技术债、监控品质趋势。
10
- 关键字:metrics, dashboard, quality, coverage, complexity, debt, 指标, 品质, 技术债。
8
+ [UDS] 长期追踪开发指标、代码质量指标与技术债。
9
+ Use when: 评估项目的持续健康状态、分类技术债并观察其趋势、向团队汇报代码质量。
10
+ Not for: 初次评估一个不熟悉的代码库——请用 /discover;单看测试覆盖率——请用 /coverage 或 /ac-coverage。
11
+ Keywords: metrics, code quality, technical debt, project health, debt trend, 开发指标, 技术债, 项目健康度, 质量趋势.
11
12
  ---
12
13
 
13
14
  # 开发指标助手
@@ -1,14 +1,15 @@
1
1
  ---
2
2
  source: ../../../../skills/migration-assistant/SKILL.md
3
3
  source_version: 1.0.0
4
- source_hash: 5d58f55f3f68
5
- translation_version: 1.0.0
6
- last_synced: 2026-07-09
4
+ source_hash: 317e388b2b82
5
+ translation_version: 1.1.0
6
+ last_synced: 2026-08-17
7
7
  status: current
8
8
  description: |
9
- 引导代码迁移、框架升级与技术现代化。
10
- 使用时机:框架升级、语言迁移、API 版本更新、依赖现代化。
11
- 关键字:migration, upgrade, modernize, framework, dependency, 迁移, 升级, 现代化。
9
+ [UDS] 引导系统性的代码迁移、框架升级与技术现代化。
10
+ Use when: 规划框架或主版本升级、评估迁移风险、在 API 迁移前先抓取契约测试的固定样本。
11
+ Not for: 维持同一套框架的原地改善——请用 /refactor;数据库 schema 设计——请用 /database。
12
+ Keywords: migration, framework upgrade, modernization, breaking change, dependency upgrade, 迁移, 升级, 技术现代化, 破坏性变更.
12
13
  ---
13
14
 
14
15
  # 迁移助手
@@ -1,10 +1,14 @@
1
1
  ---
2
2
  source: ../../../../skills/observability-assistant/SKILL.md
3
3
  source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-04-10
4
+ translation_version: 1.1.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
- description: "[UDS] 引导可观测性设置、指标设计和告警配置"
7
+ description: |
8
+ 引导可观测性建设、指标设计与告警配置。
9
+ Use when: 新服务的埋点、SLO 定义、告警设计、成熟度评估。
10
+ Not for: 设置数值目标与 Error Budget 策略——请用 /slo;日志格式与级别——请用 /logging-guide。
11
+ Keywords: observability, metrics, traces, golden signals, alerting, SLO, 可观测性, 指标, 追踪, 告警.
8
12
  ---
9
13
 
10
14
  # 可观测性助手
@@ -2,14 +2,15 @@
2
2
  name: orchestrate
3
3
  source: ../../../../skills/orchestrate/SKILL.md
4
4
  source_version: 2.0.0
5
- translation_version: 2.0.0
6
- last_synced: 2026-07-16
7
- source_hash: e66c388ce04a
5
+ translation_version: 2.1.0
6
+ last_synced: 2026-08-17
7
+ source_hash: 357586a2f4d0
8
8
  scope: universal
9
9
  description: |
10
- [UDS] 以 Claude 原生 Agent tool 编排多任务执行计划(DAG-based,无外部引擎)。
11
- Use when: executing a plan.json file with parallel/sequential task dependencies.
12
- Keywords: orchestrate, plan, execute, DAG, task plan, 编排, 执行计划, 并行.
10
+ 以 Claude 原生 Agent tool 编排多任务执行计划(以 DAG 为基础,不需外部引擎)。
11
+ Use when: 执行带有并行/顺序任务依赖关系的 plan.json 文件。
12
+ Not for: 一开始生成计划——请用 /plan;彼此之间没有依赖关系的单一任务。
13
+ Keywords: orchestrate, plan, execute, DAG, task plan, 编排, 执行计划, 并行, 任务依赖.
13
14
  argument-hint: "<plan.json> [--dry-run]"
14
15
  ---
15
16
 
@@ -2,14 +2,15 @@
2
2
  name: plan
3
3
  source: ../../../../skills/plan/SKILL.md
4
4
  source_version: 2.0.0
5
- translation_version: 2.0.0
6
- last_synced: 2026-07-16
7
- source_hash: 375b1ddb3613
5
+ translation_version: 2.1.0
6
+ last_synced: 2026-08-17
7
+ source_hash: 208202753de4
8
8
  scope: universal
9
9
  description: |
10
- [UDS] 从 Spec 文档、OpenSpec 变更或自由文本需求生成 plan.json。
11
- Use when: converting specifications into executable task plans for /orchestrate.
12
- Keywords: plan, spec, task plan, 计划, 规格, 任务, plan.json, DAG.
10
+ 从 Spec 文档、OpenSpec 变更或自由文本需求生成 plan.json。
11
+ Use when: 把规格转换成可供 /orchestrate 执行的任务计划。
12
+ Not for: 执行产出的计划——请用 /orchestrate;判断这个想法值不值得做——请用 /brainstorm。
13
+ Keywords: plan, spec, task plan, plan.json, DAG, 计划, 规格, 任务, 任务计划.
13
14
  argument-hint: "[spec-file.md | openspec-dir/ | \"需求描述文本\" | (交互模式)]"
14
15
  ---
15
16
 
@@ -1,13 +1,14 @@
1
1
  ---
2
2
  source: ../../../../skills/pr-automation-assistant/SKILL.md
3
3
  source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-03-23
4
+ translation_version: 1.1.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
7
  description: |
8
- 引导 Pull Request 创建、审查自动化和合并策略。
9
- 使用时机:创建 PR、自动化审查、配置合并策略。
10
- 关键字:pull request, PR, merge, review, GitHub, GitLab, 合并请求, 审查。
8
+ 引导 pull request 创建、审查自动化与合并策略。
9
+ Use when: 创建 PR、自动化审查流程、配置合并策略。
10
+ Not for: 审查本身的内容实质——请用 /code-review;分支命名与合并策略——请用 /git-workflow-guide。
11
+ Keywords: pull request, PR, merge, review, GitHub, GitLab, 合并请求, 审查自动化, 合并策略.
11
12
  ---
12
13
 
13
14
  # PR 自动化助手
@@ -1,13 +1,14 @@
1
1
  ---
2
2
  source: ../../../../skills/project-discovery/SKILL.md
3
3
  source_version: 1.1.0
4
- translation_version: 1.1.0
5
- last_synced: 2026-03-26
4
+ translation_version: 1.2.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
7
  description: |
8
- 在既有代码库新增功能前的 Phase 0 评估,评估项目健康度、架构与风险。
9
- 使用时机:新增功能前、项目健康度检查、风险评估。
10
- 关键字:discover, assessment, health, risk, 评估, 健康度, 风险, 架构。
8
+ [UDS] 在既有代码库新增功能之前,评估项目健康度、架构与风险。
9
+ Use when: 接手不熟悉或老旧的项目、动工前先估算风险、建立风险登记簿。
10
+ Not for: 对已经熟悉的代码库做持续指标追踪——请用 /metrics;从代码回推规格——请用 /reverse。
11
+ Keywords: discovery, project assessment, legacy onboarding, risk register, technical debt, 现状评估, 项目盘点, 风险登记簿, 老旧系统.
11
12
  ---
12
13
 
13
14
  # 项目现况评估
@@ -1,9 +1,14 @@
1
1
  ---
2
2
  source: ../../../../skills/project-structure-guide/SKILL.md
3
3
  source_version: 1.1.0
4
- translation_version: 1.1.0
5
- last_synced: 2026-03-04
4
+ translation_version: 1.2.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
+ description: |
8
+ 依各语言的最佳实践组织项目目录结构的指南。
9
+ Use when: 创建项目、重整结构、新增模块、配置构建流程、决定文件该放哪里。
10
+ Not for: 专门为 AI 导览而设计的结构——请用 /ai-friendly-architecture;原地重整既有代码——请用 /refactor。
11
+ Keywords: project, structure, directory, layout, gitignore, scaffold, file placement, utils, helpers, shared, 项目结构, 目录布局, 文件摆放.
7
12
  ---
8
13
 
9
14
  # 项目结构指南
@@ -2,14 +2,15 @@
2
2
  name: push
3
3
  source: ../../../../skills/push/SKILL.md
4
4
  source_version: 2.0.0
5
- translation_version: 2.0.0
6
- last_synced: 2026-07-16
7
- source_hash: cb3cc9fb2313
5
+ translation_version: 2.1.0
6
+ last_synced: 2026-08-17
7
+ source_hash: 3242aa64fe0d
8
8
  scope: universal
9
9
  description: |
10
- [UDS] AI 辅助 git push 安全层:质量门禁 + 协作护栏。
11
- Use when: pushing commits, force pushing, pushing to protected branches, pushing feature branches.
12
- Keywords: git push, force push, protected branch, quality gate, push receipt, PR automation, 推送, 保护分支, 质量门禁.
10
+ AI 辅助的 git push 安全层,提供质量关卡与协作护栏。
11
+ Use when: 推送 commit、强制推送、推送到受保护分支、推送 feature 分支。
12
+ Not for: 撰写 commit 内容——请用 /commit;分支与合并策略的决策——请用 /git-workflow-guide。
13
+ Keywords: git push, force push, protected branch, quality gate, push receipt, PR automation, 推送, 保护分支, 质量门禁, 强制推送.
13
14
  allowed-tools: Read, Bash(git:*), Bash(npm:*), Bash(pnpm:*), Bash(yarn:*), Bash(bun:*)
14
15
  argument-hint: "[--force] [--target <branch>] [--skip-gates] [--no-pr]"
15
16
  ---
@@ -1,13 +1,14 @@
1
1
  ---
2
2
  source: ../../../../skills/refactoring-assistant/SKILL.md
3
3
  source_version: 2.0.0
4
- translation_version: 2.0.0
5
- last_synced: 2026-02-10
4
+ translation_version: 2.1.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
7
  description: |
8
- 引导重构决策、推荐策略,并提供逐步执行工作流程。
9
- 使用时机:重构代码、评估重构 vs 重写、处理遗留代码。
10
- 关键字:refactor, strategy, legacy, technical debt, 重构, 策略, 遗留代码, 技术债。
8
+ [UDS] 引导重构决策与策略选择,包含「重构还是重写」这个判断。
9
+ Use when: 代码已经难以修改、在战术性与架构性重构之间做选择、要在老旧代码里安全地动手。
10
+ Not for: 换到不同框架或主版本——请用 /migrate;清除调试残留与死代码——请用 /sweep。
11
+ Keywords: refactor, rewrite, strangler, legacy code, technical debt, code smell, 重构, 重写, 技术债, 坏味道.
11
12
  ---
12
13
 
13
14
  # 重构助手
@@ -1,13 +1,14 @@
1
1
  ---
2
2
  source: ../../../../skills/release-standards/SKILL.md
3
3
  source_version: 1.1.0
4
- translation_version: 1.1.0
5
- last_synced: 2026-02-10
4
+ translation_version: 1.2.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
7
  description: |
8
- 引导遵循语义化版本和变更日志最佳实践的发布流程。
9
- 使用时机:版本发布、版本管理、变更日志更新。
10
- 关键字:release, version, semver, changelog, 发布, 版本, 语义化。
8
+ [UDS] 引导发布流程——语义化版本、发布模式,以及 start/finish/promote/deploy 的顺序。
9
+ Use when: 切一个发布版本、决定语义化版本要升哪一位、把 release candidate 晋级为稳定版、记录一次部署。
10
+ Not for: 撰写变更日志条目本身——请用 /changelog;部署的实现机制——请用 /deploy。
11
+ Keywords: release, semantic versioning, version bump, release candidate, promote, 发布, 语义化版本, 发版流程, 版本晋级.
11
12
  ---
12
13
 
13
14
  # 发布助手
@@ -1,13 +1,14 @@
1
1
  ---
2
2
  source: ../../../../skills/requirement-assistant/SKILL.md
3
3
  source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-02-10
4
+ translation_version: 1.1.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
7
  description: |
8
- 编写结构良好的用户故事和需求文件,遵循 INVEST 准则。
9
- 使用时机:编写需求、定义用户故事、验收条件。
10
- 关键字:requirement, user story, INVEST, acceptance criteria, 需求, 用户故事, 验收条件。
8
+ [UDS] 撰写符合 INVEST 准则的用户故事与需求。
9
+ Use when: 把一个功能构想转成用户故事、定义可测试的验收条件、检视待办项目的质量。
10
+ Not for: 带有设计与差异操作的完整规格文档——请用 /sdd;判断这个构想本身对不对——请用 /brainstorm。
11
+ Keywords: requirement, user story, INVEST, acceptance criteria, backlog refinement, 需求, 用户故事, 验收条件, 待办梳理.
11
12
  ---
12
13
 
13
14
  # 需求助手
@@ -1,14 +1,15 @@
1
1
  ---
2
2
  source: ../../../../skills/retrospective-assistant/SKILL.md
3
3
  source_version: 1.0.0
4
- source_hash: e9de3576878e
5
- translation_version: 1.0.0
6
- last_synced: 2026-07-16
4
+ source_hash: 3efae30b9297
5
+ translation_version: 1.1.0
6
+ last_synced: 2026-08-17
7
7
  status: current
8
8
  description: |
9
9
  [UDS] 引导 Sprint 与 Release 周期的结构化团队回顾。
10
- 使用时机:迭代结束、发布复盘、流程改善。
11
- 关键字:retrospective, retro, 回顾, 复盘, 持续改善。
10
+ Use when: Sprint 结束、发布后复盘、迭代审视、流程改善。
11
+ Not for: 生产环境事故的事后复盘——请用 /incident;追踪两次回顾之间的指标趋势——请用 /metrics。
12
+ Keywords: retrospective, retro, sprint review, lessons learned, action items, 回顾, 复盘, 迭代审视, 流程改善.
12
13
  ---
13
14
 
14
15
  # 回顾助手
@@ -1,14 +1,15 @@
1
1
  ---
2
2
  source: ../../../../skills/reverse-engineer/SKILL.md
3
3
  source_version: 1.2.0
4
- source_hash: 469dcdc76a83
5
- translation_version: 1.2.0
6
- last_synced: 2026-07-16
4
+ source_hash: 4645517162ab
5
+ translation_version: 1.3.0
6
+ last_synced: 2026-08-17
7
7
  status: current
8
8
  description: |
9
- 系统考古——跨逻辑、数据、运行时三维度逆向工程代码。
10
- 使用时机:从代码提取规格、分析数据模型、分析运行时基准、生成 Gherkin 场景、分析测试覆盖率。
11
- 关键字:reverse engineering, spec, data, runtime, bdd, tdd, 逆向工程, 规格, 覆盖率。
9
+ [UDS] 系统考古——从逻辑、数据、运行时三个维度对既有系统做逆向工程。
10
+ Use when: 为没有文档的系统补上文档、从既有代码回推规格、绘制未知的数据模型或运行时拓扑。
11
+ Not for: 动工前评估健康度与风险——请用 /discover;从已批准的规格正向推导测试——请用 /spec-derive。
12
+ Keywords: reverse engineering, system archeology, legacy code, spec extraction, data model, runtime, 逆向工程, 系统考古, 规格提取, 数据模型.
12
13
  ---
13
14
 
14
15
  # 逆向工程助手
@@ -1,10 +1,14 @@
1
1
  ---
2
2
  source: ../../../../skills/runbook-assistant/SKILL.md
3
3
  source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-04-10
4
+ translation_version: 1.1.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
- description: "[UDS] 引导 Runbook 撰写、维护、演练和覆盖率报告"
7
+ description: |
8
+ 引导 Runbook 的撰写、维护与演练。
9
+ Use when: 撰写 Runbook、规划演练、审计 Runbook 覆盖范围、事故后更新 Runbook。
10
+ Not for: 处理正在进行中的事故——请用 /incident;部署流程本身——请用 /deploy。
11
+ Keywords: runbook, operations, drill, on-call, procedure, 运维手册, 演练, 值班, 标准流程.
8
12
  ---
9
13
 
10
14
  # Runbook 助手
@@ -1,13 +1,14 @@
1
1
  ---
2
2
  source: ../../../../skills/security-assistant/SKILL.md
3
3
  source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-03-23
4
+ translation_version: 1.1.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
7
  description: |
8
- 引导安全审查和漏洞评估,遵循 OWASP 标准。
9
- 使用时机:安全审计、漏洞检查、安全编码审查、威胁建模。
10
- 关键字:security, OWASP, vulnerability, authentication, authorization, 安全, 漏洞, 认证。
8
+ 引导安全审查与漏洞评估,遵循 OWASP 标准。
9
+ Use when: 安全审计、漏洞检查、安全编码审查、威胁建模。
10
+ Not for: 自动化的依赖包、CVE 与密钥扫描——请用 /scan;处理正在发生的安全事件——请用 /incident。
11
+ Keywords: security, OWASP, vulnerability, authentication, authorization, 信息安全, 漏洞, 认证, 授权, 威胁建模.
11
12
  ---
12
13
 
13
14
  # 安全审计助手
@@ -1,13 +1,14 @@
1
1
  ---
2
2
  source: ../../../../skills/security-scan-assistant/SKILL.md
3
3
  source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-03-23
4
+ translation_version: 1.1.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
7
  description: |
8
- 引导自动化安全扫描、依赖包审计和机密检测。
9
- 使用时机:依赖审计、CVE 扫描、机密检测、许可证合规。
10
- 关键字:scan, audit, CVE, dependency, secret, SBOM, vulnerability, 扫描, 漏洞。
8
+ 引导自动化安全扫描、依赖包审计与密钥检测。
9
+ Use when: 依赖包审计、CVE 扫描、密钥检测、许可证合规。
10
+ Not for: 人工的威胁建模与安全设计审查——请用 /security;一般的代码整洁度——请用 /sweep。
11
+ Keywords: scan, audit, CVE, dependency, secret, SBOM, vulnerability, 扫描, 审计, 依赖包, 密钥检测.
11
12
  ---
12
13
 
13
14
  # 安全扫描助手
@@ -2,13 +2,16 @@
2
2
  name: skill-builder
3
3
  source: ../../../../skills/skill-builder/SKILL.md
4
4
  source_version: 1.0.0
5
- translation_version: 1.0.0
6
- last_synced: 2026-07-16
7
- source_hash: 1c5f079e0851
5
+ translation_version: 1.1.0
6
+ last_synced: 2026-08-17
7
+ source_hash: 8eee581c49c4
8
8
  status: current
9
9
  scope: universal
10
10
  description: |
11
- [UDS] 识别重复流程并以正确的开发深度构建 Skill
11
+ [UDS] 把重复的手动流程转成范围界定得宜的 Skill,过程中拿捏恰当的流程分量。
12
+ Use when: 同一段多步骤流程已经手动做过三次以上、把临时凑出来的 Skill 正式化、决定某个 Skill 该放在哪一层。
13
+ Not for: 记录历史事实或项目状态——那属于记忆,不是 Skill;不会再发生的一次性任务。
14
+ Keywords: skill, skill builder, process knowledge, repeated process, automation, 技能建立, 流程知识, 自动化, 重复流程.
12
15
  allowed-tools: Read, Glob, Grep, Write, Edit, Bash
13
16
  argument-hint: "[process description | 流程描述]"
14
17
  ---
@@ -1,10 +1,14 @@
1
1
  ---
2
2
  source: ../../../../skills/slo-assistant/SKILL.md
3
3
  source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-04-10
4
+ translation_version: 1.1.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
- description: "[UDS] 引导 SLI 选取、SLO 设置和 Error Budget 管理"
7
+ description: |
8
+ 引导 SLI 选取、SLO 设置与 Error Budget 管理。
9
+ Use when: 定义服务质量目标、建立以 SLO 为基础的告警、Error Budget 策略。
10
+ Not for: 埋点与指标收集——请用 /observability;处理正在违反目标的状况——请用 /incident。
11
+ Keywords: SLI, SLO, SLA, Error Budget, burn rate, service level, 服务等级, 错误预算, 燃烧率, 服务质量目标.
8
12
  ---
9
13
 
10
14
  # SLO 助手
@@ -2,13 +2,16 @@
2
2
  name: spec-derive
3
3
  source: ../../../../skills/spec-derivation/SKILL.md
4
4
  source_version: 1.0.0
5
- translation_version: 1.0.0
6
- last_synced: 2026-07-16
7
- source_hash: 094ceb9af93a
5
+ translation_version: 1.1.0
6
+ last_synced: 2026-08-17
7
+ source_hash: 3f875cea1cad
8
8
  status: current
9
9
  scope: partial
10
10
  description: |
11
- [UDS] 从规格衍生 BDD 场景、TDD 骨架或 ATDD 表格
11
+ [UDS] 从已批准的规格推导出 BDD 场景、TDD 骨架、集成与 E2E 测试,以及 ATDD 表格。
12
+ Use when: 规格已批准且需要产出测试产物、从验收条件生成带标签的测试骨架、从规格生成契约桩。
13
+ Not for: 从既有代码回推规格——请用 /reverse;撰写或审查规格本身——请用 /sdd。
14
+ Keywords: forward derivation, spec to test, BDD scenario, TDD skeleton, ATDD table, 正向推演, 规格衍生, 测试生成, 契约桩.
12
15
  allowed-tools: Read, Write, Grep, Glob
13
16
  argument-hint: "[all|bdd|tdd|it|e2e|atdd] <spec-file>"
14
17
  prerequisites: ["spec-approved"]
@@ -1,14 +1,15 @@
1
1
  ---
2
2
  source: ../../../../skills/spec-driven-dev/SKILL.md
3
3
  source_version: 1.2.0
4
- translation_version: 1.2.0
5
- last_synced: 2026-07-16
6
- source_hash: 488aea3f5120
4
+ translation_version: 1.3.0
5
+ last_synced: 2026-08-17
6
+ source_hash: 989b50cd2147
7
7
  status: current
8
8
  description: |
9
- 在编写代码前,建立、审查和管理规格文件。
10
- 使用时机:建立规格、审查设计、规格驱动开发流程。
11
- 关键字:spec, specification, SDD, design, review, 规格, 设计, 审查, 验证。
9
+ [UDS] 在写代码之前建立并审查规格文档——规格格式、状态与差异操作。
10
+ Use when: 某项变更需要先有书面规格、审查规格的完整性、用 delta 区段修订既有规格。
11
+ Not for: 执行带关卡的 SDD 生命周期——该部分已移至采用层(XSPEC-095);快速迭代用的轻量微规格——请用 uds spec 命令。
12
+ Keywords: SDD, spec, specification, design document, delta operation, spec review, 规格驱动开发, 规格文档, 变更操作, 规格审查.
12
13
  ---
13
14
  <!-- DEPRECATION NOTICE (XSPEC-086 Phase 4, 2026-04-28):
14
15
  SDD 生命周期编排(7 阶段状态机、阶段转换、闸门检查)已迁移至
@@ -2,15 +2,16 @@
2
2
  name: sweep
3
3
  source: ../../../../skills/sweep/SKILL.md
4
4
  source_version: 1.0.0
5
- translation_version: 1.0.0
6
- last_synced: 2026-07-16
7
- source_hash: 340ed7c83bbd
5
+ translation_version: 1.1.0
6
+ last_synced: 2026-08-17
7
+ source_hash: 85af5ee0d1f4
8
8
  status: current
9
9
  scope: universal
10
10
  description: |
11
- [UDS] 扫描代码库的调试残留与代码质量问题;可自动修正安全模式。
12
- Use when: before committing, during PR review, or periodic codebase cleanup.
13
- Keywords: sweep, debug cleanup, console.log, debugger, TODO, ts-any, code quality, 扫描, 清理.
11
+ 扫描代码库中的调试残留与代码质量问题;可选择自动修正安全的模式。
12
+ Use when: 提交前、PR 审查期间,或定期清理代码库。
13
+ Not for: 结构性的代码改善——请用 /refactor;针对安全的专门扫描——请用 /scan。
14
+ Keywords: sweep, debug cleanup, console.log, debugger, TODO, ts-any, code quality, 扫描, 清理, 调试残留.
14
15
  allowed-tools: Read, Grep, Glob, Bash(find:*), Edit, Write
15
16
  argument-hint: "[--fix] [--report] [--path <dir>] [--exclude <pattern>]"
16
17
  ---
@@ -1,13 +1,14 @@
1
1
  ---
2
2
  source: ../../../../skills/tdd-assistant/SKILL.md
3
3
  source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-02-10
4
+ translation_version: 1.1.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
7
  description: |
8
- 引导测试驱动开发(TDD)流程:红-绿-重构。
9
- 使用时机:TDD 开发、撰写测试先行的代码、学习 TDD。
10
- 关键字:TDD, test-driven, red-green-refactor, 测试驱动, 红绿重构。
8
+ [UDS] 测试驱动开发(TDD)的参考资料:红-绿-重构循环、FIRST 原则与 Arrange-Act-Assert 结构。
9
+ Use when: 在实现前先写一个会失败的测试、用 Arrange-Act-Assert 组织测试、以 FIRST 检视既有测试。
10
+ Not for: 交互式地驱动 RED/GREEN 循环——该部分已移至采用层(XSPEC-095);测量测试覆盖了多少代码——请用 /coverage。
11
+ Keywords: TDD, test first, Red Green Refactor, FIRST, Arrange Act Assert, unit test, 测试驱动开发, 红绿重构, 单元测试.
11
12
  ---
12
13
 
13
14
  # TDD 助手
@@ -1,13 +1,14 @@
1
1
  ---
2
2
  source: ../../../../skills/test-coverage-assistant/SKILL.md
3
3
  source_version: 1.1.0
4
- translation_version: 1.1.0
5
- last_synced: 2026-02-10
4
+ translation_version: 1.2.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
7
  description: |
8
- 多维度分析测试覆盖率并提供可执行的建议。
9
- 使用时机:分析覆盖率、识别测试缺口、制定测试策略。
10
- 关键字:coverage, test, analysis, dimension, 覆盖率, 测试, 分析, 维度。
8
+ [UDS] 以八维度框架分析代码层级的测试覆盖率,并建议该优先补上哪些缺口。
9
+ Use when: 覆盖率数字看起来很健康但缺陷照样流出、要在行覆盖率之外判断测试完整性、设定覆盖率目标。
10
+ Not for: 需求层级的 AC 与测试追踪——请用 /ac-coverage;补写缺少的测试——请用 /tdd 或 /spec-derive。
11
+ Keywords: test coverage, eight dimensions, line coverage, branch coverage, test quality, 测试覆盖率, 八维度, 测试完整性, 覆盖缺口.
11
12
  ---
12
13
 
13
14
  # 测试覆盖率助手
@@ -1,16 +1,17 @@
1
1
  ---
2
2
  source: ../../../../skills/testing-guide/SKILL.md
3
3
  source_version: 1.2.0
4
- translation_version: 1.2.0
5
- last_synced: 2026-07-16
6
- source_hash: 2a5e2a667b04
4
+ translation_version: 1.3.0
5
+ last_synced: 2026-08-17
6
+ source_hash: 372f9eca773d
7
7
  status: current
8
8
  name: testing
9
9
  description: |
10
- 面向 UT/IT/ST/E2E 的测试金字塔与测试编写标准。
10
+ 测试金字塔,以及 UT/IT/ST/E2E 的测试编写标准。
11
11
  支持 ISTQB 与业界通行金字塔两种框架。
12
- 使用时机:编写测试、讨论测试覆盖率、测试策略或测试命名时。
13
- 关键词:test, unit, integration, e2e, coverage, mock, ISTQB, SIT, 测试, 单元, 集成, 端对端。
12
+ Use when: 编写测试、讨论测试覆盖率、测试策略或测试命名时。
13
+ Not for: 驱动红-绿-重构循环——请用 /tdd;测量实际达成的覆盖率——请用 /coverage。
14
+ Keywords: test, unit, integration, e2e, coverage, mock, ISTQB, SIT, 测试, 单元测试, 集成测试, 端对端.
14
15
  ---
15
16
 
16
17
  # 测试指南
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  source: ../../CHANGELOG.md
3
- source_version: 6.5.0
4
- translation_version: 6.5.0
5
- last_synced: 2026-08-14
3
+ source_version: 6.7.0
4
+ translation_version: 6.7.0
5
+ last_synced: 2026-08-17
6
6
  status: current
7
7
  ---
8
8
 
@@ -17,6 +17,37 @@ status: current
17
17
 
18
18
  ## [Unreleased]
19
19
 
20
+ ## [6.7.0] - 2026-08-17
21
+
22
+ ### 修正
23
+
24
+ - **skill 觸發面在三層全數復原——55 個 skill × 英文、zh-TW、zh-CN。** 一個 skill 的 `description` 是模型決定要不要叫用它時**唯一看得到的東西**。commit `d415937e`(2026-02-10)把其中 17 個改寫成 `[UDS] <標籤>`,刪掉 `Use when:` 與 `Keywords:` 兩行、**連中文關鍵字一起**;相鄰 commit 的標題寫著 `token optimization`。當時**只有 token 可數**——沒有任何東西在量觸發面,於是那個取捨看起來是單邊的,而它不是。2026-08-14 量測:55 個含 `SKILL.md` 的 skill 中,**27 個有觸發條件、27 個有關鍵字、0 個有排除條件、28 個兩者皆無**——而那 28 個正是方法論核心:tdd、bdd、atdd、spec-driven-dev、code-review、commit-standards、checkin、requirement。
25
+ - **英文來源**:28 個復原,且**全部 55 個補上排除條件**(`Not for:`)。只加觸發不加排除,換來的是過度觸發;而一個不該響卻響的 skill 會被整個關掉,**連帶拖走還能用的那些**。15 個可從 git 歷史救回者中**有 8 個被重寫**,因為歷史文字已不描述現行行為——其中六個宣稱自己會引導某套生命週期,而那已於 XSPEC-095 移交採用層。**救回一個過期的描述,比不救更糟。**
26
+ - **語系層**:zh-TW 與 zh-CN **各 55/55,是翻譯不是轉碼**。**這一半才是重點**——以 `--locale zh-tw` 安裝的專案,在英文來源已修好時仍拿到被剝過的描述,這個修正本來到不了它要給的那個讀者。繁體與簡體各自用道地用詞,另修正三份 zh-CN 描述中混入的繁體字。
27
+ - **翻譯 drift 62 → 38**,剩下的 38 是刻意的停點:24 份漂移完全來自本次 description 編輯者更新了 hash,12 份本文早已漂移者保留過期 hash——更新它們等於宣稱整份檔案已同步,而那件事沒有人驗證過。
28
+ - ⚠️ **28 個中有 10 個帶著 `disable-model-invocation: true`**,由同一個 `d415937e` 加入。對那 10 個而言,補描述**並不會**讓它們變成可被選中——擋住的是那個旗標,而要不要拿掉它是**設計決定不是缺陷**。模型真正選得到的數量是 **45,不是 55**。
29
+
30
+ ### 新增
31
+
32
+ - **`ai-response-navigation` 1.2.0 → 1.3.0 —— 選用規則 R10 與 R11。** 它們的來源與 R7–R9 不同:使用者在同一次工作階段中**兩度**指出,一個正確且完整的回答讀不懂,而當時 R7–R9 已經出貨且正在被遵守。**先講發現並不足夠。**
33
+ - **R10 —— 白話是主詞,識別字是佐證。** *觸發*:任何向人解釋一個情況、一個缺陷、或一個系統行為的回應。用讀者會用的話說清楚發生了什麼;路徑、符號、行號、指令輸出、版本字串屬於它們所支持的那句話**之後**,而不是那句話本身。它**不是**可以省略它們的許可——想驗證的讀者必須驗得了。**與 R7 分開是刻意的**:R7 管的是「先發現後證據」的順序,而一個回應可以先講發現、卻仍用只有作者持有的詞彙講它。兩者都讓讀者無法行動,但它們是不同的失效。
34
+ - **R11 —— 每個選項都要帶自己的優劣。** *觸發*:要求讀者在兩個以上做法之間選擇的回應。規則 2 已要求標示推薦項並給出**它的**理由;R11 要求**每一個**選項都說明它換到什麼、代價是什麼。一份只有推薦項被論證的清單,等於**把比較的工作丟回給讀者**——而那正是他請你做的事;而沒標代價的選項讀起來像是沒有代價。**優劣不是模稜兩可**:「稍微難一點」不是代價,「重寫 110 個檔且翻譯需要人審」才是。空白的代價欄讀起來是「沒有分析過」,而讀者分不出這兩者。
35
+
36
+ ## [6.6.0] - 2026-08-17
37
+
38
+ ### 新增
39
+
40
+ - **`spec-driven-development` 2.3.0 → 2.4.0 —— 沒有驗證項的 AC 不是 AC。** 每一條驗收標準都必須有一個**指向它的驗證項**——測試、檢查、閘門,或一則明確記錄的手動步驟。沒有任何驗證項引用的 AC 是一張沒有人兌現的支票,而且它**不會**大聲失敗:它只是安靜地停止成立,而規格繼續宣稱它為真。**規則**:這樣的 AC 必須**降級為設計意圖**,不得繼續掛在 AC 欄——降級是誠實的,未經驗證的 AC 不是。標準同時寫明什麼**不算**驗證項:「審查者會注意到」不是驗證項,因為審查者讀的是規格,而規格說那條 AC 成立。新增規則 `SDD-AC-VERIFIED`。
41
+ - **實測案例**:一份 2026-05-14 的規格寫著 `AC-7:舊版系統報告完整保留(無回歸)`。它的 Test Plan 有七項,**沒有一項指向 AC-7**。該報告的 timer 是 disabled、部署函式從未被呼叫——**從那條 AC 被寫下的同一天起**。三個月後在驗證一件無關的安裝時偶然撞到。它不是接上了檢查後來鬆脫,**它從來沒有被接上過**。
42
+
43
+ - **`ai-response-navigation` 1.1.0 → 1.2.0 —— 選用規則 R7–R9,管答案本身**(XSPEC 借鑒 B-10,來源 [`ayghri/i-have-adhd`](https://github.com/ayghri/i-have-adhd),MIT)。規則 1–6 管的是答案**之後**要附什麼:導航區塊、標記過的推薦、匹配回應類型的模板。**答案本身沒有任何規則在管。** 於是一個回應可以把結論埋在一整面證據底下,只要結尾附上正確的導航區塊,它仍然滿足**本標準的每一條**——而找不到答案的讀者,不會因為被告知下一步而得到幫助。
44
+ - **R7 —— 先講發現,不要先講過程。** *觸發*:回答問題、回報調查結果、或提出決策的回應。第一行寫**查到了什麼**或**該做什麼**——不是方法、不是把問題複述一遍、不是回答的計畫。證據(`file:line`、指令輸出、表格、量測數字)是**佐證**,應放在它所支持的主張之後;以證據開場會迫使讀者自行重建結論,而那正是他請你做的工作。本條規範的是**順序**,**不**代表可以省略證據。
45
+ - **R8 —— 每一輪重述進度。** *觸發*:跨 3 輪以上的對話,或含 3 個以上步驟的任務。用一行說明工作進行到哪裡。不能假設讀者能在訊息之間記住「我們在 5 步中的第 3 步」,而重述它的成本是一個句子。與模板 4(進行中)互補:**R8 管開頭,模板管結尾。**
46
+ - **R9 —— 不要開場白。** *觸發*:任何實質性回應。本條把一項既有禁令一般化:[`anti-sycophancy-prompting`](../../core/anti-sycophancy-prompting.md) 已經禁止「以正面肯定開場批評」,但**僅限批評情境**。R9 把同一項禁令擴及每一個實質回應,理由不同——不是為了防拍馬屁,而是為了消除它在讀者與答案之間製造的延遲。**R9 不適用於結語**;R1 的導航區塊要求依然成立。
47
+ - **來源十條只取三條,其餘七條的淘汰理由寫進標準本文**,不是只寫在待辦清單裡。兩條與 R1–R2 重複。三條與本標準或其他標準衝突:它的「不要 recap/不要結語」**與 R1 的導航區塊直接矛盾**;它的「清單上限 5 項」會切斷證據表格與走訪分母;它的「具體時間估計」已由 [`estimation-standards`](../../core/estimation-standards.md) 涵蓋。
48
+ - **選用的語義同 R6**(模型級別標注):採用者不必啟用、既有 skill 不需回頭補,專案**可以**在自己的設定中把任一條提升為必須。**不可選的是每一條都帶有精確的觸發條件**——一條鬆到永遠不會啟動的規則,與沒有這條規則無從分辨,那正是 XSPEC-378 記錄的失效模式。
49
+ - **擴充既有標準而非新建一支**:再開一支管「AI 怎麼對人類寫回答」的標準,會讓同一條軸出現兩個實作。
50
+
20
51
  ## [6.5.0] - 2026-08-14
21
52
 
22
53
  ### 新增