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

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 +10 -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 +92 -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
@@ -11,6 +11,7 @@
11
11
  * adopters (asiaostrich-telemetry-server, asiaostrich-telemetry-client,
12
12
  * machine-setup): all three have `.husky/pre-commit` calling `npx uds check`,
13
13
  * none has `core.hooksPath` set, and the hook has never once run.
14
+ * (That `npx uds check` form was itself replaced — see buildPreCommitBlock.)
14
15
  *
15
16
  * Fix: set `core.hooksPath` directly ourselves. This is exactly what husky's
16
17
  * own `index.js` does internally (verified against husky ^9.1.7's source:
@@ -94,7 +95,7 @@ export function wireGitHooksPath(projectPath, targetRelDir) {
94
95
  return {
95
96
  wired: false,
96
97
  reason: `git core.hooksPath is already set to "${configured}"`,
97
- hint: `UDS will not override an existing core.hooksPath. Confirm the hook script there also runs \`npx uds check\`, or switch it yourself: git config --local core.hooksPath ${targetRelDir}`
98
+ hint: `UDS will not override an existing core.hooksPath. Confirm the hook script there also runs \`universal-dev-standards check\` (the installed CLI — not the short name "uds", which on the npm registry is an unrelated package), or switch it yourself: git config --local core.hooksPath ${targetRelDir}`
98
99
  };
99
100
  }
100
101
 
@@ -107,7 +108,7 @@ export function wireGitHooksPath(projectPath, targetRelDir) {
107
108
  return {
108
109
  wired: false,
109
110
  reason: '.git/hooks/pre-commit already exists',
110
- hint: 'UDS will not overwrite or bypass an existing .git/hooks/pre-commit. Add "npx uds check" to it manually, or remove it and re-run `uds init`.'
111
+ hint: 'UDS will not overwrite or bypass an existing .git/hooks/pre-commit. Add a "universal-dev-standards check" line to it manually (it needs the UDS CLI installed in this project or on PATH), or remove it and re-run `uds init`.'
111
112
  };
112
113
  }
113
114
 
@@ -126,10 +127,133 @@ export function wireGitHooksPath(projectPath, targetRelDir) {
126
127
  }
127
128
  }
128
129
 
