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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (712) hide show
  1. package/bin/uds.js +12 -1
  2. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  3. package/bundled/ai/standards/commit-message.ai.yaml +12 -2
  4. package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
  5. package/bundled/core/commit-message-guide.md +22 -19
  6. package/bundled/core/secret-management-standards.md +13 -1
  7. package/bundled/extensions/locales/zh-tw.md +19 -19
  8. package/bundled/hooks/validate-commit-msg.mjs +52 -9
  9. package/bundled/locales/zh-CN/CHANGELOG.md +2312 -1102
  10. package/bundled/locales/zh-CN/CLAUDE.md +987 -101
  11. package/bundled/locales/zh-CN/README.md +3 -3
  12. package/bundled/locales/zh-CN/SECURITY.md +3 -3
  13. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  14. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
  15. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  16. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
  17. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
  18. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
  19. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
  20. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  21. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  22. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  23. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  24. package/bundled/locales/zh-CN/core/accessibility-standards.md +871 -62
  25. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  26. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  27. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  28. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  29. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  30. package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +311 -72
  31. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  32. package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
  33. package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
  34. package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
  35. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  36. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  37. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  38. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  39. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  40. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  41. package/bundled/locales/zh-CN/core/changelog-standards.md +485 -63
  42. package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
  43. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  44. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  45. package/bundled/locales/zh-CN/core/code-review-checklist.md +37 -23
  46. package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
  47. package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
  48. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  49. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  50. package/bundled/locales/zh-CN/core/deprecation-standards.md +155 -40
  51. package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
  52. package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
  53. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  54. package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
  55. package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
  56. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  57. package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
  58. package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
  59. package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
  60. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  61. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  62. package/bundled/locales/zh-CN/core/feature-flag-standards.md +202 -57
  63. package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
  64. package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
  65. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  66. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  67. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  68. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  69. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  70. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  71. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  72. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  73. package/bundled/locales/zh-CN/core/mutation-testing.md +45 -6
  74. package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
  75. package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
  76. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  77. package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
  78. package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
  79. package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
  80. package/bundled/locales/zh-CN/core/project-structure.md +550 -170
  81. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  82. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  83. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  84. package/bundled/locales/zh-CN/core/retrospective-standards.md +215 -22
  85. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  86. package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
  87. package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
  88. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  89. package/bundled/locales/zh-CN/core/security-standards.md +169 -16
  90. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  91. package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
  92. package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
  93. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  94. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  95. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  96. package/bundled/locales/zh-CN/core/supply-chain-security-standards.md +159 -32
  97. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  98. package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
  99. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  100. package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
  101. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  102. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  103. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  104. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  105. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  106. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  107. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  108. package/bundled/locales/zh-CN/core/versioning.md +737 -73
  109. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  110. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  111. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  112. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +2 -1
  113. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  114. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
  115. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
  116. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  117. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
  118. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  119. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
  120. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  121. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  122. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +2 -0
  123. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  124. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  125. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  126. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  127. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  128. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  129. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  130. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  131. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  132. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  133. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  134. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  135. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  136. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  137. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  138. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  139. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  140. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  141. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  142. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  143. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  144. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  145. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  146. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  147. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  148. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  149. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  150. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  151. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  152. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  153. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  154. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  155. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  156. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  157. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  158. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  159. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  160. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  161. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  162. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  163. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  164. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  165. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  166. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  167. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  168. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  169. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  170. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  171. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  172. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  173. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  174. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  175. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  176. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  177. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  178. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  179. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  180. package/bundled/locales/zh-CN/skills/README.md +2 -1
  181. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  182. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  183. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  184. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  185. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  186. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  187. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  188. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  189. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  190. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  191. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  192. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  193. package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +217 -137
  194. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  195. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  196. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  197. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  198. package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +148 -132
  199. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  200. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  201. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  202. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  203. package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +122 -121
  204. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  205. package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
  206. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  207. package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
  208. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  209. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  210. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  211. package/bundled/locales/zh-CN/skills/code-review-assistant/guide.md +119 -45
  212. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  213. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  214. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  215. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  216. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  217. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  218. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  219. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  220. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  221. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  222. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  223. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  224. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  225. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  226. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  227. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  228. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  229. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  230. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  231. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  232. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  233. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  234. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  235. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  236. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  237. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  238. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  239. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  240. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  241. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  242. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  243. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  244. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  245. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  246. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  247. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  248. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  249. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  250. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  251. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  252. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  253. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  254. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  255. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  256. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  257. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  258. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  259. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  260. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  261. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +4 -4
  262. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  263. package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
  264. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  265. package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
  266. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  267. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  268. package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +4 -2
  269. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  270. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  271. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  272. package/bundled/locales/zh-CN/skills/docs-generator/guide.md +8 -7
  273. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  274. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  275. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  276. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  277. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  278. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  279. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  280. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  281. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  282. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  283. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  284. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  285. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  286. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  287. package/bundled/locales/zh-CN/skills/project-discovery/guide.md +158 -157
  288. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  289. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  290. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  291. package/bundled/locales/zh-CN/skills/refactoring-assistant/guide.md +172 -171
  292. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  293. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  294. package/bundled/locales/zh-CN/skills/release-standards/guide.md +51 -43
  295. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  296. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  297. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  298. package/bundled/locales/zh-CN/skills/requirement-assistant/guide.md +88 -79
  299. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  300. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  301. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  302. package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +2 -2
  303. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  304. package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
  305. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  306. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  307. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  308. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  309. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  310. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  311. package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +2 -2
  312. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  313. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  314. package/bundled/locales/zh-CN/skills/tdd-assistant/guide.md +217 -156
  315. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  316. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  317. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  318. package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +25 -12
  319. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  320. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  321. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  322. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  323. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  324. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  325. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  326. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  327. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  328. package/bundled/locales/zh-TW/CHANGELOG.md +2291 -1110
  329. package/bundled/locales/zh-TW/CLAUDE.md +962 -76
  330. package/bundled/locales/zh-TW/README.md +3 -3
  331. package/bundled/locales/zh-TW/SECURITY.md +3 -3
  332. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  333. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
  334. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  335. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
  336. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
  337. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
  338. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
  339. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  340. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  341. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  342. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  343. package/bundled/locales/zh-TW/core/accessibility-standards.md +895 -46
  344. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  345. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  346. package/bundled/locales/zh-TW/core/agent-dispatch.md +102 -33
  347. package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
  348. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  349. package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
  350. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  351. package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
  352. package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
  353. package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
  354. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  355. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  356. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  357. package/bundled/locales/zh-TW/core/branch-completion.md +130 -34
  358. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  359. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  360. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  361. package/bundled/locales/zh-TW/core/chaos-engineering-standards.md +138 -36
  362. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  363. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  364. package/bundled/locales/zh-TW/core/code-review-checklist.md +19 -7
  365. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  366. package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
  367. package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
  368. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  369. package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
  370. package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
  371. package/bundled/locales/zh-TW/core/developer-memory.md +102 -12
  372. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  373. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  374. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  375. package/bundled/locales/zh-TW/core/environment-standards.md +250 -72
  376. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  377. package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
  378. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  379. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  380. package/bundled/locales/zh-TW/core/feature-flag-standards.md +202 -57
  381. package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
  382. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  383. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  384. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  385. package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +234 -487
  386. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  387. package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
  388. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  389. package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
  390. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  391. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  392. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  393. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  394. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  395. package/bundled/locales/zh-TW/core/observability-standards.md +284 -40
  396. package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
  397. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  398. package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
  399. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  400. package/bundled/locales/zh-TW/core/project-context-memory.md +210 -31
  401. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  402. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  403. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  404. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  405. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  406. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  407. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  408. package/bundled/locales/zh-TW/core/runbook-standards.md +296 -23
  409. package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
  410. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  411. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  412. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  413. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  414. package/bundled/locales/zh-TW/core/slo-standards.md +301 -49
  415. package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
  416. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  417. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  418. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  419. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  420. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  421. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  422. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  423. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  424. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  425. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  426. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  427. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  428. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  429. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  430. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  431. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  432. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  433. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  434. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  435. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +2 -1
  436. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  437. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
  438. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  439. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
  440. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  441. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
  442. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  443. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
  444. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  445. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  446. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +2 -0
  447. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  448. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  449. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  450. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  451. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  452. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  453. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  454. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  455. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  456. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  457. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  458. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  459. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  460. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  461. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  462. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  463. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  464. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  465. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  466. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  467. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  468. package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +584 -475
  469. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  470. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  471. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  472. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  473. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  474. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  475. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  476. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  477. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  478. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  479. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  480. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  481. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  482. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  483. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  484. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  485. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  486. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  487. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  488. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  489. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  490. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  491. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  492. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  493. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  494. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  495. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  496. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  497. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  498. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  499. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  500. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  501. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  502. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  503. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  504. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  505. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  506. package/bundled/locales/zh-TW/skills/README.md +2 -1
  507. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  508. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  509. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  510. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  511. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  512. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  513. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  514. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  515. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  516. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  517. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  518. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  519. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  520. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  521. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  522. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  523. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  524. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  525. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  526. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  527. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  528. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  529. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  530. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  531. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  532. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  533. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  534. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  535. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  536. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  537. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  538. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  539. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  540. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  541. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  542. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  543. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  544. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  545. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  546. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  547. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  548. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  549. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  550. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  551. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  552. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  553. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  554. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  555. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  556. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  557. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  558. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  559. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  560. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  561. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  562. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  563. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  564. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  565. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  566. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  567. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  568. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  569. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  570. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  571. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  572. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  573. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  574. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  575. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  576. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  577. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  578. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  579. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  580. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  581. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  582. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  583. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  584. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  585. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  586. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  587. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  588. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  589. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  590. package/bundled/locales/zh-TW/skills/commit-standards/guide.md +137 -17
  591. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  592. package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
  593. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  594. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  595. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  596. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  597. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  598. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  599. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  600. package/bundled/locales/zh-TW/skills/docs-generator/guide.md +4 -3
  601. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  602. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  603. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  604. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  605. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  606. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  607. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  608. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  609. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  610. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  611. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  612. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  613. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  614. package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +85 -18
  615. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  616. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  617. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  618. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  619. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  620. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  621. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  622. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  623. package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +91 -45
  624. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  625. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  626. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  627. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  628. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  629. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  630. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  631. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  632. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  633. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  634. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  635. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  636. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  637. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  638. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  639. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  640. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  641. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  642. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  643. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  644. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  645. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  646. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  647. package/bundled/locales/zh-TW/skills/tdd-assistant/language-examples.md +693 -47
  648. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  649. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  650. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  651. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  652. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  653. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  654. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  655. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  656. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  657. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  658. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  659. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  660. package/bundled/skills/.claude-plugin/plugin.json +71 -0
  661. package/bundled/skills/commit-standards/SKILL.md +2 -2
  662. package/bundled/skills/commit-standards/guide.md +3 -2
  663. package/bundled/skills/commit-standards/language-options.md +19 -17
  664. package/package.json +2 -2
  665. package/src/commands/audit.js +28 -1
  666. package/src/commands/check.js +77 -7
  667. package/src/commands/compile.js +37 -4
  668. package/src/commands/config.js +49 -24
  669. package/src/commands/init.js +78 -30
  670. package/src/commands/open-work.js +6 -2
  671. package/src/commands/release-messages.js +228 -0
  672. package/src/commands/release.js +127 -68
  673. package/src/commands/run-intent.js +11 -0
  674. package/src/commands/spec-split.js +2 -1
  675. package/src/commands/spec.js +11 -2
  676. package/src/commands/update.js +184 -30
  677. package/src/compilers/claude-code-compiler.js +9 -1
  678. package/src/config/ai-agent-paths.js +14 -1
  679. package/src/core/installed-formats.js +15 -0
  680. package/src/core/open-work-config.js +20 -1
  681. package/src/core/project-config.js +55 -0
  682. package/src/i18n/messages.js +160 -2
  683. package/src/installers/hooks-installer.js +1 -1
  684. package/src/installers/manifest-installer.js +1 -1
  685. package/src/installers/skills-installer.js +1 -1
  686. package/src/installers/standards-installer.js +3 -1
  687. package/src/mcp/server.js +9 -3
  688. package/src/prompts/init.js +26 -22
  689. package/src/reconciler/actual-state-scanner.js +2 -8
  690. package/src/reconciler/backup-locations.js +5 -0
  691. package/src/reconciler/backup-manager.js +19 -11
  692. package/src/reconciler/desired-state-calculator.js +89 -57
  693. package/src/reconciler/plan-executor.js +101 -8
  694. package/src/reconciler/recorded-versions.js +49 -0
  695. package/src/reconciler/relative-path.js +23 -0
  696. package/src/uninstallers/hook-uninstaller.js +9 -1
  697. package/src/uninstallers/skills-uninstaller.js +22 -3
  698. package/src/utils/available-standards-report.js +25 -4
  699. package/src/utils/available-standards.js +13 -3
  700. package/src/utils/build-manifest.js +1 -1
  701. package/src/utils/commit-message-judge.js +60 -13
  702. package/src/utils/friction-detector.js +23 -11
  703. package/src/utils/git-hooks.js +106 -4
  704. package/src/utils/integration-generator.js +95 -67
  705. package/src/utils/legacy-hook-migration.js +121 -2
  706. package/src/utils/open-work-tracking.mjs +105 -16
  707. package/src/utils/sdd-header.js +16 -4
  708. package/src/utils/skills-installer.js +2 -1
  709. package/src/utils/spinner.js +14 -4
  710. package/src/utils/standard-validator.js +3 -2
  711. package/standards-registry.json +10 -8
  712. package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
