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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (711) hide show
  1. package/bin/uds.js +12 -1
  2. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  3. package/bundled/ai/standards/commit-message.ai.yaml +12 -2
  4. package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
  5. package/bundled/core/commit-message-guide.md +22 -19
  6. package/bundled/core/secret-management-standards.md +13 -1
  7. package/bundled/extensions/locales/zh-tw.md +19 -19
  8. package/bundled/hooks/validate-commit-msg.mjs +52 -9
  9. package/bundled/locales/zh-CN/CHANGELOG.md +2309 -1110
  10. package/bundled/locales/zh-CN/CLAUDE.md +987 -101
  11. package/bundled/locales/zh-CN/README.md +3 -3
  12. package/bundled/locales/zh-CN/SECURITY.md +3 -3
  13. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  14. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
  15. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  16. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
  17. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
  18. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
  19. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
  20. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  21. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  22. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  23. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  24. package/bundled/locales/zh-CN/core/accessibility-standards.md +871 -62
  25. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  26. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  27. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  28. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  29. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  30. package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +311 -72
  31. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  32. package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
  33. package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
  34. package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
  35. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  36. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  37. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  38. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  39. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  40. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  41. package/bundled/locales/zh-CN/core/changelog-standards.md +485 -63
  42. package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
  43. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  44. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  45. package/bundled/locales/zh-CN/core/code-review-checklist.md +37 -23
  46. package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
  47. package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
  48. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  49. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  50. package/bundled/locales/zh-CN/core/deprecation-standards.md +155 -40
  51. package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
  52. package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
  53. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  54. package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
  55. package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
  56. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  57. package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
  58. package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
  59. package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
  60. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  61. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  62. package/bundled/locales/zh-CN/core/feature-flag-standards.md +202 -57
  63. package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
  64. package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
  65. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  66. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  67. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  68. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  69. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  70. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  71. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  72. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  73. package/bundled/locales/zh-CN/core/mutation-testing.md +45 -6
  74. package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
  75. package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
  76. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  77. package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
  78. package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
  79. package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
  80. package/bundled/locales/zh-CN/core/project-structure.md +550 -170
  81. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  82. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  83. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  84. package/bundled/locales/zh-CN/core/retrospective-standards.md +215 -22
  85. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  86. package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
  87. package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
  88. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  89. package/bundled/locales/zh-CN/core/security-standards.md +169 -16
  90. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  91. package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
  92. package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
  93. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  94. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  95. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  96. package/bundled/locales/zh-CN/core/supply-chain-security-standards.md +159 -32
  97. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  98. package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
  99. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  100. package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
  101. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  102. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  103. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  104. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  105. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  106. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  107. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  108. package/bundled/locales/zh-CN/core/versioning.md +737 -73
  109. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  110. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  111. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  112. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +2 -1
  113. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  114. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
  115. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
  116. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  117. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
  118. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  119. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
  120. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  121. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  122. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +2 -0
  123. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  124. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  125. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  126. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  127. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  128. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  129. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  130. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  131. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  132. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  133. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  134. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  135. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  136. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  137. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  138. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  139. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  140. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  141. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  142. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  143. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  144. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  145. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  146. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  147. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  148. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  149. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  150. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  151. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  152. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  153. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  154. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  155. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  156. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  157. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  158. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  159. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  160. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  161. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  162. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  163. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  164. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  165. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  166. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  167. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  168. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  169. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  170. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  171. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  172. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  173. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  174. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  175. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  176. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  177. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  178. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  179. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  180. package/bundled/locales/zh-CN/skills/README.md +2 -1
  181. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  182. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  183. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  184. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  185. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  186. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  187. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  188. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  189. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  190. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  191. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  192. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  193. package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +217 -137
  194. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  195. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  196. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  197. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  198. package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +148 -132
  199. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  200. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  201. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  202. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  203. package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +122 -121
  204. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  205. package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
  206. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  207. package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
  208. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  209. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  210. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  211. package/bundled/locales/zh-CN/skills/code-review-assistant/guide.md +119 -45
  212. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  213. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  214. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  215. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  216. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  217. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  218. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  219. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  220. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  221. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  222. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  223. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  224. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  225. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  226. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  227. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  228. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  229. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  230. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  231. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  232. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  233. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  234. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  235. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  236. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  237. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  238. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  239. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  240. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  241. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  242. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  243. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  244. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  245. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  246. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  247. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  248. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  249. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  250. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  251. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  252. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  253. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  254. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  255. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  256. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  257. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  258. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  259. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  260. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  261. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +4 -4
  262. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  263. package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
  264. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  265. package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
  266. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  267. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  268. package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +4 -2
  269. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  270. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  271. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  272. package/bundled/locales/zh-CN/skills/docs-generator/guide.md +8 -7
  273. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  274. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  275. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  276. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  277. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  278. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  279. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  280. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  281. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  282. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  283. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  284. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  285. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  286. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  287. package/bundled/locales/zh-CN/skills/project-discovery/guide.md +158 -157
  288. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  289. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  290. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  291. package/bundled/locales/zh-CN/skills/refactoring-assistant/guide.md +172 -171
  292. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  293. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  294. package/bundled/locales/zh-CN/skills/release-standards/guide.md +51 -43
  295. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  296. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  297. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  298. package/bundled/locales/zh-CN/skills/requirement-assistant/guide.md +88 -79
  299. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  300. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  301. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  302. package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +2 -2
  303. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  304. package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
  305. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  306. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  307. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  308. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  309. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  310. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  311. package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +2 -2
  312. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  313. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  314. package/bundled/locales/zh-CN/skills/tdd-assistant/guide.md +217 -156
  315. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  316. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  317. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  318. package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +25 -12
  319. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  320. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  321. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  322. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  323. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  324. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  325. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  326. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  327. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  328. package/bundled/locales/zh-TW/CHANGELOG.md +2282 -1112
  329. package/bundled/locales/zh-TW/CLAUDE.md +962 -76
  330. package/bundled/locales/zh-TW/README.md +3 -3
  331. package/bundled/locales/zh-TW/SECURITY.md +3 -3
  332. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  333. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
  334. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  335. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
  336. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
  337. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
  338. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
  339. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  340. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  341. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  342. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  343. package/bundled/locales/zh-TW/core/accessibility-standards.md +895 -46
  344. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  345. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  346. package/bundled/locales/zh-TW/core/agent-dispatch.md +102 -33
  347. package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
  348. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  349. package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
  350. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  351. package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
  352. package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
  353. package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
  354. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  355. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  356. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  357. package/bundled/locales/zh-TW/core/branch-completion.md +130 -34
  358. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  359. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  360. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  361. package/bundled/locales/zh-TW/core/chaos-engineering-standards.md +138 -36
  362. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  363. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  364. package/bundled/locales/zh-TW/core/code-review-checklist.md +19 -7
  365. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  366. package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
  367. package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
  368. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  369. package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
  370. package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
  371. package/bundled/locales/zh-TW/core/developer-memory.md +102 -12
  372. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  373. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  374. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  375. package/bundled/locales/zh-TW/core/environment-standards.md +250 -72
  376. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  377. package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
  378. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  379. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  380. package/bundled/locales/zh-TW/core/feature-flag-standards.md +202 -57
  381. package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
  382. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  383. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  384. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  385. package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +234 -487
  386. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  387. package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
  388. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  389. package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
  390. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  391. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  392. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  393. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  394. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  395. package/bundled/locales/zh-TW/core/observability-standards.md +284 -40
  396. package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
  397. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  398. package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
  399. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  400. package/bundled/locales/zh-TW/core/project-context-memory.md +210 -31
  401. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  402. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  403. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  404. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  405. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  406. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  407. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  408. package/bundled/locales/zh-TW/core/runbook-standards.md +296 -23
  409. package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
  410. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  411. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  412. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  413. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  414. package/bundled/locales/zh-TW/core/slo-standards.md +301 -49
  415. package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
  416. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  417. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  418. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  419. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  420. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  421. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  422. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  423. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  424. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  425. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  426. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  427. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  428. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  429. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  430. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  431. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  432. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  433. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  434. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  435. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +2 -1
  436. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  437. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
  438. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  439. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
  440. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  441. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
  442. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  443. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
  444. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  445. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  446. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +2 -0
  447. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  448. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  449. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  450. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  451. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  452. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  453. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  454. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  455. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  456. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  457. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  458. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  459. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  460. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  461. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  462. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  463. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  464. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  465. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  466. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  467. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  468. package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +584 -475
  469. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  470. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  471. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  472. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  473. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  474. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  475. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  476. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  477. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  478. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  479. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  480. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  481. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  482. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  483. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  484. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  485. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  486. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  487. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  488. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  489. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  490. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  491. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  492. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  493. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  494. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  495. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  496. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  497. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  498. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  499. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  500. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  501. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  502. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  503. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  504. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  505. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  506. package/bundled/locales/zh-TW/skills/README.md +2 -1
  507. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  508. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  509. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  510. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  511. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  512. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  513. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  514. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  515. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  516. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  517. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  518. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  519. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  520. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  521. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  522. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  523. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  524. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  525. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  526. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  527. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  528. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  529. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  530. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  531. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  532. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  533. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  534. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  535. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  536. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  537. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  538. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  539. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  540. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  541. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  542. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  543. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  544. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  545. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  546. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  547. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  548. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  549. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  550. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  551. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  552. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  553. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  554. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  555. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  556. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  557. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  558. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  559. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  560. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  561. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  562. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  563. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  564. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  565. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  566. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  567. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  568. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  569. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  570. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  571. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  572. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  573. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  574. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  575. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  576. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  577. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  578. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  579. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  580. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  581. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  582. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  583. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  584. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  585. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  586. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  587. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  588. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  589. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  590. package/bundled/locales/zh-TW/skills/commit-standards/guide.md +137 -17
  591. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  592. package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
  593. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  594. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  595. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  596. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  597. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  598. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  599. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  600. package/bundled/locales/zh-TW/skills/docs-generator/guide.md +4 -3
  601. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  602. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  603. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  604. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  605. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  606. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  607. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  608. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  609. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  610. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  611. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  612. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  613. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  614. package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +85 -18
  615. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  616. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  617. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  618. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  619. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  620. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  621. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  622. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  623. package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +91 -45
  624. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  625. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  626. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  627. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  628. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  629. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  630. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  631. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  632. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  633. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  634. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  635. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  636. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  637. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  638. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  639. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  640. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  641. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  642. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  643. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  644. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  645. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  646. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  647. package/bundled/locales/zh-TW/skills/tdd-assistant/language-examples.md +693 -47
  648. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  649. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  650. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  651. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  652. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  653. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  654. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  655. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  656. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  657. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  658. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  659. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  660. package/bundled/skills/.claude-plugin/plugin.json +71 -0
  661. package/bundled/skills/commit-standards/SKILL.md +2 -2
  662. package/bundled/skills/commit-standards/guide.md +3 -2
  663. package/bundled/skills/commit-standards/language-options.md +19 -17
  664. package/package.json +2 -2
  665. package/src/commands/audit.js +28 -1
  666. package/src/commands/check.js +72 -3
  667. package/src/commands/compile.js +37 -4
  668. package/src/commands/config.js +49 -24
  669. package/src/commands/init.js +78 -30
  670. package/src/commands/open-work.js +6 -2
  671. package/src/commands/release-messages.js +228 -0
  672. package/src/commands/release.js +127 -68
  673. package/src/commands/run-intent.js +11 -0
  674. package/src/commands/spec.js +4 -2
  675. package/src/commands/update.js +173 -20
  676. package/src/compilers/claude-code-compiler.js +9 -1
  677. package/src/config/ai-agent-paths.js +14 -1
  678. package/src/core/installed-formats.js +15 -0
  679. package/src/core/open-work-config.js +20 -1
  680. package/src/core/project-config.js +55 -0
  681. package/src/i18n/messages.js +106 -2
  682. package/src/installers/hooks-installer.js +1 -1
  683. package/src/installers/manifest-installer.js +1 -1
  684. package/src/installers/skills-installer.js +1 -1
  685. package/src/installers/standards-installer.js +3 -1
  686. package/src/mcp/server.js +9 -3
  687. package/src/prompts/init.js +26 -22
  688. package/src/reconciler/actual-state-scanner.js +2 -8
  689. package/src/reconciler/backup-locations.js +5 -0
  690. package/src/reconciler/backup-manager.js +19 -11
  691. package/src/reconciler/desired-state-calculator.js +89 -57
  692. package/src/reconciler/plan-executor.js +101 -8
  693. package/src/reconciler/recorded-versions.js +49 -0
  694. package/src/reconciler/relative-path.js +23 -0
  695. package/src/uninstallers/hook-uninstaller.js +9 -1
  696. package/src/uninstallers/skills-uninstaller.js +22 -3
  697. package/src/utils/available-standards-report.js +25 -4
  698. package/src/utils/available-standards.js +13 -3
  699. package/src/utils/build-manifest.js +1 -1
  700. package/src/utils/commit-message-judge.js +60 -13
  701. package/src/utils/friction-detector.js +23 -11
  702. package/src/utils/git-hooks.js +106 -4
  703. package/src/utils/integration-generator.js +95 -67
  704. package/src/utils/legacy-hook-migration.js +121 -2
  705. package/src/utils/open-work-tracking.mjs +105 -16
  706. package/src/utils/sdd-header.js +16 -4
  707. package/src/utils/skills-installer.js +2 -1
  708. package/src/utils/spinner.js +14 -4
  709. package/src/utils/standard-validator.js +3 -2
  710. package/standards-registry.json +10 -8
  711. package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
