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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (711) hide show
  1. package/bin/uds.js +12 -1
  2. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  3. package/bundled/ai/standards/commit-message.ai.yaml +12 -2
  4. package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
  5. package/bundled/core/commit-message-guide.md +22 -19
  6. package/bundled/core/secret-management-standards.md +13 -1
  7. package/bundled/extensions/locales/zh-tw.md +19 -19
  8. package/bundled/hooks/validate-commit-msg.mjs +52 -9
  9. package/bundled/locales/zh-CN/CHANGELOG.md +2309 -1110
  10. package/bundled/locales/zh-CN/CLAUDE.md +987 -101
  11. package/bundled/locales/zh-CN/README.md +3 -3
  12. package/bundled/locales/zh-CN/SECURITY.md +3 -3
  13. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  14. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
  15. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  16. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
  17. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
  18. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
  19. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
  20. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  21. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  22. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  23. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  24. package/bundled/locales/zh-CN/core/accessibility-standards.md +871 -62
  25. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  26. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  27. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  28. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  29. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  30. package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +311 -72
  31. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  32. package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
  33. package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
  34. package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
  35. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  36. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  37. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  38. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  39. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  40. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  41. package/bundled/locales/zh-CN/core/changelog-standards.md +485 -63
  42. package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
  43. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  44. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  45. package/bundled/locales/zh-CN/core/code-review-checklist.md +37 -23
  46. package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
  47. package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
  48. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  49. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  50. package/bundled/locales/zh-CN/core/deprecation-standards.md +155 -40
  51. package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
  52. package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
  53. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  54. package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
  55. package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
  56. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  57. package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
  58. package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
  59. package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
  60. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  61. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  62. package/bundled/locales/zh-CN/core/feature-flag-standards.md +202 -57
  63. package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
  64. package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
  65. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  66. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  67. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  68. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  69. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  70. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  71. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  72. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  73. package/bundled/locales/zh-CN/core/mutation-testing.md +45 -6
  74. package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
  75. package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
  76. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  77. package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
  78. package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
  79. package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
  80. package/bundled/locales/zh-CN/core/project-structure.md +550 -170
  81. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  82. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  83. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  84. package/bundled/locales/zh-CN/core/retrospective-standards.md +215 -22
  85. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  86. package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
  87. package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
  88. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  89. package/bundled/locales/zh-CN/core/security-standards.md +169 -16
  90. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  91. package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
  92. package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
  93. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  94. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  95. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  96. package/bundled/locales/zh-CN/core/supply-chain-security-standards.md +159 -32
  97. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  98. package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
  99. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  100. package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
  101. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  102. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  103. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  104. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  105. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  106. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  107. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  108. package/bundled/locales/zh-CN/core/versioning.md +737 -73
  109. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  110. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  111. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  112. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +2 -1
  113. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  114. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
  115. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
  116. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  117. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
  118. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  119. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
  120. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  121. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  122. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +2 -0
  123. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  124. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  125. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  126. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  127. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  128. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  129. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  130. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  131. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  132. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  133. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  134. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  135. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  136. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  137. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  138. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  139. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  140. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  141. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  142. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  143. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  144. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  145. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  146. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  147. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  148. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  149. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  150. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  151. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  152. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  153. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  154. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  155. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  156. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  157. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  158. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  159. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  160. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  161. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  162. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  163. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  164. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  165. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  166. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  167. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  168. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  169. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  170. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  171. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  172. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  173. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  174. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  175. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  176. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  177. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  178. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  179. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  180. package/bundled/locales/zh-CN/skills/README.md +2 -1
  181. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  182. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  183. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  184. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  185. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  186. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  187. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  188. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  189. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  190. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  191. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  192. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  193. package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +217 -137
  194. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  195. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  196. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  197. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  198. package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +148 -132
  199. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  200. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  201. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  202. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  203. package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +122 -121
  204. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  205. package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
  206. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  207. package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
  208. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  209. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  210. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  211. package/bundled/locales/zh-CN/skills/code-review-assistant/guide.md +119 -45
  212. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  213. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  214. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  215. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  216. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  217. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  218. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  219. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  220. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  221. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  222. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  223. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  224. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  225. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  226. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  227. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  228. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  229. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  230. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  231. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  232. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  233. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  234. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  235. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  236. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  237. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  238. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  239. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  240. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  241. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  242. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  243. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  244. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  245. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  246. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  247. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  248. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  249. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  250. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  251. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  252. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  253. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  254. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  255. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  256. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  257. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  258. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  259. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  260. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  261. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +4 -4
  262. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  263. package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
  264. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  265. package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
  266. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  267. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  268. package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +4 -2
  269. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  270. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  271. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  272. package/bundled/locales/zh-CN/skills/docs-generator/guide.md +8 -7
  273. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  274. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  275. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  276. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  277. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  278. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  279. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  280. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  281. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  282. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  283. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  284. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  285. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  286. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  287. package/bundled/locales/zh-CN/skills/project-discovery/guide.md +158 -157
  288. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  289. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  290. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  291. package/bundled/locales/zh-CN/skills/refactoring-assistant/guide.md +172 -171
  292. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  293. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  294. package/bundled/locales/zh-CN/skills/release-standards/guide.md +51 -43
  295. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  296. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  297. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  298. package/bundled/locales/zh-CN/skills/requirement-assistant/guide.md +88 -79
  299. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  300. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  301. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  302. package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +2 -2
  303. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  304. package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
  305. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  306. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  307. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  308. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  309. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  310. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  311. package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +2 -2
  312. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  313. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  314. package/bundled/locales/zh-CN/skills/tdd-assistant/guide.md +217 -156
  315. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  316. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  317. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  318. package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +25 -12
  319. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  320. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  321. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  322. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  323. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  324. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  325. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  326. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  327. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  328. package/bundled/locales/zh-TW/CHANGELOG.md +2282 -1112
  329. package/bundled/locales/zh-TW/CLAUDE.md +962 -76
  330. package/bundled/locales/zh-TW/README.md +3 -3
  331. package/bundled/locales/zh-TW/SECURITY.md +3 -3
  332. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  333. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
  334. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  335. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
  336. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
  337. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
  338. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
  339. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  340. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  341. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  342. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  343. package/bundled/locales/zh-TW/core/accessibility-standards.md +895 -46
  344. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  345. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  346. package/bundled/locales/zh-TW/core/agent-dispatch.md +102 -33
  347. package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
  348. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  349. package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
  350. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  351. package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
  352. package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
  353. package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
  354. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  355. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  356. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  357. package/bundled/locales/zh-TW/core/branch-completion.md +130 -34
  358. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  359. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  360. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  361. package/bundled/locales/zh-TW/core/chaos-engineering-standards.md +138 -36
  362. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  363. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  364. package/bundled/locales/zh-TW/core/code-review-checklist.md +19 -7
  365. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  366. package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
  367. package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
  368. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  369. package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
  370. package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
  371. package/bundled/locales/zh-TW/core/developer-memory.md +102 -12
  372. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  373. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  374. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  375. package/bundled/locales/zh-TW/core/environment-standards.md +250 -72
  376. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  377. package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
  378. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  379. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  380. package/bundled/locales/zh-TW/core/feature-flag-standards.md +202 -57
  381. package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
  382. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  383. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  384. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  385. package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +234 -487
  386. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  387. package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
  388. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  389. package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
  390. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  391. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  392. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  393. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  394. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  395. package/bundled/locales/zh-TW/core/observability-standards.md +284 -40
  396. package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
  397. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  398. package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
  399. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  400. package/bundled/locales/zh-TW/core/project-context-memory.md +210 -31
  401. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  402. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  403. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  404. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  405. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  406. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  407. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  408. package/bundled/locales/zh-TW/core/runbook-standards.md +296 -23
  409. package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
  410. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  411. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  412. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  413. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  414. package/bundled/locales/zh-TW/core/slo-standards.md +301 -49
  415. package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
  416. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  417. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  418. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  419. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  420. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  421. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  422. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  423. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  424. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  425. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  426. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  427. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  428. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  429. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  430. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  431. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  432. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  433. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  434. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  435. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +2 -1
  436. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  437. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
  438. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  439. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
  440. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  441. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
  442. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  443. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
  444. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  445. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  446. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +2 -0
  447. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  448. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  449. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  450. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  451. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  452. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  453. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  454. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  455. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  456. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  457. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  458. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  459. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  460. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  461. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  462. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  463. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  464. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  465. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  466. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  467. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  468. package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +584 -475
  469. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  470. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  471. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  472. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  473. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  474. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  475. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  476. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  477. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  478. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  479. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  480. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  481. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  482. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  483. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  484. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  485. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  486. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  487. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  488. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  489. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  490. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  491. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  492. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  493. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  494. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  495. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  496. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  497. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  498. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  499. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  500. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  501. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  502. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  503. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  504. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  505. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  506. package/bundled/locales/zh-TW/skills/README.md +2 -1
  507. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  508. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  509. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  510. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  511. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  512. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  513. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  514. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  515. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  516. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  517. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  518. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  519. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  520. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  521. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  522. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  523. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  524. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  525. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  526. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  527. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  528. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  529. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  530. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  531. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  532. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  533. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  534. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  535. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  536. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  537. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  538. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  539. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  540. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  541. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  542. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  543. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  544. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  545. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  546. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  547. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  548. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  549. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  550. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  551. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  552. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  553. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  554. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  555. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  556. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  557. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  558. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  559. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  560. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  561. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  562. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  563. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  564. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  565. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  566. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  567. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  568. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  569. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  570. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  571. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  572. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  573. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  574. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  575. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  576. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  577. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  578. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  579. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  580. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  581. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  582. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  583. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  584. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  585. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  586. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  587. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  588. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  589. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  590. package/bundled/locales/zh-TW/skills/commit-standards/guide.md +137 -17
  591. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  592. package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
  593. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  594. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  595. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  596. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  597. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  598. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  599. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  600. package/bundled/locales/zh-TW/skills/docs-generator/guide.md +4 -3
  601. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  602. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  603. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  604. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  605. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  606. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  607. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  608. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  609. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  610. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  611. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  612. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  613. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  614. package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +85 -18
  615. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  616. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  617. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  618. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  619. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  620. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  621. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  622. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  623. package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +91 -45
  624. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  625. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  626. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  627. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  628. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  629. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  630. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  631. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  632. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  633. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  634. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  635. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  636. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  637. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  638. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  639. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  640. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  641. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  642. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  643. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  644. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  645. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  646. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  647. package/bundled/locales/zh-TW/skills/tdd-assistant/language-examples.md +693 -47
  648. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  649. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  650. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  651. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  652. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  653. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  654. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  655. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  656. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  657. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  658. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  659. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  660. package/bundled/skills/.claude-plugin/plugin.json +71 -0
  661. package/bundled/skills/commit-standards/SKILL.md +2 -2
  662. package/bundled/skills/commit-standards/guide.md +3 -2
  663. package/bundled/skills/commit-standards/language-options.md +19 -17
  664. package/package.json +2 -2
  665. package/src/commands/audit.js +28 -1
  666. package/src/commands/check.js +72 -3
  667. package/src/commands/compile.js +37 -4
  668. package/src/commands/config.js +49 -24
  669. package/src/commands/init.js +78 -30
  670. package/src/commands/open-work.js +6 -2
  671. package/src/commands/release-messages.js +228 -0
  672. package/src/commands/release.js +127 -68
  673. package/src/commands/run-intent.js +11 -0
  674. package/src/commands/spec.js +4 -2
  675. package/src/commands/update.js +173 -20
  676. package/src/compilers/claude-code-compiler.js +9 -1
  677. package/src/config/ai-agent-paths.js +14 -1
  678. package/src/core/installed-formats.js +15 -0
  679. package/src/core/open-work-config.js +20 -1
  680. package/src/core/project-config.js +55 -0
  681. package/src/i18n/messages.js +106 -2
  682. package/src/installers/hooks-installer.js +1 -1
  683. package/src/installers/manifest-installer.js +1 -1
  684. package/src/installers/skills-installer.js +1 -1
  685. package/src/installers/standards-installer.js +3 -1
  686. package/src/mcp/server.js +9 -3
  687. package/src/prompts/init.js +26 -22
  688. package/src/reconciler/actual-state-scanner.js +2 -8
  689. package/src/reconciler/backup-locations.js +5 -0
  690. package/src/reconciler/backup-manager.js +19 -11
  691. package/src/reconciler/desired-state-calculator.js +89 -57
  692. package/src/reconciler/plan-executor.js +101 -8
  693. package/src/reconciler/recorded-versions.js +49 -0
  694. package/src/reconciler/relative-path.js +23 -0
  695. package/src/uninstallers/hook-uninstaller.js +9 -1
  696. package/src/uninstallers/skills-uninstaller.js +22 -3
  697. package/src/utils/available-standards-report.js +25 -4
  698. package/src/utils/available-standards.js +13 -3
  699. package/src/utils/build-manifest.js +1 -1
  700. package/src/utils/commit-message-judge.js +60 -13
  701. package/src/utils/friction-detector.js +23 -11
  702. package/src/utils/git-hooks.js +106 -4
  703. package/src/utils/integration-generator.js +95 -67
  704. package/src/utils/legacy-hook-migration.js +121 -2
  705. package/src/utils/open-work-tracking.mjs +105 -16
  706. package/src/utils/sdd-header.js +16 -4
  707. package/src/utils/skills-installer.js +2 -1
  708. package/src/utils/spinner.js +14 -4
  709. package/src/utils/standard-validator.js +3 -2
  710. package/standards-registry.json +10 -8
  711. package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
