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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (688) hide show
  1. package/README.md +13 -3
  2. package/bin/uds.js +75 -3
  3. package/bundled/ai/options/code-review/pr-review.ai.yaml +20 -1
  4. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  5. package/bundled/ai/standards/ai-response-navigation.ai.yaml +43 -3
  6. package/bundled/ai/standards/checkin-standards.ai.yaml +25 -6
  7. package/bundled/ai/standards/code-review.ai.yaml +15 -2
  8. package/bundled/ai/standards/commit-message.ai.yaml +18 -4
  9. package/bundled/ai/standards/developer-memory.ai.yaml +12 -2
  10. package/bundled/ai/standards/full-coverage-testing.ai.yaml +86 -7
  11. package/bundled/ai/standards/open-work-tracking.ai.yaml +196 -11
  12. package/bundled/ai/standards/pipeline-security-gates.ai.yaml +53 -4
  13. package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
  14. package/bundled/core/ai-response-navigation.md +128 -12
  15. package/bundled/core/code-review-checklist.md +20 -2
  16. package/bundled/core/commit-message-guide.md +22 -19
  17. package/bundled/core/developer-memory.md +12 -2
  18. package/bundled/core/full-coverage-testing.md +99 -5
  19. package/bundled/core/open-work-tracking.md +157 -17
  20. package/bundled/core/pipeline-security-gates.md +63 -0
  21. package/bundled/core/project-context-memory.md +10 -2
  22. package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
  23. package/bundled/extensions/languages/csharp-style.md +464 -0
  24. package/bundled/extensions/languages/php-style.md +700 -0
  25. package/bundled/extensions/locales/zh-cn.md +717 -0
  26. package/bundled/extensions/locales/zh-tw.md +717 -0
  27. package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
  28. package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
  29. package/bundled/locales/COVERAGE.md +5 -4
  30. package/bundled/locales/zh-CN/CHANGELOG.md +199 -3
  31. package/bundled/locales/zh-CN/README.md +3 -3
  32. package/bundled/locales/zh-CN/SECURITY.md +3 -2
  33. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  34. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
  35. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  36. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
  37. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
  38. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
  39. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
  40. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  41. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  42. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  43. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  44. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  45. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  46. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  47. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  48. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  49. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  50. package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
  51. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  52. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  53. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  54. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  55. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  56. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  57. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  58. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  59. package/bundled/locales/zh-CN/core/code-review-checklist.md +54 -23
  60. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  61. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  62. package/bundled/locales/zh-CN/core/developer-memory.md +159 -60
  63. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  64. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  65. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  66. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  67. package/bundled/locales/zh-CN/core/full-coverage-testing.md +103 -9
  68. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  69. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  70. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  71. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  72. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  73. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  74. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  75. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  76. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  77. package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
  78. package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
  79. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  80. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  81. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  82. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  83. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  84. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  85. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  86. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  87. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  88. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  89. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  90. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  91. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  92. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  93. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  94. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  95. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  96. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  97. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  98. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  99. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  100. package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
  101. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +9 -3
  102. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  103. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +68 -33
  104. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +29 -15
  105. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  106. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
  107. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  108. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
  109. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  110. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  111. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +46 -0
  112. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  113. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  114. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  115. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  116. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  117. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  118. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  119. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  120. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  121. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  122. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  123. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  124. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  125. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  126. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  127. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  128. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  129. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  130. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  131. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  132. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  133. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  134. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  135. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  136. package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
  137. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  138. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  139. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  140. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  141. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  142. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  143. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  144. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  145. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  146. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  147. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  148. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  149. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  150. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  151. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  152. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  153. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  154. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  155. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  156. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  157. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  158. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  159. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  160. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  161. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  162. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  163. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  164. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  165. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  166. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  167. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  168. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  169. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  170. package/bundled/locales/zh-CN/skills/README.md +3 -1
  171. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  172. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  173. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  174. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  175. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  176. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  177. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  178. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  179. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  180. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  181. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  182. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  183. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  184. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  185. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  186. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  187. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  188. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  189. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  190. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  191. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  192. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  193. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  194. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  195. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  196. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  197. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  198. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  199. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  200. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  201. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  202. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  203. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  204. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  205. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  206. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  207. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  208. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  209. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  210. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  211. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  212. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  213. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  214. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  215. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  216. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  217. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  218. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  219. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  220. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  221. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  222. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  223. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  224. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  225. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  226. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  227. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  228. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  229. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  230. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  231. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  232. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  233. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  234. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  235. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  236. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  237. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  238. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  239. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  240. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  241. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  242. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  243. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  244. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  245. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -2
  246. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  247. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  248. package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
  249. package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
  250. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  251. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  252. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  253. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  254. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  255. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  256. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  257. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  258. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  259. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  260. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  261. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  262. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  263. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  264. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  265. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  266. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  267. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  268. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  269. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  270. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  271. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  272. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  273. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  274. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  275. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  276. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  277. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  278. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  279. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  280. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  281. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  282. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  283. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  284. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  285. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  286. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  287. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  288. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  289. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  290. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  291. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  292. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  293. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  294. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  295. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  296. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  297. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  298. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  299. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  300. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  301. package/bundled/locales/zh-TW/CHANGELOG.md +199 -3
  302. package/bundled/locales/zh-TW/README.md +3 -3
  303. package/bundled/locales/zh-TW/SECURITY.md +3 -2
  304. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  305. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
  306. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  307. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
  308. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
  309. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
  310. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
  311. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  312. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  313. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  314. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  315. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  316. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  317. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  318. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  319. package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
  320. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  321. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  322. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  323. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  324. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  325. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  326. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  327. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  328. package/bundled/locales/zh-TW/core/code-review-checklist.md +36 -7
  329. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  330. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  331. package/bundled/locales/zh-TW/core/developer-memory.md +111 -12
  332. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  333. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  334. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  335. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  336. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  337. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  338. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  339. package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
  340. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  341. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  342. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  343. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  344. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  345. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  346. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  347. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  348. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  349. package/bundled/locales/zh-TW/core/open-work-tracking.md +92 -16
  350. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  351. package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
  352. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  353. package/bundled/locales/zh-TW/core/project-context-memory.md +215 -31
  354. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  355. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  356. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  357. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  358. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  359. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  360. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  361. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  362. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  363. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  364. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  365. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  366. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  367. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  368. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  369. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  370. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  371. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  372. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  373. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  374. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  375. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  376. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  377. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  378. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  379. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  380. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  381. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  382. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  383. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  384. package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
  385. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +9 -3
  386. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  387. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +61 -26
  388. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  389. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +29 -15
  390. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  391. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
  392. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  393. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
  394. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  395. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  396. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +46 -0
  397. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  398. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  399. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  400. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  401. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  402. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  403. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  404. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  405. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  406. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  407. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  408. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  409. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  410. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  411. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  412. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  413. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  414. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  415. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  416. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  417. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  418. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  419. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  420. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  421. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  422. package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
  423. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  424. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  425. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  426. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  427. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  428. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  429. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  430. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  431. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  432. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  433. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  434. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  435. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  436. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  437. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  438. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  439. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  440. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  441. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  442. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  443. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  444. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  445. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  446. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  447. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  448. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  449. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  450. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  451. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  452. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  453. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  454. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  455. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  456. package/bundled/locales/zh-TW/skills/README.md +3 -1
  457. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  458. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  459. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  460. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  461. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  462. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  463. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  464. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  465. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  466. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  467. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  468. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  469. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  470. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  471. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  472. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  473. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  474. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  475. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  476. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  477. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  478. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  479. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  480. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  481. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  482. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  483. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  484. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  485. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  486. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  487. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  488. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  489. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  490. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  491. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  492. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  493. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  494. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  495. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  496. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  497. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  498. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  499. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  500. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  501. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  502. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  503. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  504. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  505. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  506. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  507. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  508. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  509. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  510. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  511. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  512. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  513. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  514. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  515. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  516. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  517. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  518. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  519. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  520. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  521. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  522. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  523. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  524. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  525. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  526. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  527. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  528. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  529. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  530. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  531. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  532. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  533. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  534. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  535. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  536. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  537. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  538. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  539. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  540. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  541. package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
  542. package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
  543. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  544. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  545. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  546. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  547. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  548. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  549. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  550. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  551. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  552. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  553. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  554. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  555. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  556. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  557. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  558. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  559. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  560. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  561. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  562. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  563. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  564. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  565. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  566. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  567. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  568. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  569. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  570. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  571. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  572. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  573. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  574. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  575. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  576. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  577. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  578. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  579. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  580. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  581. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  582. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  583. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  584. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  585. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  586. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  587. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  588. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  589. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  590. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  591. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  592. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  593. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  594. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  595. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  596. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  597. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  598. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  599. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  600. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  601. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  602. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  603. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  604. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  605. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  606. package/bundled/skills/README.md +1 -0
  607. package/bundled/skills/SKILL_NAMING.md +9 -0
  608. package/bundled/skills/commit-standards/SKILL.md +2 -2
  609. package/bundled/skills/commit-standards/guide.md +3 -2
  610. package/bundled/skills/commit-standards/language-options.md +19 -17
  611. package/bundled/skills/comprehension-ladder/SKILL.md +283 -0
  612. package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
  613. package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
  614. package/bundled/templates/gates/check-stubs.mjs +644 -0
  615. package/package.json +5 -3
  616. package/src/commands/audit.js +20 -2
  617. package/src/commands/check.js +155 -28
  618. package/src/commands/deps.js +31 -1
  619. package/src/commands/hitl.js +3 -0
  620. package/src/commands/init.js +159 -48
  621. package/src/commands/list.js +12 -3
  622. package/src/commands/mcp.js +2 -3
  623. package/src/commands/open-work.js +123 -0
  624. package/src/commands/quickstart.js +29 -13
  625. package/src/commands/release.js +102 -19
  626. package/src/commands/run-intent.js +10 -0
  627. package/src/commands/simulate.js +20 -8
  628. package/src/commands/skills.js +59 -33
  629. package/src/commands/spec-split.js +30 -17
  630. package/src/commands/spec.js +55 -21
  631. package/src/commands/uninstall.js +146 -32
  632. package/src/commands/update.js +471 -93
  633. package/src/core/install-records.js +192 -0
  634. package/src/core/manifest.js +12 -10
  635. package/src/core/marketplace-sentinel.js +5 -0
  636. package/src/core/open-work-config.js +122 -0
  637. package/src/core/project-config.js +92 -38
  638. package/src/flows/init-flow.js +10 -0
  639. package/src/hitl/manager.js +4 -2
  640. package/src/i18n/messages.js +413 -78
  641. package/src/installers/hooks-installer.js +236 -27
  642. package/src/installers/integration-installer.js +5 -1
  643. package/src/installers/skills-installer.js +3 -1
  644. package/src/installers/standards-installer.js +16 -23
  645. package/src/mcp/__tests__/server.test.js +0 -1
  646. package/src/mcp/server.js +16 -4
  647. package/src/prompts/init.js +148 -13
  648. package/src/reconciler/backup-locations.js +80 -0
  649. package/src/reconciler/backup-manager.js +451 -123
  650. package/src/reconciler/index.js +86 -10
  651. package/src/reconciler/install-roots.js +90 -0
  652. package/src/reconciler/plan-executor.js +37 -15
  653. package/src/uninstallers/hook-uninstaller.js +220 -33
  654. package/src/uninstallers/integration-uninstaller.js +35 -5
  655. package/src/uninstallers/skills-uninstaller.js +95 -16
  656. package/src/uninstallers/standards-uninstaller.js +56 -7
  657. package/src/utils/agents-installer.js +10 -17
  658. package/src/utils/available-standards-report.js +144 -0
  659. package/src/utils/available-standards.js +216 -0
  660. package/src/utils/command-hash-ownership.js +103 -0
  661. package/src/utils/commit-message-judge.js +155 -0
  662. package/src/utils/copier.js +80 -2
  663. package/src/utils/deps-applicability.js +25 -0
  664. package/src/utils/detector.js +46 -1
  665. package/src/utils/friction-detector.js +27 -0
  666. package/src/utils/gate-scripts.js +141 -0
  667. package/src/utils/git-hooks.js +139 -7
  668. package/src/utils/hasher.js +36 -0
  669. package/src/utils/health-scorer.js +10 -7
  670. package/src/utils/installed-names-ownership.js +114 -0
  671. package/src/utils/integration-generator.js +36 -24
  672. package/src/utils/legacy-hook-migration.js +112 -0
  673. package/src/utils/locale.js +19 -0
  674. package/src/utils/open-work-tracking.mjs +1754 -0
  675. package/src/utils/prompt-closed.js +18 -0
  676. package/src/utils/sdd-header.js +66 -0
  677. package/src/utils/skill-frontmatter.js +102 -0
  678. package/src/utils/skill-hash-ownership.js +64 -0
  679. package/src/utils/skill-name-collision.js +169 -0
  680. package/src/utils/skills-install-paths.js +114 -0
  681. package/src/utils/skills-installer.js +75 -106
  682. package/src/utils/standard-validator.js +98 -27
  683. package/src/utils/test-change-check.js +160 -0
  684. package/src/utils/test-policy.js +214 -0
  685. package/src/utils/transient-fs.js +113 -0
  686. package/src/utils/update-summary.js +29 -0
  687. package/src/vibe/micro-spec.js +15 -0
  688. package/standards-registry.json +48 -9
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/refactoring-standards.md
3
3
  source_version: 2.2.0
