universal-dev-standards 6.14.0-beta.9 → 6.14.1-beta.1

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 (721) 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/mock-boundary.ai.yaml +138 -2
  5. package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
  6. package/bundled/ai/standards/turn-completion-integrity.ai.yaml +6 -2
  7. package/bundled/core/commit-message-guide.md +22 -19
  8. package/bundled/core/mock-boundary.md +70 -2
  9. package/bundled/core/secret-management-standards.md +13 -1
  10. package/bundled/core/turn-completion-integrity.md +8 -2
  11. package/bundled/extensions/locales/zh-tw.md +19 -19
  12. package/bundled/hooks/check-dangerous-cmd.mjs +161 -26
  13. package/bundled/hooks/check-logging-standard.mjs +35 -6
  14. package/bundled/hooks/validate-commit-msg.mjs +317 -28
  15. package/bundled/locales/zh-CN/CHANGELOG.md +2323 -1099
  16. package/bundled/locales/zh-CN/CLAUDE.md +987 -101
  17. package/bundled/locales/zh-CN/README.md +3 -3
  18. package/bundled/locales/zh-CN/SECURITY.md +4 -3
  19. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  20. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
  21. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  22. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
  23. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
  24. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
  25. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
  26. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  27. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  28. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  29. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  30. package/bundled/locales/zh-CN/core/accessibility-standards.md +871 -62
  31. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  32. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  33. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  34. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  35. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  36. package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +311 -72
  37. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  38. package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
  39. package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
  40. package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
  41. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  42. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  43. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  44. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  45. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  46. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  47. package/bundled/locales/zh-CN/core/changelog-standards.md +485 -63
  48. package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
  49. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  50. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  51. package/bundled/locales/zh-CN/core/code-review-checklist.md +37 -23
  52. package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
  53. package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
  54. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  55. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  56. package/bundled/locales/zh-CN/core/deprecation-standards.md +155 -40
  57. package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
  58. package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
  59. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  60. package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
  61. package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
  62. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  63. package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
  64. package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
  65. package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
  66. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  67. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  68. package/bundled/locales/zh-CN/core/feature-flag-standards.md +202 -57
  69. package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
  70. package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
  71. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  72. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  73. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  74. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  75. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  76. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  77. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  78. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  79. package/bundled/locales/zh-CN/core/mock-boundary.md +74 -6
  80. package/bundled/locales/zh-CN/core/mutation-testing.md +45 -6
  81. package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
  82. package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
  83. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  84. package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
  85. package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
  86. package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
  87. package/bundled/locales/zh-CN/core/project-structure.md +550 -170
  88. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  89. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  90. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  91. package/bundled/locales/zh-CN/core/retrospective-standards.md +215 -22
  92. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  93. package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
  94. package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
  95. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  96. package/bundled/locales/zh-CN/core/security-standards.md +169 -16
  97. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  98. package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
  99. package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
  100. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  101. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  102. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  103. package/bundled/locales/zh-CN/core/supply-chain-security-standards.md +159 -32
  104. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  105. package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
  106. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  107. package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
  108. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  109. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  110. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  111. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  112. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  113. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  114. package/bundled/locales/zh-CN/core/turn-completion-integrity.md +8 -6
  115. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  116. package/bundled/locales/zh-CN/core/versioning.md +737 -73
  117. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  118. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  119. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  120. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +2 -1
  121. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  122. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
  123. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
  124. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  125. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
  126. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  127. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
  128. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  129. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  130. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +2 -0
  131. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  132. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  133. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  134. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  135. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  136. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  137. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  138. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  139. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  140. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  141. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  142. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  143. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  144. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  145. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  146. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  147. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  148. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  149. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  150. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  151. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  152. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  153. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  154. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  155. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  156. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  157. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  158. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  159. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  160. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  161. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  162. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  163. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  164. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  165. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  166. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  167. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  168. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  169. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  170. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  171. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  172. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  173. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  174. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  175. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  176. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  177. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  178. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  179. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  180. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  181. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  182. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  183. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  184. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  185. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  186. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  187. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  188. package/bundled/locales/zh-CN/skills/README.md +2 -1
  189. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  190. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  191. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  192. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  193. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  194. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  195. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  196. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  197. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  198. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  199. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  200. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  201. package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +217 -137
  202. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  203. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  204. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  205. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  206. package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +148 -132
  207. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  208. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  209. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  210. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  211. package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +122 -121
  212. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  213. package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
  214. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  215. package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
  216. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  217. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  218. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  219. package/bundled/locales/zh-CN/skills/code-review-assistant/guide.md +119 -45
  220. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  221. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  222. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  223. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  224. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  225. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  226. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  227. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  228. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  229. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  230. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  231. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  232. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  233. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  234. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  235. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  236. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  237. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  238. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  239. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  240. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  241. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  242. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  243. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  244. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  245. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  246. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  247. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  248. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  249. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  250. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  251. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  252. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  253. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  254. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  255. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  256. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  257. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  258. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  259. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  260. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  261. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  262. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  263. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  264. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  265. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  266. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  267. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  268. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  269. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +4 -4
  270. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  271. package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
  272. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  273. package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
  274. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  275. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  276. package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +4 -2
  277. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  278. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  279. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  280. package/bundled/locales/zh-CN/skills/docs-generator/guide.md +8 -7
  281. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  282. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  283. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  284. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  285. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  286. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  287. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  288. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  289. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  290. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  291. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  292. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  293. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  294. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  295. package/bundled/locales/zh-CN/skills/project-discovery/guide.md +158 -157
  296. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  297. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  298. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  299. package/bundled/locales/zh-CN/skills/refactoring-assistant/guide.md +172 -171
  300. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  301. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  302. package/bundled/locales/zh-CN/skills/release-standards/guide.md +51 -43
  303. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  304. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  305. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  306. package/bundled/locales/zh-CN/skills/requirement-assistant/guide.md +88 -79
  307. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  308. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  309. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  310. package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +2 -2
  311. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  312. package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
  313. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  314. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  315. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  316. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  317. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  318. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  319. package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +2 -2
  320. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  321. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  322. package/bundled/locales/zh-CN/skills/tdd-assistant/guide.md +217 -156
  323. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  324. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  325. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  326. package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +25 -12
  327. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  328. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  329. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  330. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  331. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  332. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  333. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  334. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  335. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  336. package/bundled/locales/zh-TW/CHANGELOG.md +2323 -1128
  337. package/bundled/locales/zh-TW/CLAUDE.md +962 -76
  338. package/bundled/locales/zh-TW/README.md +3 -3
  339. package/bundled/locales/zh-TW/SECURITY.md +4 -3
  340. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  341. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
  342. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  343. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
  344. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
  345. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
  346. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
  347. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  348. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  349. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  350. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  351. package/bundled/locales/zh-TW/core/accessibility-standards.md +895 -46
  352. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  353. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  354. package/bundled/locales/zh-TW/core/agent-dispatch.md +102 -33
  355. package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
  356. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  357. package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
  358. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  359. package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
  360. package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
  361. package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
  362. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  363. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  364. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  365. package/bundled/locales/zh-TW/core/branch-completion.md +130 -34
  366. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  367. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  368. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  369. package/bundled/locales/zh-TW/core/chaos-engineering-standards.md +138 -36
  370. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  371. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  372. package/bundled/locales/zh-TW/core/code-review-checklist.md +19 -7
  373. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  374. package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
  375. package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
  376. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  377. package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
  378. package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
  379. package/bundled/locales/zh-TW/core/developer-memory.md +102 -12
  380. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  381. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  382. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  383. package/bundled/locales/zh-TW/core/environment-standards.md +250 -72
  384. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  385. package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
  386. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  387. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  388. package/bundled/locales/zh-TW/core/feature-flag-standards.md +202 -57
  389. package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
  390. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  391. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  392. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  393. package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +234 -487
  394. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  395. package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
  396. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  397. package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
  398. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  399. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  400. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  401. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  402. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  403. package/bundled/locales/zh-TW/core/mock-boundary.md +74 -6
  404. package/bundled/locales/zh-TW/core/observability-standards.md +284 -40
  405. package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
  406. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  407. package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
  408. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  409. package/bundled/locales/zh-TW/core/project-context-memory.md +210 -31
  410. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  411. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  412. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  413. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  414. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  415. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  416. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  417. package/bundled/locales/zh-TW/core/runbook-standards.md +296 -23
  418. package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
  419. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  420. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  421. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  422. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  423. package/bundled/locales/zh-TW/core/slo-standards.md +301 -49
  424. package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
  425. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  426. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  427. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  428. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  429. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  430. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  431. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  432. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  433. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  434. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  435. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  436. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  437. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  438. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  439. package/bundled/locales/zh-TW/core/turn-completion-integrity.md +8 -6
  440. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  441. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  442. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  443. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  444. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  445. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +2 -1
  446. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  447. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
  448. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  449. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
  450. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  451. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
  452. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  453. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
  454. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  455. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  456. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +2 -0
  457. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  458. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  459. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  460. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  461. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  462. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  463. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  464. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  465. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  466. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  467. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  468. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  469. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  470. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  471. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  472. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  473. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  474. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  475. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  476. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  477. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  478. package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +584 -475
  479. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  480. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  481. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  482. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  483. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  484. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  485. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  486. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  487. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  488. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  489. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  490. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  491. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  492. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  493. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  494. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  495. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  496. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  497. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  498. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  499. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  500. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  501. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  502. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  503. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  504. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  505. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  506. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  507. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  508. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  509. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  510. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  511. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  512. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  513. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  514. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  515. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  516. package/bundled/locales/zh-TW/skills/README.md +2 -1
  517. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  518. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  519. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  520. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  521. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  522. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  523. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  524. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  525. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  526. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  527. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  528. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  529. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  530. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  531. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  532. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  533. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  534. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  535. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  536. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  537. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  538. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  539. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  540. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  541. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  542. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  543. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  544. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  545. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  546. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  547. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  548. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  549. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  550. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  551. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  552. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  553. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  554. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  555. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  556. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  557. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  558. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  559. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  560. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  561. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  562. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  563. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  564. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  565. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  566. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  567. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  568. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  569. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  570. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  571. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  572. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  573. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  574. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  575. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  576. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  577. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  578. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  579. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  580. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  581. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  582. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  583. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  584. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  585. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  586. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  587. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  588. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  589. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  590. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  591. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  592. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  593. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  594. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  595. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  596. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  597. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  598. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  599. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  600. package/bundled/locales/zh-TW/skills/commit-standards/guide.md +137 -17
  601. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  602. package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
  603. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  604. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  605. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  606. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  607. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  608. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  609. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  610. package/bundled/locales/zh-TW/skills/docs-generator/guide.md +4 -3
  611. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  612. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  613. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  614. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  615. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  616. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  617. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  618. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  619. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  620. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  621. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  622. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  623. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  624. package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +85 -18
  625. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  626. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  627. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  628. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  629. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  630. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  631. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  632. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  633. package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +91 -45
  634. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  635. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  636. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  637. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  638. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  639. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  640. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  641. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  642. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  643. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  644. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  645. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  646. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  647. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  648. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  649. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  650. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  651. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  652. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  653. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  654. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  655. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  656. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  657. package/bundled/locales/zh-TW/skills/tdd-assistant/language-examples.md +693 -47
  658. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  659. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  660. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  661. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  662. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  663. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  664. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  665. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  666. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  667. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  668. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  669. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  670. package/bundled/skills/.claude-plugin/plugin.json +71 -0
  671. package/bundled/skills/commit-standards/SKILL.md +2 -2
  672. package/bundled/skills/commit-standards/guide.md +3 -2
  673. package/bundled/skills/commit-standards/language-options.md +19 -17
  674. package/package.json +2 -2
  675. package/src/commands/audit.js +28 -1
  676. package/src/commands/check.js +72 -3
  677. package/src/commands/compile.js +37 -4
  678. package/src/commands/config.js +49 -24
  679. package/src/commands/init.js +78 -30
  680. package/src/commands/open-work.js +6 -2
  681. package/src/commands/release-messages.js +228 -0
  682. package/src/commands/release.js +127 -68
  683. package/src/commands/run-intent.js +11 -0
  684. package/src/commands/spec.js +4 -2
  685. package/src/commands/update.js +227 -47
  686. package/src/compilers/claude-code-compiler.js +9 -1
  687. package/src/config/ai-agent-paths.js +14 -1
  688. package/src/core/installed-formats.js +15 -0
  689. package/src/core/open-work-config.js +20 -1
  690. package/src/core/project-config.js +55 -0
  691. package/src/i18n/messages.js +106 -2
  692. package/src/installers/hooks-installer.js +1 -1
  693. package/src/installers/manifest-installer.js +1 -1
  694. package/src/installers/skills-installer.js +1 -1
  695. package/src/installers/standards-installer.js +3 -1
  696. package/src/mcp/server.js +9 -3
  697. package/src/prompts/init.js +26 -22
  698. package/src/reconciler/actual-state-scanner.js +2 -8
  699. package/src/reconciler/backup-locations.js +5 -0
  700. package/src/reconciler/backup-manager.js +19 -11
  701. package/src/reconciler/desired-state-calculator.js +89 -57
  702. package/src/reconciler/plan-executor.js +101 -8
  703. package/src/reconciler/recorded-versions.js +49 -0
  704. package/src/reconciler/relative-path.js +23 -0
  705. package/src/uninstallers/hook-uninstaller.js +9 -1
  706. package/src/uninstallers/skills-uninstaller.js +22 -3
  707. package/src/utils/available-standards-report.js +25 -4
  708. package/src/utils/available-standards.js +13 -3
  709. package/src/utils/build-manifest.js +1 -1
  710. package/src/utils/commit-message-judge.js +60 -13
  711. package/src/utils/friction-detector.js +23 -11
  712. package/src/utils/git-hooks.js +106 -4
  713. package/src/utils/integration-generator.js +95 -67
  714. package/src/utils/legacy-hook-migration.js +121 -2
  715. package/src/utils/open-work-tracking.mjs +105 -16
  716. package/src/utils/sdd-header.js +16 -4
  717. package/src/utils/skills-installer.js +2 -1
  718. package/src/utils/spinner.js +14 -4
  719. package/src/utils/standard-validator.js +3 -2
  720. package/standards-registry.json +10 -8
  721. 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
 