@@ -26,9 +26,12 @@
26
26
  * @module utils/legacy-hook-migration
27
27
  */
28
28
 
29
- import { existsSync, readFileSync, writeFileSync } from 'fs';
29
+ import { existsSync, readFileSync, writeFileSync, chmodSync } from 'fs';
30
30
  import { join } from 'path';
31
- import { buildPreCommitBlock, UDS_HOOK_MARKER, BARE_UDS_RUNNER_RE, hasBareUdsRunner } from './git-hooks.js';
31
+ import {
32
+ buildPreCommitBlock, buildNativePreCommitHook, classifyNativePreCommitHook,
33
+ UDS_HOOK_MARKER, UDS_HOOK_END_MARKER, BARE_UDS_RUNNER_RE, hasBareUdsRunner
34
+ } from './git-hooks.js';
32
35
  import { getFileRecord, proveUnchanged, recordFile, newRecorder, RECORD_KINDS } from '../core/install-records.js';
33
36
 
34
37
  /** The exact command lines UDS itself has written under the marker, and the extra arguments each carried. */
@@ -110,3 +113,119 @@ export function migrateLegacyHuskyHook(projectPath, { plan = false, manifest = n
110
113
  }
111
114
  return { state: 'migrated', replaced, kept, recorder };
112
115
  }
