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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (693) hide show
  1. package/README.md +13 -3
  2. package/bin/uds.js +75 -3
  3. package/bundled/ai/options/code-review/pr-review.ai.yaml +20 -1
  4. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  5. package/bundled/ai/standards/ai-response-navigation.ai.yaml +43 -3
  6. package/bundled/ai/standards/checkin-standards.ai.yaml +25 -6
  7. package/bundled/ai/standards/code-review.ai.yaml +15 -2
  8. package/bundled/ai/standards/commit-message.ai.yaml +18 -4
  9. package/bundled/ai/standards/developer-memory.ai.yaml +12 -2
  10. package/bundled/ai/standards/full-coverage-testing.ai.yaml +86 -7
  11. package/bundled/ai/standards/open-work-tracking.ai.yaml +254 -4
  12. package/bundled/ai/standards/pipeline-security-gates.ai.yaml +53 -4
  13. package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
  14. package/bundled/ai/standards/turn-completion-integrity.ai.yaml +14 -7
  15. package/bundled/core/ai-response-navigation.md +128 -12
  16. package/bundled/core/code-review-checklist.md +20 -2
  17. package/bundled/core/commit-message-guide.md +22 -19
  18. package/bundled/core/developer-memory.md +12 -2
  19. package/bundled/core/full-coverage-testing.md +99 -5
  20. package/bundled/core/open-work-tracking.md +251 -8
  21. package/bundled/core/pipeline-security-gates.md +63 -0
  22. package/bundled/core/project-context-memory.md +10 -2
  23. package/bundled/core/turn-completion-integrity.md +58 -11
  24. package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
  25. package/bundled/extensions/languages/csharp-style.md +464 -0
  26. package/bundled/extensions/languages/php-style.md +700 -0
  27. package/bundled/extensions/locales/zh-cn.md +717 -0
  28. package/bundled/extensions/locales/zh-tw.md +717 -0
  29. package/bundled/hooks/check-turn-completion-agy.mjs +147 -0
  30. package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
  31. package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
  32. package/bundled/locales/COVERAGE.md +5 -4
  33. package/bundled/locales/zh-CN/CHANGELOG.md +211 -3
  34. package/bundled/locales/zh-CN/README.md +3 -3
  35. package/bundled/locales/zh-CN/SECURITY.md +3 -1
  36. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  37. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
  38. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  39. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
  40. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
  41. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
  42. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
  43. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  44. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  45. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  46. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  47. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  48. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  49. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  50. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  51. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  52. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  53. package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
  54. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  55. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  56. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  57. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  58. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  59. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  60. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  61. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  62. package/bundled/locales/zh-CN/core/code-review-checklist.md +54 -23
  63. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  64. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  65. package/bundled/locales/zh-CN/core/developer-memory.md +159 -60
  66. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  67. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  68. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  69. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  70. package/bundled/locales/zh-CN/core/full-coverage-testing.md +103 -9
  71. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  72. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  73. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  74. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  75. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  76. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  77. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  78. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  79. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  80. package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
  81. package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
  82. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  83. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  84. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  85. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  86. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  87. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  88. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  89. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  90. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  91. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  92. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  93. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  94. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  95. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  96. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  97. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  98. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  99. package/bundled/locales/zh-CN/core/turn-completion-integrity.md +46 -13
  100. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  101. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  102. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  103. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  104. package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
  105. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +11 -2
  106. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  107. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +76 -40
  108. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +32 -15
  109. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  110. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
  111. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  112. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
  113. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  114. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  115. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +46 -0
  116. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  117. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  118. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  119. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  120. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  121. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  122. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  123. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  124. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  125. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  126. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  127. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  128. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  129. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  130. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  131. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  132. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  133. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  134. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  135. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  136. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  137. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  138. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  139. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  140. package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
  141. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  142. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  143. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  144. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  145. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  146. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  147. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  148. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  149. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  150. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  151. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  152. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  153. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  154. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  155. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  156. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  157. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  158. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  159. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  160. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  161. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  162. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  163. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  164. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  165. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  166. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  167. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  168. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  169. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  170. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  171. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  172. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  173. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  174. package/bundled/locales/zh-CN/skills/README.md +3 -1
  175. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  176. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  177. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  178. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  179. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  180. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  181. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  182. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  183. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  184. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  185. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  186. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  187. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  188. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  189. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  190. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  191. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  192. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  193. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  194. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  195. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  196. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  197. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  198. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  199. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  200. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  201. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  202. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  203. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  204. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  205. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  206. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  207. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  208. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  209. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  210. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  211. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  212. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  213. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  214. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  215. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  216. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  217. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  218. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  219. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  220. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  221. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  222. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  223. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  224. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  225. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  226. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  227. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  228. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  229. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  230. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  231. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  232. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  233. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  234. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  235. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  236. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  237. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  238. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  239. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  240. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  241. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  242. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  243. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  244. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  245. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  246. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  247. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  248. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  249. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -2
  250. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  251. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  252. package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
  253. package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
  254. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  255. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  256. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  257. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  258. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  259. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  260. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  261. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  262. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  263. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  264. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  265. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  266. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  267. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  268. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  269. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  270. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  271. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  272. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  273. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  274. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  275. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  276. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  277. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  278. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  279. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  280. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  281. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  282. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  283. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  284. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  285. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  286. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  287. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  288. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  289. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  290. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  291. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  292. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  293. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  294. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  295. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  296. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  297. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  298. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  299. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  300. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  301. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  302. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  303. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  304. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  305. package/bundled/locales/zh-TW/CHANGELOG.md +211 -3
  306. package/bundled/locales/zh-TW/README.md +3 -3
  307. package/bundled/locales/zh-TW/SECURITY.md +3 -1
  308. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  309. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
  310. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  311. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
  312. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
  313. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
  314. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
  315. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  316. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  317. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  318. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  319. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  320. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  321. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  322. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  323. package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
  324. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  325. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  326. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  327. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  328. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  329. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  330. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  331. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  332. package/bundled/locales/zh-TW/core/code-review-checklist.md +36 -7
  333. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  334. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  335. package/bundled/locales/zh-TW/core/developer-memory.md +111 -12
  336. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  337. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  338. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  339. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  340. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  341. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  342. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  343. package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
  344. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  345. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  346. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  347. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  348. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  349. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  350. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  351. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  352. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  353. package/bundled/locales/zh-TW/core/open-work-tracking.md +164 -9
  354. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  355. package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
  356. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  357. package/bundled/locales/zh-TW/core/project-context-memory.md +215 -31
  358. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  359. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  360. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  361. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  362. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  363. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  364. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  365. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  366. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  367. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  368. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  369. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  370. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  371. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  372. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  373. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  374. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  375. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  376. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  377. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  378. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  379. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  380. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  381. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  382. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  383. package/bundled/locales/zh-TW/core/turn-completion-integrity.md +46 -13
  384. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  385. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  386. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  387. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  388. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  389. package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
  390. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +11 -2
  391. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  392. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +69 -33
  393. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  394. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +32 -15
  395. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  396. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
  397. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  398. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
  399. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  400. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  401. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +46 -0
  402. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  403. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  404. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  405. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  406. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  407. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  408. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  409. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  410. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  411. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  412. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  413. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  414. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  415. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  416. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  417. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  418. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  419. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  420. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  421. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  422. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  423. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  424. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  425. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  426. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  427. package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
  428. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  429. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  430. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  431. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  432. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  433. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  434. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  435. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  436. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  437. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  438. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  439. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  440. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  441. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  442. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  443. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  444. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  445. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  446. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  447. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  448. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  449. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  450. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  451. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  452. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  453. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  454. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  455. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  456. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  457. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  458. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  459. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  460. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  461. package/bundled/locales/zh-TW/skills/README.md +3 -1
  462. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  463. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  464. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  465. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  466. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  467. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  468. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  469. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  470. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  471. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  472. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  473. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  474. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  475. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  476. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  477. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  478. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  479. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  480. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  481. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  482. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  483. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  484. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  485. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  486. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  487. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  488. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  489. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  490. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  491. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  492. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  493. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  494. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  495. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  496. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  497. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  498. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  499. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  500. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  501. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  502. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  503. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  504. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  505. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  506. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  507. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  508. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  509. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  510. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  511. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  512. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  513. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  514. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  515. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  516. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  517. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  518. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  519. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  520. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  521. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  522. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  523. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  524. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  525. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  526. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  527. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  528. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  529. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  530. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  531. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  532. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  533. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  534. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  535. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  536. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  537. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  538. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  539. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  540. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  541. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  542. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  543. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  544. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  545. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  546. package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
  547. package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
  548. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  549. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  550. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  551. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  552. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  553. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  554. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  555. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  556. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  557. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  558. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  559. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  560. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  561. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  562. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  563. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  564. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  565. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  566. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  567. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  568. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  569. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  570. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  571. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  572. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  573. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  574. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  575. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  576. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  577. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  578. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  579. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  580. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  581. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  582. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  583. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  584. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  585. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  586. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  587. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  588. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  589. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  590. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  591. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  592. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  593. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  594. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  595. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  596. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  597. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  598. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  599. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  600. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  601. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  602. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  603. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  604. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  605. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  606. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  607. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  608. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  609. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  610. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  611. package/bundled/skills/README.md +1 -0
  612. package/bundled/skills/SKILL_NAMING.md +9 -0
  613. package/bundled/skills/commit-standards/SKILL.md +2 -2
  614. package/bundled/skills/commit-standards/guide.md +3 -2
  615. package/bundled/skills/commit-standards/language-options.md +19 -17
  616. package/bundled/skills/comprehension-ladder/SKILL.md +283 -0
  617. package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
  618. package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
  619. package/bundled/templates/gates/check-stubs.mjs +644 -0
  620. package/package.json +5 -3
  621. package/src/commands/audit.js +20 -2
  622. package/src/commands/check.js +155 -28
  623. package/src/commands/deps.js +31 -1
  624. package/src/commands/hitl.js +3 -0
  625. package/src/commands/init.js +173 -49
  626. package/src/commands/list.js +12 -3
  627. package/src/commands/mcp.js +2 -3
  628. package/src/commands/open-work.js +123 -0
  629. package/src/commands/quickstart.js +29 -13
  630. package/src/commands/release.js +102 -19
  631. package/src/commands/run-intent.js +10 -0
  632. package/src/commands/simulate.js +20 -8
  633. package/src/commands/skills.js +59 -33
  634. package/src/commands/spec-split.js +30 -17
  635. package/src/commands/spec.js +55 -21
  636. package/src/commands/uninstall.js +146 -32
  637. package/src/commands/update.js +471 -93
  638. package/src/core/install-records.js +192 -0
  639. package/src/core/manifest.js +12 -10
  640. package/src/core/marketplace-sentinel.js +5 -0
  641. package/src/core/open-work-config.js +122 -0
  642. package/src/core/project-config.js +92 -38
  643. package/src/flows/init-flow.js +10 -0
  644. package/src/hitl/manager.js +4 -2
  645. package/src/i18n/messages.js +413 -78
  646. package/src/installers/hooks-installer.js +320 -24
  647. package/src/installers/integration-installer.js +5 -1
  648. package/src/installers/skills-installer.js +3 -1
  649. package/src/installers/standards-installer.js +16 -23
  650. package/src/mcp/__tests__/server.test.js +0 -1
  651. package/src/mcp/server.js +16 -4
  652. package/src/prompts/init.js +148 -13
  653. package/src/reconciler/backup-locations.js +80 -0
  654. package/src/reconciler/backup-manager.js +451 -123
  655. package/src/reconciler/index.js +86 -10
  656. package/src/reconciler/install-roots.js +90 -0
  657. package/src/reconciler/plan-executor.js +37 -15
  658. package/src/uninstallers/hook-uninstaller.js +323 -33
  659. package/src/uninstallers/integration-uninstaller.js +35 -5
  660. package/src/uninstallers/skills-uninstaller.js +95 -16
  661. package/src/uninstallers/standards-uninstaller.js +56 -7
  662. package/src/utils/agents-installer.js +10 -17
  663. package/src/utils/available-standards-report.js +144 -0
  664. package/src/utils/available-standards.js +216 -0
  665. package/src/utils/command-hash-ownership.js +103 -0
  666. package/src/utils/commit-message-judge.js +155 -0
  667. package/src/utils/copier.js +80 -2
  668. package/src/utils/deps-applicability.js +25 -0
  669. package/src/utils/detector.js +46 -1
  670. package/src/utils/friction-detector.js +27 -0
  671. package/src/utils/gate-scripts.js +141 -0
  672. package/src/utils/git-hooks.js +139 -7
  673. package/src/utils/hasher.js +36 -0
  674. package/src/utils/health-scorer.js +10 -7
  675. package/src/utils/installed-names-ownership.js +114 -0
  676. package/src/utils/integration-generator.js +36 -24
  677. package/src/utils/legacy-hook-migration.js +112 -0
  678. package/src/utils/locale.js +19 -0
  679. package/src/utils/open-work-tracking.mjs +1754 -0
  680. package/src/utils/prompt-closed.js +18 -0
  681. package/src/utils/sdd-header.js +66 -0
  682. package/src/utils/skill-frontmatter.js +102 -0
  683. package/src/utils/skill-hash-ownership.js +64 -0
  684. package/src/utils/skill-name-collision.js +169 -0
  685. package/src/utils/skills-install-paths.js +114 -0
  686. package/src/utils/skills-installer.js +75 -106
  687. package/src/utils/standard-validator.js +98 -27
  688. package/src/utils/test-change-check.js +160 -0
  689. package/src/utils/test-policy.js +214 -0
  690. package/src/utils/transient-fs.js +113 -0
  691. package/src/utils/update-summary.js +29 -0
  692. package/src/vibe/micro-spec.js +15 -0
  693. package/standards-registry.json +48 -9