4
4
  translation_version: 2.2.0
5
- last_synced: 2026-07-01
5
+ last_synced: 2026-10-11
6
+ source_hash: e293ee5788ca
6
7
  status: current
7
8
  ---
8
9
 
@@ -12,99 +13,202 @@ status: current
12
13
 
13
14
  **版本**: 2.2.0
14
15
  **最後更新**: 2026-07-01
15
- **適用性**: 所有軟體專案
16
- **範圍**: 通用 (Universal)
16
+ **適用性**: 所有進行程式碼改善工作的軟體專案
17
+ **範圍**: 部分通用 (Partial)
18
+ **業界標準**: ISO/IEC 25010 可維護性
19
+
20
+ > **詳細模式與教學請參閱 [重構指南](guides/refactoring-guide.md)**
17
21
 
18
22
  ---
19
23
 
20
24
  ## 目的
21
25
 
22
- 本標準定義重構的時機、安全規則與決策矩陣。關於具體重構模式(如 Extract Method, Strangler Fig)的詳細教學,請參閱 **[重構指南](guides/refactoring-guide.md)**。
26
+ 本標準定義完整的程式碼重構指引,涵蓋從日常 TDD 重構循環到大規模遺留系統現代化的各種情境。
23
27
 
24
28
  ---
25
29
 
