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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (721) hide show
  1. package/bin/uds.js +12 -1
  2. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  3. package/bundled/ai/standards/commit-message.ai.yaml +12 -2
  4. package/bundled/ai/standards/mock-boundary.ai.yaml +138 -2
  5. package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
  6. package/bundled/ai/standards/turn-completion-integrity.ai.yaml +6 -2
  7. package/bundled/core/commit-message-guide.md +22 -19
  8. package/bundled/core/mock-boundary.md +70 -2
  9. package/bundled/core/secret-management-standards.md +13 -1
  10. package/bundled/core/turn-completion-integrity.md +8 -2
  11. package/bundled/extensions/locales/zh-tw.md +19 -19
  12. package/bundled/hooks/check-dangerous-cmd.mjs +161 -26
  13. package/bundled/hooks/check-logging-standard.mjs +35 -6
  14. package/bundled/hooks/validate-commit-msg.mjs +317 -28
  15. package/bundled/locales/zh-CN/CHANGELOG.md +2323 -1099
  16. package/bundled/locales/zh-CN/CLAUDE.md +987 -101
  17. package/bundled/locales/zh-CN/README.md +3 -3
  18. package/bundled/locales/zh-CN/SECURITY.md +4 -3
  19. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  20. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
  21. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  22. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
  23. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
  24. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
  25. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
  26. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  27. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  28. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  29. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  30. package/bundled/locales/zh-CN/core/accessibility-standards.md +871 -62
  31. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  32. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  33. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  34. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  35. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  36. package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +311 -72
  37. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  38. package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
  39. package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
  40. package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
  41. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  42. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  43. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  44. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  45. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  46. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  47. package/bundled/locales/zh-CN/core/changelog-standards.md +485 -63
  48. package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
  49. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  50. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  51. package/bundled/locales/zh-CN/core/code-review-checklist.md +37 -23
  52. package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
  53. package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
  54. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  55. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  56. package/bundled/locales/zh-CN/core/deprecation-standards.md +155 -40
  57. package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
  58. package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
  59. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  60. package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
  61. package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
  62. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  63. package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
  64. package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
  65. package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
  66. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  67. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  68. package/bundled/locales/zh-CN/core/feature-flag-standards.md +202 -57
  69. package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
  70. package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
  71. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  72. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  73. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  74. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  75. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  76. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  77. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  78. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  79. package/bundled/locales/zh-CN/core/mock-boundary.md +74 -6
  80. package/bundled/locales/zh-CN/core/mutation-testing.md +45 -6
  81. package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
  82. package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
  83. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  84. package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
  85. package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
  86. package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
  87. package/bundled/locales/zh-CN/core/project-structure.md +550 -170
  88. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  89. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  90. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  91. package/bundled/locales/zh-CN/core/retrospective-standards.md +215 -22
  92. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  93. package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
  94. package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
  95. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  96. package/bundled/locales/zh-CN/core/security-standards.md +169 -16
  97. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  98. package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
  99. package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
  100. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  101. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  102. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  103. package/bundled/locales/zh-CN/core/supply-chain-security-standards.md +159 -32
  104. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  105. package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
  106. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  107. package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
  108. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  109. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  110. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  111. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  112. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  113. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  114. package/bundled/locales/zh-CN/core/turn-completion-integrity.md +8 -6
  115. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  116. package/bundled/locales/zh-CN/core/versioning.md +737 -73
  117. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  118. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  119. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  120. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +2 -1
  121. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  122. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
  123. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
  124. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  125. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
  126. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  127. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
  128. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  129. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  130. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +2 -0
  131. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  132. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  133. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  134. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  135. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  136. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  137. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  138. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  139. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  140. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  141. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  142. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  143. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  144. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  145. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  146. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  147. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  148. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  149. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  150. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  151. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  152. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  153. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  154. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  155. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  156. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  157. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  158. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  159. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  160. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  161. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  162. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  163. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  164. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  165. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  166. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  167. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  168. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  169. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  170. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  171. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  172. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  173. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  174. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  175. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  176. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  177. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  178. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  179. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  180. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  181. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  182. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  183. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  184. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  185. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  186. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  187. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  188. package/bundled/locales/zh-CN/skills/README.md +2 -1
  189. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  190. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  191. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  192. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  193. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  194. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  195. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  196. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  197. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  198. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  199. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  200. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  201. package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +217 -137
  202. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  203. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  204. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  205. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  206. package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +148 -132
  207. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  208. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  209. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  210. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  211. package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +122 -121
  212. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  213. package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
  214. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  215. package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
  216. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  217. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  218. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  219. package/bundled/locales/zh-CN/skills/code-review-assistant/guide.md +119 -45
  220. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  221. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  222. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  223. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  224. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  225. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  226. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  227. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  228. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  229. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  230. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  231. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  232. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  233. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  234. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  235. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  236. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  237. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  238. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  239. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  240. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  241. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  242. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  243. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  244. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  245. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  246. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  247. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  248. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  249. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  250. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  251. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  252. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  253. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  254. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  255. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  256. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  257. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  258. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  259. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  260. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  261. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  262. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  263. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  264. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  265. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  266. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  267. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  268. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  269. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +4 -4
  270. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  271. package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
  272. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  273. package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
  274. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  275. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  276. package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +4 -2
  277. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  278. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  279. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  280. package/bundled/locales/zh-CN/skills/docs-generator/guide.md +8 -7
  281. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  282. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  283. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  284. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  285. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  286. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  287. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  288. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  289. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  290. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  291. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  292. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  293. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  294. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  295. package/bundled/locales/zh-CN/skills/project-discovery/guide.md +158 -157
  296. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  297. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  298. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  299. package/bundled/locales/zh-CN/skills/refactoring-assistant/guide.md +172 -171
  300. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  301. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  302. package/bundled/locales/zh-CN/skills/release-standards/guide.md +51 -43
  303. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  304. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  305. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  306. package/bundled/locales/zh-CN/skills/requirement-assistant/guide.md +88 -79
  307. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  308. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  309. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  310. package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +2 -2
  311. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  312. package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
  313. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  314. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  315. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  316. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  317. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  318. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  319. package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +2 -2
  320. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  321. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  322. package/bundled/locales/zh-CN/skills/tdd-assistant/guide.md +217 -156
  323. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  324. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  325. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  326. package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +25 -12
  327. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  328. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  329. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  330. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  331. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  332. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  333. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  334. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  335. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  336. package/bundled/locales/zh-TW/CHANGELOG.md +2323 -1128
  337. package/bundled/locales/zh-TW/CLAUDE.md +962 -76
  338. package/bundled/locales/zh-TW/README.md +3 -3
  339. package/bundled/locales/zh-TW/SECURITY.md +4 -3
  340. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  341. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
  342. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  343. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
  344. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
  345. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
  346. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
  347. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  348. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  349. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  350. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  351. package/bundled/locales/zh-TW/core/accessibility-standards.md +895 -46
  352. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  353. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  354. package/bundled/locales/zh-TW/core/agent-dispatch.md +102 -33
  355. package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
  356. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  357. package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
  358. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  359. package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
  360. package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
  361. package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
  362. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  363. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  364. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  365. package/bundled/locales/zh-TW/core/branch-completion.md +130 -34
  366. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  367. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  368. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  369. package/bundled/locales/zh-TW/core/chaos-engineering-standards.md +138 -36
  370. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  371. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  372. package/bundled/locales/zh-TW/core/code-review-checklist.md +19 -7
  373. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  374. package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
  375. package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
  376. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  377. package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
  378. package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
  379. package/bundled/locales/zh-TW/core/developer-memory.md +102 -12
  380. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  381. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  382. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  383. package/bundled/locales/zh-TW/core/environment-standards.md +250 -72
  384. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  385. package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
  386. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  387. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  388. package/bundled/locales/zh-TW/core/feature-flag-standards.md +202 -57
  389. package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
  390. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  391. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  392. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  393. package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +234 -487
  394. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  395. package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
  396. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  397. package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
  398. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  399. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  400. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  401. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  402. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  403. package/bundled/locales/zh-TW/core/mock-boundary.md +74 -6
  404. package/bundled/locales/zh-TW/core/observability-standards.md +284 -40
  405. package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
  406. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  407. package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
  408. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  409. package/bundled/locales/zh-TW/core/project-context-memory.md +210 -31
  410. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  411. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  412. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  413. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  414. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  415. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  416. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  417. package/bundled/locales/zh-TW/core/runbook-standards.md +296 -23
  418. package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
  419. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  420. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  421. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  422. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  423. package/bundled/locales/zh-TW/core/slo-standards.md +301 -49
  424. package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
  425. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  426. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  427. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  428. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  429. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  430. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  431. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  432. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  433. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  434. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  435. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  436. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  437. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  438. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  439. package/bundled/locales/zh-TW/core/turn-completion-integrity.md +8 -6
  440. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  441. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  442. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  443. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  444. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  445. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +2 -1
  446. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  447. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
  448. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  449. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
  450. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  451. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
  452. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  453. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
  454. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  455. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  456. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +2 -0
  457. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  458. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  459. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  460. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  461. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  462. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  463. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  464. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  465. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  466. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  467. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  468. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  469. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  470. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  471. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  472. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  473. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  474. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  475. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  476. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  477. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  478. package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +584 -475
  479. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  480. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  481. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  482. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  483. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  484. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  485. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  486. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  487. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  488. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  489. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  490. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  491. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  492. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  493. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  494. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  495. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  496. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  497. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  498. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  499. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  500. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  501. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  502. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  503. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  504. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  505. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  506. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  507. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  508. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  509. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  510. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  511. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  512. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  513. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  514. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  515. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  516. package/bundled/locales/zh-TW/skills/README.md +2 -1
  517. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  518. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  519. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  520. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  521. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  522. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  523. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  524. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  525. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  526. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  527. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  528. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  529. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  530. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  531. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  532. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  533. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  534. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  535. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  536. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  537. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  538. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  539. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  540. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  541. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  542. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  543. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  544. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  545. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  546. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  547. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  548. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  549. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  550. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  551. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  552. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  553. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  554. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  555. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  556. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  557. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  558. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  559. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  560. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  561. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  562. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  563. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  564. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  565. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  566. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  567. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  568. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  569. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  570. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  571. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  572. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  573. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  574. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  575. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  576. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  577. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  578. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  579. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  580. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  581. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  582. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  583. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  584. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  585. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  586. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  587. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  588. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  589. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  590. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  591. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  592. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  593. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  594. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  595. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  596. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  597. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  598. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  599. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  600. package/bundled/locales/zh-TW/skills/commit-standards/guide.md +137 -17
  601. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  602. package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
  603. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  604. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  605. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  606. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  607. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  608. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  609. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  610. package/bundled/locales/zh-TW/skills/docs-generator/guide.md +4 -3
  611. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  612. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  613. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  614. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  615. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  616. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  617. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  618. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  619. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  620. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  621. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  622. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  623. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  624. package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +85 -18
  625. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  626. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  627. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  628. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  629. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  630. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  631. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  632. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  633. package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +91 -45
  634. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  635. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  636. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  637. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  638. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  639. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  640. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  641. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  642. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  643. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  644. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  645. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  646. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  647. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  648. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  649. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  650. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  651. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  652. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  653. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  654. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  655. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  656. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  657. package/bundled/locales/zh-TW/skills/tdd-assistant/language-examples.md +693 -47
  658. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  659. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  660. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  661. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  662. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  663. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  664. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  665. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  666. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  667. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  668. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  669. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  670. package/bundled/skills/.claude-plugin/plugin.json +71 -0
  671. package/bundled/skills/commit-standards/SKILL.md +2 -2
  672. package/bundled/skills/commit-standards/guide.md +3 -2
  673. package/bundled/skills/commit-standards/language-options.md +19 -17
  674. package/package.json +2 -2
  675. package/src/commands/audit.js +28 -1
  676. package/src/commands/check.js +72 -3
  677. package/src/commands/compile.js +37 -4
  678. package/src/commands/config.js +49 -24
  679. package/src/commands/init.js +78 -30
  680. package/src/commands/open-work.js +6 -2
  681. package/src/commands/release-messages.js +228 -0
  682. package/src/commands/release.js +127 -68
  683. package/src/commands/run-intent.js +11 -0
  684. package/src/commands/spec.js +4 -2
  685. package/src/commands/update.js +227 -47
  686. package/src/compilers/claude-code-compiler.js +9 -1
  687. package/src/config/ai-agent-paths.js +14 -1
  688. package/src/core/installed-formats.js +15 -0
  689. package/src/core/open-work-config.js +20 -1
  690. package/src/core/project-config.js +55 -0
  691. package/src/i18n/messages.js +106 -2
  692. package/src/installers/hooks-installer.js +1 -1
  693. package/src/installers/manifest-installer.js +1 -1
  694. package/src/installers/skills-installer.js +1 -1
  695. package/src/installers/standards-installer.js +3 -1
  696. package/src/mcp/server.js +9 -3
  697. package/src/prompts/init.js +26 -22
  698. package/src/reconciler/actual-state-scanner.js +2 -8
  699. package/src/reconciler/backup-locations.js +5 -0
  700. package/src/reconciler/backup-manager.js +19 -11
  701. package/src/reconciler/desired-state-calculator.js +89 -57
  702. package/src/reconciler/plan-executor.js +101 -8
  703. package/src/reconciler/recorded-versions.js +49 -0
  704. package/src/reconciler/relative-path.js +23 -0
  705. package/src/uninstallers/hook-uninstaller.js +9 -1
  706. package/src/uninstallers/skills-uninstaller.js +22 -3
  707. package/src/utils/available-standards-report.js +25 -4
  708. package/src/utils/available-standards.js +13 -3
  709. package/src/utils/build-manifest.js +1 -1
  710. package/src/utils/commit-message-judge.js +60 -13
  711. package/src/utils/friction-detector.js +23 -11
  712. package/src/utils/git-hooks.js +106 -4
  713. package/src/utils/integration-generator.js +95 -67
  714. package/src/utils/legacy-hook-migration.js +121 -2
  715. package/src/utils/open-work-tracking.mjs +105 -16
  716. package/src/utils/sdd-header.js +16 -4
  717. package/src/utils/skills-installer.js +2 -1
  718. package/src/utils/spinner.js +14 -4
  719. package/src/utils/standard-validator.js +3 -2
  720. package/standards-registry.json +10 -8
  721. package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