@@ -1,8 +1,9 @@
1
1
  ---
2
- source: ../../../../skills/refactoring-assistant/SKILL.md
2
+ source: ../../../../skills/refactoring-assistant/guide.md
3
3
  source_version: 2.0.0
4
4
  translation_version: 2.0.0
5
- last_synced: 2026-01-21
5
+ last_synced: 2026-10-16
6
+ source_hash: 40b6adf241b1
6
7
  status: current
7
8
  description: |
8
9
  引导重构决策和大规模代码改进。
@@ -12,7 +13,7 @@ description: |
12
13
 
13
14
  # 重构助手
14
15
 
15
- > **语言**: [English](../../../../skills/refactoring-assistant/SKILL.md) | 简体中文
16
+ > **语言**: [English](../../../../skills/refactoring-assistant/guide.md) | [繁體中文](../../../zh-TW/skills/refactoring-assistant/guide.md) | 简体中文
16
17
 
17
18
  **版本**: 2.0.0
18
19
  **最后更新**: 2026-01-21
@@ -29,237 +30,237 @@ description: |
29
30
  ## 快速参考(YAML 压缩格式)
30
31
 
31
32
  ```yaml
32
- # === 决策:重构 vs 重写 ===
33
+ # === DECISION: Refactor vs Rewrite ===
33
34
  decision_tree:
34
- - q: "代码在生产环境运行?"
35
- n: "→ 考虑重写(风险较低)"
35
+ - q: "Code in production?"
36
+ n: "→ Consider rewrite (lower risk)"
36
37
  y: next
37
- - q: "了解代码的功能?"
38
- n: "→ 先写特征测试"
38
+ - q: "Understand what code does?"
39
+ n: "→ Characterization tests first"
39
40
  y: next
40
- - q: "测试覆盖率 >60%?"
41
- n: "→ 先补测试"
41
+ - q: "Test coverage >60%?"
42
+ n: "→ Add tests first"
42
43
  y: next
43
- - q: "核心架构可修复?"
44
- n: "→ Strangler Fig 模式"
45
- y: "→ 增量重构 ✓"
44
+ - q: "Core architecture salvageable?"
45
+ n: "→ Strangler Fig pattern"
46
+ y: "→ Incremental Refactoring ✓"
46
47
 
47
48
  comparison_matrix:
48
- favor_refactor: [大型代码库, 良好测试, 业务关键, 团队熟悉, 架构健全, 时间紧迫, 低风险]
49
- favor_rewrite: [小型独立, 无测试, 可容忍停机, 无人熟悉, 架构有缺陷, 时间充裕, 较高风险]
49
+ favor_refactor: [large_codebase, good_tests, business_critical, team_knows_code, sound_arch, tight_deadline, low_risk]
50
+ favor_rewrite: [small_isolated, no_tests, can_tolerate_downtime, no_knowledge, flawed_arch, flexible_time, higher_risk]
50
51
 
51
- # === 警告:第二系统效应 ===
52
+ # === WARNING: Second-System Effect ===
52
53
  rewrite_antipatterns:
53
- - "加入原本没有的功能"
54
- - "为未来弹性过度抽象"
55
- - "忽略现有系统的经验教训"
56
- quote: "第二个系统是一个人设计过最危险的系统。— Fred Brooks"
54
+ - "Adding features not in original"
55
+ - "Over-abstracting for future flexibility"
56
+ - "Ignoring lessons from existing system"
57
+ quote: "The second system is the most dangerous system a person ever designs. — Fred Brooks"
57
58
 
58
- # === 战术性策略:日常重构 ===
59
+ # === TACTICAL: Daily Refactoring Strategies ===
59
60
  tactical:
60
61
  preparatory_refactoring:
61
- definition: "在新增功能前调整结构,让改变更容易"
62
- quote: "先把改变变容易(这可能很难),然后再做那个容易的改变。— Kent Beck"
63
- when: [功能被阻挡, 降低阻力, 即将变更]
62
+ definition: "Restructure code to make upcoming change easier"
63
+ quote: "First make the change easy (this might be hard), then make the easy change. — Kent Beck"
64
+ when: [feature_blocked, reduce_friction, upcoming_changes]
64
65
  workflow:
65
- 1: "识别要做的改变"
66
- 2: "识别是什么让改变困难"
67
- 3: "重构以让改变变容易"
68
- 4: "做那个(现在变容易的)改变"
66
+ 1: "Identify the change you want to make"
67
+ 2: "Identify what makes this change difficult"
68
+ 3: "Refactor to make the change easy"
69
+ 4: "Make the (now easy) change"
69
70
  principles:
70
- - "预备性重构与功能分开提交"
71
- - "每一步都维持测试通过"
72
- - "不要混合重构与功能工作"
71
+ - "Preparatory refactoring is separate commit from feature"
72
+ - "Each step maintains passing tests"
73
+ - "Don't combine refactoring with feature work"
73
74
 
74
75
  boy_scout_rule:
75
- definition: "离开时让代码比来时更干净(机会主义重构)"
76
- quote: "离开营地时,让它比你来的时候更干净。— Robert C. Martin"
77
- when: [任何维护, Bug修复, 功能新增, 对抗熵]
76
+ definition: "Leave code cleaner than you found it (opportunistic refactoring)"
77
+ quote: "Leave the campground cleaner than you found it. — Robert C. Martin"
78
+ when: [any_maintenance, bug_fixes, feature_additions, fighting_entropy]
78
79
  guidelines:
79
- - "只做小改进(分钟,不是小时)"
80
- - "不改变行为"
81
- - "不破坏现有测试"
82
- - "保持范围在当前任务内"
80
+ - "Only small improvements (minutes, not hours)"
81
+ - "Don't change behavior"
82
+ - "Don't break existing tests"
83
+ - "Keep scope within current task"
83
84
  examples:
84
- - "重新命名令人困惑的变量"
85
- - "将几行代码提取为命名良好的方法"
86
- - "移除死代码"
87
- - "加入澄清注释"
85
+ - "Rename confusingly-named variable"
86
+ - "Extract lines into well-named method"
87
+ - "Remove dead code"
88
+ - "Add clarifying comment"
88
89
  antipatterns:
89
- - "把 Bug 修复变成大重构"
90
- - "重构不相关的代码"
91
- - "没有测试覆盖就修改"
92
- - "范围蔓延超出原始任务"
90
+ - "Turning bug fix into major refactoring"
91
+ - "Refactoring unrelated code"
92
+ - "Changes without test coverage"
93
+ - "Scope creep beyond original task"
93
94
 
94
95
  red_green_refactor:
95
- definition: "TDD 重构阶段"
96
- duration: "每循环 5-15 分钟"
97
- scope: "单一方法/类"
98
- techniques: [提取方法, 重新命名, 内联变量, 替换魔术数字]
99
- reference: "→ 见 TDD 标准"
96
+ definition: "TDD refactoring phase"
97
+ duration: "5-15 min per cycle"
98
+ scope: "single method/class"
99
+ techniques: [extract_method, rename, inline_var, replace_magic_number]
100
+ reference: "→ See TDD Standards"
100
101
 
101
- # === 战略性策略:架构重构 ===
102
+ # === STRATEGIC: Architectural Refactoring ===
102
103
  strategic:
103
104
  strangler_fig:
104
- definition: "逐步将功能路由到新系统,渐进替换旧系统"
105
- origin: "命名自绞杀榕树"
105
+ definition: "Gradually replace legacy by routing to new system"
106
+ origin: "Named after strangler fig trees"
106
107
  phases:
107
- 1_拦截: "请求 → 门面 → 旧系统(100%)"
108
- 2_迁移: "请求 → 门面 → [新系统(功能), 旧系统(其余)]"
109
- 3_完成: "请求 → 新系统(100%) [旧系统下线]"
108
+ 1_intercept: "Request → Facade → Legacy(100%)"
109
+ 2_migrate: "Request → Facade → [New(Feature), Legacy(Rest)]"
110
+ 3_complete: "Request → New(100%) [Legacy decommissioned]"
110
111
  checklist:
111
- - "识别拦截点"
112
- - "建立事件捕获层"
113
- - "在新系统实现第一个功能"
114
- - "渐进式路由流量"
115
- - "监控并比较"
116
- - "下线旧系统"
112
+ - "Identify interception point"
113
+ - "Create event capture layer"
114
+ - "Implement first feature in new"
115
+ - "Route traffic incrementally"
116
+ - "Monitor and compare"
117
+ - "Decommission legacy"
117
118
 
118
119
  anti_corruption_layer:
119
- definition: "防止遗留模型污染新系统的翻译层"
120
- origin: "Eric Evans, 领域驱动设计 (2003)"
120
+ definition: "Translation layer preventing legacy model from polluting new system"
121
+ origin: "Eric Evans, Domain-Driven Design (2003)"
121
122
  when:
122
- - "新旧系统必须共存并互动"
123
- - "遗留系统有混乱的领域模型"
124
- - "保护新系统的限界上下文"
123
+ - "New and legacy must coexist and interact"
124
+ - "Legacy has chaotic domain model"
125
+ - "Protecting new system's Bounded Context"
125
126
  components:
126
- facade: "简化复杂的遗留接口"
127
- adapter: "将遗留数据转换为新领域模型"
128
- translator: "映射遗留术语到通用语言"
127
+ facade: "Simplifies complex legacy interfaces"
128
+ adapter: "Converts legacy data to new domain model"
129
+ translator: "Maps legacy terminology to ubiquitous language"
129
130
  checklist:
130
- - "定义清晰的 ACL 接口"
131
- - "映射遗留实体到新模型"
132
- - "处理数据格式转换"
133
- - "实现错误翻译"
134
- - "加入日志以便调试"
135
- - "彻底测试 ACL 隔离性"
131
+ - "Define clear ACL interface"
132
+ - "Map legacy entities to new model"
133
+ - "Handle data format conversions"
134
+ - "Implement error translation"
135
+ - "Add logging for debugging"
136
+ - "Test ACL isolation thoroughly"
136
137
  vs_strangler:
137
- strangler: "目标是取代遗留"
138
- acl: "目标是与遗留共存"
138
+ strangler: "Goal is to replace legacy"
139
+ acl: "Goal is to coexist with legacy"
139
140
 
140
141
  branch_by_abstraction:
141
142
  steps:
142
- 1: "客户端 → 抽象(接口) → 旧实现"
143
- 2: "客户端 → 抽象 → [旧实现, 新实现(切换)]"
144
- 3: "客户端 → 新实现 [旧实现已移除]"
145
- principles: [所有变更在主干, 功能开关, 过渡期共存]
143
+ 1: "Client → Abstraction(interface) → OldImpl"
144
+ 2: "Client → Abstraction → [OldImpl, NewImpl(toggled)]"
145
+ 3: "Client → NewImpl [OldImpl removed]"
146
+ principles: [all_changes_on_trunk, feature_toggles, coexist_during_transition]
146
147
 
147
148
  parallel_change:
148
149
  aka: "Expand-Migrate-Contract"
149
150
  phases:
150
- expand: "新增新的在旧的旁边,新代码用新的,旧的仍运作"
151
- migrate: "更新所有客户端用新的,验证,数据迁移"
152
- contract: "移除旧的,清理,更新文档"
151
+ expand: "Add new alongside old, new code uses new, old still works"
152
+ migrate: "Update all clients to new, verify, data migration"
153
+ contract: "Remove old, clean up, update docs"
153
154
 
154
- # === 安全策略:遗留代码 ===
155
+ # === SAFETY: Legacy Code Strategies ===
155
156
  safety:
156
157
  legacy:
157
- definition: "没有测试的代码(不论年龄)"
158
- dilemma: "安全修改需要测试 → 加测试需要修改代码"
159
- solution: "使用安全技术先加测试"
158
+ definition: "Code without tests (regardless of age)"
159
+ dilemma: "Need tests to change safely → Need to change to add tests"
160
+ solution: "Safe techniques to add tests first"
160
161
 
161
162
  characterization_tests:
162
- purpose: "捕捉现有行为(非验证正确性)"
163
+ purpose: "Capture existing behavior (not verify correctness)"
163
164
  process:
164
- 1: "调用要理解的代码"
165
- 2: "写预期会失败的断言"
166
- 3: "执行,观察实际结果"
167
- 4: "更新断言以匹配实际行为"
168
- 5: "重复直到涵盖需要修改的行为"
169
- principle: "记录代码做什么,而非应该做什么"
165
+ 1: "Call code to understand"
166
+ 2: "Write assertion expected to FAIL"
167
+ 3: "Run, see actual result"
168
+ 4: "Update assertion to match actual"
169
+ 5: "Repeat until behavior covered"
170
+ principle: "Document what code DOES, not what it SHOULD do"
170
171
 
171
172
  scratch_refactoring:
172
- definition: "为了理解而重构,舍弃所有变更"
173
+ definition: "Refactor to understand, discard all changes"
173
174
  workflow:
174
- 1: "建立探针分支(或 git stash)"
175
- 2: "大胆重构以理解"
176
- 3: "记录学到的内容"
177
- 4: "舍弃变更(git reset --hard)"
178
- 5: "应用学习编写特征测试"
179
- when: [代码太复杂, 无文档, 需要快速建立心智模型]
180
- principle: "目标是理解,不是整洁代码"
175
+ 1: "Create scratch branch (or git stash)"
176
+ 2: "Aggressively refactor to understand"
177
+ 3: "Take notes on learnings"
178
+ 4: "Discard changes (git reset --hard)"
179
+ 5: "Apply learnings to write characterization tests"
180
+ when: [code_too_complex, no_docs, need_mental_model_fast]
181
+ principle: "Goal is understanding, not clean code"
181
182
 
182
183
  seams:
183
- definition: "可以在不编辑代码的情况下改变行为的地方"
184
- object: "通过多态覆写(注入测试替身)"
185
- preprocessing: "编译时替换(宏)"
186
- link: "链接时替换(DI,模块替换)"
184
+ definition: "Place to alter behavior without editing code"
185
+ object: "Override via polymorphism (inject test double)"
186
+ preprocessing: "Compile-time substitution (macros)"
187
+ link: "Replace at link time (DI, module replacement)"
187
188
 
188
189
  sprout_wrap:
189
- sprout_method: "新逻辑 → 建立新方法,从旧的调用"
190
- sprout_class: "新逻辑独立演进 → 新类"
191
- wrap_method: "加入前后行为 → 重命名原方法,建立包装器"
192
- wrap_class: "装饰现有 → 装饰者模式"
193
- principle: "新代码用 TDD;遗留代码在测试前保持不动"
190
+ sprout_method: "New logic → create new method, call from old"
191
+ sprout_class: "New logic evolves independently → new class"
192
+ wrap_method: "Add before/after → rename original, create wrapper"
193
+ wrap_class: "Decorate existing → decorator pattern"
194
+ principle: "New code uses TDD; legacy untouched until tested"
194
195
 
195
- # === 数据库:重构 ===
196
+ # === DATABASE: Refactoring ===
196
197
  db_expand_contract:
197
- expand: "新增新列/表,应用程序同时写入,可安全回滚"
198
- migrate: "复制数据,验证一致性,应用程序从新的读取"
199
- contract: "确认旧的未使用,移除旧的,清理双写"
198
+ expand: "Add new column/table, app writes BOTH, safe to rollback"
199
+ migrate: "Copy data, verify consistency, app reads from new"
200
+ contract: "Confirm old unused, remove old, cleanup dual-write"
200
201
 
201
202
  db_scenarios:
202
- rename_column: {strategy: "新增→迁移→删除", risk: 中}
203
- split_table: {strategy: "新表+外键→迁移→调整", risk: 高}
204
- merge_tables: {strategy: "新表→合并→切换", risk: 高}
205
- change_datatype: {strategy: "新列→转换→切换", risk: 中}
206
- add_not_null: {strategy: "填默认→加约束", risk: 低}
207
-
208
- # === 工作流程:安全重构 ===
209
- before: [定义成功标准, "覆盖率>80%", 干净工作目录, 建立分支, 与团队沟通]
210
- during: [一次一个小变更, 每次变更后测试, 失败就恢复, 频繁提交, 不加新功能]
211
- after: [所有测试通过, 可衡量地更好, 文档已更新, 团队已审查, 没有新功能]
212
-
213
- # === 指标 ===
203
+ rename_column: {strategy: "add→migrate→drop", risk: medium}
204
+ split_table: {strategy: "new+FK→migrate→adjust", risk: high}
205
+ merge_tables: {strategy: "new→merge→switch", risk: high}
206
+ change_datatype: {strategy: "new_col→convert→switch", risk: medium}
207
+ add_not_null: {strategy: "fill_defaults→add_constraint", risk: low}
208
+
209
+ # === WORKFLOW: Safe Refactoring ===
210
+ before: [define_success_criteria, "coverage>80%", clean_working_dir, create_branch, communicate]
211
+ during: [one_small_change, test_after_every_change, revert_if_fail, commit_frequently, no_new_functionality]
212
+ after: [all_tests_pass, measurably_better, docs_updated, team_reviewed, no_new_functionality]
213
+
214
+ # === METRICS ===
214
215
  code_quality:
215
- cyclomatic_complexity: "每函数<10"
216
- cognitive_complexity: "越低越好"
217
- coupling: "降低"
218
- cohesion: "提高"
216
+ cyclomatic_complexity: "<10/function"
217
+ cognitive_complexity: "lower=better"
218
+ coupling: "reduce"
219
+ cohesion: "increase"
219
220
  duplication: "<3%"
220
221
 
221
222
  test_quality:
222
- coverage: "≥80%,不降低"
223
- speed: "重构后更快"
224
- flaky_count: "降低"
223
+ coverage: "≥80%, don't decrease"
224
+ speed: "faster after refactoring"
225
+ flaky_count: "decrease"
225
226
 
226
- # === 技术债管理 ===
227
+ # === TECHNICAL DEBT ===
227
228
  quadrant: # Martin Fowler
228
- prudent_deliberate: "我们知道这是债务"
229
- reckless_deliberate: "没时间做设计"
230
- prudent_inadvertent: "现在知道应该怎么做了"
231
- reckless_inadvertent: "什么是分层?"
229
+ prudent_deliberate: "We know this is debt"
230
+ reckless_deliberate: "No time for design"
231
+ prudent_inadvertent: "Now we know how we should have done it"
232
+ reckless_inadvertent: "What's layering?"
232
233
 
233
234
  priority:
234
- high: {criteria: "阻塞开发,频繁出错", action: "立即处理"}
235
- medium: {criteria: "拖慢开发,增加复杂度", action: "规划到下个迭代"}
236
- low: {criteria: "小麻烦,影响局部", action: "有机会就处理"}
235
+ high: {criteria: "blocks dev, frequent bugs", action: "address immediately"}
236
+ medium: {criteria: "slows dev, increases complexity", action: "plan next sprint"}
237
+ low: {criteria: "minor annoyance, isolated", action: "address opportunistically"}
237
238
 
238
239
  tracking:
239
- fields: [描述, 影响, 估计工作量, 忽视风险, 相关代码]
240
+ fields: [description, impact, estimated_effort, risk_if_ignored, related_code]
240
241
 
241
- # === 决策矩阵摘要 ===
242
+ # === DECISION MATRIX SUMMARY ===
242
243
  decision_matrix:
243
- - {strategy: "预备性重构", scale: "小", risk: "低", use: "降低功能开发阻力"}
244
- - {strategy: "童子军规则", scale: "极小", risk: "低", use: "持续偿债"}
245
- - {strategy: "红-绿-重构", scale: "小", risk: "低", use: "TDD 开发循环"}
246
- - {strategy: "绞杀榕", scale: "大", risk: "中", use: "系统汰换"}
247
- - {strategy: "防腐层", scale: "中", risk: "低", use: "新旧共存"}
248
- - {strategy: "抽象分支", scale: "大", risk: "中", use: "主干重构"}
249
- - {strategy: "平行变更", scale: "中", risk: "低", use: "接口/Schema 迁移"}
250
- - {strategy: "特征测试", scale: "—", risk: "—", use: "遗留重构的前置条件"}
251
- - {strategy: "探针式重构", scale: "小", risk: "低", use: "理解黑盒代码"}
252
-
253
- # === 策略选择 ===
244
+ - {strategy: "Preparatory Refactoring", scale: "Small", risk: "Low", use: "Reduce friction before feature work"}
245
+ - {strategy: "Boy Scout Rule", scale: "Very Small", risk: "Low", use: "Continuous debt repayment"}
246
+ - {strategy: "Red-Green-Refactor", scale: "Small", risk: "Low", use: "TDD development cycle"}
247
+ - {strategy: "Strangler Fig", scale: "Large", risk: "Medium", use: "System replacement"}
248
+ - {strategy: "Anti-Corruption Layer", scale: "Medium", risk: "Low", use: "New-legacy coexistence"}
249
+ - {strategy: "Branch by Abstraction", scale: "Large", risk: "Medium", use: "Trunk refactoring"}
250
+ - {strategy: "Parallel Change", scale: "Medium", risk: "Low", use: "Interface/schema migration"}
251
+ - {strategy: "Characterization Tests", scale: "—", risk: "—", use: "Prerequisite for legacy refactoring"}
252
+ - {strategy: "Scratch Refactoring", scale: "Small", risk: "Low", use: "Understanding black-box code"}
253
+
254
+ # === STRATEGY SELECTION ===
254
255
  selection_guide:
255
- 功能被混乱代码阻挡: "预备性重构"
256
- 在Bug修复中接触代码: "童子军规则"
257
- 用TDD写新代码: "红-绿-重构"
258
- 取代整个遗留系统: "绞杀榕"
259
- 整合遗留不被污染: "防腐层"
260
- 在主干重构共享代码: "抽象分支"
261
- 变更广泛使用的接口: "平行变更"
262
- 处理未测试的遗留: "特征测试 + 探针式重构 先做"
256
+ feature_blocked_by_messy_code: "Preparatory Refactoring"
257
+ touching_code_during_bug_fix: "Boy Scout Rule"
258
+ writing_new_code_with_tdd: "Red-Green-Refactor"
259
+ replacing_entire_legacy_system: "Strangler Fig"
260
+ integrating_without_pollution: "Anti-Corruption Layer"
261
+ refactoring_shared_code_on_trunk: "Branch by Abstraction"
262
+ changing_widely_used_interface: "Parallel Change"
263
+ working_with_untested_legacy: "Characterization Tests + Scratch Refactoring FIRST"
263
264
  ```