26
- ## 核心規則
30
+ ## 重構 vs. 重寫決策矩陣
27
31
 
28
- 1. **紅-綠-重構**: 只有在測試通過 (綠燈) 時才進行重構。
29
- 2. **不改變行為**: 重構應改善結構,而非改變外部行為。
30
- 3. **小步前進**: 偏好頻繁的小重構,而非大規模的「重寫」。
31
- 4. **童子軍法則**: 離開程式碼時,要比你發現它時更乾淨。
32
+ | 因素 | 傾向重構 | 傾向重寫 |
33
+ |------|----------|----------|
34
+ | **程式碼庫規模** | 大型、複雜 | 小型、獨立 |
35
+ | **測試覆蓋率** | 良好(>60%) | 不足或沒有 |
36
+ | **業務連續性** | 關鍵 | 可容忍停機 |
37
+ | **團隊知識** | 團隊了解程式碼 | 缺乏組織知識 |
38
+ | **核心架構** | 健全,只是雜亂 | 根本性缺陷 |
39
+ | **時間壓力** | 期限緊迫 | 時程彈性 |
40
+ | **風險容忍度** | 低 | 較高 |
32
41
 
33
42
  ---
34
43
 
35
- ## 何時重構 (觸發點)
44
+ ## 何時重構
36
45
 
37
- | 觸發點 | 說明 | 建議行動 |
38
- |--------|------|----------|
39
- | **三次法則** | 發現重複程式碼三次 | 提取共用方法或元件 |
40
- | **難以測試** | 程式碼依賴性太高或副作用太多 | 依賴注入、純函式化 |
41
- | **新增功能受阻** | 現有結構難以擴充 | 準備性重構 (Preparatory Refactoring) |
42
- | **Code Review** | 被指出可讀性差或複雜度高 | 修正後再合併 |
46
+ | 情境 | 建議策略 |
47
+ |------|----------|
48
+ | 功能開發受雜亂程式碼阻礙 | 準備性重構(Preparatory Refactoring) |
49
+ | 修 bug 時順手碰到程式碼 | 童子軍法則(Boy Scout Rule) |
50
+ | 以 TDD 撰寫新程式碼 | 紅-綠-重構(Red-Green-Refactor) |
51
+ | 替換整個遺留系統 | 絞殺者模式(Strangler Fig Pattern) |
52
+ | 需要與遺留系統整合但不被污染 | 防腐層(Anti-Corruption Layer) |
53
+ | 不使用 feature branch 重構共用程式碼 | 抽象分支(Branch by Abstraction) |
54
+ | 變更廣泛使用的介面 | 平行變更(Parallel Change,Expand-Migrate-Contract) |
55
+ | 處理沒有測試的遺留程式碼 | **先寫**特徵測試(Characterization Tests) |
43
56
 