@@ -1,7 +1,7 @@
1
1
  # Mock Boundary Standards
2
2
 
3
- **Version**: 1.1.0
4
- **Last Updated**: 2026-07-01
3
+ **Version**: 1.3.0
4
+ **Last Updated**: 2026-10-28
5
5
  **Applicability**: All software projects with unit and integration tests
6
6
  **Scope**: universal
7
7
  **Industry Standards**: ISTQB Foundation (Test Doubles), xUnit Patterns (Gerard Meszaros)
@@ -101,6 +101,67 @@ The test injects `DeterministicDispatcher`, exercises the code under test, then
101
101
 
102
102
  ---
103
103
 
104
+ ## Blocking Hooks: Test the Host's Entry, Not the Matcher
105
+
106
+ A **hook** is a script an AI host (Claude Code, Codex, Gemini CLI, Antigravity CLI, and others) runs at a lifecycle event. Some hooks can **stop** what the host was about to do: refuse a tool call, reject a prompt, keep a turn from ending. For these the hollow-test problem needs no mock at all. The test simply never touches the entry the host calls.
107
+
108
+ A hook has two layers. The **judgement** decides whether this command is dangerous. The **wiring** reads the host's stdin payload and answers in the signal the host reads (an exit code, or JSON on stdout). A unit test that imports the judgement function exercises the first layer only, and the host reads the second. A wrong exit code, a payload field read under the wrong name, or output in a shape the host ignores all leave that test green.
109
+
110
+ ### Counter-example: UDS's own dangerous-command hook blocked 0 of 26
111
+
112
+ `scripts/hooks/check-dangerous-cmd.mjs` is a PreToolUse hook. When it detected a dangerous command it exited **1**. Claude Code blocks a tool call only on exit **2**; any other non-zero code is a non-blocking hook error and the command runs anyway. Its tests imported the matcher function (`isDangerousCommand()`) and called it directly, so they were green for months.
113
+
114
+ Replaying 11,617 real shell calls (2026-10-27) the rule `rm -rf /` fired 26 times. The host blocked **0** of them. 25 of the 26 were harmless temp cleanups such as `rm -rf /tmp/x`; none was a real attempt to wipe the root. The same pattern missed `rm -fr /` and `rm -r -f /`. The fix and its entry tests shipped in PR #281.
115
+
116
+ ### Rules
117
+
118
+ **H1 (MUST).** A hook that can stop a tool call, a prompt or a turn MUST have at least one test that does all three:
119
+
120
+ 1. **Runs the hook as a separate process**, with the same command the host's config runs. Spawning the script counts; importing it does not.
121
+ 2. **Sends the host's own payload on stdin**, with the field names that host uses (see the table below: Claude Code sends `tool_name` / `tool_input`, Antigravity sends `toolCall`). A payload shaped like the author's idea of the host proves nothing.
122
+ 3. **Asserts the signal the host reads**: the exact exit code, or the JSON the host parses on stdout. "Non-zero", "exited with an error" and "stderr contained the word" do not count: exit 1 is non-zero and blocks nothing on Claude Code.
123
+
124
+ A test that imports and calls an internal function MAY exist and is useful for the judgement, but it does not count toward H1.
125
+
126
+ **H2 (SHOULD).** Pair the blocking case with an allowing case run the same way, and assert the host's allow signal (for example exit 0 with nothing on stdout). A hook that blocks everything passes a blocking-only test.
127
+
128
+ **H3 (SHOULD).** Cut check: change the hook's block signal (for example `exit 2` to `exit 1`) and confirm the entry test goes red. A test that stays green has not been guarding the wiring.
129
+
130
+ H1 also applies to a hook whose only effect is that the host reads its signal, such as a PostToolUse hook that uses exit 2 to put its stderr in front of the model. The tool has already run, so it cannot be undone, but a wrong code silences the hook just the same.
131
+
132
+ ### What each host reads as "blocked"
133
+
134
+ Retrieved 2026-10-28 from each host's own documentation. Hosts change these contracts; re-check the source before relying on a cell, and when a cell says "not found" the page was read and says nothing, which is not the same as "no".
135
+
136
+ | Host | Event | Blocks | Does not block | Source |
137
+ |---|---|---|---|---|
138
+ | Claude Code | PreToolUse | exit **2** (stderr is the reason); or exit 0 with stdout `{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"..."}}` | any other exit code, **including 1**, is a non-blocking hook error and the action proceeds; invalid JSON likewise. Exception stated by the docs: a hook configured with `onFailure: "block"` blocks when it fails | code.claude.com/docs/en/hooks: Exit code output, Exit code 2, Other exit codes, Decision control |
139
+ | Claude Code | UserPromptSubmit | exit **2** (the prompt never reaches the model); or exit 0 with stdout `{"decision":"block","reason":"..."}` | any other exit code (same `onFailure: "block"` exception) | same page, Exit code 2 behavior per event |
140
+ | Claude Code | PostToolUse | cannot block: the tool already ran. Exit 2 only shows stderr to the model | any exit code, for blocking purposes | same page, Exit code 2 behavior per event |
141
+ | Codex | PreToolUse | exit **2** with the reason on stderr; or stdout `{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"..."}}`; the older `{"decision":"block","reason":"..."}` is also accepted | plain text on stdout is ignored; `permissionDecision:"ask"`, `continue:false`, `stopReason`, `suppressOutput` are not supported and the hook run is marked failed while the tool call continues; other non-zero exit codes: not found | developers.openai.com/codex/hooks, PreToolUse |
142
+ | Codex | UserPromptSubmit | exit **2** with the reason on stderr; or stdout `{"decision":"block","reason":"..."}` | plain text on stdout is added as context; other non-zero exit codes: not found | same page, UserPromptSubmit |
143
+ | Codex | PermissionRequest | stdout `{"hookSpecificOutput":{"decision":{"behavior":"deny","message":"..."}}}`; any `deny` wins | exit 2 for this event: not found; plain text on stdout is ignored | same page, PermissionRequest |
144
+ | Gemini CLI (legacy) | BeforeTool | exit **2** (stderr is the reason sent to the agent); or exit 0 with stdout `{"decision":"deny","reason":"..."}` (`"block"` is an alias). The docs name the JSON form the preferred path | any other exit code is a warning and the CLI continues | geminicli.com/docs/hooks/reference, Global hook mechanics and BeforeTool |
145
+ | Gemini CLI (legacy) | BeforeAgent, BeforeModel | exit **2** aborts the turn (BeforeAgent also erases the prompt from context; BeforeModel skips the LLM call); or `decision:"deny"` | as above | same page |
146
+ | Antigravity CLI (`agy`) | PreToolUse | exit 0 with stdout `{"decision":"deny","reason":"..."}` ("Hard blocks execution immediately"). The `decision` field is required; its other values are `allow`, `auto_approve`, `ask`, `force_ask`, `deny_unless_prior_grant`. stdin carries `toolCall.name` and `toolCall.args`, not Claude Code's names | exit-code semantics: not found (the official page is silent). Do not assume Claude Code's exit 2 applies. A third-party guide claims any non-zero code denies; it is not official and is not used here | antigravity.google/docs/hooks, Input and output contract, PreToolUse |
147
+ | Cursor and other hosts | any | not found (not surveyed in this revision) | not found | none |
148
+
149
+ Stop-type events (Claude Code and Codex Stop, Gemini CLI AfterAgent, Antigravity Stop) are **not repeated here**. Their block contracts are in the "Supported harnesses" table of [turn-completion-integrity](turn-completion-integrity.md), the single place they are written down. That table also records one case where a failed Antigravity hook was let through silently, which is the same wiring failure this section is about.
150
+
151
+ ### A replay validates the wiring, not the rules
152
+
153
+ Replaying recorded real calls through a hook (for example with rules-to-guards) is a strong way to check the wiring. It has a limit that must be stated whenever its result is reported. If the same rule list decides both "this should be blocked" and "this should not", the replay proves the hook behaves as its rules say. It does not prove the rules are right.
154
+
155
+ The 0-of-26 measurement could be made because the host's contract (exit 2 blocks) is a fact outside the hook. For "which commands deserve blocking" there was only the hook's own pattern: all 26 hits were consistent with it, 0 were real dangers, and `rm -fr /`, which the pattern did not cover, could never show up as a miss because the oracle shares the blind spot.
156
+
157
+ So report a replay as "wiring is correct" or "wiring is wrong". Do not report "the rules are correct" from it. To say anything about the rules, read the commands that actually matched, or keep a separate answer key (see [verification-oracle](verification-oracle.md)) written without looking at the hook's patterns.
158
+
159
+ ### Enforcement in UDS
160
+
161
+ UDS checks this rule against its own shipped hooks in CI: `node scripts/check-hook-entry-tests.mjs` (npm run `check:hook-entry-tests`) fails when a hook UDS ships that can block has no test that spawns it, feeds stdin and asserts the host's signal. It is static text analysis: it shows that a test of the right shape exists, not that the test would go red if the hook regressed. That is what H3 is for.
162
+
163
+ ---
164
+
104
165
  ## Hollow Test Detection
