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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (693) hide show
  1. package/README.md +13 -3
  2. package/bin/uds.js +75 -3
  3. package/bundled/ai/options/code-review/pr-review.ai.yaml +20 -1
  4. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  5. package/bundled/ai/standards/ai-response-navigation.ai.yaml +43 -3
  6. package/bundled/ai/standards/checkin-standards.ai.yaml +25 -6
  7. package/bundled/ai/standards/code-review.ai.yaml +15 -2
  8. package/bundled/ai/standards/commit-message.ai.yaml +18 -4
  9. package/bundled/ai/standards/developer-memory.ai.yaml +12 -2
  10. package/bundled/ai/standards/full-coverage-testing.ai.yaml +86 -7
  11. package/bundled/ai/standards/open-work-tracking.ai.yaml +254 -4
  12. package/bundled/ai/standards/pipeline-security-gates.ai.yaml +53 -4
  13. package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
  14. package/bundled/ai/standards/turn-completion-integrity.ai.yaml +14 -7
  15. package/bundled/core/ai-response-navigation.md +128 -12
  16. package/bundled/core/code-review-checklist.md +20 -2
  17. package/bundled/core/commit-message-guide.md +22 -19
  18. package/bundled/core/developer-memory.md +12 -2
  19. package/bundled/core/full-coverage-testing.md +99 -5
  20. package/bundled/core/open-work-tracking.md +251 -8
  21. package/bundled/core/pipeline-security-gates.md +63 -0
  22. package/bundled/core/project-context-memory.md +10 -2
  23. package/bundled/core/turn-completion-integrity.md +58 -11
  24. package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
  25. package/bundled/extensions/languages/csharp-style.md +464 -0
  26. package/bundled/extensions/languages/php-style.md +700 -0
  27. package/bundled/extensions/locales/zh-cn.md +717 -0
  28. package/bundled/extensions/locales/zh-tw.md +717 -0
  29. package/bundled/hooks/check-turn-completion-agy.mjs +147 -0
  30. package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
  31. package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
  32. package/bundled/locales/COVERAGE.md +5 -4
  33. package/bundled/locales/zh-CN/CHANGELOG.md +211 -3
  34. package/bundled/locales/zh-CN/README.md +3 -3
  35. package/bundled/locales/zh-CN/SECURITY.md +3 -1
  36. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  37. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
  38. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  39. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
  40. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
  41. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
  42. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
  43. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  44. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  45. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  46. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  47. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  48. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  49. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  50. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  51. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  52. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  53. package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
  54. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  55. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  56. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  57. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  58. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  59. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  60. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  61. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  62. package/bundled/locales/zh-CN/core/code-review-checklist.md +54 -23
  63. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  64. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  65. package/bundled/locales/zh-CN/core/developer-memory.md +159 -60
  66. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  67. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  68. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  69. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  70. package/bundled/locales/zh-CN/core/full-coverage-testing.md +103 -9
  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/pipeline-integration-standards.md +2 -1
  80. package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
  81. package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
  82. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  83. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  84. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  85. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  86. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  87. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  88. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  89. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  90. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  91. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  92. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  93. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  94. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  95. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  96. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  97. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  98. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  99. package/bundled/locales/zh-CN/core/turn-completion-integrity.md +46 -13
  100. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  101. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  102. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  103. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  104. package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
  105. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +11 -2
  106. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  107. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +76 -40
  108. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +32 -15
  109. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  110. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
  111. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  112. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
  113. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  114. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  115. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +46 -0
  116. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  117. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  118. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  119. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  120. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  121. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  122. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  123. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  124. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  125. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  126. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  127. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  128. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  129. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  130. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  131. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  132. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  133. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  134. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  135. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  136. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  137. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  138. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  139. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  140. package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
  141. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  142. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  143. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  144. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  145. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  146. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  147. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  148. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  149. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  150. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  151. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  152. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  153. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  154. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  155. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  156. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  157. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  158. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  159. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  160. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  161. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  162. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  163. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  164. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  165. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  166. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  167. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  168. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  169. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  170. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  171. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  172. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  173. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  174. package/bundled/locales/zh-CN/skills/README.md +3 -1
  175. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  176. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  177. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  178. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  179. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  180. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  181. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  182. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  183. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  184. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  185. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  186. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  187. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  188. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  189. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  190. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  191. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  192. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  193. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  194. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  195. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  196. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  197. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  198. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  199. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  200. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  201. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  202. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  203. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  204. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  205. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  206. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  207. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  208. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  209. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  210. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  211. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  212. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  213. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  214. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  215. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  216. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  217. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  218. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  219. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  220. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  221. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  222. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  223. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  224. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  225. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  226. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  227. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  228. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  229. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  230. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  231. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  232. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  233. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  234. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  235. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  236. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  237. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  238. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  239. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  240. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  241. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  242. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  243. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  244. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  245. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  246. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  247. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  248. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  249. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -2
  250. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  251. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  252. package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
  253. package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
  254. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  255. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  256. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  257. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  258. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  259. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  260. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  261. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  262. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  263. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  264. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  265. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  266. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  267. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  268. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  269. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  270. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  271. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  272. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  273. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  274. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  275. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  276. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  277. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  278. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  279. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  280. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  281. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  282. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  283. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  284. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  285. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  286. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  287. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  288. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  289. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  290. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  291. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  292. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  293. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  294. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  295. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  296. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  297. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  298. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  299. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  300. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  301. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  302. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  303. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  304. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  305. package/bundled/locales/zh-TW/CHANGELOG.md +211 -3
  306. package/bundled/locales/zh-TW/README.md +3 -3
  307. package/bundled/locales/zh-TW/SECURITY.md +3 -1
  308. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  309. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
  310. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  311. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
  312. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
  313. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
  314. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
  315. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  316. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  317. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  318. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  319. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  320. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  321. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  322. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  323. package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
  324. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  325. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  326. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  327. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  328. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  329. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  330. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  331. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  332. package/bundled/locales/zh-TW/core/code-review-checklist.md +36 -7
  333. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  334. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  335. package/bundled/locales/zh-TW/core/developer-memory.md +111 -12
  336. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  337. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  338. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  339. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  340. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  341. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  342. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  343. package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
  344. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  345. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  346. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  347. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  348. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  349. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  350. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  351. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  352. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  353. package/bundled/locales/zh-TW/core/open-work-tracking.md +164 -9
  354. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  355. package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
  356. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  357. package/bundled/locales/zh-TW/core/project-context-memory.md +215 -31
  358. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  359. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  360. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  361. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  362. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  363. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  364. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  365. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  366. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  367. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  368. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  369. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  370. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  371. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  372. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  373. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  374. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  375. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  376. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  377. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  378. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  379. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  380. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  381. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  382. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  383. package/bundled/locales/zh-TW/core/turn-completion-integrity.md +46 -13
  384. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  385. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  386. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  387. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  388. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  389. package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
  390. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +11 -2
  391. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  392. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +69 -33
  393. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  394. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +32 -15
  395. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  396. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
  397. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  398. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
  399. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  400. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  401. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +46 -0
  402. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  403. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  404. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  405. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  406. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  407. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  408. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  409. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  410. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  411. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  412. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  413. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  414. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  415. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  416. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  417. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  418. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  419. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  420. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  421. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  422. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  423. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  424. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  425. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  426. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  427. package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
  428. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  429. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  430. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  431. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  432. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  433. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  434. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  435. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  436. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  437. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  438. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  439. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  440. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  441. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  442. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  443. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  444. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  445. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  446. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  447. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  448. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  449. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  450. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  451. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  452. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  453. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  454. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  455. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  456. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  457. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  458. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  459. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  460. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  461. package/bundled/locales/zh-TW/skills/README.md +3 -1
  462. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  463. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  464. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  465. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  466. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  467. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  468. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  469. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  470. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  471. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  472. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  473. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  474. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  475. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  476. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  477. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  478. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  479. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  480. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  481. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  482. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  483. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  484. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  485. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  486. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  487. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  488. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  489. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  490. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  491. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  492. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  493. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  494. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  495. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  496. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  497. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  498. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  499. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  500. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  501. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  502. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  503. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  504. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  505. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  506. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  507. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  508. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  509. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  510. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  511. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  512. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  513. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  514. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  515. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  516. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  517. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  518. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  519. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  520. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  521. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  522. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  523. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  524. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  525. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  526. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  527. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  528. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  529. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  530. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  531. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  532. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  533. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  534. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  535. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  536. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  537. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  538. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  539. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  540. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  541. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  542. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  543. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  544. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  545. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  546. package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
  547. package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
  548. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  549. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  550. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  551. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  552. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  553. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  554. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  555. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  556. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  557. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  558. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  559. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  560. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  561. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  562. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  563. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  564. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  565. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  566. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  567. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  568. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  569. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  570. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  571. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  572. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  573. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  574. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  575. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  576. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  577. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  578. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  579. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  580. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  581. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  582. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  583. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  584. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  585. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  586. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  587. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  588. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  589. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  590. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  591. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  592. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  593. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  594. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  595. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  596. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  597. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  598. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  599. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  600. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  601. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  602. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  603. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  604. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  605. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  606. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  607. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  608. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  609. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  610. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  611. package/bundled/skills/README.md +1 -0
  612. package/bundled/skills/SKILL_NAMING.md +9 -0
  613. package/bundled/skills/commit-standards/SKILL.md +2 -2
  614. package/bundled/skills/commit-standards/guide.md +3 -2
  615. package/bundled/skills/commit-standards/language-options.md +19 -17
  616. package/bundled/skills/comprehension-ladder/SKILL.md +283 -0
  617. package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
  618. package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
  619. package/bundled/templates/gates/check-stubs.mjs +644 -0
  620. package/package.json +5 -3
  621. package/src/commands/audit.js +20 -2
  622. package/src/commands/check.js +155 -28
  623. package/src/commands/deps.js +31 -1
  624. package/src/commands/hitl.js +3 -0
  625. package/src/commands/init.js +173 -49
  626. package/src/commands/list.js +12 -3
  627. package/src/commands/mcp.js +2 -3
  628. package/src/commands/open-work.js +123 -0
  629. package/src/commands/quickstart.js +29 -13
  630. package/src/commands/release.js +102 -19
  631. package/src/commands/run-intent.js +10 -0
  632. package/src/commands/simulate.js +20 -8
  633. package/src/commands/skills.js +59 -33
  634. package/src/commands/spec-split.js +30 -17
  635. package/src/commands/spec.js +55 -21
  636. package/src/commands/uninstall.js +146 -32
  637. package/src/commands/update.js +471 -93
  638. package/src/core/install-records.js +192 -0
  639. package/src/core/manifest.js +12 -10
  640. package/src/core/marketplace-sentinel.js +5 -0
  641. package/src/core/open-work-config.js +122 -0
  642. package/src/core/project-config.js +92 -38
  643. package/src/flows/init-flow.js +10 -0
  644. package/src/hitl/manager.js +4 -2
  645. package/src/i18n/messages.js +413 -78
  646. package/src/installers/hooks-installer.js +320 -24
  647. package/src/installers/integration-installer.js +5 -1
  648. package/src/installers/skills-installer.js +3 -1
  649. package/src/installers/standards-installer.js +16 -23
  650. package/src/mcp/__tests__/server.test.js +0 -1
  651. package/src/mcp/server.js +16 -4
  652. package/src/prompts/init.js +148 -13
  653. package/src/reconciler/backup-locations.js +80 -0
  654. package/src/reconciler/backup-manager.js +451 -123
  655. package/src/reconciler/index.js +86 -10
  656. package/src/reconciler/install-roots.js +90 -0
  657. package/src/reconciler/plan-executor.js +37 -15
  658. package/src/uninstallers/hook-uninstaller.js +323 -33
  659. package/src/uninstallers/integration-uninstaller.js +35 -5
  660. package/src/uninstallers/skills-uninstaller.js +95 -16
  661. package/src/uninstallers/standards-uninstaller.js +56 -7
  662. package/src/utils/agents-installer.js +10 -17
  663. package/src/utils/available-standards-report.js +144 -0
  664. package/src/utils/available-standards.js +216 -0
  665. package/src/utils/command-hash-ownership.js +103 -0
  666. package/src/utils/commit-message-judge.js +155 -0
  667. package/src/utils/copier.js +80 -2
  668. package/src/utils/deps-applicability.js +25 -0
  669. package/src/utils/detector.js +46 -1
  670. package/src/utils/friction-detector.js +27 -0
  671. package/src/utils/gate-scripts.js +141 -0
  672. package/src/utils/git-hooks.js +139 -7
  673. package/src/utils/hasher.js +36 -0
  674. package/src/utils/health-scorer.js +10 -7
  675. package/src/utils/installed-names-ownership.js +114 -0
  676. package/src/utils/integration-generator.js +36 -24
  677. package/src/utils/legacy-hook-migration.js +112 -0
  678. package/src/utils/locale.js +19 -0
  679. package/src/utils/open-work-tracking.mjs +1754 -0
  680. package/src/utils/prompt-closed.js +18 -0
  681. package/src/utils/sdd-header.js +66 -0
  682. package/src/utils/skill-frontmatter.js +102 -0
  683. package/src/utils/skill-hash-ownership.js +64 -0
  684. package/src/utils/skill-name-collision.js +169 -0
  685. package/src/utils/skills-install-paths.js +114 -0
  686. package/src/utils/skills-installer.js +75 -106
  687. package/src/utils/standard-validator.js +98 -27
  688. package/src/utils/test-change-check.js +160 -0
  689. package/src/utils/test-policy.js +214 -0
  690. package/src/utils/transient-fs.js +113 -0
  691. package/src/utils/update-summary.js +29 -0
  692. package/src/vibe/micro-spec.js +15 -0
  693. package/standards-registry.json +48 -9