@@ -7,16 +7,25 @@
7
7
  * deploy — Record deployment to environment (manual/hybrid mode)
8
8
  * manifest — Generate build-manifest.json (manual/hybrid mode)
9
9
  * verify — Verify manifest against git state (manual/hybrid mode)
10
+ *
11
+ * Exit codes of `verify` (a script that gates a release on it must never read a failure as a pass):
12
+ * 0 the manifest verified
13
+ * 1 verification FAILED (commit or checksum does not match what the manifest records)
14
+ * 2 could not verify (no manifest, unreadable manifest, artifact not found, or the mode has no verify)
15
+ * 1 = "the answer is no", 2 = "no answer", the same split as `uds hitl check`.
10
16
  */
11
17
 
18
+ const EXIT_VERIFY_FAILED = 1;
19
+ const EXIT_CANNOT_VERIFY = 2;
20
+
12
21
  import chalk from 'chalk';
13
22
  import * as yaml from 'js-yaml';
14
23
  import { existsSync, readFileSync, writeFileSync } from 'fs';
15
24
  import { join } from 'path';
16
25
  import { execSync } from 'child_process';
17
26
  import { createHash } from 'crypto';
18
- import { resolveReleaseWorkflow } from '../utils/release-config.js';
19
- import { formatGitTag, createPromotionRecord, parseRCVersion, isStableVersion } from '../utils/version-promote.js';
27
+ import { resolveReleaseWorkflow, VALID_MODES } from '../utils/release-config.js';
28
+ import { formatGitTag, parseRCVersion, isStableVersion } from '../utils/version-promote.js';
20
29
 