package/bin/uds.js CHANGED
@@ -233,7 +233,8 @@ program
233
233
  .option('--apply', 'Apply exactly the plan --plan prints (plain `uds update` does not); with --skills/--commands it does the reconciliation AND that scope, not only the scope')
234
234
  .option('--force', 'Force update all files, ignoring hash comparison')
235
235
  .option('--prune', 'Delete .standards/ files UDS wrote but no longer ships (listed without this flag; never touches files UDS did not write)')
236
- .option('--rollback', 'Rollback to the most recent backup')
236
+ .option('--rollback', 'Rollback to the most recent backup (with the series of updates that follow from it)')
237
+ .option('--from <backup>', 'With --rollback: restore this one backup instead of the most recent series (the id --rollback prints, or its folder name); use it for a backup an older UDS made')
237
238
  .option('--add-standard <id>', 'With --plan or --apply: also install this standard UDS ships and the project lacks, and record it in the manifest (repeatable; `uds update --plan` lists what is available)', (value, previous) => [...previous, value], [])
238
239
  .option('--claude-target <target>', 'Switch an existing install to a different Claude Code integration target: project (CLAUDE.md) or local (CLAUDE.local.md) — moves the UDS block, keeps your content, no reinstall')
239
240
  .option('--locale <locale>', 'Override locale for skills install (zh-tw, zh-cn, en); also reads .uds/install.yaml + UDS_LOCALE env')