@@ -544,20 +551,15 @@ export async function updateCommand(options) {
544
551
  return;
545
552
  }
546
553
  await handleReconcile(projectPath, options, { force: !!options.force, addStandards });
547
- // These exit the process on completion, so run Skills last.
548
- if (scopedToCommands) await updateCommandsOnly(projectPath, manifest, options);
549
- if (scopedToSkills) await updateSkillsOnly(projectPath, manifest, options);
554
+ // A single scope exits the process on completion; two are chained and exit once.
555
+ await runScopes(projectPath, manifest, options, { skills: scopedToSkills, commands: scopedToCommands });
550
556
  return;
551
557
  }
552
558
 
553
- // Scope without a mode: the original shortcuts.
554
- if (scopedToSkills) {
555
- await updateSkillsOnly(projectPath, manifest, options);
556
- return;
557
- }
558
-
559
- if (scopedToCommands) {
560
- await updateCommandsOnly(projectPath, manifest, options);
559
+ // Scope without a mode: the original shortcuts. Both flags mean both scopes —
560
+ // neither may be dropped for the other (the 6.14.0 bug).
561
+ if (scopedToSkills || scopedToCommands) {
562
+ await runScopes(projectPath, manifest, options, { skills: scopedToSkills, commands: scopedToCommands });
561
563
  return;
562
564
  }
563
565
 
@@ -1940,7 +1942,6 @@ export function migrateLegacyPreCommitHook(projectPath, manifest, { plan = false
1940
1942
  if (r.state === 'error') {
1941
1943
  console.log(chalk.yellow(` ${msg.hookMigrateFailed.replace('{error}', r.error)}`));
1942
1944
  console.log();
1943
- return r;
1944
1945
  }
1945
1946
  if (r.state === 'migrated') console.log(chalk.green(` ${msg.hookMigrated}`));
1946
1947
  if (r.state === 'would-migrate') console.log(chalk.cyan(` ${msg.hookWouldMigrate}`));
@@ -1954,6 +1955,30 @@ export function migrateLegacyPreCommitHook(projectPath, manifest, { plan = false
1954
1955
  // this the record persisted just above would be overwritten by the older copy.
1955
1956
  Object.assign(manifest, mergeRecorderInto(manifest, r.recorder));
1956
1957
  }
1958
+
1959
+ // XSPEC-482 R3 + R5: hooks that run the check and cannot stop a commit - the husky block that runs `check`
1960
+ // without `--ci`, and the native hook of 5.x .. 6.13.1 / the betas. Same treatment as above: only a text UDS
1961
+ // provably wrote is replaced, anything else is named and left alone, and --plan lists it.
1962
+ const huskyCi = migrateHuskyBlockWithoutCi(projectPath, { plan, manifest });
1963
+ if (huskyCi.state === 'error') console.log(chalk.yellow(` ${msg.hookMigrateFailed.replace('{error}', huskyCi.error)}`));
1964
+ if (huskyCi.state === 'migrated') console.log(chalk.green(` ${msg.hookHuskyCiMigrated}`)); // wire:update-migrates-husky-ci
1965
+ if (huskyCi.state === 'would-migrate') console.log(chalk.cyan(` ${msg.hookHuskyCiWouldMigrate}`));
1966
+
1967
+ const native = migrateOlderNativeHook(projectPath, { plan }); // wire:update-migrates-native-hook
1968
+ const nativeFrom = native.from === 'legacy-6.11' ? msg.hookNativeFromLegacy : msg.hookNativeFromWithoutCi;
1969
+ if (native.state === 'error') console.log(chalk.yellow(` ${msg.hookNativeFailed.replace('{error}', native.error)}`));
1970
+ if (native.state === 'migrated') console.log(chalk.green(` ${msg.hookNativeMigrated.replace('{from}', nativeFrom)}`));
1971
+ if (native.state === 'would-migrate') console.log(chalk.cyan(` ${msg.hookNativeWouldMigrate.replace('{from}', nativeFrom)}`));
1972
+ for (const k of native.kept) {
1973
+ console.log(chalk.yellow(` ${msg.hookNativeKept.replace('{line}', k.line).replace('{text}', k.text)}`));
1974
+ }
1975
+ if (huskyCi.state !== 'none' || native.state !== 'none') console.log();
1976
+ for (const extra of [huskyCi.recorder, native.recorder]) {
1977
+ if (extra) {
1978
+ persistRecorder(projectPath, extra);
1979
+ Object.assign(manifest, mergeRecorderInto(manifest, extra));
1980
+ }
1981
+ }
1957
1982
  return r;
1958
1983
  }
1959
1984
 
@@ -2724,13 +2749,21 @@ async function planSkills(projectPath, manifest, options) {
2724
2749
  return;
2725
2750
  }
2726
2751
 
2752
+ // XSPEC-482 R7: "unchanged" needs the files to agree too, as `uds update --plan` judges them - a recorded version
2753
+ // equal to the shipped one says nothing about a skill file that was deleted or edited.
2754
+ const skillActions = await skillActionsOf(projectPath);
2755
+
2727
2756
  let changed = 0;
2728
2757
  for (const inst of installations) {
2729
2758
  const info = getInstalledSkillsInfoForAgent(inst.agent, inst.level, projectPath);
2730
2759
  const current = info?.version || 'unknown';
2731
- const dir = getSkillsDirForAgent(inst.agent, inst.level, projectPath);
2732
- if (current === latestVersion) {
2760
+ const dir = getSkillsDirForAgent(inst.agent, inst.level, projectPath) ?? '(no such folder)'; // XSPEC-486: null when the tool has no folder at that level
2761
+ const differing = skillActions.filter((a) => a.details?.metadata?.agent === inst.agent && (a.details?.metadata?.level || 'project') === inst.level);
2762
+ if (current === latestVersion && differing.length === 0) {
2733
2763
  console.log(chalk.gray(` = ${getAgentDisplayName(inst.agent)} (${inst.level}): v${current} — unchanged`));
2764
+ } else if (current === latestVersion) {
2765
+ changed++;
2766
+ console.log(chalk.yellow(` ~ ${getAgentDisplayName(inst.agent)} (${inst.level}): v${current} — ${differing.length} skill file(s) differ from what this UDS ships ${dir}`));
2734
2767
  } else {
2735
2768
  changed++;
2736
2769
  console.log(chalk.yellow(` ~ ${getAgentDisplayName(inst.agent)} (${inst.level}): v${current} → v${latestVersion} ${dir}`));
@@ -2759,22 +2792,83 @@ async function planCommands(projectPath, manifest, options) {
2759
2792
  return;
2760
2793
  }
2761
2794
 
2795
+ // XSPEC-482 R7: ask the reconciler, the same question `uds update --plan` answers, instead of saying "would be
2796
+ // reinstalled" for every installation whatever is on disk. A project that is current used to get "51 command(s)
2797
+ // would be reinstalled" here, "unchanged" from `--plan --skills` and "No changes" from `--plan`.
2798
+ const actions = await commandActionsOf(projectPath);
2799
+
2800
+ let changed = 0;
2762
2801
  for (const inst of installations) {
2763
2802
  const agent = typeof inst === 'string' ? inst : inst.agent;
2764
2803
  const level = typeof inst === 'string' ? 'project' : (inst.level || 'project');
2765
2804
  const info = getInstalledCommandsForAgent(agent, level, projectPath);
2766
2805
  const dir = getCommandsDirForAgent(agent, level, projectPath);
2767
- console.log(chalk.yellow(` ~ ${getAgentDisplayName(agent)} (${level}): ${info?.count || 0} command(s) would be reinstalled ${dir}`));
2806
+ const differing = actions.filter((a) => a.details?.metadata?.agent === agent && (a.details?.metadata?.level || 'project') === level);
2807
+ if (differing.length === 0) {
2808
+ console.log(chalk.gray(` = ${getAgentDisplayName(agent)} (${level}): ${info?.count || 0} command(s) — unchanged`));
2809
+ } else {
2810
+ changed++;
2811
+ console.log(chalk.yellow(` ~ ${getAgentDisplayName(agent)} (${level}): ${differing.length} command file(s) would be written or removed ${dir}`)); // wire:plan-commands-asks-reconciler
2812
+ }
2768
2813
  }
2769
2814
 
2770
2815
  console.log();
2771
- console.log(`Summary: ${installations.length} installation(s) would be reinstalled.`);
2816
+ console.log(`Summary: ${changed} installation(s) would be reinstalled, ${installations.length - changed} unchanged.`);
2772
2817
  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.'));
2818
+ if (changed > 0) console.log(chalk.gray(' Run `uds update --apply --yes --commands` to apply.'));
2774
2819
  console.log();
2775
2820
  }
2776
2821
 
2777
- async function updateSkillsOnly(projectPath, manifest, options) {
2822
+ /** The reconciler's plan actions for skill and command files (what `uds update --plan` would list). */
2823
+ async function commandActionsOf(projectPath) {
2824
+ const { plan } = await reconcilerPlan(projectPath, {});
2825
+ return plan.actions.filter((a) => a.category === 'command');
2826
+ }
2827
+
2828
+ async function skillActionsOf(projectPath) {
2829
+ const { plan } = await reconcilerPlan(projectPath, {});
2830
+ return plan.actions.filter((a) => a.category === 'skill');
2831
+ }
2832
+
2833
+ /**
2834
+ * How one scope step (Skills or commands) ends.
2835
+ *
2836
+ * Alone, it ends the process, as it always did. When `--skills` and `--commands` come
2837
+ * together the other scope still has to run, so it hands its exit code back instead and
2838
+ * {@link runScopes} ends the process once, with the worse code of the two.
2839
+ * (Found 2026-10-27 on Windows: `--skills --commands` ran one scope, exited 0 and said
2840
+ * nothing about the other. The same two axes XSPEC-372 R1/R2 separated, one level down.)
2841
+ * @param {number} code - 0 on success, non-zero on failure
2842
+ * @param {boolean} chained - true when another scope runs after this one
2843
+ * @returns {number} the code, so a caller can `return endScope(...)`
2844
+ */
2845
+ function endScope(code, chained) {
2846
+ if (!chained) process.exit(code);
2847
+ return code;
2848
+ }
2849
+
2850
+ /**
2851
+ * Run the scope steps the flags name. One scope runs exactly as before (it exits the
2852
+ * process itself). Both run in a fixed order, each printing its own section, and the
2853
+ * process ends with the worst code: any failure is non-zero, and so is a failure the
2854
+ * reconciler already recorded in `process.exitCode` (`--apply`).
2855
+ * @param {string} projectPath
2856
+ * @param {Object} manifest
2857
+ * @param {Object} options
2858
+ * @param {{skills: boolean, commands: boolean}} scopes
2859
+ */
2860
+ async function runScopes(projectPath, manifest, options, { skills, commands }) {
2861
+ if (skills && commands) {
2862
+ const skillsCode = await updateSkillsOnly(projectPath, manifest, options, { chained: true });
2863
+ const commandsCode = await updateCommandsOnly(projectPath, manifest, options, { chained: true });
2864
+ process.exit(Math.max(skillsCode, commandsCode, Number(process.exitCode) || 0));
2865
+ return;
2866
+ }
2867
+ if (skills) await updateSkillsOnly(projectPath, manifest, options);
2868
+ if (commands) await updateCommandsOnly(projectPath, manifest, options);
2869
+ }
2870
+
2871
+ async function updateSkillsOnly(projectPath, manifest, options, { chained = false } = {}) {
2778
2872
  const msg = t().commands.update;
2779
2873
  const repoInfo = getRepositoryInfo();
2780
2874
  const latestVersion = repoInfo.skills.version;
@@ -2819,13 +2913,24 @@ async function updateSkillsOnly(projectPath, manifest, options) {
2819
2913
  return Boolean(config?.supportsSkills && config?.skills);
2820
2914
  });
2821
2915
  const agents = detectedSkillsTools.length > 0 ? detectedSkillsTools : ['claude-code'];
2822
- for (const agent of agents) skillsInstallations.push({ agent, level: legacyLocation });
2916
+ // XSPEC-486 R2: a tool with no folder at the recorded level (antigravity has no user-level one) is not given
2917
+ // an installation that has nowhere to go.
2918
+ // …and the run says so, as `init` and `config` do (beta.15 Windows retest, Issue 1: this path was silent).
2919
+ for (const agent of agents) {
2920
+ if (hasSkillsLevel(agent, legacyLocation)) {
2921
+ skillsInstallations.push({ agent, level: legacyLocation });
2922
+ } else {
2923
+ console.log(chalk.yellow(
2924
+ `⚠ ${getAgentDisplayName(agent) || agent}: ` +
2925
+ `${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'}`
2926
+ ));
2927
+ }
2928
+ }
2823
2929
  } else if (legacyLocation === 'marketplace') {
2824
2930
  console.log(chalk.yellow(msg.skillsViaMarketplace || 'Skills installed via Marketplace'));
2825
2931
  console.log(chalk.gray(` ${msg.updateViaMarketplace || 'Update through Plugin Marketplace'}`));
2826
2932
  console.log();
2827
- process.exit(0);
2828
- return;
2933
+ return endScope(0, chained);
2829
2934
  }
2830
2935
  }
2831
2936
  }
@@ -2834,8 +2939,7 @@ async function updateSkillsOnly(projectPath, manifest, options) {
2834
2939
  console.log(chalk.yellow(msg.noSkillsInstalled || 'No Skills installations found'));
2835
2940
  console.log(chalk.gray(` ${msg.runInitToInstall || 'Run uds init to install Skills'}`));
2836
2941
  console.log();
2837
- process.exit(0);
2838
- return;
2942
+ return endScope(0, chained);
2839
2943
  }
2840
2944
 
2841
2945
  // Show current status
@@ -2865,8 +2969,7 @@ async function updateSkillsOnly(projectPath, manifest, options) {
2865
2969
  if (fileBasedInstallations.length === 0) {
2866
2970
  console.log(chalk.green(msg.allSkillsUpToDate || 'All Skills are up to date'));
2867
2971
  console.log();
2868
- process.exit(0);
2869
- return;
2972
+ return endScope(0, chained);
2870
2973
  }
2871
2974
 
2872
2975
  // XSPEC-454 R1: this step writes outside the reconciler, so it takes its own rollback point — the skill
@@ -2875,8 +2978,7 @@ async function updateSkillsOnly(projectPath, manifest, options) {
2875
2978
  // No backup, no write: an install that cannot be undone must not start.
2876
2979
  const skillsBackup = takeStepBackup(projectPath, 'skills', fileBasedInstallations, 'skills');
2877
2980
  if (!skillsBackup.ok) {
2878
- process.exit(1);
2879
- return;
2981
+ return endScope(1, chained);
2880
2982
  }
2881
2983
 
2882
2984
  const spinner = createSpinner(msg.installingSkills || 'Installing Skills...').start();
@@ -2892,7 +2994,7 @@ async function updateSkillsOnly(projectPath, manifest, options) {
2892
2994
  // Build location summary
2893
2995
  const locations = fileBasedInstallations.map(inst => {
2894
2996
  const displayName = getAgentDisplayName(inst.agent);
2895
- const dir = getSkillsDirForAgent(inst.agent, inst.level, projectPath);
2997
+ const dir = getSkillsDirForAgent(inst.agent, inst.level, projectPath) ?? '(no such folder)'; // XSPEC-486
2896
2998
  return `${displayName}: ${dir}`;
2897
2999
  }).join(', ');
2898
3000
 
@@ -2963,7 +3065,7 @@ async function updateSkillsOnly(projectPath, manifest, options) {
2963
3065
  // XSPEC-465 R1: a personal skill with the same name as one of the UDS skills just written wins silently.
2964
3066
  // Information only: it does not change what was installed or the exit code.
2965
3067
  printSkillNameCollisionWarning(projectPath);
2966
- process.exit(0);
3068
+ return endScope(0, chained);
2967
3069
  }
2968
3070
 
2969
3071
  /**
@@ -2972,7 +3074,7 @@ async function updateSkillsOnly(projectPath, manifest, options) {
2972
3074
  * @param {Object} manifest - Manifest object
2973
3075
  * @param {Object} [options] - CLI options (forwarded for locale resolution)
2974
3076
  */
2975
- async function updateCommandsOnly(projectPath, manifest, options) {
3077
+ async function updateCommandsOnly(projectPath, manifest, options, { chained = false } = {}) {
2976
3078
  const msg = t().commands.update;
2977
3079
 
2978
3080
  console.log(chalk.cyan(msg.updatingCommandsOnly || 'Updating slash commands for all AI Agents...'));
@@ -2999,8 +3101,7 @@ async function updateCommandsOnly(projectPath, manifest, options) {
2999
3101
  console.log(chalk.yellow(msg.noCommandsInstalled || 'No slash commands installations found'));
3000
3102
  console.log(chalk.gray(` ${msg.runInitToInstall || 'Run uds init to install commands'}`));
3001
3103
  console.log();
3002
- process.exit(0);
3003
- return;
3104
+ return endScope(0, chained);
3004
3105
  }
3005
3106
 
3006
3107
  // Show current status
@@ -3022,8 +3123,7 @@ async function updateCommandsOnly(projectPath, manifest, options) {
3022
3123
  // XSPEC-454 R1: same as the Skills step — a rollback point first, and no write without one.
3023
3124
  const commandsBackup = takeStepBackup(projectPath, 'commands', commandsInstallations, 'commands');
3024
3125
  if (!commandsBackup.ok) {
3025
- process.exit(1);
3026
- return;
3126
+ return endScope(1, chained);
3027
3127
  }
3028
3128
 
3029
3129
  const spinner = createSpinner(msg.installingCommands || 'Installing commands...').start();
@@ -3109,7 +3209,7 @@ async function updateCommandsOnly(projectPath, manifest, options) {
3109
3209
  finishStepBackup(projectPath, commandsBackup);
3110
3210
 
3111
3211
  console.log();
3112
- process.exit(0);
3212
+ return endScope(0, chained);
3113
3213
  }
3114
3214
 
3115
3215
  /**
@@ -3366,7 +3466,7 @@ async function promptNewFeatureInstallation(missingSkills, outdatedSkills, missi
3366
3466
  console.log(chalk.yellow(msg.skillsOutdatedFor || 'Skills updates available for these AI tools:'));
3367
3467
  for (const skill of outdatedSkills) {
3368
3468
  const levelLabel = skill.level === 'user' ? 'user' : 'project';
3369
- const pathDisplay = skill.path || getSkillsDirForAgent(skill.agent, skill.level);
3469
+ const pathDisplay = skill.path || getSkillsDirForAgent(skill.agent, skill.level) || '(no such folder)';
3370
3470
  console.log(chalk.gray(` • ${skill.displayName} (${levelLabel}: ${pathDisplay})`));
3371
3471
  console.log(chalk.gray(` ${skill.currentVersion} → ${skill.latestVersion}`));
3372
3472
  }
@@ -3375,7 +3475,7 @@ async function promptNewFeatureInstallation(missingSkills, outdatedSkills, missi
3375
3475
  // Build checkbox choices with path info
3376
3476
  const updateChoices = outdatedSkills.map(skill => {
3377
3477
  const levelLabel = skill.level === 'user' ? 'user' : 'project';
3378
- const pathDisplay = skill.path || getSkillsDirForAgent(skill.agent, skill.level);
3478
+ const pathDisplay = skill.path || getSkillsDirForAgent(skill.agent, skill.level) || '(no such folder)';
3379
3479
  return {
3380
3480
  name: `${skill.displayName} ${chalk.gray(`(${levelLabel}: ${pathDisplay}) ${skill.currentVersion} → ${skill.latestVersion}`)}`,
3381
3481
  value: skill.agent,
@@ -3511,14 +3611,14 @@ function takeStepBackup(projectPath, label, installations, kind) {
3511
3611
  console.log();
3512
3612
  return { ok: false };
3513
3613
  }
3514
- cleanupBackupsQuietly(projectPath);
3515
- return { ok: true, backupId: backup.backupId };
3614
+ return { ok: true, backupId: backup.backupId, cleanup: cleanupBackupsQuietly(projectPath) };
3516
3615
  }
3517
3616
 
3518
3617
  /** The step is over (its last manifest write is done): record what it created, and say how to undo it. */
3519
3618
  function finishStepBackup(projectPath, backup) {
3520
3619
  finalizeBackup(projectPath, backup.backupId);
3521
3620
  printBackupLocation(backup.backupId);
3621
+ printBackupCleanup(backup.cleanup);
3522
3622
  }
3523
3623
 
3524
3624
  /**
@@ -3534,9 +3634,34 @@ function printBackupLocation(backupId) {
3534
3634
 
3535
3635
  function cleanupBackupsQuietly(projectPath) {
3536
3636
  try {
3537
- cleanupBackups(projectPath);
3637
+ return cleanupBackups(projectPath);
3538
3638
  } catch {
3539
3639
  // an old backup that cannot be removed is not a reason to stop the update
3640
+ return null;
3641
+ }
3642
+ }
3643
+
3644
+ /**
3645
+ * Say what the backup limit did (XSPEC-475 R2). A backup is the adopter's data: one deleted without a word
3646
+ * is how an adopter loses the only copy of something version control cannot give back.
3647
+ * - every backup removed because `.uds-backups/` holds more than the limit is named;
3648
+ * - backups an older UDS left in the project root (`.uds-backup-*`) are never removed by the limit; they
3649
+ * are listed here with a suggestion to move them out themselves.
3650
+ * // implements XSPEC-475 R2
3651
+ */
3652
+ function printBackupCleanup(cleanup) {
3653
+ if (!cleanup) return;
3654
+ const removed = cleanup.removed || [];
3655
+ const legacy = cleanup.legacyKept || [];
3656
+ if (removed.length > 0) {
3657
+ console.log(chalk.yellow(` Removed ${removed.length} old backup(s) beyond the limit of ${cleanup.keep} in .uds-backups/:`));
3658
+ for (const id of removed) console.log(chalk.yellow(` ✕ ${id}`));
3659
+ }
3660
+ for (const err of cleanup.errors || []) console.log(chalk.red(` ${err}`));
3661
+ if (legacy.length > 0) {
3662
+ 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:`));
3663
+ for (const id of legacy) console.log(chalk.yellow(` - ${id}`));
3664
+ 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
3665
  }
3541
3666
  }
3542
3667
 
@@ -3551,20 +3676,37 @@ function printPaths(prefix, paths, limit, colour) {
3551
3676
  * updates, then say, item by item, what was restored, what was removed, and what was NOT put back.
3552
3677
  * It never ends in "successful" while any of those lists is not empty (XSPEC-454 R1).
3553
3678
  */
3554
- async function handleRollback(projectPath) {
3679
+ async function handleRollback(projectPath, options = {}) {
3555
3680
  const backups = listBackups(projectPath);
3556
3681
  if (backups.length === 0) {
3557
3682
  console.log(chalk.yellow('No backups found. Nothing to rollback.'));
3558
3683
  console.log();
3684
+ if (options.from) process.exitCode = 1;
3559
3685
  return;
3560
3686
  }
3561
3687
 
3562
- const latest = backups[0];
3688
+ // XSPEC-482 R11: `--from` names the one backup to restore. The default picks the newest series, and a backup an older
3689
+ // UDS made is never in it (it records no manifest hash to chain on), so without this there was no way to reach it.
3690
+ let chosen = null;
3691
+ if (options.from) {
3692
+ const wanted = String(options.from).replace(/\\/g, '/').replace(/\/+$/, '');
3693
+ const leaf = (id) => id.slice(id.lastIndexOf('/') + 1);
3694
+ chosen = backups.find((b) => b.backupId === wanted) || backups.find((b) => leaf(b.backupId) === leaf(wanted));
3695
+ if (!chosen) {
3696
+ console.log(chalk.red(`No backup named "${options.from}". Backups in this project:`));
3697
+ for (const b of backups) console.log(chalk.gray(` ${b.backupId} (${b.createdAt || 'no date'})`));
3698
+ console.log();
3699
+ process.exitCode = 1;
3700
+ return;
3701
+ }
3702
+ }
3703
+
3704
+ const latest = chosen || backups[0];
3563
3705
  console.log(chalk.cyan(`Rolling back from: ${latest.backupId}`));
3564
3706
  console.log(chalk.gray(` Created: ${latest.createdAt}`));
3565
3707
  console.log();
3566
3708
 
3567
- const result = rollbackLast(projectPath);
3709
+ const result = rollbackLast(projectPath, chosen ? chosen.backupId : undefined);
3568
3710
 
3569
3711
  for (const step of result.steps || []) {
3570
3712
  console.log(chalk.cyan(`${step.backupId}${step.label ? ` (${step.label})` : ''}`));
@@ -3582,7 +3724,16 @@ async function handleRollback(projectPath) {
3582
3724
  console.log(chalk.gray(` ${result.steps.length} consecutive updates were undone together (each one started from where the previous one ended).`));
3583
3725
  }
3584
3726
  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.`));
3727
+ // Say the true reason. A backup an older UDS made records no manifest hash, so there is nothing to tell whether it
3728
+ // continues the series; one that does carry the hash and still does not match means something else changed the project.
3729
+ const inSeries = (result.steps || []).length;
3730
+ const next = backups[inSeries];
3731
+ const why = next && !next.postManifestHash
3732
+ ? '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'
3733
+ : 'something else changed the project after it was made';
3734
+ console.log(chalk.gray(` ${result.olderBackups} older backup(s) are not part of that series (${why}) and were left alone.`));
3735
+ console.log(chalk.gray(' To restore one of them on its own: `uds update --rollback --from <backup>`. They are:'));
3736
+ for (const b of backups.slice(inSeries)) console.log(chalk.gray(` ${b.backupId} (${b.createdAt || 'no date'})`)); // wire:rollback-names-older-backups
3586
3737
  }
3587
3738
 
3588
3739
  if (result.errors.length > 0) {
@@ -3677,8 +3828,24 @@ async function handleReconcile(projectPath, options, { force, addStandards = []
3677
3828
  // XSPEC-454 R2: nothing to apply, but the manifest may still list skill files UDS never installed
3678
3829
  // (they only ever get corrected by a write, and an up-to-date project has none coming).
3679
3830
  const current = readManifest(projectPath);
3680
- if (current && (pruneForeignSkillHashes(current).length + pruneForeignCommandHashes(current).length) > 0) writeManifest(current, projectPath);
3831
+ // XSPEC-475 R6: nothing to apply means the files are what this UDS ships; the recorded versions say so too.
3832
+ let aligned = current ? alignRecordedVersions(current).changed : false; // wire:up-to-date-aligns-versions
3833
+ // XSPEC-482 R6: the same for the standards version, which only an executed plan used to record.
3834
+ if (current && alignUpstreamVersion(current).changed) aligned = true; // wire:up-to-date-aligns-upstream
3835
+ // XSPEC-456 R4 (kept through XSPEC-482 R6): the NAME lists are corrected here too. This early return used to be reached only by
3836
+ // a project that had nothing else to rewrite, which a fresh `uds init` almost never was; once init leaves the project current
3837
+ // it is the normal case, and the names UDS cannot vouch for (`_shared`, a retired skill) stayed in the manifest for good.
3838
+ // Ownership test only, as the reconciler does (no disk test).
3839
+ let droppedNames = 0;
3840
+ if (current) {
3841
+ const before = (current.skills?.names?.length || 0) + (current.commands?.names?.length || 0);
3842
+ pruneForeignSkillNames(current, '');
3843
+ pruneForeignCommandNames(current, '');
3844
+ droppedNames = before - ((current.skills?.names?.length || 0) + (current.commands?.names?.length || 0)); // wire:up-to-date-prunes-names
3845
+ }
3846
+ if (current && ((pruneForeignSkillHashes(current).length + pruneForeignCommandHashes(current).length) > 0 || aligned || droppedNames > 0)) writeManifest(current, projectPath);
3681
3847
  console.log(chalk.green('Everything is up to date. No changes needed.'));
3848
+ if (droppedNames > 0) console.log(chalk.gray(` ${t().commands.update.droppedForeignNames.replace('{count}', droppedNames)}`));
3682
3849
  // XSPEC-458 R2: "up to date" is about the files UDS manages; say what UDS ships that is not managed here.
3683
3850
  printAvailableStandardsSection(planResult.manifest, { phase: 'apply' });
3684
3851
  console.log();
@@ -3721,6 +3888,7 @@ async function handleReconcile(projectPath, options, { force, addStandards = []
3721
3888
 
3722
3889
  if (result.execution?.backupId) {
3723
3890
  printBackupLocation(result.execution.backupId);
3891
+ printBackupCleanup(result.execution.backupCleanup);
3724
3892
  }
3725
3893
 
3726
3894
  if (result.errors.length > 0) {
@@ -3731,6 +3899,18 @@ async function handleReconcile(projectPath, options, { force, addStandards = []
3731
3899
  }
3732
3900
  }
3733
3901
 
3902
+ if (!result.success) {
3903
+ // XSPEC-482 R10: say what a partly failed run left behind and the way to finish it.
3904
+ console.log();
3905
+ console.log(chalk.yellow(
3906
+ 'Not everything was applied. The overall version record did not advance, and a skills or commands batch that failed keeps its ' +
3907
+ 'old version record; a batch that succeeded has already recorded its new version. ' +
3908
+ 'Fix the cause, then run `uds update --apply` again: it completes what is left.'
3909
+ ));
3910
+ // XSPEC-482 R2: a failed action is a failed run. CI and scripts read the exit code, not the colour of a line.
3911
+ process.exitCode = 1; // wire:apply-fails-exit-1
3912
+ }
3913
+
3734
3914
  // XSPEC-458 R2: the count of what UDS ships and this project lacks, with the command that installs one.
3735
3915
  printAvailableStandardsSection(result.manifest || planResult.manifest, { phase: 'apply' });
3736
3916
  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
+ }