universal-dev-standards 6.14.0-beta.9 → 6.14.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 (711) hide show
  1. package/bin/uds.js +12 -1
  2. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  3. package/bundled/ai/standards/commit-message.ai.yaml +12 -2
  4. package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
  5. package/bundled/core/commit-message-guide.md +22 -19
  6. package/bundled/core/secret-management-standards.md +13 -1
  7. package/bundled/extensions/locales/zh-tw.md +19 -19
  8. package/bundled/hooks/validate-commit-msg.mjs +52 -9
  9. package/bundled/locales/zh-CN/CHANGELOG.md +2309 -1110
  10. package/bundled/locales/zh-CN/CLAUDE.md +987 -101
  11. package/bundled/locales/zh-CN/README.md +3 -3
  12. package/bundled/locales/zh-CN/SECURITY.md +3 -3
  13. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  14. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
  15. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  16. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
  17. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
  18. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
  19. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
  20. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  21. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  22. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  23. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  24. package/bundled/locales/zh-CN/core/accessibility-standards.md +871 -62
  25. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  26. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  27. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  28. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  29. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  30. package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +311 -72
  31. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  32. package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
  33. package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
  34. package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
  35. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  36. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  37. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  38. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  39. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  40. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  41. package/bundled/locales/zh-CN/core/changelog-standards.md +485 -63
  42. package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
  43. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  44. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  45. package/bundled/locales/zh-CN/core/code-review-checklist.md +37 -23
  46. package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
  47. package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
  48. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  49. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  50. package/bundled/locales/zh-CN/core/deprecation-standards.md +155 -40
  51. package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
  52. package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
  53. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  54. package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
  55. package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
  56. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  57. package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
  58. package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
  59. package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
  60. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  61. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  62. package/bundled/locales/zh-CN/core/feature-flag-standards.md +202 -57
  63. package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
  64. package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
  65. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  66. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  67. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  68. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  69. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  70. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  71. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  72. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  73. package/bundled/locales/zh-CN/core/mutation-testing.md +45 -6
  74. package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
  75. package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
  76. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  77. package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
  78. package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
  79. package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
  80. package/bundled/locales/zh-CN/core/project-structure.md +550 -170
  81. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  82. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  83. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  84. package/bundled/locales/zh-CN/core/retrospective-standards.md +215 -22
  85. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  86. package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
  87. package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
  88. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  89. package/bundled/locales/zh-CN/core/security-standards.md +169 -16
  90. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  91. package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
  92. package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
  93. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  94. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  95. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  96. package/bundled/locales/zh-CN/core/supply-chain-security-standards.md +159 -32
  97. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  98. package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
  99. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  100. package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
  101. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  102. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  103. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  104. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  105. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  106. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  107. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  108. package/bundled/locales/zh-CN/core/versioning.md +737 -73
  109. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  110. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  111. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  112. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +2 -1
  113. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  114. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
  115. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
  116. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  117. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
  118. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  119. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
  120. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  121. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  122. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +2 -0
  123. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  124. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  125. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  126. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  127. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  128. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  129. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  130. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  131. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  132. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  133. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  134. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  135. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  136. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  137. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  138. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  139. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  140. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  141. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  142. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  143. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  144. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  145. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  146. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  147. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  148. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  149. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  150. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  151. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  152. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  153. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  154. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  155. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  156. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  157. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  158. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  159. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  160. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  161. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  162. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  163. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  164. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  165. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  166. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  167. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  168. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  169. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  170. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  171. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  172. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  173. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  174. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  175. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  176. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  177. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  178. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  179. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  180. package/bundled/locales/zh-CN/skills/README.md +2 -1
  181. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  182. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  183. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  184. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  185. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  186. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  187. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  188. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  189. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  190. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  191. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  192. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  193. package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +217 -137
  194. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  195. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  196. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  197. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  198. package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +148 -132
  199. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  200. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  201. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  202. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  203. package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +122 -121
  204. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  205. package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
  206. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  207. package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
  208. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  209. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  210. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  211. package/bundled/locales/zh-CN/skills/code-review-assistant/guide.md +119 -45
  212. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  213. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  214. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  215. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  216. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  217. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  218. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  219. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  220. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  221. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  222. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  223. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  224. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  225. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  226. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  227. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  228. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  229. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  230. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  231. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  232. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  233. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  234. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  235. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  236. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  237. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  238. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  239. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  240. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  241. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  242. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  243. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  244. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  245. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  246. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  247. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  248. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  249. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  250. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  251. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  252. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  253. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  254. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  255. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  256. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  257. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  258. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  259. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  260. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  261. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +4 -4
  262. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  263. package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
  264. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  265. package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
  266. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  267. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  268. package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +4 -2
  269. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  270. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  271. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  272. package/bundled/locales/zh-CN/skills/docs-generator/guide.md +8 -7
  273. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  274. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  275. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  276. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  277. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  278. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  279. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  280. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  281. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  282. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  283. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  284. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  285. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  286. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  287. package/bundled/locales/zh-CN/skills/project-discovery/guide.md +158 -157
  288. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  289. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  290. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  291. package/bundled/locales/zh-CN/skills/refactoring-assistant/guide.md +172 -171
  292. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  293. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  294. package/bundled/locales/zh-CN/skills/release-standards/guide.md +51 -43
  295. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  296. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  297. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  298. package/bundled/locales/zh-CN/skills/requirement-assistant/guide.md +88 -79
  299. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  300. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  301. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  302. package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +2 -2
  303. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  304. package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
  305. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  306. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  307. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  308. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  309. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  310. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  311. package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +2 -2
  312. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  313. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  314. package/bundled/locales/zh-CN/skills/tdd-assistant/guide.md +217 -156
  315. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  316. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  317. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  318. package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +25 -12
  319. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  320. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  321. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  322. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  323. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  324. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  325. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  326. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  327. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  328. package/bundled/locales/zh-TW/CHANGELOG.md +2282 -1112
  329. package/bundled/locales/zh-TW/CLAUDE.md +962 -76
  330. package/bundled/locales/zh-TW/README.md +3 -3
  331. package/bundled/locales/zh-TW/SECURITY.md +3 -3
  332. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  333. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
  334. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  335. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
  336. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
  337. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
  338. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
  339. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  340. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  341. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  342. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  343. package/bundled/locales/zh-TW/core/accessibility-standards.md +895 -46
  344. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  345. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  346. package/bundled/locales/zh-TW/core/agent-dispatch.md +102 -33
  347. package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
  348. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  349. package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
  350. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  351. package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
  352. package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
  353. package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
  354. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  355. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  356. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  357. package/bundled/locales/zh-TW/core/branch-completion.md +130 -34
  358. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  359. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  360. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  361. package/bundled/locales/zh-TW/core/chaos-engineering-standards.md +138 -36
  362. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  363. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  364. package/bundled/locales/zh-TW/core/code-review-checklist.md +19 -7
  365. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  366. package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
  367. package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
  368. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  369. package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
  370. package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
  371. package/bundled/locales/zh-TW/core/developer-memory.md +102 -12
  372. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  373. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  374. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  375. package/bundled/locales/zh-TW/core/environment-standards.md +250 -72
  376. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  377. package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
  378. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  379. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  380. package/bundled/locales/zh-TW/core/feature-flag-standards.md +202 -57
  381. package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
  382. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  383. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  384. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  385. package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +234 -487
  386. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  387. package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
  388. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  389. package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
  390. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  391. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  392. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  393. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  394. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  395. package/bundled/locales/zh-TW/core/observability-standards.md +284 -40
  396. package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
  397. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  398. package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
  399. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  400. package/bundled/locales/zh-TW/core/project-context-memory.md +210 -31
  401. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  402. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  403. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  404. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  405. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  406. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  407. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  408. package/bundled/locales/zh-TW/core/runbook-standards.md +296 -23
  409. package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
  410. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  411. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  412. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  413. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  414. package/bundled/locales/zh-TW/core/slo-standards.md +301 -49
  415. package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
  416. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  417. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  418. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  419. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  420. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  421. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  422. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  423. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  424. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  425. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  426. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  427. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  428. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  429. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  430. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  431. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  432. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  433. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  434. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  435. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +2 -1
  436. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  437. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
  438. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  439. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
  440. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  441. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
  442. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  443. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
  444. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  445. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  446. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +2 -0
  447. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  448. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  449. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  450. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  451. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  452. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  453. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  454. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  455. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  456. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  457. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  458. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  459. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  460. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  461. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  462. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  463. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  464. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  465. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  466. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  467. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  468. package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +584 -475
  469. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  470. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  471. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  472. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  473. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  474. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  475. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  476. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  477. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  478. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  479. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  480. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  481. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  482. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  483. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  484. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  485. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  486. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  487. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  488. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  489. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  490. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  491. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  492. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  493. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  494. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  495. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  496. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  497. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  498. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  499. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  500. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  501. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  502. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  503. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  504. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  505. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  506. package/bundled/locales/zh-TW/skills/README.md +2 -1
  507. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  508. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  509. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  510. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  511. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  512. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  513. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  514. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  515. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  516. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  517. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  518. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  519. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  520. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  521. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  522. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  523. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  524. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  525. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  526. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  527. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  528. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  529. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  530. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  531. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  532. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  533. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  534. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  535. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  536. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  537. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  538. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  539. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  540. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  541. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  542. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  543. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  544. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  545. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  546. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  547. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  548. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  549. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  550. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  551. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  552. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  553. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  554. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  555. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  556. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  557. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  558. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  559. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  560. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  561. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  562. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  563. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  564. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  565. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  566. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  567. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  568. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  569. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  570. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  571. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  572. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  573. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  574. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  575. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  576. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  577. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  578. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  579. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  580. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  581. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  582. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  583. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  584. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  585. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  586. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  587. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  588. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  589. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  590. package/bundled/locales/zh-TW/skills/commit-standards/guide.md +137 -17
  591. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  592. package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
  593. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  594. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  595. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  596. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  597. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  598. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  599. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  600. package/bundled/locales/zh-TW/skills/docs-generator/guide.md +4 -3
  601. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  602. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  603. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  604. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  605. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  606. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  607. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  608. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  609. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  610. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  611. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  612. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  613. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  614. package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +85 -18
  615. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  616. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  617. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  618. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  619. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  620. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  621. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  622. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  623. package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +91 -45
  624. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  625. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  626. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  627. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  628. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  629. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  630. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  631. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  632. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  633. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  634. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  635. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  636. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  637. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  638. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  639. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  640. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  641. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  642. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  643. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  644. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  645. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  646. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  647. package/bundled/locales/zh-TW/skills/tdd-assistant/language-examples.md +693 -47
  648. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  649. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  650. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  651. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  652. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  653. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  654. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  655. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  656. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  657. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  658. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  659. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  660. package/bundled/skills/.claude-plugin/plugin.json +71 -0
  661. package/bundled/skills/commit-standards/SKILL.md +2 -2
  662. package/bundled/skills/commit-standards/guide.md +3 -2
  663. package/bundled/skills/commit-standards/language-options.md +19 -17
  664. package/package.json +2 -2
  665. package/src/commands/audit.js +28 -1
  666. package/src/commands/check.js +72 -3
  667. package/src/commands/compile.js +37 -4
  668. package/src/commands/config.js +49 -24
  669. package/src/commands/init.js +78 -30
  670. package/src/commands/open-work.js +6 -2
  671. package/src/commands/release-messages.js +228 -0
  672. package/src/commands/release.js +127 -68
  673. package/src/commands/run-intent.js +11 -0
  674. package/src/commands/spec.js +4 -2
  675. package/src/commands/update.js +173 -20
  676. package/src/compilers/claude-code-compiler.js +9 -1
  677. package/src/config/ai-agent-paths.js +14 -1
  678. package/src/core/installed-formats.js +15 -0
  679. package/src/core/open-work-config.js +20 -1
  680. package/src/core/project-config.js +55 -0
  681. package/src/i18n/messages.js +106 -2
  682. package/src/installers/hooks-installer.js +1 -1
  683. package/src/installers/manifest-installer.js +1 -1
  684. package/src/installers/skills-installer.js +1 -1
  685. package/src/installers/standards-installer.js +3 -1
  686. package/src/mcp/server.js +9 -3
  687. package/src/prompts/init.js +26 -22
  688. package/src/reconciler/actual-state-scanner.js +2 -8
  689. package/src/reconciler/backup-locations.js +5 -0
  690. package/src/reconciler/backup-manager.js +19 -11
  691. package/src/reconciler/desired-state-calculator.js +89 -57
  692. package/src/reconciler/plan-executor.js +101 -8
  693. package/src/reconciler/recorded-versions.js +49 -0
  694. package/src/reconciler/relative-path.js +23 -0
  695. package/src/uninstallers/hook-uninstaller.js +9 -1
  696. package/src/uninstallers/skills-uninstaller.js +22 -3
  697. package/src/utils/available-standards-report.js +25 -4
  698. package/src/utils/available-standards.js +13 -3
  699. package/src/utils/build-manifest.js +1 -1
  700. package/src/utils/commit-message-judge.js +60 -13
  701. package/src/utils/friction-detector.js +23 -11
  702. package/src/utils/git-hooks.js +106 -4
  703. package/src/utils/integration-generator.js +95 -67
  704. package/src/utils/legacy-hook-migration.js +121 -2
  705. package/src/utils/open-work-tracking.mjs +105 -16
  706. package/src/utils/sdd-header.js +16 -4
  707. package/src/utils/skills-installer.js +2 -1
  708. package/src/utils/spinner.js +14 -4
  709. package/src/utils/standard-validator.js +3 -2
  710. package/standards-registry.json +10 -8
  711. package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
