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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (693) hide show
  1. package/README.md +13 -3
  2. package/bin/uds.js +75 -3
  3. package/bundled/ai/options/code-review/pr-review.ai.yaml +20 -1
  4. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  5. package/bundled/ai/standards/ai-response-navigation.ai.yaml +43 -3
  6. package/bundled/ai/standards/checkin-standards.ai.yaml +25 -6
  7. package/bundled/ai/standards/code-review.ai.yaml +15 -2
  8. package/bundled/ai/standards/commit-message.ai.yaml +18 -4
  9. package/bundled/ai/standards/developer-memory.ai.yaml +12 -2
  10. package/bundled/ai/standards/full-coverage-testing.ai.yaml +86 -7
  11. package/bundled/ai/standards/open-work-tracking.ai.yaml +254 -4
  12. package/bundled/ai/standards/pipeline-security-gates.ai.yaml +53 -4
  13. package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
  14. package/bundled/ai/standards/turn-completion-integrity.ai.yaml +14 -7
  15. package/bundled/core/ai-response-navigation.md +128 -12
  16. package/bundled/core/code-review-checklist.md +20 -2
  17. package/bundled/core/commit-message-guide.md +22 -19
  18. package/bundled/core/developer-memory.md +12 -2
  19. package/bundled/core/full-coverage-testing.md +99 -5
  20. package/bundled/core/open-work-tracking.md +251 -8
  21. package/bundled/core/pipeline-security-gates.md +63 -0
  22. package/bundled/core/project-context-memory.md +10 -2
  23. package/bundled/core/turn-completion-integrity.md +58 -11
  24. package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
  25. package/bundled/extensions/languages/csharp-style.md +464 -0
  26. package/bundled/extensions/languages/php-style.md +700 -0
  27. package/bundled/extensions/locales/zh-cn.md +717 -0
  28. package/bundled/extensions/locales/zh-tw.md +717 -0
  29. package/bundled/hooks/check-turn-completion-agy.mjs +147 -0
  30. package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
  31. package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
  32. package/bundled/locales/COVERAGE.md +5 -4
  33. package/bundled/locales/zh-CN/CHANGELOG.md +211 -3
  34. package/bundled/locales/zh-CN/README.md +3 -3
  35. package/bundled/locales/zh-CN/SECURITY.md +3 -1
  36. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  37. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
  38. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  39. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
  40. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
  41. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
  42. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
  43. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  44. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  45. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  46. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  47. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  48. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  49. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  50. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  51. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  52. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  53. package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
  54. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  55. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  56. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  57. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  58. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  59. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  60. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  61. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  62. package/bundled/locales/zh-CN/core/code-review-checklist.md +54 -23
  63. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  64. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  65. package/bundled/locales/zh-CN/core/developer-memory.md +159 -60
  66. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  67. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  68. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  69. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  70. package/bundled/locales/zh-CN/core/full-coverage-testing.md +103 -9
  71. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  72. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  73. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  74. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  75. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  76. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  77. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  78. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  79. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  80. package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
  81. package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
  82. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  83. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  84. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  85. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  86. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  87. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  88. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  89. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  90. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  91. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  92. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  93. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  94. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  95. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  96. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  97. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  98. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  99. package/bundled/locales/zh-CN/core/turn-completion-integrity.md +46 -13
  100. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  101. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  102. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  103. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  104. package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
  105. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +11 -2
  106. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  107. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +76 -40
  108. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +32 -15
  109. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  110. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
  111. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  112. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
  113. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  114. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  115. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +46 -0
  116. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  117. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  118. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  119. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  120. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  121. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  122. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  123. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  124. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  125. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  126. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  127. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  128. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  129. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  130. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  131. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  132. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  133. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  134. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  135. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  136. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  137. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  138. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  139. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  140. package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
  141. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  142. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  143. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  144. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  145. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  146. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  147. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  148. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  149. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  150. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  151. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  152. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  153. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  154. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  155. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  156. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  157. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  158. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  159. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  160. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  161. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  162. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  163. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  164. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  165. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  166. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  167. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  168. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  169. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  170. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  171. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  172. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  173. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  174. package/bundled/locales/zh-CN/skills/README.md +3 -1
  175. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  176. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  177. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  178. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  179. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  180. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  181. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  182. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  183. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  184. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  185. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  186. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  187. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  188. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  189. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  190. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  191. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  192. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  193. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  194. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  195. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  196. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  197. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  198. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  199. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  200. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  201. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  202. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  203. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  204. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  205. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  206. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  207. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  208. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  209. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  210. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  211. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  212. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  213. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  214. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  215. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  216. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  217. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  218. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  219. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  220. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  221. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  222. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  223. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  224. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  225. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  226. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  227. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  228. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  229. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  230. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  231. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  232. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  233. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  234. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  235. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  236. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  237. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  238. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  239. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  240. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  241. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  242. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  243. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  244. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  245. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  246. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  247. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  248. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  249. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -2
  250. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  251. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  252. package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
  253. package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
  254. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  255. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  256. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  257. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  258. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  259. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  260. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  261. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  262. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  263. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  264. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  265. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  266. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  267. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  268. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  269. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  270. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  271. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  272. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  273. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  274. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  275. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  276. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  277. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  278. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  279. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  280. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  281. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  282. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  283. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  284. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  285. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  286. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  287. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  288. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  289. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  290. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  291. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  292. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  293. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  294. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  295. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  296. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  297. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  298. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  299. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  300. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  301. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  302. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  303. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  304. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  305. package/bundled/locales/zh-TW/CHANGELOG.md +211 -3
  306. package/bundled/locales/zh-TW/README.md +3 -3
  307. package/bundled/locales/zh-TW/SECURITY.md +3 -1
  308. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  309. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
  310. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  311. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
  312. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
  313. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
  314. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
  315. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  316. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  317. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  318. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  319. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  320. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  321. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  322. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  323. package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
  324. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  325. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  326. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  327. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  328. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  329. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  330. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  331. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  332. package/bundled/locales/zh-TW/core/code-review-checklist.md +36 -7
  333. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  334. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  335. package/bundled/locales/zh-TW/core/developer-memory.md +111 -12
  336. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  337. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  338. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  339. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  340. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  341. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  342. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  343. package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
  344. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  345. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  346. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  347. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  348. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  349. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  350. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  351. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  352. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  353. package/bundled/locales/zh-TW/core/open-work-tracking.md +164 -9
  354. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  355. package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
  356. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  357. package/bundled/locales/zh-TW/core/project-context-memory.md +215 -31
  358. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  359. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  360. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  361. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  362. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  363. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  364. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  365. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  366. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  367. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  368. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  369. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  370. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  371. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  372. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  373. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  374. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  375. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  376. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  377. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  378. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  379. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  380. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  381. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  382. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  383. package/bundled/locales/zh-TW/core/turn-completion-integrity.md +46 -13
  384. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  385. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  386. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  387. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  388. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  389. package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
  390. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +11 -2
  391. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  392. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +69 -33
  393. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  394. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +32 -15
  395. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  396. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
  397. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  398. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
  399. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  400. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  401. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +46 -0
  402. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  403. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  404. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  405. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  406. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  407. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  408. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  409. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  410. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  411. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  412. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  413. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  414. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  415. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  416. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  417. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  418. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  419. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  420. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  421. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  422. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  423. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  424. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  425. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  426. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  427. package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
  428. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  429. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  430. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  431. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  432. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  433. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  434. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  435. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  436. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  437. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  438. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  439. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  440. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  441. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  442. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  443. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  444. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  445. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  446. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  447. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  448. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  449. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  450. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  451. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  452. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  453. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  454. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  455. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  456. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  457. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  458. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  459. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  460. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  461. package/bundled/locales/zh-TW/skills/README.md +3 -1
  462. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  463. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  464. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  465. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  466. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  467. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  468. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  469. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  470. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  471. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  472. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  473. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  474. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  475. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  476. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  477. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  478. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  479. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  480. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  481. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  482. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  483. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  484. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  485. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  486. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  487. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  488. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  489. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  490. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  491. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  492. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  493. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  494. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  495. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  496. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  497. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  498. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  499. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  500. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  501. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  502. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  503. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  504. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  505. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  506. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  507. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  508. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  509. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  510. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  511. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  512. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  513. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  514. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  515. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  516. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  517. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  518. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  519. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  520. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  521. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  522. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  523. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  524. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  525. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  526. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  527. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  528. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  529. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  530. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  531. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  532. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  533. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  534. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  535. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  536. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  537. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  538. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  539. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  540. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  541. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  542. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  543. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  544. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  545. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  546. package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
  547. package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
  548. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  549. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  550. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  551. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  552. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  553. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  554. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  555. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  556. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  557. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  558. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  559. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  560. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  561. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  562. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  563. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  564. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  565. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  566. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  567. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  568. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  569. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  570. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  571. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  572. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  573. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  574. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  575. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  576. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  577. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  578. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  579. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  580. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  581. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  582. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  583. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  584. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  585. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  586. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  587. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  588. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  589. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  590. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  591. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  592. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  593. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  594. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  595. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  596. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  597. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  598. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  599. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  600. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  601. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  602. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  603. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  604. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  605. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  606. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  607. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  608. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  609. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  610. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  611. package/bundled/skills/README.md +1 -0
  612. package/bundled/skills/SKILL_NAMING.md +9 -0
  613. package/bundled/skills/commit-standards/SKILL.md +2 -2
  614. package/bundled/skills/commit-standards/guide.md +3 -2
  615. package/bundled/skills/commit-standards/language-options.md +19 -17
  616. package/bundled/skills/comprehension-ladder/SKILL.md +283 -0
  617. package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
  618. package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
  619. package/bundled/templates/gates/check-stubs.mjs +644 -0
  620. package/package.json +5 -3
  621. package/src/commands/audit.js +20 -2
  622. package/src/commands/check.js +155 -28
  623. package/src/commands/deps.js +31 -1
  624. package/src/commands/hitl.js +3 -0
  625. package/src/commands/init.js +173 -49
  626. package/src/commands/list.js +12 -3
  627. package/src/commands/mcp.js +2 -3
  628. package/src/commands/open-work.js +123 -0
  629. package/src/commands/quickstart.js +29 -13
  630. package/src/commands/release.js +102 -19
  631. package/src/commands/run-intent.js +10 -0
  632. package/src/commands/simulate.js +20 -8
  633. package/src/commands/skills.js +59 -33
  634. package/src/commands/spec-split.js +30 -17
  635. package/src/commands/spec.js +55 -21
  636. package/src/commands/uninstall.js +146 -32
  637. package/src/commands/update.js +471 -93
  638. package/src/core/install-records.js +192 -0
  639. package/src/core/manifest.js +12 -10
  640. package/src/core/marketplace-sentinel.js +5 -0
  641. package/src/core/open-work-config.js +122 -0
  642. package/src/core/project-config.js +92 -38
  643. package/src/flows/init-flow.js +10 -0
  644. package/src/hitl/manager.js +4 -2
  645. package/src/i18n/messages.js +413 -78
  646. package/src/installers/hooks-installer.js +320 -24
  647. package/src/installers/integration-installer.js +5 -1
  648. package/src/installers/skills-installer.js +3 -1
  649. package/src/installers/standards-installer.js +16 -23
  650. package/src/mcp/__tests__/server.test.js +0 -1
  651. package/src/mcp/server.js +16 -4
  652. package/src/prompts/init.js +148 -13
  653. package/src/reconciler/backup-locations.js +80 -0
  654. package/src/reconciler/backup-manager.js +451 -123
  655. package/src/reconciler/index.js +86 -10
  656. package/src/reconciler/install-roots.js +90 -0
  657. package/src/reconciler/plan-executor.js +37 -15
  658. package/src/uninstallers/hook-uninstaller.js +323 -33
  659. package/src/uninstallers/integration-uninstaller.js +35 -5
  660. package/src/uninstallers/skills-uninstaller.js +95 -16
  661. package/src/uninstallers/standards-uninstaller.js +56 -7
  662. package/src/utils/agents-installer.js +10 -17
  663. package/src/utils/available-standards-report.js +144 -0
  664. package/src/utils/available-standards.js +216 -0
  665. package/src/utils/command-hash-ownership.js +103 -0
  666. package/src/utils/commit-message-judge.js +155 -0
  667. package/src/utils/copier.js +80 -2
  668. package/src/utils/deps-applicability.js +25 -0
  669. package/src/utils/detector.js +46 -1
  670. package/src/utils/friction-detector.js +27 -0
  671. package/src/utils/gate-scripts.js +141 -0
  672. package/src/utils/git-hooks.js +139 -7
  673. package/src/utils/hasher.js +36 -0
  674. package/src/utils/health-scorer.js +10 -7
  675. package/src/utils/installed-names-ownership.js +114 -0
  676. package/src/utils/integration-generator.js +36 -24
  677. package/src/utils/legacy-hook-migration.js +112 -0
  678. package/src/utils/locale.js +19 -0
  679. package/src/utils/open-work-tracking.mjs +1754 -0
  680. package/src/utils/prompt-closed.js +18 -0
  681. package/src/utils/sdd-header.js +66 -0
  682. package/src/utils/skill-frontmatter.js +102 -0
  683. package/src/utils/skill-hash-ownership.js +64 -0
  684. package/src/utils/skill-name-collision.js +169 -0
  685. package/src/utils/skills-install-paths.js +114 -0
  686. package/src/utils/skills-installer.js +75 -106
  687. package/src/utils/standard-validator.js +98 -27
  688. package/src/utils/test-change-check.js +160 -0
  689. package/src/utils/test-policy.js +214 -0
  690. package/src/utils/transient-fs.js +113 -0
  691. package/src/utils/update-summary.js +29 -0
  692. package/src/vibe/micro-spec.js +15 -0
  693. package/standards-registry.json +48 -9