@@ -308,11 +309,17 @@ program
308
309
  console.error(result.error);
309
310
  process.exit(1);
310
311
  }
312
+ // What was left out goes to stderr in a dry run, so stdout stays the JSON it has always been.
313
+ const note = result.dryRun ? console.error : console.log;
311
314
  if (result.dryRun) {
312
315
  console.log(JSON.stringify(result.config, null, 2));
313
316
  } else {
314
317
  console.log(`Compiled ${result.compiledCount} enforcement standard(s) for ${options.target}`);
315
318
  }
319
+ for (const s of result.skipped || []) note(` Skipped ${s.id}: ${s.why}`);
320
+ if ((result.skipped || []).length > 0) {
321
+ note(' Install the hook scripts with \'uds update --with-hooks\' (or \'uds init --with-hooks\'), then compile again.');
322
+ }
316
323
  });
317
324
 
318
325
  program
@@ -485,6 +492,8 @@ openWorkCommand
485
492
  .option('--stale-after <days>', 'A waiting-on-reply row asked more than this many days ago is marked STALE (default 7, an uncalibrated initial judgment)')
486
493
  .option('--next-action-word <word>', 'A word that means "next action" in your carriers, as plain text; repeatable (also open_work.next_action_words in uds.project.yaml)', collectOption, [])
487
494
  .option('--command-word <word>', 'A program name to read as a command, for example kubectl; repeatable (also open_work.command_words in uds.project.yaml)', collectOption, [])
