universal-dev-standards 6.14.0-beta.1 → 6.14.0-beta.11

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 (688) hide show
  1. package/README.md +13 -3
  2. package/bin/uds.js +75 -3
  3. package/bundled/ai/options/code-review/pr-review.ai.yaml +20 -1
  4. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  5. package/bundled/ai/standards/ai-response-navigation.ai.yaml +43 -3
  6. package/bundled/ai/standards/checkin-standards.ai.yaml +25 -6
  7. package/bundled/ai/standards/code-review.ai.yaml +15 -2
  8. package/bundled/ai/standards/commit-message.ai.yaml +18 -4
  9. package/bundled/ai/standards/developer-memory.ai.yaml +12 -2
  10. package/bundled/ai/standards/full-coverage-testing.ai.yaml +86 -7
  11. package/bundled/ai/standards/open-work-tracking.ai.yaml +196 -11
  12. package/bundled/ai/standards/pipeline-security-gates.ai.yaml +53 -4
  13. package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
  14. package/bundled/core/ai-response-navigation.md +128 -12
  15. package/bundled/core/code-review-checklist.md +20 -2
  16. package/bundled/core/commit-message-guide.md +22 -19
  17. package/bundled/core/developer-memory.md +12 -2
  18. package/bundled/core/full-coverage-testing.md +99 -5
  19. package/bundled/core/open-work-tracking.md +157 -17
  20. package/bundled/core/pipeline-security-gates.md +63 -0
  21. package/bundled/core/project-context-memory.md +10 -2
  22. package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
  23. package/bundled/extensions/languages/csharp-style.md +464 -0
  24. package/bundled/extensions/languages/php-style.md +700 -0
  25. package/bundled/extensions/locales/zh-cn.md +717 -0
  26. package/bundled/extensions/locales/zh-tw.md +717 -0
  27. package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
  28. package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
  29. package/bundled/locales/COVERAGE.md +5 -4
  30. package/bundled/locales/zh-CN/CHANGELOG.md +199 -3
  31. package/bundled/locales/zh-CN/README.md +3 -3
  32. package/bundled/locales/zh-CN/SECURITY.md +3 -2
  33. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  34. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
  35. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  36. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
  37. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
  38. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
  39. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
  40. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  41. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  42. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  43. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  44. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  45. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  46. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  47. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  48. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  49. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  50. package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
  51. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  52. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  53. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  54. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  55. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  56. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  57. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  58. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  59. package/bundled/locales/zh-CN/core/code-review-checklist.md +54 -23
  60. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  61. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  62. package/bundled/locales/zh-CN/core/developer-memory.md +159 -60
  63. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  64. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  65. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  66. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  67. package/bundled/locales/zh-CN/core/full-coverage-testing.md +103 -9
  68. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  69. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  70. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  71. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  72. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  73. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  74. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  75. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  76. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  77. package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
  78. package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
  79. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  80. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  81. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  82. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  83. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  84. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  85. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  86. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  87. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  88. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  89. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  90. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  91. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  92. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  93. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  94. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  95. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  96. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  97. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  98. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  99. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  100. package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
  101. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +9 -3
  102. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  103. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +68 -33
  104. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +29 -15
  105. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  106. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
  107. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  108. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
  109. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  110. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  111. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +46 -0
  112. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  113. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  114. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  115. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  116. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  117. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  118. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  119. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  120. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  121. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  122. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  123. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  124. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  125. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  126. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  127. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  128. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  129. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  130. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  131. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  132. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  133. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  134. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  135. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  136. package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
  137. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  138. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  139. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  140. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  141. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  142. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  143. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  144. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  145. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  146. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  147. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  148. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  149. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  150. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  151. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  152. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  153. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  154. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  155. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  156. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  157. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  158. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  159. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  160. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  161. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  162. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  163. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  164. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  165. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  166. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  167. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  168. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  169. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  170. package/bundled/locales/zh-CN/skills/README.md +3 -1
  171. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  172. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  173. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  174. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  175. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  176. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  177. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  178. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  179. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  180. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  181. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  182. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  183. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  184. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  185. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  186. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  187. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  188. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  189. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  190. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  191. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  192. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  193. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  194. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  195. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  196. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  197. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  198. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  199. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  200. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  201. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  202. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  203. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  204. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  205. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  206. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  207. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  208. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  209. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  210. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  211. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  212. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  213. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  214. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  215. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  216. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  217. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  218. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  219. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  220. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  221. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  222. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  223. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  224. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  225. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  226. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  227. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  228. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  229. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  230. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  231. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  232. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  233. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  234. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  235. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  236. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  237. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  238. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  239. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  240. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  241. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  242. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  243. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  244. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  245. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -2
  246. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  247. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  248. package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
  249. package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
  250. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  251. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  252. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  253. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  254. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  255. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  256. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  257. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  258. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  259. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  260. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  261. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  262. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  263. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  264. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  265. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  266. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  267. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  268. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  269. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  270. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  271. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  272. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  273. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  274. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  275. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  276. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  277. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  278. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  279. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  280. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  281. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  282. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  283. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  284. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  285. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  286. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  287. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  288. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  289. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  290. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  291. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  292. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  293. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  294. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  295. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  296. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  297. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  298. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  299. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  300. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  301. package/bundled/locales/zh-TW/CHANGELOG.md +199 -3
  302. package/bundled/locales/zh-TW/README.md +3 -3
  303. package/bundled/locales/zh-TW/SECURITY.md +3 -2
  304. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  305. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
  306. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  307. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
  308. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
  309. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
  310. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
  311. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  312. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  313. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  314. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  315. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  316. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  317. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  318. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  319. package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
  320. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  321. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  322. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  323. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  324. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  325. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  326. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  327. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  328. package/bundled/locales/zh-TW/core/code-review-checklist.md +36 -7
  329. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  330. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  331. package/bundled/locales/zh-TW/core/developer-memory.md +111 -12
  332. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  333. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  334. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  335. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  336. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  337. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  338. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  339. package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
  340. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  341. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  342. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  343. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  344. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  345. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  346. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  347. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  348. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  349. package/bundled/locales/zh-TW/core/open-work-tracking.md +92 -16
  350. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  351. package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
  352. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  353. package/bundled/locales/zh-TW/core/project-context-memory.md +215 -31
  354. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  355. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  356. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  357. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  358. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  359. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  360. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  361. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  362. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  363. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  364. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  365. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  366. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  367. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  368. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  369. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  370. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  371. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  372. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  373. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  374. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  375. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  376. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  377. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  378. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  379. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  380. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  381. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  382. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  383. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  384. package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
  385. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +9 -3
  386. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  387. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +61 -26
  388. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  389. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +29 -15
  390. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  391. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
  392. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  393. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
  394. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  395. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  396. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +46 -0
  397. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  398. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  399. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  400. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  401. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  402. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  403. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  404. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  405. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  406. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  407. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  408. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  409. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  410. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  411. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  412. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  413. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  414. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  415. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  416. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  417. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  418. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  419. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  420. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  421. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  422. package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
  423. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  424. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  425. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  426. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  427. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  428. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  429. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  430. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  431. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  432. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  433. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  434. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  435. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  436. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  437. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  438. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  439. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  440. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  441. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  442. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  443. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  444. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  445. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  446. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  447. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  448. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  449. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  450. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  451. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  452. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  453. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  454. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  455. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  456. package/bundled/locales/zh-TW/skills/README.md +3 -1
  457. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  458. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  459. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  460. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  461. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  462. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  463. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  464. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  465. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  466. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  467. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  468. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  469. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  470. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  471. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  472. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  473. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  474. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  475. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  476. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  477. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  478. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  479. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  480. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  481. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  482. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  483. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  484. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  485. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  486. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  487. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  488. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  489. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  490. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  491. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  492. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  493. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  494. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  495. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  496. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  497. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  498. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  499. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  500. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  501. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  502. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  503. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  504. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  505. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  506. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  507. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  508. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  509. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  510. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  511. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  512. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  513. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  514. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  515. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  516. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  517. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  518. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  519. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  520. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  521. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  522. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  523. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  524. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  525. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  526. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  527. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  528. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  529. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  530. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  531. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  532. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  533. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  534. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  535. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  536. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  537. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  538. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  539. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  540. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  541. package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
  542. package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
  543. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  544. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  545. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  546. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  547. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  548. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  549. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  550. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  551. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  552. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  553. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  554. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  555. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  556. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  557. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  558. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  559. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  560. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  561. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  562. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  563. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  564. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  565. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  566. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  567. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  568. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  569. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  570. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  571. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  572. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  573. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  574. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  575. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  576. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  577. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  578. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  579. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  580. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  581. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  582. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  583. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  584. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  585. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  586. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  587. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  588. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  589. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  590. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  591. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  592. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  593. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  594. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  595. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  596. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  597. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  598. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  599. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  600. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  601. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  602. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  603. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  604. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  605. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  606. package/bundled/skills/README.md +1 -0
  607. package/bundled/skills/SKILL_NAMING.md +9 -0
  608. package/bundled/skills/commit-standards/SKILL.md +2 -2
  609. package/bundled/skills/commit-standards/guide.md +3 -2
  610. package/bundled/skills/commit-standards/language-options.md +19 -17
  611. package/bundled/skills/comprehension-ladder/SKILL.md +283 -0
  612. package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
  613. package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
  614. package/bundled/templates/gates/check-stubs.mjs +644 -0
  615. package/package.json +5 -3
  616. package/src/commands/audit.js +20 -2
  617. package/src/commands/check.js +155 -28
  618. package/src/commands/deps.js +31 -1
  619. package/src/commands/hitl.js +3 -0
  620. package/src/commands/init.js +159 -48
  621. package/src/commands/list.js +12 -3
  622. package/src/commands/mcp.js +2 -3
  623. package/src/commands/open-work.js +123 -0
  624. package/src/commands/quickstart.js +29 -13
  625. package/src/commands/release.js +102 -19
  626. package/src/commands/run-intent.js +11 -0
  627. package/src/commands/simulate.js +20 -8
  628. package/src/commands/skills.js +59 -33
  629. package/src/commands/spec-split.js +30 -17
  630. package/src/commands/spec.js +55 -21
  631. package/src/commands/uninstall.js +146 -32
  632. package/src/commands/update.js +471 -93
  633. package/src/core/install-records.js +192 -0
  634. package/src/core/manifest.js +12 -10
  635. package/src/core/marketplace-sentinel.js +5 -0
  636. package/src/core/open-work-config.js +122 -0
  637. package/src/core/project-config.js +113 -38
  638. package/src/flows/init-flow.js +10 -0
  639. package/src/hitl/manager.js +4 -2
  640. package/src/i18n/messages.js +413 -78
  641. package/src/installers/hooks-installer.js +236 -27
  642. package/src/installers/integration-installer.js +5 -1
  643. package/src/installers/skills-installer.js +3 -1
  644. package/src/installers/standards-installer.js +16 -23
  645. package/src/mcp/__tests__/server.test.js +0 -1
  646. package/src/mcp/server.js +16 -4
  647. package/src/prompts/init.js +148 -13
  648. package/src/reconciler/backup-locations.js +80 -0
  649. package/src/reconciler/backup-manager.js +451 -123
  650. package/src/reconciler/index.js +86 -10
  651. package/src/reconciler/install-roots.js +90 -0
  652. package/src/reconciler/plan-executor.js +37 -15
  653. package/src/uninstallers/hook-uninstaller.js +220 -33
  654. package/src/uninstallers/integration-uninstaller.js +35 -5
  655. package/src/uninstallers/skills-uninstaller.js +95 -16
  656. package/src/uninstallers/standards-uninstaller.js +56 -7
  657. package/src/utils/agents-installer.js +10 -17
  658. package/src/utils/available-standards-report.js +144 -0
  659. package/src/utils/available-standards.js +216 -0
  660. package/src/utils/command-hash-ownership.js +103 -0
  661. package/src/utils/commit-message-judge.js +155 -0
  662. package/src/utils/copier.js +80 -2
  663. package/src/utils/deps-applicability.js +25 -0
  664. package/src/utils/detector.js +46 -1
  665. package/src/utils/friction-detector.js +27 -0
  666. package/src/utils/gate-scripts.js +141 -0
  667. package/src/utils/git-hooks.js +139 -7
  668. package/src/utils/hasher.js +36 -0
  669. package/src/utils/health-scorer.js +10 -7
  670. package/src/utils/installed-names-ownership.js +114 -0
  671. package/src/utils/integration-generator.js +36 -24
  672. package/src/utils/legacy-hook-migration.js +112 -0
  673. package/src/utils/locale.js +19 -0
  674. package/src/utils/open-work-tracking.mjs +1754 -0
  675. package/src/utils/prompt-closed.js +18 -0
  676. package/src/utils/sdd-header.js +66 -0
  677. package/src/utils/skill-frontmatter.js +102 -0
  678. package/src/utils/skill-hash-ownership.js +64 -0
  679. package/src/utils/skill-name-collision.js +169 -0
  680. package/src/utils/skills-install-paths.js +114 -0
  681. package/src/utils/skills-installer.js +75 -106
  682. package/src/utils/standard-validator.js +98 -27
  683. package/src/utils/test-change-check.js +160 -0
  684. package/src/utils/test-policy.js +214 -0
  685. package/src/utils/transient-fs.js +113 -0
  686. package/src/utils/update-summary.js +29 -0
  687. package/src/vibe/micro-spec.js +15 -0
  688. package/standards-registry.json +48 -9