@@ -1,8 +1,9 @@
1
1
  ---
2
2
  source: ../../../core/refactoring-standards.md
3
- source_version: 2.1.0
4
- translation_version: 2.1.0
5
- last_synced: 2026-02-10
3
+ source_version: 2.2.0
4
+ translation_version: 2.2.0
5
+ last_synced: 2026-10-11
6
+ source_hash: e293ee5788ca
6
7
  status: current
7
8
  ---
8
9
 
@@ -10,634 +11,218 @@ status: current
10
11
 
11
12
  > **语言**: [English](../../../core/refactoring-standards.md) | 简体中文
12
13
 
13
- **版本**: 2.0.0
14
- **最后更新**: 2026-01-21
15
- **适用范围**: 所有进行代码改善的软件项目
14
+ **版本**: 2.2.0
15
+ **最后更新**: 2026-07-01
16
+ **适用范围**: 所有进行代码改进工作的软件项目
17
+ **范围**: partial
18
+ **业界标准**: ISO/IEC 25010 可维护性
19
+
20
+ > **详细模式与教程,请参阅 [重构指南](../../../core/guides/refactoring-guide.md)**
16
21
 
17
22
  ---
18
23
 
19
24
  ## 目的
20
25
 
21
- 本标准定義程序码重構的完整指引,涵蓋從日常 TDD 重構循環到大型遺留系统現代化的所有場景。确保重構工作安全、可衡量,并与业务目標一致。
22
-
23
- **主要優点**:
24
- - 系统化的程序码品质改善方法
25
- - 降低重構過程中引入错误的風險
26
- - 清晰的重構 vs 重写决策框架
27
- - 可衡量的成果与投資报酬率追蹤
26
+ 本标准定义代码重构的完整指引,涵盖从日常 TDD 重构循环到大型遗留系统现代化的所有场景。
28
27
 
