universal-dev-standards 6.14.0-beta.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 (688) 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 +196 -11
  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/core/ai-response-navigation.md +128 -12
  15. package/bundled/core/code-review-checklist.md +20 -2
  16. package/bundled/core/commit-message-guide.md +22 -19
  17. package/bundled/core/developer-memory.md +12 -2
  18. package/bundled/core/full-coverage-testing.md +99 -5
  19. package/bundled/core/open-work-tracking.md +157 -17
  20. package/bundled/core/pipeline-security-gates.md +63 -0
  21. package/bundled/core/project-context-memory.md +10 -2
  22. package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
  23. package/bundled/extensions/languages/csharp-style.md +464 -0
  24. package/bundled/extensions/languages/php-style.md +700 -0
  25. package/bundled/extensions/locales/zh-cn.md +717 -0
  26. package/bundled/extensions/locales/zh-tw.md +717 -0
  27. package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
  28. package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
  29. package/bundled/locales/COVERAGE.md +5 -4
  30. package/bundled/locales/zh-CN/CHANGELOG.md +199 -3
  31. package/bundled/locales/zh-CN/README.md +3 -3
  32. package/bundled/locales/zh-CN/SECURITY.md +3 -2
  33. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  34. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
  35. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  36. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
  37. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
  38. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
  39. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
  40. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  41. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  42. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  43. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  44. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  45. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  46. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  47. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  48. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  49. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  50. package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
  51. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  52. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  53. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  54. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  55. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  56. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  57. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  58. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  59. package/bundled/locales/zh-CN/core/code-review-checklist.md +54 -23
  60. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  61. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  62. package/bundled/locales/zh-CN/core/developer-memory.md +159 -60
  63. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  64. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  65. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  66. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  67. package/bundled/locales/zh-CN/core/full-coverage-testing.md +103 -9
  68. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  69. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  70. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  71. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  72. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  73. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  74. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  75. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  76. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  77. package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
  78. package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
  79. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  80. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  81. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  82. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  83. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  84. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  85. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  86. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  87. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  88. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  89. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  90. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  91. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  92. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  93. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  94. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  95. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  96. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  97. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  98. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  99. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  100. package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
  101. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +9 -3
  102. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  103. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +68 -33
  104. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +29 -15
  105. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  106. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
  107. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  108. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
  109. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  110. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  111. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +46 -0
  112. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  113. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  114. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  115. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  116. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  117. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  118. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  119. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  120. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  121. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  122. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  123. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  124. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  125. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  126. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  127. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  128. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  129. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  130. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  131. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  132. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  133. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  134. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  135. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  136. package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
  137. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  138. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  139. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  140. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  141. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  142. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  143. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  144. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  145. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  146. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  147. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  148. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  149. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  150. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  151. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  152. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  153. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  154. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  155. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  156. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  157. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  158. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  159. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  160. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  161. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  162. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  163. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  164. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  165. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  166. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  167. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  168. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  169. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  170. package/bundled/locales/zh-CN/skills/README.md +3 -1
  171. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  172. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  173. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  174. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  175. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  176. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  177. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  178. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  179. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  180. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  181. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  182. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  183. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  184. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  185. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  186. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  187. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  188. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  189. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  190. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  191. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  192. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  193. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  194. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  195. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  196. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  197. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  198. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  199. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  200. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  201. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  202. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  203. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  204. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  205. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  206. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  207. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  208. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  209. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  210. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  211. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  212. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  213. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  214. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  215. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  216. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  217. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  218. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  219. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  220. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  221. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  222. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  223. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  224. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  225. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  226. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  227. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  228. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  229. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  230. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  231. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  232. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  233. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  234. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  235. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  236. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  237. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  238. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  239. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  240. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  241. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  242. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  243. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  244. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  245. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -2
  246. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  247. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  248. package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
  249. package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
  250. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  251. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  252. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  253. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  254. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  255. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  256. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  257. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  258. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  259. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  260. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  261. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  262. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  263. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  264. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  265. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  266. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  267. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  268. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  269. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  270. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  271. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  272. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  273. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  274. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  275. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  276. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  277. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  278. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  279. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  280. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  281. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  282. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  283. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  284. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  285. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  286. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  287. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  288. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  289. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  290. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  291. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  292. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  293. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  294. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  295. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  296. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  297. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  298. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  299. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  300. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  301. package/bundled/locales/zh-TW/CHANGELOG.md +199 -3
  302. package/bundled/locales/zh-TW/README.md +3 -3
  303. package/bundled/locales/zh-TW/SECURITY.md +3 -2
  304. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  305. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
  306. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  307. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
  308. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
  309. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
  310. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
  311. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  312. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  313. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  314. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  315. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  316. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  317. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  318. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  319. package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
  320. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  321. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  322. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  323. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  324. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  325. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  326. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  327. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  328. package/bundled/locales/zh-TW/core/code-review-checklist.md +36 -7
  329. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  330. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  331. package/bundled/locales/zh-TW/core/developer-memory.md +111 -12
  332. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  333. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  334. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  335. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  336. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  337. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  338. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  339. package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
  340. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  341. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  342. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  343. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  344. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  345. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  346. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  347. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  348. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  349. package/bundled/locales/zh-TW/core/open-work-tracking.md +92 -16
  350. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  351. package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
  352. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  353. package/bundled/locales/zh-TW/core/project-context-memory.md +215 -31
  354. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  355. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  356. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  357. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  358. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  359. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  360. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  361. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  362. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  363. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  364. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  365. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  366. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  367. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  368. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  369. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  370. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  371. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  372. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  373. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  374. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  375. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  376. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  377. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  378. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  379. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  380. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  381. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  382. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  383. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  384. package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
  385. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +9 -3
  386. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  387. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +61 -26
  388. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  389. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +29 -15
  390. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  391. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
  392. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  393. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
  394. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  395. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  396. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +46 -0
  397. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  398. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  399. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  400. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  401. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  402. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  403. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  404. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  405. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  406. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  407. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  408. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  409. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  410. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  411. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  412. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  413. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  414. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  415. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  416. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  417. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  418. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  419. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  420. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  421. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  422. package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
  423. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  424. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  425. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  426. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  427. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  428. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  429. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  430. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  431. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  432. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  433. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  434. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  435. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  436. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  437. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  438. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  439. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  440. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  441. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  442. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  443. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  444. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  445. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  446. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  447. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  448. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  449. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  450. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  451. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  452. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  453. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  454. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  455. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  456. package/bundled/locales/zh-TW/skills/README.md +3 -1
  457. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  458. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  459. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  460. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  461. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  462. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  463. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  464. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  465. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  466. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  467. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  468. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  469. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  470. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  471. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  472. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  473. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  474. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  475. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  476. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  477. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  478. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  479. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  480. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  481. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  482. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  483. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  484. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  485. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  486. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  487. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  488. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  489. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  490. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  491. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  492. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  493. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  494. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  495. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  496. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  497. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  498. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  499. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  500. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  501. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  502. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  503. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  504. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  505. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  506. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  507. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  508. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  509. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  510. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  511. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  512. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  513. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  514. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  515. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  516. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  517. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  518. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  519. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  520. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  521. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  522. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  523. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  524. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  525. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  526. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  527. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  528. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  529. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  530. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  531. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  532. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  533. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  534. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  535. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  536. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  537. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  538. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  539. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  540. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  541. package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
  542. package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
  543. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  544. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  545. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  546. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  547. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  548. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  549. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  550. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  551. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  552. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  553. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  554. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  555. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  556. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  557. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  558. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  559. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  560. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  561. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  562. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  563. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  564. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  565. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  566. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  567. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  568. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  569. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  570. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  571. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  572. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  573. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  574. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  575. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  576. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  577. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  578. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  579. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  580. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  581. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  582. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  583. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  584. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  585. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  586. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  587. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  588. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  589. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  590. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  591. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  592. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  593. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  594. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  595. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  596. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  597. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  598. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  599. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  600. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  601. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  602. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  603. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  604. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  605. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  606. package/bundled/skills/README.md +1 -0
  607. package/bundled/skills/SKILL_NAMING.md +9 -0
  608. package/bundled/skills/commit-standards/SKILL.md +2 -2
  609. package/bundled/skills/commit-standards/guide.md +3 -2
  610. package/bundled/skills/commit-standards/language-options.md +19 -17
  611. package/bundled/skills/comprehension-ladder/SKILL.md +283 -0
  612. package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
  613. package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
  614. package/bundled/templates/gates/check-stubs.mjs +644 -0
  615. package/package.json +5 -3
  616. package/src/commands/audit.js +20 -2
  617. package/src/commands/check.js +155 -28
  618. package/src/commands/deps.js +31 -1
  619. package/src/commands/hitl.js +3 -0
  620. package/src/commands/init.js +159 -48
  621. package/src/commands/list.js +12 -3
  622. package/src/commands/mcp.js +2 -3
  623. package/src/commands/open-work.js +123 -0
  624. package/src/commands/quickstart.js +29 -13
  625. package/src/commands/release.js +102 -19
  626. package/src/commands/run-intent.js +10 -0
  627. package/src/commands/simulate.js +20 -8
  628. package/src/commands/skills.js +59 -33
  629. package/src/commands/spec-split.js +30 -17
  630. package/src/commands/spec.js +55 -21
  631. package/src/commands/uninstall.js +146 -32
  632. package/src/commands/update.js +471 -93
  633. package/src/core/install-records.js +192 -0
  634. package/src/core/manifest.js +12 -10
  635. package/src/core/marketplace-sentinel.js +5 -0
  636. package/src/core/open-work-config.js +122 -0
  637. package/src/core/project-config.js +92 -38
  638. package/src/flows/init-flow.js +10 -0
  639. package/src/hitl/manager.js +4 -2
  640. package/src/i18n/messages.js +413 -78
  641. package/src/installers/hooks-installer.js +236 -27
  642. package/src/installers/integration-installer.js +5 -1
  643. package/src/installers/skills-installer.js +3 -1
  644. package/src/installers/standards-installer.js +16 -23
  645. package/src/mcp/__tests__/server.test.js +0 -1
  646. package/src/mcp/server.js +16 -4
  647. package/src/prompts/init.js +148 -13
  648. package/src/reconciler/backup-locations.js +80 -0
  649. package/src/reconciler/backup-manager.js +451 -123
  650. package/src/reconciler/index.js +86 -10
  651. package/src/reconciler/install-roots.js +90 -0
  652. package/src/reconciler/plan-executor.js +37 -15
  653. package/src/uninstallers/hook-uninstaller.js +220 -33
  654. package/src/uninstallers/integration-uninstaller.js +35 -5
  655. package/src/uninstallers/skills-uninstaller.js +95 -16
  656. package/src/uninstallers/standards-uninstaller.js +56 -7
  657. package/src/utils/agents-installer.js +10 -17
  658. package/src/utils/available-standards-report.js +144 -0
  659. package/src/utils/available-standards.js +216 -0
  660. package/src/utils/command-hash-ownership.js +103 -0
  661. package/src/utils/commit-message-judge.js +155 -0
  662. package/src/utils/copier.js +80 -2
  663. package/src/utils/deps-applicability.js +25 -0
  664. package/src/utils/detector.js +46 -1
  665. package/src/utils/friction-detector.js +27 -0
  666. package/src/utils/gate-scripts.js +141 -0
  667. package/src/utils/git-hooks.js +139 -7
  668. package/src/utils/hasher.js +36 -0
  669. package/src/utils/health-scorer.js +10 -7
  670. package/src/utils/installed-names-ownership.js +114 -0
  671. package/src/utils/integration-generator.js +36 -24
  672. package/src/utils/legacy-hook-migration.js +112 -0
  673. package/src/utils/locale.js +19 -0
  674. package/src/utils/open-work-tracking.mjs +1754 -0
  675. package/src/utils/prompt-closed.js +18 -0
  676. package/src/utils/sdd-header.js +66 -0
  677. package/src/utils/skill-frontmatter.js +102 -0
  678. package/src/utils/skill-hash-ownership.js +64 -0
  679. package/src/utils/skill-name-collision.js +169 -0
  680. package/src/utils/skills-install-paths.js +114 -0
  681. package/src/utils/skills-installer.js +75 -106
  682. package/src/utils/standard-validator.js +98 -27
  683. package/src/utils/test-change-check.js +160 -0
  684. package/src/utils/test-policy.js +214 -0
  685. package/src/utils/transient-fs.js +113 -0
  686. package/src/utils/update-summary.js +29 -0
  687. package/src/vibe/micro-spec.js +15 -0
  688. package/standards-registry.json +48 -9