@@ -1,7 +1,6 @@
1
1
  import chalk from 'chalk';
2
2
  import { createSpinner } from '../utils/spinner.js';
3
- import { execSync } from 'child_process';
4
- import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
3
+ import { existsSync, mkdirSync, readFileSync, writeFileSync, chmodSync } from 'fs';
5
4
  import { join } from 'path';
6
5
  import {
7
6
  manifestExists as isInitialized,
@@ -15,20 +14,28 @@ import { runInitFlow } from '../flows/init-flow.js';
15
14
  import { installStandards } from '../installers/standards-installer.js';
16
15
  import { installIntegrations, generateUniversalAgentsMd } from '../installers/integration-installer.js';
17
16
  import { installSkills, installCommands } from '../installers/skills-installer.js';
17
+ import { printSkillNameCollisionWarning } from '../utils/skill-name-collision.js';
18
+ import { printDoubleInstallWarning } from '../utils/skills-install-paths.js';
18
19
  import { writeFinalManifest } from '../installers/manifest-installer.js';
19
20
  import {
20
21
  getInstalledSkillsInfo,
21
22
  getProjectInstalledSkillsInfo,
23
+ getMarketplaceSkillsInfo,
22
24
  getAgentConfig,
23
25
  getAgentDisplayName
24
26
  } from '../utils/github.js';
25
- import { displayLanguageToLocale } from '../utils/locale.js';
27
+ import { displayLanguageToLocale, normalizeRequestedLocale } from '../utils/locale.js';
28
+ import localeUtils from '../utils/locale.js';
29
+ const LOCALE_MAP_FOR_INIT = localeUtils.LOCALE_MAP;
26
30
  import { generateReleaseConfig, RELEASE_MODE_LABELS } from '../utils/release-config.js';
27
31
  import { guardAgainstSelfAdoption } from '../utils/detect-self-adoption.js';
28
32
  import { readInstallYaml } from '../utils/config-manager.js';
29
33
  import { resolveIntegrationTargetFile } from '../utils/integration-generator.js';
30
34
  import { withFileTransaction } from '../utils/transaction.js';
31
- import { wireGitHooksPath, getLocalHooksPathConfig, stripLegacyHuskyShLine, ensureShebang } from '../utils/git-hooks.js';
35
+ import { newRecorder, mkdirTracked, recordFile, persistRecorder, RECORD_KINDS } from '../core/install-records.js';
36
+ import { wireGitHooksPath, getLocalHooksPathConfig, stripLegacyHuskyShLine, ensureShebang, hookRunsUdsCheck, buildPreCommitBlock } from '../utils/git-hooks.js';
37
+ import { migrateLegacyHuskyHook } from '../utils/legacy-hook-migration.js';
38
+ import { installGateScripts } from '../utils/gate-scripts.js';
32
39
 
33
40
  /**
34
41
  * Init command - initialize standards in current project
@@ -52,6 +59,8 @@ export async function initCommand(options) {
52
59
  if (isInitialized(projectPath)) {
53
60
  console.log(chalk.yellow(msg.alreadyInitialized));
54
61
  console.log(chalk.gray(` ${msg.useUpdateOrDelete}`));
62
+ // `init` cannot run twice, so `--with-hooks` has no effect here; say where the door is.
63
+ if (options.withHooks) console.log(chalk.yellow(` ${msg.useUpdateWithHooks}`));
55
64
  return;
56
65
  }
57
66
 
@@ -211,7 +220,11 @@ export async function initCommand(options) {
211
220
  skillHashes: skillsResults.skillHashes,
212
221
  commandHashes: skillsResults.commandHashes,
213
222
  integrationBlockHashes: integrationResults.integrationBlockHashes,
214
- manifestIntegrationConfigs: integrationResults.manifestIntegrationConfigs
223
+ manifestIntegrationConfigs: integrationResults.manifestIntegrationConfigs,
224
+ createdIntegrationFiles: [
225
+ ...(integrationResults.createdFiles ?? []),
226
+ ...(agentsMdResult.created ? [agentsMdResult.path] : [])
227
+ ]
215
228
  };
216
229
  },
217
230
  // A half-installed project must never be committed: if any installer
@@ -256,9 +269,13 @@ export async function initCommand(options) {
256
269
  }
257
270
 
258
271
  // 4.6. Install enforcement hooks (if --with-hooks)
272
+ // What this step writes is recorded in the manifest (installedArtifacts) so
273
+ // `uds uninstall` can remove exactly it — hook scripts, and the folders UDS had
274
+ // to create for them — and leave everything the adopter put there alone.
275
+ const installRecorder = newRecorder();
259
276
  if (config.withHooks) {
260
277
  const { installHooks } = await import('../installers/hooks-installer.js');
261
- const hookResult = installHooks(projectPath);
278
+ const hookResult = installHooks(projectPath, { recorder: installRecorder });
262
279
  if (hookResult.installed) {
263
280
  console.log(chalk.green(
264
281
  ` ✓ Enforcement hooks installed (${hookResult.scriptsCount} scripts, `
@@ -290,7 +307,7 @@ export async function initCommand(options) {
290
307
  const selectedTools = config.integrations || config.aiTools || [];
291
308
  if (selectedTools.includes('codex')) {
292
309
  const { installCodexHooks } = await import('../installers/hooks-installer.js');
293
- const codexResult = installCodexHooks(projectPath);
310
+ const codexResult = installCodexHooks(projectPath, { recorder: installRecorder });
294
311
  if (codexResult.installed) {
295
312
  console.log(chalk.green(' ✓ Codex Stop hook installed (turn-completion-integrity)'));
296
313
  // Measured 2026-09-28 (codex-cli 0.155.1): Codex skips a project hook
@@ -304,7 +321,7 @@ export async function initCommand(options) {
304
321
  }
305
322
  if (selectedTools.includes('gemini-cli')) {
306
323
  const { installGeminiHooks } = await import('../installers/hooks-installer.js');
307
- const geminiResult = installGeminiHooks(projectPath);
324
+ const geminiResult = installGeminiHooks(projectPath, { recorder: installRecorder });
308
325
  if (geminiResult.installed) {
309
326
  console.log(chalk.green(' ✓ Gemini CLI AfterAgent hook installed (turn-completion-integrity; Gemini CLI is legacy — see the standard)'));
310
327
  } else {
@@ -313,7 +330,7 @@ export async function initCommand(options) {
313
330
  }
314
331
  if (selectedTools.includes('antigravity')) {
315
332
  const { installAgyHooks } = await import('../installers/hooks-installer.js');
316
- const agyResult = installAgyHooks(projectPath);
333
+ const agyResult = installAgyHooks(projectPath, { recorder: installRecorder });
317
334
  if (agyResult.installed) {
318
335
  console.log(chalk.green(' ✓ Antigravity CLI Stop hook installed (turn-completion-integrity; .agents/hooks.json)'));
319
336
  // Verified 2026-09-29 (agy 1.2.12): single turn, no tool calls, `agy -p`.
@@ -326,6 +343,52 @@ export async function initCommand(options) {
326
343
  }
327
344
  }
328
345
 
346
+ // 4.7. Record the integration files UDS created from nothing, and the hook
347
+ // files/folders written above. Their text outside the UDS marker block (the
348
+ // `> Auto-generated by ...` header, the generated sections) is what makes
349
+ // "delete the whole file" provable at uninstall time.
350
+ for (const created of combinedResults.createdIntegrationFiles ?? []) {
351
+ recordFile(installRecorder, projectPath, created, RECORD_KINDS.INTEGRATION_FILE);
352
+ }
353
+
354
+ // 4.8. Ship the fake-test and stub scanners the full-coverage-testing standard asks for
355
+ // (XSPEC-444 R5). They are written whether or not git is present — the hook step below
356
+ // needs a repository, the scanners do not — and recorded so `uds uninstall` removes
357
+ // exactly these files. A file that already exists is the adopter's and is left alone.
358
+ const gateResult = installGateScripts(projectPath, installRecorder);
359
+ for (const rel of gateResult.written) {
360
+ console.log(chalk.green(` ✓ ${rel} (fake-test / stub scanner — \`uds check\` runs it and warns; edit it freely)`));
361
+ }
362
+ for (const rel of gateResult.kept) {
363
+ console.log(chalk.gray(` · ${rel} already exists — kept as is`));
364
+ }
365
+ for (const file of gateResult.missingTemplate) {
366
+ console.log(chalk.yellow(` ⚠ scripts/${file} not installed — the template is missing from this UDS package`));
367
+ }
368
+ persistRecorder(projectPath, installRecorder);
369
+
370
+ // 4.9. XSPEC-465 R1: tell the adopter now if a personal skill of theirs has the same name as a UDS skill
371
+ // that was just installed (the personal one wins, with no error). Information only: it does not change
372
+ // what was installed or the exit code.
373
+ if ((combinedResults?.skills?.length ?? 0) > 0) {
374
+ // XSPEC-468 R1: skills now go into the project by default, so a project whose owner already has the UDS
375
+ // plugin would list every skill twice. Same warning `uds check` prints (XSPEC-462 R2); information only,
376
+ // it changes neither what was installed nor the exit code.
377
+ printDoubleInstallWarning(projectPath, getMarketplaceSkillsInfo());
378
+ printSkillNameCollisionWarning(projectPath);
379
+ }
380
+
381
+ // 4.95. XSPEC-468 R1: the adopter asked for the plugin by name, so no skill file was written. Say so at the
382
+ // end, where they look for the skills, and say where they come from and what the other way would do.
383
+ if (config.skillsConfig.location === 'marketplace') {
384
+ console.log();
385
+ console.log(chalk.cyan(msg.skillsFromPluginTitle));
386
+ for (const line of msg.skillsFromPluginLines) {
387
+ console.log(chalk.gray(` ${line}`));
388
+ }
389
+ console.log();
390
+ }
391
+
329
392
  // 5. Setup Pre-commit Hook
330
393
  await setupHuskyHook(projectPath);
331
394
 
@@ -337,7 +400,7 @@ export async function initCommand(options) {
337
400
  * - Node.js projects: use husky
338
401
  * - Non-Node.js projects: write native .git/hooks/pre-commit
339
402
  */
340
- export async function setupHuskyHook(projectPath, { allowInTest = false } = {}) {
403
+ export async function setupHuskyHook(projectPath, { allowInTest = false, platform = process.platform } = {}) {
341
404
  // 2026-07-30:本函式在跑測試時改寫了 universal-dev-standards 自己
342
405
  // ——`npm install --save-dev husky`、改 package.json、建 .husky/pre-commit。
343
406
  //
@@ -357,6 +420,9 @@ export async function setupHuskyHook(projectPath, { allowInTest = false } = {})
357
420
 
358
421
  const isNodeProject = existsSync(join(projectPath, 'package.json'));
359
422
 
423
+ // What this function creates, for `uds uninstall` (see core/install-records.js).
424
+ const recorder = newRecorder();
425
+
360
426
  if (isNodeProject) {
361
427
  console.log(chalk.cyan('Configuring Pre-commit Hook...'));
362
428
 
@@ -434,7 +500,7 @@ export async function setupHuskyHook(projectPath, { allowInTest = false } = {})
434
500
  // 3. Ensure .husky directory exists
435
501
  if (!existsSync(huskyDir)) {
436
502
  try {
437
- mkdirSync(huskyDir, { recursive: true });
503
+ mkdirTracked(recorder, projectPath, huskyDir);
438
504
  } catch (e) {
439
505
  console.log(chalk.red(` ✗ Failed to create .husky directory: ${e.message}`));
440
506
  return;
@@ -443,8 +509,10 @@ export async function setupHuskyHook(projectPath, { allowInTest = false } = {})
443
509
 
444
510
  // 4. Add pre-commit hook content
445
511
  const preCommitPath = join(huskyDir, 'pre-commit');
446
- const udsCmd = 'npx uds check';
447
512
 
513
+ // Only a hook file UDS creates from nothing can later be proven to be wholly
514
+ // its own; one that already existed is appended to and stays the adopter's.
515
+ const preCommitExisted = existsSync(preCommitPath);
448
516
  try {
449
517
  // husky v9's own templates carry no shebang, no `_/husky.sh` sourcing
450
518
  // (that is v8 syntax, deprecated in v9 and removed in v10). Verified
@@ -462,6 +530,18 @@ export async function setupHuskyHook(projectPath, { allowInTest = false } = {})
462
530
  // — cheap, harmless on POSIX, and required on Windows. Existing files
463
531
  // are appended to, never rewritten — their contents are the adopter's,
464
532
  // not ours; ensureShebang only ever prepends a missing first line.
533
+ // A hook an older UDS wrote asks npx for the bare name `uds`, which on the
534
+ // npm registry is an unrelated package (see buildPreCommitBlock). Swap the
535
+ // line UDS itself wrote for the current block before anything else reads
536
+ // the file; a line the adopter edited is left alone and reported below.
537
+ const legacy = existsSync(preCommitPath) ? migrateLegacyHuskyHook(projectPath) : null;
538
+ if (legacy?.state === 'migrated') {
539
+ console.log(chalk.green(' ✓ Replaced the pre-commit line an older UDS wrote (it asked npm to resolve the bare name "uds", which is not this project) with one that runs only the installed UDS CLI'));
540
+ }
541
+ for (const k of legacy?.kept ?? []) {
542
+ console.log(chalk.yellow(` ⚠ .husky/pre-commit line ${k.line} ("${k.text}") asks npm to resolve the bare name "uds", which on the npm registry is an unrelated package. UDS did not write this exact line, so it was left alone — change it to "universal-dev-standards check" (with the CLI installed in this project or on PATH).`));
543
+ }
544
+
465
545
  let content = existsSync(preCommitPath) ? readFileSync(preCommitPath, 'utf-8') : '';
466
546
 
467
547
  // A pre-existing file may still carry husky v8's `_/husky.sh` sourcing
@@ -477,10 +557,10 @@ export async function setupHuskyHook(projectPath, { allowInTest = false } = {})
477
557
  const { content: destripped, removed: hadLegacyLine } = stripLegacyHuskyShLine(content);
478
558
  content = destripped;
479
559
 
480
- const needsAppend = !content.includes('uds check');
560
+ const needsAppend = !hookRunsUdsCheck(content);
481
561
  if (needsAppend) {
482
562
  const sep = content && !content.endsWith('\n') ? '\n' : '';
483
- content = `${content}${sep}\n# UDS Standard Check\n${udsCmd}\n`;
563
+ content = `${content}${sep}\n${buildPreCommitBlock()}`;
484
564
  }
485
565
 
486
566
  const { content: shebanged, added: addedShebang } = ensureShebang(content);
@@ -488,10 +568,22 @@ export async function setupHuskyHook(projectPath, { allowInTest = false } = {})
488
568
 
489
569
  if (hadLegacyLine || needsAppend || addedShebang) {
490
570
  writeFileSync(preCommitPath, content, 'utf-8');
491
- try {
492
- execSync(`chmod +x ${preCommitPath}`);
493
- } catch {
494
- // Ignore chmod failures on systems that don't support it
571
+ if (!preCommitExisted) recordFile(recorder, projectPath, '.husky/pre-commit', RECORD_KINDS.GIT_HOOK);
572
+ // 🔴 Was `execSync(`chmod +x ...`)` inside try/catch. On Windows that
573
+ // spawned cmd.exe, which printed "'chmod' is not recognized as an
574
+ // internal or external command" straight to the user's terminal —
575
+ // execSync inherits the child's stderr by default, so the catch hid the
576
+ // failure from the code and left it loud for the human (adopter report,
577
+ // 6.14.0-beta.2, Windows 11). No shell is needed to change a mode, and
578
+ // Windows has no exec bit to set (git for Windows runs the hook through
579
+ // its own sh regardless), so it is skipped there.
580
+ if (platform !== 'win32') {
581
+ try {
582
+ chmodSync(preCommitPath, 0o755);
583
+ } catch {
584
+ // A filesystem that refuses the mode change (FAT, some mounts) is not
585
+ // a reason to fail the install; git reports a non-executable hook itself.
586
+ }
495
587
  }
496
588
  }
497
589
 
@@ -510,6 +602,8 @@ export async function setupHuskyHook(projectPath, { allowInTest = false } = {})
510
602
  console.log(chalk.red(` ✗ Failed to configure pre-commit hook: ${e.message}`));
511
603
  }
512
604
 
605
+ persistRecorder(projectPath, recorder);
606
+
513
607
  // 5. Wire git so the hook ACTUALLY runs — this is the fix. Setting
514
608
  // `core.hooksPath` ourselves is what husky's own bootstrap does internally
515
609
  // (verified against husky ^9.1.7's source: `git config core.hooksPath
@@ -565,7 +659,7 @@ export async function setupHuskyHook(projectPath, { allowInTest = false } = {})
565
659
 
566
660
  if (existsSync(hookPath)) {
567
661
  const existingContent = readFileSync(hookPath, 'utf-8');
568
- if (existingContent.includes('uds check')) {
662
+ if (hookRunsUdsCheck(existingContent)) {
569
663
  console.log(chalk.gray(' ✓ Pre-commit hook already configured'));
570
664
  } else {
571
665
  // Never clobber an adopter's own hook (this fix — it used to be
@@ -574,27 +668,42 @@ export async function setupHuskyHook(projectPath, { allowInTest = false } = {})
574
668
  console.log(chalk.gray(' UDS will not overwrite it. Add "uds check" to it yourself, or remove it and re-run `uds init`.'));
575
669
  }
576
670
  } else {
671
+ // Fail-closed (XSPEC-444 R1 class sweep). This script used to run the linters
672
+ // as `... 2>/dev/null || true` and `uds check 2>/dev/null || true`, then print
673
+ // "Pre-commit checks passed" — it could not block a commit for any reason.
674
+ // Now: a linter that is installed and fails blocks the commit; one that is not
675
+ // installed is skipped. The UDS check is the same block the husky path writes
676
+ // (buildPreCommitBlock): its exit status stops the commit, and a missing CLI
677
+ // says so and blocks rather than being skipped in silence.
577
678
  const hookContent = `#!/bin/sh
578
679
  # UDS pre-commit hook
579
680
  # Auto-generated by uds init
580
681
 
581
682
  echo "Running UDS pre-commit checks..."
582
683
 
583
- # Run lint if available
684
+ # Lint, when the language's linter is installed. A failing linter blocks the commit.
584
685
  if [ -f pyproject.toml ] || [ -f requirements.txt ]; then
585
- python -m ruff check . 2>/dev/null || true
686
+ if python -m ruff --version >/dev/null 2>&1; then
687
+ python -m ruff check . || exit $?
688
+ fi
586
689
  elif [ -f go.mod ]; then
587
- go vet ./... 2>/dev/null || true
690
+ if command -v go >/dev/null 2>&1; then
691
+ go vet ./... || exit $?
692
+ fi
588
693
  elif [ -f Cargo.toml ]; then
589
- cargo clippy 2>/dev/null || true
694
+ if command -v cargo >/dev/null 2>&1; then
695
+ cargo clippy || exit $?
696
+ fi
590
697
  fi
591
698
 
592
- # UDS Standard Check
593
- uds check 2>/dev/null || true
594
-
699
+ ${buildPreCommitBlock({ hookFile: '.git/hooks/pre-commit' })}
595
700
  echo "Pre-commit checks passed"
596
701
  `;
597
702
  writeFileSync(hookPath, hookContent, { mode: 0o755 });
703
+ // Created from nothing (the branch above is "file does not exist"), so the
704
+ // whole file is UDS's — record its hash for `uds uninstall`.
705
+ recordFile(recorder, projectPath, '.git/hooks/pre-commit', RECORD_KINDS.GIT_HOOK);
706
+ persistRecorder(projectPath, recorder);
598
707
  console.log(chalk.green(' ✓ Installed .git/hooks/pre-commit (native git hook)'));
599
708
  }
600
709
  } catch (e) {
@@ -612,9 +721,16 @@ function buildNonInteractiveConfig(options, detected, projectPath) {
612
721
  // CLI --locale > .uds/install.yaml locale: > UDS_LOCALE env > LANG > 'en'
613
722
  // detectLanguage() handles UDS_LOCALE + LANG fallback internally (P1-CLI-3).
614
723
  const installYaml = readInstallYaml(projectPath);
615
- const displayLanguage = options.locale
724
+ const requestedLanguage = options.locale
616
725
  || installYaml.locale
617
726
  || detectLanguage(null);
727
+ // Case-insensitive, and an unsupported value is said out loud instead of silently becoming English
728
+ // (dev-platform XSPEC-451 follow-up: `--locale zh-CN` used to install English with exit 0).
729
+ const { displayLanguage: normalizedLanguage, supported } = normalizeRequestedLocale(requestedLanguage);
730
+ const displayLanguage = supported ? normalizedLanguage : 'en';
731
+ if (!supported) {
732
+ console.log(chalk.yellow(`⚠ Unsupported locale "${requestedLanguage}" — installing in English. Supported: ${Object.keys(LOCALE_MAP_FOR_INIT).join(', ')}.`));
733
+ }
618
734
 
619
735
  // Determine AI tools
620
736
  const detectedAiTools = Object.keys(detected.aiTools).filter(k => detected.aiTools[k]);
@@ -650,30 +766,21 @@ function buildNonInteractiveConfig(options, detected, projectPath) {
650
766
  return Boolean(config?.supportsSkills && config?.skills);
651
767
  });
652
768
  const hasSkillsCompatibleTool = skillsCapableTools.length > 0;
653
- // Marketplace is Claude Code's. A tool reaches it either by having one
654
- // (`supportsMarketplace`) or by reading Claude's directory (`fallbackSkillsPath`).
655
- // ⚠️ Those fallback claims are NOT all verified — `opencode`'s carries the bare
656
- // comment "Can read Claude skills" and no evidence. It is preserved here rather
657
- // than flipped, because changing behaviour on an unverified field in either
658
- // direction is a guess. Codex's identical claim WAS measured, and falsified, so
659
- // its field is now null (see `ai-agent-paths.js`) and it drops out here by data.
660
- // 🔴 The marketplace is all-or-nothing for a repo: it installs into Claude's
661
- // directory, so it serves a tool only if that tool has a marketplace of its own or
662
- // declares Claude's directory as its fallback. If ANY detected tool is not served
663
- // by it, file installs are used instead — every tool then gets its own path, and
664
- // nobody is left with a successful init and an empty directory.
665
- const reachesMarketplace = t => {
666
- const c = getAgentConfig(t);
667
- return Boolean(c?.supportsMarketplace || c?.fallbackSkillsPath);
668
- };
669
- const onlySkillsCompatibleTools =
670
- hasSkillsCompatibleTool && aiToolsNormalized.every(reachesMarketplace);
769
+ // XSPEC-468 R1: with no --skills-location, skills go INTO THE PROJECT (the main path, XSPEC-462).
770
+ // This used to pick 'marketplace' whenever every detected tool could reach Claude's plugin, which left
771
+ // `uds init --yes` with no `.claude/skills/` at all and told a new user to go and install a plugin: the
772
+ // opposite of the recommendation printed by `uds skills`. The plugin is still there for anyone who asks
773
+ // for it by name (`--skills-location marketplace`), and the plugin's limits are printed, not hidden.
774
+ //
775
+ // Two cases keep their old answer, and they are knowledge, not default:
776
+ // - tools were detected and none of them can take skills -> 'none' (nothing to install, said below);
777
+ // - nothing was detected at all -> 'project' with Claude Code's own project folder (the historical
778
+ // guess; see `noToolDetected` below).
779
+ const noToolDetected = aiToolsNormalized.length === 0;
671
780
 
672
781
  let skillsLocationFlag = options.skillsLocation;
673
782
  if (!skillsLocationFlag) {
674
- skillsLocationFlag = hasSkillsCompatibleTool
675
- ? (onlySkillsCompatibleTools ? 'marketplace' : 'project')
676
- : 'none';
783
+ skillsLocationFlag = (noToolDetected || hasSkillsCompatibleTool) ? 'project' : 'none';
677
784
  }
678
785
 
679
786
  // A detected tool that can take skills and is getting none must SAY SO. The worst
@@ -748,6 +855,10 @@ function buildNonInteractiveConfig(options, detected, projectPath) {
748
855
  // `installSkills()` takes its legacy branch, and every tool's skills land in
749
856
  // `.claude/skills/` — see the block above for what that measured.
750
857
  skillsInstallationsForYes = skillsCapableTools.map(agent => ({ agent, level: location }));
858
+ // Nothing detected: name Claude Code's folder explicitly. Leaving the list empty sent the install down
859
+ // the legacy branch of `installSkills()`, which does not take the locale (so `--locale zh-tw` in a
860
+ // project with no tool marker would have installed English and said nothing).
861
+ if (noToolDetected) skillsInstallationsForYes = [{ agent: 'claude-code', level: location }];
751
862
 
752
863
  // 🔴 Detected tools, none of which can take skills, is NOT the same as "no tools
753
864
  // detected". The first is knowledge — install nothing and say why. The second is
@@ -8,6 +8,14 @@ import {
8
8
  import { readManifest, isInitialized } from '../utils/copier.js';
9
9
  import { t, getLanguage, setLanguage, isLanguageExplicitlySet } from '../i18n/messages.js';
10
10
 
11
+ /**
12
+ * The order the listing shows its categories in. A category the registry holds standards for but that is not named
13
+ * here is still listed (after these, under its own key): the "Total" line counts every standard in the registry, so a
14
+ * category that was left out of the display used to make the total larger than the list (82 of 163 standards were
15
+ * counted and never shown, and `--category core` was refused as unknown).
16
+ */
17
+ const CATEGORY_ORDER = ['skill', 'reference', 'core', 'testing', 'security', 'deployment', 'operations', 'extension', 'integration', 'template'];
18
+
11
19
  /**
12
20
  * List command - displays available standards
13
21
  * @param {Object} options - Command options
@@ -44,7 +52,8 @@ export function listCommand(options) {
44
52
  const categoryInfo = getCategoryInfo(category);
45
53
  if (!categoryInfo) {
46
54
  console.log(chalk.red(`${msg.errorUnknownCategory} '${category}'`));
47
- console.log(chalk.gray(msg.validCategories));
55
+ const valid = CATEGORY_ORDER.filter((c) => getCategoryInfo(c));
56
+ console.log(chalk.gray(`${msg.validCategories} ${valid.join(', ')}`));
48
57
  process.exit(1);
49
58
  }
50
59
  standards = getStandardsByCategory(category);
@@ -65,13 +74,13 @@ export function listCommand(options) {
65
74
  }
66
75
 
67
76
  // Display each category
68
- const categoryOrder = ['skill', 'reference', 'extension', 'integration', 'template'];
77
+ const categoryOrder = [...CATEGORY_ORDER, ...Object.keys(grouped).filter((c) => !CATEGORY_ORDER.includes(c))];
69
78
 
70
79
  for (const cat of categoryOrder) {
71
80
  if (!grouped[cat] || grouped[cat].length === 0) continue;
72
81
 
73
82
  const catInfo = getCategoryInfo(cat);
74
- console.log(chalk.yellow.bold(`${catInfo.name} (${grouped[cat].length})`));
83
+ console.log(chalk.yellow.bold(`${catInfo?.name ?? cat} (${grouped[cat].length})`));
75
84
 
76
85
  for (const std of grouped[cat]) {
77
86
  const name = std.skillName
@@ -16,9 +16,8 @@ export function mcpCommand(program) {
16
16
  mcp
17
17
  .command('serve')
18
18
  .description('Start MCP Design Standards Server (stdio transport)')
19
- .option('--root <path>', 'UDS standards root path', process.cwd())
20
- .action((options) => {
21
- const server = new McpServer({ udsRoot: options.root });
19
+ .action(() => {
20
+ const server = new McpServer();
22
21
  server.start();
23
22
  // Log to stderr only — stdout is reserved for MCP JSON-RPC messages
24
23
  process.stderr.write('UDS MCP Design Standards Server started (stdio)\n');
@@ -0,0 +1,123 @@
1
+ /**
2
+ * `uds open-work` — the open-work-tracking reference checks (OWT-017 … OWT-028)
3
+ * as a command, so an adopter can run them from the npm package.
4
+ *
5
+ * This file holds no rules. The one body of them is
6
+ * `../utils/open-work-tracking.mjs`; this only turns commander's parsed
7
+ * arguments back into the argv that module's `main()` reads, so the command and
8
+ * `node scripts/check-open-work-tracking.mjs` cannot disagree.
9
+ *
10
+ * Exit codes are the module's and are not translated: 0 no violation, 1
11
+ * violation, 2 cannot decide (no structure found, git failed, or the checker's
12
+ * own self-test arms failed). 2 is NOT a pass. `process.exitCode` is set rather
13
+ * than calling `process.exit()`, so commander's post-action hook still runs.
14
+ *
15
+ * It is a reference decision procedure offered as evidence (OWT-015), not a
16
+ * gate, and its coverage is unknown and uncalibrated (OWT-011, OWT-016); the
17
+ * module prints both statements on every run.
18
+ *
19
+ * @module commands/open-work
20
+ */
21
+
22
+ import { main } from '../utils/open-work-tracking.mjs';
23
+ import { readOpenWorkDeclarations, rootArguments, wordArguments, commandArguments, fieldWordArguments } from '../core/open-work-config.js';
24
+
25
+ /** Append `--name value` when the option was given. */
26
+ function withOption(argv, name, value) {
27
+ if (value !== undefined && value !== null) argv.push(name, String(value));
28
+ return argv;
29
+ }
30
+
31
+ function run(argv) {
32
+ process.exitCode = main(argv);
33
+ }
34
+
35
+ /**
36
+ * What uds.project.yaml declares for open-work, or null after saying why the command stops.
37
+ * A file that cannot be read at all is a note and the command goes on without it (a project's
38
+ * unrelated YAML problem must not stop a check that never needed the file); a readable file whose
39
+ * open_work section is wrong stops it, because the check would otherwise run without what the
40
+ * project meant to declare and look cleaner than it is.
41
+ */
42
+ function declarationsOrStop() {
43
+ const declared = readOpenWorkDeclarations(process.cwd()); // wire:declarations
44
+ if (declared.note) console.error(`[owt] NOTE: ${declared.note}`);
45
+ if (declared.error) {
46
+ console.error(`[owt] CANNOT DECIDE: ${declared.error}. Exit 2 is not a pass.`);
47
+ process.exitCode = 2;
48
+ return null;
49
+ }
50
+ return declared;
51
+ }
52
+
53
+ /**
54
+ * uds open-work next-action [files...] [--root DIR] [--id-pattern RE] [--next-action-word WORD ...] [--command-word WORD ...] [--now DATE] [--stale-after DAYS] — OWT-019
55
+ * `--now` and `--stale-after` are what the fourth outcome (an asked-awaiting row, XSPEC-464) needs to show an age and to mark it old.
56
+ */
57
+ export function openWorkNextActionCommand(files = [], options = {}) {
58
+ const declared = declarationsOrStop();
59
+ if (!declared) return;
60
+ const argv = ['next-action'];
61
+ withOption(argv, '--root', options.root);
62
+ withOption(argv, '--id-pattern', options.idPattern);
63
+ withOption(argv, '--now', options.now);
64
+ withOption(argv, '--stale-after', options.staleAfter);
65
+ const wordArgv = wordArguments(options.nextActionWord, declared.nextActionWords); // wire:next-action-words
66
+ const commandArgv = commandArguments(options.commandWord, declared.commandWords); // wire:next-action-command-words
67
+ argv.push(...fieldWordArguments('--asked-at-word', options.askedAtWord, declared.askedAtWords)); // wire:next-action-asked-at-words
68
+ argv.push(...fieldWordArguments('--waiting-for-word', options.waitingForWord, declared.waitingForWords));
69
+ process.exitCode = main([...argv, ...wordArgv, ...commandArgv, ...files]); // wire:next-action
70
+ }
71
+
72
+ /** uds open-work revision (--file PATH --base REV | --before FILE --after FILE) — OWT-018 */
73
+ export function openWorkRevisionCommand(options = {}) {
74
+ const argv = ['revision'];
75
+ withOption(argv, '--file', options.file);
76
+ withOption(argv, '--base', options.base);
77
+ withOption(argv, '--before', options.before);
78
+ withOption(argv, '--after', options.after);
79
+ run(argv);
80
+ }
81
+
82
+ /** uds open-work separation [files...] [--next-action-word WORD ...] — OWT-017 */
83
+ export function openWorkSeparationCommand(files = [], options = {}) {
84
+ const declared = declarationsOrStop();
85
+ if (!declared) return;
86
+ const wordArgv = wordArguments(options.nextActionWord, declared.nextActionWords); // wire:separation-words
87
+ process.exitCode = main(['separation', ...wordArgv, ...files]); // wire:separation
88
+ }
89
+
90
+ /**
91
+ * uds open-work waiting [files...] [--root DIR] [--root NAME=DIR ...] [--id-pattern RE] [--now DATE] [--asked-at-word WORD ...] [--waiting-for-word WORD ...] — OWT-020 to OWT-022, OWT-027/028.
92
+ * Calls the imported `main` itself rather than the shared `run()`: the line that carries this
93
+ * command into the checker is then its own, and cutting it silences exactly this command.
94
+ * `--root` repeats: a plain DIR is what relative paths resolve against (as before), NAME=DIR says where
95
+ * another project lives (and uds.project.yaml's open_work.projects says the same, without typing it).
96
+ */
97
+ export function openWorkWaitingCommand(files = [], options = {}) {
98
+ const declared = declarationsOrStop();
99
+ if (!declared) return;
100
+ const argv = ['waiting'];
101
+ const rootArgv = rootArguments(options.root, declared.projects); // wire:roots
102
+ argv.push(...rootArgv);
103
+ withOption(argv, '--id-pattern', options.idPattern);
104
+ withOption(argv, '--now', options.now);
105
+ const commandArgv = commandArguments(options.commandWord, declared.commandWords); // wire:waiting-command-words
106
+ argv.push(...commandArgv);
107
+ argv.push(...fieldWordArguments('--asked-at-word', options.askedAtWord, declared.askedAtWords)); // wire:waiting-asked-at-words
108
+ argv.push(...fieldWordArguments('--waiting-for-word', options.waitingForWord, declared.waitingForWords)); // wire:waiting-waiting-for-words
109
+ process.exitCode = main([...argv, ...files]); // wire:waiting
110
+ }
111
+
112
+ /** uds open-work observations [files...] [--now DATE] [--stale-after DAYS] — OWT-023/024/025/026 (same reason as above) */
113
+ export function openWorkObservationsCommand(files = [], options = {}) {
114
+ const argv = ['observations'];
115
+ withOption(argv, '--now', options.now);
116
+ withOption(argv, '--stale-after', options.staleAfter);
117
+ process.exitCode = main([...argv, ...files]); // wire:observations
118
+ }
119
+
120
+ /** uds open-work self-test — run the checker's own arms and nothing else */
121
+ export function openWorkSelfTestCommand() {
122
+ run(['--self-test']);
123
+ }
@@ -21,6 +21,7 @@
21
21
 
22
22
  import chalk from 'chalk';
23
23
  import { select } from '@inquirer/prompts';
24
+ import { isPromptClosed } from '../utils/prompt-closed.js';
24
25
 
25
26
  export const WORKFLOWS = [
26
27
  {
@@ -64,6 +65,18 @@ export const WORKFLOWS = [
64
65
  },
65
66
  ];
66
67
 
68
+ /** Print one workflow: its name, what it is for, and its numbered commands. */
69
+ function printWorkflow(workflow) {
70
+ console.log(chalk.bold(`\n${workflow.name}\n`));
71
+ console.log(chalk.gray(`${workflow.description}\n`));
72
+
73
+ for (let i = 0; i < workflow.steps.length; i++) {
74
+ const step = workflow.steps[i];
75
+ console.log(` ${chalk.cyan(`${i + 1}.`)} ${chalk.yellow(step.cmd)}`);
76
+ console.log(` ${chalk.gray(step.desc)}\n`);
77
+ }
78
+ }
79
+
67
80
  /**
68
81
  * Execute the quickstart command
69
82
  */
@@ -77,20 +90,23 @@ export async function quickstartCommand() {
77
90
  description: w.description,
78
91
  }));
79
92
 
80
- const selected = await select({
81
- message: 'Which workflow do you want to follow?',
82
- choices,
83
- });
84
-
85
- const workflow = WORKFLOWS[selected];
86
- console.log(chalk.bold(`\n${workflow.name}\n`));
87
- console.log(chalk.gray(`${workflow.description}\n`));
88
-
89
- for (let i = 0; i < workflow.steps.length; i++) {
90
- const step = workflow.steps[i];
91
- console.log(` ${chalk.cyan(`${i + 1}.`)} ${chalk.yellow(step.cmd)}`);
92
- console.log(` ${chalk.gray(step.desc)}\n`);
93
+ let selected;
94
+ try {
95
+ selected = await select({
96
+ message: 'Which workflow do you want to follow?',
97
+ choices,
98
+ });
99
+ } catch (promptError) {
100
+ if (!isPromptClosed(promptError)) throw promptError;
101
+ // Nothing can answer (not a terminal: an AI assistant, CI, a pipe). The guide's whole job is to show the commands, so show all of them
102
+ // rather than a stack trace and an exit code of 0.
103
+ console.log(chalk.gray('Nothing here can answer the question (not a terminal), so every workflow is shown.'));
104
+ for (const workflow of WORKFLOWS) printWorkflow(workflow);
105
+ console.log(chalk.gray('Tip: Run "uds quickstart" in a terminal to pick one workflow.\n'));
106
+ return;
93
107
  }
94
108
 
109
+ printWorkflow(WORKFLOWS[selected]);
110
+
95
111
  console.log(chalk.gray('Tip: Run each command in order. Use "uds quickstart" anytime to see this guide again.\n'));
96
112
  }