29
28
  ---
30
29
 
31
- ## 目录
32
-
33
- 1. [重構 vs 重写决策矩陣](#重構-vs-重写决策矩陣)
34
- 2. [依規模的重構策略](#依規模的重構策略)
35
- 3. [遺留程序码策略](#遺留程序码策略)
36
- 4. [大型重構模式](#大型重構模式)
37
- 5. [数据庫重構](#数据庫重構)
38
- 6. [安全重構工作流程](#安全重構工作流程)
39
- 7. [重構度量指標](#重構度量指標)
40
- 8. [团队协作](#团队协作)
41
- 9. [技術債管理](#技術債管理)
42
- 10. [相关标准](#相关标准)
43
- 11. [參考数据](#參考数据)
44
- 12. [版本歷程](#版本歷程)
45
-
46
- ---
30
+ ## 重构 vs 重写决策矩阵
47
31
 
48
- ## 重構 vs 重写决策矩陣
49
-
50
- 在開始任何大型重構工作之前,评估重構或重写哪个更合適。
51
-
52
- ### 决策流程图
53
-
54
- ```
55
- ┌─────────────────────────────────────────────────────────────────┐
56
- │ 重構 vs 重写决策樹 │
57
- ├─────────────────────────────────────────────────────────────────┤
58
- │ │
59
- │ 程序码目前在生产環境运行嗎? │
60
- │ ├─ 否 → 考慮重写(風險較低) │
61
- │ └─ 是 ↓ │
62
- │ │
63
- │ 你了解程序码在做什麼嗎? │
64
- │ ├─ 否 → 先写特徵测试,再决定 │
65
- │ └─ 是 ↓ │
66
- │ │
67
- │ 测试覆蓋率足夠嗎(>60%)? │
68
- │ ├─ 否 → 先補测试,再决定 │
69
- │ └─ 是 ↓ │
70
- │ │
71
- │ 核心架構可以保留嗎? │
72
- │ ├─ 否 → Strangler Fig(漸进替换) │
73
- │ └─ 是 → 漸进式重構 ✓ │
74
- │ │
75
- └─────────────────────────────────────────────────────────────────┘
76
- ```
77
-
78
- ### 比較矩陣
79
-
80
- | 因素 | 傾向重構 | 傾向重写 |
81
- |------|---------|---------|
82
- | **程序码規模** | 大型、複雜 | 小型、獨立 |
83
- | **测试覆蓋率** | 良好(>60%)| 差或没有 |
84
- | **业务連續性** | 关鍵 | 可容忍停机 |
85
- | **团队知識** | 团队理解程序码 | 無組織知識 |
86
- | **核心架構** | 健全,只是混亂 | 根本性缺陷 |
87
- | **时间壓力** | 緊迫期限 | 彈性时间 |
88
- | **風險容忍度** | 低 | 較高 |
89
-
90
- ### 警告:第二系统效应
91
-
92
- > 「第二个系统是一个人设计過最危險的系统。」— Fred Brooks
93
-
94
- 重写时,团队常常過度工程化。避免:
95
- - 新增原本没有的功能
96
- - 「为了未來彈性」過度抽象
97
- - 忽视現有系统的教訓
32
+ | 因素 | 倾向重构 | 倾向重写 |
33
+ |------|----------|----------|
34
+ | **代码库规模** | 大型、复杂 | 小型、独立 |
35
+ | **测试覆盖率** | 良好(>60%) | 不足或没有 |
36
+ | **业务连续性** | 关键 | 可容忍停机 |
37
+ | **团队知识** | 团队理解代码 | 缺乏组织内的知识传承 |
38
+ | **核心架构** | 健全,只是凌乱 | 根本性缺陷 |
39
+ | **时间压力** | 期限紧迫 | 时程弹性 |
40
+ | **风险容忍度** | 低 | 较高 |
98
41
 
99
42
  ---
100
43
 
101
- ## 依規模的重構策略
44
+ ## 何时重构
102
45
 
103
- ### 小規模:TDD 重構阶段(分鐘级)
46
+ | 情境 | 建议策略 |
47
+ |------|----------|
48
+ | 功能开发被凌乱的代码阻碍 | 预备性重构(Preparatory Refactoring) |
49
+ | 修复缺陷时顺带接触到代码 | 童子军规则(Boy Scout Rule) |
50
+ | 以 TDD 编写新代码 | 红-绿-重构(Red-Green-Refactor) |
51
+ | 替换整个遗留系统 | 绞杀者模式(Strangler Fig Pattern) |
52
+ | 需要与遗留系统集成但不被污染 | 防腐层(Anti-Corruption Layer) |
53
+ | 不使用功能分支重构共享代码 | 抽象分支(Branch by Abstraction) |
54
+ | 变更被广泛使用的接口 | 并行变更(Parallel Change,扩展-迁移-收缩) |
55
+ | 处理没有测试的遗留代码 | **先写**特征测试(Characterization Tests) |
104
56
 
105
- 紅-綠-重構循環的一部分。詳見[测试驅动开发](test-driven-development.md)。
106
-
107
- **特点**:
108
- - 时長:5-15 分鐘
109
- - 範圍:单一方法或类别
110
- - 测试:必須保持綠色
57
+ ---
111
58
 
112
- **常用技術**:
113
- - 提取方法(Extract Method)
114
- - 重新命名(Rename)
115
- - 內联变數(Inline Variable)
116
- - 以常數取代魔術數字(Replace Magic Number with Constant)
59
+ ## 策略摘要
117
60
 
118
- ### 中規模:功能级重構(小时到天)
61
+ | 策略 | 规模 | 风险 | 时长 | 主要使用情境 |
62
+ |------|------|------|------|--------------|
63
+ | **预备性重构** | 小 | 低 | 数小时 | 在功能开发前降低阻力 |
64
+ | **童子军规则** | 极小 | 低 | 数分钟 | 持续偿还技术债 |
65
+ | **红-绿-重构** | 小 | 低 | 5-15 分钟 | TDD 开发循环 |
66
+ | **绞杀者模式** | 大 | 中 | 数月 | 系统替换 |
67
+ | **防腐层** | 中 | 低 | 数周 | 新旧系统共存 |
68
+ | **抽象分支** | 大 | 中 | 数周 | 在主干上进行长期重构 |
69
+ | **并行变更** | 中 | 低 | 数天至数周 | 接口/schema 迁移 |
70
+ | **特征测试** | — | — | — | **所有遗留代码重构的前提** |
119
71
 
120
- 改善特定功能或模組,不改变其外部行为。
72
+ ---
121
73
 
122
- **特点**:
123
- - 时長:數小时到數天
124
- - 範圍:单一功能或模組
125
- - 测试:若缺少則補充特徵测试
74
+ ## 安全重构工作流程
126
75
 
127
- **規划检查清单**:
76
+ ### 重构前
128
77
 
129
- ```
130
- □ 定義範圍邊界(包含什麼、排除什麼)
131
- □ 識别模組的所有进入点
132
- □ 确保受影響程序码的测试覆蓋率 > 80%
133
- □ 規划增量提交(每个都应可部署)
134
- □ 与团队溝通(避免合併衝突)
135
- ```
78
+ - [ ] 定义成功标准(可衡量)
79
+ - [ ] 确保足够的测试覆盖率(建议 >80%)
80
+ - [ ] 提交或暂存(stash)当前工作(保持干净的工作目录)
81
+ - [ ] 创建功能分支(或在主干上配合功能开关工作)
82
+ - [ ] 与团队沟通以避免冲突
136
83
 
137
- ### 大規模:架構级重構(周到月)
84
+ ### 重构中
138
85
 
139
- 重大架構变更,如從单体迁移到微服务。
86
+ - [ ] 一次只做**一个**小变更
87
+ - [ ] **每次**变更后都运行测试
88
+ - [ ] 若测试失败,**立即**回退
89
+ - [ ] 频繁提交(每次测试通过都是一个保存点)
90
+ - [ ] 重构时绝不新增功能
140
91
 
141
- **特点**:
142
- - 时長:數周到數月
143
- - 範圍:多个模組或整个系统
144
- - 测试:需要完整的集成测试
92
+ ### 重构后
145
93
 
146
- **模式**:見[大型重構模式](#大型重構模式)
94
+ - [ ] 所有测试通过(与重构前相同)
95
+ - [ ] 代码有可衡量的改善(复杂度、重复度等)
96
+ - [ ] 必要时更新文档
97
+ - [ ] 完成团队审查
98
+ - [ ] 没有新增功能
147
99
 
148
100
  ---
149
101
 
150
- ## 遺留程序码策略
102
+ ## 代码质量指标
151
103
 
152
- 基於 Michael Feathers 的《Working Effectively with Legacy Code》。
104
+ ### 目标指标
153
105
 
154
- ### 遺留程序码困境
106
+ | 指标 | 目标 | 工具 |
107
+ |------|------|------|
108
+ | **圈复杂度** | 每个函数 < 10 | 静态分析 |
109
+ | **认知复杂度** | 越低越好 | SonarQube |
110
+ | **代码重复(文本)** | < 3% | 静态分析 |
111
+ | **语义重复** | 0 个未受管控的领域事实 | Golden 测试 / 架构测试(见下文) |
112
+ | **测试覆盖率** | ≥ 80% | 覆盖率工具 |
155
113
 
156
- **定義**:遺留程序码 = 没有测试的程序码(無关年齡)
114
+ > **文本重复 vs 语义重复**:`Code Duplication` 指标只能检测*文本*重复(几乎相同的 token 序列),无法检测*语义*重复——同一个领域事实在多处被重新实现,或派生的聚合值被持久化却没有与其来源建立强制绑定。不是逐字节相同的副本(改写过的逻辑、在一处正确而在另一处错误的公式)能通过静态分析,却会持续各自漂移。语义重复必须由 golden 测试与架构测试来管控(参见[语义重复与复制漂移](#语义重复与复制漂移)),而非依赖上述静态分析阈值。
157
115
 
158
- **困境**:
159
- - 要安全地修改程序码,我們需要测试
160
- - 要加测试,我們常常需要修改程序码
161
- - 没有测试就修改程序码是有風險的
116
+ ### ISO/IEC 25010 可维护性目标
162
117
 
163
- **解决方案**:使用安全技術在修改前加入测试。
118
+ | 子特性 | 指标 | 目标 |
119
+ |--------|------|------|
120
+ | **模块化(Modularity)** | 耦合度、文件大小 | 减少依赖 |
121
+ | **可复用性(Reusability)** | 代码重复 | 提取方法、DRY |
122
+ | **可分析性(Analysability)** | 圈复杂度 | 简化逻辑 |
123
+ | **可修改性(Modifiability)** | 内聚度、测试覆盖率 | 单一职责 |
124
+ | **可测试性(Testability)** | 分支覆盖率 | 依赖注入 |
164
125
 
165
- ### 特徵测试(Characterization Tests)
166
-
167
- **目的**:捕獲現有行为(不是验证正确性)
168
-
169
- **流程**:
170
-
171
- ```
172
- 1. 呼叫你想了解的程序码
173
- 2. 写一个你预期会失败的斷言
174
- 3. 执行测试看实际發生什麼
175
- 4. 更新斷言以符合实际行为
176
- 5. 重複直到覆蓋你需要修改的行为
177
- ```
178
-
179
- **範例**:
180
-
181
- ```javascript
182
- // 步骤 1:初始(预期会失败)
183
- test('calculateDiscount 回传... 某个值', () => {
184
- const result = calculateDiscount(100, 'GOLD');
185
- expect(result).toBe(0); // 猜测 - 可能会失败
186
- });
126
+ ---
187
127
 
188
- // 步骤 2:执行後,更新为实际值
189
- test('calculateDiscount 对 GOLD 客戶回传 15', () => {
190
- const result = calculateDiscount(100, 'GOLD');
191
- expect(result).toBe(15); // 实际行为
192
- });
193
- ```
128
+ ## 语义重复与复制漂移
194
129
 
195
- ### 尋找接縫(Finding Seams)
130
+ 文本重复指标能抓到复制粘贴,却会漏掉更危险的情况:**同一个领域事实在不止一处被实现**。当这些实现并非逐字节相同时——改写过的分类逻辑、在某个调用点正确而在另一个调用点有细微错误的公式、与其汇总的明细行分开存储的总计——它们能通过静态分析,然后**各自独立地漂移**,产生看似无关、实则同一根因的缺陷。
196
131
 
197
- **定義**:接縫是可以在不编辑程序码的情况下改变行为的地方。
132
+ ### 反模式:复制漂移(Copy-Drift)
198
133
 
199
- | 接縫类型 | 运作方式 | 範例 |
200
- |---------|---------|------|
201
- | **物件接縫** | 透過多型覆写 | 透過界面注入测试替身 |
202
- | **预处理接縫** | 编譯时替换 | 条件编譯、巨集 |
203
- | **連結接縫** | 連結时替换 | 依賴注入、模組替换 |
134
+ 复制漂移在以下任一情况发生:
204
135
 
205
- ### Sprout 与 Wrap 技術
136
+ - 单一领域事实(分类、规则、计算)在**多个调用点被重新实现**,而不是由一个共享单元计算;或
137
+ - **派生值被持久化**(存储的聚合值、计数器或反规范化字段)**却没有与其来源建立强制关系**,导致每条写入路径都能独立更新它。
206
138
 
207
- | 技術 | 使用时机 | 做法 |
208
- |-----|---------|-----|
209
- | **Sprout Method** | 在現有方法中加入新邏辑 | 建立新方法,從舊方法呼叫 |
210
- | **Sprout Class** | 新邏辑需要獨立演进 | 建立新类别,從舊程序码參照 |
211
- | **Wrap Method** | 需要在前後加入行为 | 重命名原方法,建立包裝器 |
212
- | **Wrap Class** | 裝飾現有类别 | 裝飾者模式 |
139
+ 由于这些副本并非字面上完全相同,文本重复工具不会报告任何问题。分歧日后会以不一致的形式浮现:列表视图与详情视图不一致、存储的计数器因某条更新路径的递减分支被注释掉而重复计数,或同一个公式在不同模块中得出不同答案。
213
140
 
214
- **原則**:新程序码使用 TDD;遺留程序码在测试前保持不动。
141
+ ### 模式:单一事实来源 / 派生而非复制(Derive-Don't-Duplicate)
215
142
 
216
- ### 程序码考古
143
+ - **一个事实一个单元。** 将每个领域事实提取为**单一**的分类器 / 计算器 / 解析器。每个调用点都调用它——不重新实现,也不改写。
144
+ - **派生,而非存储。** 优先在读取时计算值,而不是持久化第二份副本。始终派生的值不会漂移。
145
+ - **若聚合值必须存储**,应将其视为**明细行的投影**,并在**单一关卡点**重新计算——例如 `SaveChanges` 拦截器,或一个共享的 `recompute()` 函数——让*每条*写入路径(包括异步作业与失败回写)都经过同一套重新计算并保持一致。**绝不**让个别路径对存储的聚合值做 `col = col + delta` 这类增量调整;增量调整正是递减/回滚分支被跳过、计数器出现分歧的根源。
146
+ - **用测试锁定。** 使用 **golden 测试**固定单一事实来源,并加入**架构测试**,一旦该规则在其他地方被重新定义就失败,让未来的副本在 CI 阶段就被拒绝,而不是在生产环境中才被发现。
217
147
 
218
- 理解無文件程序码的技術:
148
+ ### 迁移推论——刻意分歧登记表
219
149
 
220
- ```
221
- 1. 草稿重構(Scratch Refactoring)
222
- ├─ 重構以理解,不是保留
223
- ├─ 使用 git stash 或分支
224
- └─ 完成後捨棄(git reset --hard)
150
+ 当新系统**刻意**与遗留行为产生分歧时,必须记录下来——否则日后的“修复”会悄悄把它改回去。移植时常见的情况:遗留*函数*返回 X,但下游的遗留*流水线*会把它调和为 Y;移植时将这个调和过程并入单一单元,于是该函数现在直接返回 Y。
225
151
 
226
- 2. 追蹤变數流动
227
- ├─ 從输入追蹤到输出
228
- ├─ 標记关鍵转换点
229
- └─ 邊發現邊记录
152
+ - 将每项刻意分歧登记在**刻意分歧登记表**中(遗留行为、新行为、理由、所属事实)。
153
+ - 用 **golden 测试**固定新行为,让未来“修正”回遗留行为时构建失败。
154
+ - 将登记表提供给任何针对遗留系统的**差异测试**,使该分歧被视为*预期*,而不是被标记为回归。
230
155
 
231
- 3. 执行时觀察
232
- ├─ 加入暫时性日誌
233
- ├─ 使用除錯器逐步执行
234
- └─ 建立心智模型
156
+ ### 采用者注意事项
235
157
 
236
- 4. Git 考古
237
- ├─ git log -p <file>(查看所有变更)
238
- ├─ git blame(找到原作者)
239
- └─ 搜尋提交消息找脈络
240
- ```
158
+ - 逐函数比较遗留与新实现所得到的是**候选项,而非结论**。每个候选项都必须对照**整条**遗留流水线(而不只是单一函数)判定后,才能称为缺陷——遗留流水线可能已在下游调和了表面上的差异。
159
+ - 以**程序化 / 基于 token** 的方式(而非手动)提取遗留函数主体,以免在调查抄写错误时又引入新的抄写错误。
241
160
 
242
161
  ---
243
162
 
244
- ## 大型重構模式
245
-
246
- ### Strangler Fig 模式
247
-
248
- **使用时机**:漸进替换遺留系统
249
-
250
- ```
251
- ┌─────────────────────────────────────────────────────────────────┐
252
- │ Strangler Fig 模式 │
253
- ├─────────────────────────────────────────────────────────────────┤
254
- │ │
255
- │ 阶段 1: 攔截(INTERCEPT) │
256
- │ ┌─────────┐ ┌─────────┐ ┌─────────────┐ │
257
- │ │ 请求 │────▶│ 門面 │────▶│ 舊系统(100%)│ │
258
- │ └─────────┘ └─────────┘ └─────────────┘ │
259
- │ │
260
- │ 阶段 2: 迁移(MIGRATE) │
261
- │ ┌─────────┐ ┌─────────┐ ┌─────────────┐ │
262
- │ │ 请求 │────▶│ 門面 │──┬─▶│ 新系统(功能A)│ │
263
- │ └─────────┘ └─────────┘ │ └─────────────┘ │
264
- │ └─▶│ 舊系统(其餘) │ │
265
- │ └─────────────┘ │
266
- │ │
267
- │ 阶段 3: 完成(COMPLETE) │
268
- │ ┌─────────┐ ┌─────────────┐ │
269
- │ │ 请求 │────▶│ 新系统(100%)│ [舊系统已下线] │
270
- │ └─────────┘ └─────────────┘ │
271
- │ │
272
- └─────────────────────────────────────────────────────────────────┘
273
- ```
274
-
275
- **检查清单**:
276
- - [ ] 識别攔截点(API 閘道、門面、代理)
277
- - [ ] 建立事件捕獲层
278
- - [ ] 在新系统中实作第一个功能
279
- - [ ] 漸进式路由流量
280
- - [ ] 監控并比較結果
281
- - [ ] 下线舊元件
282
-
283
- ### Branch by Abstraction
284
-
285
- **使用时机**:在不用長期分支的情况下重構共享程序码
286
-
287
- ```
288
- 步骤 1:引入抽象
289
- 客户端 → 抽象(界面)→ 舊实作
290
-
291
- 步骤 2:新增新实作
292
- 客户端 → 抽象 → 舊实作
293
- └─→ 新实作(功能開关控制)
294
-
295
- 步骤 3:切换并移除
296
- 客户端 → 新实作
297
- [舊实作已移除]
298
- ```
299
-
300
- **关鍵原則**:
301
- - 所有变更在主幹(trunk)上(没有長期分支)
302
- - 功能開关控制哪个实作是活躍的
303
- - 兩个实作可以在過渡期共存
304
-
305
- ### 平行变更(Expand-Migrate-Contract)
306
-
307
- **使用时机**:变更多个客户端使用的界面
308
-
309
- ```
310
- 阶段 1: 擴展(EXPAND)
311
- ├─ 在舊的旁邊新增新欄位/方法
312
- ├─ 新程序码使用新界面
313
- └─ 舊程序码仍然运作
314
-
315
- 阶段 2: 迁移(MIGRATE)
316
- ├─ 更新所有客户端使用新界面
317
- ├─ 验证所有客户端已迁移
318
- └─ 数据迁移(如需要)
319
-
320
- 阶段 3: 收縮(CONTRACT)
321
- ├─ 移除舊欄位/方法
322
- ├─ 清理迁移程序码
323
- └─ 更新文件
324
- ```
163
+ ## PR 大小指南
325
164
 
326
- ---
165
+ | 大小 | 变更行数 | 审查时间 | 建议 |
166
+ |------|----------|----------|------|
167
+ | 小 | < 200 | < 30 分钟 | ✅ 理想 |
168
+ | 中 | 200-500 | < 1 小时 | ⚠️ 可接受 |
169
+ | 大 | > 500 | — | ❌ **应拆分** |
327
170
 
328
- ## 数据庫重構
329
-
330
- ### Schema 变更的 Expand-Contract 模式
331
-
332
- ```
333
- ┌─────────────────────────────────────────────────────────────────┐
334
- │ 数据庫重構(Expand-Contract) │
335
- ├─────────────────────────────────────────────────────────────────┤
336
- │ │
337
- │ 阶段 1: 擴展(新增新的,保留舊的) │
338
- │ ├─ 新增新欄位/表 │
339
- │ ├─ 应用程序同时写入新舊 │
340
- │ └─ 此时可安全回滾 │
341
- │ │
342
- │ 阶段 2: 迁移(搬移数据) │
343
- │ ├─ 從舊複制数据到新 │
344
- │ ├─ 验证数据一致性 │
345
- │ └─ 应用程序開始從新读取 │
346
- │ │
347
- │ 阶段 3: 收縮(移除舊的) │
348
- │ ├─ 确认舊欄位/表不再被读取 │
349
- │ ├─ 移除舊欄位/表 │
350
- │ └─ 清理雙写程序码 │
351
- │ │
352
- └─────────────────────────────────────────────────────────────────┘
353
- ```
354
-
355
- ### 常見 Schema 重構場景
356
-
357
- | 場景 | 策略 | 風險等级 |
358
- |-----|------|---------|
359
- | **重命名欄位** | 新增新的 → 迁移 → 刪除舊的 | 中 |
360
- | **拆分表格** | 新表 + 外鍵 → 迁移 → 調整应用程序 | 高 |
361
- | **合併表格** | 新表 → 合併数据 → 切换应用程序 | 高 |
362
- | **变更数据型别** | 新欄位 → 转换 → 切换应用程序 | 中 |
363
- | **新增 NOT NULL** | 填入预设值 → 新增約束 | 低 |
364
-
365
- ### 数据庫迁移安全检查清单
366
-
367
- ```
368
- 迁移前:
369
- □ 完整备份已完成
370
- □ 迁移脚本已在测试環境验证
371
- □ 回滾脚本已准备
372
- □ 迁移时间已估算(考慮数据量)
373
- □ 維護窗口已通知
374
-
375
- 迁移中:
376
- □ 監控数据庫效能
377
- □ 增量验证数据完整性
378
- □ 应用程序健康检查通過
379
-
380
- 迁移後:
381
- □ 数据一致性验证
382
- □ 应用程序功能验证
383
- □ 效能基线比較
384
- □ 备份保留一段时间以供回滾
385
- ```
386
-
387
- ### 零停机迁移技術
388
-
389
- | 技術 | 说明 | 使用場景 |
390
- |-----|------|---------|
391
- | **Online Schema Change** | pt-osc, gh-ost | MySQL 大表变更 |
392
- | **Blue-Green Database** | 雙数据庫切换 | 高可用需求 |
393
- | **Shadow Write** | 同时写入兩个数据庫并比較 | 验证迁移正确性 |
394
- | **Feature Flag** | 控制读取來源 | 漸进式切换 |
171
+ **原则**:多个小 PR > 一个大 PR
395
172
 
396
173
  ---
397
174
 
398
- ## 安全重構工作流程
175
+ ## 技术债优先级
399
176
 
400
- ### 重構前
401
-
402
- ```
403
- □ 定義成功标准(可衡量的)
404
- □ 确保足夠的测试覆蓋率(建议 >80%)
405
- □ 提交/暫存當前工作(乾淨的工作目录)
406
- □ 建立功能分支(或在主幹上使用功能開关)
407
- □ 与团队溝通以避免衝突
408
- ```
409
-
410
- ### 重構中
411
-
412
- ```
413
- □ 一次只做一个小变更
414
- □ 每次变更後执行测试
415
- □ 如果测试失败,立即復原
416
- □ 頻繁提交(每次测试通過都是一个存檔点)
417
- □ 重構时絕不加入新功能
418
- ```
419
-
420
- ### 重構後
421
-
422
- ```
423
- □ 所有测试通過(与之前相同)
424
- □ 程序码可衡量地更好(複雜度、重複等)
425
- □ 如需要則更新文件
426
- □ 团队审查完成
427
- □ 没有新增功能
428
- ```
177
+ | 优先级 | 标准 | 行动 |
178
+ |--------|------|------|
179
+ | **高** | 阻碍开发、频繁引发缺陷 | 立即处理 |
180
+ | **中** | 拖慢开发、增加复杂度 | 排入下一个迭代 |
181
+ | **低** | 轻微困扰、影响范围局限 | 视机会处理 |
429
182
 
430
183
  ---
431
184
 
432
- ## 重構度量指標
433
-
434
- ### 程序码品质指標
435
-
436
- | 指標 | 测量方式 | 目標 |
437
- |-----|---------|-----|
438
- | **循環複雜度** | 静态分析工具 | 每函式 < 10 |
439
- | **认知複雜度** | SonarQube 等 | 越低越好 |
440
- | **耦合度** | 模組间依賴數 | 降低 |
441
- | **內聚性** | LCOM 指標 | 提高 |
442
- | **程序码重複** | 重複程序码百分比 | < 3% |
443
- | **程序码行數** | 僅供參考 | 較少 ≠ 一定更好 |
185
+ ## 数据库重构安全
444
186
 
445
- ### 测试品质指標
187
+ ### 迁移前检查清单
446
188
 
447
- | 指標 | 目標 | 备註 |
448
- |-----|-----|------|
449
- | **测试覆蓋率** | ≥ 80% | 重構期间不要降低 |
450
- | **测试速度** | 更快 | 重構应改善可测试性 |
451
- | **不穩定测试數** | 降低 | 穩定性改善 |
189
+ - [ ] 已完成完整备份
190
+ - [ ] 迁移脚本已在预发布(staging)环境测试
191
+ - [ ] 已准备回滚脚本
192
+ - [ ] 已估算迁移时间
193
+ - [ ] 已通知维护时段
452
194
 
453
- ### 运維指標(DORA 指標)
195
+ ### 迁移后检查清单
454
196
 
455
- | 指標 | 测量方式 | 预期改善 |
456
- |-----|---------|---------|
457
- | **部署頻率** | CI/CD 记录 | 提高(可維護性改善)|
458
- | **变更失败率** | 回滾次數 | 降低 |
459
- | **平均恢復时间** | 事故记录 | 縮短 |
460
- | **前置时间** | 從提交到部署 | 縮短 |
461
-
462
- ### 团队效率指標
463
-
464
- | 指標 | 测量方式 | 备註 |
465
- |-----|---------|------|
466
- | **新人上手时间** | 新員工熟悉时间 | 縮短 = 更好的可读性 |
467
- | **PR 审查时间** | Git 记录 | 縮短 = 更好的可理解性 |
468
- | **Bug 修復时间** | Issue 追蹤 | 縮短 = 更好的可維護性 |
469
-
470
- ### 重構 ROI 框架
471
-
472
- ```
473
- 成本:
474
- ├─ 开发时间 × 时薪
475
- ├─ 测试时间
476
- ├─ 部署風險成本
477
- └─ 机会成本(未建置的功能)
478
-
479
- 收益:
480
- ├─ 減少的維護时间 × 未來年數
481
- ├─ 減少的 Bug × 修復成本
482
- ├─ 更快的功能开发
483
- └─ 更低的人員流动成本
484
- ```
485
-
486
- ---
487
-
488
- ## 团队协作
489
-
490
- ### 重構项目啟动
491
-
492
- ```
493
- 啟动会議議程:
494
- 1. 範圍定義
495
- ├─ 哪些模組/文件在範圍內
496
- └─ 明确排除什麼
497
-
498
- 2. 成功标准对齊
499
- ├─ 量化目標(複雜度降低 X%)
500
- └─ 功能目標(行为不变)
501
-
502
- 3. 工作分配
503
- ├─ 按模組(垂直切分)
504
- └─ 按层级(水平切分)
505
-
506
- 4. 風險评估
507
- ├─ 最高風險區域
508
- └─ 回滾策略
509
- ```
510
-
511
- ### 分工策略
512
-
513
- | 策略 | 使用时机 | 注意事项 |
514
- |-----|---------|---------|
515
- | **垂直切分** | 獨立模組 | 确保界面不变 |
516
- | **水平切分** | 跨模組重構(如命名规范)| 需嚴格同步 |
517
- | **Strangler 分工** | 大型系统替换 | 一人一个 Strangler 切片 |
518
- | **Mob Programming** | 核心/高風險區域 | 全团队一起,降低風險 |
519
-
520
- ### 溝通机制
521
-
522
- ```
523
- 日常溝通:
524
- ├─ 站立会議同步重構进度
525
- ├─ 共享的重構看板(Kanban)
526
- └─ 專用頻道(#refactoring-xxx)
527
-
528
- PR 规范:
529
- ├─ 標題加 [Refactor] 前綴
530
- ├─ 说明改了什麼以及为什麼
531
- ├─ 包含前後複雜度比較
532
- └─ 遺留程序码需要特徵测试
533
-
534
- 衝突处理:
535
- ├─ 小範圍:立即解决
536
- ├─ 中範圍:每日同步会議
537
- └─ 大範圍:考慮 Branch by Abstraction
538
- ```
539
-
540
- ### PR 大小指引
541
-
542
- | 大小 | 变更行數 | 审查时间 |
543
- |-----|---------|---------|
544
- | 小 | < 200 | < 30 分鐘 |
545
- | 中 | 200-500 | < 1 小时 |
546
- | 大 | > 500 | **应該拆分** |
547
-
548
- **原則**:多个小 PR > 一个大 PR
549
-
550
- ---
551
-
552
- ## 技術債管理
553
-
554
- ### 技術債象限
555
-
556
- 基於 Martin Fowler 的技術債象限:
557
-
558
- ```
559
- 刻意的
560
- │
561
- ┌────────────────┼────────────────┐
562
- │ │ │
563
- │ 审慎的 │ 魯莽的 │
564
- │ 「我們知道 │ 「我們没时间 │
565
- │ 这是債务」 │ 做设计」 │
566
- │ │ │
567
- 审慎的 ├────────────────┼────────────────┤ 魯莽的
568
- │ │ │
569
- │ 审慎的 │ 魯莽的 │
570
- │ 「現在我們 │ 「什麼是 │
571
- │ 知道該怎麼 │ 分层?」 │
572
- │ 做了」 │ │
573
- │ │ │
574
- └────────────────┼────────────────┘
575
- │
576
- 無意的
577
- ```
578
-
579
- ### 債务優先順序
580
-
581
- | 優先级 | 标准 | 行动 |
582
- |-------|------|-----|
583
- | **高** | 阻擋开发、導致頻繁 Bug | 立即处理 |
584
- | **中** | 拖慢开发、增加複雜度 | 排入下个 Sprint |
585
- | **低** | 小煩惱、影響隔離 | 隨机处理 |
586
-
587
- ### 追蹤技術債
588
-
589
- ```
590
- 每个債务项目记录:
591
- ├─ 描述:問題是什麼?
592
- ├─ 影響:如何影響开发?
593
- ├─ 估计工作量:修復需要多久?
594
- ├─ 忽视的風險:不处理会怎样?
595
- └─ 相关程序码:受影響的文件/模組連結
596
- ```
197
+ - [ ] 数据一致性验证
198
+ - [ ] 应用功能验证
199
+ - [ ] 性能基线比较
200
+ - [ ] 在回滚期间保留备份
597
201
 
598
202
  ---
599
203
 
600
204
  ## 相关标准
601
205
 
602
- - [测试驅动开发](test-driven-development.md) - TDD 循環包含重構阶段
603
- - [程序码审查清单](code-review-checklist.md) - 重構 PR 审查指引
604
- - [提交消息指南](commit-message-guide.md) - `refactor` 提交类型
605
- - [程序码簽入标准](checkin-standards.md) - 提交前要求
606
-
607
- ---
608
-
609
- ## 參考数据
610
-
611
- ### 書籍
612
-
613
- - Martin Fowler -《重構:改善既有程序的设计》第二版(2018)
614
- - Michael Feathers -《Working Effectively with Legacy Code》(2004)
615
- - Joshua Kerievsky -《Refactoring to Patterns》(2004)
616
-
617
- ### 文章
618
-
619
- - Martin Fowler - [Strangler Fig Application](https://martinfowler.com/bliki/StranglerFigApplication.html)
620
- - Martin Fowler - [Branch by Abstraction](https://martinfowler.com/bliki/BranchByAbstraction.html)
621
- - Pete Hodgson - [Feature Toggles](https://martinfowler.com/articles/feature-toggles.html)
622
- - Martin Fowler - [Technical Debt Quadrant](https://martinfowler.com/bliki/TechnicalDebtQuadrant.html)
623
-
624
- ### 工具
625
-
626
- - [Refactoring Guru](https://refactoring.guru/) - 重構技術目录
627
- - [SonarQube](https://www.sonarqube.org/) - 程序码品质与複雜度分析
628
- - [ApprovalTests](https://approvaltests.com/) - Golden Master 测试
206
+ - [测试驱动开发](test-driven-development.md) - 包含重构阶段的 TDD 循环
207
+ - [测试标准](testing-standards.md) - 用于锁定单一事实来源的 golden 测试与架构测试
208
+ - [测试治理](test-governance.md) - 在 CI 中管控语义重复与刻意分歧检查
209
+ - [代码审查检查清单](code-review-checklist.md) - 重构 PR 审查指引
210
+ - [提交信息指南](commit-message-guide.md) - `refactor` 提交类型
211
+ - [代码签入标准](checkin-standards.md) - 提交前要求
629
212
 
630
213
  ---
631
214
 
632
- ## 版本历程
215
+ ## 版本历史
633
216
 
634
217
  | 版本 | 日期 | 变更 |
635
- |-----|------|------|
636
- | 2.0.0 | 2026-01-21 | 重大重组:新增战术性策略(预备性重构、童子军规则)、防腐层、决策矩阵摘要。重组为战术性/战略性/安全防护三类。 |
218
+ |------|------|------|
219
+ | 2.2.0 | 2026-07-01 | 新增语义重复与复制漂移(issue #142):复制漂移反模式、单一事实来源 / 派生而非复制模式、刻意分歧登记表迁移推论;将重复指标拆分为文本与语义两类 |
220
+ | 2.1.0 | 2026-01-29 | 重构:拆分为规则 + 指南,将详细模式移至指南 |
221
+ | 2.0.0 | 2026-01-21 | 重大重组:新增战术性策略、防腐层 |
637
222
  | 1.0.0 | 2026-01-12 | 初始重构标准定义 |
638
223
 
639
224
  ---
640
225
 
641
226
  ## 授权
642
227
 
643
- 本标准以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权釋出。
228
+ 本标准以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权发布。