@@ -1,7 +1,7 @@
1
1
  # UDS 功能參考手冊
2
2
 
3
3
  > Universal Development Standards - 完整功能文件
4
- > Auto-generated | Last updated: 2026-09-29
4
+ > Auto-generated | Last updated: 2026-10-12
5
5
 
6
6
  **Language**: [English](../../../docs/reference/FEATURE-REFERENCE.md) | 繁體中文 | [简体中文](../../zh-CN/docs/FEATURE-REFERENCE.md)
7
7
 
@@ -9,15 +9,15 @@
9
9
 
10
10
  ## 目錄
11
11
 
12
- 1. [CLI 指令](#cli-commands) (23)
12
+ 1. [CLI 指令](#cli-commands) (24)
13
13
  2. [斜線命令](#slash-commands) (51)
14
- 3. [技能](#skills) (55)
14
+ 3. [技能](#skills) (56)
15
15
  4. [代理](#agents) (5)
16
16
  5. [工作流程](#workflows) (5)
17
17
  6. [核心規範](#core-standards) (153)
18
- 7. [腳本](#scripts) (62)
18
+ 7. [腳本](#scripts) (66)
19
19
 
20
- **Total Features: 354**
20
+ **Total Features: 360**
21
21
 
22
22
  ---
23
23
 
@@ -48,7 +48,7 @@
48
48
  | `--lang` | Language extension (csharp, php) |
49
49
  | `--framework` | Framework extension (fat-free) |
50
50
  | `--locale` | Locale extension (zh-tw) |
51
- | `--skills-location` | Skills location (marketplace, user, project, none) [default: marketplace] |
51
+ | `--skills-location` | Skills location (project, user, marketplace, none) [default: project] |
52
52
  | `--content-mode` | Content mode for integration files (minimal, index) [default: index]; full is retired and resolves to index |
53
53
  | `--agents-md` | Generate AGENTS.md universal summary |
54
54
  | `--no-agents-md` | Skip AGENTS.md generation |
@@ -116,7 +116,7 @@
116
116
 
117
117
  ### `uds simulate`
118
118
 
119
- **說明**: Simulate a standard check with input (Predictive Validation)
119
+ **說明**: Simulate a standard check with input (Predictive Validation). Exit 0 = passes, 1 = does not comply, 2 = no verdict (cannot simulate; not a pass). Only commit-message defines a simulator today
120
120
 
121
121
  **選項**:
122
122
  | Option | 說明 |
@@ -156,8 +156,11 @@
156
156
  | `--force` | Force update all files, ignoring hash comparison |
157
157
  | `--prune` | Delete .standards/ files UDS wrote but no longer ships (listed without this flag; never touches files UDS did not write) |
158
158
  | `--rollback` | Rollback to the most recent backup |
159
+ | `--add-standard` | With --plan or --apply: also install this standard UDS ships and the project lacks, and record it in the manifest (repeatable; `uds update --plan` lists what is available) |
159
160
  | `--claude-target` | Switch an existing install to a different Claude Code integration target: project (CLAUDE.md) or local (CLAUDE.local.md) — moves the UDS block, keeps your content, no reinstall |
160
161
  | `--locale` | Override locale for skills install (zh-tw, zh-cn, en); also reads .uds/install.yaml + UDS_LOCALE env |
162
+ | `--with-hooks` | Install the enforcement hooks that are missing from this already-initialized project (re-detects tools; hooks already there and your own hooks are not touched; with --plan, writes nothing; --force also overwrites edited hook scripts) |
163
+ | `--ai-tool` | With --with-hooks: comma-separated tools to install hooks for (claude-code, codex, gemini-cli, antigravity) instead of detecting them |
161
164
 
162
165
  ### `uds skills`
163
166
 
@@ -179,6 +182,7 @@
179
182
  | `--gh` | Force gh CLI for submission |
180
183
  | `--format` | Output format (json) |
181
184
  | `--quiet` | Summary only |
185
+ | `--offline` | No network access at all: no CLI version check, and --report does not submit |
182
186
  | `--score` | Run multi-dimensional health score analysis |
183
187
  | `--self` | Self mode: analyze UDS repo itself (use with --score) |
184
188
  | `--save` | Save score snapshot for trend tracking (use with --score) |
@@ -198,6 +202,7 @@
198
202
  | `--path` | Directory containing package.json (default: cwd) |
199
203
  | `--json` | Output raw JSON |
200
204
  | `--concurrency` | Parallel registry lookups (default: 8) |
205
+ | `--if-present` | Exit 0 and say that nothing was checked when there is no package.json or no runtime dependency (default: exit 1) |
201
206
 
202
207
  ### `uds uninstall`
203
208
 
@@ -276,6 +281,10 @@
276
281
 
277
282
  **說明**: MCP server commands for AI tool integration
278
283
 
284
+ ### `uds open-work`
285
+
286
+ **說明**: Reference checks for open-work-tracking (OWT-017 to OWT-028). Exit 0 no violation, 1 violation, 2 cannot decide (not a pass)
287
+
279
288
  ### `uds run`
280
289
 
281
290
  **說明**: Run a project command by intent (test/lint/build/security) via uds.project.yaml
@@ -359,6 +368,7 @@
359
368
  | `ci-cd-assistant` | 引導 CI/CD 管線的設計、設定與最佳化。 |
360
369
  | `code-review-assistant` | [UDS] 系統性程式碼審查的參考資料:八大審查類別,以及 BLOCKING/IMPORTANT/SUGGESTION 評論前綴。 |
361
370
  | `commit-standards` | [UDS] 產生符合 Conventional Commits 規範的 commit message,包含雙語格式。 |
371
+ | `comprehension-ladder` | [UDS] 把一段難懂的 AI 輸出換成較好懂的形式:受控文字、Mermaid 圖、單檔 HTML 解說頁。所有形式都來自同一份大綱,所以形式會變,事實不會變。 |
362
372
  | `contract-test-assistant` | [UDS] 引導 API 與微服務的合約測試策略。 |
363
373
  | `database-assistant` | 引導資料庫設計、遷移與查詢最佳化。 |
364
374
  | `deploy-assistant` | 引導在沒有 CI/CD 平台(GitHub Actions/GitLab CI)的情況下完成可靠部署。 |
@@ -442,7 +452,7 @@
442
452
  | `ai-command-behavior` | 1.0.0 | This standard defines a structure for specifying AI Agent runtime behavior in co |
443
453
  | `ai-friendly-architecture` | 1.0.0 | This standard defines architecture and documentation practices that maximize the |
444
454
  | `ai-instruction-standards` | 1.1.1 | This standard defines best practices for creating and maintaining AI instruction |
445
- | `ai-response-navigation` | 1.3.0 | This standard defines navigation behavior for AI responses: every substantive AI |
455
+ | `ai-response-navigation` | 1.4.0 | This standard defines navigation behavior for AI responses: every substantive AI |
446
456
  | `alerting-standards` | 1.0.0 | |
447
457
  | `anti-hallucination` | 1.5.1 | This standard defines strict guidelines for AI assistants to prevent hallucinati |
448
458
  | `anti-sycophancy-prompting` | 1.0.0 | This standard defines techniques and rules for designing prompts that elicit gen |
@@ -461,8 +471,8 @@
461
471
  | `checkin-standards` | 1.8.0 | This standard defines quality gates that MUST be passed before committing code t |
462
472
  | `circuit-breaker` | - | |
463
473
  | `class-level-fix` | 1.1.0 | A defect is almost never alone. It is one member of a set — one flag in a dispat |
464
- | `code-review-checklist` | 1.5.0 | This standard provides a comprehensive checklist for reviewing code changes, ens |
465
- | `commit-message-guide` | 1.3.0 | Standardized commit messages improve code review efficiency, facilitate automate |
474
+ | `code-review-checklist` | 1.6.0 | This standard provides a comprehensive checklist for reviewing code changes, ens |
475
+ | `commit-message-guide` | 1.4.0 | Standardized commit messages improve code review efficiency, facilitate automate |
466
476
  | `container-image-standards` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
467
477
  | `container-security` | - | |
468
478
  | `containerization-standards` | 1.0.0 | |
@@ -478,7 +488,7 @@
478
488
  | `deployment-standards` | 1.1.0 | This standard defines guidelines for safely deploying software to production, co |
479
489
  | `deprecation-standards` | 1.1.0 | |
480
490
  | `design-document-standards` | 1.0.0 | |
481
- | `developer-memory` | 1.2.0 | This standard defines a structured system for capturing, retrieving, and surfaci |
491
+ | `developer-memory` | 1.2.1 | This standard defines a structured system for capturing, retrieving, and surfaci |
482
492
  | `disaster-recovery-drill` | - | |
483
493
  | `documentation-lifecycle` | 1.0.0 | This standard defines **when** to update documentation, **when** to check it, an |
484
494
  | `documentation-structure` | 1.5.0 | This standard defines a consistent documentation structure for software projects |
@@ -516,18 +526,18 @@
516
526
  | `mutation-testing` | 1.1.0 | Mutation testing evaluates test suite effectiveness by injecting artificial bugs |
517
527
  | `no-cicd-deployment` | - | |
518
528
  | `observability-standards` | 1.0.0 | |
519
- | `open-work-tracking` | 1.1.0 | The deferred-item-exit standard requires that a deferred item leave its document |
529
+ | `open-work-tracking` | 1.4.0 | The deferred-item-exit standard requires that a deferred item leave its document |
520
530
  | `packaging-standards` | 1.1.0 | This standard defines a Recipe-based packaging framework that enables user proje |
521
531
  | `performance-standards` | 1.2.0 | This standard defines comprehensive guidelines for software performance engineer |
522
532
  | `pii-classification` | 1.1.0 | **Status**: Active | **Updated**: 2026-06-19 | |
523
533
  | `pipeline-integration-standards` | - | |
524
- | `pipeline-security-gates` | - | |
534
+ | `pipeline-security-gates` | 1.1.0 | |
525
535
  | `policy-as-code-testing` | - | |
526
536
  | `postmortem-standards` | 1.0.0 | |
527
537
  | `prd-standards` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
528
538
  | `privacy-standards` | 1.1.0 | |
529
539
  | `product-metrics-standards` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
530
- | `project-context-memory` | 1.2.0 | This standard defines a structured system for capturing, retrieving, and enforci |
540
+ | `project-context-memory` | 1.2.1 | This standard defines a structured system for capturing, retrieving, and enforci |
531
541
  | `project-structure` | 1.2.0 | This standard defines conventions for project directory structure beyond documen |
532
542
  | `prompt-regression` | - | |
533
543
  | `property-based-testing` | - | |
@@ -598,6 +608,7 @@
598
608
  | `check-ai-agent-sync.ps1` | Check Ai Agent Sync |
599
609
  | `check-ai-agent-sync.sh` | AI Agent Sync Checker |
600
610
  | `check-ai-yaml-parses.mjs` | Every shipped .ai.yaml must parse, and must parse into what it says. |
611
+ | `check-bats-assertions.mjs` | check-bats-assertions.mjs — find .bats assertions that can pass silently. |
601
612
  | `check-bump-sync-roundtrip.mjs` | check-bump-sync-roundtrip — 測「跑完 bump 之後 check 必須通過」這個不變量。 |
602
613
  | `check-cli-docs-sync.ps1` | Check Cli Docs Sync |
603
614
  | `check-cli-docs-sync.sh` | CLI-to-Documentation Sync Checker |
@@ -610,7 +621,8 @@
610
621
  | `check-docs-sync.sh` | Documentation Sync Checker |
611
622
  | `check-error-exit.mjs` | 🔴 沒填就是沒設定,而沒設定會 exit 2, |
612
623
  | `check-external-references.mjs` | External Reference Checker (SPEC-SELFDIAG-001 REQ-5, AC-7) |
613
- | `check-open-work-tracking.mjs` | Open-work-tracking reference checks for OWT-017 / OWT-018 / OWT-019. |
624
+ | `check-home-untouched.mjs` | check-home-untouched — did this run write anywhere UDS writes under HOME? |
625
+ | `check-open-work-tracking.mjs` | Open-work-tracking reference checks for OWT-017 to OWT-028 — repo entry point. |
614
626
  | `check-orphan-specs.ps1` | Check Orphan Specs |
615
627
  | `check-orphan-specs.sh` | Orphan Spec Detection Script |
616
628
  | `check-prompt-footprint.mjs` | Prompt Footprint Ratchet — DEC-117 D2/L2 |
@@ -633,6 +645,7 @@
633
645
  | `check-version-sync.ps1` | Check Version Sync |
634
646
  | `check-version-sync.sh` | Version Sync Checker |
635
647
  | `check-workflow-compliance.sh` | Thin wrapper — scripts/check-workflow-compliance.ts is the only copy of the |
648
+ | `ci-vitest-summary.mjs` | ci-vitest-summary — say how many tests ran, passed, failed and were skipped (dev-platform XSPEC-469 R4). |
636
649
  | `commitlint-bilingual-rule.mjs` | commitlint-bilingual-rule.mjs — custom commitlint rules enforcing the |
637
650
  | `convert-md-to-yaml.mjs` | Markdown to AI-YAML Conversion Script |
638
651
  | `fix-manifest-paths.ps1` | Fix Manifest Paths |
@@ -644,6 +657,7 @@
644
657
  | `generate-version-manifest.mjs` | Generate Version Manifest (SPEC-SELFDIAG-001 REQ-9, AC-14) |
645
658
  | `install-hooks.mjs` | Install Hooks |
646
659
  | `install-hooks.sh` | Thin wrapper — scripts/install-hooks.mjs is the only copy of the installer |
660
+ | `npm-pack-files.mjs` | @param {string} stdout @returns {string[]} package-relative file paths |
647
661
  | `pre-commit.mjs` | Build a platform-aware shell command for a .sh script. |
648
662
  | `pre-release-check.ps1` | Pre Release Check |
649
663
  | `pre-release-check.sh` | Pre-release Check Script |
@@ -2,7 +2,8 @@
2
2
  source: ../../../docs/STANDARDS-REFERENCE.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-04-22
5
+ last_synced: 2026-10-11
6
+ source_hash: 04e59b1acabe
6
7
  status: current
7
8
  ---
8
9
 
@@ -2,7 +2,8 @@
2
2
  source: ../../../docs/USAGE-MODES-COMPARISON.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-01-12
5
+ last_synced: 2026-10-11
6
+ source_hash: 65e48ed292b6
6
7
  status: current
7
8
  ---
8
9
 
@@ -35,7 +36,7 @@ status: current
35
36
 
36
37
  **配置方式**:
37
38
  - 安裝時選擇 `standardsScope: minimal`
38
- - Skills 位置:Plugin Marketplace(推薦)
39
+ - Skills 位置:裝進專案(`--skills-location project`,預設);外掛市集是有限制的替代方式(只支援 Claude Code、只有英文技能文字、只跟正式版)
39
40
  - 最小化規範文件複製到專案
40
41
 
41
42
  **包含內容**:
@@ -147,7 +148,7 @@ status: current
147
148
  | 團隊同步 | 需各自安裝 | Git 同步 | 混合 |
148
149
 
149
150
  **說明**:
150
- - Skills 在 Plugin Marketplace 集中管理,但無法版本控制
151
+ - 裝進專案的 Skills(預設)可以提交到 Git;來自外掛市集的 Skills 由 Claude Code 管理,不在專案內
151
152
  - 規範文件可放入 Git,團隊自動同步
152
153
  - 自訂規則需要修改規範文件
153
154
 
@@ -180,7 +181,7 @@ status: current
180
181
 
181
182
  **配置方式**:
182
183
  ```bash
183
- uds init -y --skills-location marketplace
184
+ uds init -y --skills-location project
184
185
  # standardsScope 將自動設為 minimal
185
186
  ```
186
187
 
@@ -195,7 +196,7 @@ uds init -y --skills-location marketplace
195
196
 
196
197
  **配置方式**:
197
198
  ```bash
198
- uds init -y --skills-location marketplace --content-mode index
199
+ uds init -y --skills-location project --content-mode index
199
200
  # 在互動提示中選擇多個 AI 工具
200
201
  ```
201
202
 
@@ -296,11 +297,11 @@ uds init -y --skills-location none --content-mode index
296
297
  ```
297
298
  個人開發者 + Claude Code
298
299
  └─ 推薦:僅 Skills(模式 A)
299
- └─ 配置:standardsScope: minimal + Plugin Marketplace
300
+ └─ 配置:standardsScope: minimal + 技能裝進專案
300
301
 
301
302
  團隊開發 + 混合工具
302
303
  └─ 推薦:Skills + 規範文件(模式 C)
303
- └─ 配置:standardsScope: full + Plugin Marketplace
304
+ └─ 配置:standardsScope: full + 技能裝進專案
304
305
  └─ 規範文件納入 Git 管理
305
306
 
306
307
  企業環境 + 合規要求
@@ -2,10 +2,18 @@
2
2
  source: docs/USER-MANUAL.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
+ last_synced: 2026-10-11
6
+ source_hash: 5c3253bd60b5
5
7
  status: current
6
8
  ---
7
9
 
8
- # 使用者手冊
10
+ > **⚠️ 已棄用(DEPRECATED)** — 本手冊已過時(最後更新於 2026-03-24),不再維護。
11
+ > 最新指南請參閱新版使用者文件 **[docs/user/README.md](user/README.md)**。
12
+ > 封存位置:[docs/archive/USER-MANUAL-2026-03-24.md](../../../docs/archive/USER-MANUAL-2026-03-24.md)
13
+
14
+ ---
15
+
16
+ # 使用者手冊(已封存)
9
17
 
10
18
  **Version**: 1.0.0
11
19
  **Last Updated**: 2026-03-24
@@ -2,12 +2,15 @@
2
2
  source: ../../../docs/WINDOWS-GUIDE.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2025-12-30
5
+ last_synced: 2026-10-11
6
+ source_hash: 4416025824b3
6
7
  status: current
7
8
  ---
8
9
 
9
10
  # Windows 開發指南
10
11
 
12
+ > **語言**: [English](../../../docs/WINDOWS-GUIDE.md) | 繁體中文 | [简体中文](../../zh-CN/docs/WINDOWS-GUIDE.md)
13
+
11
14
  本指南提供使用和貢獻 Universal Development Standards 的 Windows 特定說明。
12
15
 
13
16
  ---
@@ -59,7 +62,13 @@ npm link
59
62
 
60
63
  ## 安裝 Claude Code Skills
61
64
 
62
- **推薦:Plugin Marketplace**
65
+ **主要路徑:裝進專案**(支援多種 AI 工具、有繁體與簡體中文文字、跟著你裝的 UDS 版本)
66
+ ```bash
67
+ npx universal-dev-standards init # 新專案
68
+ npx universal-dev-standards update --apply --skills # 已設定好的專案
69
+ ```
70
+
71
+ **替代方式(有限制):Claude Code 外掛市集**(只支援 Claude Code、只有英文技能文字、只跟正式版、專案內不放檔案)
63
72
  ```bash
64
73
  /plugin marketplace add AsiaOstrich/universal-dev-standards
65
74
  /plugin install universal-dev-standards@asia-ostrich
@@ -2,6 +2,8 @@
2
2
  source: docs/specs/system/memory-adoption-strategy.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
+ last_synced: 2026-10-11
6
+ source_hash: d38e219de7d9
5
7
  status: current
6
8
  ---
7
9
 
@@ -2,6 +2,8 @@
2
2
  source: docs/user/FAQ.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
+ last_synced: 2026-10-11
6
+ source_hash: d978dbb787f7
5
7
  status: current
6
8
  ---
7
9
 
@@ -2,6 +2,8 @@
2
2
  source: docs/user/GETTING-STARTED.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
+ last_synced: 2026-10-11
6
+ source_hash: a71a0848b809
5
7
  status: current
6
8
  ---
7
9
 
@@ -57,6 +59,50 @@ CLAUDE.md ← 已更新 UDS 指引(Claude Code)
57
59
 
58
60
  ---
59
61
 
62
+ ## 技能怎麼裝
63
+
64
+ 取得 UDS 技能有兩種方式,兩種都受支援。主要路徑是裝進專案;Claude Code 外掛市集是有限制的替代方式。
65
+
66
+ > **預設是裝進專案。** `uds init` 與不帶 `--skills-location` 的 `uds init --yes` 會把技能裝進專案(Claude Code 是 `.claude/skills/`)。6.14 之前它們一個技能檔都不裝,把 Claude Code 的技能留給外掛。要改用外掛,請加 `--skills-location marketplace`:專案內不會寫入任何技能檔,安裝結尾會說明技能從哪裡來。
67
+
68
+ | | 裝進專案(主要路徑) | Claude Code 外掛市集(替代方式) |
69
+ |---|---|---|
70
+ | 指令 | 新專案:`uds init`(這是預設)<br>已設定過的專案:`uds update --apply --skills` | `/plugin marketplace add AsiaOstrich/universal-dev-standards`,再 `/plugin install universal-dev-standards@asia-ostrich` |
71
+ | AI 工具 | Claude Code、OpenCode、Cursor、Codex、Copilot、Windsurf 等 | 只支援 Claude Code |
72
+ | 技能文字的語言 | 英文、繁體中文、簡體中文。中文文字放在 npm 套件內,所以安裝它們不需要網路;缺少這些文字的 UDS 會改裝英文並明說 | 只有英文:外掛設定沒有語系選擇 |
73
+ | UDS 版本 | 你裝的那個版本,包含測試版 | 只跟正式版 |
74
+ | 專案內的檔案 | 有,例如 `.claude/skills/`;`uds check` 會逐檔驗證 | 沒有 |
75
+ | 更新 | 升級 UDS 後,自己再跑一次 `uds update --apply --skills` | 由 Claude Code 管理外掛(`/plugin`) |
76
+
77
+ **請二擇一。** Claude Code 執行外掛技能是 `/<外掛名>:<技能名>`,執行專案技能是 `/<技能名>`,所以兩種都裝時每個技能會出現兩次(例如 `/commit` 與 `/universal-dev-standards:commit`),而且每個技能的名稱與描述每回合都會放進脈絡,重複裝等於重複占用。`uds check` 發現專案內有 UDS 技能、同時又裝了 UDS 外掛時,會印出警告;警告只是資訊,不改變判定與結束碼。要留專案這份,在 Claude Code 執行 `/plugin uninstall universal-dev-standards@asia-ostrich`。要留外掛,刪掉 `.claude/skills/` 底下的 UDS 技能資料夾。
78
+
79
+ **為什麼 `uds check` 與 `uds update` 叫你跑 `uds update --apply --skills`。** `uds check` 在專案裡的技能檔遺失或被改過時說這句,`uds update` 在已裝的技能版本落後時說這句。只有裝進專案的技能有檔案,UDS 才能拿它和當初裝的內容比對、放回去,所以修法就是那個指令。外掛不在你的專案裡放檔案,`uds check` 沒有東西可比對,也就沒有這類訊息。
80
+
81
+ `uds skills` 會列出裝了什麼、裝在哪裡,並印出同樣的兩種方式與各自的限制。
82
+
83
+ ### 個人技能與 UDS 技能同名時
84
+
85
+ Claude Code 對同一個名稱只執行一個技能,而且漏掉另一個時不會告訴你。哪一個執行,取決於各自從哪裡來(Claude Code 技能文件,2026-10-07 讀取):
86
+
87
+ | 同名出現在 | 執行哪一個 |
88
+ |---|---|
89
+ | 企業層(組織下發的 managed settings 目錄)、個人層(`~/.claude/skills/<名稱>/`)、專案層(`.claude/skills/<名稱>/`) | 企業層高於個人層,個人層高於專案層 |
90
+ | 專案技能與子目錄裡的巢狀技能 | 兩個都載入:`/<名稱>` 執行專案根目錄那個,巢狀那個是 `/<目錄>:<名稱>` |
91
+ | 外掛技能與上面任一處的技能 | 兩個都載入:外掛技能是 `/<外掛名>:<名稱>` |
92
+ | 技能與 `.claude/commands/<名稱>.md` 檔 | 技能 |
93
+
94
+ 技能的名稱是 `SKILL.md` frontmatter 裡的 `name:`,沒有就用資料夾名稱;資料夾名稱同樣能叫出該技能,所以兩者任一撞名都算。
95
+
96
+ **對 UDS 的意思。** `uds init --skills-location project` 與 `uds update --apply --skills` 寫進去的是專案技能。你若已有同名的個人技能,執行的是你的,UDS 那個永遠不會執行,而且沒有任何訊息說明。UDS 有幾個技能名稱短而通用(`plan`、`push`、`sweep`、`orchestrate`,以及資料夾叫 `commit-standards` 的 `/commit`),所以有個人技能庫的人都可能遇到。UDS 不為此改名:改名會破壞所有既有的呼叫。
97
+
98
+ **怎麼看見。** `uds check` 會拿專案裡的 UDS 技能與 `~/.claude/skills/` 的技能比對,印出一則警告並點名每一組;`uds init` 與 `uds update --apply --skills` 在安裝結尾印同一則警告。它只是資訊,不改變判定也不改變結束碼。它有限制,而且**沒有警告不等於沒有撞名**:它看不到組織以企業層下發的技能(優先序高於個人層),也看不到它執行之後你才新增的個人技能,所以新增之後請再跑一次 `uds check`。
99
+
100
+ **怎麼解。** 二擇一。兩個都留:把你的個人技能改名(資料夾名稱,以及 `SKILL.md` 裡的 `name:`)。只留你的:刪掉 `.claude/skills/` 底下那個 UDS 技能資料夾。
101
+
102
+ 替新的 UDS 技能取名以避免撞名,屬於貢獻者的事:見 `skills/SKILL_NAMING.md`。
103
+
104
+ ---
105
+
60
106
  ## 步驟 3 — 你的第一份 Spec(`/sdd`)
61
107
 
62
108
  在寫程式碼之前,先建立一份 spec:
@@ -2,6 +2,8 @@
2
2
  source: docs/user/GLOSSARY.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
+ last_synced: 2026-10-11
6
+ source_hash: 2371510bee49
5
7
  status: current
6
8
  ---
7
9
 
@@ -2,6 +2,8 @@
2
2
  source: docs/user/README.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
+ last_synced: 2026-10-11
6
+ source_hash: df4b49a1bde6
5
7
  status: current
6
8
  ---
7
9
 
@@ -2,6 +2,8 @@
2
2
  source: docs/user/TROUBLESHOOTING.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
+ last_synced: 2026-10-11
6
+ source_hash: dab05ff153f2
5
7
  status: current
6
8
  ---
7
9
 
@@ -2,7 +2,8 @@
2
2
  source: ../../../../integrations/claude-code/README.md
3
3
  source_version: 1.2.0
4
4
  translation_version: 1.2.0
5
- last_synced: 2026-09-18
5
+ last_synced: 2026-10-11
6
+ source_hash: 3308f2ae440b
6
7
  status: current
7
8
  ---
8
9
 
@@ -2,19 +2,34 @@
2
2
  source: ../../../../integrations/codex/AGENTS.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-01-13
5
+ last_synced: 2026-10-11
6
+ source_hash: 1bb0a0d9a5bf
6
7
  status: current
7
8
  ---
8
9
 
9
10
  # 通用開發標準
10
11
 
12
+ > **語言**: [English](../../../../integrations/codex/AGENTS.md) | 繁體中文 | [简体中文](../../../zh-CN/integrations/codex/AGENTS.md)
13
+
14
+ **版本**: 1.0.0
15
+ **最後更新**: 2026-01-09
16
+
11
17
  本專案遵循通用文件規範,以確保高品質、無幻覺的程式碼與文件。
12
18
 
13
19
  ---
14
20
 
21
+ ## 核心標準使用規則
22
+
23
+ > **核心標準使用規則**:
24
+ > 在驗證標準、檢查程式碼或執行任務時,**優先**閱讀 `core/` 中的精簡規則(例如 `core/testing-standards.md`)。
25
+ > **僅在**明確要求教學內容、詳細說明或教學指南時,才閱讀 `core/guides/` 或 `methodologies/guides/`。
26
+ > 這可確保 token 效率與聚焦的上下文。
27
+
28
+ ---
29
+
15
30
  ## 規格驅動開發 (SDD) 優先
16
31
 
17
- **規則**:當專案中整合了 SDD 工具(如 OpenSpec、Spec Kit 等)並提供特定命令時,你必須優先使用這些命令,而非手動編輯檔案。
32
+ **規則**:當專案中整合了 SDD 工具(如 OpenSpec、Spec Kit 等)並提供特定命令(例如 `/openspec` 或 `/sdd` 等斜線指令)時,你必須優先使用這些命令,而非手動編輯檔案。
18
33
 
19
34
  **偵測方式**:
20
35
  - OpenSpec:檢查是否有 `openspec/` 目錄或 `openspec.json`
@@ -89,6 +104,32 @@ status: current
89
104
 
90
105
  ---
91
106
 
107
+ ## 工作流程強制閘門
108
+
109
+ **關鍵**:在執行任何工作流程階段指令之前,你必須檢查先決條件。
110
+
111
+ ### 會話啟動協定
112
+ 會話開始時,檢查是否有進行中的工作流程:`ls .workflow-state/*.yaml 2>/dev/null`
113
+ 若發現進行中的工作流程 → 告知使用者並提供繼續執行的選項。
114
+
115
+ ### 階段閘門
116
+
117
+ | 工作流程 | 階段 | 先決條件 | 失敗時 |
118
+ |---------|-------|-------------|------------|
119
+ | SDD | implement | 規格狀態 = Approved | → `/sdd approve` |
120
+ | SDD | verify | 所有 AC 皆有程式碼 + 測試 | → `/sdd implement` |
121
+ | TDD | GREEN | 已存在失敗的測試 | → 停留在 RED |
122
+ | TDD | REFACTOR | 所有測試通過 | → 停留在 GREEN |
123
+ | BDD | AUTOMATION | `.feature` 檔案存在 | → FORMULATION |
124
+ | Commit | feat/fix | 檢查進行中的規格 | → 建議 `Refs: SPEC-XXX` |
125
+
126
+ **絕不**在失敗的測試存在之前撰寫實作程式碼(TDD)。
127
+ **絕不**在 `.feature` 檔案存在之前撰寫步驟定義(BDD)。
128
+
129
+ 參考:`.standards/workflow-enforcement.ai.yaml`
130
+
131
+ ---
132
+
92
133
  ## 程式碼審查標準
93
134
 
94
135
  參考:`core/code-review-checklist.md`
@@ -102,6 +143,23 @@ status: current
102
143
 
103
144
  ---
104
145
 
146
+ ## AI 回應導航
147
+
148
+ **規則**:每個實質性的 AI 回應結尾都必須包含導航區塊(Navigation Footer),建議下一步行動。
149
+
150
+ **關鍵行為**:
151
+ - 在完成任務、提供分析、提出問題或回報錯誤後,附加導航建議
152
+ - 提供多個選項時,以 ⭐ 標記推薦選項
153
+ - 使用情境範本(任務完成、使用者提問、錯誤/失敗、進行中、資訊性回覆)
154
+ - 依情境調整選項數量(1-5 個,絕不超過 5 個)
155
+ - 適用時,建議中優先使用斜線指令
156
+
157
+ **豁免**:極短的確認("OK"、"Done")可省略導航。
158
+
159
+ 參考:`.standards/ai-response-navigation.ai.yaml`(或 `core/ai-response-navigation.md`)
160
+
161
+ ---
162
+
105
163
  ## 版本歷史
106
164
 
107
165
  | 版本 | 日期 | 變更 |
@@ -113,3 +171,79 @@ status: current
113
171
  ## 授權
114
172
 
115
173
  本文件以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。
174
+
175
+
176
+ ## Available UDS Slash Commands | UDS 可用命令
177
+
178
+ > 為 SPEC-INTSYNC-001 同步合規自動產生的索引。權威描述位於 `skills/commands/*.md` 與 `skills/commands/COMMAND-INDEX.json`。
179
+
180
+ ### core
181
+
182
+ - `/commit`
183
+ - `/code-review`
184
+ - `/sdd`
185
+ - `/check`
186
+ - `/init`
187
+ - `/update`
188
+ - `/config`
189
+
190
+ ### testing
191
+
192
+ - `/tdd`
193
+ - `/bdd`
194
+ - `/atdd`
195
+ - `/e2e`
196
+ - `/coverage`
197
+ - `/ac-coverage`
198
+ - `/derive`
199
+ - `/derive-bdd`
200
+ - `/derive-tdd`
201
+ - `/derive-atdd`
202
+ - `/derive-all`
203
+ - `/journey-test`
204
+
205
+ ### quality
206
+
207
+ - `/checkin`
208
+ - `/refactor`
209
+ - `/scan`
210
+ - `/security`
211
+ - `/reverse`
212
+ - `/reverse-sdd`
213
+ - `/reverse-bdd`
214
+ - `/reverse-tdd`
215
+
216
+ ### docs
217
+
218
+ - `/docs`
219
+ - `/docgen`
220
+ - `/changelog`
221
+ - `/requirement`
222
+ - `/brainstorm`
223
+ - `/sdd-retro`
224
+ - `/pr`
225
+
226
+ ### ops
227
+
228
+ - `/observability`
229
+ - `/slo`
230
+ - `/runbook`
231
+ - `/incident`
232
+ - `/metrics`
233
+ - `/durable`
234
+ - `/ci-cd`
235
+
236
+ ### methodology
237
+
238
+ - `/methodology`
239
+ - `/dev-workflow`
240
+ - `/discover`
241
+ - `/release`
242
+ - `/audit`
243
+ - `/migrate`
244
+ - `/skill-builder`
245
+
246
+ ### reference
247
+
248
+ - `/database`
249
+ - `/api-design`
@@ -2,12 +2,18 @@
2
2
  source: ../../../../integrations/codex/README.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-01-13
5
+ last_synced: 2026-10-11
6
+ source_hash: 75de1661b8b0
6
7
  status: current
7
8
  ---
8
9
 
9
10
  # OpenAI Codex 整合
10
11
 
12
+ > **語言**: [English](../../../../integrations/codex/README.md) | 繁體中文 | [简体中文](../../../zh-CN/integrations/codex/README.md)
13
+
14
+ **版本**: 1.0.0
15
+ **最後更新**: 2026-01-09
16
+
11
17
  本目錄提供將通用開發規範與 OpenAI Codex CLI 整合的資源。
12
18
 
13
19
  ## 概述