116
+
117
+ // ─────────────────────────────────────────────────────────────────────────────
118
+ // XSPEC-482 R3 + R5: pre-commit hooks that look like a check and cannot stop a commit.
119
+ //
120
+ // Two shapes are on disk in projects UDS set up earlier, and both let every commit through:
121
+ // - `.git/hooks/pre-commit` of 5.x .. 6.13.1: `uds check 2>/dev/null || true` (the CLI PATH happens to
122
+ // hold, errors thrown away, "Pre-commit checks passed" printed whatever happened);
123
+ // - the hook of 6.14.0-beta.2 .. beta.12 (native file, or the block inside `.husky/pre-commit`): it runs
124
+ // the installed CLI, but `check` without `--ci` exits 0 when a standard file was edited.
125
+ // `uds init` now writes `check --ci`. These functions bring the files already on disk to it.
126
+ //
127
+ // What counts as "UDS wrote this": the whole file equals one of the known texts (native hook), or the
128
+ // block between UDS's two marker lines equals the known block (husky). Exact equality, not a pattern: a
129
+ // hook someone edited is NOT replaced - it is reported with the line number and what to write instead.
130
+ // ─────────────────────────────────────────────────────────────────────────────
131
+
132
+
133
+ /** A hook line that runs a UDS check and is built never to fail: `... check ... || true`. */
134
+ const ALWAYS_PASS_CHECK_RE = /\b(?:uds|universal-dev-standards)\s+check\b[^\n]*\|\|\s*true\b/;
135
+
136
+ /**
137
+ * Bring the native `.git/hooks/pre-commit` of an older UDS to the one this CLI writes.
138
+ *
139
+ * @param {string} projectPath
140
+ * @param {{plan?: boolean}} [opts] plan - report what would change, write nothing
141
+ * @returns {{
142
+ * file: '.git/hooks/pre-commit',
143
+ * state: 'none'|'migrated'|'would-migrate'|'kept'|'error',
144
+ * from?: 'legacy-6.11'|'without-ci',
145
+ * kept: Array<{line: number, text: string}>, // lines that make the check always pass, in a file UDS cannot prove it wrote
146
+ * recorder: object|null, // install record to fold into the manifest when non-null
147
+ * error?: string
148
+ * }}
149
+ */
150
+ export function migrateOlderNativeHook(projectPath, { plan = false } = {}) {
151
+ const file = '.git/hooks/pre-commit';
152
+ const abs = join(projectPath, '.git', 'hooks', 'pre-commit');
153
+ const none = { file, state: 'none', kept: [], recorder: null };
154
+ if (!existsSync(abs)) return none;
155
+
156
+ let content;
157
+ try {
158
+ content = readFileSync(abs, 'utf-8');
159
+ } catch (e) {
160
+ return { ...none, state: 'error', error: e.message };
161
+ }
162
+
163
+ const known = classifyNativePreCommitHook(content);
164
+ if (known === 'legacy-6.11' || known === 'without-ci') {
165
+ if (plan) return { ...none, state: 'would-migrate', from: known };
166
+ try {
167
+ // Keep the file's own line endings: a hook saved with CRLF stays CRLF (the husky path below does the same).
168
+ const fresh = buildNativePreCommitHook();
169
+ writeFileSync(abs, content.includes('\r\n') ? fresh.replace(/\n/g, '\r\n') : fresh, 'utf-8'); // wire:native-migration-keeps-eol
170
+ // writeFileSync keeps an existing file's mode; make sure git will still run it.
171
+ if (process.platform !== 'win32') chmodSync(abs, 0o755);
172
+ } catch (e) {
173
+ return { ...none, state: 'error', from: known, error: e.message };
174
+ }
175
+ // The whole file is UDS's again: record it, so `uds uninstall` can delete it as provably ours.
176
+ const recorder = newRecorder();
177
+ recordFile(recorder, projectPath, file, RECORD_KINDS.GIT_HOOK);
178
+ return { ...none, state: 'migrated', from: known, recorder };
179
+ }
180
+ if (known === 'current') return none;
181
+
182
+ // Not a text UDS wrote: if it still carries the always-pass check, say where. It is not replaced.
183
+ const kept = [];
184
+ content.split('\n').forEach((raw, i) => {
185
+ const text = raw.replace(/\r$/, '');
186
+ if (ALWAYS_PASS_CHECK_RE.test(text)) kept.push({ line: i + 1, text: text.trim() });
187
+ });
188
+ return kept.length > 0 ? { ...none, state: 'kept', kept } : none;
189
+ }
190
+
191
+ /**
192
+ * Bring the block `.husky/pre-commit` carries from beta.2 .. beta.12 (`check` without `--ci`) to the current one.
193
+ * Only the block between UDS's two marker lines, and only when it is exactly the old text; the lines around it
194
+ * are the adopter's and stay as they are.
195
+ *
196
+ * @param {string} projectPath
197
+ * @param {{plan?: boolean, manifest?: object|null}} [opts] manifest - read only to see whether the whole file was provably UDS's
198
+ * @returns {{file: '.husky/pre-commit', state: 'none'|'migrated'|'would-migrate'|'error', recorder: object|null, error?: string}}
199
+ */
200
+ export function migrateHuskyBlockWithoutCi(projectPath, { plan = false, manifest = null } = {}) {
201
+ const file = '.husky/pre-commit';
202
+ const abs = join(projectPath, '.husky', 'pre-commit');
203
+ const none = { file, state: 'none', recorder: null };
204
+ if (!existsSync(abs)) return none;
205
+
206
+ let content;
207
+ try {
208
+ content = readFileSync(abs, 'utf-8');
209
+ } catch (e) {
210
+ return { ...none, state: 'error', error: e.message };
211
+ }
212
+ const eol = content.includes('\r\n') ? '\r\n' : '\n';
213
+ const text = content.replace(/\r\n/g, '\n');
214
+ const oldBlock = buildPreCommitBlock({ ci: false });
215
+ if (!text.includes(oldBlock) || !text.includes(UDS_HOOK_END_MARKER)) return none;
216
+ if (plan) return { ...none, state: 'would-migrate' };
217
+
218
+ const wasProven = !!manifest && !!getFileRecord(manifest, file) && proveUnchanged(manifest, projectPath, file).state === 'proven';
219
+ try {
220
+ const next = text.replace(oldBlock, buildPreCommitBlock());
221
+ writeFileSync(abs, eol === '\r\n' ? next.replace(/\n/g, '\r\n') : next, 'utf-8');
222
+ } catch (e) {
223
+ return { ...none, state: 'error', error: e.message };
224
+ }
225
+ let recorder = null;
226
+ if (wasProven) {
227
+ recorder = newRecorder();
228
+ recordFile(recorder, projectPath, file, RECORD_KINDS.GIT_HOOK);
229
+ }
230
+ return { ...none, state: 'migrated', recorder };
231
+ }
@@ -130,7 +130,7 @@
130
130
  * uds open-work revision --file PATH --base GIT_REV
131
131
  * uds open-work revision --before FILE --after FILE
132
132
  * uds open-work separation <file...> [--next-action-word WORD ...]