495
+ .option('--asked-at-word <word>', 'A word that heads your "when was it asked" column, as plain text; repeatable (also open_work.asked_at_words in uds.project.yaml)', collectOption, [])
496
+ .option('--waiting-for-word <word>', 'A word that heads your "what is it waiting for" column, as plain text; repeatable (also open_work.waiting_for_words in uds.project.yaml)', collectOption, [])
488
497
  .action(openWorkNextActionCommand);
489
498
 
490
499
  openWorkCommand
@@ -509,6 +518,8 @@ openWorkCommand
509
518
  .option('--id-pattern <regex>', 'Your own requirement-identifier pattern (the default is an uncalibrated initial judgment)')
510
519
  .option('--now <date>', 'Treat this day (YYYY-MM-DD) as today, so a result does not drift with the date')
511
520
  .option('--command-word <word>', 'A program name to read as a command, for example kubectl; repeatable (also open_work.command_words in uds.project.yaml)', collectOption, [])
521
+ .option('--asked-at-word <word>', 'A word that heads your "when was it asked" column, as plain text; repeatable (also open_work.asked_at_words in uds.project.yaml)', collectOption, [])
522
+ .option('--waiting-for-word <word>', 'A word that heads your "what is it waiting for" column, as plain text; repeatable (also open_work.waiting_for_words in uds.project.yaml)', collectOption, [])
512
523
  .action(openWorkWaitingCommand);
513
524
 
514
525
  openWorkCommand
@@ -1,93 +1,95 @@
1
- # Traditional Chinese Commit Types - AI Optimized Option
1
+ # Traditional Chinese Commit Messages - AI Optimized Option
2
2
  # Parent: commit-message
3
+ #
4
+ # 2.0.0 (XSPEC-475 OQ1): the TYPE is English (feat, fix, ...) exactly as in the english option; the SUBJECT (and the
5
+ # body) is Traditional Chinese. Before 2.0.0 this file listed Chinese types (新增, 修正, ...) while the human-readable
6
+ # option (options/commit-message/traditional-chinese.md) and every adopter's commitlint type-enum already used English
7
+ # types. A Chinese type is no longer allowed.
3
8
 
4
9
  id: traditional-chinese
5
10
  meta:
6
11
  parent: commit-message
7
- version: "1.0.0"
8
- description: Traditional Chinese commit types for local teams
12
+ version: "2.0.0"
13
+ description: English commit types with Traditional Chinese subjects, for local teams
9
14
 
10
15
  best_for:
11
16
  - local teams in Taiwan
12
17
  - internal projects
13
18
  - teams preferring native language
14
19
 
20
+ format:
21
+ template: "<type>(<scope>): <Traditional Chinese subject>"
22
+ note: Type is English (same list as the english option); scope is lowercase English or Chinese; the subject and body may be Traditional Chinese
23
+
15
24
  types:
16
- - type: 新增
17
- english: feat
18
- description: 新功能
19
- example: "新增(認證): 加入 OAuth2 登入"
20
-
21
- - type: 修正
22
- english: fix
23
- description: 錯誤修正
24
- example: "修正(API): 處理空值回應"
25
-
26
- - type: 重構
27
- english: refactor
28
- description: 程式碼重構(無功能變更)
29
- example: "重構(核心): 簡化驗證邏輯"
30
-
31
- - type: 文件
32
- english: docs
33
- description: 僅文件更新
34
- example: "文件(說明): 更新安裝指南"
35
-
36
- - type: 樣式
37
- english: style
38
- description: 格式調整(無邏輯變更)
39
- example: "樣式(排版): 修正縮排"
40
-
41
- - type: 測試
42
- english: test
43
- description: 新增或更新測試
44
- example: "測試(認證): 新增登入單元測試"
45
-
46
- - type: 效能
47
- english: perf
48
- description: 效能改善
49
- example: "效能(查詢): 最佳化資料庫查詢"
50
-
51
- - type: 建置
52
- english: build
53
- description: 建置系統或相依套件
54
- example: "建置(套件): 升級 lodash 至 4.17.21"
55
-
56
- - type: 整合
57
- english: ci
58
- description: CI/CD 流程變更
59
- example: "整合(GitHub): 新增程式碼覆蓋率工作流程"
60
-
61
- - type: 維護
62
- english: chore
63
- description: 維護任務
64
- example: "維護(套件): 更新開發相依套件"
65
-
66
- - type: 回退
67
- english: revert
68
- description: 還原先前提交
69
- example: "回退: 新增(認證): 加入 OAuth2 登入"
70
-
71
- - type: 安全
72
- english: security
73
- description: 安全漏洞修正
74
- example: "安全(認證): 修正 XSS 漏洞"
25
+ - type: feat
26
+ description: New feature (新功能)
27
+ example: "feat(auth): 加入 OAuth2 登入"
28
+
29
+ - type: fix
30
+ description: Bug fix (錯誤修正)
31
+ example: "fix(api): 處理空值回應"
32
+
33
+ - type: refactor
34
+ description: Code refactoring, no functional change (程式碼重構)
35
+ example: "refactor(core): 簡化驗證邏輯"
36
+
37
+ - type: docs
38
+ description: Documentation only (僅文件更新)
39
+ example: "docs(readme): 更新安裝指南"
40
+
41
+ - type: style
42
+ description: Formatting, no logic change (格式調整)
43
+ example: "style(lint): 修正縮排"
44
+
45
+ - type: test
46
+ description: Adding or updating tests (新增或更新測試)
47
+ example: "test(auth): 新增登入單元測試"
48
+
49
+ - type: perf
50
+ description: Performance improvement (效能改善)
51
+ example: "perf(query): 最佳化資料庫查詢"
52
+
53
+ - type: build
54
+ description: Build system or dependencies (建置系統或相依套件)
55
+ example: "build(deps): 升級 lodash 至 4.17.21"
56
+
57
+ - type: ci
58
+ description: CI/CD pipeline changes (CI/CD 流程變更)
59
+ example: "ci(github): 新增程式碼覆蓋率工作流程"
60
+
61
+ - type: chore
62
+ description: Maintenance tasks (維護任務)
63
+ example: "chore(deps): 更新開發相依套件"
64
+
65
+ - type: revert
66
+ description: Revert a previous commit (還原先前提交)
67
+ example: "revert: feat(auth): 加入 OAuth2 登入"
68
+
69
+ - type: security
70
+ description: Security vulnerability fix (安全漏洞修正)
71
+ example: "security(auth): 修正 XSS 漏洞"
75
72
 