129
- /** Does `filePath` contain the marker UDS writes into a hook it manages? */
130
+ // ─────────────────────────────────────────────────────────────────────────────
131
+ // What UDS writes into `.husky/pre-commit`.
132
+ //
133
+ // 🔴 This used to be the single line `npx uds check`. `npx` resolves a bare
134
+ // command name from node_modules/.bin and PATH first, and only when neither has
135
+ // it does it go to the npm registry — and the registry package named `uds` is
136
+ // NOT this project (it is an unrelated package by another maintainer, no
137
+ // `bin`, last published 2022). So a clone with no UDS installed had a commit
138
+ // hook that asked npm for a stranger's package by name. It failed today only
139
+ // because that package has no executable; the day its owner publishes one with a
140
+ // `uds` bin, every adopter's every commit runs the stranger's code.
141
+ //
142
+ // Measured 2026-09-30 against a local fake registry that logs each request
143
+ // (npm 10.9.9, 11.20.0, 12.1.0 — identical): `npx --no-install uds` STILL fetches
144
+ // the package metadata for `uds` (GET /uds), so `--no-install` is not a fix; and
145
+ // `npx --no-install --package=universal-dev-standards uds` does not find a
146
+ // GLOBAL install at all (it goes to the registry for our own name and fails).
147
+ // Neither is usable, so the hook does not involve npm at all: it looks in this
148
+ // project's node_modules/.bin, then on PATH, and it looks for the bin named
149
+ // after the full package name — `universal-dev-standards` is a name only this
150
+ // project can publish, `uds` is a name anyone's package can also claim.
151
+ // ─────────────────────────────────────────────────────────────────────────────
152
+
153
+ /** First line of the block UDS writes (also the marker older UDS versions wrote). */
154
+ export const UDS_HOOK_MARKER = '# UDS Standard Check';
155
+ /** Last line of the block — lets uninstall remove the whole block, not guess line by line. */
156
+ export const UDS_HOOK_END_MARKER = '# End UDS Standard Check';
157
+ /** The bin every UDS release has shipped since the rename; named after the package on purpose. */
158
+ export const UDS_BIN_NAME = 'universal-dev-standards';
159
+ /** A hook line that runs the UDS check — the old short form or the current full-name form. */
160
+ export const UDS_CHECK_COMMAND_RE = /\b(?:uds|universal-dev-standards)\s+check\b/;
161
+
162
+ /**
163
+ * Any place a hook script runs the bare name `uds` through a package runner
164
+ * (npx, bunx, pnpm dlx, yarn dlx, npm exec ...). Broader than the two exact lines UDS
165
+ * ever wrote (see legacy-hook-migration.js): this finds lines to TELL the
166
+ * adopter about, not lines UDS may change.
167
+ */
168
+ export const BARE_UDS_RUNNER_RE = /\b(?:npx|bunx|pnpx|pnpm\s+dlx|yarn\s+dlx|npm\s+exec|npm\s+x)\s+(?:-\S+\s+)*uds\b/;
169
+
170
+ /** Does this hook script still run the bare name `uds` through a package runner? */
171
+ export function hasBareUdsRunner(content) {
172
+ return typeof content === 'string' && content.split('\n').some((l) => BARE_UDS_RUNNER_RE.test(l));
173
+ }
174
+
175
+ /** Does hook script `content` run the UDS check, in either the old or the current form? */
176
+ export function hookRunsUdsCheck(content) {
177
+ return typeof content === 'string' && UDS_CHECK_COMMAND_RE.test(content);
178
+ }
179
+
180
+ /**
181
+ * The block `uds init` appends to `.husky/pre-commit` (and `uds update` swaps in
182
+ * for the old one-liner). POSIX sh; runs in git-bash on Windows.
183
+ *
184
+ * - The subshell keeps the PATH change from leaking into the adopter's own
185
+ * commands in the same hook file.
186
+ * - `|| exit $?` makes both outcomes stop the commit even when the adopter has
187
+ * put more commands after this block. Without it the "not installed" branch
188
+ * would be a silent skip of the check, which is what this must never be.
189
+ * - Not installed: say what is missing and how to fix it, exit non-zero. It
190
+ * neither skips the check nor downloads anything.
191
+ *
192
+ * @param {{args?: string, hookFile?: string}} [opts]
193
+ * args — extra arguments to keep on the check command
194
+ * (e.g. `--standard checkin-standards`, which older UDS versions wrote).
195
+ * hookFile — the file the block is written into, named in the "blocked" message so
196
+ * it points at the file the adopter actually has (default `.husky/pre-commit`;
197
+ * the native hook passes `.git/hooks/pre-commit`).
198
+ * @returns {string} the block, LF line endings, ending with a newline
199
+ */
200
+ export function buildPreCommitBlock({ args = '', hookFile = '.husky/pre-commit' } = {}) {
201
+ const cmd = args ? `${UDS_BIN_NAME} check ${args}` : `${UDS_BIN_NAME} check`;
202
+ return [
203
+ UDS_HOOK_MARKER,
204
+ '# Runs the UDS CLI installed in this project (node_modules/.bin) or on PATH.',
205
+ '# It never asks npm to fetch anything: the short name "uds" on the npm registry',
206
+ '# belongs to an unrelated package, and npx would download and run it.',
207
+ '(',
208
+ ' PATH="$PWD/node_modules/.bin:$PATH"',
209
+ ` if command -v ${UDS_BIN_NAME} >/dev/null 2>&1; then`,
210
+ ` ${cmd}`,
211
+ ' exit $?',
212
+ ' fi',
213
+ ` echo "[UDS] Pre-commit check cannot run: the UDS CLI (${UDS_BIN_NAME}) is not installed." >&2`,
214
+ ` echo "[UDS] Install it: npm install --save-dev ${UDS_BIN_NAME} (or: npm install -g ${UDS_BIN_NAME})" >&2`,
215
+ ` echo "[UDS] This commit is blocked until it is installed, or until you remove this block from ${hookFile}." >&2`,
216
+ ' exit 1',
217
+ ') || exit $?',
218
+ UDS_HOOK_END_MARKER,
219
+ ''
220
+ ].join('\n');
221
+ }
222
+
223
+ /**
224
+ * Remove the block buildPreCommitBlock() writes — from the marker line through
225
+ * the end-marker line, inclusive — and nothing else. A block whose end marker is
226
+ * gone (the adopter cut into it) is left alone: what remains of it is no longer
227
+ * provably UDS's, and the caller's line-level fallback deals with the lines it can name.
228
+ * @returns {{content: string, removed: boolean}}
229
+ */
230
+ export function stripUdsHookBlock(content) {
231
+ const lines = content.split('\n');
232
+ const out = [];
233
+ let removed = false;
234
+ for (let i = 0; i < lines.length; i++) {
235
+ if (lines[i].trim() === UDS_HOOK_MARKER) {
236
+ let end = -1;
237
+ for (let j = i + 1; j < lines.length; j++) {
238
+ if (lines[j].trim() === UDS_HOOK_END_MARKER) { end = j; break; }
239
+ // Another marker before an end marker means this block is not well-formed.
240
+ if (lines[j].trim() === UDS_HOOK_MARKER) break;
241
+ }
242
+ if (end !== -1) {
243
+ i = end;
244
+ removed = true;
245
+ continue;
246
+ }
247
+ }
248
+ out.push(lines[i]);
249
+ }
250
+ return { content: out.join('\n'), removed };
251
+ }
252
+
253
+ /** Does `filePath` contain a hook line UDS manages (the old one-liner or the current block)? */
130
254
  function hasUdsMarker(filePath) {
131
255
  try {
132
- return readFileSync(filePath, 'utf-8').includes('uds check');
256
+ return hookRunsUdsCheck(readFileSync(filePath, 'utf-8'));
133
257
  } catch {
134
258
  return false;
135
259
  }
@@ -225,7 +349,7 @@ export function stripLegacyHuskyShLine(content) {
225
349
  * @param {string} projectPath
226
350
  * @returns {{relevant: boolean, wired?: boolean, hookFile?: string,
227
351
  * configuredHooksPath?: string|null, effectiveHooksDir?: string|null,
228
- * legacyV8?: boolean, missingShebang?: boolean}}
352
+ * legacyV8?: boolean, missingShebang?: boolean, legacyBareUds?: boolean}}
229
353
  * `relevant: false` means there is nothing UDS-managed to report on (no
230
354
  * hook file, or hooks-dir could not be determined — never guess "unwired"
231
355
  * from a failed lookup).