133
- * uds open-work waiting <file...> [--root DIR] [--root NAME=DIR ...] [--id-pattern RE] [--now YYYY-MM-DD]
133
+ * uds open-work waiting <file...> [--root DIR] [--root NAME=DIR ...] [--id-pattern RE] [--now YYYY-MM-DD] [--asked-at-word WORD ...] [--waiting-for-word WORD ...]
134
134
  * uds open-work observations <file...> [--now YYYY-MM-DD] [--stale-after DAYS]
135
135
  * uds open-work self-test
136
136
  * node scripts/check-open-work-tracking.mjs next-action <file...> ... (repo clone)
@@ -202,6 +202,34 @@ export function normaliseDeclaredWords(raw = []) {
202
202
  return { words, error: null };
203
203
  }
204
204
 
205
+ /**
206
+ * Field words an adopter declares for the waiting checks (XSPEC-475 R3): the words that head the asked-at column and the
207
+ * "what is it waiting for" column in THIS project's carriers. Same rules as the next-action words: plain text, never a
208
+ * pattern, case-insensitive, and a blank one is refused (an empty alternative would match every header).
209
+ * @param {string[]} raw
210
+ * @param {string} flag - the option name, for the message (for example `--asked-at-word`)
211
+ * @param {string} example - a word to show in the message
212
+ * @returns {{words:string[], error:string|null}}
213
+ */
214
+ export function normaliseDeclaredFieldWords(raw = [], flag = '--asked-at-word', example = '何時問') {
215
+ const words = [];
216
+ for (const w of raw) {
217
+ const word = typeof w === 'string' ? w.replace(/\s+/g, ' ').trim() : '';
218
+ if (!word) return { words: [], error: `a declared ${flag} is empty or blank; it would match every header, so it is refused (give the exact word, for example ${flag} ${example})` }; // [mutation-anchor:blank-field-word-refused]
219
+ if (!words.some((x) => x.toLowerCase() === word.toLowerCase())) words.push(word);
220
+ }
221
+ return { words, error: null };
222
+ }
223
+
224
+ /** `--asked-at-word` and `--waiting-for-word`, validated: `{ words: { askedAt, awaiting }, error }`. */
225
+ function declaredRoleWords(flagAll) {
226
+ const askedAt = normaliseDeclaredFieldWords(flagAll('--asked-at-word'), '--asked-at-word', '何時問');
227
+ if (askedAt.error) return { words: {}, error: askedAt.error };
228
+ const awaiting = normaliseDeclaredFieldWords(flagAll('--waiting-for-word'), '--waiting-for-word', '問什麼');
229
+ if (awaiting.error) return { words: {}, error: awaiting.error };
230
+ return { words: { askedAt: askedAt.words, awaiting: awaiting.words }, error: null };
231
+ }
232
+
205
233
  /**
206
234
  * Program names an adopter declares (461 R5), under the same rules as the next-action words: plain text, never a
207
235
  * pattern, and a blank one is refused. A command is one program name, so a word with a space in it could never
@@ -553,9 +581,14 @@ export function checkSeparation(carriers, opts = {}) {
553
581
 
554
582
  const stripPunct = (s) => s.replace(/^[("'「『“]+|[)"'」』”.,;:!?、。,;:)]+$/g, '');
555
583
 
584
+ // A slash command (`/work`, `/sdd`): one leading slash and one word, no extension. It names an action to run, not a file.
585
+ // XSPEC-475 R5(b): it used to be read as the absolute path `/work` and reported path-missing.
586
+ const SLASH_COMMAND = /^\/[A-Za-z][\w-]*$/;
587
+
556
588
  function pathLike(tok, inCode) {
557
589
  const t = stripPunct(tok).replace(/:\d+(?::\d+)?$/, '');
558
590
  if (!t || /\s/.test(t) || /^[a-z][a-z0-9+.-]*:\/\//i.test(t)) return null;
591
+ if (SLASH_COMMAND.test(t)) return null; // [mutation-anchor:slash-command-not-path]
559
592
  const segs = t.split('/');
560
593
  const last = segs[segs.length - 1];
561
594
  const ext = /\.([A-Za-z0-9]+)$/.exec(last);
@@ -581,7 +614,8 @@ export function classifyNextAction(text, opts = {}) {
581
614
  const prose = text.replace(/`([^`]+)`/g, (_, c) => {
582
615
  const code = c.trim();
583
616
  const first = code.split(/\s+/)[0].replace(/^\$\s*/, '');