21
30
  // Default deployment environments (overridable via release-config.yaml release.environments)
22
31
  const DEFAULT_ENVIRONMENTS = ['development', 'staging', 'canary', 'preview', 'production'];
@@ -39,6 +48,69 @@ function loadReleaseConfig(projectPath) {
39
48
  }
40
49
  }
41
50
 
51
+ /**
52
+ * The release mode the project's UDS manifest records (`.standards/manifest.json`, `options.release_mode`), or null when
53
+ * there is no readable manifest or it records none. A plain read: no migration, no output, nothing written.
54
+ */
55
+ function manifestReleaseMode(projectPath) {
56
+ try {
57
+ const manifest = JSON.parse(readFileSync(join(projectPath, '.standards', 'manifest.json'), 'utf-8'));
58
+ const mode = manifest?.options?.release_mode;
59
+ return VALID_MODES.includes(mode) ? mode : null;
60
+ } catch {
61
+ return null;
62
+ }
63
+ }
64
+
65
+ /**
66
+ * Which release mode applies, and where that came from (XSPEC-475 R4).
67
+ *
68
+ * 1. `.standards/release-config.yaml` `release.mode` - the detailed file, wins when it names a mode;
69
+ * 2. the manifest's `options.release_mode` - what `uds init` / `uds config` recorded; used when the file is
70
+ * missing (or names no mode), so a project that recorded `manual` is not run as ci-cd;
71
+ * 3. ci-cd.
72
+ *
73
+ * Before this, only (1) was read: a manifest that said `manual` with no release-config.yaml ran as ci-cd and the
74
+ * refusal never said why. `reason` always says which of the three decided and what was missing.
75
+ * @returns {{ config: Object|null, source: 'config'|'manifest'|'default', reason: string }}
76
+ */
77
+ function resolveReleaseMode(projectPath, releaseConfig) {
78
+ const fileMode = releaseConfig?.release?.mode;
79
+ if (fileMode) {
80
+ return { config: releaseConfig, source: 'config', reason: `模式 ${fileMode} 來自 .standards/release-config.yaml。` };
81
+ }
82
+ const fileMissing = releaseConfig === null
83
+ ? '找不到 .standards/release-config.yaml(或它無法解析)'
84
+ : '.standards/release-config.yaml 沒有指定 release.mode';
85
+ const recorded = manifestReleaseMode(projectPath); // wire:release-mode-from-manifest
86
+ if (recorded) {
87
+ return {
88
+ config: { ...(releaseConfig ?? {}), release: { ...(releaseConfig?.release ?? {}), mode: recorded } },
89
+ source: 'manifest',
90
+ reason: `${fileMissing};模式 ${recorded} 取自 .standards/manifest.json 的 options.release_mode。`
91
+ };
92
+ }
93
+ return {
94
+ config: releaseConfig,
95
+ source: 'default',
96
+ reason: `${fileMissing},.standards/manifest.json 也沒有記錄 options.release_mode,所以使用預設的 ci-cd。`
97
+ };
98
+ }
99
+
100
+ /**
101
+ * The deployment environment names a release-config.yaml declares, or null when it declares none.
102
+ * An entry is a name (`- staging`) or the object `uds config` writes (`- name: staging`, with `type` and so on).
103
+ * The object form used to be compared as if it were a name, so a project set up by UDS itself could not deploy anywhere.
104
+ */
105
+ function configuredEnvironmentNames(releaseConfig) {
106
+ const declared = releaseConfig?.release?.environments;
107
+ if (!Array.isArray(declared)) return null;
108
+ const names = declared
109
+ .map((entry) => (entry && typeof entry === 'object' ? entry.name : entry))
110
+ .filter((name) => typeof name === 'string' && name.trim() !== '');
111
+ return names.length > 0 ? names : null;
112
+ }
113
+
42
114
  /**
43
115
  * Load deployments.yaml
44
116
  */