@@ -52,6 +52,7 @@ import {
52
52
  getAgentDisplayName,
53
53
  getAgentConfig,
54
54
  getSkillsDirForAgent,
55
+ hasSkillsLevel,
55
56
  getCommandsDirForAgent
56
57
  } from '../config/ai-agent-paths.js';
57
58
  import { getMarketplaceSkillsInfo } from '../utils/github.js';
@@ -60,7 +61,7 @@ import { detectAITools } from '../utils/detector.js';
60
61
  import { HOOK_CAPABLE_TOOLS, resolveHookTools, installMissingHooks } from '../installers/hooks-installer.js';
61
62
  import { persistRecorder, mergeRecorderInto, newRecorder } from '../core/install-records.js';
62
63
  import { installGateScripts, gateStandardInstalled, GATE_SCRIPTS } from '../utils/gate-scripts.js';
63
- import { migrateLegacyHuskyHook } from '../utils/legacy-hook-migration.js';
64
+ import { migrateLegacyHuskyHook, migrateHuskyBlockWithoutCi, migrateOlderNativeHook } from '../utils/legacy-hook-migration.js';
64
65
  import {
65
66
  promptSkillsInstallLocation,
66
67
  promptCommandsInstallation
@@ -76,6 +77,7 @@ import {
76
77
  cleanupBackups
77
78
  } from '../reconciler/index.js';
78
79
  import { stepWritePaths } from '../reconciler/install-roots.js';
80
+ import { alignRecordedVersions, alignUpstreamVersion } from '../reconciler/recorded-versions.js';
79
81
  import { restoreSingleFile } from './check.js';
80
82
  import { guardAgainstSelfAdoption } from '../utils/detect-self-adoption.js';
81
83
  import { resolveIntegrationFile, SUPPORTED_AI_TOOLS, getToolFormat } from '../core/constants.js';
@@ -513,6 +515,11 @@ export async function updateCommand(options) {
513
515
  migrateLegacyPreCommitHook(projectPath, manifest, { plan: !!options.plan });
514
516
  }
515
517
 
518
+ if (options.from && !options.rollback) {
519
+ console.log(chalk.yellow(' ! --from names the backup for --rollback; without --rollback it does nothing and is ignored.'));
520
+ console.log();
521
+ }
522
+
516
523
  // Handle --rollback option (DSR). It restores a whole backup, so a scope
517
524
  // flag cannot narrow it — say so rather than appearing to honour it.
518
525
  if (options.rollback) {
@@ -520,7 +527,7 @@ export async function updateCommand(options) {
520
527
  console.log(chalk.yellow(' ! --rollback restores a complete backup; --skills/--commands cannot narrow it and are ignored.'));
521
528
  console.log();
522
529
  }
523
- await handleRollback(projectPath);
530
+ await handleRollback(projectPath, options);
524
531
  return;
525
532
  }
526
533
 
@@ -1940,7 +1947,6 @@ export function migrateLegacyPreCommitHook(projectPath, manifest, { plan = false
1940
1947
  if (r.state === 'error') {
1941
1948
  console.log(chalk.yellow(` ${msg.hookMigrateFailed.replace('{error}', r.error)}`));
1942
1949
  console.log();
1943
- return r;
1944
1950
  }
1945
1951
  if (r.state === 'migrated') console.log(chalk.green(` ${msg.hookMigrated}`));
1946
1952
  if (r.state === 'would-migrate') console.log(chalk.cyan(` ${msg.hookWouldMigrate}`));
@@ -1954,6 +1960,30 @@ export function migrateLegacyPreCommitHook(projectPath, manifest, { plan = false
1954
1960
  // this the record persisted just above would be overwritten by the older copy.
1955
1961
  Object.assign(manifest, mergeRecorderInto(manifest, r.recorder));
1956
1962
  }
1963
+
1964
+ // XSPEC-482 R3 + R5: hooks that run the check and cannot stop a commit - the husky block that runs `check`
1965
+ // without `--ci`, and the native hook of 5.x .. 6.13.1 / the betas. Same treatment as above: only a text UDS
1966
+ // provably wrote is replaced, anything else is named and left alone, and --plan lists it.
1967
+ const huskyCi = migrateHuskyBlockWithoutCi(projectPath, { plan, manifest });
1968
+ if (huskyCi.state === 'error') console.log(chalk.yellow(` ${msg.hookMigrateFailed.replace('{error}', huskyCi.error)}`));
1969
+ if (huskyCi.state === 'migrated') console.log(chalk.green(` ${msg.hookHuskyCiMigrated}`)); // wire:update-migrates-husky-ci
1970
+ if (huskyCi.state === 'would-migrate') console.log(chalk.cyan(` ${msg.hookHuskyCiWouldMigrate}`));
1971
+
1972
+ const native = migrateOlderNativeHook(projectPath, { plan }); // wire:update-migrates-native-hook
1973
+ const nativeFrom = native.from === 'legacy-6.11' ? msg.hookNativeFromLegacy : msg.hookNativeFromWithoutCi;
1974
+ if (native.state === 'error') console.log(chalk.yellow(` ${msg.hookNativeFailed.replace('{error}', native.error)}`));
1975
+ if (native.state === 'migrated') console.log(chalk.green(` ${msg.hookNativeMigrated.replace('{from}', nativeFrom)}`));
1976
+ if (native.state === 'would-migrate') console.log(chalk.cyan(` ${msg.hookNativeWouldMigrate.replace('{from}', nativeFrom)}`));
1977
+ for (const k of native.kept) {
1978
+ console.log(chalk.yellow(` ${msg.hookNativeKept.replace('{line}', k.line).replace('{text}', k.text)}`));
1979
+ }
1980
+ if (huskyCi.state !== 'none' || native.state !== 'none') console.log();
1981
+ for (const extra of [huskyCi.recorder, native.recorder]) {
1982
+ if (extra) {
1983
+ persistRecorder(projectPath, extra);
1984
+ Object.assign(manifest, mergeRecorderInto(manifest, extra));
1985
+ }
1986
+ }
1957
1987
  return r;
1958
1988
  }
1959
1989
 
@@ -2724,13 +2754,21 @@ async function planSkills(projectPath, manifest, options) {
2724
2754
  return;
2725
2755
  }
2726
2756
 
2757
+ // XSPEC-482 R7: "unchanged" needs the files to agree too, as `uds update --plan` judges them - a recorded version
2758
+ // equal to the shipped one says nothing about a skill file that was deleted or edited.
2759
+ const skillActions = await skillActionsOf(projectPath);
2760
+
2727
2761
  let changed = 0;
2728
2762
  for (const inst of installations) {
2729
2763
  const info = getInstalledSkillsInfoForAgent(inst.agent, inst.level, projectPath);
2730
2764
  const current = info?.version || 'unknown';
2731
- const dir = getSkillsDirForAgent(inst.agent, inst.level, projectPath);
2732
- if (current === latestVersion) {
2765
+ const dir = getSkillsDirForAgent(inst.agent, inst.level, projectPath) ?? '(no such folder)'; // XSPEC-486: null when the tool has no folder at that level
2766
+ const differing = skillActions.filter((a) => a.details?.metadata?.agent === inst.agent && (a.details?.metadata?.level || 'project') === inst.level);
2767
+ if (current === latestVersion && differing.length === 0) {
2733
2768
  console.log(chalk.gray(` = ${getAgentDisplayName(inst.agent)} (${inst.level}): v${current} — unchanged`));
2769
+ } else if (current === latestVersion) {
2770
+ changed++;
2771
+ console.log(chalk.yellow(` ~ ${getAgentDisplayName(inst.agent)} (${inst.level}): v${current} — ${differing.length} skill file(s) differ from what this UDS ships ${dir}`));
2734
2772
  } else {
2735
2773
  changed++;
2736
2774
  console.log(chalk.yellow(` ~ ${getAgentDisplayName(inst.agent)} (${inst.level}): v${current} → v${latestVersion} ${dir}`));
@@ -2759,21 +2797,44 @@ async function planCommands(projectPath, manifest, options) {
2759
2797
  return;
2760
2798
  }
2761
2799
 
2800
+ // XSPEC-482 R7: ask the reconciler, the same question `uds update --plan` answers, instead of saying "would be
2801
+ // reinstalled" for every installation whatever is on disk. A project that is current used to get "51 command(s)
2802
+ // would be reinstalled" here, "unchanged" from `--plan --skills` and "No changes" from `--plan`.
2803
+ const actions = await commandActionsOf(projectPath);
2804
+
2805
+ let changed = 0;
2762
2806
  for (const inst of installations) {
2763
2807
  const agent = typeof inst === 'string' ? inst : inst.agent;
2764
2808
  const level = typeof inst === 'string' ? 'project' : (inst.level || 'project');
2765
2809
  const info = getInstalledCommandsForAgent(agent, level, projectPath);
2766
2810
  const dir = getCommandsDirForAgent(agent, level, projectPath);
2767
- console.log(chalk.yellow(` ~ ${getAgentDisplayName(agent)} (${level}): ${info?.count || 0} command(s) would be reinstalled ${dir}`));
2811
+ const differing = actions.filter((a) => a.details?.metadata?.agent === agent && (a.details?.metadata?.level || 'project') === level);
2812
+ if (differing.length === 0) {
2813
+ console.log(chalk.gray(` = ${getAgentDisplayName(agent)} (${level}): ${info?.count || 0} command(s) — unchanged`));
2814
+ } else {
2815
+ changed++;
2816
+ console.log(chalk.yellow(` ~ ${getAgentDisplayName(agent)} (${level}): ${differing.length} command file(s) would be written or removed ${dir}`)); // wire:plan-commands-asks-reconciler
2817
+ }
2768
2818
  }
2769
2819
 
2770
2820
  console.log();
2771
- console.log(`Summary: ${installations.length} installation(s) would be reinstalled.`);
2821
+ console.log(`Summary: ${changed} installation(s) would be reinstalled, ${installations.length - changed} unchanged.`);
2772
2822
  console.log(chalk.gray(` Locale that would be used: ${resolveLocale(manifest, projectPath, options)}`));
2773
- console.log(chalk.gray(' Run `uds update --apply --yes --commands` to apply.'));
2823
+ if (changed > 0) console.log(chalk.gray(' Run `uds update --apply --yes --commands` to apply.'));
2774
2824
  console.log();
2775
2825
  }
2776
2826
 
2827
+ /** The reconciler's plan actions for skill and command files (what `uds update --plan` would list). */
2828
+ async function commandActionsOf(projectPath) {
2829
+ const { plan } = await reconcilerPlan(projectPath, {});
2830
+ return plan.actions.filter((a) => a.category === 'command');
2831
+ }
2832
+
2833
+ async function skillActionsOf(projectPath) {
2834
+ const { plan } = await reconcilerPlan(projectPath, {});
2835
+ return plan.actions.filter((a) => a.category === 'skill');
2836
+ }
2837
+
2777
2838
  async function updateSkillsOnly(projectPath, manifest, options) {
2778
2839
  const msg = t().commands.update;
2779
2840
  const repoInfo = getRepositoryInfo();
@@ -2819,7 +2880,19 @@ async function updateSkillsOnly(projectPath, manifest, options) {
2819
2880
  return Boolean(config?.supportsSkills && config?.skills);
2820
2881
  });
2821
2882
  const agents = detectedSkillsTools.length > 0 ? detectedSkillsTools : ['claude-code'];
2822
- for (const agent of agents) skillsInstallations.push({ agent, level: legacyLocation });
2883
+ // XSPEC-486 R2: a tool with no folder at the recorded level (antigravity has no user-level one) is not given
2884
+ // an installation that has nowhere to go.
2885
+ // …and the run says so, as `init` and `config` do (beta.15 Windows retest, Issue 1: this path was silent).
2886
+ for (const agent of agents) {
2887
+ if (hasSkillsLevel(agent, legacyLocation)) {
2888
+ skillsInstallations.push({ agent, level: legacyLocation });
2889
+ } else {
2890
+ console.log(chalk.yellow(
2891
+ `⚠ ${getAgentDisplayName(agent) || agent}: ` +
2892
+ `${msg.skillsNoUserPath || 'has no user-level skills folder (only the project one), so this update left it out. To put its skills into this project instead: uds config --type skills --ai-tool antigravity --skills-location project'}`
2893
+ ));
2894
+ }
2895
+ }
2823
2896
  } else if (legacyLocation === 'marketplace') {
2824
2897
  console.log(chalk.yellow(msg.skillsViaMarketplace || 'Skills installed via Marketplace'));
2825
2898
  console.log(chalk.gray(` ${msg.updateViaMarketplace || 'Update through Plugin Marketplace'}`));
@@ -2892,7 +2965,7 @@ async function updateSkillsOnly(projectPath, manifest, options) {
2892
2965
  // Build location summary
2893
2966
  const locations = fileBasedInstallations.map(inst => {
2894
2967
  const displayName = getAgentDisplayName(inst.agent);
2895
- const dir = getSkillsDirForAgent(inst.agent, inst.level, projectPath);
2968
+ const dir = getSkillsDirForAgent(inst.agent, inst.level, projectPath) ?? '(no such folder)'; // XSPEC-486
2896
2969
  return `${displayName}: ${dir}`;
2897
2970
  }).join(', ');
2898
2971
 
@@ -3366,7 +3439,7 @@ async function promptNewFeatureInstallation(missingSkills, outdatedSkills, missi
3366
3439
  console.log(chalk.yellow(msg.skillsOutdatedFor || 'Skills updates available for these AI tools:'));
3367
3440
  for (const skill of outdatedSkills) {
3368
3441
  const levelLabel = skill.level === 'user' ? 'user' : 'project';
3369
- const pathDisplay = skill.path || getSkillsDirForAgent(skill.agent, skill.level);
3442
+ const pathDisplay = skill.path || getSkillsDirForAgent(skill.agent, skill.level) || '(no such folder)';
3370
3443
  console.log(chalk.gray(` • ${skill.displayName} (${levelLabel}: ${pathDisplay})`));
3371
3444
  console.log(chalk.gray(` ${skill.currentVersion} → ${skill.latestVersion}`));
3372
3445
  }
@@ -3375,7 +3448,7 @@ async function promptNewFeatureInstallation(missingSkills, outdatedSkills, missi
3375
3448
  // Build checkbox choices with path info
3376
3449
  const updateChoices = outdatedSkills.map(skill => {
3377
3450
  const levelLabel = skill.level === 'user' ? 'user' : 'project';
3378
- const pathDisplay = skill.path || getSkillsDirForAgent(skill.agent, skill.level);
3451
+ const pathDisplay = skill.path || getSkillsDirForAgent(skill.agent, skill.level) || '(no such folder)';
3379
3452
  return {
3380
3453
  name: `${skill.displayName} ${chalk.gray(`(${levelLabel}: ${pathDisplay}) ${skill.currentVersion} → ${skill.latestVersion}`)}`,
3381
3454
  value: skill.agent,
@@ -3511,14 +3584,14 @@ function takeStepBackup(projectPath, label, installations, kind) {
3511
3584
  console.log();
3512
3585
  return { ok: false };
3513
3586
  }
3514
- cleanupBackupsQuietly(projectPath);
3515
- return { ok: true, backupId: backup.backupId };
3587
+ return { ok: true, backupId: backup.backupId, cleanup: cleanupBackupsQuietly(projectPath) };
3516
3588
  }
3517
3589
 
3518
3590
  /** The step is over (its last manifest write is done): record what it created, and say how to undo it. */
3519
3591
  function finishStepBackup(projectPath, backup) {
3520
3592
  finalizeBackup(projectPath, backup.backupId);
3521
3593
  printBackupLocation(backup.backupId);
3594
+ printBackupCleanup(backup.cleanup);
3522
3595
  }
3523
3596
 
3524
3597
  /**
@@ -3534,9 +3607,34 @@ function printBackupLocation(backupId) {
3534
3607
 
3535
3608
  function cleanupBackupsQuietly(projectPath) {
3536
3609
  try {
3537
- cleanupBackups(projectPath);
3610
+ return cleanupBackups(projectPath);
3538
3611
  } catch {
3539
3612
  // an old backup that cannot be removed is not a reason to stop the update
3613
+ return null;
3614
+ }
3615
+ }
3616
+
3617
+ /**
3618
+ * Say what the backup limit did (XSPEC-475 R2). A backup is the adopter's data: one deleted without a word
3619
+ * is how an adopter loses the only copy of something version control cannot give back.
3620
+ * - every backup removed because `.uds-backups/` holds more than the limit is named;
3621
+ * - backups an older UDS left in the project root (`.uds-backup-*`) are never removed by the limit; they
3622
+ * are listed here with a suggestion to move them out themselves.
3623
+ * // implements XSPEC-475 R2
3624
+ */
3625
+ function printBackupCleanup(cleanup) {
3626
+ if (!cleanup) return;
3627
+ const removed = cleanup.removed || [];
3628
+ const legacy = cleanup.legacyKept || [];
3629
+ if (removed.length > 0) {
3630
+ console.log(chalk.yellow(` Removed ${removed.length} old backup(s) beyond the limit of ${cleanup.keep} in .uds-backups/:`));
3631
+ for (const id of removed) console.log(chalk.yellow(` ✕ ${id}`));
3632
+ }
3633
+ for (const err of cleanup.errors || []) console.log(chalk.red(` ${err}`));
3634
+ if (legacy.length > 0) {
3635
+ console.log(chalk.yellow(` ${legacy.length} backup(s) from an older UDS are still in the project root and were NOT removed by the limit:`));
3636
+ for (const id of legacy) console.log(chalk.yellow(` - ${id}`));
3637
+ console.log(chalk.gray(' UDS never deletes these. If you need them, move them out of the project yourself (for example, to a folder outside the repository).'));
3540
3638
  }
3541
3639
  }
3542
3640
 
@@ -3551,20 +3649,37 @@ function printPaths(prefix, paths, limit, colour) {
3551
3649
  * updates, then say, item by item, what was restored, what was removed, and what was NOT put back.
3552
3650
  * It never ends in "successful" while any of those lists is not empty (XSPEC-454 R1).
3553
3651
  */
3554
- async function handleRollback(projectPath) {
3652
+ async function handleRollback(projectPath, options = {}) {
3555
3653
  const backups = listBackups(projectPath);
3556
3654
  if (backups.length === 0) {
3557
3655
  console.log(chalk.yellow('No backups found. Nothing to rollback.'));
3558
3656
  console.log();
3657
+ if (options.from) process.exitCode = 1;
3559
3658
  return;
3560
3659
  }
3561
3660
 
3562
- const latest = backups[0];
3661
+ // XSPEC-482 R11: `--from` names the one backup to restore. The default picks the newest series, and a backup an older
3662
+ // UDS made is never in it (it records no manifest hash to chain on), so without this there was no way to reach it.
3663
+ let chosen = null;
3664
+ if (options.from) {
3665
+ const wanted = String(options.from).replace(/\\/g, '/').replace(/\/+$/, '');
3666
+ const leaf = (id) => id.slice(id.lastIndexOf('/') + 1);
3667
+ chosen = backups.find((b) => b.backupId === wanted) || backups.find((b) => leaf(b.backupId) === leaf(wanted));
3668
+ if (!chosen) {
3669
+ console.log(chalk.red(`No backup named "${options.from}". Backups in this project:`));
3670
+ for (const b of backups) console.log(chalk.gray(` ${b.backupId} (${b.createdAt || 'no date'})`));
3671
+ console.log();
3672
+ process.exitCode = 1;
3673
+ return;
3674
+ }
3675
+ }
3676
+
3677
+ const latest = chosen || backups[0];
3563
3678
  console.log(chalk.cyan(`Rolling back from: ${latest.backupId}`));
3564
3679
  console.log(chalk.gray(` Created: ${latest.createdAt}`));
3565
3680
  console.log();
3566
3681
 
3567
- const result = rollbackLast(projectPath);
3682
+ const result = rollbackLast(projectPath, chosen ? chosen.backupId : undefined);
3568
3683
 
3569
3684
  for (const step of result.steps || []) {
3570
3685
  console.log(chalk.cyan(`${step.backupId}${step.label ? ` (${step.label})` : ''}`));
@@ -3582,7 +3697,16 @@ async function handleRollback(projectPath) {
3582
3697
  console.log(chalk.gray(` ${result.steps.length} consecutive updates were undone together (each one started from where the previous one ended).`));
3583
3698
  }
3584
3699
  if (result.olderBackups > 0) {
3585
- console.log(chalk.gray(` ${result.olderBackups} older backup(s) are not part of that series (something else changed the project in between) and were left alone.`));
3700
+ // Say the true reason. A backup an older UDS made records no manifest hash, so there is nothing to tell whether it
3701
+ // continues the series; one that does carry the hash and still does not match means something else changed the project.
3702
+ const inSeries = (result.steps || []).length;
3703
+ const next = backups[inSeries];
3704
+ const why = next && !next.postManifestHash
3705
+ ? 'it was made by an older UDS, which did not record what links one backup to the next, so it cannot be joined to the series'
3706
+ : 'something else changed the project after it was made';
3707
+ console.log(chalk.gray(` ${result.olderBackups} older backup(s) are not part of that series (${why}) and were left alone.`));
3708
+ console.log(chalk.gray(' To restore one of them on its own: `uds update --rollback --from <backup>`. They are:'));
3709
+ for (const b of backups.slice(inSeries)) console.log(chalk.gray(` ${b.backupId} (${b.createdAt || 'no date'})`)); // wire:rollback-names-older-backups
3586
3710
  }
3587
3711
 
3588
3712
  if (result.errors.length > 0) {
@@ -3677,8 +3801,24 @@ async function handleReconcile(projectPath, options, { force, addStandards = []
3677
3801
  // XSPEC-454 R2: nothing to apply, but the manifest may still list skill files UDS never installed
3678
3802
  // (they only ever get corrected by a write, and an up-to-date project has none coming).
3679
3803
  const current = readManifest(projectPath);
3680
- if (current && (pruneForeignSkillHashes(current).length + pruneForeignCommandHashes(current).length) > 0) writeManifest(current, projectPath);
3804
+ // XSPEC-475 R6: nothing to apply means the files are what this UDS ships; the recorded versions say so too.
3805
+ let aligned = current ? alignRecordedVersions(current).changed : false; // wire:up-to-date-aligns-versions
3806
+ // XSPEC-482 R6: the same for the standards version, which only an executed plan used to record.
3807
+ if (current && alignUpstreamVersion(current).changed) aligned = true; // wire:up-to-date-aligns-upstream
3808
+ // XSPEC-456 R4 (kept through XSPEC-482 R6): the NAME lists are corrected here too. This early return used to be reached only by
3809
+ // a project that had nothing else to rewrite, which a fresh `uds init` almost never was; once init leaves the project current
3810
+ // it is the normal case, and the names UDS cannot vouch for (`_shared`, a retired skill) stayed in the manifest for good.
3811
+ // Ownership test only, as the reconciler does (no disk test).
3812
+ let droppedNames = 0;
3813
+ if (current) {
3814
+ const before = (current.skills?.names?.length || 0) + (current.commands?.names?.length || 0);
3815
+ pruneForeignSkillNames(current, '');
3816
+ pruneForeignCommandNames(current, '');
3817
+ droppedNames = before - ((current.skills?.names?.length || 0) + (current.commands?.names?.length || 0)); // wire:up-to-date-prunes-names
3818
+ }
3819
+ if (current && ((pruneForeignSkillHashes(current).length + pruneForeignCommandHashes(current).length) > 0 || aligned || droppedNames > 0)) writeManifest(current, projectPath);
3681
3820
  console.log(chalk.green('Everything is up to date. No changes needed.'));
3821
+ if (droppedNames > 0) console.log(chalk.gray(` ${t().commands.update.droppedForeignNames.replace('{count}', droppedNames)}`));
3682
3822
  // XSPEC-458 R2: "up to date" is about the files UDS manages; say what UDS ships that is not managed here.
3683
3823
  printAvailableStandardsSection(planResult.manifest, { phase: 'apply' });
3684
3824
  console.log();
@@ -3721,6 +3861,7 @@ async function handleReconcile(projectPath, options, { force, addStandards = []
3721
3861
 
3722
3862
  if (result.execution?.backupId) {
3723
3863
  printBackupLocation(result.execution.backupId);
3864
+ printBackupCleanup(result.execution.backupCleanup);
3724
3865
  }
3725
3866
 
3726
3867
  if (result.errors.length > 0) {
@@ -3731,6 +3872,18 @@ async function handleReconcile(projectPath, options, { force, addStandards = []
3731
3872
  }
3732
3873
  }
3733
3874
 
3875
+ if (!result.success) {
3876
+ // XSPEC-482 R10: say what a partly failed run left behind and the way to finish it.
3877
+ console.log();
3878
+ console.log(chalk.yellow(
3879
+ 'Not everything was applied. The overall version record did not advance, and a skills or commands batch that failed keeps its ' +
3880
+ 'old version record; a batch that succeeded has already recorded its new version. ' +
3881
+ 'Fix the cause, then run `uds update --apply` again: it completes what is left.'
3882
+ ));
3883
+ // XSPEC-482 R2: a failed action is a failed run. CI and scripts read the exit code, not the colour of a line.
3884
+ process.exitCode = 1; // wire:apply-fails-exit-1
3885
+ }
3886
+
3734
3887
  // XSPEC-458 R2: the count of what UDS ships and this project lacks, with the command that installs one.
3735
3888
  printAvailableStandardsSection(result.manifest || planResult.manifest, { phase: 'apply' });
3736
3889
  console.log();
@@ -8,6 +8,7 @@
8
8
  */
9
9
 
10
10
  import { BaseCompiler } from './base-compiler.js';
11
+ import { normalizeMatcher } from '../installers/hooks-installer.js';
11
12
 
12
13
  const DEFAULT_MATCHERS = {
13
14
  UserPromptSubmit: '',
@@ -27,7 +28,14 @@ export class ClaudeCodeCompiler extends BaseCompiler {
27
28
 
28
29
  for (const std of enforceable) {
29
30
  const { hook_script, trigger } = std.enforcement;
30
- const matcher = std.enforcement.matcher ?? DEFAULT_MATCHERS[trigger] ?? '';
31
+ // Claude Code's matcher is a string (https://code.claude.com/docs/en/hooks, "Matcher patterns"). A standard may
32
+ // declare it as an object (`matcher: { tool: Write, path: "src/**/*.ts" }`); that used to be written to
33
+ // settings.json as the object, which the documented format has no place for (XSPEC-482 R4). Same reduction
34
+ // `uds init --with-hooks` and `uds update --with-hooks` apply, so the three write one format.
35
+ const declared = std.enforcement.matcher;
36
+ const matcher = declared === undefined || declared === null
37
+ ? (DEFAULT_MATCHERS[trigger] ?? '')
38
+ : normalizeMatcher(declared); // wire:compile-matcher-is-a-string
31
39
 
32
40
  if (!hooks[trigger]) {
33
41
  hooks[trigger] = [];
@@ -354,13 +354,26 @@ export function getSkillsDirForAgent(agent, level = 'user', projectPath = null)
354
354
  if (!config || !config.skills) return null;
355
355
 
356
356
  if (level === 'user') {
357
- return config.skills.user;
357
+ // A tool can have no user-level folder (antigravity, on purpose). `null`, never `undefined`: every caller
358
+ // already treats a falsy answer as "no such place" (XSPEC-486 R2).
359
+ return config.skills.user || null; // wire:skills-dir-user-null-not-undefined
358
360
  } else if (level === 'project' && projectPath) {
359
361
  return join(projectPath, config.skills.project);
360
362
  }
361
363
  return null;
362
364
  }
363
365
 
366
+ /**
367
+ * Does the agent have a skills folder at this level? A tool may have only a project folder (antigravity: agy
368
+ * knows one skills location, the workspace) - then no user-level skills can be listed, installed or removed.
369
+ * @param {string} agent - Agent identifier
370
+ * @param {string} level - 'user' or 'project'
371
+ * @returns {boolean}
372
+ */
373
+ export function hasSkillsLevel(agent, level) {
374
+ return Boolean(AI_AGENT_PATHS[agent]?.skills?.[level]);
375
+ }
376
+
364
377
  /**
365
378
  * Get commands directory path for an agent
366
379
  * @param {string} agent - Agent identifier
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Which file formats a manifest's `format` setting puts on disk.
3
+ *
4
+ * `both` is not a third kind of file: it is the human copy (.md) and the AI copy (.ai.yaml) of every standard and
5
+ * every option, side by side. The installer copies once per entry of this list, and the reconciler has to expect
6
+ * exactly the same set. When the reconciler read `both` as one format it resolved only the human copy and planned
7
+ * to delete every AI copy the installer had just written (XSPEC-483).
8
+ *
9
+ * @param {string} [format] - 'ai', 'human' or 'both'. Anything else, including a missing value, is read as 'ai'.
10
+ * @returns {string[]} The formats to resolve a source file in: ['ai', 'human'] for 'both', otherwise one entry.
11
+ */
12
+ export function getInstalledFormats(format) {
13
+ if (format === 'both') return ['ai', 'human'];
14
+ return [format || 'ai'];
15
+ }
@@ -11,6 +11,10 @@
11
11
  * - 待辦
12
12
  * command_words: # extra program names read as a command in a next action or a draft
13
13
  * - kubectl
14
+ * asked_at_words: # extra words that head the "when was it asked" column (XSPEC-475 R3)
15
+ * - 何時問
16
+ * waiting_for_words: # extra words that head the "what is it waiting for" column (XSPEC-475 R3)
17
+ * - 問什麼
14
18
  *
15
19
  * This file holds no rule. It turns the section into the same `--root NAME=DIR` and
16
20
  * `--next-action-word WORD` arguments a person could type, and hands them to the checker, which
@@ -36,7 +40,7 @@ import { PROJECT_NAME } from '../utils/open-work-tracking.mjs';
36
40
  * `error`: the file is readable and its open_work section is wrong (the command stops with exit 2).
37
41
  */
38
42
  export function readOpenWorkDeclarations(cwd = process.cwd()) {
39
- const out = { projects: {}, nextActionWords: [], commandWords: [], note: null, error: null };
43
+ const out = { projects: {}, nextActionWords: [], commandWords: [], askedAtWords: [], waitingForWords: [], note: null, error: null };
40
44
  let config;
41
45
  try {
42
46
  config = loadProjectConfig(cwd);
@@ -71,6 +75,14 @@ export function readOpenWorkDeclarations(cwd = process.cwd()) {
71
75
  out.commandWords.push(w);
72
76
  }
73
77
  }
78
+ for (const [key, into] of [['asked_at_words', out.askedAtWords], ['waiting_for_words', out.waitingForWords]]) {
79
+ if (section[key] === undefined || section[key] === null) continue;
80
+ if (!Array.isArray(section[key])) return bad(`.${key} must be a list of words`);
81
+ for (const w of section[key]) {
82
+ if (typeof w !== 'string') return bad(`.${key} must hold text only; write each word as plain text`);
83
+ into.push(w);
84
+ }
85
+ }
74
86
  return out;
75
87
  }
76
88
 
@@ -101,3 +113,10 @@ export function wordArguments(cliWords, declaredWords = []) {
101
113
  for (const w of [].concat(cliWords ?? [], declaredWords)) argv.push('--next-action-word', w);
102
114
  return argv;
103
115
  }
116
+
117
+ /** The `--asked-at-word` or `--waiting-for-word` arguments (XSPEC-475 R3): the command line's words, then the file's. */
118
+ export function fieldWordArguments(flag, cliWords, declaredWords = []) {
119
+ const argv = [];
120
+ for (const w of [].concat(cliWords ?? [], declaredWords)) argv.push(flag, w);
121
+ return argv;
122
+ }
@@ -98,6 +98,61 @@ function validateConfig(config, filePath) {
98
98
  }
99
99
  }
100
100
 
101
+ /**
102
+ * True when `text` ends inside an open quote, reading it the way a shell does: a `'` inside `"..."` (and a `"` inside
103
+ * `'...'`) is plain text, and a backslash escapes the next character outside single quotes.
104
+ */
105
+ function endsInsideQuote(text) {
106
+ let open = null;
107
+ for (let i = 0; i < text.length; i++) {
108
+ const ch = text[i];
109
+ if (open === null) {
110
+ if (ch === '\\') i++;
111
+ else if (ch === '"' || ch === "'") open = ch;
112
+ } else if (open === '"' && ch === '\\') {
113
+ i++;
114
+ } else if (ch === open) {
115
+ open = null;
116
+ }
117
+ }
118
+ return open !== null;
119
+ }
120
+
121
+ /**
122
+ * The 1-based line of uds.project.yaml whose command YAML cut short in the middle of a quote, or null. XSPEC-475 R5(c).
123
+ *
124
+ * YAML ends an unquoted value at a space followed by `#`. `build: node -p "'quoted # kept'"` therefore becomes
125
+ * `node -p "'quoted`: the shell would have kept the `#`, YAML does not, and what is left has an unclosed quote - a command
126
+ * that cannot be what the author meant. A genuine trailing comment (`test: dotnet test X.csproj # 90 tests pass`) leaves a
127
+ * complete command and is the supported way to comment, so it is NOT reported. Only the cut-short case is, and the text YAML
128
+ * dropped is not repeated (it may be a comment the person wants kept out of the output).
129
+ *
130
+ * Only a plain (unquoted) scalar on one line is looked at, and only when the value YAML produced is exactly the text
131
+ * before the `#` - so a line this cannot match up with the parsed value is never reported.
132
+ * @param {string} projectPath
133
+ * @param {string} intent
134
+ * @param {string} command - the value YAML produced for `intent`
135
+ * @returns {number|null}
136
+ */
137
+ export function truncatedYamlValueLine(projectPath, intent, command) {
138
+ const configPath = join(projectPath, CONFIG_FILENAME);
139
+ if (!existsSync(configPath)) return null;
140
+ const escaped = intent.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
141
+ const line = new RegExp(`^[ \\t]+${escaped}[ \\t]*:[ \\t]+(.*)$`);
142
+ const lines = readFileSync(configPath, 'utf8').split(/\r?\n/);
143
+ for (let n = 0; n < lines.length; n++) {
144
+ const m = line.exec(lines[n]);
145
+ if (!m) continue;
146
+ const value = m[1].trim();
147
+ if (/^["'|>[{&*!]/.test(value)) continue; // quoted, block, flow or anchored: not a plain scalar
148
+ const at = value.search(/\s#/);
149
+ if (at < 0) continue;
150
+ if (value.slice(0, at).trim() !== command) continue; // not the line YAML read this value from
151
+ return endsInsideQuote(command) ? n + 1 : null; // [mutation-anchor:cut-inside-quote]
152
+ }
153
+ return null;
154
+ }
155
+
101
156
  /**
102
157
  * Get a specific command intent from config.
103
158
  * Returns undefined if not configured.