@@ -252,6 +376,13 @@ export function checkPreCommitHookWiring(projectPath) {
252
376
  try { return !hasShebang(readFileSync(managedPath, 'utf-8')); } catch { return false; }
253
377
  })();
254
378
 
379
+ // Independent of wiring, like missingShebang: the file can be wired and still ask
380
+ // npm for the bare name `uds` (see buildPreCommitBlock). Only the husky file is
381
+ // examined — that is the one UDS wrote the old one-liner into.
382
+ const legacyBareUds = hasHuskyHook && (() => {
383
+ try { return hasBareUdsRunner(readFileSync(huskyHookPath, 'utf-8')); } catch { return false; }
384
+ })();
385
+
255
386
  const effectiveFile = join(effectiveHooksDir, 'pre-commit');
256
387
  let wired = false;
257
388
  if (existsSync(effectiveFile)) {
@@ -264,7 +395,7 @@ export function checkPreCommitHookWiring(projectPath) {
264
395
  }
265
396
  }
266
397
 
267
- if (wired) return { relevant: true, wired: true, hookFile, missingShebang };
398
+ if (wired) return { relevant: true, wired: true, hookFile, missingShebang, legacyBareUds };
268
399
 
269
400
  const legacyV8 = hasHuskyHook && (() => {
270
401
  try { return hasLegacyHuskyShLine(readFileSync(huskyHookPath, 'utf-8')); } catch { return false; }
@@ -277,6 +408,7 @@ export function checkPreCommitHookWiring(projectPath) {
277
408
  configuredHooksPath: getLocalHooksPathConfig(projectPath),
278
409
  effectiveHooksDir,
279
410
  legacyV8,
280
- missingShebang
411
+ missingShebang,
412
+ legacyBareUds
281
413
  };
282
414
  }
@@ -532,6 +532,42 @@ export function computeIntegrationBlockHash(filePath) {
532
532
  }
533
533
  }
534
534
 
535
+ /**
536
+ * Hash everything in an integration file that is OUTSIDE the UDS marker block.
537
+ *
538
+ * `computeIntegrationBlockHash` answers "did anyone edit what UDS manages?".
539
+ * This answers the opposite question, which `uds uninstall` needs: "is anything
540
+ * outside the block something other than what UDS itself wrote?". A file UDS
541
+ * created from nothing (AGENTS.md's `# AGENTS.md` / `> Auto-generated by ...`
542
+ * header and its trailing sections, CLAUDE.md's leading guidance) has plenty of
543
+ * text outside the markers, and that text alone cannot tell "generated by UDS"
544
+ * from "typed by the adopter" — only a hash recorded when UDS created the file,
545
+ * compared with the same hash now, can.
546
+ *
547
+ * Line endings are normalized (same reason as every other hash here) and each
548
+ * side is trimmed, so an editor adding a trailing newline is not "a user edit".
549
+ *
550
+ * @param {string} filePath - Absolute file path
551
+ * @returns {{hash: string, size: number}|null} null when the file cannot be read,
552
+ * has no marker block, or has an ambiguous marker pair (no proof is available)
553
+ */
554
+ export function computeOutsideBlockHash(filePath) {
555
+ try {
556
+ const content = normalizeLineEndings(readFileSync(filePath, 'utf-8'));
557
+ const { before, blockContent, after } = extractBlockContent(content, detectFormat(filePath));
558
+ if (!blockContent) return null;
559
+ const outside = `${before.trim()}\n\u0000\n${after.trim()}`;
560
+ return {
561
+ hash: `sha256:${createHash('sha256').update(outside).digest('hex')}`,
562
+ size: Buffer.byteLength(outside, 'utf-8')
563
+ };
564
+ } catch {
565
+ // Includes AmbiguousMarkerError: with two marker pairs there is no single
566
+ // "outside", so there is nothing to prove anything with.
567
+ return null;
568
+ }
569
+ }
570
+
535
571
  /**
536
572
  * Compare integration block hash with stored hash info
537
573
  * @param {string} filePath - Absolute file path
@@ -177,20 +177,26 @@ export function calculateConsistency(projectPath) {
177
177
  }
178
178
 
179
179
  /**
180
- * Calculate coverage score
180
+ * Calculate coverage score — how many of the two check scripts each installed standard can
181
+ * have (`scripts/check-<id>.sh`, `scripts/check-<id>-sync.sh`) are present.
182
+ *
183
+ * XSPEC-444 R5: this used to report `details.has_tests` and add it into the sum, but
184
+ * `hasTests` was declared as 0 and never incremented anywhere — a number that was always 0 and
185
+ * looked like a measurement of whether the standards have tests. It is removed rather than
186
+ * faked. The SCORE is unchanged: the denominator was already two per standard, which is the
187
+ * two script kinds above, so no project's coverage score moves.
181
188
  * @param {string} projectPath
182
189
  * @param {string[]} standardIds
183
190
  * @returns {{ score: number, details: object }}
184
191
  */