@@ -118,7 +190,13 @@ function getPackageVersion(projectPath) {
118
190
  export async function releaseCommand(subcommand, args, options) {
119
191
  const projectPath = process.cwd();
120
192
  const releaseConfig = loadReleaseConfig(projectPath);
121
- const workflow = resolveReleaseWorkflow(releaseConfig);
193
+ const resolved = resolveReleaseMode(projectPath, releaseConfig);
194
+ const workflow = resolveReleaseWorkflow(resolved.config);
195
+ // When the mode did not come from release-config.yaml, say where it came from - once, and in every refusal below.
196
+ if (resolved.source === 'manifest' && workflow.hasManifest) console.log(chalk.gray(` ${resolved.reason}`));
197
+ const explainMode = () => {
198
+ if (resolved.source !== 'config') console.log(chalk.gray(` ${resolved.reason}`));
199
+ };
122
200
 
123
201
  switch (subcommand) {
124
202
  case 'promote':
@@ -126,6 +204,7 @@ export async function releaseCommand(subcommand, args, options) {
126
204
  console.log(chalk.red('promote 子命令僅在 manual 或 hybrid 模式下可用。'));
127
205
  console.log(chalk.gray(' 目前模式: ' + workflow.type));
128
206
  console.log(chalk.gray(' 使用 `uds config --type release_mode` 切換模式'));
207
+ explainMode();
129
208
  return;
130
209
  }
131
210
  await handlePromote(args, projectPath);
@@ -135,6 +214,7 @@ export async function releaseCommand(subcommand, args, options) {
135
214
  if (!workflow.hasDeploy) {
136
215
  console.log(chalk.red('deploy 子命令僅在 manual 或 hybrid 模式下可用。'));
137
216
  console.log(chalk.gray(' 目前模式: ' + workflow.type));
217
+ explainMode();
138
218
  return;
139
219
  }
140
220
  await handleDeploy(args, options, projectPath);
@@ -143,6 +223,7 @@ export async function releaseCommand(subcommand, args, options) {
143
223
  case 'manifest':
144
224
  if (!workflow.hasManifest) {
145
225
  console.log(chalk.red('manifest 子命令僅在 manual 或 hybrid 模式下可用。'));
226
+ explainMode();
146
227
  return;
147
228
  }
148
229
  await handleManifest(args, options, projectPath);
@@ -151,9 +232,14 @@ export async function releaseCommand(subcommand, args, options) {
151
232
  case 'verify':
152
233
  if (!workflow.hasManifest) {
153
234
  console.log(chalk.red('verify 子命令僅在 manual 或 hybrid 模式下可用。'));
235
+ explainMode();
236
+ process.exitCode = EXIT_CANNOT_VERIFY; // nothing was verified; 0 would read as "verified"
154
237
  return;
155
238
  }
156
- await handleVerify(projectPath, options);
239
+ {
240
+ const verifyExit = await handleVerify(projectPath, options);
241
+ if (verifyExit !== 0) process.exitCode = verifyExit; // wire:release-verify-exit
242
+ }
157
243
  break;
158
244
 
159
245
  default:
@@ -203,16 +289,12 @@ async function handlePromote(targetVersion, projectPath) {
203
289
  console.log(chalk.gray(` 晉升目標: ${targetVersion}`));
204
290
  }
205
291
 
206
- // Create promotion record
207
- const record = createPromotionRecord(currentVersion || 'unknown', targetVersion);
208
- console.log();
209
- console.log(chalk.green(` ✓ 晉升紀錄建立: ${record.promoted_from} → ${record.version}`));
210
-
211
- // Create git tag
292
+ // This command only prints. It writes no promotion record and creates no git tag, so it must not say it did.
212
293
  const tag = formatGitTag(targetVersion);
213
- console.log(chalk.green(` ✓ Git tag: ${tag}`));
214
294
  console.log();
215
- console.log(chalk.cyan('後續步驟:'));
295
+ console.log(chalk.yellow('這個指令不會建立晉升紀錄,也不會建立 Git tag;它只列出下一步要執行的事。'));
296
+ console.log();
297
+ console.log(chalk.cyan('下一步(由你執行):'));
216
298
  console.log(chalk.gray(` 1. 更新版本檔案為 ${targetVersion}`));
217
299
  console.log(chalk.gray(` 2. git tag ${tag}`));
218
300
  console.log(chalk.gray(' 3. 從此 commit 重新打包'));
@@ -234,10 +316,7 @@ async function handleDeploy(environment, options, projectPath) {
234
316
 
235
317
  // Validate environment against allow-list (overridable via release-config.yaml)
236
318
  const deployConfig = loadReleaseConfig(projectPath);
237
- const allowedEnvironments =
238
- Array.isArray(deployConfig?.release?.environments) && deployConfig.release.environments.length > 0
239
- ? deployConfig.release.environments
240
- : DEFAULT_ENVIRONMENTS;
319
+ const allowedEnvironments = configuredEnvironmentNames(deployConfig) || DEFAULT_ENVIRONMENTS;
241
320
  if (!allowedEnvironments.includes(environment)) {
242
321
  console.log(chalk.red(`未知的部署環境: ${environment}`));
243
322
  console.log(chalk.gray(` 允許的環境: ${allowedEnvironments.join(', ')}`));
@@ -335,6 +414,8 @@ async function handleManifest(versionArg, options, projectPath) {
335
414
  *
336
415
  * T13 (XSPEC-292): when --artifact is given, compute its SHA256 so verify
337
416
  * actually CONSUMES the checksum recorded in the manifest, not just stores it.
417
+ *
418
+ * @returns {Promise<number>} the exit code: 0 verified, EXIT_VERIFY_FAILED, or EXIT_CANNOT_VERIFY
338
419
  */
339
420
  async function handleVerify(projectPath, options = {}) {
340
421
  const manifestPath = join(projectPath, 'build-manifest.json');
@@ -342,7 +423,7 @@ async function handleVerify(projectPath, options = {}) {
342
423
  if (!existsSync(manifestPath)) {
343
424
  console.log(chalk.red('找不到 build-manifest.json'));
344
425
  console.log(chalk.gray(' 請先執行 uds release manifest'));
345
- return;
426
+ return EXIT_CANNOT_VERIFY;
346
427
  }
347
428
 
348
429
  let manifest;
@@ -350,7 +431,7 @@ async function handleVerify(projectPath, options = {}) {
350
431
  manifest = JSON.parse(readFileSync(manifestPath, 'utf-8'));
351
432
  } catch {
352
433
  console.log(chalk.red('build-manifest.json 格式不正確'));
353
- return;
434
+ return EXIT_CANNOT_VERIFY;
354
435
  }
355
436
  const currentCommit = getGitCommit();
356
437
 
@@ -360,7 +441,7 @@ async function handleVerify(projectPath, options = {}) {
360
441
  if (artifactPath) {
361
442
  if (!existsSync(artifactPath)) {
362
443
  console.log(chalk.red(`找不到 artifact:${artifactPath}`));
363
- return;
444
+ return EXIT_CANNOT_VERIFY;
364
445
  }
365
446
  actualChecksum = createHash('sha256').update(readFileSync(artifactPath)).digest('hex');
366
447
  }
@@ -396,6 +477,8 @@ async function handleVerify(projectPath, options = {}) {
396
477
  } else {
397
478
  console.log(chalk.yellow(' Staging: 未通過或無紀錄'));
398
479
  }
480
+
481
+ return result.valid ? 0 : EXIT_VERIFY_FAILED;
399
482
  }
400
483
 
401
484
  /**
@@ -6,6 +6,7 @@
6
6
  import chalk from 'chalk';
7
7
  import { execSync } from 'child_process';
8
8
  import { resolveCommand } from '../core/command-router.js';
9
+ import { droppedYamlComment } from '../core/project-config.js';
9
10
 
10
11
  const KNOWN_INTENTS = ['test', 'lint', 'build', 'security'];
11
12
 
@@ -62,6 +63,15 @@ export async function runIntentCommand(intent, options = {}) {
62
63
  console.log(chalk.gray(`$ ${resolved.command}`));
63
64
  console.log();
64
65
 
66
+ // XSPEC-475 R5(c): YAML ends an unquoted value at a space followed by `#`. Say so before running, in a dry run and a
67
+ // real run alike, so a command cut short is seen instead of discovered from its error.
68
+ const dropped = resolved.source === 'uds.project.yaml' ? droppedYamlComment(projectPath, intent, resolved.command) : null; // wire:run-dropped-comment
69
+ if (dropped) {
70
+ console.log(chalk.yellow(`⚠ uds.project.yaml 的 ${intent} 指令中,空白加 # 之後的文字被 YAML 當成註解丟掉了:${dropped}`));
71
+ console.log(chalk.yellow(' 如果那一段是指令的一部分,請把整個值用引號包起來(例如 \'...\' 或 "...");如果只是註解,可以忽略這則警告。'));
72
+ console.log();
73
+ }
74
+
65
75
  if (options.dryRun) {
66
76
  console.log(chalk.yellow('(dry-run mode — 未實際執行)'));
67
77
  return;
@@ -1,6 +1,9 @@
1
1
  import chalk from 'chalk';
2
2
  import { StandardValidator } from '../utils/standard-validator.js';
3
3
 
4
+ /** Process exit code per outcome. 2 means no verdict - it is not a pass. */
5
+ export const EXIT_CODES = { pass: 0, fail: 1, 'cannot-simulate': 2 };
6
+
4
7
  export async function simulateCommand(options) {
5
8
  if (!options.standard) {
6
9
  if (options.json) {
@@ -25,10 +28,13 @@ export async function simulateCommand(options) {
25
28
 
26
29
  try {
27
30
  const result = await validator.simulate(options.standard, options.input);
31
+ // XSPEC-456 R2: exit 0 only for a pass. 1 = the input does not comply, 2 = no verdict could be reached
32
+ // (the same "cannot decide is not a pass" contract as `uds open-work`).
33
+ const exitCode = EXIT_CODES[result.status] ?? EXIT_CODES['cannot-simulate'];
28
34
 
29
35
  if (options.json) {
30
36
  console.log(JSON.stringify(result, null, 2));
31
- if (!result.success) process.exitCode = 1;
37
+ process.exitCode = exitCode;
32
38
  return;
33
39
  }
34
40
 
@@ -37,25 +43,31 @@ export async function simulateCommand(options) {
37
43
  console.log(chalk.gray('Input: ' + options.input));
38
44
  console.log(chalk.gray('─'.repeat(50)));
39
45
 
40
- if (result.success) {
46
+ if (result.status === 'pass') {
41
47
  console.log(chalk.green('✓ Simulation Passed'));
42
48
  if (result.details) console.log(chalk.gray(result.details));
49
+ } else if (result.status === 'fail') {
50
+ console.log(chalk.red('✗ Simulation Failed: the input does not comply'));
51
+ if (result.details) {
52
+ console.log(chalk.gray('\nDetails:'));
53
+ console.log(chalk.gray(result.details));
54
+ }
43
55
  } else {
44
- console.log(chalk.red('✗ Simulation Failed'));
45
- console.log(chalk.red(` ${result.message}`));
56
+ console.log(chalk.yellow('⚠ Cannot simulate: no verdict was reached, so this is neither a pass nor a fail'));
57
+ console.log(chalk.yellow(` ${result.message}`));
46
58
  if (result.details) {
47
59
  console.log(chalk.gray('\nDetails:'));
48
60
  console.log(chalk.gray(result.details));
49
61
  }
50
- process.exitCode = 1;
51
62
  }
63
+ process.exitCode = exitCode;
52
64
  } catch (error) {
53
65
  if (options.json) {
54
- console.log(JSON.stringify({ success: false, message: error.message }));
55
- process.exit(1);
66
+ console.log(JSON.stringify({ status: 'cannot-simulate', success: false, message: error.message }));
67
+ process.exit(EXIT_CODES['cannot-simulate']);
56
68
  }
57
69
  console.error(chalk.red(`Error: ${error.message}`));
58
- process.exit(1);
70
+ process.exit(EXIT_CODES['cannot-simulate']);
59
71
  }
60
72
  if (!options.json) console.log();
61
73
  }
@@ -3,8 +3,12 @@ import { existsSync, readdirSync, readFileSync } from 'fs';
3
3
  import { join } from 'path';
4
4
  import { homedir } from 'os';
5
5
  import { getAllSkillNames } from '../utils/registry.js';
6
+ import { getAvailableSkillNames } from '../utils/skills-installer.js';
7
+ import { pruneForeignSkillHashes } from '../utils/skill-hash-ownership.js';
8
+ import { getSkillsDirForAgent, getAgentDisplayName } from '../config/ai-agent-paths.js';
6
9
  import { readManifest, isInitialized } from '../utils/copier.js';
7
10
  import { t, setLanguage, isLanguageExplicitlySet } from '../i18n/messages.js';
11
+ import { printInstallPathComparison } from '../utils/skills-install-paths.js';
8
12
 
9
13
  // Known skill directories (non-skill items to exclude)
10
14
  const NON_SKILL_ITEMS = [
@@ -111,8 +115,18 @@ export function skillsCommand() {
111
115
  console.log(chalk.gray('─'.repeat(50)));
112
116
  console.log();
113
117
 
114
- // Get all known skills from registry
115
- const knownSkills = getAllSkillNames();
118
+ // XSPEC-456 R3: the skills UDS ships are the ones in its skills source tree (what `uds init` and
119
+ // `uds update` install, and what `uds check` verifies). This used to be the `skillFiles` list of
120
+ // standards-registry.json, a hand-kept list that stopped at 30 while UDS ships 56, so a project with
121
+ // all 56 installed read "27 / 30" (27 = the installed ones that happened to be on the stale list).
122
+ // The registry list is only a fallback for a source tree that did not load.
123
+ const shipped = getAvailableSkillNames();
124
+ const knownSkills = shipped.length > 0 ? shipped : getAllSkillNames();
125
+
126
+ // XSPEC-462 R1: one place that prints the two ways to install (an empty result and a full one both end with it).
127
+ const sayBothWays = () => {
128
+ printInstallPathComparison();
129
+ };
116
130
 
117
131
  // Check different installation locations
118
132
  const installations = [];
@@ -131,7 +145,7 @@ export function skillsCommand() {
131
145
  path: udsPlugin.installPath,
132
146
  version: udsPlugin.version || 'unknown',
133
147
  skills,
134
- recommended: !udsPlugin.isLegacyMarketplace,
148
+ isPlugin: true,
135
149
  legacyMarketplace: udsPlugin.isLegacyMarketplace
136
150
  });
137
151
  }
@@ -157,11 +171,10 @@ export function skillsCommand() {
157
171
  }
158
172
 
159
173
  installations.push({
160
- location: 'User Level (deprecated)',
174
+ location: 'User Level',
161
175
  path: userSkillsDir,
162
176
  version,
163
- skills: udsSkills,
164
- deprecated: true
177
+ skills: udsSkills
165
178
  });
166
179
  }
167
180
  }
@@ -186,35 +199,51 @@ export function skillsCommand() {
186
199
  }
187
200
 
188
201
  installations.push({
189
- location: 'Project Level (deprecated)',
202
+ location: 'Project Level',
190
203
  path: projectSkillsDir,
191
204
  version,
192
- skills: udsSkills,
193
- deprecated: true
205
+ skills: udsSkills
194
206
  });
195
207
  }
196
208
  }
197
209
 
210
+ // 4. Other AI tools the manifest says Skills were installed for (Codex, OpenCode, ...). Claude Code's
211
+ // own two locations were handled above.
212
+ const manifestForSkills = isInitialized(projectPath) ? readManifest(projectPath) : null;
213
+ const seenDirs = new Set(installations.map(i => i.path));
214
+ for (const entry of manifestForSkills?.skills?.installations || []) {
215
+ const agent = typeof entry === 'string' ? entry : entry?.agent;
216
+ const level = typeof entry === 'string' ? 'project' : (entry?.level || 'project');
217
+ if (!agent || agent === 'claude-code') continue;
218
+ const dir = getSkillsDirForAgent(agent, level, projectPath);
219
+ if (!dir || seenDirs.has(dir)) continue;
220
+ seenDirs.add(dir);
221
+ const udsSkills = listSkillsInDir(dir).filter(s => knownSkills.includes(s));
222
+ if (udsSkills.length === 0) continue;
223
+ installations.push({
224
+ location: `${getAgentDisplayName(agent)} (${level} level)`,
225
+ path: dir,
226
+ version: manifestForSkills.skills.version || 'unknown',
227
+ skills: udsSkills
228
+ });
229
+ }
230
+
198
231
  // Display results
199
232
  if (installations.length === 0) {
200
233
  console.log(chalk.yellow(msg.noSkillsInstalled));
201
234
  console.log();
202
- console.log(chalk.gray(msg.installViaMarketplace));
203
- console.log(chalk.cyan(' /plugin marketplace add AsiaOstrich/universal-dev-standards'));
204
- console.log(chalk.cyan(' /plugin install universal-dev-standards@asia-ostrich'));
205
- console.log();
235
+ // XSPEC-462 R1: say both ways and what each one can and cannot do, not only the plugin.
236
+ sayBothWays();
206
237
  return;
207
238
  }
208
239
 
209
240
  // Show each installation
210
241
  for (const install of installations) {
211
242
  // Header
212
- if (install.recommended) {
213
- console.log(chalk.green(`✓ ${install.location}`) + chalk.gray(` ${msg.recommended}`));
214
- } else if (install.legacyMarketplace) {
215
- console.log(chalk.yellow(`⚠ ${install.location}`));
216
- } else if (install.deprecated) {
243
+ if (install.legacyMarketplace) {
217
244
  console.log(chalk.yellow(`⚠ ${install.location}`));
245
+ } else if (install.isPlugin) {
246
+ console.log(chalk.green(`✓ ${install.location}`));
218
247
  } else {
219
248
  console.log(chalk.blue(`● ${install.location}`));
220
249
  }
@@ -226,7 +255,7 @@ export function skillsCommand() {
226
255
  // Skills list
227
256
  console.log(chalk.gray(` Skills (${install.skills.length}):`));
228
257
  for (const skill of install.skills) {
229
- const icon = (install.deprecated || install.legacyMarketplace)
258
+ const icon = install.legacyMarketplace
230
259
  ? chalk.yellow('○')
231
260
  : chalk.green('✓');
232
261
  console.log(` ${icon} ${skill}`);
@@ -241,31 +270,28 @@ export function skillsCommand() {
241
270
  console.log(chalk.cyan(' /plugin install universal-dev-standards@asia-ostrich'));
242
271
  console.log();
243
272
  }
244
-
245
- // Deprecation warning
246
- if (install.deprecated) {
247
- console.log(chalk.yellow(` ${msg.manualInstallDeprecated}`));
248
- console.log(chalk.gray(` ${msg.manualInstallHint}`));
249
- console.log(chalk.cyan(' /plugin marketplace add AsiaOstrich/universal-dev-standards'));
250
- console.log(chalk.cyan(' /plugin install universal-dev-standards@asia-ostrich'));
251
- console.log();
252
- }
253
273
  }
254
274
 
255
275
  // Summary
256
276
  const totalSkills = new Set(installations.flatMap(i => i.skills)).size;
257
- const hasMarketplace = installations.some(i => i.recommended);
258
277
 
259
278
  console.log(chalk.gray('─'.repeat(50)));
260
279
  console.log(chalk.gray(`${msg.totalUniqueSkills}: ${totalSkills} / ${knownSkills.length}`));
261
280
 
262
- if (!hasMarketplace && installations.length > 0) {
263
- console.log();
264
- console.log(chalk.yellow(msg.recommendation));
265
- console.log(chalk.gray(` ${msg.benefits}`));
281
+ // The number `uds check` prints is a count of FILES (a skill is one or more files), so say how the two
282
+ // relate instead of leaving two different numbers side by side. Counted the way `check` counts them.
283
+ if (manifestForSkills?.skillHashes) {
284
+ const tracked = structuredClone(manifestForSkills);
285
+ pruneForeignSkillHashes(tracked, new Set(knownSkills));
286
+ const files = Object.keys(tracked.skillHashes || {}).length;
287
+ if (files > 0 && msg.skillFilesTracked) {
288
+ console.log(chalk.gray(msg.skillFilesTracked.replace('{files}', files)));
289
+ }
266
290
  }
267
291
 
292
+ // XSPEC-462 R1: the two ways, side by side, with their limits.
268
293
  console.log();
294
+ sayBothWays();
269
295
  }
270
296
 
271
297
  // Export for testing
@@ -13,6 +13,7 @@ import { MicroSpec } from '../vibe/micro-spec.js';
13
13
  import { existsSync, readFileSync, writeFileSync, mkdirSync, copyFileSync } from 'node:fs';
14
14
  import { join } from 'node:path';
15
15
  import { withFileTransaction } from '../utils/transaction.js';
16
+ import { isPromptClosed } from '../utils/prompt-closed.js';
16
17
 
17
18
  /**
18
19
  * Extract acceptance criteria from spec markdown
@@ -86,25 +87,36 @@ export async function specSplitCommand(id, options = {}) {
86
87
  }
87
88
  console.log();
88
89
 
89
- // Interactive selection: which ACs to move to new spec
90
- const toMove = await checkbox({
91
- message: 'Select ACs to move to a NEW spec (remaining stay in original):',
92
- choices: acs.map(ac => ({
93
- name: `${ac.id}: ${ac.text.substring(ac.id.length + 1).trim().substring(0, 60)}`,
94
- value: ac.id,
95
- })),
96
- });
97
-
98
- if (toMove.length === 0 || toMove.length === acs.length) {
99
- console.log(chalk.yellow('Must select some (but not all) ACs to move. Aborting.'));
90
+ // Interactive selection: which ACs to move to new spec. Nothing can be written before both answers are in,
91
+ // so a prompt that cannot be answered (not a terminal) changes nothing and says so.
92
+ let toMove;
93
+ let proceed;
94
+ try {
95
+ toMove = await checkbox({
96
+ message: 'Select ACs to move to a NEW spec (remaining stay in original):',
97
+ choices: acs.map(ac => ({
98
+ name: `${ac.id}: ${ac.text.substring(ac.id.length + 1).trim().substring(0, 60)}`,
99
+ value: ac.id,
100
+ })),
101
+ });
102
+
103
+ if (toMove.length === 0 || toMove.length === acs.length) {
104
+ console.log(chalk.yellow('Must select some (but not all) ACs to move. Aborting.'));
105
+ return;
106
+ }
107
+
108
+ proceed = await inquirerConfirm({
109
+ message: `Split ${id}: keep ${acs.length - toMove.length} ACs, move ${toMove.length} ACs to new spec?`,
110
+ default: true,
111
+ });
112
+ } catch (promptError) {
113
+ if (!isPromptClosed(promptError)) throw promptError;
114
+ console.log(chalk.red('\nCannot ask which ACs to move: there is nothing attached to answer the prompt (non-interactive shell, CI, or a pipe).'));
115
+ console.log(chalk.gray(` Run \`uds spec split ${id}\` in a terminal. Nothing has been changed.`));
116
+ process.exitCode = 2;
100
117
  return;
101
118
  }
102
119
 
103
- const proceed = await inquirerConfirm({
104
- message: `Split ${id}: keep ${acs.length - toMove.length} ACs, move ${toMove.length} ACs to new spec?`,
105
- default: true,
106
- });
107
-
108
120
  if (!proceed) {
109
121
  console.log(chalk.gray('Split cancelled.'));
110
122
  return;
@@ -152,7 +164,8 @@ export async function specSplitCommand(id, options = {}) {
152
164
  const acSection = movedACLines.join('\n');
153
165
  const finalContent = newContent.replace(
154
166
  /\*\*Acceptance\*\*:[\s\S]*?(?=\n\*\*|$)/,
155
- `**Acceptance**:\n${acSection}`
167
+ // The lazy match stops before the blank line that ends the section, so give it back (or **Confirmed** sticks to the last AC).
168
+ `**Acceptance**:\n${acSection}\n`
156
169
  );
157
170
 
158
171
  // T11 (XSPEC-292 §9.2): the two writes must be atomic. If creating the new