76
73
  rules:
77
- - id: chinese-type
74
+ - id: english-type
78
75
  trigger: writing commit type
79
- instruction: Use Chinese type from the types list
76
+ instruction: Use the English type from the types list (feat, fix, docs, ...); a Chinese type such as 新增 is not allowed
80
77
  priority: required
81
78
 
79
+ - id: chinese-subject
80
+ trigger: writing commit subject
81
+ instruction: Write the subject in Traditional Chinese
82
+ priority: recommended
83
+
82
84
  - id: chinese-scope
83
85
  trigger: writing commit scope
84
- instruction: Scope can be Chinese or English, but be consistent
86
+ instruction: Scope can be Chinese or English, but be consistent; English scope is lowercase
85
87
  priority: recommended
86
88
 
87
89
  examples:
88
- simple: "新增(認證): 加入登入表單"
90
+ simple: "feat(auth): 加入登入表單"
89
91
  with_body: |
90
- 新增(認證): 加入 OAuth2 登入支援
92
+ feat(auth): 加入 OAuth2 登入支援
91
93
 
92
94
  實作 Google OAuth2 認證流程。
93
95
  - 整合 Google OAuth2 SDK
@@ -13,8 +13,8 @@ standard:
13
13
  - "Reference issue numbers in footer"
14
14
 
15
15
  meta:
16
- version: "2.0.0"
17
- updated: "2026-02-04"
16
+ version: "2.1.0"
17
+ updated: "2026-10-12"
18
18
  source: core/commit-message-guide.md
19
19
  description: Conventional Commits format for standardized git commit messages
20
20
 
@@ -60,6 +60,7 @@ standard:
60
60
  choices:
61
61
  - id: english
62
62
  file: options/commit-message/english.ai.yaml
63
+ # 1.4.0 of the guide (XSPEC-475): traditional-chinese = English type + Traditional Chinese subject and body.
63
64
  - id: traditional-chinese
64
65
  file: options/commit-message/traditional-chinese.ai.yaml
65
66
  - id: bilingual
@@ -74,6 +75,15 @@ standard:
74
75
  trigger: writing commit message
75
76
  instruction: Use the same language consistently across all commits
76
77
  priority: required
78
+ - id: english-type
79
+ trigger: choosing the commit type under any language option
80
+ instruction: >-
81
+ The type is always an English word from the chosen option's list (feat, fix, docs, ...), also under
82
+ traditional-chinese, where only the subject and body are Traditional Chinese (feat(auth): 加入 OAuth2 登入).
83
+ A Chinese type such as 新增 is not allowed. Migration from guide versions before 1.4.0:
84
+ 新增->feat, 修正->fix, 重構->refactor, 文件->docs, 樣式->style, 測試->test, 效能->perf, 建置->build,
85
+ 整合->ci, 維護->chore, 回退->revert, 安全->security.
86
+ priority: required
77
87
  - id: subject-max-length
78
88
  trigger: writing commit subject
79
89
  instruction: Keep subject line under 72 characters
@@ -3,7 +3,7 @@
3
3
 
4
4
  id: secret-management-standards
5
5
  title: Secret Management and Credential Hygiene Standards
6
- version: "1.0.0"
6
+ version: "1.1.0"
7
7
  status: Active
8
8
  tags: [secrets, vault, kms, sops, security, rotation, credential-management]
9
9
  summary: |
@@ -67,9 +67,20 @@ requirements:
67
67
  format (AKIA[0-9A-Z]{16}), PEM private key headers (-----BEGIN .* PRIVATE KEY),
68
68
  generic API token patterns (api[_-]?key\s*[:=]\s*\S{16,}), and
69
69
  connection strings containing passwords.
70
+ How the scanners are run is governed by pipeline-security-gates
71
+ (PSG-1 to PSG-3): PSG-1 the scan output MUST NOT contain the matched
72
+ secret value (file, line and rule name only); PSG-2 a scanner that
73
+ cannot run counts as a failed gate and MUST block the commit or
74
+ pipeline; PSG-3 every detection rule the team writes itself SHOULD have
75
+ a red sample (must be caught) and a green sample (must not be
76
+ reported), executed in a test.
70
77
  level: MUST
78
+ references:
79
+ - pipeline-security-gates
71
80
  examples:
72
81
  - "`.pre-commit-config.yaml` includes `detect-secrets` hook; fails on AWS key pattern"
82
+ - "PSG-1: CI log shows `rule aws-access-key at config/dev.env:12`, never the key itself (gitleaks run with `--redact`)"
83
+ - "PSG-2: gitleaks binary missing in the CI image -> the job fails, it does not pass with no scan"
73
84
  - "CI step: `gitleaks detect --source . --exit-code 1` blocks PR merge"