264
265
 
265
266
  ---
@@ -277,16 +278,16 @@ selection_guide:
277
278
  ## 详细指南
278
279
 
279
280
  完整标准请参阅:
280
- - [重构标准](../../../../core/refactoring-standards.md)
281
+ - [重构标准](../../core/refactoring-standards.md)
281
282
 
282
283
  ---
283
284
 
284
285
  ## 相关标准
285
286
 
286
- - [重构标准](../../../../core/refactoring-standards.md) - 核心标准
287
- - [测试驱动开发](../../../../core/test-driven-development.md) - TDD 重构阶段
288
- - [代码审查检查清单](../../../../core/code-review-checklist.md) - 重构 PR 审查
289
- - [签入标准](../../../../core/checkin-standards.md) - 提交前要求
287
+ - [重构标准](../../core/refactoring-standards.md) - 核心标准
288
+ - [测试驱动开发](../../core/test-driven-development.md) - TDD 重构阶段
289
+ - [代码审查检查清单](../../core/code-review-checklist.md) - 重构 PR 审查
290
+ - [签入标准](../../core/checkin-standards.md) - 提交前要求
290
291
  - [TDD 助手](../tdd-assistant/SKILL.md) - TDD 工作流程
291
292
 
292
293
  ---
@@ -2,7 +2,8 @@
2
2
  source: ../../../../skills/release-standards/SKILL.md
