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,23 +2,24 @@
2
2
  source: ../../../../skills/release-standards/changelog-format.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2025-12-25
5
+ last_synced: 2026-10-11
6
+ source_hash: d214563d2b6b
6
7
  status: current
7
8
  ---
8
9
 
9
- # 变更日誌格式指南
10
+ # 变更日志格式指南
10
11
 
11
12
  > **语言**: [English](../../../../skills/release-standards/changelog-format.md) | 简体中文
12
13
 
13
14
  **版本**: 1.0.0
14
- **最後更新**: 2025-12-24
15
- **適用範圍**: Claude Code Skills
15
+ **最后更新**: 2025-12-24
16
+ **适用范围**: Claude Code Skills
16
17
 
17
18
  ---
18
19
 
19
20
  ## 目的
20
21
 
21
- 本文件提供撰写和格式化变更日誌文件的指南。
22
+ 本文档提供撰写和格式化变更日志文件的指南。
22
23
 
23
24
  此标准遵循 [Keep a Changelog](https://keepachangelog.com/) 格式。
24
25
 
@@ -58,22 +59,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
58
59
 
59
60
  | 分类 | 用途 | 何时使用 |
60
61
  |----------|-------|-------------|
61
- | **Added** | 新功能 | 为使用者提供的新功能 |
62
- | **Changed** | 修改 | 現有功能的变更 |
63
- | **Deprecated** | 即將移除 | 即將被移除的功能 |
62
+ | **Added** | 新功能 | 为用户提供的新功能 |
63
+ | **Changed** | 修改 | 现有功能的变更 |
64
+ | **Deprecated** | 即将移除 | 即将被移除的功能 |
64
65
  | **Removed** | 已移除功能 | 在此版本中移除的功能 |
65
- | **Fixed** | 错误修復 | 任何错误修復 |
66
- | **Security** | 安全性修補 | 漏洞修復 |
66
+ | **Fixed** | 错误修复 | 任何错误修复 |
67
+ | **Security** | 安全补丁 | 漏洞修复 |
67
68
 
68
69
  ---
69
70
 
70
- ## 版本標題格式
71
+ ## 版本标题格式
71
72
 
72
73
  ```markdown
73
74
  ## [VERSION] - YYYY-MM-DD
74
75
  ```
75
76
 
76
- **範例**:
77
+ **示例**:
77
78
  ```markdown
78
79
  ## [2.0.0] - 2025-12-15
79
80
  ## [1.5.0-beta.1] - 2025-12-01
@@ -88,7 +89,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
88
89
  - [Action verb] [what changed] ([reference])
89
90
  ```
90
91
 
91
- **範例**:
92
+ **示例**:
92
93
  ```markdown
93
94
  ### Added
94
95
  - Add user dashboard with customizable widgets (#123)
@@ -105,9 +106,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
105
106
 
106
107
  ---
107
108
 
108
- ## 破壞性变更
109
+ ## 破坏性变更
109
110
 
110
- 使用 **BREAKING** 前綴清楚標记破壞性变更:
111
+ 使用 **BREAKING** 前缀清楚标记破坏性变更:
111
112
 
112
113
  ```markdown
113
114
  ### Changed
@@ -122,7 +123,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
122
123
 
123
124
  ## 安全性公告
124
125
 
125
- 如果可用,請包含嚴重程度和 CVE:
126
+ 如果可用,请包含严重程度和 CVE:
126
127
 
127
128
  ```markdown
128
129
  ### Security
@@ -133,42 +134,42 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
133
134
 
134
135
  ---
135
136
 
136
- ## 提交消息与变更日誌对应
137
+ ## 提交信息与变更日志对应
137
138
 
138
- | 提交类型 | 变更日誌分类 | 备註 |
139
+ | 提交类型 | 变更日志分类 | 备注 |
139
140
  |-------------|-------------------|-------|
140
141
  | `feat` | **Added** | 新功能 |
141
- | `fix` | **Fixed** | 错误修復 |
142
- | `perf` | **Changed** | 效能改善 |
143
- | `refactor` | *(通常省略)* | 內部变更 |
144
- | `docs` | *(通常省略)* | 僅文件 |
145
- | `test` | *(通常省略)* | 僅测试 |
146
- | `chore` | *(通常省略)* | 維護 |
147
- | `BREAKING CHANGE` | **Changed** 或 **Removed** | 使用 **BREAKING** 前綴 |
148
- | `security` | **Security** | 安全性修補 |
149
- | `deprecate` | **Deprecated** | 棄用通知 |
142
+ | `fix` | **Fixed** | 错误修复 |
143
+ | `perf` | **Changed** | 性能改进 |
144
+ | `refactor` | *(通常省略)* | 内部变更 |
145
+ | `docs` | *(通常省略)* | 仅文档 |
146
+ | `test` | *(通常省略)* | 仅测试 |
147
+ | `chore` | *(通常省略)* | 维护 |
148
+ | `BREAKING CHANGE` | **Changed** 或 **Removed** | 使用 **BREAKING** 前缀 |
149
+ | `security` | **Security** | 安全补丁 |
150
+ | `deprecate` | **Deprecated** | 弃用通知 |
150
151
 
151
152
  ---
152
153
 
153
- ## 排除規則
154
+ ## 排除规则
154
155
 
155
- 以下项目**不应**记录在变更日誌中:
156
+ 以下内容**不应**记录在变更日志中:
156
157
 
157
- | 分类 | 範例 | 原因 |
158
+ | 分类 | 示例 | 原因 |
158
159
  |----------|----------|--------|
159
- | 建置输出 | `dist/`, `build/`, `bin/` | 产生的文件 |
160
- | 相依套件 | `node_modules/`, lock files | 自动管理 |
161
- | 本地设置 | `.env`, `*.local.json` | 環境特定 |
160
+ | 构建输出 | `dist/`, `build/`, `bin/` | 生成的文件 |
161
+ | 依赖包 | `node_modules/`, lock files | 自动管理 |
162
+ | 本地设置 | `.env`, `*.local.json` | 环境特定 |
162
163
  | IDE 设置 | `.vscode/`, `.idea/` | 开发者偏好 |
163
- | 內部重構 | 程序码風格、变數名称 | 無使用者影響 |
164
+ | 内部重构 | 代码风格、变量名称 | 无用户影响 |
164
165
 
165
166
  ---
166
167
 
167
168
  ## 撰写技巧
168
169
 
169
- ### 为使用者撰写,而非开发者
170
+ ### 为用户撰写,而非开发者
170
171
 
171
- | 良好範例 | 不良範例 |
172
+ | 良好示例 | 不良示例 |
172
173
  |------|-----|
173
174
  | Add dark mode theme option | Implement ThemeProvider with context |
174
175
  | Fix login timeout on slow networks | Fix race condition in AuthService |
@@ -176,9 +177,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
176
177
 
177
178
  ---
178
179
 
179
- ## 多语言支援
180
+ ## 多语言支持
180
181
 
181
- ### 雙語条目
182
+ ### 双语条目
182
183
 
183
184
  ```markdown
184
185
  ## [1.2.0] - 2025-12-15
@@ -191,7 +192,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
191
192
 
192
193
  ### Fixed | 修復
193
194
  - Fix login timeout issue
194
- 修復登入逾时問題
195
+ 修復登入逾時問題
195
196
  ```
196
197
 
197
198
  ---
@@ -242,6 +243,6 @@ conventional-changelog -p angular -i CHANGELOG.md -s
242
243
 
243
244
  ## 授权条款
244
245
 
245
- 本文件依据 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权發布。
246
+ 本文档依据 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权发布。
246
247
 
247
- **來源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
248
+ **来源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
@@ -2,36 +2,37 @@
2
2
  source: ../../../../skills/release-standards/release-workflow.md
3
3
  source_version: 2.2.0
4
4
  translation_version: 2.2.0
5
- last_synced: 2026-01-26
5
+ last_synced: 2026-10-11
6
+ source_hash: 77ab71c9f97f
6
7
  status: current
7
8
  ---
8
9
 
9
- # 發布流程指南
10
+ # 发布流程指南
10
11
 
11
12
  > **Language**: [English](../../../../skills/release-standards/release-workflow.md) | 简体中文
12
13
 
13
14
  **版本**: 2.2.0
14
- **最後更新**: 2026-01-26
15
- **適用範圍**: 所有使用語義化版本的软体项目
15
+ **最后更新**: 2026-01-26
16
+ **适用范围**: 所有使用语义化版本的软件项目
16
17
 
17
18
  ---
18
19
 
19
20
  ## 目的
20
21
 
21
- 本文件提供適用於任何软体项目的通用發布流程指南。涵蓋版本管理、發布类型和标准發布流程。
22
+ 本文档提供适用于任何软件项目的通用发布流程指南。涵盖版本管理、发布类型和标准发布流程。
22
23
 
23
- > **注意**:项目特有配置(額外的版本文件、翻譯同步、自订验证脚本)請在项目的 `CLAUDE.md` 文件中定義。
24
+ > **注意**:项目特有配置(额外的版本文件、翻译同步、自定义验证脚本)请在项目的 `CLAUDE.md` 文件中定义。
24
25
 
25
26
  ---
26
27
 
27
- ## 發布类型
28
+ ## 发布类型
28
29
 
29
- ### 1. Beta 發布(测试版本)
30
+ ### 1. Beta 发布(测试版本)
30
31
 
31
32
  **使用时机:**
32
- - 在穩定版發布前测试新功能
33
- - 向早期採用者收集回饋
34
- - 在生产環境前验证错误修正
33
+ - 在稳定版发布前测试新功能
34
+ - 向早期采用者收集反馈
35
+ - 在生产环境前验证错误修正
35
36
 
36
37
  **版本模式:** `X.Y.Z-beta.N`(例如:`3.2.1-beta.1`)
37
38
 
@@ -39,12 +40,12 @@ status: current
39
40
 
40
41
  ---
41
42
 
42
- ### 2. 穩定發布(正式版本)
43
+ ### 2. 稳定发布(正式版本)
43
44
 
44
45
  **使用时机:**
45
46
  - 所有功能已测试并验证
46
- - 准备好用於生产環境
47
- - 所有测试通過
47
+ - 准备好用于生产环境
48
+ - 所有测试通过
48
49
 
49
50
  **版本模式:** `X.Y.Z`(例如:`3.2.1`)
50
51
 
@@ -52,11 +53,11 @@ status: current
52
53
 
53
54
  ---
54
55
 
55
- ### 3. Alpha 發布(早期测试)
56
+ ### 3. Alpha 发布(早期测试)
56
57
 
57
58
  **使用时机:**
58
- - 非常早期的测试,功能不穩定
59
- - 僅限內部团队测试
59
+ - 非常早期的测试,功能不稳定
60
+ - 仅限内部团队测试
60
61
 
61
62
  **版本模式:** `X.Y.Z-alpha.N`(例如:`3.3.0-alpha.1`)
62
63
 
@@ -64,11 +65,11 @@ status: current
64
65
 
65
66
  ---
66
67
 
67
- ### 4. 候選發布(预發布)
68
+ ### 4. 候选发布(预发布)
68
69
 
69
70
  **使用时机:**
70
- - 穩定版發布前的最終测试
71
- - 不包含新功能,僅错误修正
71
+ - 稳定版发布前的最终测试
72
+ - 不包含新功能,仅错误修正
72
73
 
73
74
  **版本模式:** `X.Y.Z-rc.N`(例如:`3.2.1-rc.1`)
74
75
 
@@ -76,36 +77,30 @@ status: current
76
77
 
77
78
  ---
78
79
 
79
- ## 标准發布流程
80
+ ## 标准发布流程
80
81
 
81
- ### 步骤 1:發布前检查
82
+ > **流程理念**:先定版本,再验证。在测试之前先更新版本,确保验证针对的正是要发布的确切版本。
83
+
84
+ ### 步骤 1:准备发布分支
82
85
 
83
86
  ```bash
84
87
  # 确保在 main 分支并已更新
85
88
  git checkout main
86
89
  git pull origin main
87
90
 
88
- # 执行测试
89
- npm test # 或项目的测试指令
90
-
91
- # 执行程序码检查
92
- npm run lint # 或项目的 lint 指令
93
-
94
- # 检查 git 状态
95
- git status # 应为乾淨状态
96
-
97
- # 执行文档同步检查(如有)
98
- ./scripts/check-usage-docs-sync.sh # 或 .\scripts\check-usage-docs-sync.ps1
91
+ # 检查 git 状态(应为干净状态)
92
+ git status
99
93
  ```
100
94
 
101
95
  ### 步骤 2:更新版本
102
96
 
103
97
  ```bash
104
98
  # npm 项目
105
- npm version X.Y.Z # 穩定版
106
- npm version X.Y.Z-beta.N # Beta 版
99
+ npm version X.Y.Z --no-git-tag-version # 稳定版
100
+ npm version X.Y.Z-beta.N --no-git-tag-version # Beta 版
107
101
 
108
102
  # 其他项目,手动更新版本文件
103
+ # 更新所有项目特有的版本文件(参见 CLAUDE.md)
109
104
  ```
110
105
 
111
106
  ### 步骤 3:更新 CHANGELOG
@@ -113,8 +108,6 @@ npm version X.Y.Z-beta.N # Beta 版
113
108
  依照 [Keep a Changelog](https://keepachangelog.com/) 格式更新 `CHANGELOG.md`:
114
109
 
115
110
  ```markdown
116
- ## [Unreleased]
117
-
118
111
  ## [X.Y.Z] - YYYY-MM-DD
119
112
 
120
113
  ### Added
@@ -127,50 +120,88 @@ npm version X.Y.Z-beta.N # Beta 版
127
120
  - 错误修正描述
128
121
  ```
129
122
 
130
- ### 步骤 4:提交与标签
123
+ Beta 版本需加上警告:
124
+
125
+ ```markdown
126
+ ## [X.Y.Z-beta.N] - YYYY-MM-DD
127
+
128
+ > ⚠️ **Beta 发布**:供测试使用。安装方式:`npm install <package>@beta`
129
+ ```
130
+
131
+ ### 步骤 4:执行所有测试
132
+
133
+ ```bash
134
+ # 执行自动化测试
135
+ npm test # 或项目的测试命令
136
+
137
+ # 执行代码检查
138
+ npm run lint # 或项目的 lint 命令
139
+
140
+ # 执行发布前检查(如有)
141
+ ./scripts/pre-release-check.sh # 或 .\scripts\pre-release-check.ps1
142
+
143
+ # 执行文档同步检查(如有)
144
+ ./scripts/check-usage-docs-sync.sh # 或 .\scripts\check-usage-docs-sync.ps1
145
+ ```
146
+
147
+ ### 步骤 5:手动验证
148
+
149
+ 继续之前,手动验证:
150
+
151
+ - [ ] **构建验证**:应用程序构建成功
152
+ - [ ] **冒烟测试**:核心功能按预期运作
153
+ - [ ] **版本显示**:版本号显示正确
154
+ - [ ] **Beta 版**:已知问题已记录在 CHANGELOG 中
155
+
156
+ > ⚠️ **任何验证失败时请在此停止。** 先修复问题再继续。
157
+
158
+ ### 步骤 6:提交与标签
131
159
 
132
160
  ```bash
133
161
  # 提交变更
134
162
  git add .
135
163
  git commit -m "chore(release): X.Y.Z"
136
164
 
137
- # 建立并推送标签
165
+ # 创建并推送标签
138
166
  git tag vX.Y.Z
139
167
  git push origin main --tags
140
168
  ```
141
169
 
142
- ### 步骤 5:建立 Release
170
+ ### 步骤 7:创建 Release
143
171
 
144
- 建立 GitHub/GitLab Release:
172
+ 创建 GitHub/GitLab Release:
145
173
  - Tag:`vX.Y.Z`
146
- - 標題:`vX.Y.Z - [Release Name]`
147
- - 若为 beta/alpha/rc,標记为 pre-release
148
- - 從 CHANGELOG 加入發布说明
174
+ - 标题:`vX.Y.Z - [Release Name]`
175
+ - 若为 beta/alpha/rc,标记为 pre-release
176
+ - 从 CHANGELOG 加入发布说明
149
177
 
150
- ### 步骤 6:验证發布
178
+ ### 步骤 8:验证发布
151
179
 
152
180
  ```bash
153
- # npm 套件
181
+ # npm 包
154
182
  npm view <package-name> dist-tags
155
183
 
156
- # 测试安裝
184
+ # 测试安装
157
185
  npm install -g <package-name>@<version>
186
+
187
+ # 验证版本
188
+ <command> --version # 应显示 X.Y.Z
158
189
  ```
159
190
 
160
191
  ---
161
192
 
162
193
  ## npm dist-tag 策略
163
194
 
164
- | 版本模式 | npm Tag | 安裝指令 |
195
+ | 版本模式 | npm Tag | 安装命令 |
165
196
  |---------|---------|---------|
166
197
  | `X.Y.Z` | `latest` | `npm install <package>` |
167
198
  | `X.Y.Z-beta.N` | `beta` | `npm install <package>@beta` |
168
199
  | `X.Y.Z-alpha.N` | `alpha` | `npm install <package>@alpha` |
169
200
  | `X.Y.Z-rc.N` | `rc` | `npm install <package>@rc` |
170
201
 
171
- ### 自动标签偵测
202
+ ### 自动标签检测
172
203
 
173
- 用於 CI/CD 自动化,使用正則表达式偵测版本类型:
204
+ 用于 CI/CD 自动化,使用正则表达式检测版本类型:
174
205
 
175
206
  ```bash
176
207
  VERSION=$(node -p "require('./package.json').version")
@@ -192,12 +223,12 @@ npm publish --tag $TAG
192
223
 
193
224
  ## CHANGELOG 格式
194
225
 
195
- ### Beta 發布格式
226
+ ### Beta 发布格式
196
227
 
197
228
  ```markdown
198
229
  ## [X.Y.Z-beta.N] - YYYY-MM-DD
199
230
 
200
- > ⚠️ **Beta 發布**:这是测试版本。
231
+ > ⚠️ **Beta 发布**:这是测试版本。
201
232
 
202
233
  ### Added
203
234
  - 功能描述
@@ -206,13 +237,13 @@ npm publish --tag $TAG
206
237
  - 错误修正描述
207
238
  ```
208
239
 
209
- ### 穩定發布格式
240
+ ### 稳定发布格式
210
241
 
211
242
  ```markdown
212
243
  ## [X.Y.Z] - YYYY-MM-DD
213
244
 
214
245
  ### Added
215
- - 功能描述及詳情
246
+ - 功能描述及详情
216
247
 
217
248
  ### Changed
218
249
  - 变更描述
@@ -225,51 +256,54 @@ npm publish --tag $TAG
225
256
 
226
257
  ## 版本编号策略
227
258
 
228
- 遵循[語義化版本](https://semver.org/):
259
+ 遵循[语义化版本](https://semver.org/):
229
260
 
230
- | 变更类型 | 版本递增 | 範例 |
261
+ | 变更类型 | 版本递增 | 示例 |
231
262
  |---------|---------|------|
232
- | 破壞性变更 | MAJOR | 2.9.5 → 3.0.0 |
233
- | 新功能(向後相容) | MINOR | 3.1.5 → 3.2.0 |
234
- | 错误修正(向後相容) | PATCH | 3.2.0 → 3.2.1 |
235
- | 预發布 | 新增後綴 | 3.2.1 → 3.2.1-beta.1 |
263
+ | 破坏性变更 | MAJOR | 2.9.5 → 3.0.0 |
264
+ | 新功能(向后兼容) | MINOR | 3.1.5 → 3.2.0 |
265
+ | 错误修正(向后兼容) | PATCH | 3.2.0 → 3.2.1 |
266
+ | 预发布 | 新增后缀 | 3.2.1 → 3.2.1-beta.1 |
236
267
 
237
268
  ---
238
269
 
239
- ## 疑難排解
270
+ ## 故障排除
240
271
 
241
272
  ### npm Tag 错误
242
273
 
243
- 如果使用错误的标签發布:
274
+ 如果使用错误的标签发布:
244
275
 
245
276
  ```bash
246
277
  npm dist-tag add <package>@<version> <correct-tag>
247
278
  ```
248
279
 
249
- ### 需要撤回發布
280
+ ### 需要撤回发布
250
281
 
251
282
  ```bash
252
- # 选项 1:棄用
283
+ # 选项 1:弃用
253
284
  npm deprecate <package>@<version> "Please use <new-version> instead"
254
285
 
255
- # 选项 2:取消發布(僅限 72 小时內)
286
+ # 选项 2:取消发布(仅限 72 小时内)
256
287
  npm unpublish <package>@<version>
257
288
 
258
- # 选项 3:發布修補版本
289
+ # 选项 3:发布补丁版本
259
290
  npm version patch
260
291
  ```
261
292
 
262
293
  ---
263
294
 
264
- ## 预發布检查清单
295
+ ## 预发布检查清单
265
296
 
266
- ### 通用检查
297
+ ### 通用检查(所有发布)
267
298
 
268
- - [ ] 所有测试通過
269
- - [ ] Linting 通過
270
- - [ ] Git 工作目录乾淨
271
- - [ ] CHANGELOG 已更新
272
- - [ ] 在正确的分支(穩定版用 main)
299
+ - [ ] 在正确的分支(稳定版用 main)
300
+ - [ ] Git 工作目录干净
301
+ - [ ] 所有必要文件中的版本已更新
302
+ - [ ] CHANGELOG 已更新发布说明
303
+ - [ ] 所有测试通过
304
+ - [ ] Linting 通过
305
+ - [ ] 构建成功
306
+ - [ ] 核心功能正常(冒烟测试)
273
307
  - [ ] 生成的文档已是最新版本(如适用)
274
308
 
275
309
  ### 文档同步验证
@@ -286,23 +320,23 @@ npm version patch
286
320
  - README 反映新功能
287
321
  - 迁移指南完整(如适用)
288
322
 
289
- ### Beta 發布前
323
+ ### Beta 发布前
290
324
 
291
325
  - [ ] 通用检查完成
292
- - [ ] 已知問題已记录
326
+ - [ ] 已知问题已记录在 CHANGELOG 中
293
327
 
294
- ### 穩定發布前
328
+ ### 稳定发布前
295
329
 
296
330
  - [ ] 通用检查完成
297
- - [ ] Beta 测试完成(如適用)
298
- - [ ] 無嚴重错误
299
- - [ ] 已建立迁移指南(如有破壞性变更)
331
+ - [ ] Beta 测试完成(如适用)
332
+ - [ ] 无严重错误
333
+ - [ ] 已创建迁移指南(如有破坏性变更)
300
334
 
301
335
  ---
302
336
 
303
337
  ## 项目特有配置
304
338
 
305
- 项目特有的發布需求請在 `CLAUDE.md` 中定義:
339
+ 项目特有的发布需求请在 `CLAUDE.md` 文件中定义:
306
340
 
307
341
  ```markdown
308
342
  ## Release Process (Project-Specific)
@@ -323,29 +357,29 @@ npm version patch
323
357
  - Custom verification step 2
324
358
  ```
325
359
 
326
- 这讓 AI 助手在执行 `/release` 指令时自动套用项目特有規則。
360
+ 这让 AI 助手在执行 `/release` 命令时自动应用项目特有规则。
327
361
 
328
362
  ---
329
363
 
330
- ## AI 助理指南
364
+ ## AI 助手指南
331
365
 
332
- 協助發布时:
366
+ 协助发布时:
333
367
 
334
- 1. **識别發布类型:** 詢問是 beta、alpha、rc 或穩定版
335
- 2. **执行预發布检查:** 测试、linting、git 状态
336
- 3. **检查项目特有規則:** 阅读 `CLAUDE.md` 取得額外需求
368
+ 1. **识别发布类型:** 询问是 beta、alpha、rc 或稳定版
369
+ 2. **执行预发布检查:** 测试、linting、git 状态
370
+ 3. **检查项目特有规则:** 阅读 `CLAUDE.md` 获取额外需求
337
371
  4. **验证文档同步:** 确保生成的文档与源文件一致
338
- 5. **更新版本:** 使用適當的版本指令
372
+ 5. **更新版本:** 使用适当的版本命令
339
373
  6. **更新 CHANGELOG:** 遵循标准格式
340
- 7. **建立 git tag:** 格式 `v{VERSION}`
341
- 8. **建立 release:** GitHub/GitLab release
342
- 9. **验证發布:** 检查 dist-tags 并测试安裝
374
+ 7. **创建 git tag:** 格式 `v{VERSION}`
375
+ 8. **创建 release:** GitHub/GitLab release
376
+ 9. **验证发布:** 检查 dist-tags 并测试安装
343
377
 
344
378
  ---
345
379
 
346
- ## 相关文件
380
+ ## 相关文档
347
381
 
348
- - [語義化版本指南](./semantic-versioning.md)
382
+ - [语义化版本指南](./semantic-versioning.md)
349
383
  - [Changelog 格式](./changelog-format.md)
350
384
 
351
385
  ---
@@ -354,11 +388,13 @@ npm version patch
354
388
 
355
389
  | 版本 | 日期 | 变更 |
356
390
  |------|------|------|
357
- | 2.0.0 | 2026-01-14 | 重構为通用指南,项目特有内容移至 CLAUDE.md |
358
- | 1.0.0 | 2026-01-02 | 初始發布流程指南 |
391
+ | 2.2.0 | 2026-01-26 | 简化为通用的 Beta→Stable 流程;Alpha→Beta→Stable 移至项目特有配置 |
392
+ | 2.1.0 | 2026-01-26 | 采用“先定版本”流程:更新版本 → 测试 → 验证 → 发布 |
393
+ | 2.0.0 | 2026-01-14 | 重构为通用指南,项目特有内容移至 CLAUDE.md |
394
+ | 1.0.0 | 2026-01-02 | 初始发布流程指南 |
359
395
 
360
396
  ---
361
397
 
362
398
  ## 授权
363
399
 
364
- 本文件以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权發布。
400
+ 本文档以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权发布。