universal-dev-standards 6.14.0-beta.8 → 6.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (712) hide show
  1. package/bin/uds.js +12 -1
  2. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  3. package/bundled/ai/standards/commit-message.ai.yaml +12 -2
  4. package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
  5. package/bundled/core/commit-message-guide.md +22 -19
  6. package/bundled/core/secret-management-standards.md +13 -1
  7. package/bundled/extensions/locales/zh-tw.md +19 -19
  8. package/bundled/hooks/validate-commit-msg.mjs +52 -9
  9. package/bundled/locales/zh-CN/CHANGELOG.md +2312 -1102
  10. package/bundled/locales/zh-CN/CLAUDE.md +987 -101
  11. package/bundled/locales/zh-CN/README.md +3 -3
  12. package/bundled/locales/zh-CN/SECURITY.md +3 -3
  13. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  14. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
  15. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  16. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
  17. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
  18. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
  19. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
  20. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  21. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  22. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  23. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  24. package/bundled/locales/zh-CN/core/accessibility-standards.md +871 -62
  25. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  26. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  27. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  28. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  29. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  30. package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +311 -72
  31. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  32. package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
  33. package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
  34. package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
  35. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  36. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  37. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  38. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  39. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  40. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  41. package/bundled/locales/zh-CN/core/changelog-standards.md +485 -63
  42. package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
  43. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  44. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  45. package/bundled/locales/zh-CN/core/code-review-checklist.md +37 -23
  46. package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
  47. package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
  48. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  49. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  50. package/bundled/locales/zh-CN/core/deprecation-standards.md +155 -40
  51. package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
  52. package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
  53. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  54. package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
  55. package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
  56. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  57. package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
  58. package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
  59. package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
  60. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  61. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  62. package/bundled/locales/zh-CN/core/feature-flag-standards.md +202 -57
  63. package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
  64. package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
  65. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  66. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  67. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  68. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  69. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  70. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  71. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  72. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  73. package/bundled/locales/zh-CN/core/mutation-testing.md +45 -6
  74. package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
  75. package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
  76. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  77. package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
  78. package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
  79. package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
  80. package/bundled/locales/zh-CN/core/project-structure.md +550 -170
  81. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  82. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  83. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  84. package/bundled/locales/zh-CN/core/retrospective-standards.md +215 -22
  85. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  86. package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
  87. package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
  88. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  89. package/bundled/locales/zh-CN/core/security-standards.md +169 -16
  90. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  91. package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
  92. package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
  93. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  94. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  95. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  96. package/bundled/locales/zh-CN/core/supply-chain-security-standards.md +159 -32
  97. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  98. package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
  99. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  100. package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
  101. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  102. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  103. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  104. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  105. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  106. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  107. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  108. package/bundled/locales/zh-CN/core/versioning.md +737 -73
  109. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  110. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  111. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  112. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +2 -1
  113. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  114. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
  115. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
  116. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  117. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
  118. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  119. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
  120. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  121. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  122. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +2 -0
  123. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  124. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  125. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  126. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  127. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  128. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  129. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  130. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  131. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  132. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  133. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  134. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  135. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  136. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  137. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  138. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  139. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  140. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  141. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  142. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  143. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  144. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  145. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  146. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  147. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  148. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  149. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  150. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  151. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  152. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  153. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  154. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  155. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  156. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  157. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  158. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  159. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  160. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  161. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  162. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  163. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  164. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  165. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  166. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  167. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  168. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  169. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  170. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  171. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  172. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  173. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  174. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  175. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  176. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  177. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  178. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  179. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  180. package/bundled/locales/zh-CN/skills/README.md +2 -1
  181. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  182. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  183. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  184. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  185. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  186. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  187. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  188. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  189. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  190. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  191. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  192. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  193. package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +217 -137
  194. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  195. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  196. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  197. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  198. package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +148 -132
  199. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  200. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  201. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  202. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  203. package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +122 -121
  204. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  205. package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
  206. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  207. package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
  208. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  209. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  210. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  211. package/bundled/locales/zh-CN/skills/code-review-assistant/guide.md +119 -45
  212. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  213. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  214. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  215. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  216. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  217. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  218. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  219. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  220. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  221. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  222. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  223. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  224. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  225. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  226. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  227. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  228. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  229. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  230. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  231. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  232. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  233. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  234. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  235. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  236. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  237. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  238. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  239. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  240. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  241. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  242. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  243. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  244. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  245. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  246. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  247. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  248. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  249. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  250. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  251. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  252. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  253. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  254. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  255. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  256. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  257. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  258. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  259. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  260. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  261. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +4 -4
  262. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  263. package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
  264. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  265. package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
  266. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  267. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  268. package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +4 -2
  269. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  270. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  271. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  272. package/bundled/locales/zh-CN/skills/docs-generator/guide.md +8 -7
  273. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  274. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  275. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  276. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  277. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  278. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  279. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  280. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  281. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  282. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  283. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  284. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  285. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  286. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  287. package/bundled/locales/zh-CN/skills/project-discovery/guide.md +158 -157
  288. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  289. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  290. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  291. package/bundled/locales/zh-CN/skills/refactoring-assistant/guide.md +172 -171
  292. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  293. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  294. package/bundled/locales/zh-CN/skills/release-standards/guide.md +51 -43
  295. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  296. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  297. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  298. package/bundled/locales/zh-CN/skills/requirement-assistant/guide.md +88 -79
  299. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  300. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  301. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  302. package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +2 -2
  303. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  304. package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
  305. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  306. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  307. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  308. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  309. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  310. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  311. package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +2 -2
  312. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  313. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  314. package/bundled/locales/zh-CN/skills/tdd-assistant/guide.md +217 -156
  315. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  316. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  317. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  318. package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +25 -12
  319. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  320. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  321. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  322. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  323. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  324. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  325. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  326. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  327. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  328. package/bundled/locales/zh-TW/CHANGELOG.md +2291 -1110
  329. package/bundled/locales/zh-TW/CLAUDE.md +962 -76
  330. package/bundled/locales/zh-TW/README.md +3 -3
  331. package/bundled/locales/zh-TW/SECURITY.md +3 -3
  332. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  333. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
  334. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  335. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
  336. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
  337. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
  338. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
  339. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  340. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  341. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  342. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  343. package/bundled/locales/zh-TW/core/accessibility-standards.md +895 -46
  344. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  345. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  346. package/bundled/locales/zh-TW/core/agent-dispatch.md +102 -33
  347. package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
  348. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  349. package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
  350. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  351. package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
  352. package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
  353. package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
  354. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  355. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  356. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  357. package/bundled/locales/zh-TW/core/branch-completion.md +130 -34
  358. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  359. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  360. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  361. package/bundled/locales/zh-TW/core/chaos-engineering-standards.md +138 -36
  362. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  363. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  364. package/bundled/locales/zh-TW/core/code-review-checklist.md +19 -7
  365. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  366. package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
  367. package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
  368. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  369. package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
  370. package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
  371. package/bundled/locales/zh-TW/core/developer-memory.md +102 -12
  372. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  373. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  374. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  375. package/bundled/locales/zh-TW/core/environment-standards.md +250 -72
  376. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  377. package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
  378. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  379. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  380. package/bundled/locales/zh-TW/core/feature-flag-standards.md +202 -57
  381. package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
  382. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  383. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  384. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  385. package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +234 -487
  386. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  387. package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
  388. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  389. package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
  390. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  391. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  392. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  393. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  394. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  395. package/bundled/locales/zh-TW/core/observability-standards.md +284 -40
  396. package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
  397. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  398. package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
  399. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  400. package/bundled/locales/zh-TW/core/project-context-memory.md +210 -31
  401. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  402. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  403. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  404. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  405. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  406. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  407. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  408. package/bundled/locales/zh-TW/core/runbook-standards.md +296 -23
  409. package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
  410. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  411. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  412. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  413. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  414. package/bundled/locales/zh-TW/core/slo-standards.md +301 -49
  415. package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
  416. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  417. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  418. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  419. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  420. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  421. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  422. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  423. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  424. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  425. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  426. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  427. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  428. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  429. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  430. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  431. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  432. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  433. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  434. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  435. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +2 -1
  436. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  437. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
  438. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  439. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
  440. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  441. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
  442. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  443. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
  444. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  445. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  446. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +2 -0
  447. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  448. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  449. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  450. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  451. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  452. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  453. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  454. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  455. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  456. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  457. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  458. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  459. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  460. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  461. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  462. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  463. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  464. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  465. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  466. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  467. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  468. package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +584 -475
  469. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  470. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  471. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  472. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  473. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  474. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  475. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  476. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  477. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  478. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  479. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  480. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  481. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  482. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  483. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  484. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  485. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  486. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  487. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  488. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  489. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  490. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  491. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  492. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  493. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  494. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  495. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  496. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  497. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  498. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  499. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  500. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  501. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  502. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  503. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  504. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  505. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  506. package/bundled/locales/zh-TW/skills/README.md +2 -1
  507. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  508. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  509. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  510. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  511. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  512. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  513. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  514. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  515. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  516. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  517. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  518. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  519. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  520. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  521. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  522. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  523. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  524. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  525. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  526. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  527. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  528. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  529. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  530. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  531. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  532. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  533. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  534. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  535. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  536. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  537. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  538. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  539. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  540. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  541. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  542. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  543. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  544. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  545. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  546. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  547. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  548. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  549. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  550. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  551. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  552. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  553. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  554. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  555. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  556. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  557. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  558. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  559. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  560. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  561. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  562. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  563. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  564. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  565. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  566. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  567. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  568. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  569. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  570. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  571. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  572. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  573. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  574. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  575. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  576. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  577. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  578. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  579. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  580. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  581. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  582. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  583. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  584. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  585. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  586. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  587. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  588. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  589. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  590. package/bundled/locales/zh-TW/skills/commit-standards/guide.md +137 -17
  591. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  592. package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
  593. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  594. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  595. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  596. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  597. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  598. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  599. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  600. package/bundled/locales/zh-TW/skills/docs-generator/guide.md +4 -3
  601. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  602. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  603. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  604. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  605. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  606. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  607. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  608. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  609. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  610. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  611. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  612. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  613. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  614. package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +85 -18
  615. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  616. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  617. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  618. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  619. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  620. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  621. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  622. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  623. package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +91 -45
  624. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  625. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  626. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  627. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  628. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  629. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  630. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  631. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  632. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  633. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  634. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  635. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  636. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  637. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  638. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  639. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  640. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  641. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  642. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  643. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  644. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  645. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  646. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  647. package/bundled/locales/zh-TW/skills/tdd-assistant/language-examples.md +693 -47
  648. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  649. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  650. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  651. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  652. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  653. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  654. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  655. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  656. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  657. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  658. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  659. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  660. package/bundled/skills/.claude-plugin/plugin.json +71 -0
  661. package/bundled/skills/commit-standards/SKILL.md +2 -2
  662. package/bundled/skills/commit-standards/guide.md +3 -2
  663. package/bundled/skills/commit-standards/language-options.md +19 -17
  664. package/package.json +2 -2
  665. package/src/commands/audit.js +28 -1
  666. package/src/commands/check.js +77 -7
  667. package/src/commands/compile.js +37 -4
  668. package/src/commands/config.js +49 -24
  669. package/src/commands/init.js +78 -30
  670. package/src/commands/open-work.js +6 -2
  671. package/src/commands/release-messages.js +228 -0
  672. package/src/commands/release.js +127 -68
  673. package/src/commands/run-intent.js +11 -0
  674. package/src/commands/spec-split.js +2 -1
  675. package/src/commands/spec.js +11 -2
  676. package/src/commands/update.js +184 -30
  677. package/src/compilers/claude-code-compiler.js +9 -1
  678. package/src/config/ai-agent-paths.js +14 -1
  679. package/src/core/installed-formats.js +15 -0
  680. package/src/core/open-work-config.js +20 -1
  681. package/src/core/project-config.js +55 -0
  682. package/src/i18n/messages.js +160 -2
  683. package/src/installers/hooks-installer.js +1 -1
  684. package/src/installers/manifest-installer.js +1 -1
  685. package/src/installers/skills-installer.js +1 -1
  686. package/src/installers/standards-installer.js +3 -1
  687. package/src/mcp/server.js +9 -3
  688. package/src/prompts/init.js +26 -22
  689. package/src/reconciler/actual-state-scanner.js +2 -8
  690. package/src/reconciler/backup-locations.js +5 -0
  691. package/src/reconciler/backup-manager.js +19 -11
  692. package/src/reconciler/desired-state-calculator.js +89 -57
  693. package/src/reconciler/plan-executor.js +101 -8
  694. package/src/reconciler/recorded-versions.js +49 -0
  695. package/src/reconciler/relative-path.js +23 -0
  696. package/src/uninstallers/hook-uninstaller.js +9 -1
  697. package/src/uninstallers/skills-uninstaller.js +22 -3
  698. package/src/utils/available-standards-report.js +25 -4
  699. package/src/utils/available-standards.js +13 -3
  700. package/src/utils/build-manifest.js +1 -1
  701. package/src/utils/commit-message-judge.js +60 -13
  702. package/src/utils/friction-detector.js +23 -11
  703. package/src/utils/git-hooks.js +106 -4
  704. package/src/utils/integration-generator.js +95 -67
  705. package/src/utils/legacy-hook-migration.js +121 -2
  706. package/src/utils/open-work-tracking.mjs +105 -16
  707. package/src/utils/sdd-header.js +16 -4
  708. package/src/utils/skills-installer.js +2 -1
  709. package/src/utils/spinner.js +14 -4
  710. package/src/utils/standard-validator.js +3 -2
  711. package/standards-registry.json +10 -8
  712. package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