3
3
  source_version: 1.1.0
4
4
  translation_version: 1.2.0
5
- last_synced: 2026-08-17
5
+ last_synced: 2026-10-11
6
+ source_hash: e9e935fd95a0
6
7
  status: current
7
8
  description: |
8
9
  [UDS] 引导发布流程——语义化版本、发布模式,以及 start/finish/promote/deploy 的顺序。
@@ -19,34 +20,62 @@ description: |
19
20
 
20
21
  ## 子命令
21
22
 
22
- | 子命令 | 说明 | Description |
23
- |--------|------|-------------|
24
- | `start` | 开始发布流程 | Start a release branch/process |
25
- | `finish` | 完成发布(标签、合并) | Finalize release (tag, merge) |
26
- | `changelog` | 产生或更新变更日志 | Generate or update CHANGELOG.md |
27
- | `check` | 执行发布前检查 | Run pre-release verification |
23
+ | 子命令 | 模式 | 说明 |
24
+ |--------|------|------|
25
+ | `start` | All | 开始发布流程 |
26
+ | `finish` | CI/CD | 完成发布(标签、合并) |
27
+ | `promote` | Manual/Hybrid | RC → Stable 晋升 |
28
+ | `deploy` | Manual/Hybrid | 记录部署记录 |
29
+ | `manifest` | Manual/Hybrid | 生成打包信息清单(build-manifest.json) |
30
+ | `verify` | Manual/Hybrid | 验证清单一致性 |
31
+ | `changelog` | All | 生成或更新变更日志 |
32
+ | `check` | All | 执行发布前检查 |
33
+
34
+ ## 发布模式
35
+
36
+ 通过 `uds init` 或 `uds config --type release_mode` 配置:
37
+
38
+ | 模式 | 说明 |
39
+ |------|------|
40
+ | `ci-cd` | 通过 CI/CD 流水线自动发布(默认) |
41
+ | `manual` | 手动打包 + RC 工作流程 |
42
+ | `hybrid` | CI 构建产物 + 手动部署 |
28
43
 