74
85
  - "False positive whitelisted via `.secrets.baseline` with documented justification"
75
86
  - "Developer receives pre-commit error: 'High confidence secret detected: AWS Access Key'"
@@ -2,8 +2,8 @@
2
2
 
3
3
  > **Language**: English | [繁體中文](../locales/zh-TW/core/commit-message-guide.md)
4
4
 
5
- **Version**: 1.3.0
6
- **Last Updated**: 2025-12-24
5
+ **Version**: 1.4.0
6
+ **Last Updated**: 2026-10-12
7
7
  **Applicability**: All projects using Git version control
8
8
  **Scope**: universal
9
9
  **Industry Standards**: Conventional Commits 1.0.0
@@ -64,22 +64,24 @@ Use English types for international teams and maximum tool compatibility.
64
64
 
65
65
  ### Option B: Traditional Chinese (Taiwanese Teams)
66
66
 
67
- Use Traditional Chinese types for local teams preferring native language commits.
68
-
69
- | Type | When to Use | English Equivalent |
70
- | ------ | -------------------- | ------------------ |
71
- | `新增` | New feature | feat |
72
- | `修正` | Bug fix | fix |
73
- | `重構` | Refactoring | refactor |
74
- | `文件` | Documentation only | docs |
75
- | `樣式` | Formatting only | style |
76
- | `測試` | Adding/updating tests | test |
77
- | `效能` | Performance | perf |
78
- | `建置` | Build system | build |
79
- | `整合` | CI/CD changes | ci |
80
- | `維護` | Maintenance | chore |
81
- | `回退` | Revert commit | revert |
82
- | `安全` | Security fix | security |
67
+ Use the **English types of Option A** with a Traditional Chinese subject and body, for local teams preferring native language commits. The type stays English because tools read it (commitlint `type-enum`, changelog generators, `uds simulate`); only the subject and body are Chinese. A Chinese type such as `新增` is **not** allowed.
68
+
69
+ | Type | When to Use | Example |
70
+ | ---------- | --------------------- | --------------------------------- |
71
+ | `feat` | New feature | `feat(auth): 加入 OAuth2 登入` |
72
+ | `fix` | Bug fix | `fix(api): 處理空值回應` |
73
+ | `refactor` | Refactoring | `refactor(core): 簡化驗證邏輯` |
74
+ | `docs` | Documentation only | `docs(readme): 更新安裝指南` |
75
+ | `style` | Formatting only | `style(lint): 修正縮排` |
76
+ | `test` | Adding/updating tests | `test(auth): 新增登入單元測試` |
77
+ | `perf` | Performance | `perf(query): 最佳化資料庫查詢` |
78
+ | `build` | Build system | `build(deps): 升級 lodash` |
79
+ | `ci` | CI/CD changes | `ci(github): 新增覆蓋率工作流程` |
80
+ | `chore` | Maintenance | `chore(deps): 更新開發相依套件` |
81
+ | `revert` | Revert commit | `revert: feat(auth): 加入 OAuth2 登入` |
82
+ | `security` | Security fix | `security(auth): 修正 XSS 漏洞` |
83
+
84
+ > **Changed in 1.4.0** (XSPEC-475): earlier versions of this option listed Chinese types (`新增`, `修正`, ...). They are no longer allowed; a project that used them migrates by replacing the type with its English equivalent (`新增` → `feat`, `修正` → `fix`, `重構` → `refactor`, `文件` → `docs`, `樣式` → `style`, `測試` → `test`, `效能` → `perf`, `建置` → `build`, `整合` → `ci`, `維護` → `chore`, `回退` → `revert`, `安全` → `security`).
83
85
 
84
86
  ### Option C: Bilingual Mode (Recommended)
85
87
 
@@ -151,7 +153,7 @@ Use this guide to choose the appropriate commit message language for your projec
151
153
  This project uses **English** commit types (feat, fix, refactor, etc.)
152
154
 
153
155
  <!-- Option B: Traditional Chinese -->
154
- This project uses **Traditional Chinese** commit types (新增, 修正, 重構, etc.)
156
+ This project uses **English** commit types (feat, fix, refactor, etc.) with **Traditional Chinese** subjects and bodies
155
157
 
156
158
  <!-- Option C: Bilingual Mode -->
157
159
  This project uses **Bilingual Mode** with English types/scopes and bilingual subject/body.
@@ -936,6 +938,7 @@ Closes #123
936
938
 
937
939
  | Version | Date | Changes |
938
940
  | ------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
941
+ | 1.4.0 | 2026-10-12 | Changed: Option B (Traditional Chinese) uses English types with Traditional Chinese subject and body; Chinese types (新增, 修正, ...) are no longer allowed (XSPEC-475 OQ1). Migration table added |
939
942
  | 1.3.0 | 2026-03-16 | Added: Spec reference footer convention (Refs: SPEC-XXX) |
940
943
  | 1.2.3 | 2025-12-24 | Added: Related Standards section |
941
944
  | 1.2.2 | 2025-12-16 | Added: Language selection guide with decision matrix and quick selection tips |
@@ -1,6 +1,6 @@
1
1
  # Secret Management and Credential Hygiene Standards
2
2
 
3
- > **Version**: 1.0.0 | **Status**: Active | **Updated**: 2026-06-17
3
+ > **Version**: 1.1.0 | **Status**: Active | **Updated**: 2026-10-12
4
4
  > **AI-optimized version**: `ai/standards/secret-management-standards.ai.yaml`
