universal-dev-standards 6.14.0-beta.1 → 6.14.0-beta.11

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 +11 -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 +113 -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
@@ -2,62 +2,63 @@
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
 
9
- # 使用模式比較:Skills vs 规范文件 vs 兩者并用
10
+ # 使用模式比较:Skills vs 规范文件 vs 两者并用
10
11
 
11
12
  > **语言**: [English](../../../docs/USAGE-MODES-COMPARISON.md) | 简体中文
12
13
  >
13
14
  > **版本**: 1.0.0
14
- > **最後更新**: 2026-01-12
15
+ > **最后更新**: 2026-01-12
15
16
 
16
- 本文件比較安裝 Universal Development Standards (UDS) 後三种使用模式的效果差異。
17
+ 本文件比较安装 Universal Development Standards (UDS) 后三种使用模式的效果差异。
17
18
 
18
19
  ---
19
20
 
20
21
  ## 目录
21
22
 
22
- 1. [概覽](#概覽)
23
- 2. [模式比較](#模式比較)
24
- 3. [详细比較](#详细比較)
25
- 4. [使用場景建议](#使用場景建议)
26
- 5. [功能覆蓋](#功能覆蓋)
27
- 6. [定量比較](#定量比較)
28
- 7. [結論](#結論)
23
+ 1. [概览](#概览)
24
+ 2. [模式比较](#模式比较)
25
+ 3. [详细比较](#详细比较)
26
+ 4. [使用场景建议](#使用场景建议)
27
+ 5. [功能覆盖](#功能覆盖)
28
+ 6. [定量比较](#定量比较)
29
+ 7. [结论](#结论)
29
30
 
30
31
  ---
31
32
 
32
- ## 概覽
33
+ ## 概览
33
34
 
34
- ### 模式 A:僅使用 Skills
35
+ ### 模式 A:仅使用 Skills
35
36
 
36
37
  **配置方式**:
37
- - 安裝时选择 `standardsScope: minimal`
38
- - Skills 位置:Plugin Marketplace(推荐)
39
- - 最小化规范文件複制到项目
38
+ - 安装时选择 `standardsScope: minimal`
39
+ - Skills 位置:装进项目(`--skills-location project`,默认);插件市场是有限制的替代方式(只支持 Claude Code、只有英文技能文本、只跟正式版)
40
+ - 最小化规范文件复制到项目
40
41
 
41
42
  **包含内容**:
42
43
  - 16 个 Claude Code Skills(互动式命令)
43
- - 最小化规范文件(僅 reference 类别)
44
+ - 最小化规范文件(仅 reference 类别)
44
45
 
45
- ### 模式 B:僅使用规范文件
46
+ ### 模式 B:仅使用规范文件
46
47
 
47
48
  **配置方式**:
48
- - 安裝时选择 `standardsScope: full`
49
- - 跳過 Skills 安裝(或选择非 Claude Code 工具)
50
- - 完整规范文件複制到 `.standards/`
49
+ - 安装时选择 `standardsScope: full`
50
+ - 跳过 Skills 安装(或选择非 Claude Code 工具)
51
+ - 完整规范文件复制到 `.standards/`
51
52
 
52
53
  **包含内容**:
53
54
  - 17 个核心规范文件
54
55
  - 集成文件(.cursorrules、CLAUDE.md 等)
55
- - 無互动式 Skills
56
+ - 无互动式 Skills
56
57
 
57
58
  ### 模式 C:同时使用 Skills 与规范文件
58
59
 
59
60
  **配置方式**:
60
- - 安裝时选择 `standardsScope: full` + Skills 安裝
61
+ - 安装时选择 `standardsScope: full` + Skills 安装
61
62
 
62
63
  **包含内容**:
63
64
  - 16 个 Claude Code Skills
@@ -66,267 +67,267 @@ status: current
66
67
 
67
68
  ---
68
69
 
69
- ## 模式比較
70
+ ## 模式比较
70
71
 
71
- ### 快速比較表
72
+ ### 快速比较表
72
73
 
73
- | 面向 | 僅 Skills | 僅规范文件 | Skills + 规范文件 |
74
+ | 面向 | 仅 Skills | 仅规范文件 | Skills + 规范文件 |
74
75
  |------|----------|-----------|------------------|
75
- | 互动式命令 | 16 个 | 無 | 16 个 |
76
+ | 互动式命令 | 16 个 | 无 | 16 个 |
76
77
  | 规范深度 | 中 | 高 | 高 |
77
78
  | Token 消耗 | 低 | 中-高 | 高 |
78
- | 多工具支援 | 僅 Claude Code | 全部 9 个 AI 工具 | 全部 9 个 AI 工具 |
79
- | 版本控制 | 外部管理 | Git 追蹤 | 混合 |
80
- | 自订擴展 | 受限 | 完整 | 完整 |
79
+ | 多工具支持 | 仅 Claude Code | 全部 9 个 AI 工具 | 全部 9 个 AI 工具 |
80
+ | 版本控制 | 外部管理 | Git 追踪 | 混合 |
81
+ | 自定义扩展 | 受限 | 完整 | 完整 |
81
82
  | 学习曲线 | 低 | 高 | 低 |
82
83
 
83
- ### 最適合場景
84
+ ### 最适合场景
84
85
 
85
86
  | 模式 | 推荐对象 |
86
87
  |------|---------|
87
- | **僅 Skills** | 个人开发者,專門使用 Claude Code |
88
- | **僅规范文件** | 多工具团队、企业環境、離线使用 |
89
- | **Skills + 规范文件** | 完整体驗、学习 UDS、团队入職 |
88
+ | **仅 Skills** | 个人开发者,专门使用 Claude Code |
89
+ | **仅规范文件** | 多工具团队、企业环境、离线使用 |
90
+ | **Skills + 规范文件** | 完整体验、学习 UDS、团队入职 |
90
91
 
91
92
  ---
92
93
 
93
- ## 详细比較
94
+ ## 详细比较
94
95
 
95
- ### 互动性与使用体驗
96
+ ### 互动性与使用体验
96
97
 
97
- | 面向 | 僅 Skills | 僅规范文件 | Skills + 规范文件 |
98
+ | 面向 | 仅 Skills | 仅规范文件 | Skills + 规范文件 |
98
99
  |------|----------|-----------|------------------|
99
- | 互动式命令 | 16 个可用 | 無 | 16 个可用 |
100
- | 上下文感知 | 自动偵测 | 需手动阅读 | 自动偵测 |
101
- | 工作流程引導 | 逐步引導 | 需自行理解 | 逐步引導 |
100
+ | 互动式命令 | 16 个可用 | 无 | 16 个可用 |
101
+ | 上下文感知 | 自动检测 | 需手动阅读 | 自动检测 |
102
+ | 工作流程引导 | 逐步引导 | 需自行理解 | 逐步引导 |
102
103
  | 学习曲线 | 低 | 高 | 低 |
103
104
 
104
105
  **说明**:
105
- - Skills 提供 `/commit`、`/tdd`、`/code-review` 等命令进行互动引導
106
+ - Skills 提供 `/commit`、`/tdd`、`/code-review` 等命令进行互动引导
106
107
  - 规范文件需要开发者主动阅读并应用
107
- - Skills 可自动偵测上下文(如 git status、项目语言)
108
+ - Skills 可自动检测上下文(如 git status、项目语言)
108
109
 
109
110
  ### 内容完整性
110
111
 
111
- | 面向 | 僅 Skills | 僅规范文件 | Skills + 规范文件 |
112
+ | 面向 | 仅 Skills | 仅规范文件 | Skills + 规范文件 |
112
113
  |------|----------|-----------|------------------|
113
114
  | 规范深度 | 中 | 高 | 高 |
114
- | 範例數量 | 精簡 | 豐富 | 豐富 |
115
- | 决策矩陣 | 部分 | 完整 | 完整 |
116
- | 版本追蹤 | 否 | 是 | 是 |
117
- | 跨语言範例 | 部分 | 完整 | 完整 |
115
+ | 示例数量 | 精简 | 丰富 | 丰富 |
116
+ | 决策矩阵 | 部分 | 完整 | 完整 |
117
+ | 版本追踪 | 否 | 是 | 是 |
118
+ | 跨语言示例 | 部分 | 完整 | 完整 |
118
119
 
119
120
  **说明**:
120
- - Skills 提取规范文件的精華,但省略部分細节
121
- - 规范文件包含完整的决策樹、範例、和邊界情况
122
- - 如大規模重構模式(`refactoring-standards.md`)在 Skills 中無对应功能
121
+ - Skills 提取规范文件的精华,但省略部分细节
122
+ - 规范文件包含完整的决策树、示例、和边界情况
123
+ - 如大规模重构模式(`refactoring-standards.md`)在 Skills 中无对应功能
123
124
 
124
- ### 工具支援
125
+ ### 工具支持
125
126
 
126
- | 工具 | 僅 Skills | 僅规范文件 | Skills + 规范文件 |
127
+ | 工具 | 仅 Skills | 仅规范文件 | Skills + 规范文件 |
127
128
  |------|----------|-----------|------------------|
128
- | Claude Code | 完整 | 基礎 | 完整 |
129
- | Cursor | 不支援 | 支援 | 支援 |
130
- | Windsurf | 不支援 | 支援 | 支援 |
131
- | Cline | 不支援 | 支援 | 支援 |
132
- | GitHub Copilot | 不支援 | 支援 | 支援 |
133
- | 其他 AI 工具 | 不支援 | 支援 | 支援 |
129
+ | Claude Code | 完整 | 基础 | 完整 |
130
+ | Cursor | 不支持 | 支持 | 支持 |
131
+ | Windsurf | 不支持 | 支持 | 支持 |
132
+ | Cline | 不支持 | 支持 | 支持 |
133
+ | GitHub Copilot | 不支持 | 支持 | 支持 |
134
+ | 其他 AI 工具 | 不支持 | 支持 | 支持 |
134
135
 
135
136
  **说明**:
136
- - Skills 僅支援 Claude Code
137
- - 规范文件可集成到所有 9 个支援的 AI 工具
137
+ - Skills 仅支持 Claude Code
138
+ - 规范文件可集成到所有 9 个支持的 AI 工具
138
139
  - 多工具团队需要规范文件
139
140
 
140
- ### 維護与更新
141
+ ### 维护与更新
141
142
 
142
- | 面向 | 僅 Skills | 僅规范文件 | Skills + 规范文件 |
143
+ | 面向 | 仅 Skills | 仅规范文件 | Skills + 规范文件 |
143
144
  |------|----------|-----------|------------------|
144
145
  | 更新方式 | Plugin 自动更新 | `uds update` | 混合 |
145
- | 版本控制 | 外部管理 | Git 追蹤 | 部分 |
146
- | 自订擴展 | 受限 | 完整 | 完整 |
147
- | 团队同步 | 需各自安裝 | Git 同步 | 混合 |
146
+ | 版本控制 | 外部管理 | Git 追踪 | 部分 |
147
+ | 自定义扩展 | 受限 | 完整 | 完整 |
148
+ | 团队同步 | 需各自安装 | Git 同步 | 混合 |
148
149
 
149
150
  **说明**:
150
- - Skills 在 Plugin Marketplace 集中管理,但無法版本控制
151
+ - 装进项目的 Skills(默认)可以提交到 Git;来自插件市场的 Skills 由 Claude Code 管理,不在项目内
151
152
  - 规范文件可放入 Git,团队自动同步
152
- - 自订規則需要修改规范文件
153
+ - 自定义规则需要修改规范文件
153
154
 
154
155
  ### Token 使用效率
155
156
 
156
- | 面向 | 僅 Skills | 僅规范文件 | Skills + 规范文件 |
157
+ | 面向 | 仅 Skills | 仅规范文件 | Skills + 规范文件 |
157
158
  |------|----------|-----------|------------------|
158
- | 基礎 Token 消耗 | 低 | 中-高 | 高 |
159
- | 按需载入 | 是 | 否 | 部分 |
160
- | 重複内容 | 無 | 無 | 有 |
159
+ | 基础 Token 消耗 | 低 | 中-高 | 高 |
160
+ | 按需加载 | 是 | 否 | 部分 |
161
+ | 重复内容 | 无 | 无 | 有 |
161
162
 
162
163
  **说明**:
163
- - Skills 按需载入,只在呼叫时消耗 token
164
- - 规范文件集成到 CLAUDE.md 後,每次对话都会载入
165
- - 同时使用时,Skills 与规范文件有部分内容重疊
164
+ - Skills 按需加载,只在调用时消耗 token
165
+ - 规范文件集成到 CLAUDE.md 后,每次对话都会加载
166
+ - 同时使用时,Skills 与规范文件有部分内容重叠
166
167
 
167
168
  ---
168
169
 
169
- ## 使用場景建议
170
+ ## 使用场景建议
170
171
 
171
- ### 場景 1:个人开发者 + 僅使用 Claude Code
172
+ ### 场景 1:个人开发者 + 仅使用 Claude Code
172
173
 
173
- **推荐模式**:僅使用 Skills(模式 A)
174
+ **推荐模式**:仅使用 Skills(模式 A)
174
175
 
175
176
  **原因**:
176
177
  - Token 消耗最低
177
- - 互动体驗最佳
178
- - 無需管理額外文件
179
- - `/commit`、`/tdd`、`/code-review` 命令足夠日常使用
178
+ - 互动体验最佳
179
+ - 无需管理额外文件
180
+ - `/commit`、`/tdd`、`/code-review` 命令足够日常使用
180
181
 
181
182
  **配置方式**:
182
183
  ```bash
183
- uds init -y --skills-location marketplace
184
- # standardsScope 將自动设为 minimal
184
+ uds init -y --skills-location project
185
+ # standardsScope 将自动设为 minimal
185
186
  ```
186
187
 
187
- ### 場景 2:团队开发 + 多种 AI 工具
188
+ ### 场景 2:团队开发 + 多种 AI 工具
188
189
 
189
190
  **推荐模式**:同时使用 Skills + 规范文件(模式 C)
190
191
 
191
192
  **原因**:
192
193
  - 规范文件可 Git 同步,确保团队一致性
193
194
  - 非 Claude Code 使用者可使用规范文件
194
- - Skills 提供 Claude Code 使用者更好的体驗
195
+ - Skills 提供 Claude Code 使用者更好的体验
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
 
202
- ### 場景 3:嚴格规范要求的企业環境
203
+ ### 场景 3:严格规范要求的企业环境
203
204
 
204
- **推荐模式**:僅使用规范文件(模式 B)
205
+ **推荐模式**:仅使用规范文件(模式 B)
205
206
 
206
207
  **原因**:
207
- - 可完全自订规范内容
208
- - 完整的版本控制和审计追蹤
209
- - 不依賴外部 Plugin Marketplace
210
- - 適合需要離线工作的環境
208
+ - 可完全自定义规范内容
209
+ - 完整的版本控制和审计追踪
210
+ - 不依赖外部 Plugin Marketplace
211
+ - 适合需要离线工作的环境
211
212
 
212
213
  **配置方式**:
213
214
  ```bash
214
215
  uds init -y --skills-location none --content-mode index
215
216
  ```
216
217
 
217
- ### 場景 4:学习 UDS 标准体系
218
+ ### 场景 4:学习 UDS 标准体系
218
219
 
219
220
  **推荐模式**:同时使用 Skills + 规范文件(模式 C)
220
221
 
221
222
  **原因**:
222
- - Skills 提供引導式学习
223
- - 规范文件提供深入參考
223
+ - Skills 提供引导式学习
224
+ - 规范文件提供深入参考
224
225
  - 可对照 Skills 行为与规范内容
225
226
 
226
227
  ---
227
228
 
228
- ## 功能覆蓋
229
+ ## 功能覆盖
229
230
 
230
- ### Skills 強项但规范文件較弱的功能
231
+ ### Skills 强项但规范文件较弱的功能
231
232
 
232
233
  | 功能 | 对应 Skill |
233
234
  |------|-----------|
234
- | 方法論切换 | `/methodology switch` |
235
+ | 方法论切换 | `/methodology switch` |
235
236
  | 阶段检查点提醒 | `methodology-system` |
236
237
  | 自动提交消息生成 | `/commit` |
237
- | 互动式 TDD 循環 | `/tdd` |
238
+ | 互动式 TDD 循环 | `/tdd` |
238
239
 
239
- ### 规范文件提供但 Skills 未涵蓋的功能
240
+ ### 规范文件提供但 Skills 未涵盖的功能
240
241
 
241
242
  | 功能 | 对应规范文件 |
242
243
  |------|-------------|
243
- | 大規模重構模式(Strangler Fig) | `refactoring-standards.md` |
244
- | 技術債评估矩陣 | `refactoring-standards.md` |
244
+ | 大规模重构模式(Strangler Fig) | `refactoring-standards.md` |
245
+ | 技术债评估矩阵 | `refactoring-standards.md` |
245
246
  | 完整错误码分类体系 | `error-code-standards.md` |
246
- | 日誌採样策略 | `logging-standards.md` |
247
- | 项目类型映射矩陣 | `documentation-writing-standards.md` |
247
+ | 日志采样策略 | `logging-standards.md` |
248
+ | 项目类型映射矩阵 | `documentation-writing-standards.md` |
248
249
 
249
- ### 兩者均完整覆蓋的功能
250
+ ### 两者均完整覆盖的功能
250
251
 
251
252
  | 功能 | Skill | 规范文件 |
252
253
  |------|-------|---------|
253
254
  | Conventional Commits | `commit-standards` | `commit-message-guide.md` |
254
255
  | 测试金字塔 | `testing-guide` | `testing-standards.md` |
255
256
  | 代码审查清单 | `code-review-assistant` | `code-review-checklist.md` |
256
- | 語義化版本 | `release-standards` | `versioning.md` |
257
+ | 语义化版本 | `release-standards` | `versioning.md` |
257
258
  | CHANGELOG 格式 | `changelog-guide` | `changelog-standards.md` |
258
259
 
259
260
  ---
260
261
 
261
- ## 定量比較
262
+ ## 定量比较
262
263
 
263
- ### 内容量比較
264
+ ### 内容量比较
264
265
 
265
- | 指標 | 僅 Skills | 僅规范文件 | Skills + 规范文件 |
266
+ | 指标 | 仅 Skills | 仅规范文件 | Skills + 规范文件 |
266
267
  |------|----------|-----------|------------------|
267
- | 文件數量 | ~16 Skills | ~17 规范 | ~33 總计 |
268
- | 估计行數 | ~3,000 | ~8,000 | ~11,000 |
268
+ | 文件数量 | ~16 Skills | ~17 规范 | ~33 总计 |
269
+ | 估计行数 | ~3,000 | ~8,000 | ~11,000 |
269
270
  | 估计 Token | ~15K | ~40K | ~50K |
270
271
 
271
- ### 各領域功能覆蓋率
272
+ ### 各领域功能覆盖率
272
273
 
273
- | 領域 | 僅 Skills | 僅规范文件 | Skills + 规范文件 |
274
+ | 领域 | 仅 Skills | 仅规范文件 | Skills + 规范文件 |
274
275
  |------|----------|-----------|------------------|
275
276
  | 版本管理 | 90% | 100% | 100% |
276
277
  | 测试规范 | 85% | 100% | 100% |
277
278
  | 代码审查 | 95% | 100% | 100% |
278
- | 重構指引 | 30% | 100% | 100% |
279
+ | 重构指引 | 30% | 100% | 100% |
279
280
  | 错误处理 | 70% | 100% | 100% |
280
- | 日誌规范 | 60% | 100% | 100% |
281
+ | 日志规范 | 60% | 100% | 100% |
281
282
 
282
283
  ---
283
284
 
284
- ## 結論
285
+ ## 结论
285
286
 
286
- ### 效果差異總結
287
+ ### 效果差异总结
287
288
 
288
- 1. **互动性**:Skills > 规范文件(Skills 提供主动引導)
289
- 2. **完整性**:规范文件 > Skills(规范文件涵蓋更多細节)
290
- 3. **效率**:Skills > 规范文件(按需载入,token 消耗低)
291
- 4. **靈活性**:规范文件 > Skills(可自订、可版本控制)
292
- 5. **多工具支援**:规范文件 > Skills(Skills 僅限 Claude Code)
289
+ 1. **互动性**:Skills > 规范文件(Skills 提供主动引导)
290
+ 2. **完整性**:规范文件 > Skills(规范文件涵盖更多细节)
291
+ 3. **效率**:Skills > 规范文件(按需加载,token 消耗低)
292
+ 4. **灵活性**:规范文件 > Skills(可自定义、可版本控制)
293
+ 5. **多工具支持**:规范文件 > Skills(Skills 仅限 Claude Code)
293
294
 
294
- ### 最佳实踐建议
295
+ ### 最佳实践建议
295
296
 
296
297
  ```
297
298
  个人开发者 + Claude Code
298
- └─ 推荐:僅 Skills(模式 A)
299
- └─ 配置:standardsScope: minimal + Plugin Marketplace
299
+ └─ 推荐:仅 Skills(模式 A)
300
+ └─ 配置:standardsScope: minimal + 技能装进项目
300
301
 
301
302
  团队开发 + 混合工具
302
303
  └─ 推荐:Skills + 规范文件(模式 C)
303
- └─ 配置:standardsScope: full + Plugin Marketplace
304
- └─ 规范文件納入 Git 管理
304
+ └─ 配置:standardsScope: full + 技能装进项目
305
+ └─ 规范文件纳入 Git 管理
305
306
 
306
- 企业環境 + 合規要求
307
- └─ 推荐:僅规范文件(模式 B)
308
- └─ 配置:standardsScope: full + 無 Skills
309
- └─ 可完全離线使用
307
+ 企业环境 + 合规要求
308
+ └─ 推荐:仅规范文件(模式 B)
309
+ └─ 配置:standardsScope: full + 无 Skills
310
+ └─ 可完全离线使用
310
311
  ```
311
312
 
312
- ### 總体评价
313
+ ### 总体评价
313
314
 
314
- | 模式 | 適合对象 | 评分 |
315
+ | 模式 | 适合对象 | 评分 |
315
316
  |------|---------|------|
316
- | 僅 Skills | 个人快速开发 | ★★★★☆ |
317
- | 僅规范文件 | 多工具团队/企业 | ★★★★☆ |
318
- | Skills + 规范文件 | 完整体驗/学习 | ★★★★★ |
317
+ | 仅 Skills | 个人快速开发 | ★★★★☆ |
318
+ | 仅规范文件 | 多工具团队/企业 | ★★★★☆ |
319
+ | Skills + 规范文件 | 完整体验/学习 | ★★★★★ |
319
320
 
320
- **結論**:三种模式各有優勢,选择取决於团队規模、工具組合、和合規要求。对於希望獲得最完整体驗的用戶,建议同时使用 Skills 与规范文件。
321
+ **结论**:三种模式各有优势,选择取决于团队规模、工具组合、和合规要求。对于希望获得最完整体验的用户,建议同时使用 Skills 与规范文件。
321
322
 
322
323
  ---
323
324
 
324
325
  ## 相关文件
325
326
 
326
327
  - [CLI 初始化选项](CLI-INIT-OPTIONS.md) - 完整 CLI 选项指南
327
- - [採用指南](../../../adoption/ADOPTION-GUIDE.md) - 标准採用指南
328
+ - [采用指南](../../../adoption/ADOPTION-GUIDE.md) - 标准采用指南
328
329
  - [Skills README](../../../skills/README.md) - Claude Code Skills 文件
329
330
 
330
331
  ---
331
332
 
332
- **由 Universal Dev Standards 团队維護**
333
+ **由 Universal Dev Standards 团队维护**
@@ -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
+ > **⚠️ 已弃用** — 本手册已过时(最后更新于 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
@@ -47,7 +55,7 @@ Universal Development Standards 是一套为 AI 时代设计的**语言无关、
47
55
  |------|------|------|
48
56
  | **Core Standards** | 53 | 通用开发准则(Markdown) |
49
57
  | **AI Skills** | 43 | 交互式技能(YAML) |
50
- | **Slash Commands** | 30 | 日常开发快速操作指令 |
58
+ | **Slash Commands** | 45 | 日常开发快速操作指令 |
51
59
  | **CLI Commands** | 6 | 命令行工具 |
52
60
 
53
61
  **三大特性:**
@@ -602,7 +610,7 @@ Refs: SPEC-001
602
610
  >
603
611
  > **以上集成目前没有任何一个通过行为验证**——「状态」栏说的是**我们写的那份集成**有多完整,
604
612
  > 不是该工具是否曾被实测。完整清单、两套图例与验证排程见
605
- > [README](../../README.md#-ai-工具支持);验证程序见
613
+ > [README](../README.md#-ai-工具支持);验证程序见
606
614
  > [Integration Verification](../../../docs/reference/INTEGRATION-VERIFICATION.md)。
607
615
 
608
616
  > **一套标准,多工具通用** — 换 AI 工具不需要重学标准。
@@ -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-TW/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
@@ -206,7 +215,7 @@ uds init --help
206
215
 
207
216
  ## 相关文件
208
217
 
209
- - [主 README](../../README.md) - 专案概述
218
+ - [主 README](../README.md) - 专案概述
210
219
  - [CLI README](../../../cli/README.md) - CLI 文件
211
220
  - [采用指南](../adoption/ADOPTION-GUIDE.md) - 完整采用指南
212
221
 
@@ -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
 
@@ -17,8 +19,8 @@ status: current
17
19
 
18
20
  刚安装完 UDS?从这里开始:
19
21
 
20
- 1. **[GETTING-STARTED.md](../../../../docs/user/GETTING-STARTED.md)** — 5 分钟导览:安装 → 初始化 → 第一份 spec → 第一次 commit(简中翻译进行中)
21
- 2. **[GLOSSARY.md](../../../../docs/user/GLOSSARY.md)** — 什么是 Skill?Standard?Tier?所有 UDS 术语的定义(简中翻译进行中)
22
+ 1. **[GETTING-STARTED.md](GETTING-STARTED.md)** — 5 分钟导览:安装 → 初始化 → 第一份 spec → 第一次 commit
23
+ 2. **[GLOSSARY.md](GLOSSARY.md)** — 什么是 Skill?Standard?Tier?所有 UDS 术语的定义
22
24
  3. **[SKILLS-INDEX.md](../../../../docs/user/SKILLS-INDEX.md)** — 按 Tier 与分类浏览全部 55 个 skill(自动生成,仅英文)
23
25
 
24
26
  ---