29
44
  ## 版本类型
30
45
 
31
46
  | 类型 | 格式 | npm Tag | 用途 |
32
47
  |------|------|---------|------|
33
- | 正式版 | `X.Y.Z` | `@latest` | Stable |
34
- | 公开测试 | `X.Y.Z-beta.N` | `@beta` | Beta |
35
- | 内部测试 | `X.Y.Z-alpha.N` | `@alpha` | Alpha |
36
- | 候选版本 | `X.Y.Z-rc.N` | `@rc` | RC |
48
+ | Stable | `X.Y.Z` | `@latest` | 正式版 |
49
+ | Beta | `X.Y.Z-beta.N` | `@beta` | 公开测试 |
50
+ | Alpha | `X.Y.Z-alpha.N` | `@alpha` | 内部测试 |
51
+ | RC | `X.Y.Z-rc.N` | `@rc` | 候选版本 |
37
52
 
38
53
  ## 工作流程
39
54
 
40
55
  1. **决定版本** - 根据变更决定版本类型(MAJOR/MINOR/PATCH)
41
- 2. **更新版本文件** - 更新 package.json 和相关版本引用
42
- 3. **更新 CHANGELOG** - 将 [Unreleased] 条目移至新版本区段
43
- 4. **执行发布前检查** - 验证测试、lint 和标准合规
44
- 5. **建立 git tag** - 使用 `vX.Y.Z` 格式标签
45
- 6. **提交并推送** - 提交版本更新并推送标签
56
+ 2. **分流未关闭的 issue/PR** - `gh pr list` + `gh issue list`;将每一项二分为 **带上(bring-in)或延后(defer)**(XSPEC-265)
57
+ 3. **更新版本文件** - 更新 package.json 和相关版本引用
58
+ 4. **更新 CHANGELOG** - 将 [Unreleased] 条目移至新版本区段
59
+ 5. **执行发布前检查** - 验证测试、lint、标准合规,**以及 issue/PR 分流闸门**
60
+ 6. **创建 git tag** - 使用 `vX.Y.Z` 格式标签
61
+ 7. **提交并推送** - 提交版本更新并推送标签
62
+
63
+ ### 发版前 issue/PR 分流闸门(XSPEC-265)
64
+
65
+ 递增版本号之前,扫描未关闭的 issue/PR,并对每一项做出有意识的决定——**不要**依赖记忆:
66
+
67
+ | 类别 | 动作 |
68
+ |------|------|
69
+ | **带上(Bring-in)** | patch 级 dependabot PR / 阻塞发布的 bug / 与本版主题相关的修复 → 在递增版本前合并 |
70
+ | **延后(Defer)** | major PR、审计/增强类 issue、需要另行评估者 → 记录在签核(signoff)的 "deferred" 中,并写入发布说明的 Known Issues |
71
+
72
+ - 确认 `cross-project/sub-project-triage.md` 快照是近期的(≤7 天);若已过期则刷新。
73
+ - 将结果记录在发布签核(Tier-1)中:`Pre-release issue/PR triage | PASS | N PRs / M issues: X merged / Y deferred`。
74
+ - **不要求清空 backlog**——只要求每一项都有有意识的决定 + 留下记录。
46
75
 