@@ -52,7 +52,7 @@ export function verifyManifest(manifest, gitTagCommit, options = {}) {
52
52
  if (!manifest.commit) {
53
53
  errors.push('manifest missing commit field');
54
54
  } else if (manifest.commit !== gitTagCommit) {
55
- errors.push(`commit mismatch: manifest has "${manifest.commit}", git tag points to "${gitTagCommit}"`);
55
+ errors.push(`commit mismatch: manifest has "${manifest.commit}", the current HEAD is "${gitTagCommit}"`);
56
56
  }
57
57
 
58
58
  const recorded = manifest.checksum?.package ?? null;
@@ -32,18 +32,47 @@ import * as yaml from 'js-yaml';
32
32
  /** Used only when no commit-message option file is installed. The Conventional Commits type set. */
33
33
  export const FALLBACK_TYPES = ['feat', 'fix', 'docs', 'style', 'refactor', 'perf', 'test', 'build', 'ci', 'chore', 'revert'];
34
34
 
35
- /** `type(scope)!: subject` - scope and the breaking-change mark are optional. */
36
- const HEADER = /^(?<type>[A-Za-z][A-Za-z0-9-]*)(?:\((?<scope>[^()]*)\))?(?<bang>!)?: (?<subject>\S.*)$/;
35
+ /**
36
+ * `type(scope)!: subject` - scope and the breaking-change mark are optional.
37
+ * // implements XSPEC-475 R1
38
+ * The type is any run of letters (any script) and digits, not only ASCII: the traditional-chinese option file
39
+ * allows types like 新增 and 修正. Whether the word is an ALLOWED type is decided afterwards, from the option
40
+ * files; the header shape only says where the type is.
41
+ */
42
+ const HEADER = /^(?<type>\p{L}[\p{L}\p{N}-]*)(?:\((?<scope>[^()]*)\))?(?<bang>!)?: (?<subject>\S.*)$/u;
43
+
44
+ /**
45
+ * Lowercase rules (`scope-lowercase`) are about letters that HAVE a case. A Chinese character has no
46
+ * lowercase form, so it can neither pass nor break the rule. Each such letter is replaced with a lowercase
47
+ * stand-in before the standard's own pattern is applied, so the pattern stays the single source of the rule.
48
+ * // implements XSPEC-475 R1
49
+ */
50
+ function withUncasedLettersAsLowercase(text) {
51
+ return text.replace(/\p{L}/gu, (ch) => (ch.toLowerCase() === ch.toUpperCase() ? 'a' : ch));
52
+ }
53
+
54
+ /** Compare dotted numeric versions ("1.0.0" < "2.0.0"); a missing or non-numeric part counts as 0. */
55
+ function compareVersions(a, b) {
56
+ const part = (v) => String(v ?? '0').split(/[.-]/).map((n) => Number.parseInt(n, 10) || 0);
57
+ const [x, y] = [part(a), part(b)];
58
+ for (let i = 0; i < Math.max(x.length, y.length); i++) {
59
+ const d = (x[i] ?? 0) - (y[i] ?? 0);
60
+ if (d !== 0) return d < 0 ? -1 : 1;
61
+ }
62
+ return 0;
63
+ }
37
64
 
38
65
  /**
39
66
  * The commit types the project's installed option files allow. An option file belongs to this standard when
40
67
  * its `meta.parent` is `commit-message`. Installed projects keep option files flat in `.standards/options/`
41
68
  * (`english.ai.yaml`); a checkout of UDS itself nests them (`.standards/options/commit-message/`). Both are read.
42
69
  * @param {string} standardsDir - `<project>/.standards`
43
- * @returns {{ types: string[], source: string }}
70
+ * @param {{ shippedRoot?: string|null }} [opts] - the folder holding the option files this CLI ships (`<root>/ai/options/commit-message/`)
71
+ * @returns {{ types: string[], source: string, stale: Array<{id: string, installed: string, shipped: string}> }}
44
72
  */
45
- export function allowedCommitTypes(standardsDir) {
73
+ export function allowedCommitTypes(standardsDir, { shippedRoot = null } = {}) {
46
74
  const found = new Set();
75
+ const stale = [];
47
76
  const optionsDir = path.join(standardsDir, 'options');
48
77
  for (const dir of [optionsDir, path.join(optionsDir, 'commit-message')]) {
49
78
  let names = [];
@@ -56,7 +85,19 @@ export function allowedCommitTypes(standardsDir) {
56
85
  try {
57
86
  const doc = yaml.load(fs.readFileSync(path.join(dir, name), 'utf-8'));
58
87
  if (doc?.meta?.parent !== 'commit-message') continue;
59
- for (const entry of doc.types || []) {
88
+ // XSPEC-475 R7: an installed option file that is OLDER than the one this CLI ships is judged by the shipped one, and
89
+ // the caller is told. After a CLI upgrade and before `uds update --apply` the installed file still has the old rules
90
+ // (traditional-chinese 1.0.0 listed Chinese types), and judging by it gave the opposite of the current answer without a word.
91
+ let rules = doc;
92
+ const shippedFile = shippedRoot && doc.id ? path.join(shippedRoot, 'ai', 'options', 'commit-message', `${doc.id}.ai.yaml`) : null;
93
+ if (shippedFile && fs.existsSync(shippedFile)) {
94
+ const shipped = yaml.load(fs.readFileSync(shippedFile, 'utf-8'));
95
+ if (compareVersions(doc.meta.version, shipped?.meta?.version) < 0) { // [mutation-anchor:installed-option-older]
96
+ rules = shipped;
97
+ stale.push({ id: doc.id, installed: String(doc.meta.version ?? 'unknown'), shipped: String(shipped.meta.version) });
98
+ }
99
+ }
100
+ for (const entry of rules.types || []) {
60
101
  if (entry && typeof entry.type === 'string') found.add(entry.type);
61
102
  }
62
103
  } catch {
@@ -64,8 +105,8 @@ export function allowedCommitTypes(standardsDir) {
64
105
  }
65
106
  }
66
107
  }
67
- if (found.size === 0) return { types: FALLBACK_TYPES, source: 'the Conventional Commits set, because no commit-message option file is installed' };
68
- return { types: [...found], source: '.standards/options' };
108
+ if (found.size === 0) return { types: FALLBACK_TYPES, source: 'the Conventional Commits set, because no commit-message option file is installed', stale };
109
+ return { types: [...found], source: stale.length > 0 ? ".standards/options, with the CLI's current rules for the option file(s) listed as out of date" : '.standards/options', stale };
69
110
  }
70
111
 
71
112
  /** The `validator` pattern of a rule in the standard, as a RegExp, or null when there is none. */
@@ -83,12 +124,13 @@ function ruleValidator(standardConfig, ruleId) {
83
124
  * @param {Object} standardConfig - the parsed commit-message standard
84
125
  * @param {string} input - the commit message (only the first line is the header)
85
126
  * @param {{ standardsDir: string }} context
86
- * @returns {{ verdict: 'pass' | 'fail', findings: string[], checked: string[], notChecked: string[] }}
127
+ * @returns {{ verdict: 'pass' | 'fail', findings: string[], checked: string[], notChecked: string[], notes: string[] }}
87
128
  */
88
- export function judgeCommitMessage(standardConfig, input, { standardsDir }) {
129
+ export function judgeCommitMessage(standardConfig, input, { standardsDir, shippedRoot = null }) {
89
130
  const findings = [];
90
131
  const checked = [];
91
132
  const notChecked = [];
133
+ const notes = [];
92
134
 
93
135
  const header = String(input).replace(/\r\n/g, '\n').split('\n')[0];
94
136
  const match = HEADER.exec(header);
@@ -98,18 +140,23 @@ export function judgeCommitMessage(standardConfig, input, { standardsDir }) {
98
140
  findings.push('The first line is not in the form <type>(<scope>): <subject> (scope is optional).');
99
141
  } else {
100
142
  const { type, scope, subject } = match.groups;
101
- const { types, source } = allowedCommitTypes(standardsDir);
143
+ const { types, source, stale } = allowedCommitTypes(standardsDir, { shippedRoot });
144
+ for (const o of stale) {
145
+ notes.push(`The installed option file "${o.id}" is version ${o.installed}, older than the ${o.shipped} this CLI ships, so this message was judged by the CLI's current rules. Run \`uds update --apply\` to bring the installed option file up to date.`);
146
+ }
102
147
 
103
148
  checked.push(`type is one of: ${types.join(', ')} (from ${source})`);
104
149
  if (!types.includes(type)) {
105
- findings.push(`Type "${type}" is not one of: ${types.join(', ')}.`);
150
+ findings.push(`Type "${type}" is not one of: ${types.join(', ')}.${/[^\u0020-\u007E]/.test(type)
151
+ ? ' The type must be an English word from that list; only the subject may be Chinese (for example `feat(api): 新增部門端點`).'
152
+ : ''}`);
106
153
  }
107
154
 
108
155
  if (scope !== undefined) {
109
156
  const scopeRule = ruleValidator(standardConfig, 'scope-lowercase');
110
157
  if (scopeRule) {
111
158
  checked.push('rule scope-lowercase');
112
- if (scope === '' || !scopeRule.test(scope)) {
159
+ if (scope === '' || !scopeRule.test(withUncasedLettersAsLowercase(scope))) {
113
160
  findings.push(`Scope "${scope}" breaks rule scope-lowercase (use lowercase letters, digits and dashes, starting with a letter).`);
114
161
  }
115
162
  } else {
@@ -133,5 +180,5 @@ export function judgeCommitMessage(standardConfig, input, { standardsDir }) {
133
180
  notChecked.push('rule imperative-mood (the standard gives no machine-checkable pattern)');
134
181
  notChecked.push('rule no-mixed-changes and the commit language option');
135
182
 
136
- return { verdict: findings.length === 0 ? 'pass' : 'fail', findings, checked, notChecked };
183
+ return { verdict: findings.length === 0 ? 'pass' : 'fail', findings, checked, notChecked, notes };
137
184
  }
@@ -55,18 +55,30 @@ export function detectFrictions(projectPath, manifest) {
55
55
  * @returns {Array}
56
56
  */
57
57
  function detectAvailableStandards(manifest) {
58
- const { offered } = getAvailableStandards(manifest);
59
- if (offered.length === 0) return [];
60
-
58
+ const { offered, recommended } = getAvailableStandards(manifest);
61
59
  const msg = t().availableStandards;
62
- const shown = offered.slice(0, 5).map(s => s.id).join(', ');
63
- return [{
64
- standard: msg.frictionStandard.replace('{count}', offered.length),
65
- type: 'not-installed',
66
- severity: 'LOW',
67
- diff: offered.length > 5 ? `${shown}, …` : shown,
68
- suggestion: msg.frictionSuggestion
69
- }];
60
+ const findings = [];
61
+ if (offered.length > 0) {
62
+ const shown = offered.slice(0, 5).map(s => s.id).join(', ');
63
+ findings.push({
64
+ standard: msg.frictionStandard.replace('{count}', offered.length),
65
+ type: 'not-installed',
66
+ severity: 'LOW',
67
+ diff: offered.length > 5 ? `${shown}, …` : shown,
68
+ suggestion: msg.frictionSuggestion
69
+ });
70
+ }
71
+ // XSPEC-475 R9: the recommended core standards are named, with the command that installs each one.
72
+ if (recommended.length > 0) {
73
+ findings.push({
74
+ standard: msg.frictionRecommended.replace('{count}', recommended.length),
75
+ type: 'not-installed',
76
+ severity: 'LOW',
77
+ diff: recommended.map(s => s.id).join(', '),
78
+ suggestion: recommended.map(s => `uds update --apply --add-standard ${s.id}`).join('; ')
79
+ });
80
+ }
81
+ return findings;
70
82
  }
71
83
 
72
84
  /**
@@ -189,16 +189,34 @@ export function hookRunsUdsCheck(content) {
189
189
  * - Not installed: say what is missing and how to fix it, exit non-zero. It
190
190
  * neither skips the check nor downloads anything.
191
191
  *
192
- * @param {{args?: string, hookFile?: string}} [opts]
192
+ * @param {{args?: string, hookFile?: string, ci?: boolean}} [opts]
193
193
  * args — extra arguments to keep on the check command
194
194
  * (e.g. `--standard checkin-standards`, which older UDS versions wrote).
195
195
  * hookFile — the file the block is written into, named in the "blocked" message so
196
196
  * it points at the file the adopter actually has (default `.husky/pre-commit`;
197
197
  * the native hook passes `.git/hooks/pre-commit`).
198
+ * ci — call `check --ci` (default). A plain `uds check` prints "Some issues detected" and exits 0
199
+ * when a standard file was edited, so a hook that runs it never stops a commit for that
200
+ * (XSPEC-482 R3, found by the beta.12 macOS retest: tampered standard, `git commit` went
201
+ * through). `--ci` is the mode whose exit code says "issues". `ci: false` rebuilds the text
202
+ * UDS 6.14.0-beta.2 to beta.12 wrote, ONLY so that `uds update` can recognise it exactly
203
+ * (legacy-hook-migration.js); nothing writes that text any more.
198
204
  * @returns {string} the block, LF line endings, ending with a newline
199
205
  */
200
- export function buildPreCommitBlock({ args = '', hookFile = '.husky/pre-commit' } = {}) {
201
- const cmd = args ? `${UDS_BIN_NAME} check ${args}` : `${UDS_BIN_NAME} check`;
206
+ export function buildPreCommitBlock({ args = '', hookFile = '.husky/pre-commit', ci = true } = {}) {
207
+ const cmd = args ? `${UDS_BIN_NAME} check ${args}` : `${UDS_BIN_NAME} check${ci ? ' --ci' : ''}`;
208
+ // When the check fails the commit is stopped; say so (the lines above it name the files), otherwise the
209
+ // reader sees a list of warnings and no sign that git refused the commit because of them.
210
+ const afterCheck = (ci && !args)
211
+ ? [
212
+ ' status=$?',
213
+ ' if [ "$status" -ne 0 ]; then',
214
+ ' echo "[UDS] This commit is blocked: the UDS check found the issues listed above." >&2',
215
+ ' echo "[UDS] To put the standard files back, run the UDS CLI with: check --restore" >&2',
216
+ ' fi',
217
+ ' exit $status'
218
+ ]
219
+ : [' exit $?'];
202
220
  return [
203
221
  UDS_HOOK_MARKER,
204
222
  '# Runs the UDS CLI installed in this project (node_modules/.bin) or on PATH.',
@@ -208,7 +226,7 @@ export function buildPreCommitBlock({ args = '', hookFile = '.husky/pre-commit'
208
226
  ' PATH="$PWD/node_modules/.bin:$PATH"',
209
227
  ` if command -v ${UDS_BIN_NAME} >/dev/null 2>&1; then`,
210
228
  ` ${cmd}`,
211
- ' exit $?',
229
+ ...afterCheck,
212
230
  ' fi',
213
231
  ` echo "[UDS] Pre-commit check cannot run: the UDS CLI (${UDS_BIN_NAME}) is not installed." >&2`,
214
232
  ` echo "[UDS] Install it: npm install --save-dev ${UDS_BIN_NAME} (or: npm install -g ${UDS_BIN_NAME})" >&2`,
@@ -220,6 +238,90 @@ export function buildPreCommitBlock({ args = '', hookFile = '.husky/pre-commit'
220
238
  ].join('\n');
221
239
  }
222
240
 
241
+ /**
242
+ * The whole `.git/hooks/pre-commit` file `uds init` writes for a project that has no package.json.
243
+ *
244
+ * Fail-closed (XSPEC-444 R1 class sweep): a linter that is installed and fails blocks the commit; one that is
245
+ * not installed is skipped. The UDS check is the block above, whose exit status stops the commit.
246
+ *
247
+ * @param {{ci?: boolean}} [opts] `ci: false` rebuilds the beta.2 to beta.12 text, for exact recognition only (see buildPreCommitBlock)
248
+ * @returns {string}
249
+ */
250
+ export function buildNativePreCommitHook({ ci = true } = {}) {
251
+ return `#!/bin/sh
252
+ # UDS pre-commit hook
253
+ # Auto-generated by uds init
254
+
255
+ echo "Running UDS pre-commit checks..."
256
+
257
+ # Lint, when the language's linter is installed. A failing linter blocks the commit.
258
+ if [ -f pyproject.toml ] || [ -f requirements.txt ]; then
259
+ if python -m ruff --version >/dev/null 2>&1; then
260
+ python -m ruff check . || exit $?
261
+ fi
262
+ elif [ -f go.mod ]; then
263
+ if command -v go >/dev/null 2>&1; then
264
+ go vet ./... || exit $?
265
+ fi
266
+ elif [ -f Cargo.toml ]; then
267
+ if command -v cargo >/dev/null 2>&1; then
268
+ cargo clippy || exit $?
269
+ fi
270
+ fi
271
+
272
+ ${buildPreCommitBlock({ hookFile: '.git/hooks/pre-commit', ci })}
273
+ echo "Pre-commit checks passed"
274
+ `;
275
+ }
276
+
277
+ /**
278
+ * The `.git/hooks/pre-commit` that every UDS release from the 5.x line to 6.13.1 wrote (checked byte for byte
279
+ * against the file `universal-dev-standards@6.11.0` produces; the template did not change between those
280
+ * releases, `git log -S` on init.js). It runs `uds check 2>/dev/null || true`: the CLI that PATH happens to
281
+ * hold, errors thrown away, always "passed". Kept here as text so `uds update` and `uds uninstall` can tell
282
+ * "UDS wrote exactly this" from "someone edited it". Nothing writes it any more.
283
+ */
284
+ export const LEGACY_NATIVE_HOOK_6_11 = `#!/bin/sh
285
+ # UDS pre-commit hook
286
+ # Auto-generated by uds init
287
+
288
+ echo "Running UDS pre-commit checks..."
289
+
290
+ # Run lint if available
291
+ if [ -f pyproject.toml ] || [ -f requirements.txt ]; then
292
+ python -m ruff check . 2>/dev/null || true
293
+ elif [ -f go.mod ]; then
294
+ go vet ./... 2>/dev/null || true
295
+ elif [ -f Cargo.toml ]; then
296
+ cargo clippy 2>/dev/null || true
297
+ fi
298
+
299
+ # UDS Standard Check
300
+ uds check 2>/dev/null || true
301
+
302
+ echo "Pre-commit checks passed"
303
+ `;
304
+
305
+ /** Line endings made LF, so a hook file saved with CRLF still compares equal to the text above. */
306
+ const lf = (text) => String(text).replace(/\r\n/g, '\n');
307
+
308
+ /**
309
+ * Which hook text, if any, is `content` byte for byte (apart from line endings)?
310
+ * @returns {'legacy-6.11'|'without-ci'|'current'|null}
311
+ * legacy-6.11 — the always-pass hook of 5.x to 6.13.1;
312
+ * without-ci — the beta.2 to beta.12 hook, whose check cannot fail a commit;
313
+ * current — what this CLI writes;
314
+ * null — anything else: not provably UDS's.
315
+ */
316
+ export function classifyNativePreCommitHook(content) {
317
+ if (typeof content !== 'string') return null;
318
+ const text = lf(content);
319
+ if (text === LEGACY_NATIVE_HOOK_6_11) return 'legacy-6.11';
320
+ if (text === buildNativePreCommitHook({ ci: false })) return 'without-ci';
321
+ if (text === buildNativePreCommitHook()) return 'current';
322
+ return null;
323
+ }
324
+
223
325
  /**
224
326
  * Remove the block buildPreCommitBlock() writes — from the marker line through
225
327
  * the end-marker line, inclusive — and nothing else. A block whose end marker is
@@ -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) {
@@ -2470,11 +2472,17 @@ export function generateIndexDisclosure(format, language = 'en') {
2470
2472
  'follow its contents. Working from this block alone means working without the',
2471
2473
  'standards.'
2472
2474
  ]
2473
- : [
2474
- '**這個區塊是索引,不是標準本文。** 規則並未複製於此。',
2475
- '在依照下方任何一項行動之前,請打開 `.standards/` 底下對應的檔案並遵守其內容。',
2476
- '只憑這個區塊工作,等同於沒有採用標準。'
2477
- ];
2475
+ : language === 'zh-cn'
2476
+ ? [
2477
+ '**这个区块是索引,不是标准本文。** 规则并未复制于此。',
2478
+ '在依照下方任何一项行动之前,请打开 `.standards/` 底下对应的文件并遵守其内容。',
2479
+ '只凭这个区块工作,等同于没有采用标准。'
2480
+ ]
2481
+ : [
2482
+ '**這個區塊是索引,不是標準本文。** 規則並未複製於此。',
2483
+ '在依照下方任何一項行動之前,請打開 `.standards/` 底下對應的檔案並遵守其內容。',
2484
+ '只憑這個區塊工作,等同於沒有採用標準。'
2485
+ ];
2478
2486
 
2479
2487
  if (format === 'markdown') {
2480
2488
  return lines.map((l) => `> ${l}`).join('\n');
@@ -2484,6 +2492,22 @@ export function generateIndexDisclosure(format, language = 'en') {
2484
2492
  return lines.map((l) => l.replace(/\*\*/g, '').replace(/`/g, '')).join('\n');
2485
2493
  }
2486
2494
 
2495
+ /**
2496
+ * Pick the text for a content language: English, Traditional Chinese (also used for 'bilingual', whose second language
2497
+ * is Traditional unless the display language is Simplified), or Simplified Chinese for 'zh-cn'.
2498
+ * XSPEC-482 R13: these functions chose between English and Traditional only, so a Simplified Chinese project got
2499
+ * Traditional sentences in the block `uds init` wrote.
2500
+ * @param {string} language
2501
+ * @param {string} en
2502
+ * @param {string} zhTw
2503
+ * @param {string} zhCn
2504
+ * @returns {string}
2505
+ */
2506
+ function byLanguage(language, en, zhTw, zhCn) {
2507
+ if (language === 'en') return en;
2508
+ return language === 'zh-cn' ? zhCn : zhTw;
2509
+ }
2510
+
2487
2511
  /**
2488
2512
  * Generate minimal standards reference for minimal content mode
2489
2513
  * @param {string[]} installedStandards - List of installed standard file paths
@@ -2535,17 +2559,16 @@ export function generateMinimalStandardsReference(
2535
2559
  const sections = [];
2536
2560
 
2537
2561
  if (format === 'markdown') {
2538
- sections.push(language === 'en'
2539
- ? '## Standards Reference'
2540
- : '## 規範文件參考');
2562
+ sections.push(byLanguage(language, '## Standards Reference', '## 規範文件參考', '## 规范文档参考'));
2541
2563
  sections.push('');
2542
- sections.push(language === 'en'
2543
- ? '**IMPORTANT**: When performing related tasks, you MUST read and follow the standards in `.standards/`:'
2544
- : '**重要**:執行相關任務時,務必讀取並遵循 `.standards/` 目錄下的對應規範:');
2564
+ sections.push(byLanguage(language,
2565
+ '**IMPORTANT**: When performing related tasks, you MUST read and follow the standards in `.standards/`:',
2566
+ '**重要**:執行相關任務時,務必讀取並遵循 `.standards/` 目錄下的對應規範:',
2567
+ '**重要**:执行相关任务时,务必读取并遵循 `.standards/` 目录下的对应规范:'));
2545
2568
  sections.push('');
2546
2569
 
2547
2570
  if (coreStandards.length > 0) {
2548
- sections.push(language === 'en' ? '**Core Standards:**' : '**核心規範:**');
2571
+ sections.push(byLanguage(language, '**Core Standards:**', '**核心規範:**', '**核心规范:**'));
2549
2572
  for (const std of coreStandards) {
2550
2573
  sections.push(`- \`.standards/${std.filename}\``);
2551
2574
  }
@@ -2553,7 +2576,7 @@ export function generateMinimalStandardsReference(
2553
2576
  }
2554
2577
 
2555
2578
  if (optionStandards.length > 0) {
2556
- sections.push(language === 'en' ? '**Options:**' : '**選項:**');
2579
+ sections.push(byLanguage(language, '**Options:**', '**選項:**', '**选项:**'));
2557
2580
  for (const std of optionStandards) {
2558
2581
  sections.push(`- \`.standards/options/${std.filename}\``);
2559
2582
  }
@@ -2563,20 +2586,20 @@ export function generateMinimalStandardsReference(
2563
2586
  // Said out loud rather than dropped quietly. A shorter list and a complete
2564
2587
  // one read the same, and only the manifest knows which this is.
2565
2588
  if (unresolved.length > 0) {
2566
- sections.push(language === 'en'
2567
- ? `> ${unresolved.length} manifest entr${unresolved.length === 1 ? 'y' : 'ies'} could not be matched to an installed file and ${unresolved.length === 1 ? 'is' : 'are'} not listed above: ${unresolved.join(', ')}. Run \`uds update\` — if that does not clear it, the manifest and the registry disagree.`
2568
- : `> 有 ${unresolved.length} 筆 manifest 項目對不到已安裝的檔案,未列於上方:${unresolved.join('、')}。請執行 \`uds update\`;若仍未消失,代表 manifest 與 registry 不一致。`);
2589
+ sections.push(byLanguage(language,
2590
+ `> ${unresolved.length} manifest entr${unresolved.length === 1 ? 'y' : 'ies'} could not be matched to an installed file and ${unresolved.length === 1 ? 'is' : 'are'} not listed above: ${unresolved.join(', ')}. Run \`uds update\` — if that does not clear it, the manifest and the registry disagree.`,
2591
+ `> 有 ${unresolved.length} 筆 manifest 項目對不到已安裝的檔案,未列於上方:${unresolved.join('、')}。請執行 \`uds update\`;若仍未消失,代表 manifest 與 registry 不一致。`,
2592
+ `> 有 ${unresolved.length} 笔 manifest 项目对不到已安装的文件,未列于上方:${unresolved.join('、')}。请执行 \`uds update\`;若仍未消失,代表 manifest 与 registry 不一致。`));
2569
2593
  sections.push('');
2570
2594
  }
2571
2595
  } else {
2572
2596
  // Plaintext format
2573
- sections.push(language === 'en'
2574
- ? '## Standards Reference'
2575
- : '## 規範文件參考');
2597
+ sections.push(byLanguage(language, '## Standards Reference', '## 規範文件參考', '## 规范文档参考'));
2576
2598
  sections.push('');
2577
- sections.push(language === 'en'
2578
- ? 'IMPORTANT: When performing related tasks, read and follow the standards in .standards/:'
2579
- : '重要:執行相關任務時,務必讀取並遵循 .standards/ 目錄下的對應規範:');
2599
+ sections.push(byLanguage(language,
2600
+ 'IMPORTANT: When performing related tasks, read and follow the standards in .standards/:',
2601
+ '重要:執行相關任務時,務必讀取並遵循 .standards/ 目錄下的對應規範:',
2602
+ '重要:执行相关任务时,务必读取并遵循 .standards/ 目录下的对应规范:'));
2580
2603
  sections.push('');
2581
2604
 
2582
2605
  for (const std of coreStandards) {
@@ -2585,7 +2608,7 @@ export function generateMinimalStandardsReference(
2585
2608
 
2586
2609
  if (optionStandards.length > 0) {
2587
2610
  sections.push('');
2588
- sections.push(language === 'en' ? 'Options:' : '選項:');
2611
+ sections.push(byLanguage(language, 'Options:', '選項:', '选项:'));
2589
2612
  for (const std of optionStandards) {
2590
2613
  sections.push(`- .standards/options/${std.filename}`);
2591
2614
  }
@@ -2593,9 +2616,10 @@ export function generateMinimalStandardsReference(
2593
2616
 
2594
2617
  if (unresolved.length > 0) {
2595
2618
  sections.push('');
2596
- sections.push(language === 'en'
2597
- ? `NOTE: ${unresolved.length} manifest entries could not be matched to an installed file and are not listed: ${unresolved.join(', ')}`
2598
- : `注意:有 ${unresolved.length} 筆 manifest 項目對不到已安裝的檔案,未列出:${unresolved.join('、')}`);
2619
+ sections.push(byLanguage(language,
2620
+ `NOTE: ${unresolved.length} manifest entries could not be matched to an installed file and are not listed: ${unresolved.join(', ')}`,
2621
+ `注意:有 ${unresolved.length} 筆 manifest 項目對不到已安裝的檔案,未列出:${unresolved.join('、')}`,
2622
+ `注意:有 ${unresolved.length} 笔 manifest 项目对不到已安装的文件,未列出:${unresolved.join('、')}`));
2599
2623
  }
2600
2624
  sections.push('');
2601
2625
  }
@@ -2625,12 +2649,12 @@ function generateOutputLanguageDirective(outputLanguage, language) {
2625
2649
 
2626
2650
  if (outputLanguage === 'traditional-chinese') {
2627
2651
  if (language === 'zh-tw') {
2628
- return '## 提交訊息語言\n所有提交訊息必須使用**繁體中文**撰寫。\n格式:`<類型>(<範圍>): <主旨>`';
2652
+ return '## 提交訊息語言\n所有提交訊息的主旨與本文必須使用**繁體中文**撰寫;類型維持英文(feat、fix、docs 等)。\n格式:`<type>(<scope>): <主旨>`';
2629
2653
  }
2630
2654
  if (language === 'zh-cn') {
2631
- return '## 提交消息语言\n所有提交消息必须使用**繁体中文**撰写。\n格式:`<类型>(<范围>): <主旨>`';
2655
+ return '## 提交消息语言\n所有提交消息的主旨与正文必须使用**繁体中文**撰写;类型保持英文(feat、fix、docs 等)。\n格式:`<type>(<scope>): <主旨>`';
2632
2656
  }
2633
- return '## Commit Message Language\nWrite all commit messages in **Traditional Chinese (繁體中文)**.\nFormat: `<類型>(<範圍>): <主旨>`';
2657
+ 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
2658
  }
2635
2659
 
2636
2660
  if (outputLanguage === 'simplified-chinese') {
@@ -3043,7 +3067,10 @@ export function generateIntegrationContent(config) {
3043
3067
 
3044
3068
  // Include commit message language directive inside markers so it updates with marker-based updates
3045
3069
  if (outputLanguage) {
3046
- const commitLangSection = generateOutputLanguageDirective(outputLanguage, language);
3070
+ // A Simplified Chinese project that chose bilingual commits gets the Simplified directive, as the commit-standards
3071
+ // section above already does; the Traditional one named "English + 繁體中文" for a project that asked for 简体中文 (XSPEC-482 R13).
3072
+ const directiveLanguage = (outputLanguage === 'bilingual' && language === 'zh-cn') ? 'bilingual-zhcn' : outputLanguage;
3073
+ const commitLangSection = generateOutputLanguageDirective(directiveLanguage, language);
3047
3074
  if (commitLangSection) {
3048
3075
  standardsContent += commitLangSection + '\n\n';
3049
3076
  }
@@ -3330,9 +3357,7 @@ export function generateComplianceInstructions(
3330
3357
  sections.push('');
3331
3358
 
3332
3359
  if (mustFollow.length > 0) {
3333
- sections.push(language === 'en'
3334
- ? '**MUST follow** (always required):'
3335
- : '**MUST follow** (每次都要遵守):');
3360
+ sections.push(byLanguage(language, '**MUST follow** (always required):', '**MUST follow** (每次都要遵守):', '**MUST follow** (每次都要遵守):'));
3336
3361
  sections.push('| Task | Standard | When |');
3337
3362
  sections.push('|------|----------|------|');
3338
3363
  for (const entry of mustFollow) {
@@ -3342,9 +3367,7 @@ export function generateComplianceInstructions(
3342
3367
  }
3343
3368
 
3344
3369
  if (shouldFollow.length > 0) {
3345
- sections.push(language === 'en'
3346
- ? '**SHOULD follow** (when relevant):'
3347
- : '**SHOULD follow** (相關任務時參考):');
3370
+ sections.push(byLanguage(language, '**SHOULD follow** (when relevant):', '**SHOULD follow** (相關任務時參考):', '**SHOULD follow** (相关任务时参考):'));
3348
3371
  sections.push('| Task | Standard | When |');
3349
3372
  sections.push('|------|----------|------|');
3350
3373
  for (const entry of shouldFollow) {
@@ -3361,9 +3384,7 @@ export function generateComplianceInstructions(
3361
3384
  sections.push('');
3362
3385
 
3363
3386
  if (mustFollow.length > 0) {
3364
- sections.push(language === 'en'
3365
- ? 'MUST follow (always required):'
3366
- : 'MUST follow (每次都要遵守):');
3387
+ sections.push(byLanguage(language, 'MUST follow (always required):', 'MUST follow (每次都要遵守):', 'MUST follow (每次都要遵守):'));
3367
3388
  for (const entry of mustFollow) {
3368
3389
  sections.push(`- ${entry.task}: Read ${entry.standard} ${entry.when.toLowerCase()}`);
3369
3390
  }
@@ -3371,9 +3392,7 @@ export function generateComplianceInstructions(
3371
3392
  }
3372
3393
 
3373
3394
  if (shouldFollow.length > 0) {
3374
- sections.push(language === 'en'
3375
- ? 'SHOULD follow (when relevant):'
3376
- : 'SHOULD follow (相關任務時參考):');
3395
+ sections.push(byLanguage(language, 'SHOULD follow (when relevant):', 'SHOULD follow (相關任務時參考):', 'SHOULD follow (相关任务时参考):'));
3377
3396
  for (const entry of shouldFollow) {
3378
3397
  sections.push(`- ${entry.task}: Reference ${entry.standard}`);
3379
3398
  }
@@ -3427,14 +3446,23 @@ export function generateStandardsIndex(installedStandards, format, language = 'z
3427
3446
  ? ['', `${unresolved.length} further manifest entr${unresolved.length === 1 ? 'y has' : 'ies have'} no installed file and ${unresolved.length === 1 ? 'is' : 'are'} not counted above: ${unresolved.join(', ')}. Standards removed upstream stay in a manifest until someone drops them; \`uds update\` does not prune them.`]
3428
3447
  : [])
3429
3448
  ]
3430
- : [
3431
- `本專案採用 UDS 標準共 **${total}** 條(core ${coreCount}、options ${optionCount}),安裝於 \`.standards/\`。`,
3432
- '',
3433
- '權威清單為 `.standards/manifest.json` 的 `standards` 欄位。要知道某標準要求什麼,讀它自己的檔案——並看第一行,已棄用的標準會在那裡寫明。',
3434
- ...(unresolved.length > 0
3435
- ? ['', `另有 ${unresolved.length} 筆 manifest 項目沒有已安裝的檔案,未計入上方數字:${unresolved.join('、')}。上游移除的標準會留在 manifest 裡直到有人拿掉它;\`uds update\` 不會修剪它們。`]
3436
- : [])
3437
- ];
3449
+ : language === 'zh-cn'
3450
+ ? [
3451
+ `本项目采用 UDS 标准共 **${total}** 条(core ${coreCount}、options ${optionCount}),安装于 \`.standards/\`。`,
3452
+ '',
3453
+ '权威清单为 `.standards/manifest.json` 的 `standards` 字段。要知道某标准要求什么,读它自己的文件——并看第一行,已弃用的标准会在那里写明。',
3454
+ ...(unresolved.length > 0
3455
+ ? ['', `另有 ${unresolved.length} 笔 manifest 项目没有已安装的文件,未计入上方数字:${unresolved.join('、')}。上游移除的标准会留在 manifest 里直到有人拿掉它;\`uds update\` 不会修剪它们。`]
3456
+ : [])
3457
+ ]
3458
+ : [
3459
+ `本專案採用 UDS 標準共 **${total}** 條(core ${coreCount}、options ${optionCount}),安裝於 \`.standards/\`。`,
3460
+ '',
3461
+ '權威清單為 `.standards/manifest.json` 的 `standards` 欄位。要知道某標準要求什麼,讀它自己的檔案——並看第一行,已棄用的標準會在那裡寫明。',
3462
+ ...(unresolved.length > 0
3463
+ ? ['', `另有 ${unresolved.length} 筆 manifest 項目沒有已安裝的檔案,未計入上方數字:${unresolved.join('、')}。上游移除的標準會留在 manifest 裡直到有人拿掉它;\`uds update\` 不會修剪它們。`]
3464
+ : [])
3465
+ ];
3438
3466
 
3439
3467
  const plainBody = body.map((l) => l.replace(/`/g, ''));
3440
3468
  return [heading, '', ...(md ? body : plainBody), ''].join('\n');
@@ -3490,7 +3518,7 @@ function withSelectedOptions(manifest) {
3490
3518
  * Both call sites now use this function instead of re-deriving the value.
3491
3519
  *
3492
3520
  * @param {Object} manifest - Project manifest
3493
- * @returns {'en'|'zh-tw'|'bilingual'} Resolved content language
3521
+ * @returns {'en'|'zh-tw'|'zh-cn'|'bilingual'} Resolved content language
3494
3522
  */
3495
3523
  export function resolveIntegrationLanguage(manifest) {
3496
3524
  const selected = manifest.options?.output_language || manifest.options?.commit_language || 'english';
@@ -3498,7 +3526,7 @@ export function resolveIntegrationLanguage(manifest) {
3498
3526
  const fromOutput = selected === 'bilingual'
3499
3527
  ? 'bilingual'
3500
3528
  : selected === 'traditional-chinese' ? 'zh-tw' : 'en';
3501
- return ['en', 'zh-tw', 'bilingual'].includes(display) ? display : fromOutput;
3529
+ return ['en', 'zh-tw', 'zh-cn', 'bilingual'].includes(display) ? display : fromOutput; // wire:integration-language-zh-cn
3502
3530
  }
3503
3531
 
3504
3532
  export function buildToolIntegrationConfig(manifest, tool) {