5
5
  > **Spec**: XSPEC-065 (cross-project/specs/XSPEC-065-uds-infrastructure-pack.md)
6
6
 
@@ -69,6 +69,14 @@ detected patterns: AWS access key format (`AKIA[0-9A-Z]{16}`), PEM private key
69
69
  headers (`-----BEGIN .* PRIVATE KEY`), generic API token patterns
70
70
  (`api[_-]?key\s*[:=]\s*\S{16,}`), and connection strings containing passwords.
71
71
 
72
+ How the scanners are run is governed by [`pipeline-security-gates`](./pipeline-security-gates.md), and the
73
+ three rules there apply to every scanner this requirement asks for: **PSG-1** — the scan output (terminal, CI log,
74
+ report file) MUST NOT contain the matched secret value, only the file, the line and the rule name; **PSG-2** — a
75
+ scanner that cannot run (not installed, crashed, no network for its rules) counts as a failed gate and MUST block the
76
+ commit or the pipeline, never let it through; **PSG-3** — every detection rule the team writes itself SHOULD have one
77
+ sample that must be caught (red) and one that must not be reported (green), executed in a test. The four minimum
78
+ patterns above are the rules PSG-3 applies to when a team writes its own.
79
+
72
80
  ### REQ-004 — Secret Injection
73
81
 
74
82
  Secrets MUST be injected into application processes via environment variables or
@@ -91,6 +99,9 @@ secrets as read-only volumes with restrictive file permissions (0400 or 0600).
91
99
 
92
100
  - **`iac-design-principles`** — secret backends (Vault/KMS state) are themselves
93
101
  versioned, access-controlled infrastructure.
102
+ - **`pipeline-security-gates`** — PSG-1 to PSG-3 govern how the scanners of REQ-003 are run (no secret value in
103
+ their output, a scanner that cannot run blocks, red and green samples for self-written rules); the two standards
104
+ point at each other.
94
105
  - **`audit-trail`** — rotation, access, and injection events are auditable
95
106
  operations (REQ-002 mandates logging rotation events).
96
107
  - **`pii-classification`** — credentials guarding TIER-1 PII inherit the strictest
@@ -107,4 +118,5 @@ secrets as read-only volumes with restrictive file permissions (0400 or 0600).
107
118
 
108
119
  | Version | Date | Changes |
109
120
  |---------|------|---------|
121
+ | v1.1.0 | 2026-10-12 | REQ-003 points to `pipeline-security-gates` PSG-1 to PSG-3 for how the scanners are run; integration section lists the cross-reference (XSPEC-475 OQ3) |
110
122
  | v1.0.0 | 2026-06-17 | Initial — REQ-001~004: secret source options, rotation policy, hardcoded-secret prevention, secret injection (XSPEC-065) |
@@ -348,29 +348,29 @@ public class UserService
348
348
 
349
349
  ### Commit Types in Traditional Chinese | 繁體中文 Commit 類型
350
350
 
351
- Use Traditional Chinese types for Taiwan-based teams:
352
-
353
- | 繁體中文類型 | 英文對應 | 說明 |
354
- |------------|---------|------|
355
- | `新增` | feat | 新功能 |
356
- | `修正` | fix | Bug 修復 |
357
- | `重構` | refactor | 程式碼重構 |
358
- | `文件` | docs | 文件更新 |
359
- | `測試` | test | 測試相關 |
360
- | `樣式` | style | 程式碼格式 |
361
- | `效能` | perf | 效能優化 |
362
- | `建置` | build | 建置系統 |
363
- | `整合` | ci | CI/CD 變更 |
364
- | `維護` | chore | 維護任務 |
365
- | `回退` | revert | 回退提交 |
366
- | `安全` | security | 安全漏洞修復 |
351
+ Use the **English type** with a **Traditional Chinese subject and body** for Taiwan-based teams (XSPEC-475). A Chinese type such as `新增` is not allowed, because commitlint's `type-enum` and `uds simulate` read English types:
352
+
353
+ | 英文類型 | 說明 | 範例 |
354
+ |---------|------|------|
355
+ | `feat` | 新功能 | `feat(auth): 加入 OAuth2 登入` |
356
+ | `fix` | Bug 修復 | `fix(api): 處理空值回應` |
357
+ | `refactor` | 程式碼重構 | `refactor(core): 簡化驗證邏輯` |
358
+ | `docs` | 文件更新 | `docs(readme): 更新安裝指南` |
359
+ | `test` | 測試相關 | `test(auth): 新增登入單元測試` |
360
+ | `style` | 程式碼格式 | `style(lint): 修正縮排` |
361
+ | `perf` | 效能優化 | `perf(query): 最佳化資料庫查詢` |
362
+ | `build` | 建置系統 | `build(deps): 升級 lodash` |
363
+ | `ci` | CI/CD 變更 | `ci(github): 新增覆蓋率工作流程` |
364
+ | `chore` | 維護任務 | `chore(deps): 更新開發相依套件` |
365
+ | `revert` | 回退提交 | `revert: feat(auth): 加入 OAuth2 登入` |
366
+ | `security` | 安全漏洞修復 | `security(auth): 修正 XSS 漏洞` |
367
367
 
368
368
  ---
369
369
 
370
370
  ### Commit Message Examples | Commit 訊息範例
371
371
 
372
372
  ```
373
- 新增(認證): 實作 OAuth2 Google 登入功能
373
+ feat(auth): 實作 OAuth2 Google 登入功能
374
374
 
375
375
  - 新增 GoogleAuthService 處理 Google OAuth2 流程
376
376
  - 整合 JWT token 產生邏輯
@@ -385,7 +385,7 @@ Closes #123
385
385
  ```