105
166
 
106
167
  Before submitting a test file, check:
@@ -109,6 +170,7 @@ Before submitting a test file, check:
109
170
  2. **All assertions are `.toHaveBeenCalled()` variants** → Add output-value assertions
110
171
  3. **Mock path matches test subject directory** → Self-referential mock; remove it
111
172
  4. **More mock setup lines than assertion lines** → Likely hollow
173
+ 5. **A blocking hook whose tests only import and call its functions** → Add an entry test that spawns it and asserts the host's signal (see Blocking Hooks)
112
174
 
113
175
  ---
114
176
 
@@ -119,6 +181,7 @@ Before submitting a test file, check:
119
181
  - **Orphan Mock**: Cross-module mock with no integration test counterpart
120
182
  - **Security Bypass Mock**: Auth/permission logic replaced with pass-through stub
121
183
  - **Database Mock Cascade**: DB returns hardcoded data, hiding real query errors
184
+ - **Matcher-Only Hook Test**: A blocking hook whose tests import and call its judgement function and never run the hook as the host does. Green while the hook blocks nothing (UDS's own 0-of-26)
122
185
  - **Poll/Sleep for Background Result**: Sleeping or polling to wait for fire-and-forget work to finish. The race is still there — the timeout merely hides it most of the time while slowing the whole suite and, on a shared runner, leaking flakiness into other MRs' CI. Inject a deterministic runner and await the tracked task instead.
123
186
 
124
187
  ---
@@ -133,6 +196,8 @@ Before submitting a test file, check:
133
196
  | No security mock | Test involves auth/permissions | Use real test user + real token |
134
197
  | Hollow review | Mock count ≥ import count | Add output-value assertion |
135
198
  | No poll/sleep for background work | Test asserts a fire-and-forget side effect | Inject deterministic runner; await the tracked task |
199
+ | Host entry test for blocking hooks | Hook can stop a tool call, prompt or turn | Spawn it, send the host's payload on stdin, assert the exit code or stdout JSON the host reads |
200
+ | Replay proves wiring only | Reporting a replay of real calls through a hook | Report "wiring correct"; do not report "rules correct" unless the rules were checked against an independent answer |
136
201
 
137
202
  ---
138
203
 
@@ -141,6 +206,8 @@ Before submitting a test file, check:
141
206
  - **testing**: Mock boundary rules apply to all test levels in the testing pyramid
142
207
  - **test-completeness-dimensions**: Dimension 8 (AI Test Quality) references these rules
143
208
  - **flow-based-testing**: Flow tests must follow mock boundary rules
209
+ - **turn-completion-integrity**: Holds the block contracts for Stop-type events; this standard holds them for tool and prompt events, and neither repeats the other
210
+ - **verification-oracle**: An answer key for judging whether a hook's rules are right must not be derived from the hook's own patterns
144
211
 
145
212
  ---
146
213
 
@@ -150,3 +217,4 @@ Before submitting a test file, check:
150
217
  |---------|------|--------|
151
218
  | 1.0.0 | 2026-05-04 | Initial standard: hollow test problem, CAN/CANNOT mock tables, detection, anti-patterns, rules summary |
152
219
  | 1.1.0 | 2026-07-01 | Added injectable background execution as a seam (parallel to clock injection): CAN-mock row, `Injectable Background Execution` section, `Poll/Sleep for Background Result` anti-pattern, and no-poll/sleep rule (issue #143) |
220
+ | 1.3.0 | 2026-10-28 | Added `Blocking Hooks: Test the Host's Entry, Not the Matcher`: H1 MUST (spawn the hook, send the host's stdin payload, assert the signal the host reads), H2/H3 SHOULD, the per-host block-signal table, and the replay-validates-wiring-not-rules note, with UDS's own 0-of-26 as the counter-example. Number re-aligned with `mock-boundary.ai.yaml`, which had used 1.2.0 for the background-execution addition recorded here as 1.1.0 |
@@ -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) |
@@ -2,8 +2,8 @@
2
2
 
3
3
  > **Language**: English | [繁體中文](../locales/zh-TW/core/turn-completion-integrity.md)
4
4
 
5
- **Version**: 1.5.0
6
- **Last Updated**: 2026-09-29
5
+ **Version**: 1.5.1
6
+ **Last Updated**: 2026-10-28
7
7
  **Applicability**: Any harness where an agent ends a turn and hands control back to a human
8
8
  **Scope**: universal
9
9
  **Industry Standards**: none claimed — derived from observed failures, see Evidence
@@ -158,6 +158,12 @@ actually wired into that harness's own config. As of v1.5.0:
158
158
  | Gemini CLI (legacy) | AfterAgent | `.gemini/settings.json` | stdout `{"decision":"deny","reason":...}`, exit 0 — the documented preferred path over exit code 2 |
159
159
  | Antigravity CLI (`agy`) | Stop | `.agents/hooks.json` | stdout `{"decision":"continue","reason":...}`, exit 0; `{}` allows |
160
160
 
161
+ This table covers Stop-type events only. The signals a host reads for events that
162
+ stop a tool call or a prompt (PreToolUse, UserPromptSubmit, BeforeTool) are in the
163
+ "What each host reads as 'blocked'" table of [mock-boundary](mock-boundary.md), the
164
+ one place they are written down, together with the rule that a blocking hook must be
165
+ tested by running it as the host does. They are not repeated here.
166
+
161
167
  Wired is not running on Codex. Codex skips a project hook until the project
162
168
  is trusted **and** that exact hook definition has been trusted through `/hooks`
163
169
  in an interactive Codex session; trust is recorded against the definition's
@@ -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 中
@@ -2,10 +2,20 @@
2
2
  /**
3
3
  * UDS Hook: Dangerous Command Detection
4
4
  *
5
- * Detects potentially destructive shell commands and blocks execution.
6
- * Exit code: 0 = safe, 1 = dangerous
5
+ * Detects destructive shell commands and blocks the tool call.
7
6
  *
8
- * Usage: echo "rm -rf /" | node check-dangerous-cmd.mjs
7
+ * Exit code: 0 = allow, 2 = dangerous (blocks the tool call).
8
+ * Claude Code blocks a PreToolUse call ONLY on exit 2; any other non-zero code
9
+ * is a non-blocking hook error and the command still runs.
10
+ *
11
+ * Input, in order of preference:
12
+ * 1. Claude Code PreToolUse payload on stdin:
13
+ * {"hook_event_name":"PreToolUse","tool_name":"Bash","tool_input":{"command":"..."}}
14
+ * Only `tool_input.command` is inspected, never the other fields.
15
+ * 2. A raw command line on stdin when stdin is not a JSON object.
16
+ * 3. A command line as argv[2].
17
+ *
18
+ * Usage: echo '{"tool_input":{"command":"rm -rf /"}}' | node check-dangerous-cmd.mjs
9
19
  * or: node check-dangerous-cmd.mjs "rm -rf /"
10
20
  *
11
21
  * Performance target: < 500ms
@@ -13,48 +23,173 @@
13
23
  * @see docs/specs/SPEC-HOOKS-001-core-standard-hooks.md (REQ-2)
14
24
  */
15
25
 
16
- const DANGEROUS_PATTERNS = [
17
- /rm\s+-rf\s+\//,
18
- /mkfs\./,
19
- /dd\s+if=.*of=\/dev\//,
20
- /format\s+[a-zA-Z]:/,
21
- />\s*\/dev\/sda/,
22
- /chmod\s+-R\s+777\s+\//,
23
- /:()\{\s*:\|:&\s*\};:/, // fork bomb
26
+ const BLOCK_EXIT_CODE = 2;
27
+
28
+ // Where `rm -r` is never what the user meant: the filesystem root or the home directory.
29
+ // `/`, `//`, `/*`, `~`, `~/`, `~/*`, `$HOME`, `${HOME}`, `$HOME/`, `$HOME/*`. Not `/tmp/x`, not `~/proj`.
30
+ const ROOT_OR_HOME = /^(?:\/+\*?|(?:~|\$HOME|\$\{HOME\})(?:\/+\*?)?)$/;
31
+
32
+ // Words after which the real command follows (`sudo -u root rm ...`, `bash -c "rm ..."`, `then rm ...`).
33
+ const WRAPPERS = new Set([
34
+ 'sudo', 'doas', 'env', 'command', 'builtin', 'exec', 'nohup', 'time', 'nice', 'ionice', 'timeout',
35
+ 'bash', 'sh', 'zsh', 'dash', 'ksh', 'eval',
36
+ 'then', 'do', 'else', 'elif', 'if', 'while', 'until', '!', '{',
37
+ ]);
38
+
39
+ const baseName = (word) => word.slice(word.lastIndexOf('/') + 1);
40
+ const unquote = (word) => word.replace(/^["'`]+|["'`]+$/g, '');
41
+
42
+ /** Split a command line into simple commands, each a list of unquoted words. */
43
+ function simpleCommands(cmd) {
44
+ return cmd
45
+ .split(/[;&|\n()`]+/)
46
+ .map((segment) => segment.split(/\s+/).map(unquote).filter(Boolean))
47
+ .filter((words) => words.length > 0);
48
+ }
49
+
50
+ /**
51
+ * Index of the real command word in a simple command, or -1.
52
+ * The command is the first word, or the first word after a run of wrappers.
53
+ * `echo rm -rf /` and `git commit -m "rm -rf /"` have no `rm` command, so they never reach here.
54
+ */
55
+ function commandIndex(words, name) {
56
+ let i = 0;
57
+ while (i < words.length && /^[A-Za-z_][A-Za-z0-9_]*=/.test(words[i])) i++; // VAR=value prefix
58
+ if (i >= words.length) return -1;
59
+ if (matches(words[i], name)) return i;
60
+ if (!WRAPPERS.has(words[i])) return -1;
61
+ for (let j = i + 1; j < words.length; j++) {
62
+ if (matches(words[j], name)) return j;
63
+ }
64
+ return -1;
65
+ }
66
+
67
+ const matches = (word, name) => (typeof name === 'string' ? baseName(word) === name : name.test(baseName(word)));
68
+
69
+ function partition(args) {
70
+ const flags = [];
71
+ const operands = [];
72
+ let optionsEnded = false;
73
+ for (const arg of args) {
74
+ if (!optionsEnded && arg === '--') optionsEnded = true;
75
+ else if (!optionsEnded && arg.startsWith('-') && arg.length > 1) flags.push(arg);
76
+ else operands.push(arg);
77
+ }
78
+ return { flags, operands };
79
+ }
80
+
81
+ const isRecursive = (flags) =>
82
+ flags.some((f) => f === '--recursive' || (!f.startsWith('--') && /[rR]/.test(f)));
83
+
84
+ const RULES = [
85
+ {
86
+ name: 'rm-recursive-root-or-home',
87
+ test: (words) => {
88
+ const at = commandIndex(words, 'rm');
89
+ if (at < 0) return false;
90
+ const { flags, operands } = partition(words.slice(at + 1));
91
+ return isRecursive(flags) && operands.some((t) => ROOT_OR_HOME.test(t));
92
+ },
93
+ },
94
+ {
95
+ name: 'mkfs',
96
+ test: (words) => commandIndex(words, /^mkfs(?:\..+)?$/) >= 0,
97
+ },
98
+ {
99
+ name: 'dd-to-device',
100
+ test: (words) => {
101
+ const at = commandIndex(words, 'dd');
102
+ if (at < 0) return false;
103
+ return words.slice(at + 1).some((w) => /^of=\/dev\//.test(w) && !/^of=\/dev\/(?:null|zero|stdout|stderr|tty|fd\/)/.test(w));
104
+ },
105
+ },
106
+ {
107
+ name: 'format-drive',
108
+ test: (words) => {
109
+ const at = commandIndex(words, /^format(?:\.com|\.exe)?$/i);
110
+ return at >= 0 && words.slice(at + 1).some((w) => /^[a-zA-Z]:/.test(w));
111
+ },
112
+ },
113
+ {
114
+ name: 'chmod-recursive-777-root',
115
+ test: (words) => {
116
+ const at = commandIndex(words, 'chmod');
117
+ if (at < 0) return false;
118
+ const { flags, operands } = partition(words.slice(at + 1));
119
+ const recursive = flags.some((f) => f === '--recursive' || (!f.startsWith('--') && /R/.test(f)));
120
+ const wideOpen = operands.some((o) => /^(?:0?777|[ugoa]*\+rwx)$/.test(o));
121
+ return recursive && wideOpen && operands.some((t) => ROOT_OR_HOME.test(t));
122
+ },
123
+ },
124
+ ];
125
+
126
+ // Matched on the whole command line, not per word: they are syntax, not a command word.
127
+ const WHOLE_LINE_RULES = [
128
+ { name: 'redirect-to-disk', pattern: />\s*\/dev\/(?:sd[a-z]|hd[a-z]|vd[a-z]|xvd[a-z]|nvme\d+n\d+|r?disk\d+)/ },
129
+ { name: 'fork-bomb', pattern: /:\s*\(\s*\)\s*\{\s*:\s*\|\s*:\s*&\s*\}\s*;\s*:/ },
24
130
  ];
25
131
 
132
+ /**
133
+ * Name of the first dangerous rule the command trips, or null.
134
+ * @param {string} cmd - The shell command to check
135
+ * @returns {string|null}
136
+ */
137
+ export function findDangerousRule(cmd) {
138
+ if (!cmd || typeof cmd !== 'string') return null;
139
+ for (const rule of WHOLE_LINE_RULES) {
140
+ if (rule.pattern.test(cmd)) return rule.name;
141
+ }
142
+ for (const words of simpleCommands(cmd)) {
143
+ for (const rule of RULES) {
144
+ if (rule.test(words)) return rule.name;
145
+ }
146
+ }
147
+ return null;
148
+ }
149
+
26
150
  /**
27
151
  * Check if a command matches dangerous patterns.
28
152
  * @param {string} cmd - The shell command to check
29
153
  * @returns {boolean} true if dangerous
30
154
  */
31
155
  export function isDangerousCommand(cmd) {
32
- if (!cmd || typeof cmd !== 'string') return false;
33
- return DANGEROUS_PATTERNS.some((p) => p.test(cmd));
156
+ return findDangerousRule(cmd) !== null;
157
+ }
158
+
159
+ /**
160
+ * The command to check, from stdin text. A Claude Code payload yields only
161
+ * `tool_input.command` (null when it has none); anything else is a raw command line.
162
+ * @param {string} raw
163
+ * @returns {string|null}
164
+ */
165
+ export function commandFromInput(raw) {
166
+ let payload;
167
+ try { payload = JSON.parse(raw); } catch { return raw; }
168
+ if (payload === null || typeof payload !== 'object' || Array.isArray(payload)) return raw;
169
+ const command = payload.tool_input?.command;
170
+ return typeof command === 'string' ? command : null;
171
+ }
172
+
173
+ function verdict(cmd) {
174
+ const rule = findDangerousRule(cmd);
175
+ if (rule === null) process.exit(0);
176
+ console.error(`Blocked by UDS security standard (rule: ${rule}): ${cmd}`);
177
+ process.exit(BLOCK_EXIT_CODE);
34
178
  }
35
179
 
36
180
  // CLI mode
37
181
  if (process.argv[1] && process.argv[1].endsWith('check-dangerous-cmd.mjs')) {
38
182
  const input = process.argv[2];
39
183
  if (input) {
40
- if (isDangerousCommand(input)) {
41
- console.error(`⚠️ Dangerous command detected: "${input}"`);
42
- process.exit(1);
43
- } else {
44
- process.exit(0);
45
- }
184
+ verdict(input);
46
185
  } else {
47
186
  let data = '';
48
187
  process.stdin.setEncoding('utf-8');
49
188
  process.stdin.on('data', (chunk) => { data += chunk; });
50
189
  process.stdin.on('end', () => {
51
- const cmd = data.trim();
52
- if (isDangerousCommand(cmd)) {
53
- console.error(`⚠️ Dangerous command detected: "${cmd}"`);
54
- process.exit(1);
55
- } else {
56
- process.exit(0);
57
- }
190
+ const raw = data.trim();
191
+ if (!raw) process.exit(0);
192
+ verdict(commandFromInput(raw));
58
193
  });
59
194
  }
60
195
  }
@@ -4,7 +4,19 @@
4
4
  *
5
5
  * Checks code for unstructured logging calls (console.log, console.warn, etc.)
6
6
  * and suggests using structured logging instead.
7
- * Exit code: 0 = pass, 1 = unstructured logging found
7
+ * Exit code: 0 = pass, 2 = unstructured logging found
8
+ *
9
+ * Why 2 and not 1: Claude Code shows a PostToolUse hook's stderr to the model only on
10
+ * exit 2. Any other non-zero code is a non-blocking hook error that the model never
11
+ * sees, so the suggestion would reach nobody. (The Write has already happened, so
12
+ * exit 2 here feeds the message back; it cannot undo anything.)
13
+ *
14
+ * Input, in order of preference:
15
+ * 1. Claude Code PostToolUse payload on stdin: only the written text
16
+ * (`tool_input.content`, or `tool_input.new_string` for an Edit) is checked,
17
+ * never the other fields such as file_path.
18
+ * 2. Raw code on stdin when stdin is not a JSON object.
19
+ * 3. Code as argv[2].
8
20
  *
9
21
  * Usage: echo 'console.log("debug")' | node check-logging-standard.mjs
10
22
  * or: node check-logging-standard.mjs 'console.log("debug")'
@@ -32,13 +44,29 @@ export function hasUnstructuredLogging(code) {
32
44
  return UNSTRUCTURED_PATTERNS.some((p) => p.test(code));
33
45
  }
34
46
 
47
+ /**
48
+ * The code to check, from stdin text. A Claude Code payload yields only the written
49
+ * text (null when it carries none); anything else is raw code.
50
+ * @param {string} raw
51
+ * @returns {string|null}
52
+ */
53
+ export function codeFromInput(raw) {
54
+ let payload;
55
+ try { payload = JSON.parse(raw); } catch { return raw; }
56
+ if (payload === null || typeof payload !== 'object' || Array.isArray(payload)) return raw;
57
+ const text = payload.tool_input?.content ?? payload.tool_input?.new_string;
58
+ return typeof text === 'string' ? text : null;
59
+ }
60
+
61
+ const FEEDBACK_EXIT_CODE = 2;
62
+
35
63
  // CLI mode
36
64
  if (process.argv[1] && process.argv[1].endsWith('check-logging-standard.mjs')) {
37
65
  const input = process.argv[2];
38
66
  if (input) {
39
67
  if (hasUnstructuredLogging(input)) {
40
- console.error('⚠️ Unstructured logging detected. Use structured logging (e.g., JSON logger) instead.');
41
- process.exit(1);
68
+ console.error('Unstructured logging detected. Use structured logging (e.g., JSON logger) instead.');
69
+ process.exit(FEEDBACK_EXIT_CODE);
42
70
  } else {
43
71
  process.exit(0);
44
72
  }
@@ -47,10 +75,11 @@ if (process.argv[1] && process.argv[1].endsWith('check-logging-standard.mjs')) {
47
75
  process.stdin.setEncoding('utf-8');
48
76
  process.stdin.on('data', (chunk) => { data += chunk; });
49
77
  process.stdin.on('end', () => {
50
- const code = data.trim();
78
+ const raw = data.trim();
79
+ const code = raw ? codeFromInput(raw) : null;
51
80
  if (hasUnstructuredLogging(code)) {
52
- console.error('⚠️ Unstructured logging detected. Use structured logging (e.g., JSON logger) instead.');
53
- process.exit(1);
81
+ console.error('Unstructured logging detected. Use structured logging (e.g., JSON logger) instead.');
82
+ process.exit(FEEDBACK_EXIT_CODE);
54
83
  } else {
55
84
  process.exit(0);
56
85
  }