47
76
  ### 版本递增规则
48
77
 
49
- | 变更类型 | 递增 | 范例 |
78
+ | 变更类型 | 递增 | 示例 |
50
79
  |---------|------|------|
51
80
  | 破坏性变更 | MAJOR | 1.9.5 → 2.0.0 |
52
81
  | 新功能(向下兼容) | MINOR | 2.3.5 → 2.4.0 |
@@ -54,24 +83,38 @@ description: |
54
83
 
55
84
  ## 使用方式
56
85
 
86
+ ### CI/CD 模式(默认)
57
87
  - `/release start 1.2.0` - 开始 v1.2.0 的发布流程
58
88
  - `/release changelog 1.2.0` - 更新 v1.2.0 的 CHANGELOG
59
- - `/release finish 1.2.0` - 完成并标签 v1.2.0
89
+ - `/release finish 1.2.0` - 完成并标记 v1.2.0
60
90
  - `/release check` - 执行发布前验证
61
91
 
92
+ ### 手动模式(RC 工作流程)
93
+ - `/release start 1.2.0-rc.1` - 创建 RC 版本
94
+ - `uds release manifest` - 生成 build-manifest.json
95
+ - `uds release deploy staging` - 记录 staging 部署
96
+ - `uds release deploy staging --result passed` - 记录测试结果
97
+ - `/release promote 1.2.0` - 将 RC 晋升为稳定版
98
+ - `uds release deploy production` - 记录 production 部署
99
+ - `uds release verify` - 验证清单一致性
100
+
62
101
  ## 下一步引导