584
- if (pathLike(code, true)) push('path', pathLike(code, true)); // [mutation-anchor:kind-path]
617
+ if (/^\/[A-Za-z][\w-]*(?:\s|$)/.test(code)) push('command', code); // a slash command, with or without arguments (XSPEC-475 R5(b))
618
+ else if (pathLike(code, true)) push('path', pathLike(code, true)); // [mutation-anchor:kind-path]
585
619
  else if (commands.includes(first) || /^\.{1,2}\//.test(first)) push('command', code); // [mutation-anchor:kind-command]
586
620
  else if (/\.(?:test|spec)\.[cm]?[jt]sx?|(?:^|[\s/])test_\w+|::/.test(code)) push('test', code); // [mutation-anchor:kind-test]
587
621
  else {
@@ -596,6 +630,7 @@ export function classifyNextAction(text, opts = {}) {
596
630
  for (const tok of prose.split(/\s+/)) {
597
631
  const p = pathLike(tok, false);
598
632
  if (p) push('path', p);
633
+ else if (SLASH_COMMAND.test(stripPunct(tok))) push('command', stripPunct(tok));
599
634
  }
600
635
  const cmdRe = new RegExp(`(?:^|[^\\w-])(${commands.map(escapeRegExp).join('|')})\\s+([-@\\w./:]+)`, 'g');
601
636
  let m;
@@ -738,7 +773,7 @@ export function checkNextActions(carriers, opts = {}) {
738
773
  const staleAfter = opts.staleAfterDays ?? DEFAULT_STALE_AFTER_DAYS;
739
774
  const res = { walked: 0, empty: 0, counts: { 'named-resolved': 0, 'named-unresolved': 0, unnamed: 0, 'waiting-on-reply': 0 }, unresolvedSplit: { 'path-missing': 0, 'not-resolvable': 0 }, violations: [], detail: [], noFieldCarriers: [], undecidable: [], waitingOnReply: [], staleAfter };
740
775
  // No project is declared, so no other project is looked up: this call reads the carriers' own rows and nothing else.
741
- const rows = checkWaiting(carriers, { now, root: opts.root, idPattern: opts.idPattern, extraCommands: opts.extraCommands, projects: new Map() }).records;
776
+ const rows = checkWaiting(carriers, { now, root: opts.root, idPattern: opts.idPattern, extraCommands: opts.extraCommands, roleWords: opts.roleWords, projects: new Map() }).records;
742
777
  for (const c of carriers) {
743
778
  const { fields, items, ragged } = extractNextActions(c.content, opts.words);
744
779
  for (const g of ragged) res.undecidable.push({ path: c.path, ...g });
@@ -897,7 +932,28 @@ export const DEFAULT_STALE_AFTER_DAYS = 7;
897
932
  const BLANK_FIELD = /^(?:|-+|—|–|n\/?a|none|tbd|\?+|無|待定|未知|unknown)$/i;
898
933
  const stripMd = (s) => s.replace(/\*\*|__|`/g, '').trim();
899
934
 
900
- const rolesOf = (header) => Object.entries(VOCAB_STATE.roles).filter(([, re]) => re.test(header)).map(([role]) => role);
935
+ /** A regex for words the adopter declared for one role, or null when there are none. Plain text, any case. */
936
+ const plainAlternation = (words) => words.map((w) => escapeRegExp(w)).join('|');
937
+ const declaredRoleRegExp = (words = []) => (words.length ? new RegExp(plainAlternation(words), 'i') : null);
938
+
939
+ /**
940
+ * The roles a header (or label) plays: the built-in vocabulary, plus the words the adopter declared for `askedAt` and
941
+ * `awaiting` (XSPEC-475 R3). `roleWords` is `{ askedAt: string[], awaiting: string[] }`.
942
+ */
943
+ const rolesOf = (header, roleWords = {}) => {
944
+ const roles = Object.entries(VOCAB_STATE.roles).filter(([, re]) => re.test(header)).map(([role]) => role);
945
+ for (const role of ['askedAt', 'awaiting']) {
946
+ if (!roles.includes(role) && declaredRoleRegExp(roleWords[role])?.test(header)) roles.push(role); // [mutation-anchor:declared-role-word]
947
+ }
948
+ return roles;
949
+ };
950
+
951
+ /** The words that are read as these roles out of the box, for a message that says what is accepted. */
952
+ const ACCEPTED_ROLE_WORDS = {
953
+ askedAt: 'asked-at, asked on, asked date, 詢問時間, 詢問日期, 發問時間, 發問日期, 送出時間, 送出日期, 寄出時間, 寄出日期, 已問時間, 已問日期, 問於',
954
+ awaiting: 'waiting for, waiting on, awaiting, blocked on, 等什麼, 等待對象, 等待什麼, 等待內容, 等誰',
955
+ release: 'release, unblock, 解除, 放行',
956
+ };
901
957
 
902
958
  // inline labels in a list item: "status: not-yet-asked; draft: drafts/q.md"
903
959
  const LABEL_WORDS = [
@@ -917,9 +973,10 @@ const LABEL_WORDS = [
917
973
  ['nextAction', VOCAB.nextAction],
918
974
  ];
919
975
 
920
- function parseRoleLabels(text) {
976
+ function parseRoleLabels(text, roleWords = {}) {
921
977
  const hits = [];
922
- for (const [role, word] of LABEL_WORDS) {
978
+ const declaredLabels = ['askedAt', 'awaiting'].filter((role) => (roleWords[role] || []).length).map((role) => [role, { source: plainAlternation(roleWords[role]) }]);
979
+ for (const [role, word] of [...LABEL_WORDS, ...declaredLabels]) {
923
980
  const re = new RegExp(`(?:^|[;;,,|((]\\s*|\\s)(${word.source})[\\w\\s-]{0,12}[::]`, 'gi');
924
981
  let m;
925
982
  while ((m = re.exec(text)) !== null) {
@@ -950,7 +1007,7 @@ function parseRoleLabels(text) {
950
1007
  * `ragged`, never read as empty (same rule as the next-action table).
951
1008
  * @returns {{records:object[], ragged:object[]}}
952
1009
  */
953
- export function extractRecords(md) {
1010
+ export function extractRecords(md, roleWords = {}) {
954
1011
  const lines = parseDoc(md);
955
1012
  const records = [];
956
1013
  const ragged = [];
@@ -958,7 +1015,7 @@ export function extractRecords(md) {
958
1015
  for (const t of findTables(lines)) {
959
1016
  inTable.add(t.headerIdx); inTable.add(t.headerIdx + 1);
960
1017
  t.rows.forEach((r) => inTable.add(r.idx));
961
- const roles = t.header.map(rolesOf);
1018
+ const roles = t.header.map((h) => rolesOf(h, roleWords));
962
1019
  const columns = new Set(roles.flat());
963
1020
  if (!columns.size) continue;
964
1021
  for (const r of t.rows) {
@@ -968,16 +1025,16 @@ export function extractRecords(md) {
968
1025
  const f = {};
969
1026
  const fr = {};
970
1027
  roles.forEach((rs, n) => rs.forEach((role) => { if (f[role] === undefined) { f[role] = stripMd(r.cells[n]); fr[role] = r.cells[n]; } }));
971
- records.push({ where, title, f, fr, columns, lineStart: r.idx, lineEnd: r.idx });
1028
+ records.push({ where, title, f, fr, columns, headers: t.header.map(stripMd), lineStart: r.idx, lineEnd: r.idx });
972
1029
  }
973
1030
  }
974
1031
  let cur = null;
975
1032
  const flush = () => {
976
1033
  if (cur) {
977
1034
  const text = cur.parts.join(' ; ');
978
- const { f, fr, title } = parseRoleLabels(text);
1035
+ const { f, fr, title } = parseRoleLabels(text, roleWords);
979
1036
  if (Object.keys(f).length) {
980
- records.push({ where: `list item (line ${cur.idx + 1}, "${clip(title || stripMd(cur.parts[0]), 40)}")`, title: title || stripMd(cur.parts[0]), f, fr, columns: new Set(Object.keys(f)), lineStart: cur.idx, lineEnd: cur.end });
1037
+ records.push({ where: `list item (line ${cur.idx + 1}, "${clip(title || stripMd(cur.parts[0]), 40)}")`, title: title || stripMd(cur.parts[0]), f, fr, columns: new Set(Object.keys(f)), headers: null, lineStart: cur.idx, lineEnd: cur.end });
981
1038
  }
982
1039
  }
983
1040
  cur = null;
@@ -1153,6 +1210,25 @@ export function resolveReference(ref, projects, env = REAL_ENV) {
1153
1210
  return { status: 'needs-a-person', why: `a ${ref.kind === 'id' ? 'requirement or specification identifier' : ref.kind === 'object' ? 'free-form object' : ref.kind} in another project has nothing this check can read` }; // [mutation-anchor:needs-a-person]
1154
1211
  }
1155
1212
 
1213
+ /** The option and uds.project.yaml key that declare a word for each role (XSPEC-475 R3). `release` has none: it is not declarable. */
1214
+ const ROLE_DECLARE = {
1215
+ askedAt: { label: 'asked-at', flag: '--asked-at-word', key: 'open_work.asked_at_words' },
1216
+ awaiting: { label: 'what it waits for', flag: '--waiting-for-word', key: 'open_work.waiting_for_words' },
1217
+ release: { label: 'release', flag: null, key: null },
1218
+ };
1219
+
1220
+ /**
1221
+ * Appended to a violation when the record has NO field read as `role` at all (as opposed to a field that is empty or wrong):
1222
+ * says what was looked for, what the record showed, and how to declare the project's own word. XSPEC-475 R3.
1223
+ */
1224
+ function fieldNotFound(record, role, roleWords = {}) {
1225
+ const d = ROLE_DECLARE[role];
1226
+ const seen = record.headers ? `headers seen: ${record.headers.map((h) => `"${clip(h, 30)}"`).join(', ')}` : `labels seen: ${[...record.columns].join(', ')}`;
1227
+ const declared = (roleWords[role] || []).length ? `; declared by you: ${roleWords[role].join(', ')}` : '';
1228
+ const how = d.flag ? ` To declare your own word: ${d.flag} <word>, or ${d.key} in uds.project.yaml.` : '';
1229
+ return `. No column or label of this record is read as ${d.label} (${seen}). Accepted: ${ACCEPTED_ROLE_WORDS[role]}${declared}.${how}`;
1230
+ }
1231
+
1156
1232
  /**
1157
1233
  * OWT-020 / OWT-021 / OWT-022. Reads every record that has a status field (OWT-010: a structural
1158
1234
  * field, never prose). `now` is a UTC day (ms); inject it, never read the clock inside a rule.
@@ -1169,8 +1245,9 @@ export function checkWaiting(carriers, opts = {}) {
1169
1245
  // list to decide which rows OWT-019 does not apply to, so the two commands cannot disagree about a row (R2 by construction).
1170
1246
  records: [],
1171
1247
  };
1248
+ const roleWords = opts.roleWords ?? {}; // XSPEC-475 R3: the asked-at / waiting-for words the project declared
1172
1249
  for (const c of carriers) {
1173
- const { records, ragged } = extractRecords(c.content);
1250
+ const { records, ragged } = extractRecords(c.content, roleWords);
1174
1251
  for (const g of ragged) if (g.columns.has('status')) res.ragged.push({ path: c.path, ...g });
1175
1252
  const withStatus = records.filter((r) => r.f.status !== undefined);
1176
1253
  if (!withStatus.length) { res.noStateCarriers.push(c.path); continue; }
@@ -1209,12 +1286,15 @@ export function checkWaiting(carriers, opts = {}) {
1209
1286
  }
1210
1287
  if (state === 'asked-awaiting') {
1211
1288
  const day = parseDay(r.f.askedAt);
1212
- if (day === null) bad('OWT-022', r.f.askedAt === undefined || BLANK_FIELD.test(r.f.askedAt ?? '') ? 'is asked-awaiting but has no asked-at' : `has an asked-at that is not a date with a year: "${clip(r.f.askedAt, 40)}"`); // [mutation-anchor:asked-at-required]
1289
+ // XSPEC-475 R3: three different faults, three different messages. A field that was not FOUND is a vocabulary problem (the
1290
+ // project may call the column something else, and can declare it); a field that is blank or not a date is a value problem.
1291
+ if (day === null) bad('OWT-022', r.f.askedAt === undefined ? `is asked-awaiting but has no asked-at${fieldNotFound(r, 'askedAt', roleWords)}` : BLANK_FIELD.test(r.f.askedAt) ? 'is asked-awaiting but has no asked-at' : `has an asked-at that is not a date with a year: "${clip(r.f.askedAt, 40)}"`); // [mutation-anchor:asked-at-required]
1213
1292
  else if (day > now) bad('OWT-022', `has an asked-at (${dayString(day)}) later than today (${dayString(now)})`);
1214
1293
  else { note.push(`asked ${ageDays(now, day)}d ago`); askedDay = day; }
1215
1294
  const hasWhat = r.f.awaiting !== undefined && !BLANK_FIELD.test(r.f.awaiting);
1216
1295
  const hasRelease = r.f.release !== undefined && !BLANK_FIELD.test(r.f.release);
1217
- if (!(hasWhat && hasRelease)) bad('OWT-022', `is asked-awaiting but does not state ${!hasWhat && !hasRelease ? 'what it waits for and what event releases it' : !hasWhat ? 'what it waits for' : 'what event releases it'} (OWT-002)`); // [mutation-anchor:asked-release-required]
1296
+ const notFound = (!hasWhat && r.f.awaiting === undefined ? fieldNotFound(r, 'awaiting', roleWords) : '') + (!hasRelease && r.f.release === undefined ? fieldNotFound(r, 'release', roleWords) : '');
1297
+ if (!(hasWhat && hasRelease)) bad('OWT-022', `is asked-awaiting but does not state ${!hasWhat && !hasRelease ? 'what it waits for and what event releases it' : !hasWhat ? 'what it waits for' : 'what event releases it'} (OWT-002)${notFound}`); // [mutation-anchor:asked-release-required]
1218
1298
  }
1219
1299
  res.detail.push({ ...at, state, text: r.title, note: note.join(', ') });
1220
1300
  // 464 R1: `asked-awaiting` and nothing OWT-020 or OWT-022 objects to. Both rules are read from what THIS function just raised
@@ -1338,6 +1418,11 @@ export function selfTestArms() {
1338
1418
  expect('OWT-022 violating: asked-awaiting does not say what releases it (OWT-002)', ruleOf(waiting('| q | asked-awaiting | | 2026-10-01 | the quote | |\n'), 'OWT-022') === 1);
1339
1419
  expect('OWT-022 clean: asked-awaiting with asked-at, what it waits for and its release', ruleOf(waiting('| q | asked-awaiting | | 2026-10-01 | the quote | the reply arrives |\n'), 'OWT-022') === 0);
1340
1420
  expect('OWT-020 clean: a done item is not waiting', waiting('| q | done | | | | |\n').violations.length === 0);
1421
+ // XSPEC-475 R3: the words the not-found message lists as accepted are the words the vocabulary reads (one list said twice would drift), and a declared header is read.
1422
+ expect('XSPEC-475 R3 clean: every word the not-found message lists as accepted is read by the vocabulary', Object.entries(ACCEPTED_ROLE_WORDS).every(([role, list]) => list.split(', ').every((w) => VOCAB_STATE.roles[role].test(w))));
1423
+ const declaredTab = '| item | status | 何時問 | 問什麼 | release |\n|---|---|---|---|---|\n| q | asked-awaiting | 2026-10-01 | the quote | the reply arrives |\n';
1424
+ expect('XSPEC-475 R3 violating: a header the vocabulary does not hold is not read as asked-at until it is declared', ruleOf(checkWaiting([{ path: 'd.md', content: declaredTab }], { now: NOW }), 'OWT-022') >= 1);
1425
+ expect('XSPEC-475 R3 clean: the same header, declared, is read as asked-at and as what it waits for', ruleOf(checkWaiting([{ path: 'd.md', content: declaredTab }], { now: NOW, roleWords: { askedAt: ['何時問'], awaiting: ['問什麼'] } }), 'OWT-022') === 0);
1341
1426
 
1342
1427
  const otab = (rows) => `| fact | status | observed-by | observed-at | value |\n|---|---|---|---|---|\n${rows}`;
1343
1428
  const obs = (rows, o = {}) => checkObservations([{ path: 'o.md', content: otab(rows) }], { now: NOW, ...o });
@@ -1520,6 +1605,8 @@ export function main(argv, io = { log: console.log, err: console.error }) {
1520
1605
  if (declared.error) { say(`[owt] next-action: ${declared.error}`); return finish(2); }
1521
1606
  const commandsDeclared = normaliseDeclaredCommands(flagAll('--command-word'));
1522
1607
  if (commandsDeclared.error) { say(`[owt] next-action: ${commandsDeclared.error}`); return finish(2); }
1608
+ const roleWords = declaredRoleWords(flagAll);
1609
+ if (roleWords.error) { say(`[owt] next-action: ${roleWords.error}`); return finish(2); }
1523
1610
  // 464: today and the stale threshold are injected, as they are for `waiting` and `observations`, never read inside a rule.
1524
1611
  const nowArg = flag('--now');
1525
1612
  const now = nowArg === undefined ? todayUtc() : parseDay(nowArg);
@@ -1530,7 +1617,7 @@ export function main(argv, io = { log: console.log, err: console.error }) {
1530
1617
  const files = args;
1531
1618
  if (!files.length) { say('[owt] next-action: no files given'); return finish(2); }
1532
1619
  const carriers = files.map(readCarrier);
1533
- const res = checkNextActions(carriers, { root, idPattern, words: declared.words, extraCommands: commandsDeclared.words, now, staleAfterDays });
1620
+ const res = checkNextActions(carriers, { root, idPattern, words: declared.words, extraCommands: commandsDeclared.words, roleWords: roleWords.words, now, staleAfterDays });
1534
1621
  say(`[owt] OWT-019 walked ${res.walked} next-action field(s) in ${files.length} carrier(s); ${res.empty} empty/done field(s) not evaluated; ${res.noFieldCarriers.length} carrier(s) had no next-action field`);
1535
1622
  // `waiting-on-reply=N` is appended only when N is not 0, as `waiting-cross-project` is: a carrier with no such row prints what it always printed.
1536
1623
  say(`[owt] named-resolved=${res.counts['named-resolved']} named-unresolved=${res.counts['named-unresolved']} unnamed=${res.counts.unnamed} undecidable-table-rows=${res.undecidable.length}${res.counts['waiting-on-reply'] ? ` waiting-on-reply=${res.counts['waiting-on-reply']}` : ''}`);
@@ -1609,11 +1696,13 @@ export function main(argv, io = { log: console.log, err: console.error }) {
1609
1696
  const idPattern = cmd === 'waiting' ? flag('--id-pattern') : undefined;
1610
1697
  const commandsDeclared = cmd === 'waiting' ? normaliseDeclaredCommands(flagAll('--command-word')) : { words: [], error: null };
1611
1698
  if (commandsDeclared.error) { say(`[owt] waiting: ${commandsDeclared.error}`); return finish(2); }
1699
+ const roleWords = cmd === 'waiting' ? declaredRoleWords(flagAll) : { words: {}, error: null };
1700
+ if (roleWords.error) { say(`[owt] waiting: ${roleWords.error}`); return finish(2); }
1612
1701
  const files = args;
1613
1702
  if (!files.length) { say(`[owt] ${cmd}: no files given`); return finish(2); }
1614
1703
  const carriers = files.map(readCarrier);
1615
1704
  if (cmd === 'waiting') {
1616
- const res = checkWaiting(carriers, { now, root, idPattern, projects, extraCommands: commandsDeclared.words });
1705
+ const res = checkWaiting(carriers, { now, root, idPattern, projects, extraCommands: commandsDeclared.words, roleWords: roleWords.words });
1617
1706
  say(`[owt] OWT-020/021/022 walked ${res.walked} record(s) with a status field in ${carriers.length} carrier(s) (today ${dayString(now)}); ${res.noStateCarriers.length} carrier(s) had none`);
1618
1707
  say(`[owt] not-yet-asked=${res.counts['not-yet-asked']} asked-awaiting=${res.counts['asked-awaiting']} waiting-unspecified=${res.counts['waiting-unspecified']} done=${res.counts.done} other=${res.counts.other}${res.counts['waiting-cross-project'] ? ` waiting-cross-project=${res.counts['waiting-cross-project']}` : ''} undecidable-table-rows=${res.ragged.length}`);
1619
1708
  for (const d of res.detail) say(`[owt] ${d.state.padEnd(20)} ${d.path} ${d.where}: ${d.text.slice(0, 60)}${d.note ? ` (${d.note})` : ''}`);
@@ -12,10 +12,12 @@
12
12
  */
13
13
 
14
14
  /** Where a status or type can be read in a header table: `| Status | Approved (2026-01-01) |`. */
15
- const TABLE_FIELD = (name) => new RegExp(`^\\|\\s*\\**\\s*${name}\\s*\\**\\s*\\|\\s*(.+?)\\s*\\|?\\s*$`, 'i');
15
+ const TABLE_FIELD = (name) => new RegExp(`^\\|\\s*\\**\\s*(?:${name})\\s*\\**\\s*\\|\\s*(.+?)\\s*\\|?\\s*$`, 'i');
16
16
  /** ...in a field line: `- **Status**: Archived`, `> **Status**: Stable`, `Status: Draft`. */
17
- const LINE_FIELD = (name) => new RegExp(`^[\\s>*-]*\\**\\s*${name}\\s*\\**\\s*[:\uFF1A]\\s*\\**\\s*(.+?)\\s*$`, 'i');
17
+ const LINE_FIELD = (name) => new RegExp(`^[\\s>*-]*\\**\\s*(?:${name})\\s*\\**\\s*[:\uFF1A]\\s*\\**\\s*(.+?)\\s*$`, 'i');
18
18
  const TABLE_SEPARATOR = /^\|[\s:|-]+\|?\s*$/;
19
+ /** Between two fields on one line: a full-width or half-width bar. */
20
+ const FIELD_SEPARATOR = /\s*[\uFF5C|]\s*/;
19
21
 
20
22
  /** First word of a header value, lower-cased (`Approved (2026-01-01)` -> `approved`); text it cannot split stays as written. */
21
23
  function headerWord(value) {
@@ -51,15 +53,25 @@ export function readSddHeader(content) {
51
53
  const row = TABLE_FIELD(name).exec(lines[i]);
52
54
  // A header row of a table (`| Status | Description |`) is followed by a separator row; a field row is not.
53
55
  if (row && !TABLE_SEPARATOR.test(lines[i + 1] || '')) return headerWord(row[1]);
56
+ // XSPEC-475 R8: several fields on one line, separated by a full-width `|` or a half-width `|`
57
+ // (`**規格**: SPEC-002 | **狀態**: Draft(驗收中)`). Each piece is read as a field line of its own. A table row
58
+ // (a line that starts with `|`) was handled above and is never split.
59
+ if (!/^\s*\|/.test(lines[i])) {
60
+ for (const piece of lines[i].split(FIELD_SEPARATOR)) {
61
+ const inPiece = LINE_FIELD(name).exec(piece); // [mutation-anchor:same-line-fields]
62
+ if (inPiece) return headerWord(inPiece[1]);
63
+ }
64
+ }
54
65
  const field = LINE_FIELD(name).exec(lines[i]);
55
66
  if (field) return headerWord(field[1]);
56
67
  }
57
68
  for (const line of frontMatter) {
58
- const fm = new RegExp(`^${name}\\s*:\\s*(.+?)\\s*$`, 'i').exec(line);
69
+ const fm = new RegExp(`^(?:${name})\\s*:\\s*(.+?)\\s*$`, 'i').exec(line);
59
70
  if (fm) return headerWord(fm[1]);
60
71
  }
61
72
  return null;
62
73
  };
63
74
 
64
- return { title, status: read('Status'), type: read('Type') };
75
+ // // implements XSPEC-475 R5(a): the Chinese field names (`| 狀態 |`, `**狀態**: Draft`) are read like the English ones
76
+ return { title, status: read('Status|狀態'), type: read('Type|類型') };
65
77
  }
@@ -158,7 +158,8 @@ export function getSkillsSourceEntryNames() {
158
158
  try {
159
159
  return new Set(
160
160
  readdirSync(SKILLS_LOCAL_DIR, { withFileTypes: true })
161
- .filter((e) => e.isDirectory())
161
+ // Dot folders are settings, not skills (skills/.claude-plugin holds the plugin manifest, 2026-10-21).
162
+ .filter((e) => e.isDirectory() && !e.name.startsWith('.'))
162
163
  .map((e) => e.name)
163
164
  );
164
165
  } catch {
@@ -22,10 +22,20 @@ import ora from 'ora';
22
22
  * @returns {import('ora').Ora}
23
23
  */
24
24
  export function createSpinner(options) {
25
- if (typeof options === 'string') {
26
- return ora({ text: options, stream: process.stdout });
27
- }
28
- return ora({ stream: process.stdout, ...options });
25
+ const base = typeof options === 'string' ? { text: options } : options;
26
+ return ora({ stream: process.stdout, ...base, ...disabledWhenNoWidth(process.stdout) });
27
+ }
28
+
29
+ /**
30
+ * ora's clear step divides the length of the line by the stream's width to know how many lines to erase. A terminal that
31
+ * reports a width of 0 (a pty opened with no window size, which is what `expect` and some CI runners give a child) makes
32
+ * that Infinity, and the spinner sat in the erase loop at full CPU, so the command never finished (XSPEC-482 R14f).
33
+ * With no usable width there is nothing to animate: the spinner is switched off and prints its plain lines instead.
34
+ * @param {{isTTY?: boolean, columns?: number}} stream
35
+ * @returns {{isEnabled?: boolean}}
36
+ */
37
+ export function disabledWhenNoWidth(stream) {
38
+ return stream && stream.isTTY && !(stream.columns > 0) ? { isEnabled: false } : {}; // wire:spinner-off-without-width
29
39
  }
30
40
 
31
41
  export default createSpinner;
@@ -4,7 +4,7 @@ import * as yaml from 'js-yaml';
4
4
  import { exec } from 'child_process';
5
5
  import util from 'util';
6
6
  import { pathToFileURL } from 'node:url';
7
- import { readManifest } from './copier.js';
7
+ import { readManifest, getRepoRoot } from './copier.js';
8
8
  import { judgeCommitMessage } from './commit-message-judge.js';
9
9
 
10
10
  const execAsync = util.promisify(exec);
@@ -461,9 +461,10 @@ export class StandardValidator {
461
461
  const judgeName = simulator.judge
462
462
  || (standardConfig?.standard?.id === 'commit-message' && /commitlint/.test(simulator.command || '') ? 'commit-message' : null);
463
463
  if (judgeName === 'commit-message') {
464
- const outcome = judgeCommitMessage(standardConfig, input, { standardsDir: this.standardsDir });
464
+ const outcome = judgeCommitMessage(standardConfig, input, { standardsDir: this.standardsDir, shippedRoot: getRepoRoot() }); // wire:simulate-shipped-root
465
465
  const details = [
466
466
  ...outcome.findings.map(f => `- ${f}`),
467
+ ...outcome.notes.map(n => `Note: ${n}`),
467
468
  `Checked: ${outcome.checked.join('; ')}`,
468
469
  `Not checked: ${outcome.notChecked.join('; ')}`
469
470
  ].join('\n');
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "$schema": "https://json-schema.org/draft/2020-12/schema",
3
- "version": "6.14.0-beta.9",
3
+ "version": "6.14.0",
4
4
  "lastUpdated": "2026-05-13",
5
5
  "description": "Standards registry for universal-dev-standards with integrated skills and AI-optimized formats",
6
6
  "formats": {
@@ -58,14 +58,14 @@
58
58
  "standards": {
59
59
  "name": "universal-dev-standards",
60
60
  "url": "https://github.com/AsiaOstrich/universal-dev-standards",
61
- "version": "6.14.0-beta.9"
61
+ "version": "6.14.0"
62
62
  },
63
63
  "skills": {
64
64
  "name": "universal-dev-standards",
65
65
  "url": "https://github.com/AsiaOstrich/universal-dev-standards",
66
66
  "localPath": "skills",
67
67
  "rawUrl": "https://raw.githubusercontent.com/AsiaOstrich/universal-dev-standards/main/skills",
68
- "version": "6.14.0-beta.9",
68
+ "version": "6.14.0",
69
69
  "note": "Skills are now included in the main repository under skills/"
70
70
  }
71
71
  },
@@ -774,6 +774,7 @@
774
774
  "ai": "ai/standards/turn-completion-integrity.ai.yaml"
775
775
  },
776
776
  "category": "core",
777
+ "recommended": true,
777
778
  "description": "An agent must not end a turn having stated a next action it did not take; enforced at turn end by a Stop hook, with a per-language corpus that runs in CI"
778
779
  },
779
780
  {
@@ -2295,6 +2296,7 @@
2295
2296
  "ai": "ai/standards/pipeline-security-gates.ai.yaml"
2296
2297
  },
2297
2298
  "category": "core",
2299
+ "recommended": true,
2298
2300
  "description": "Security checkpoints embedded in CI pipeline — SAST, DAST, SCA, secrets scan (including the scanner's own output and failure behaviour) with block/warn/log behavior"
2299
2301
  },
2300
2302
  {
@@ -2334,7 +2336,7 @@
2334
2336
  "id": "license-compliance",
2335
2337
  "name": "License Compliance Standards",
2336
2338
  "nameZh": "授權合規標準",
2337
- "version": "6.14.0-beta.9",
2339
+ "version": "6.14.0",
2338
2340
  "source": {
2339
2341
  "human": "core/license-compliance.md",
2340
2342
  "ai": "ai/standards/license-compliance.ai.yaml"
@@ -2346,7 +2348,7 @@
2346
2348
  "id": "verification-oracle",
2347
2349
  "name": "Verification Oracle Standards",
2348
2350
  "nameZh": "驗證 Oracle 標準",
2349
- "version": "6.14.0-beta.9",
2351
+ "version": "6.14.0",
2350
2352
  "source": {
2351
2353
  "human": "core/verification-oracle.md",
2352
2354
  "ai": "ai/standards/verification-oracle.ai.yaml"
@@ -2358,7 +2360,7 @@
2358
2360
  "id": "model-provenance",
2359
2361
  "name": "Model Provenance Policy Standards",
2360
2362
  "nameZh": "模型來源政策標準",
2361
- "version": "6.14.0-beta.9",
2363
+ "version": "6.14.0",
2362
2364
  "source": {
2363
2365
  "human": "core/model-provenance.md",
2364
2366
  "ai": "ai/standards/model-provenance.ai.yaml"
@@ -2370,7 +2372,7 @@
2370
2372
  "id": "resource-cost-boundary",
2371
2373
  "name": "Resource / Cost Boundary Declaration Standards",
2372
2374
  "nameZh": "資源/成本邊界宣告標準",
2373
- "version": "6.14.0-beta.9",
2375
+ "version": "6.14.0",
2374
2376
  "source": {
2375
2377
  "human": "core/resource-cost-boundary.md",
2376
2378
  "ai": "ai/standards/resource-cost-boundary.ai.yaml"
@@ -2464,7 +2466,7 @@
2464
2466
  "ai": "ai/standards/secret-management-standards.ai.yaml"
2465
2467
  },
2466
2468
  "category": "core",
2467
- "description": "Three secret source tiers (Vault, Cloud KMS, SOPS), rotation policies by credential type, hardcoded secret prevention, and safe injection patterns"
2469
+ "description": "Three secret source tiers (Vault, Cloud KMS, SOPS), rotation policies by credential type, hardcoded secret prevention (scanner rules PSG-1 to PSG-3 of pipeline-security-gates), and safe injection patterns"
2468
2470
  },
2469
2471
  {
2470
2472
  "id": "prd-standards",