185
192
  export function calculateCoverage(projectPath, standardIds) {
186
193
  if (!standardIds || standardIds.length === 0) {
187
- return { score: 0, details: { has_check_script: 0, has_tests: 0, total: 0 } };
194
+ return { score: 0, details: { has_check_script: 0, total: 0 } };
188
195
  }
189
196
 
190
197
  // Check for check scripts matching standard names
191
198
  const scriptsDir = join(projectPath, 'scripts');
192
199
  let hasCheckScript = 0;
193
- let hasTests = 0;
194
200
 
195
201
  for (const id of standardIds) {
196
202
  const scriptName = `check-${id}.sh`;
@@ -204,16 +210,13 @@ export function calculateCoverage(projectPath, standardIds) {
204
210
  }
205
211
  }
206
212
 
207
- const ratio = standardIds.length > 0
208
- ? (hasCheckScript + hasTests) / (standardIds.length * 2)
209
- : 0;
213
+ const ratio = hasCheckScript / (standardIds.length * 2);
210
214
  const score = Math.round(Math.min(ratio * 100, 100));
211
215
 
212
216
  return {
213
217
  score,
214
218
  details: {
215
219
  has_check_script: hasCheckScript,
216
- has_tests: hasTests,
217
220
  total: standardIds.length
218
221
  }
219
222
  };
@@ -0,0 +1,114 @@
1
+ /**
2
+ * Which names in `manifest.skills.names` / `manifest.commands.names` UDS can still vouch for.
3
+ * // implements XSPEC-456 R4
4
+ *
5
+ * XSPEC-454 R2 cleaned `skillHashes` and `commandHashes` and left these two lists alone, on the
6
+ * reasoning that an over-long list is harmless. It is not: after `uds update --apply --skills` removed
7
+ * the `_shared`, `agents`, `ai`, `tools` and `workflows` folders an old CLI had copied into the skills
8
+ * folder, the manifest still listed all five as installed skills (61 names for 56 skills), which
9
+ * contradicted both the disk and the release notes' claim that the records were cleaned.
10
+ *
11
+ * The rule is the one XSPEC-454 R2 uses for the hash records: **what UDS can vouch for stays**.
12
+ * - a skill (command) name stays only if UDS ships a skill (command) of that name;
13
+ * - when asked to (`checkDisk`), only if it is also present in one of the places the manifest says
14
+ * it was installed. That second test is skipped when it cannot be made (no install location
15
+ * recorded, or none of the recorded folders exists): a name list is never emptied because the
16
+ * tool could not find where to look.
17
+ *
18
+ * Every manifest field that records skill or command NAMES, and what handles it:
19
+ * skills.names -> this module (skills)
20
+ * commands.names -> this module (commands)
21
+ * skillHashes -> utils/skill-hash-ownership.js (XSPEC-454 R2; the name is the 3rd path segment)
22
+ * commandHashes -> utils/command-hash-ownership.js (XSPEC-454 R2; the name is the file stem)
23
+ * `skills.installations` / `commands.installations` record tools and levels, not names, and
24
+ * `installedArtifacts` records only integration files and created directories.
25
+ *
26
+ * @module utils/installed-names-ownership
27
+ */
28
+
29
+ import { existsSync } from 'fs';
30
+ import { join } from 'path';
31
+ import { getAvailableSkillNames, getAvailableCommandNames } from './skills-installer.js';
32
+ import { MARKETPLACE_NAMES_SENTINEL } from '../core/marketplace-sentinel.js';
33
+ import { getSkillsDirForAgent, getCommandsDirForAgent, getCommandFileExtension } from '../config/ai-agent-paths.js';
34
+
35
+ /** Below these sizes the source tree did not load; never read that as "UDS ships nothing". */
36
+ const MIN_SHIPPED = 10;
37
+
38
+ /** `{ agent, level }` for every recorded installation (strings are legacy project-level entries). */
39
+ function installationsOf(section) {
40
+ return (section?.installations || [])
41
+ .map((entry) => (typeof entry === 'string'
42
+ ? { agent: entry, level: 'project' }
43
+ : { agent: entry?.agent, level: entry?.level || 'project' }))
44
+ .filter((entry) => entry.agent);
45
+ }
46
+
47
+ /** Folders a skill of the recorded installations would live in. Empty when the manifest does not say. */
48
+ function skillFolders(manifest, projectPath) {
49
+ const dirs = installationsOf(manifest.skills)
50
+ .map(({ agent, level }) => getSkillsDirForAgent(agent, level, projectPath))
51
+ .filter(Boolean);
52
+ if (dirs.length > 0) return dirs;
53
+ // A legacy manifest records no installations, only where the skills went.
54
+ const location = manifest.skills?.location;
55
+ if (location === 'project' || location === 'user') {
56
+ const dir = getSkillsDirForAgent('claude-code', location, projectPath);
57
+ return dir ? [dir] : [];
58
+ }
59
+ return [];
60
+ }
61
+
62
+ /** `[folder, extension]` pairs where a command of the recorded installations would live. */
63
+ function commandFolders(manifest, projectPath) {
64
+ return installationsOf(manifest.commands)
65
+ .map(({ agent, level }) => [getCommandsDirForAgent(agent, level, projectPath), getCommandFileExtension(agent)])
66
+ .filter(([dir]) => Boolean(dir));
67
+ }
68
+
69
+ function prune(names, keep) {
70
+ const kept = [];
71
+ const dropped = [];
72
+ for (const name of names) (keep(name) ? kept : dropped).push(name);
73
+ return { kept, dropped: dropped.sort() };
74
+ }
75
+
76
+ /**
77
+ * Drop the names in `manifest.skills.names` that UDS cannot vouch for. Mutates `manifest`.
78
+ *
79
+ * @param {Object} manifest
80
+ * @param {string} projectPath
81
+ * @param {Object} [options]
82
+ * @param {boolean} [options.checkDisk=false] - also require the skill to be present where it was installed
83
+ * @param {Set<string>} [options.shipped] - Injection point for tests; defaults to the skills this CLI ships
84
+ * @returns {string[]} The names dropped, sorted
85
+ */
86
+ export function pruneForeignSkillNames(manifest, projectPath, { checkDisk = false, shipped = new Set(getAvailableSkillNames()) } = {}) {
87
+ const names = manifest?.skills?.names;
88
+ if (!Array.isArray(names) || shipped.size < MIN_SHIPPED) return [];
89
+ // Marketplace installs record a sentinel instead of names; there is nothing to prune.
90
+ if (names.includes(MARKETPLACE_NAMES_SENTINEL)) return [];
91
+
92
+ const dirs = checkDisk ? skillFolders(manifest, projectPath) : [];
93
+ const diskTestPossible = dirs.some((dir) => existsSync(dir));
94
+ const { kept, dropped } = prune(names, (name) =>
95
+ shipped.has(name) && (!diskTestPossible || dirs.some((dir) => existsSync(join(dir, name)))));
96
+ if (dropped.length > 0) manifest.skills.names = kept;
97
+ return dropped;
98
+ }
99
+
100
+ /**
101
+ * Drop the names in `manifest.commands.names` that UDS cannot vouch for. Mutates `manifest`.
102
+ * Same contract as {@link pruneForeignSkillNames}.
103
+ */
104
+ export function pruneForeignCommandNames(manifest, projectPath, { checkDisk = false, shipped = new Set(getAvailableCommandNames()) } = {}) {
105
+ const names = manifest?.commands?.names;
106
+ if (!Array.isArray(names) || shipped.size < MIN_SHIPPED) return [];
107
+
108
+ const places = checkDisk ? commandFolders(manifest, projectPath) : [];
109
+ const diskTestPossible = places.some(([dir]) => existsSync(dir));
110
+ const { kept, dropped } = prune(names, (name) =>
111
+ shipped.has(name) && (!diskTestPossible || places.some(([dir, ext]) => existsSync(join(dir, `${name}${ext}`)))));
112
+ if (dropped.length > 0) manifest.commands.names = kept;
113
+ return dropped;
114
+ }
@@ -172,20 +172,22 @@ const COMMIT_TYPE_TEMPLATES = {
172
172
  format: '<type>(<scope>): <subject>',
173
173
  formatNote: 'English types for maximum tool compatibility'
174
174
  },
175
+ // XSPEC-475 OQ1: English types, Traditional Chinese subject. It used to list Chinese types (功能, 修正, ...), which the
176
+ // commit-message simulator could not read and no adopter's commitlint type-enum allowed.
175
177
  'traditional-chinese': {
176
178
  types: [
177
- { type: '功能', english: 'feat', description: '新功能', example: '功能(認證): 新增 OAuth2 登入' },
178
- { type: '修正', english: 'fix', description: '錯誤修正', example: '修正(api): 處理空值回應' },
179
- { type: '文件', english: 'docs', description: '文件更新', example: '文件(readme): 更新安裝指南' },
180
- { type: '樣式', english: 'style', description: '格式調整', example: '樣式(lint): 修正縮排' },
181
- { type: '重構', english: 'refactor', description: '程式碼重構', example: '重構(user): 抽取驗證邏輯' },
182
- { type: '測試', english: 'test', description: '測試相關', example: '測試(cart): 新增結帳測試' },
183
- { type: '雜項', english: 'chore', description: '維護任務', example: '雜項(deps): 更新套件' },
184
- { type: '效能', english: 'perf', description: '效能改善', example: '效能(query): 優化資料庫查詢' },
185
- { type: '整合', english: 'ci', description: '持續整合', example: '整合(github): 新增部署流程' }
179
+ { type: 'feat', description: '新功能', example: 'feat(auth): 新增 OAuth2 登入' },
180
+ { type: 'fix', description: '錯誤修正', example: 'fix(api): 處理空值回應' },
181
+ { type: 'docs', description: '文件更新', example: 'docs(readme): 更新安裝指南' },
182
+ { type: 'style', description: '格式調整', example: 'style(lint): 修正縮排' },
183
+ { type: 'refactor', description: '程式碼重構', example: 'refactor(user): 抽取驗證邏輯' },
184
+ { type: 'test', description: '測試相關', example: 'test(cart): 新增結帳測試' },
185
+ { type: 'chore', description: '維護任務', example: 'chore(deps): 更新套件' },
186
+ { type: 'perf', description: '效能改善', example: 'perf(query): 優化資料庫查詢' },
187
+ { type: 'ci', description: '持續整合', example: 'ci(github): 新增部署流程' }
186
188
  ],
187
- format: '<類型>(<範圍>): <主旨>',
188
- formatNote: '類型使用中文,範圍可使用英文或中文'
189
+ format: '<type>(<scope>): <主旨>',
190
+ formatNote: '類型使用英文(與 english 選項相同,不可用中文類型),主旨與本文使用繁體中文,範圍可使用英文或中文'
189
191
  },
190
192
  bilingual: {
191
193
  types: [
@@ -233,10 +235,10 @@ function generateCommitTypesTable(outputLanguage, format = 'markdown') {
233
235
 
234
236
  if (format === 'markdown') {
235
237
  if (outputLanguage === 'traditional-chinese') {
236
- lines.push('| 類型 | 英文對照 | 說明 | 範例 |');
237
- lines.push('|------|----------|------|------|');
238
+ lines.push('| 類型 | 說明 | 範例 |');
239
+ lines.push('|------|------|------|');
238
240
  for (const t of template.types) {
239
- lines.push(`| \`${t.type}\` | ${t.english} | ${t.description} | ${t.example} |`);
241
+ lines.push(`| \`${t.type}\` | ${t.description} | ${t.example} |`);
240
242
  }
241
243
  } else if (outputLanguage === 'bilingual') {
242
244
  lines.push('| Type | EN Description | 中文說明 | Example |');
@@ -263,7 +265,7 @@ function generateCommitTypesTable(outputLanguage, format = 'markdown') {
263
265
  // Plaintext format
264
266
  if (outputLanguage === 'traditional-chinese') {
265
267
  for (const t of template.types) {
266
- lines.push(`- ${t.type} (${t.english}): ${t.description}`);
268
+ lines.push(`- ${t.type}: ${t.description}`);
267
269
  }
268
270
  } else if (outputLanguage === 'bilingual' || outputLanguage === 'bilingual-zhcn') {
269
271
  for (const t of template.types) {
@@ -2625,12 +2627,12 @@ function generateOutputLanguageDirective(outputLanguage, language) {
2625
2627
 
2626
2628
  if (outputLanguage === 'traditional-chinese') {
2627
2629
  if (language === 'zh-tw') {
2628
- return '## 提交訊息語言\n所有提交訊息必須使用**繁體中文**撰寫。\n格式:`<類型>(<範圍>): <主旨>`';
2630
+ return '## 提交訊息語言\n所有提交訊息的主旨與本文必須使用**繁體中文**撰寫;類型維持英文(feat、fix、docs 等)。\n格式:`<type>(<scope>): <主旨>`';
2629
2631
  }
2630
2632
  if (language === 'zh-cn') {
2631
- return '## 提交消息语言\n所有提交消息必须使用**繁体中文**撰写。\n格式:`<类型>(<范围>): <主旨>`';
2633
+ return '## 提交消息语言\n所有提交消息的主旨与正文必须使用**繁体中文**撰写;类型保持英文(feat、fix、docs 等)。\n格式:`<type>(<scope>): <主旨>`';
2632
2634
  }
2633
- return '## Commit Message Language\nWrite all commit messages in **Traditional Chinese (繁體中文)**.\nFormat: `<類型>(<範圍>): <主旨>`';
2635
+ return '## Commit Message Language\nWrite the subject and body of all commit messages in **Traditional Chinese (繁體中文)**; keep the type English (feat, fix, docs, ...).\nFormat: `<type>(<scope>): <主旨>`';
2634
2636
  }
2635
2637
 
2636
2638
  if (outputLanguage === 'simplified-chinese') {
@@ -3202,8 +3204,14 @@ export function writeIntegrationFile(tool, config, projectPath) {
3202
3204
  try {
3203
3205
  let content = generateIntegrationContent({ ...config, tool });
3204
3206
 
3207
+ // Whether this call CREATES the file (as opposed to merging into one that was
3208
+ // already there). Only a file UDS created from nothing can later be proven
3209
+ // to be wholly UDS's — see core/install-records.js. Taken from the existence
3210
+ // check that already gates the merge below, before anything is written.
3211
+ const created = !existsSync(filePath);
3212
+
3205
3213
  // Handle merge if file exists
3206
- if (existsSync(filePath)) {
3214
+ if (!created) {
3207
3215
  const existingContent = readFileSync(filePath, 'utf-8');
3208
3216
 
3209
3217
  if (config.mergeStrategy) {
@@ -3242,6 +3250,7 @@ export function writeIntegrationFile(tool, config, projectPath) {
3242
3250
  success: true,
3243
3251
  path: fileName, // Return relative path for consistency
3244
3252
  absolutePath: filePath,
3253
+ created,
3245
3254
  blockHashInfo // Contains: blockHash, blockSize, fullHash, fullSize
3246
3255
  };
3247
3256
  } catch (error) {
@@ -3584,8 +3593,8 @@ export function parseStandardsIndexCount(content) {
3584
3593
  export function wrapWithMarkers(content, format) {
3585
3594
  const markers = UDS_MARKERS[format] || UDS_MARKERS.markdown;
3586
3595
  const warning = format === 'plaintext'
3587
- ? '# WARNING: This block is managed by UDS (universal-dev-standards). DO NOT manually edit. Use \'npx uds init\' or \'npx uds update\' to modify.'
3588
- : '<!-- WARNING: This block is managed by UDS (universal-dev-standards). DO NOT manually edit. Use \'npx uds init\' or \'npx uds update\' to modify. -->';
3596
+ ? '# WARNING: This block is managed by UDS. DO NOT manually edit. Use \'npx universal-dev-standards init\' or \'npx universal-dev-standards update\' to modify.'
3597
+ : '<!-- WARNING: This block is managed by UDS. DO NOT manually edit. Use \'npx universal-dev-standards init\' or \'npx universal-dev-standards update\' to modify. -->';
3589
3598
  // 冪等:warning 位於 markers **內部**,而 extractMarkedContent 取出的內容也含它,
3590
3599
  // 於是重新包裝會疊出第二份(dev-platform CLAUDE.md 實測 178/179 兩行完全相同)。
3591
3600
  // 這裡先剝掉內容開頭既有的 warning,不論上游哪條路徑造成都能修掉。
@@ -3949,7 +3958,7 @@ export function generateAgentsMdSummary(config = {}) {
3949
3958
  blockLines.push(`- \`${dir}/${filename}\` — ${filename.replace(suffix, '')}`);
3950
3959
  }
3951
3960
  } else {
3952
- blockLines.push('No standards installed yet. Run `npx uds init` to install.');
3961
+ blockLines.push('No standards installed yet. Run `npx universal-dev-standards init` to install.');
3953
3962
  }
3954
3963
 
3955
3964
  lines.push(wrapWithMarkers(blockLines.join('\n'), 'markdown'));
@@ -3976,12 +3985,14 @@ export function generateAgentsMdSummary(config = {}) {
3976
3985
  */
3977
3986
  export function writeAgentsMdSummary(config, projectPath) {
3978
3987
  const filePath = join(projectPath, 'AGENTS.md');
3979
-
3980
3988
  try {
3981
3989
  let content = generateAgentsMdSummary({ ...config, projectPath });
3982
3990
 
3991
+ // See writeIntegrationFile: true only when this call creates the file.
3992
+ const created = !existsSync(filePath);
3993
+
3983
3994
  // Handle merge if file exists (preserve user content outside markers)
3984
- if (existsSync(filePath)) {
3995
+ if (!created) {
3985
3996
  const existingContent = readFileSync(filePath, 'utf-8');
3986
3997
  const newParts = extractMarkedContent(content, 'markdown');
3987
3998
  if (newParts.content) {
@@ -3997,6 +4008,7 @@ export function writeAgentsMdSummary(config, projectPath) {
3997
4008
  success: true,
3998
4009
  path: 'AGENTS.md',
3999
4010
  absolutePath: filePath,
4011
+ created,
4000
4012
  blockHashInfo
4001
4013
  };
4002
4014
  } catch (error) {
@@ -0,0 +1,112 @@
1
+ /**
2
+ * Migrate the pre-commit hook line older UDS versions wrote
3
+ * (`npx uds check`) to the block current UDS writes.
4
+ *
5
+ * Why it exists: every adopter who ran `uds init` before this fix has
6
+ * `.husky/pre-commit` asking `npx` to run the bare name `uds`. `npx` looks in
7
+ * node_modules/.bin and PATH first and otherwise asks the npm registry — where
8
+ * `uds` is an unrelated package that is not ours (see buildPreCommitBlock in
9
+ * git-hooks.js for the measurements). Fixing what `uds init` writes today does
10
+ * nothing for the hooks already on disk, so `uds update` swaps them.
11
+ *
12
+ * ⚠️ THIS FILE RECOGNISES the old text; it must never EMIT it. The regression
13
+ * guard (tests/unit/no-bare-uds-npx.test.js) lists this file as the one place
14
+ * a bare-name npx string is allowed, and says why. Nothing here may write one.
15
+ *
16
+ * What counts as "UDS wrote this line" — exact equality, not a pattern:
17
+ * only the two shapes UDS has ever generated, and only directly under the
18
+ * marker comment UDS put above them.
19
+ * 2026-02-04 .. 2026-03-04 npx uds check --standard checkin-standards
20
+ * 2026-03-04 .. this fix npx uds check
21
+ * (from `git log -S` on the writer in cli/src/commands/init.js.) A line an
22
+ * adopter edited, or wrote themselves, is NOT swapped: it cannot be proven to be
23
+ * ours, and a hook that runs the adopter's own arguments is theirs to change.
24
+ * It is reported, with the exact line number and what to write instead.
25
+ *
26
+ * @module utils/legacy-hook-migration
27
+ */
28
+
29
+ import { existsSync, readFileSync, writeFileSync } from 'fs';
30
+ import { join } from 'path';
31
+ import { buildPreCommitBlock, UDS_HOOK_MARKER, BARE_UDS_RUNNER_RE, hasBareUdsRunner } from './git-hooks.js';
32
+ import { getFileRecord, proveUnchanged, recordFile, newRecorder, RECORD_KINDS } from '../core/install-records.js';
33
+
34
+ /** The exact command lines UDS itself has written under the marker, and the extra arguments each carried. */
35
+ const UDS_WRITTEN_LEGACY_LINES = new Map([
36
+ ['npx uds check', ''],
37
+ ['npx uds check --standard checkin-standards', '--standard checkin-standards']
38
+ ]);
39
+
40
+ /**
41
+ * Swap the legacy hook line UDS wrote in `.husky/pre-commit` for the current block.
42
+ *
43
+ * @param {string} projectPath
44
+ * @param {{plan?: boolean, manifest?: object|null}} [opts]
45
+ * plan — report what would change, write nothing
46
+ * manifest — read only to see whether the file was provably UDS's before the
47
+ * swap (so the install record can follow it); may be null
48
+ * @returns {{
49
+ * state: 'none'|'migrated'|'would-migrate'|'kept'|'error',
50
+ * replaced: number, // legacy UDS-written lines swapped (or that would be)
51
+ * kept: Array<{line: number, text: string}>, // bare-name lines UDS cannot prove it wrote
52
+ * recorder: object|null, // fold into the manifest when non-null
53
+ * error?: string
54
+ * }}
55
+ */
56
+ export function migrateLegacyHuskyHook(projectPath, { plan = false, manifest = null } = {}) {
57
+ const rel = '.husky/pre-commit';
58
+ const abs = join(projectPath, '.husky', 'pre-commit');
59
+ const none = { state: 'none', replaced: 0, kept: [], recorder: null };
60
+ if (!existsSync(abs)) return none;
61
+
62
+ let content;
63
+ try {
64
+ content = readFileSync(abs, 'utf-8');
65
+ } catch (e) {
66
+ return { ...none, state: 'error', error: e.message };
67
+ }
68
+ if (!hasBareUdsRunner(content)) return none;
69
+
70
+ const eol = content.includes('\r\n') ? '\r\n' : '\n';
71
+ const lines = content.split('\n');
72
+ const out = [];
73
+ const kept = [];
74
+ let replaced = 0;
75
+
76
+ for (let i = 0; i < lines.length; i++) {
77
+ const text = lines[i].replace(/\r$/, '');
78
+ const next = i + 1 < lines.length ? lines[i + 1].replace(/\r$/, '').trim() : null;
79
+ // Marker line directly followed by a line UDS is known to have written.
80
+ if (text.trim() === UDS_HOOK_MARKER && next !== null && UDS_WRITTEN_LEGACY_LINES.has(next)) {
81
+ const block = buildPreCommitBlock({ args: UDS_WRITTEN_LEGACY_LINES.get(next) });
82
+ // block ends with '\n'; drop that so the surrounding line join supplies it.
83
+ out.push(...block.replace(/\n$/, '').split('\n').map((l) => l + (eol === '\r\n' ? '\r' : '')));
84
+ replaced += 1;
85
+ i += 1; // the legacy command line is consumed
86
+ continue;
87
+ }
88
+ if (BARE_UDS_RUNNER_RE.test(text)) kept.push({ line: i + 1, text: text.trim() });
89
+ out.push(lines[i]);
90
+ }
91
+
92
+ if (replaced === 0) return { state: 'kept', replaced: 0, kept, recorder: null };
93
+
94
+ if (plan) return { state: 'would-migrate', replaced, kept, recorder: null };
95
+
96
+ // Was the whole file provably UDS's until now? Then the swap must not cost it
97
+ // that proof: re-record the new content, or uninstall falls back from "delete
98
+ // the file UDS created" to "strip lines".
99
+ let recorder = null;
100
+ const wasProven = !!manifest && !!getFileRecord(manifest, rel) && proveUnchanged(manifest, projectPath, rel).state === 'proven';
101
+
102
+ try {
103
+ writeFileSync(abs, out.join('\n'), 'utf-8');
104
+ } catch (e) {
105
+ return { state: 'error', replaced: 0, kept, recorder: null, error: e.message };
106
+ }
107
+ if (wasProven) {
108
+ recorder = newRecorder();
109
+ recordFile(recorder, projectPath, rel, RECORD_KINDS.GIT_HOOK);
110
+ }
111
+ return { state: 'migrated', replaced, kept, recorder };
112
+ }