63
102
 
64
103
  `/release` 完成后,AI 助手应建议:
65
104
 
66
105
  > **发布流程完成。建议下一步:**
67
- > - 验证 npm 发布状态 `npm view <pkg> dist-tags`
68
- > - 建立 GitHub Release 并撰写发布说明
106
+ > - 验证 npm 发布状态 `npm view <pkg> dist-tags` ⭐ **推荐**
107
+ > - 创建 GitHub Release 并撰写发布说明
69
108
  > - 通知利益相关者新版本已发布
70
109
 
71
110
  ## 参考
72
111
 
73
- - [变更日誌格式指南](./changelog-format.md) — 要撰写或审查变更日志时读它。
74
- - [發布流程指南](./release-workflow.md) — 真的要发一版、需要逐步流程时读它。
75
- - [語意化版本指南](./semantic-versioning.md) — 要判断一个变更算 major、minor 还是 patch 时读它。
112
+ - [变更日志格式指南](./changelog-format.md) — 要撰写或审查变更日志条目时读它。
113
+ - [发布流程指南](./release-workflow.md) — 真的要发一版、需要逐步流程时读它。
114
+ - [语义化版本指南](./semantic-versioning.md) — 要判断一个变更算 major、minor 还是 patch 时读它。
76
115
  - 详细指南:[guide.md](./guide.md)
77
116
  - 核心规范:[versioning.md](../../../../core/versioning.md)
117
+
118
+ ## AI 代理行为
119
+
120
+ > 完整的 AI 行为定义请参阅对应的命令文件:[`/release`](../../../../skills/commands/release.md#ai-agent-behavior--ai-代理行為)