44
57
  ---
45
58
 
46
- ## 程式碼異味 (Code Smell) 檢查清單
59
+ ## 策略摘要
47
60
 
48
- - [ ] **長函式 (Long Method)**: 超過 20-30 行?
49
- - [ ] **大類別 (Large Class)**: 承擔太多責任?
50
- - [ ] **重複程式碼 (Duplicated Code)**: 違反 DRY 原則?
51
- - [ ] **過多參數 (Long Parameter List)**: 超過 3-4 個參數?
52
- - [ ] **特徵依戀 (Feature Envy)**: 一個方法過度使用另一個類別的資料?
53
- - [ ] **魔法數字 (Magic Numbers)**: 未解釋的常數?
61
+ | 策略 | 規模 | 風險 | 時程 | 主要使用情境 |
62
+ |------|------|------|------|--------------|
63
+ | **準備性重構** | 小 | 低 | 數小時 | 功能開發前降低阻力 |
64
+ | **童子軍法則** | 極小 | 低 | 數分鐘 | 持續償還技術債 |
65
+ | **紅-綠-重構** | 小 | 低 | 5-15 分鐘 | TDD 開發循環 |
66
+ | **絞殺者模式** | 大 | 中 | 數月 | 系統替換 |
67
+ | **防腐層** | 中 | 低 | 數週 | 新舊系統共存 |
68
+ | **抽象分支** | 大 | 中 | 數週 | 在主幹上進行長期重構 |
69
+ | **平行變更** | 中 | 低 | 數天至數週 | 介面/schema 遷移 |
70
+ | **特徵測試** | — | — | — | **所有遺留程式碼重構的先決條件** |
54
71
 
55
72
  ---
56
73
 
57
- ## 重構安全網
74
+ ## 安全重構工作流程
75
+
76
+ ### 重構前
77
+
78
+ - [ ] 定義成功標準(可量測)
79
+ - [ ] 確保足夠的測試覆蓋率(建議 >80%)
80
+ - [ ] 提交或暫存目前的工作(乾淨的工作目錄)
81
+ - [ ] 建立 feature 分支(或在主幹上搭配功能開關)
82
+ - [ ] 與團隊溝通以避免衝突
83
+
84
+ ### 重構中
58
85
 
59
- 在重構遺留程式碼 (Legacy Code) 前,必須建立安全網:
86
+ - [ ] 一次只做**一個**小變更
87
+ - [ ] **每次**變更後都執行測試
88
+ - [ ] 測試失敗時**立即**還原
89
+ - [ ] 頻繁提交(每次測試通過都是一個存檔點)
90
+ - [ ] 重構時絕不新增功能
60
91
 
61
- 1. **確認現有測試**: 如果沒有測試,先寫測試(特徵測試 Characterization Tests)。
62
- 2. **自動化執行**: 確保測試可以一鍵執行且快速回饋。
63
- 3. **版本控制**: 確保在乾淨的 Git 狀態下開始。
92
+ ### 重構後
93
+
94
+ - [ ] 所有測試通過(與重構前相同)
95
+ - [ ] 程式碼有可量測的改善(複雜度、重複度等)
96
+ - [ ] 必要時更新文件
97
+ - [ ] 完成團隊審查
98
+ - [ ] 沒有新增任何功能
64
99
 
65
100
  ---
66
101
 
67
- ## 語意重複與 Copy-Drift(語意重複)
102
+ ## 程式碼品質指標
103
+
104
+ ### 目標指標
105
+
106
+ | 指標 | 目標 | 工具 |
107
+ |------|------|------|
108
+ | **循環複雜度(Cyclomatic Complexity)** | 每個函式 < 10 | 靜態分析 |
109
+ | **認知複雜度(Cognitive Complexity)** | 越低越好 | SonarQube |
110
+ | **程式碼重複(文字)** | < 3% | 靜態分析 |
111
+ | **語意重複** | 0 個未受管理的 domain fact | Golden / architecture test(見下文) |
112
+ | **測試覆蓋率** | ≥ 80% | 覆蓋率工具 |
68
113
 