package/README.md CHANGED
@@ -139,14 +139,14 @@ uds skills
139
139
  - Installation location (Plugin Marketplace, User Level, Project Level) | 安裝位置
140
140
  - Installed version | 已安裝版本
141
141
  - List of installed skills | 已安裝的 Skills 清單
142
- - Migration recommendations for deprecated installations | 棄用安裝的遷移建議
142
+ - The two ways to install skills, side by side, with what each can and cannot do | 並列兩種安裝方式與各自的限制
143
143
 
144
144
  **Example Output | 範例輸出:**
145
145
  ```
146
146
  Universal Dev Standards - Installed Skills
147
147
  ──────────────────────────────────────────────────
148
148
 
149
- ✓ Plugin Marketplace (recommended)
149
+ ✓ Plugin Marketplace
150
150
  Version: 3.2.2
151
151
  Path: /Users/.../.claude/plugins/universal-dev-standards@...
152
152
 
@@ -305,12 +305,22 @@ This CLI works alongside [Claude Code Skills](../skills/):
305
305
  - **Reference documents** provide guidelines for manual reference
306
306
  - **參考文件**提供手動參考的指南
307
307
 
308
- **Install Skills via Plugin Marketplace | 透過 Plugin Marketplace 安裝 Skills:**
308
+ **Install Skills | 安裝 Skills:** two ways; the main path is into the project (many AI tools, Traditional and Simplified Chinese texts, follows the UDS version you installed, betas included). The Claude Code plugin marketplace is an alternative: Claude Code only, English texts only, stable releases only, no files in the project. See [How to install skills](../docs/user/GETTING-STARTED.md#how-to-install-skills).
309
+ 有兩種方式;主要路徑是裝進專案(支援多種 AI 工具、有繁體與簡體中文、跟著你裝的 UDS 版本,含測試版)。Claude Code 外掛市集是替代方式:只支援 Claude Code、只有英文、只跟正式版、專案內不放檔案。
310
+
309
311
  ```bash