386
386
 
387
387
  ```
388
- 修正(API): 解決並發更新使用者資料時的競爭條件
388
+ fix(api): 解決並發更新使用者資料時的競爭條件
389
389
 
390
390
  問題原因:
391
391
  - 兩個同時發出的 PUT /users/:id 請求會互相覆蓋
@@ -406,7 +406,7 @@ Fixes #456
406
406
  ```
407
407
 
408
408
  ```
409
- 重構(資料庫): 提取連線池管理為獨立模組
409
+ refactor(database): 提取連線池管理為獨立模組
410
410
 
411
411
  重構原因:
412
412
  - 連線池邏輯散落在多個 Repository 中
@@ -23,30 +23,73 @@
23
23
  * @see docs/specs/SPEC-HOOKS-001-core-standard-hooks.md (REQ-1)
24
24
  */
25
25
 
26
- const VALID_TYPES = [
27
- 'feat', 'fix', 'docs', 'chore', 'test',
28
- 'refactor', 'style', 'perf', 'ci', 'build', 'revert',
26
+ import { existsSync, readdirSync, readFileSync } from 'node:fs';
27
+ import { join } from 'node:path';
28
+
29
+ /**
30
+ * Used only when the project has no commit-message option file: the Conventional Commits set. Same list `uds simulate
31
+ * -s commit-message` falls back to (FALLBACK_TYPES in cli/src/utils/commit-message-judge.js).
32
+ */
33
+ const FALLBACK_TYPES = [
34
+ 'feat', 'fix', 'docs', 'style', 'refactor', 'perf', 'test', 'build', 'ci', 'chore', 'revert',
29
35
  ];
30
36
 
31
- const COMMIT_PATTERN = new RegExp(
32
- `^(${VALID_TYPES.join('|')})(\\(.+\\))?:\\s.+`
33
- );
37
+ /**
38
+ * The commit types the project allows: those listed by the commit-message option files installed in
39
+ * `.standards/options/` (a file whose `meta.parent` is `commit-message`), or the fallback set when there are none.
40
+ *
41
+ * XSPEC-482 R12: this was a fixed list that lacked `security`, so `uds simulate` (which reads these same files) passed
42
+ * `security(auth): rotate keys` and this hook refused it. The two now read one source. The hook has no YAML parser
43
+ * to lean on (it runs in the adopter's project with no dependencies), so it reads the two things it needs line by line:
44
+ * the `parent:` of the `meta:` block and the `- type:` entries under `types:`.
45
+ *
46
+ * @param {string} [root] - the project root; defaults to $CLAUDE_PROJECT_DIR or the working directory
47
+ * @returns {string[]}
48
+ */
49
+ export function allowedTypes(root = process.env.CLAUDE_PROJECT_DIR || process.cwd()) {
50
+ const found = new Set();
51
+ const optionsDir = join(root, '.standards', 'options');
52
+ for (const dir of [optionsDir, join(optionsDir, 'commit-message')]) {
53
+ if (!existsSync(dir)) continue;
54
+ let names = [];
55
+ try { names = readdirSync(dir).filter((n) => n.endsWith('.ai.yaml')); } catch { continue; }
56
+ for (const name of names) {
57
+ let text = '';
58
+ try { text = readFileSync(join(dir, name), 'utf-8').replace(/\r\n/g, '\n'); } catch { continue; }
59
+ if (!/^\s+parent:\s*["']?commit-message["']?\s*$/m.test(text)) continue;
60
+ const lines = text.split('\n');
61
+ const start = lines.findIndex((l) => /^types:\s*$/.test(l));
62
+ if (start === -1) continue;
63
+ for (let i = start + 1; i < lines.length; i++) {
64
+ if (/^\S/.test(lines[i]) && !lines[i].startsWith('#')) break; // next top-level key
65
+ const m = /^\s*-\s+type:\s*["']?([^"'#\s][^"'#]*?)["']?\s*(?:#.*)?$/.exec(lines[i]);
66
+ if (m) found.add(m[1]);
67
+ }
68
+ }
69
+ }
70
+ return found.size > 0 ? [...found] : FALLBACK_TYPES;
71
+ }
72
+
73
+ const escapeRe = (t) => t.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
34
74
 
35
75
  /**
36
76
  * Validate a commit message against Conventional Commits format.
37
77
  * @param {string} msg - The commit message to validate
78
+ * @param {string[]} [types] - the allowed types (default: the project's, see allowedTypes)
38
79
  * @returns {boolean} true if valid
39
80
  */
40
- export function validateCommitMessage(msg) {
81
+ export function validateCommitMessage(msg, types = allowedTypes()) {
41
82
  if (!msg || typeof msg !== 'string') return false;
42
- return COMMIT_PATTERN.test(msg.trim());
83
+ // `type(scope)!: subject`: scope and the breaking-change mark are optional, as in `uds simulate`.
84
+ const pattern = new RegExp(`^(${types.map(escapeRe).join('|')})(\\(.+\\))?!?:\\s.+`, 'u');
85
+ return pattern.test(msg.trim());
43
86
  }
44
87
 
45
88
  // CLI mode.
46
89
  function complain(msg) {
47
90
  console.error(`❌ Invalid commit message format: "${msg}"`);
48
91
  console.error(` Expected: <type>(<scope>): <subject>`);
49
- console.error(` Valid types: ${VALID_TYPES.join(', ')}`);
92
+ console.error(` Valid types: ${allowedTypes().join(', ')}`);
50
93
  }
51
94
 
52
95
  /**