69
- 文字重複(textual duplication)指標只能抓到逐字複製,卻抓不到更危險的情況:**同一個 domain fact 在多處被重複實作**。當這些實作不是逐字相同時(改寫過的分類邏輯、同一條公式在一處對一處錯、把 total 與它彙總的 rows 分開儲存),它們會通過靜態分析,然後**各自獨立地漂移**,產生看似無關、實則同源的一叢 bug。
114
+ > **文字重複 vs. 語意重複**:`程式碼重複` 指標只能偵測*文字*重複(幾乎相同的 token 序列),無法偵測*語意*重複——同一個 domain fact 在多處被重新實作,或 derived aggregate 被持久化卻沒有與來源的強制綁定。並非逐位元組相同的 copy(改寫過的邏輯、一處正確另一處錯誤的公式)會通過靜態分析,卻仍持續各自漂移。語意重複必須由 golden test 與 architecture test 治理(見[語意重複與 Copy-Drift](#語意重複與-copy-drift)),而非上述靜態分析門檻。
115
+
116
+ ### ISO/IEC 25010 可維護性目標
117
+
118
+ | 子特性 | 指標 | 目標 |
119
+ |--------|------|------|
120
+ | **模組化(Modularity)** | 耦合度、檔案大小 | 減少相依 |
121
+ | **可重用性(Reusability)** | 程式碼重複 | 提取方法、DRY |
122
+ | **可分析性(Analysability)** | 循環複雜度 | 簡化邏輯 |
123
+ | **可修改性(Modifiability)** | 內聚度、測試覆蓋率 | 單一職責 |
124
+ | **可測試性(Testability)** | 分支覆蓋率 | 依賴注入 |
125
+
126
+ ---
127
+
128
+ ## 語意重複與 Copy-Drift
129
+
130
+ 文字重複指標能抓到複製貼上,卻漏掉更危險的情況:**同一個 domain fact 在多處被實作**。當這些實作不是逐位元組相同時——改寫過的分類邏輯、一個 call site 正確而另一個有細微錯誤的公式、與其彙總的 rows 分開儲存的 total——它們會通過靜態分析,然後**各自獨立地漂移**,產生看似無關、實則同源的 bug。
70
131
 
71
132
  ### 反模式:Copy-Drift
72
133
 
73
134
  Copy-Drift 發生於下列任一情況:
74
135
 
75
136
  - 單一 domain fact(分類、規則、計算)被**在多個 call site 重複實作**,而非由單一共用單元計算;或
76
- - **derived value 被持久化**(stored aggregate、counter、denormalized 欄位)**卻無與來源綁定的強制關係**,使每條 write path 都能各自更新它。
137
+ - **derived value 被持久化**(stored aggregate、counter 或 denormalized 欄位)**卻沒有與來源的強制關係**,使每條 write path 都能各自更新它。
77
138
 
78
- 因為這些 copy 並非逐字相同,文字重複工具一個都抓不到。漂移會在稍後以不一致的形式浮現:list view 與 detail view 對不上、stored counter 因某條更新路徑的 decrement/rollback 分支被略過或被註解掉而重複計數、或同一條公式在不同模組給出不同答案。
139
+ 因為這些 copy 並非逐字相同,文字重複工具什麼都不會回報。漂移會在稍後以不一致的形式浮現:list view 與 detail view 對不上、stored counter 因某條更新路徑的 decrement 分支被註解掉而重複計數、或同一條公式在不同模組給出不同答案。
79
140
 
80
141
  ### 模式:Single Source of Truth / Derive-Don't-Duplicate
81
142
 
82
- - **每個 fact 只有一個單元**:把每個 domain fact 抽成**唯一**的 classifier / calculator / resolver;所有 call site 都呼叫它——不重實作、不改寫。
83
- - **優先 derive,不要 store**:優先在 read 時計算,而非持久化第二份 copy;永遠被 derive 的值不會漂移。
84
- - **若 aggregate 一定要存**,把它當成 detail rows 的 **projection**,並在**單一 choke point**(例如 `SaveChanges` interceptor,或單一共用 `recompute()` 函式)重算,讓**每一條** write path(含 async job 與 failure write-back)都走同一個重算路徑而保持一致。**絕不**讓個別 path 對 stored aggregate 做 incremental `col = col + delta` 調整;incremental 調整正是 decrement/rollback 分支被略過、counter 發生漂移的原因。
85
- - **用測試鎖定**:用 **golden test** 鎖定 single source of truth,並加一個 **architecture test**——若規則在別處被重新定義就 fail,讓未來的 copy 在 CI 被擋下,而非在 production 才發現。
143
+ - **每個 fact 只有一個單元**:把每個 domain fact 抽成**唯一**的 classifier / calculator / resolver;所有 call site 都呼叫它——不重新實作、不改寫。
144
+ - **Derive,不要 store**:優先在讀取時計算,而非持久化第二份 copy;永遠被 derive 的值不會漂移。
145
+ - **若 aggregate 一定要儲存**,把它當成其 detail rows 的 **projection**,並在**單一 choke point**(例如 `SaveChanges` interceptor,或單一共用 `recompute()` 函式)重算,讓**每一條** write path(含 async job 與 failure write-back)都經過同一個重算而保持一致。**絕不**讓個別 path 對 stored aggregate 套用 incremental `col = col + delta` 調整;incremental 調整正是 decrement/rollback 分支被略過、counter 發生漂移的原因。
146
+ - **用測試鎖定**:用 **golden test** 鎖定 single source of truth,並加上 **architecture test**——若規則在別處被重新定義就 fail,讓未來的 copy 在 CI 被擋下,而非在 production 才被發現。
86
147
 
87
148
  ### 遷移推論——Intentional-Divergence Registry(刻意偏離登記)
88
149
 
89
- 當新系統**刻意**偏離 legacy 行為時,必須登記——否則未來某次「修正」會靜默地把它回退掉。port 過程中常見的情況:legacy *函式*回傳 X,但 legacy *pipeline* 在下游把它調和成 Y;port 把這個調和折進單一單元,讓函式直接回傳 Y。
150
+ 當新系統**刻意**偏離 legacy 行為時,必須記錄下來——否則日後某次「修正」會靜默地把它回退。port 過程中常見的情況:legacy *函式*回傳 X,但下游的 legacy *pipeline* 把它調和成 Y;port 把這個調和折進單一單元,讓函式直接回傳 Y。
90
151
 
91
- - 把每個刻意偏離登記在 **intentional-divergence registry**(legacy 行為、new 行為、rationale、所屬 fact)。
92
- - 用 **golden test** 鎖定 new 行為,讓未來「修正」回 legacy 會讓 build fail。
93
- - 把 registry 餵給對 legacy 的任何 **differential test**,使該偏離被視為**預期**而非 regression。
152
+ - 把每個刻意偏離登記在 **intentional-divergence registry**(legacy 行為、新行為、理由、所屬 fact)。
153
+ - 用 **golden test** 鎖定新行為,讓未來「修正」回 legacy 時 build 會失敗。
154
+ - 把 registry 餵給任何對 legacy 的 **differential test**,使該偏離被視為*預期*,而非被標記為 regression。
94
155
 
95
156
  ### 給採用者的註記
96
157
 
97
- - per-function 的 legacy-vs-new diffing 只產出**候選**,非裁決;每個候選都要對照**整條** legacy pipeline(下游可能已調和該差異)裁決後,才能稱為 bug。
98
- - 用 programmatic / token-based 方式抽取 legacy 函式本體(不要手抄),避免在調查抄寫錯誤時又重新引入抄寫錯誤。
158
+ - per-function 的 legacy-vs-new diffing 產出的是**候選,而非裁決**。每個候選都必須對照**整條** legacy pipeline(而不只是那一個函式)裁決後,才能稱為 bug——legacy pipeline 可能已在下游調和了表面上的差異。
159
+ - 以 **programmatic / token-based** 方式(而非手抄)抽取 legacy 函式本體,避免在調查抄寫錯誤時又重新引入抄寫錯誤。
160
+
161
+ ---
162
+
163
+ ## PR 大小指引
164
+
165
+ | 大小 | 變更行數 | 審查時間 | 建議 |
166
+ |------|----------|----------|------|
167
+ | 小 | < 200 | < 30 分鐘 | ✅ 理想 |
168
+ | 中 | 200-500 | < 1 小時 | ⚠️ 可接受 |
169
+ | 大 | > 500 | — | ❌ **應拆分** |
170
+
171
+ **原則**:多個小 PR > 一個大 PR
172
+
173
+ ---
174
+
175
+ ## 技術債優先順序
176
+
177
+ | 優先級 | 判斷標準 | 行動 |
178
+ |--------|----------|------|
179
+ | **高** | 阻礙開發、頻繁造成 bug | 立即處理 |
180
+ | **中** | 拖慢開發、增加複雜度 | 規劃至下個 sprint |
181
+ | **低** | 輕微困擾、影響範圍有限 | 伺機處理 |
182
+
183
+ ---
184
+
185
+ ## 資料庫重構安全
186
+
187
+ ### 遷移前檢查清單
188
+
189
+ - [ ] 已完成完整備份
190
+ - [ ] 遷移腳本已在 staging 測試
191
+ - [ ] 已準備回滾腳本
192
+ - [ ] 已估算遷移時間
193
+ - [ ] 已公告維護時段
194
+
195
+ ### 遷移後檢查清單
196
+
197
+ - [ ] 資料一致性驗證
198
+ - [ ] 應用程式功能驗證
199
+ - [ ] 效能基準比較
200
+ - [ ] 備份保留至回滾期結束
99
201
 
100
202
  ---
101
203
 
102
204
  ## 相關標準
103
205
 
104
- - [重構指南](guides/refactoring-guide.md) - 詳細模式與教學
105
- - [測試標準](testing-standards.md) - golden test 與 architecture test 鎖定 single source of truth
206
+ - [測試驅動開發](test-driven-development.md) - 包含重構階段的 TDD 循環
207
+ - [測試標準](testing-standards.md) - 以 golden test 與 architecture test 鎖定 single source of truth
106
208
  - [測試治理](test-governance.md) - 在 CI 治理語意重複與 intentional-divergence 檢查
107
- - [程式碼審查清單](code-review-checklist.md)
209
+ - [程式碼審查清單](code-review-checklist.md) - 重構 PR 審查指引
210
+ - [Commit Message 指南](commit-message-guide.md) - `refactor` 提交類型
211
+ - [程式碼簽入標準](checkin-standards.md) - 提交前要求
108
212
 
109
213
  ---
110
214
 
@@ -112,9 +216,10 @@ Copy-Drift 發生於下列任一情況:
112
216
 
113
217
  | 版本 | 日期 | 變更 |
114
218
  |------|------|------|
115
- | 2.2.0 | 2026-07-01 | 新增「語意重複與 Copy-Drift」(issue #142):Copy-Drift 反模式、Single Source of Truth / Derive-Don't-Duplicate 模式、Intentional-Divergence Registry 遷移推論。 |
116
- | 2.0.0 | 2026-01-29 | **重大重構**:拆分為規則(本文件)和指南(refactoring-guide.md)。 |
117
- | 1.0.0 | 2025-12-15 | 初始版本 |
219
+ | 2.2.0 | 2026-07-01 | 新增「語意重複與 Copy-Drift」(issue #142):Copy-Drift 反模式、Single Source of Truth / Derive-Don't-Duplicate 模式、Intentional-Divergence Registry 遷移推論;將重複指標拆分為文字重複與語意重複 |
220
+ | 2.1.0 | 2026-01-29 | 重構:拆分為規則 + 指南,詳細模式移至指南 |
221
+ | 2.0.0 | 2026-01-21 | 重大重組:新增戰術性策略、防腐層 |
222
+ | 1.0.0 | 2026-01-12 | 初始重構標準定義 |
118
223
 
119
224
  ---
120
225
 
@@ -1,17 +1,18 @@
1
1
  ---
2
2
  source: ../../../core/requirement-engineering.md
3
- source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-03-24
6
- status: stale
3
+ source_version: 1.1.0
4
+ translation_version: 1.1.0
5
+ last_synced: 2026-10-11
6
+ source_hash: e8d346f82f79
7
+ status: current
7
8
  ---
8
9
 
9
10
  # 需求工程標準
10
11
 
11
12
  > **語言**: [English](../../../core/requirement-engineering.md) | 繁體中文
12
13
 
13
- **版本**: 1.0.0
14
- **最後更新**: 2026-01-28
14
+ **版本**: 1.1.0
15
+ **最後更新**: 2026-07-10
15
16
  **適用性**: 所有軟體專案
16
17
  **範圍**: 通用 (Universal)
17
18
  **業界標準**: IEEE 830-1998、IEEE 29148-2018、SWEBOK v4.0
@@ -23,7 +24,7 @@ status: stale
23
24
 
24
25
  需求工程是在整個開發生命週期中系統性地引出、分析、規格化和驗證軟體需求的過程。它提供撰寫、管理和驗證需求的理論基礎,基於業界標準包括 IEEE 830-1998、IEEE 29148-2018、SWEBOK v4.0 和 ISO/IEC 25010。
25
26
 
26
- 此過程涵蓋功能需求(系統應做什麼)、非功能需求(效能、安全、可用性等品質屬性)和約束條件。使用者故事(Agile 格式)搭配驗收條件(Given-When-Then)作為主要規格格式,透過 INVEST 準則驗證。
27
+ 此過程涵蓋功能需求(系統應做什麼)、非功能需求(效能、安全、可用性等品質屬性)和約束條件。使用者故事(Agile 格式)搭配驗收條件(Given-When-Then)作為主要規格格式,透過 INVEST 準則(Independent 獨立、Negotiable 可協商、Valuable 有價值、Estimable 可估算、Small 小型、Testable 可測試)驗證。
27
28
 
28
29
  ---
29
30
 
@@ -41,36 +42,6 @@ status: stale
41
42
  | **品質模型** | ISO/IEC 25010(8 個特徵) |
42
43
  | **標準** | IEEE 830、IEEE 29148、SWEBOK v4.0 |
43
44
 
44
- ## 使用者故事格式
45
-
46
- ```
47
- 作為 [角色]
48
- 我希望 [功能]
49
- 以便 [商業價值]
50
- ```
51
-
52
- ### INVEST 準則
53
-
54
- | 準則 | 說明 |
55
- |------|------|
56
- | **I**ndependent | 獨立 — 故事之間盡量獨立 |
57
- | **N**egotiable | 可協商 — 細節可以討論調整 |
58
- | **V**aluable | 有價值 — 對使用者或業務有價值 |
59
- | **E**stimable | 可估算 — 可以估算工作量 |
60
- | **S**mall | 小型 — 可在一個迭代內完成 |
61
- | **T**estable | 可測試 — 可以撰寫驗收條件 |
62
-
63
- ## 需求優先級
64
-
65
- ### MoSCoW 方法
66
-
67
- | 分類 | 說明 |
68
- |------|------|
69
- | **Must have** | 必要 — 沒有就無法發布 |
70
- | **Should have** | 應有 — 重要但可以延後 |
71
- | **Could have** | 可有 — 增值但非必要 |
72
- | **Won't have** | 不做 — 此版本明確排除 |
73
-
74
45
  ## 相關標準
75
46
 
76
47
  - [規格驅動開發](spec-driven-development.md)
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/retrospective-standards.md
3
3
  source_version: 1.1.0
4
4
  translation_version: 1.1.0
5
- last_synced: 2026-08-24
5
+ last_synced: 2026-10-11
6
+ source_hash: c2c2bb863693
6
7
  status: current
7
8
  ---
8
9
 
@@ -10,11 +11,12 @@ status: current
10
11
 
11
12
  > **語言**: [English](../../../core/retrospective-standards.md) | 繁體中文
12
13
 
13
- **版本**: 1.0.0
14
- **最後更新**: 2026-03-26
14
+ **版本**: 1.1.0
15
+ **最後更新**: 2026-08-24
15
16
  **適用範圍**: 所有實踐迭代開發的軟體團隊
16
17
  **範疇**: universal
17
18
  **產業標準**: Scrum Guide(Sprint 回顧)、CMMI Level 3、ISO/IEC 12207 §6.3.6
19
+ **參考資料**: [Scrum Guide](https://scrumguides.org/)、[Fun Retrospectives](https://www.funretrospectives.com/)
18
20
 
19
21
  ---
20
22
 
@@ -31,6 +33,15 @@ status: current
31
33
  | **Sprint** | 每個迭代結束 | 30-60 分鐘 | 團隊流程、協作、工具 |
32
34
  | **Release** | 每次發布後 | 60-90 分鐘 | 交付品質、循環指標、跨團隊協調 |
33
35
 
36
+ ### 與事後檢討(Post-Mortem)的區別
37
+
38
+ | 面向 | 回顧 | 事後檢討(事故) |
39
+ |------|------|------------------|
40
+ | **觸發** | 計畫性(迭代/發布結束時) | 反應性(事故發生後) |
41
+ | **基調** | 以改善為焦點 | 以根因為焦點 |
42
+ | **範圍** | 整個流程 | 特定事故 |
43
+ | **頻率** | 定期(每 1-4 週) | 視需要 |
44
+
34
45
  ---
35
46
 
36
47
  ## 回顧工作流程
@@ -40,12 +51,57 @@ PREPARE ──► GATHER ──► ANALYZE ──► DECIDE ──► TRACK
40
51
  準備資料 蒐集意見 分析歸納 決定行動 追蹤落實
41
52
  ```
42
53
 
54
+ ### 階段 1:PREPARE(準備)
55
+
56
+ 在會議前蒐集資料,讓討論以事實為基礎。
57
+
58
+ | 資料來源 | 要蒐集什麼 |
59
+ |----------|------------|
60
+ | Git log | Commit、已合併的 PR、分支 |
61
+ | Issue 追蹤系統 | 完成的故事、發現的 Bug |
62
+ | CI/CD | 建置成功率、部署頻率 |
63
+ | 指標 | Velocity、循環時間、測試覆蓋率 |
64
+
65
+ ### 階段 2:GATHER(蒐集)
66
+
67
+ 使用結構化技法蒐集團隊觀點(見下文)。
68
+
69
+ **基本規則:**
70
+ - 聚焦於流程,而非人
71
+ - 不指責——找出系統性原因
72
+ - 每個人都參與
73
+ - 每個段落都要控時
74
+
75
+ ### 階段 3:ANALYZE(分析)
76
+
77
+ 將相似項目分組,並找出跨主題的模式。
78
+
79
+ ### 階段 4:DECIDE(決定)
80
+
81
+ 選出前 1-3 項要聚焦的改善。每一項都成為一個行動項目。
82
+
83
+ **行動項目格式:**
84
+
85
+ | 欄位 | 說明 |
86
+ |------|------|
87
+ | **Action** | 具體、可執行的描述 |
88
+ | **Owner** | 單一負責人 |
89
+ | **Due Date** | 目標完成日期 |
90
+ | **Status** | Open → In Progress → Done |
91
+ | **Metric** | 如何衡量成功(選填) |
92
+
93
+ ### 階段 5:TRACK(追蹤)
94
+
95
+ 在下一次回顧開始時檢視先前的行動項目。
96
+
43
97
  ---
44
98
 
45
99
  ## 引導技法
46
100
 
47
101
  ### Start-Stop-Continue(預設)
48
102
 
103
+ 最簡單也最常見的技法。適合快速回顧。
104
+
49
105
  | 類別 | 問題 |
50
106
  |------|------|
51
107
  | **開始做** | 我們應該開始做什麼? |
@@ -54,6 +110,8 @@ PREPARE ──► GATHER ──► ANALYZE ──► DECIDE ──► TRACK
54
110
 
55
111
  ### Starfish
56
112
 
113
+ 比 Start-Stop-Continue 更細緻。適合較深入的分析。
114
+
57
115
  | 類別 | 問題 |
58
116
  |------|------|
59
117
  | **更多** | 什麼應該做更多? |
@@ -64,6 +122,8 @@ PREPARE ──► GATHER ──► ANALYZE ──► DECIDE ──► TRACK
64
122
 
65
123
  ### 4Ls
66
124
 
125
+ 聚焦於情緒與學習。適合團隊建立。
126
+
67
127
  | 類別 | 問題 |
68
128
  |------|------|
69
129
  | **喜歡** | 你享受什麼? |
@@ -73,12 +133,70 @@ PREPARE ──► GATHER ──► ANALYZE ──► DECIDE ──► TRACK
73
133
 
74
134
  ### 帆船法
75
135
 
136
+ 視覺化隱喻。適合富創意的團隊。
137
+
76
138
  | 元素 | 意義 |
77
139
  |------|------|
78
140
  | **風** | 推動我們前進的力量(優勢) |
79
141
  | **錨** | 拖住我們的力量(阻礙) |
80
142
  | **礁石** | 前方的風險 |
81
- | **島嶼** | 我們的目標 |
143
+ | **島嶼** | 我們的目標/目的地 |
144
+
145
+ ---
146
+
147
+ ## 回顧報告範本
148
+
149
+ ```markdown
150
+ # Retrospective: [Sprint N / Release vX.Y.Z]
151
+
152
+ - **Type**: [Sprint | Release]
153
+ - **Date**: YYYY-MM-DD
154
+ - **Participants**: [names]
155
+ - **Facilitator**: [name]
156
+ - **Technique**: [Start-Stop-Continue | Starfish | 4Ls | Sailboat]
157
+
158
+ ## Previous Action Items Review
159
+ | # | Action | Owner | Status | Notes |
160
+ |---|--------|-------|--------|-------|
161
+ | 1 | [from last retro] | [person] | Done/Open | [update] |
162
+
163
+ ## [Technique-specific sections]
164
+ (e.g., Start / Stop / Continue for SSC technique)
165
+
166
+ ## Action Items
167
+ | # | Action | Owner | Due Date | Status |
168
+ |---|--------|-------|----------|--------|
169
+ | 1 | [description] | [person] | YYYY-MM-DD | Open |
170
+
171
+ ## Key Learnings
172
+ - [learning 1]
173
+ - [learning 2]
174
+
175
+ ## Metrics Summary (Release retrospective only)
176
+ | Metric | This Release | Previous | Trend |
177
+ |--------|-------------|----------|-------|
178
+ | Velocity | [value] | [value] | ↑/↓/→ |
179
+ | Bug Rate | [value] | [value] | ↑/↓/→ |
180
+ | Test Coverage | [%] | [%] | ↑/↓/→ |
181
+ | Cycle Time | [days] | [days] | ↑/↓/→ |
182
+ ```
183
+
184
+ ---
185
+
186
+ ## 存放慣例
187
+
188
+ ```
189
+ docs/retrospectives/
190
+ ├── RETRO-2026-03-15-sprint-12.md
191
+ ├── RETRO-2026-03-26-release-v5.1.0.md
192
+ └── README.md # Index (optional)
193
+ ```
194
+
195
+ ### 檔案命名
196
+
197
+ - 格式:`RETRO-YYYY-MM-DD-[type]-[identifier].md`
198
+ - Sprint:`RETRO-2026-03-15-sprint-12.md`
199
+ - Release:`RETRO-2026-03-26-release-v5.1.0.md`
82
200
 
83
201
  ---
84
202
 
@@ -95,9 +213,9 @@ Open ──► In Progress ──► Done
95
213
  ### 追蹤規則
96
214
 
97
215
  1. 在每次回顧的**開頭**檢視所有未完成的行動項目。
98
- 2. 超過 **2 個回顧循環**仍未完成的項目應重新評估。
216
+ 2. 超過 **2 個回顧循環**仍未完成的項目應重新評估(升級處理、重新定義或取消)。
99
217
  3. 每次回顧最多 **3 個行動項目**。專注勝過廣度。
100
- 4. 每個行動項目必須有**單一負責人**。
218
+ 4. 每個行動項目必須有**單一負責人**(不能是「整個團隊」)。
101
219
 
102
220
  ---
103
221
 
@@ -109,7 +227,9 @@ Open ──► In Progress ──► Done
109
227
  | 指責 | 人們不再參與 | 執行「討論流程不討論人」規則 |
110
228
  | 沒有行動項目 | 回顧變成發洩 | 一定以 1-3 個具體行動結尾 |
111
229
  | 太多行動項目 | 什麼都做不完 | 最多 3 項,無情地排優先 |
112
- | 從不檢視過去的行動 | 行動被遺忘 | 每次回顧必先檢視 |
230
+ | 從不檢視過去的行動 | 行動被遺忘 | 每次回顧必先檢視先前的行動 |
231
+ | 永遠同一位引導者 | 觀點偏誤 | 輪替引導者角色 |
232
+ | 只有大聲的人發言 | 遺漏其他觀點 | 討論前先進行靜默書寫 |
113
233
 
114
234
  ---
115
235