312
+ # Into the project (main path) | 裝進專案(主要路徑)
313
+ uds init --skills-location project # new project | 新專案
314
+ uds update --apply --skills # existing project | 已設定過的專案
315
+
316
+ # Claude Code plugin marketplace (alternative) | Claude Code 外掛市集(替代方式)
310
317
  /plugin marketplace add AsiaOstrich/universal-dev-standards
311
318
  /plugin install universal-dev-standards@asia-ostrich
312
319
  ```
313
320
 
321
+ Installing both lists every skill twice in Claude Code; `uds check` warns when it finds both.
322
+ 兩種都裝,Claude Code 會把每個技能列出兩次;`uds check` 發現兩者並存時會警告。
323
+
314
324
  **Important | 重要**: For standards with Skills available, use the Skill OR copy the source document — never both.
315
325
  對於有可用 Skills 的規範,請使用 Skill 或複製來源文件 — 切勿兩者同時使用。
316
326
 
package/bin/uds.js CHANGED
@@ -26,6 +26,7 @@ import { compileStandards } from '../src/commands/compile.js';
26
26
  import { generateReport } from '../src/commands/report.js';
27
27
  import { mcpCommand } from '../src/commands/mcp.js';
28
28
  import { runIntentCommand } from '../src/commands/run-intent.js';
29
+ import { openWorkNextActionCommand, openWorkRevisionCommand, openWorkSeparationCommand, openWorkWaitingCommand, openWorkObservationsCommand, openWorkSelfTestCommand } from '../src/commands/open-work.js';
29
30
  import { setLanguage, setLanguageExplicit, detectLanguage, t } from '../src/i18n/messages.js';
30
31
  import { maybeCheckForUpdates, formatUpdateNotice, shouldCheckUpdateForCommand } from '../src/utils/update-checker.js';
31
32
  import { config } from '../src/utils/config-manager.js';
@@ -105,9 +106,13 @@ program
105
106
  // Fallback to OS environment variable detection
106
107
  setLanguage(detectLanguage(null));
107
108
  })
108
- .hook('postAction', async (thisCommand) => {
109
+ .hook('postAction', async (thisCommand, actionCommand) => {
109
110
  const cmd = thisCommand.name();
110
111
  if (!shouldCheckUpdateForCommand(cmd)) return;
112
+ // XSPEC-454 R3: --offline promises no network. This hook runs after every command and
113
+ // asks the npm registry for the latest version; it ignored the flag, so `check --offline`
114
+ // and `audit --offline` still made that request (whenever the terminal was interactive).
115
+ if (actionCommand?.opts?.().offline) return;
111
116
  await printUpdateNoticeIfAvailable();
112
117
  });
113
118
 
@@ -129,7 +134,7 @@ program
129
134
  .option('--lang <language>', 'Language extension (csharp, php)')
130
135
  .option('--framework <framework>', 'Framework extension (fat-free)')
131
136
  .option('--locale <locale>', 'Locale extension (zh-tw)')
132
- .option('--skills-location <location>', 'Skills location (marketplace, user, project, none) [default: marketplace]')
137
+ .option('--skills-location <location>', 'Skills location (project, user, marketplace, none) [default: project]')
133
138
  // No double quotes in this description: generate-usage-docs.mjs parses the
134
139
  // option table out of this file and truncates at the first one, which turned
135
140
  // the retirement note into a dangling semicolon in three locales.
@@ -199,7 +204,7 @@ program
199
204
 
200
205
  program
201
206
  .command('simulate')
202
- .description('Simulate a standard check with input (Predictive Validation)')
207
+ .description('Simulate a standard check with input (Predictive Validation). Exit 0 = passes, 1 = does not comply, 2 = no verdict (cannot simulate; not a pass). Only commit-message defines a simulator today')
203
208
  .option('-s, --standard <id>', 'Standard to simulate against')
204
209
  .option('-i, --input <string>', 'Input string to test')
205
210
  .option('--json', 'Output result in JSON format')
@@ -229,8 +234,11 @@ program
229
234
  .option('--force', 'Force update all files, ignoring hash comparison')
230
235
  .option('--prune', 'Delete .standards/ files UDS wrote but no longer ships (listed without this flag; never touches files UDS did not write)')
231
236
  .option('--rollback', 'Rollback to the most recent backup')
237
+ .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], [])
232
238
  .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')
233
239
  .option('--locale <locale>', 'Override locale for skills install (zh-tw, zh-cn, en); also reads .uds/install.yaml + UDS_LOCALE env')
240
+ .option('--with-hooks', 'Install the enforcement hooks that are missing from this already-initialized project (re-detects tools; hooks already there and your own hooks are not touched; with --plan, writes nothing; --force also overwrites edited hook scripts)')
241
+ .option('--ai-tool <tools>', 'With --with-hooks: comma-separated tools to install hooks for (claude-code, codex, gemini-cli, antigravity) instead of detecting them')
234
242
  .action(updateCommand);
235
243
 
236
244
  program
@@ -250,6 +258,8 @@ program
250
258
  .option('--gh', 'Force gh CLI for submission')
251
259
  .option('--format <format>', 'Output format (json)')
252
260
  .option('--quiet', 'Summary only')
261
+ // XSPEC-454 R3: `check` and `update` already take --offline; `audit` rejected it with "unknown option".
262
+ .option('--offline', 'No network access at all: no CLI version check, and --report does not submit')
253
263
  .option('--score', 'Run multi-dimensional health score analysis')
254
264
  .option('--self', 'Self mode: analyze UDS repo itself (use with --score)')
255
265
  .option('--save', 'Save score snapshot for trend tracking (use with --score)')
@@ -270,6 +280,7 @@ program
270
280
  .option('--path <dir>', 'Directory containing package.json (default: cwd)')
271
281
  .option('--json', 'Output raw JSON')
272
282
  .option('--concurrency <n>', 'Parallel registry lookups (default: 8)')
283
+ .option('--if-present', 'Exit 0 and say that nothing was checked when there is no package.json or no runtime dependency (default: exit 1)')
273
284
  .action(depsCommand);
274
285
 
275
286
  program
@@ -455,6 +466,67 @@ aiContextCommand
455
466
  // MCP command for AI tool integration
456
467
  mcpCommand(program);
457
468
 
469
+ // Open-work-tracking reference checks (OWT-017 … OWT-028). A group of its own, not
470
+ // a flag on `check`: `check` validates the installed standards and has its own
471
+ // --ci/--json meaning, while these are five checks with different arguments and
472
+ // an exit-code contract in which 2 ("cannot decide") is not a pass.
473
+ // commander keeps the last value of a repeated option; these options repeat and every value counts
474
+ const collectOption = (value, previous) => previous.concat([value]);
475
+ const openWorkCommand = program
476
+ .command('open-work')
477
+ .description('Reference checks for open-work-tracking (OWT-017 to OWT-028). Exit 0 no violation, 1 violation, 2 cannot decide (not a pass)');
478
+
479
+ openWorkCommand
480
+ .command('next-action [files...]')
481
+ .description('OWT-019: every "next action" field names a file path, test name, command or requirement identifier; a row that is asked-awaiting and complete under OWT-022 is waiting-on-reply and is listed apart')
482
+ .option('--root <dir>', 'Directory relative paths are resolved against (default: cwd)')
483
+ .option('--id-pattern <regex>', 'Your own requirement-identifier pattern (the default is an uncalibrated initial judgment)')
484
+ .option('--now <date>', 'Treat this day (YYYY-MM-DD) as today, so the age of a waiting-on-reply row does not drift with the date')
485
+ .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
+ .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
+ .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, [])
488
+ .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, [])
489
+ .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, [])
490
+ .action(openWorkNextActionCommand);
491
+
492
+ openWorkCommand
493
+ .command('revision')
494
+ .description('OWT-018: a change to acceptance/goal/constraint sections needs a new, complete revision record')
495
+ .option('--file <path>', 'Carrier file (with --base)')
496
+ .option('--base <rev>', 'Git revision to compare --file against')
497
+ .option('--before <file>', 'Earlier version of the carrier (with --after)')
498
+ .option('--after <file>', 'Later version of the carrier (with --before)')
499
+ .action(openWorkRevisionCommand);
500
+
501
+ openWorkCommand
502
+ .command('separation [files...]')
503
+ .description('OWT-017: no single carrier holds both an intent section and a progress/next-action section')
504
+ .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, [])
505
+ .action(openWorkSeparationCommand);
506
+
507
+ openWorkCommand
508
+ .command('waiting [files...]')
509
+ .description('OWT-020/021/022: a waiting item says whether it was asked; not-yet-asked names its draft; asked-awaiting has asked-at, what it waits for and its release. OWT-027/028: a release condition may name an object in another project, which is looked up on this machine only')
510
+ .option('--root <dir>', 'Directory relative paths are resolved against (default: cwd); repeat as --root <name>=<dir> to say where another project lives (also open_work.projects in uds.project.yaml)', collectOption, [])
511
+ .option('--id-pattern <regex>', 'Your own requirement-identifier pattern (the default is an uncalibrated initial judgment)')
512
+ .option('--now <date>', 'Treat this day (YYYY-MM-DD) as today, so a result does not drift with the date')
513
+ .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, [])
514
+ .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, [])
515
+ .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, [])
516
+ .action(openWorkWaitingCommand);
517
+
518
+ openWorkCommand
519
+ .command('observations [files...]')
520
+ .description('OWT-023/024/025/026: a hand-written fact the assistant cannot observe carries observed-by, observed-at and yes/no/unknown; unknown and stale are counted apart')
521
+ .option('--now <date>', 'Treat this day (YYYY-MM-DD) as today, so a result does not drift with the date')
522
+ .option('--stale-after <days>', 'Days after which an observation is reported as stale (default 7, an uncalibrated initial judgment)')
523
+ .action(openWorkObservationsCommand);
524
+
525
+ openWorkCommand
526
+ .command('self-test')
527
+ .description('Run the checker\'s own self-test arms (a checker that fails them decides nothing)')
528
+ .action(openWorkSelfTestCommand);
529
+
458
530
  // uds run <intent> — language-agnostic command proxy (XSPEC-029)
459
531
  program
460
532
  .command('run <intent>')
@@ -4,7 +4,7 @@
4
4
  id: pr-review
5
5
  meta:
6
6
  parent: code-review
7
- version: "1.0.0"
7
+ version: "1.1.0"
8
8
  description: Traditional pull request code review process
9
9
 
10
10
  best_for:
@@ -21,6 +21,7 @@ workflow:
21
21
  - Write clear description
22
22
  - Link related issues
23
23
  - Request reviewers
24
+ - State the Merge Danger (door and blast radius)
24
25
 
25
26
  - name: Review
26
27
  actor: Reviewer
@@ -114,6 +115,15 @@ rules:
114
115
  instruction: At least one approval required
115
116
  priority: required
116
117
 
118
+ - id: merge-danger-declared
119
+ trigger: opening or merging PR
120
+ instruction: |
121
+ The PR states its door (two-way: easy to take back after merge; one-way: irreversible or
122
+ hard to take back - data migration, deletion, changed default behavior, changed exit code,
123
+ renamed public interface) and its blast radius in one word. A one-way door is made known to
124
+ whoever decides to merge BEFORE the merge.
125
+ priority: required
126
+
117
127
  pr_template: |
118
128
  ## Summary
119
129
  Brief description of changes
@@ -128,6 +138,15 @@ pr_template: |
128
138
  - [ ] Unit tests added/updated
129
139
  - [ ] Manual testing performed
130
140
 
141
+ ## Merge Danger
142
+ Door (tick one):
143
+ - [ ] Two-way door: after merging, it can be taken back easily
144
+ - [ ] One-way door: irreversible or hard to take back (data migration, deletion, changed default behavior, changed exit code, renamed public interface)
145
+
146
+ Blast radius (one word, e.g. docs, cli, adopters):
147
+
148
+ A one-way door must be made known to whoever decides to merge before the merge.
149
+
131
150
  ## Checklist
132
151
  - [ ] Code follows project style guidelines
133
152
  - [ ] Self-review completed
@@ -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
@@ -3,14 +3,17 @@
3
3
 
4
4
  id: ai-response-navigation
5
5
  meta:
6
- version: "1.3.0"
7
- updated: "2026-08-17"
6
+ version: "1.4.0"
7
+ updated: "2026-10-05"
8
8
  source: core/ai-response-navigation.md
9
9
  description: >
10
10
  Every substantive AI response must include contextual next-step suggestions with recommended
11
11
  options (rules 1-6, required). Optional rules 7-11 govern the answer itself: lead with the
12
12
  finding, restate state across turns, no preamble, plain language as the subject, and a
13
- trade-off on every option rather than only the recommended one.
13
+ trade-off on every option rather than only the recommended one. Rule 12 is controlled
14
+ language: one required clause (a simplified text keeps the writer's hedges, never turning
15
+ "might" into "is") and optional language-neutral plain-writing principles. It ships no
16
+ English dictionary.
14
17
 
15
18
  rules:
16
19
  - id: navigation-footer
@@ -127,6 +130,8 @@ rules:
127
130
  Distinct from lead-with-the-finding: that rule orders finding before evidence, this one
128
131
  governs register. A response can lead with its finding and still state that finding in
129
132
  vocabulary only its author holds; both leave the reader unable to act.
133
+ Putting a claim in plain words is a rewrite, and a rewrite is where hedges get lost: when
134
+ the claim was hedged, keep-uncertainty-markers (rule 12.1, required) governs.
130
135
  priority: optional
131
136
 
132
137
  - id: every-option-carries-its-trade-off
@@ -143,6 +148,41 @@ rules:
143
148
  costlier to read, so the 1-5 cap matters more, not less.
144
149
  priority: optional
145
150
 
151
+ # ── Rule 12 (v1.4.0): controlled language, split into two entries ──
152
+ # One rule in the Markdown, two entries here because priority is one value per entry and the
153
+ # two halves are not the same strength. 12.1 is required: it is the only part whose failure makes
154
+ # the reader believe something untrue, and it needs no calibration (compare before and after).
155
+ # 12.2 is optional: its ranges are uncalibrated starting points with no checker, and a required
156
+ # rule with a threshold nobody can verify produces mechanical compliance.
157
+ # Takes the principles of ASD-STE100 and none of its English dictionary or tense rules.
158
+
159
+ - id: keep-uncertainty-markers
160
+ trigger: shortening, simplifying, rewriting or translating text for a reader who is not its author
161
+ instruction: >
162
+ Keep the writer's hedges (might, could, probably, appears to, not yet confirmed; 可能, 推斷,
163
+ 大概, 尚未確認). Do NOT turn an uncertain claim into a certain one, do NOT drop a hedge to save
164
+ words, and do NOT add a fact the source did not state (an invented cause, an invented
165
+ "confirmed"). A shorter sentence is the goal; a more certain one is not allowed. A hedge may go
166
+ only when the claim has since been verified, and then the verification (what was checked, with
167
+ what result) takes its place; deleting the hedge alone is not verification.
168
+ priority: required
169
+
170
+ - id: controlled-language
171
+ trigger: writing for a non-specialist reader who has to judge or approve something from the text
172
+ instruction: >
173
+ Apply language-neutral plain-writing principles, each in the unit the language itself uses and
174
+ with no word list: (1) short sentences, one idea each, counted in the language's own unit —
175
+ as a starting range not a limit, roughly 15-25 words in English and 25-40 characters in
176
+ Chinese, calibrated per language and reader; (2) one name per thing for the whole text;
177
+ (3) a clear subject and the active voice, the passive only when the actor is unknown or
178
+ irrelevant; (4) one step, one action, as a numbered list; (5) few semicolons; (6) numbers carry
179
+ units. Do NOT use ASD-STE100's approved dictionary or tense restrictions: they depend on English
180
+ and do not apply to Chinese or other non-English text. Do NOT gauge non-English text with a
181
+ counter that splits on whitespace or ASCII; it reads a Chinese paragraph as one word and always
182
+ passes. Optional because the ranges are uncalibrated and unchecked; keep-uncertainty-markers is
183
+ the part that does not bend.
184
+ priority: optional
185
+
146
186
  related_standards:
147
187
  - ai-command-behavior
148
188
  - ai-instruction-standards
@@ -12,7 +12,7 @@ standard:
12
12
  - "Documentation: docs updated, CHANGELOG updated"
13
13
 
14
14
  meta:
15
- version: "2.2.0"
15
+ version: "2.2.1"
16
16
  updated: "2026-07-09"
17
17
  source: core/checkin-standards.md
18
18
  description: Quality gates that must be passed before committing code
@@ -167,10 +167,29 @@ standard:
167
167
 
168
168
  physical_spec:
169
169
  type: custom_script
170
+ # Fail-closed (XSPEC-444 R1): a failing lint or test script fails this check.
171
+ # A script that is genuinely absent is reported (printed) and does not fail it —
172
+ # the hint is printed only for that case, never as a fallback for a failure.
173
+ # Inline Node keeps it portable (sh and cmd.exe) and lets it read package.json
174
+ # instead of guessing from exit codes. The npm-init placeholder test script
175
+ # ("no test specified") counts as absent. A package.json that exists but cannot
176
+ # be read fails the check. No package.json (not an npm project): hint, no failure.
170
177
  validator:
171
178
  command: >
172
- echo "🔍 UDS Check-in Gates:" &&
173
- (npm run lint --if-present || echo "ℹ️ No lint script") &&
174
- (npm test --if-present || echo "ℹ️ No test script") &&
175
- (test -f CHANGELOG.md || echo "ℹ️ No CHANGELOG.md")
176
- rule: "checkin_gates_passed"
179
+ node -e "
180
+ const fs=require('fs'),cp=require('child_process');
181
+ console.log('🔍 UDS Check-in Gates:');
182
+ let pkg;
183
+ try{pkg=JSON.parse(fs.readFileSync('package.json','utf8').replace(/^\uFEFF/,''))}
184
+ catch(e){if(e.code!=='ENOENT'){console.error('package.json cannot be read: '+e.message);process.exit(1)}}
185
+ if(pkg===undefined){console.log('ℹ️ No package.json - lint and tests were NOT run by this check (not an npm project)')}
186
+ else{const sc=(pkg&&pkg.scripts)||{};
187
+ for(const n of ['lint','test']){
188
+ const s=sc[n];
189
+ if(!s||(n==='test'&&/no test specified/.test(s))){console.log('ℹ️ No '+n+' script');continue}
190
+ const r=cp.spawnSync('npm run '+n,{stdio:'inherit',shell:true});
191
+ if(r.status!==0){console.error('FAILED: npm run '+n+' exited with '+r.status);process.exit(1)}
192
+ }}
193
+ if(!fs.existsSync('CHANGELOG.md'))console.log('ℹ️ No CHANGELOG.md');
194
+ "
195
+ rule: "checkin_gates_passed"
@@ -12,8 +12,8 @@ standard:
12
12
  - "Be constructive and explain 'why'"
13
13
 
14
14
  meta:
15
- version: "2.2.0"
16
- updated: "2026-08-24"
15
+ version: "2.3.0"
16
+ updated: "2026-10-08"
17
17
  source: core/code-review-checklist.md
18
18
  description: Systematic checklist for reviewing code quality and security
19
19
 
@@ -59,6 +59,10 @@ standard:
59
59
  - item: Unit tests are included
60
60
  - item: Tests cover edge cases
61
61
  - item: Tests are meaningful (not just for coverage)
62
+ - item: Expected values are independent of the code under test (a literal, a hand-computed example or the spec; not the same call repeated or the same arithmetic typed again)
63
+ merge_danger:
64
+ - item: "The change states its door (two-way: easy to take back after merge; one-way: irreversible or hard to take back — data migration, deletion, changed default behavior, changed exit code, renamed public interface) and its blast radius in one word"
65
+ - item: A one-way door is known to the decision-maker before the merge
62
66
  documentation:
63
67
  - item: Public APIs are documented
64
68
  - item: Complex logic has comments
@@ -107,6 +111,15 @@ standard:
107
111
  trigger: finding good code
108
112
  instruction: Acknowledge and praise good implementations
109
113
  priority: recommended
114
+ - id: merge-danger-known
115
+ trigger: reviewing or merging a change
116
+ instruction: |
117
+ Read the Merge Danger field (door and blast radius). A one-way door (a data migration,
118
+ a deletion, a changed default behavior, a changed exit code, a renamed public interface)
119
+ must be made known to whoever decides to merge BEFORE the merge, in the PR description
120
+ or the hand-off report. If the field is missing, ask for it; do not infer the door from
121
+ the diff alone.
122
+ priority: required
110
123
  - id: timely-review
111
124
  trigger: assigned for review
112
125
  instruction: Complete review within 24 hours
@@ -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
@@ -114,9 +124,13 @@ physical_spec:
114
124
  validator:
115
125
  command: "test -f commitlint.config.js || test -f .commitlintrc.js || test -f .commitlintrc.json"
116
126
  rule: "commitlint_config_exists"
127
+ # XSPEC-456 R2: judged by the CLI itself from this file's own rules (header format, the types in
128
+ # options/commit-message, rules scope-lowercase and subject-max-length). It used to pipe the message
129
+ # into `npx commitlint`, which needs the network and a commitlint config, and answered "failed" for a
130
+ # compliant message when the config was missing.
117
131
  simulator:
118
- type: command
119
- command: 'echo "{input}" | npx commitlint'
132
+ type: builtin
133
+ judge: commit-message
120
134
 
121
135
  enforcement:
122
136
  # 🔴 hook_type was "PreCommit" — Claude Code has no such event — and the
@@ -11,13 +11,23 @@ standard:
11
11
  - "Adjust confidence dynamically based on feedback"
12
12
  - "De-identify entries before storing (remove secrets, project names)"
13
13
  - "Respect noise control levels and cooldown periods"
14
+ - "Keep personal, cross-project, identifiable facts and cross-project work coordination out of memory entries (see boundary)"
14
15
 
15
16
  meta:
16
- version: "1.2.0"
17
- updated: "2026-09-25"
17
+ version: "1.2.1"
18
+ updated: "2026-10-07"
18
19
  source: core/developer-memory.md
19
20
  description: Structured system for capturing, retrieving, and surfacing developer experience insights across conversations and projects
20
21
 
22
+ boundary:
23
+ not_held_here:
24
+ - what: "個人、跨專案、可識別的資訊(誰負責什麼、怎麼連到某個環境)"
25
+ belongs_in: "使用者自己的 AI 工具記憶"
26
+ why: "去識別化會把它剝掉,所以它不能是一筆記憶條目;那種記憶綁一個使用者、一台機器,不被分享"
27
+ - what: "跨專案的工作協調(誰在等誰)"
28
+ belongs_in: "open-work-tracking(OWT-027~OWT-029)"
29
+ why: "那是開放工作,不是記憶"
30
+
21
31
  schema:
22
32
  required:
23
33
  - field: id