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
@@ -2,7 +2,8 @@
2
2
  source: ../../../../skills/tdd-assistant/tdd-workflow.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-01-07
5
+ last_synced: 2026-10-11
6
+ source_hash: ec7c0482a527
6
7
  status: current
7
8
  ---
8
9
 
@@ -11,7 +12,7 @@ status: current
11
12
  > **语言**: [English](../../../../skills/tdd-assistant/tdd-workflow.md) | 简体中文
12
13
 
13
14
  **版本**: 1.0.0
14
- **最後更新**: 2026-01-07
15
+ **最后更新**: 2026-01-07
15
16
 
16
17
  ---
17
18
 
@@ -19,53 +20,53 @@ status: current
19
20
 
20
21
  ```
21
22
  ┌─────────────────────────────────────────────────────────────────────────────┐
22
- │ 完整 TDD 工作流程 │
23
+ │ 完整 TDD 工作流程 │
23
24
  ├─────────────────────────────────────────────────────────────────────────────┤
24
25
  │ │
25
26
  │ ┌───────────────┐ │
26
- │ │ 1. 理解需求 │ 阅读需求/spec/使用者故事 │
27
- │ │ │ 識别驗收标准 │
27
+ │ │ 1. 理解需求 │ 阅读需求/规格/用户故事 │
28
+ │ │ │ 识别验收标准 │
28
29
  │ └───────┬───────┘ │
29
30
  │ │ │
30
31
  │ ▼ │
31
32
  │ ┌───────────────┐ │
32
- │ │ 2. 列出测试 │ 腦力激盪测试案例 │
33
- │ │ 案例 │ 快樂路徑、邊界情况、错误 │
33
+ │ │ 2. 列出测试 │ 头脑风暴测试用例 │
34
+ │ │ 用例 │ 正常路径、边界情况、错误 │
34
35
  │ └───────┬───────┘ │
35
36
  │ │ │
36
37
  │ ▼ │
37
38
  │ ┌───────────────┐ │
38
- │ │ 3. 选择一个 │ 從最簡单的案例開始 │
39
- │ │ 测试 │ (通常是快樂路徑) │
39
+ │ │ 3. 选择一个 │ 从最简单的用例开始 │
40
+ │ │ 测试 │ (通常是正常路径) │
40
41
  │ └───────┬───────┘ │
41
42
  │ │ │
42
43
  │ ▼ │
43
44
  │ ┌───────────────┐ │
44
- │ │ 🔴 紅色 │ 撰写失败测试 │
45
- │ │ (1-5 分鐘) │ 验证它因正确原因失败 │
45
+ │ │ 🔴 RED │ 编写失败的测试 │
46
+ │ │ (1-5 分钟) │ 确认它因正确的原因失败 │
46
47
  │ └───────┬───────┘ │
47
48
  │ │ │
48
49
  │ ▼ │
49
50
  │ ┌───────────────┐ │
50
- │ │ 🟢 綠色 │ 撰写最少程序码讓它通過 │
51
- │ │ (1-10 分鐘) │ 「假裝」是可以的 │
51
+ │ │ 🟢 GREEN │ 编写让测试通过的最少代码 │
52
+ │ │ (1-10 分钟) │ 「先假装实现」是可以的 │
52
53
  │ └───────┬───────┘ │
53
54
  │ │ │
54
55
  │ ▼ │
55
56
  │ ┌───────────────┐ │
56
- │ │ 🔵 重構 │ 清理程序码 │
57
- │ │ (5-15 分鐘) │ 保持测试綠色 │
57
+ │ │ 🔵 REFACTOR │ 清理代码 │
58
+ │ │ (5-15 分钟) │ 保持测试为绿色 │
58
59
  │ └───────┬───────┘ │
59
60
  │ │ │
60
61
  │ ▼ │
61
62
  │ ┌───────────────┐ ┌─────────────────┐ │
62
- │ │ 还有更多测试?│─是─▶│ 返回步骤 3 │ │
63
- │ │ │ │ │ │
63
+ │ │ 还有测试? │─是──▶│ 返回 │ │
64
+ │ │ │ │ 步骤 3 │ │
64
65
  │ └───────┬───────┘ └─────────────────┘ │
65
66
  │ │ 否 │
66
67
  │ ▼ │
67
68
  │ ┌───────────────┐ │
68
- │ │ ✅ 完成 │ 所有驗收标准达成 │
69
+ │ │ ✅ 完成 │ 所有验收标准均已满足 │
69
70
  │ └───────────────┘ │
70
71
  │ │
71
72
  └─────────────────────────────────────────────────────────────────────────────┘
@@ -73,87 +74,87 @@ status: current
73
74
 
74
75
  ---
75
76
 
76
- ## 紅色阶段深入解析
77
+ ## 红灯阶段深入解析
77
78
 
78
- ### 目標
79
+ ### 目标
79
80
 
80
- 撰写一个测试:
81
- - 描述预期行为(非实作)
82
- - 因为**正确的原因**而失败
83
- - 有清楚、描述性的名称
81
+ 编写一个测试,它应当:
82
+ - 描述预期行为(而非实现方式)
83
+ - 因**正确的**原因而失败
84
+ - 具有清晰、具描述性的名称
84
85
 
85
86
  ### 逐步说明
86
87
 
87
- 1. **选择要测试什麼**
88
- - 從最簡单的場景開始
89
- - 專注於「一个」行为
88
+ 1. **选择要测试什么**
89
+ - 从最简单的场景开始
90
+ - 专注于「一个」行为
90
91
 
91
- 2. **撰写测试结构**
92
+ 2. **编写测试结构**
92
93
  ```typescript
93
94
  test('should [预期行为] when [条件]', () => {
94
- // Arrange - 设置测试数据
95
+ // Arrange - 准备测试数据
95
96
 
96
97
  // Act - 执行行为
97
98
 
98
- // Assert - 验证結果
99
+ // Assert - 验证结果
99
100
  });
100
101
  ```
101
102
 
102
- 3. **填写测试**
103
- - Arrange:建立测试数据和依賴
104
- - Act:呼叫被测试的方法/函式
105
- - Assert:验证预期結果
103
+ 3. **填写测试内容**
104
+ - Arrange:创建测试数据和依赖
105
+ - Act:调用被测试的方法/函数
106
+ - Assert:验证预期结果
106
107
 
107
- 4. **执行测试**
108
- - 它应該「失败」
109
- - 验证失败是因为正确的原因
108
+ 4. **运行测试**
109
+ - 它应该「失败」
110
+ - 确认失败是因为正确的原因
110
111
 
111
- ### 常見错误
112
+ ### 常见错误
112
113
 
113
- | 错误 | 範例 | 修復 |
114
- |------|------|------|
115
- | **斷言太多** | 在一个测试中测试 5 件事 | 每个测试一个行为 |
116
- | **模糊的测试名称** | `test('works')` | `test('should return sum of two numbers')` |
117
- | **無斷言** | 缺少 `expect()` | 始終斷言预期結果 |
118
- | **测试实作** | 检查私有方法呼叫 | 测试可觀察的行为 |
119
- | **测试已經通過** | 测试現有行为 | 为「新」行为撰写 |
114
+ | 错误 | 示例 | 修正方式 |
115
+ |------|------|----------|
116
+ | **断言过多** | 在一个测试中测试 5 件事 | 每个测试只测一个行为 |
117
+ | **测试名称模糊** | `test('works')` | `test('should return sum of two numbers')` |
118
+ | **没有断言** | 缺少 `expect()` | 始终断言预期结果 |
119
+ | **测试实现细节** | 检查私有方法调用 | 测试可观察的行为 |
120
+ | **测试一开始就通过** | 测试已有的行为 | 针对「新」行为编写 |
120
121
 
121
- ### 紅色阶段检查清单
122
+ ### 红灯阶段检查清单
122
123
 
123
124
  ```
124
125
  □ 测试名称清楚描述行为
125
126
  □ 测试遵循 AAA 模式
126
- □ 测试只有「一个」斷言(或相关群組)
127
- □ 测试执行时「失败」
128
- □ 失败消息清楚
129
- □ 失败是因为「正确的原因」(非語法错误)
127
+ □ 测试只有「一个」断言(或一组相关断言)
128
+ □ 运行时测试「失败」
129
+ □ 失败信息清楚
130
+ □ 失败是因为「正确的原因」(而非语法错误)
130
131
  ```
131
132
 
132
133
  ---
133
134
 
134
- ## 綠色阶段深入解析
135
+ ## 绿灯阶段深入解析
135
136
 
136
- ### 目標
137
+ ### 目标
137
138
 
138
- 撰写**最少**的程序码讓测试通過。
139
+ 编写让测试通过的**最少**代码。
139
140
 
140
141
  ### 逐步说明
141
142
 
142
- 1. **分析失败**
143
- - 测试期望什麼?
144
- - 提供它的最簡单方式是什麼?
143
+ 1. **分析失败原因**
144
+ - 测试期望的是什么?
145
+ - 满足它最简单的方式是什么?
145
146
 
146
- 2. **撰写最少程序码**
147
- - 对於第一个测试,硬编码是可以的
148
- - 不要预期未來的需求
147
+ 2. **编写最少代码**
148
+ - 第一个测试可以硬编码
149
+ - 不要预先考虑未来的需求
149
150
 
150
- 3. **执行测试**
151
- - 它应該「通過」
152
- - 所有其他测试应該仍然通過
151
+ 3. **运行测试**
152
+ - 它应该「通过」
153
+ - 其他所有测试应该仍然通过
153
154
 
154
- ### 「假裝」策略
155
+ ### 「先假装实现」策略
155
156
 
156
- 对於第一个测试,假裝实現是完全可以的:
157
+ 对于第一个测试,假装实现是完全可以的:
157
158
 
158
159
  ```typescript
159
160
  // 测试:should return sum of 2 and 3
@@ -161,326 +162,507 @@ test('should return sum of two numbers', () => {
161
162
  expect(add(2, 3)).toBe(5);
162
163
  });
163
164
 
164
- // 第一个实現(假裝!)
165
+ // 第一个实现(假装实现!)
165
166
  function add(a: number, b: number): number {
166
- return 5; // 只回传预期值
167
+ return 5; // 直接返回预期值
167
168
  }
168
169
  ```
169
170
 
170
- 然後新增更多测试來強制泛化:
171
+ 然后添加更多测试来迫使实现泛化:
171
172
 
172
173
  ```typescript
173
- // 第二个测试強制真正的实現
174
+ // 第二个测试迫使真正的实现
174
175
  test('should return sum of 1 and 1', () => {
175
176
  expect(add(1, 1)).toBe(2);
176
177
  });
177
178
 
178
- // 現在我們必須泛化
179
+ // 现在必须泛化
179
180
  function add(a: number, b: number): number {
180
181
  return a + b;
181
182
  }
182
183
  ```
183
184
 
184
- ### 綠色阶段检查清单
185
+ ### 常见错误
186
+
187
+ | 错误 | 示例 | 修正方式 |
188
+ |------|------|----------|
189
+ | **过度设计** | 添加目前还不需要的功能 | 只为当前测试编写代码 |
190
+ | **过早优化** | 性能调优 | 先让它能运行 |
191
+ | **添加错误处理** | 为未测试的情况加 try-catch | 只处理已测试的错误 |
192
+ | **复制大段代码** | 从其他项目复制 | 编写最少的代码 |
193
+
194
+ ### 绿灯阶段检查清单
185
195
 
186
196
  ```
187
- □ 撰写了「最少」程序码讓测试通過
188
- □ 没有新增测试不需要的功能
189
- □ 當前测试通過
190
- □ 所有其他测试仍然通過
191
- □ 没有過早優化
197
+ □ 编写了「最少」的代码让测试通过
198
+ □ 没有添加测试不需要的功能
199
+ □ 当前测试通过
200
+ □ 其他所有测试仍然通过
201
+ □ 没有过早优化
192
202
  ```
193
203
 
194
204
  ---
195
205
 
196
- ## 重構阶段深入解析
206
+ ## 重构阶段深入解析
197
207
 
198
- ### 目標
208
+ ### 目标
199
209
 
200
- 在保持所有测试綠色的同时改善程序码品质。
210
+ 在保持所有测试为绿色的同时改善代码质量。
201
211
 
202
212
  ### 逐步说明
203
213
 
204
- 1. **識别程序码異味**
205
- - 重複
206
- - 過長方法
214
+ 1. **识别代码坏味道**
215
+ - 重复
216
+ - 过长的方法
207
217
  - 命名不佳
208
- - 複雜条件
218
+ - 复杂的条件判断
209
219
 
210
- 2. **选择「一个」改善**
211
- - 不要試图一次修復所有東西
220
+ 2. **选择「一项」改进**
221
+ - 不要试图一次修好所有问题
212
222
 
213
- 3. **进行变更**
214
- - 小的、漸进的变更
223
+ 3. **进行修改**
224
+ - 小步、渐进式的修改
215
225
 
216
- 4. **立即执行测试**
217
- - 如果测试失败,立即復原
226
+ 4. **立即运行测试**
227
+ - 如果测试失败,立即回退
218
228
 
219
- 5. **如有需要重複**
229
+ 5. **视需要重复**
220
230
 
221
- ### 常見重構
231
+ ### 常见重构手法
222
232
 
223
- | 技術 | 使用时机 | 範例 |
224
- |------|---------|------|
225
- | **提取方法** | 過長方法、重複程序码 | 將 10 行提取到 `calculateTax()` |
226
- | **重新命名** | 不清楚的名称 | `x` → `totalAmount` |
227
- | **內联** | 不必要的间接 | 移除包裝函式 |
228
- | **提取变數** | 複雜表达式 | `const isEligible = age >= 18 && hasId` |
229
- | **取代魔術數字** | 硬编码值 | `7` → `DAYS_IN_WEEK` |
233
+ | 手法 | 适用时机 | 示例 |
234
+ |------|----------|------|
235
+ | **提取方法** | 方法过长、代码重复 | 把 10 行提取到 `calculateTax()` |
236
+ | **重命名** | 名称不清楚 | `x` → `totalAmount` |
237
+ | **内联** | 不必要的间接层 | 移除包装函数 |
238
+ | **提取变量** | 表达式复杂 | `const isEligible = age >= 18 && hasId` |
239
+ | **替换魔法数字** | 硬编码的值 | `7` → `DAYS_IN_WEEK` |
230
240
 
231
- ### 重構安全規則
241
+ ### 重构安全规则
232
242
 
233
243
  ```
234
- 1. 開始前测试是綠色
235
- 2. 一次做「一个」变更
236
- 3. 「每次」变更後执行测试
237
- 4. 如果测试「失败」→ 立即「復原」
238
- 5. 重構时絕不新增功能
244
+ 1. 开始前测试为「绿色」
245
+ 2. 一次只做「一个」修改
246
+ 3. 「每次」修改后都运行测试
247
+ 4. 如果测试「失败」→ 立即「回退」
248
+ 5. 重构时绝不添加新功能
239
249
  ```
240
250
 
241
- ### 重構阶段检查清单
251
+ ### 常见错误
252
+
253
+ | 错误 | 示例 | 修正方式 |
254
+ |------|------|----------|
255
+ | **跳过此阶段** | 直接进入下一个测试 | 始终寻找改进空间 |
256
+ | **一次修改太多** | 同时重构 5 处 | 一次只做一个修改 |
257
+ | **添加功能** | 「既然都改到这里了……」 | 只清理现有代码 |
258
+ | **不运行测试** | 到最后才一起运行 | 每次修改后都运行 |
259
+
260
+ ### 重构阶段检查清单
242
261
 
243
262
  ```
244
- □ 開始前所有测试綠色
245
- □ 識别了具体的改善
246
- □ 做了「一个」小变更
247
- □ 测试仍然綠色
248
- □ 程序码更乾淨/簡单
249
- □ 没有新增功能
250
- □ 对其他改善重複
263
+ □ 开始前所有测试为「绿色」
264
+ □ 已识别具体的改进点
265
+ □ 做了「一个」小修改
266
+ □ 测试仍然为「绿色」
267
+ □ 代码更整洁/更简单
268
+ □ 没有添加新功能
269
+ □ 对其他改进点重复上述步骤
251
270
  ```
252
271
 
253
272
  ---
254
273
 
255
274
  ## BDD 工作流程
256
275
 
257
- ### Gherkin 語法
276
+ ### Gherkin 语法
258
277
 
259
278
  ```gherkin
260
279
  Feature: [功能名称]
261
280
  As a [角色]
262
- I want [目標]
281
+ I want [目标]
263
282
  So that [好处]
264
283
 
265
284
  Background:
266
- Given [所有場景的共同设置]
285
+ Given [所有场景共用的准备]
267
286
 
268
- Scenario: [場景名称]
287
+ Scenario: [场景名称]
269
288
  Given [初始情境]
270
289
  And [更多情境]
271
290
  When [动作]
272
291
  And [更多动作]
273
- Then [预期結果]
274
- And [更多結果]
292
+ Then [预期结果]
293
+ And [更多结果]
275
294
 
276
- Scenario Outline: [參數化場景]
277
- Given [帶有 <參數> 的情境]
295
+ Scenario Outline: [参数化场景]
296
+ Given [带有 <parameter> 的情境]
278
297
  When [动作]
279
- Then [帶有 <预期> 的結果]
298
+ Then [带有 <expected> 的结果]
280
299
 
281
300
  Examples:
282
- | 參數 | 预期 |
283
- | 值1 | 結果1 |
284
- | 值2 | 結果2 |
301
+ | parameter | expected |
302
+ | value1 | result1 |
303
+ | value2 | result2 |
285
304
  ```
286
305
 
287
306
  ### BDD 工作流程步骤
288
307
 
289
308
  ```
290
309
  ┌─────────────────────────────────────────────────────────────────┐
291
- │ BDD 工作流程 │
310
+ │ BDD 工作流程 │
292
311
  ├─────────────────────────────────────────────────────────────────┤
293
312
  │ │
294
- │ 1. 探索会議 │
295
- │ ├─ 开发者、BA、QA、利益相关者一起 │
296
- │ ├─ 討論使用者故事 │
297
- │ └─ 識别驗收标准 │
313
+ │ 1. 探索会议(Discovery Session) │
314
+ │ ├─ 开发人员、BA、QA、利益相关者一起参与 │
315
+ │ ├─ 讨论用户故事 │
316
+ │ └─ 识别验收标准 │
298
317
  │ │
299
- │ 2. 制定 │
300
- │ ├─ 用 Gherkin 撰写場景 │
301
- │ ├─ 每个 AC → 一个或多个場景 │
302
- │ └─ 与团队审查 │
318
+ │ 2. 制定(Formulation) │
319
+ │ ├─ 用 Gherkin 编写场景 │
320
+ │ ├─ 每个 AC → 一个或多个场景 │
321
+ │ └─ 与团队一起评审 │
303
322
  │ │
304
- │ 3. 自动化 │
305
- │ ├─ 建立 step definitions │
306
- │ ├─ 每个 step → 执行該步骤的程序码 │
307
- │ └─ 为 step 实現使用 TDD │
323
+ │ 3. 自动化(Automation) │
324
+ │ ├─ 创建 step definitions │
325
+ │ ├─ 每个 step → 执行该步骤的代码 │
326
+ │ └─ 用 TDD 实现各个 step │
308
327
  │ │
309
- │ 4. 实現 │
310
- │ ├─ 执行場景(它們失败 - 紅色) │
311
- │ ├─ 实現功能程序码(綠色) │
312
- │ └─ 重構 │
328
+ │ 4. 实现(Implementation) │
329
+ │ ├─ 运行场景(它们会失败 - RED) │
330
+ │ ├─ 实现功能代码(GREEN) │
331
+ │ └─ 重构 │
313
332
  │ │
314
- │ 5. 活文件 │
315
- │ └─ 場景作为始終最新的文件 │
333
+ │ 5. 活文档(Living Documentation) │
334
+ │ └─ 场景作为始终保持最新的文档 │
316
335
  │ │
317
336
  └─────────────────────────────────────────────────────────────────┘
318
337
  ```
319
338
 
339
+ ### Step Definitions 示例(JavaScript/Cucumber)
340
+
341
+ ```javascript
342
+ const { Given, When, Then } = require('@cucumber/cucumber');
343
+
344
+ Given('I have a shopping cart with {int} items', async function (count) {
345
+ this.cart = new ShoppingCart();
346
+ for (let i = 0; i < count; i++) {
347
+ this.cart.addItem({ name: `Item ${i}`, price: 10 });
348
+ }
349
+ });
350
+
351
+ When('I apply discount code {string}', async function (code) {
352
+ this.result = await this.cart.applyDiscount(code);
353
+ });
354
+
355
+ Then('the cart total should be {float}', function (expectedTotal) {
356
+ expect(this.cart.getTotal()).toBeCloseTo(expectedTotal, 2);
357
+ });
358
+ ```
359
+
360
+ ### BDD 最佳实践
361
+
362
+ | 实践 | 说明 |
363
+ |------|------|
364
+ | **声明式优于命令式** | 描述「做什么」,而不是「怎么做」 |
365
+ | **业务语言** | 避免技术术语 |
366
+ | **场景相互独立** | 每个场景都自成一体 |
367
+ | **步骤精简** | 每个场景 5-10 个步骤 |
368
+ | **步骤可复用** | 编写通用的 step definitions |
369
+
370
+ ```gherkin
371
+ # ❌ 命令式(过于细节)
372
+ Scenario: Login
373
+ Given I navigate to "http://example.com/login"
374
+ And I click on the username field
375
+ And I type "john@example.com"
376
+ And I click on the password field
377
+ And I type "secret123"
378
+ And I click the "Login" button
379
+ Then I see "Welcome John"
380
+
381
+ # ✅ 声明式(聚焦行为)
382
+ Scenario: Successful login
383
+ Given I am on the login page
384
+ When I login with valid credentials
385
+ Then I should see my dashboard
386
+ ```
387
+
320
388
  ---
321
389
 
322
390
  ## ATDD 工作流程
323
391
 
324
- ### 驗收标准格式
392
+ ### 验收标准格式
325
393
 
326
394
  ```markdown
327
- ## 使用者故事
395
+ ## 用户故事
328
396
 
329
397
  **作为** [角色]
330
398
  **我想要** [功能]
331
399
  **以便** [好处]
332
400
 
333
- ## 驗收标准
401
+ ## 验收标准
334
402
 
335
403
  ### AC-1:[标准名称]
336
404
  **Given** [前置条件]
337
405
  **When** [动作]
338
- **Then** [预期結果]
406
+ **Then** [预期结果]
339
407
 
340
408
  ### AC-2:[标准名称]
341
409
  **Given** [前置条件]
342
410
  **When** [动作]
343
- **Then** [预期結果]
411
+ **Then** [预期结果]
344
412
 
345
- ## 不在範圍內
413
+ ## 不在范围内
346
414
  - [明确不包含的事项]
347
415
 
348
- ## 技術备註
349
- - [实現提示、約束]
416
+ ## 技术备注
417
+ - [实现提示、约束]
350
418
  ```
351
419
 
352
420
  ### ATDD 工作流程步骤
353
421
 
354
422
  ```
355
423
  ┌─────────────────────────────────────────────────────────────────┐
356
- │ ATDD 工作流程 │
424
+ │ ATDD 工作流程 │
357
425
  ├─────────────────────────────────────────────────────────────────┤
358
426
  │ │
359
- │ 1. 規格研討会 │
360
- │ ├─ 产品負責人展示使用者故事 │
361
- │ ├─ 团队提出澄清問題 │
362
- │ ├─ 一起定義驗收标准 │
363
- │ └─ 为每个 AC 撰写範例 │
427
+ │ 1. 规格研讨会(Specification Workshop) │
428
+ │ ├─ 产品负责人介绍用户故事 │
429
+ │ ├─ 团队提出澄清问题 │
430
+ │ ├─ 共同定义验收标准 │
431
+ │ └─ 为每个 AC 编写示例 │
364
432
  │ │
365
- │ 2. 精煉 │
366
- │ ├─ 將範例转换为可执行测试 │
367
- │ ├─ 消除歧義 │
368
- │ └─ 取得产品負責人簽核 │
433
+ │ 2. 提炼(Distillation) │
434
+ │ ├─ 把示例转换为可执行的测试 │
435
+ │ ├─ 消除歧义 │
436
+ │ └─ 取得产品负责人签核 │
369
437
  │ │
370
- │ 3. 开发 │
371
- │ ├─ 驗收测试是紅色 │
372
- │ ├─ 为功能层级测试使用 BDD │
373
- │ ├─ 为单元层级测试使用 TDD │
374
- │ └─ 驗收测试变成綠色 │
438
+ │ 3. 开发(Development) │
439
+ │ ├─ 验收测试为 RED │
440
+ │ ├─ 功能层级测试使用 BDD │
441
+ │ ├─ 单元层级测试使用 TDD │
442
+ │ └─ 验收测试变为 GREEN │
375
443
  │ │
376
- │ 4. 展示 │
377
- │ ├─ 展示通過的驗收测试 │
378
- │ ├─ 产品負責人验证 │
379
- │ └─ 接受或精煉标准 │
444
+ │ 4. 演示(Demo) │
445
+ │ ├─ 展示已通过的验收测试 │
446
+ │ ├─ 产品负责人确认 │
447
+ │ └─ 接受或细化标准 │
380
448
  │ │
381
449
  └─────────────────────────────────────────────────────────────────┘
382
450
  ```
383
451
 
452
+ ### AC 与测试的对应
453
+
454
+ | 验收标准 | 测试层级 | 工具 |
455
+ |----------|----------|------|
456
+ | 面向用户的行为 | 验收测试 | FitNesse, Cucumber |
457
+ | 功能行为 | BDD | Cucumber, SpecFlow |
458
+ | 单元逻辑 | TDD | Jest, xUnit |
459
+ | API 契约 | 集成测试 | Supertest, REST Assured |
460
+
384
461
  ---
385
462
 
386
463
  ## 团队协作模式
387
464
 
388
- ### 使用 TDD 的結对程序设计
465
+ ### 结合 TDD 的结对编程
389
466
 
390
467
  #### 乒乓模式
391
468
 
392
469
  ```
393
470
  ┌─────────────────────────────────────────────────────────────────┐
394
- │ 乒乓 TDD │
471
+ │ 乒乓 TDD(Ping-Pong) │
472
+ ├─────────────────────────────────────────────────────────────────┤
473
+ │ │
474
+ │ 开发人员 A 开发人员 B │
475
+ │ ─────────── ─────────── │
476
+ │ 1. 编写失败的测试 ──────────────────────────▶ │
477
+ │ ◀───────────────────── 2. 让它通过 │
478
+ │ ◀───────────────────── 3. 编写测试 │
479
+ │ 4. 让它通过 ────────────────────────────────▶ │
480
+ │ 5. 编写测试 ────────────────────────────────▶ │
481
+ │ ◀───────────────────── 6. 让它通过 │
482
+ │ │
483
+ │ 任何一方都可以随时重构 │
484
+ │ │
485
+ └─────────────────────────────────────────────────────────────────┘
486
+ ```
487
+
488
+ **好处**:
489
+ - 双方始终保持投入
490
+ - 知识共享
491
+ - 及早发现错误
492
+
493
+ #### 驾驶员-领航员模式
494
+
495
+ ```
496
+ ┌─────────────────────────────────────────────────────────────────┐
497
+ │ 驾驶员-领航员 TDD │
395
498
  ├─────────────────────────────────────────────────────────────────┤
396
499
  │ │
397
- │ 开发者 A 开发者 B │
398
- │ ───────── ───────── │
399
- │ 1. 撰写失败测试 ──────────────────────▶ │
400
- │ ◀────────────────────── 2. 讓它通過 │
401
- │ ◀────────────────────── 3. 撰写测试 │
402
- │ 4. 讓它通過 ────────────────────────────▶ │
403
- │ 5. 撰写测试 ────────────────────────────▶ │
404
- │ ◀────────────────────── 6. 讓它通過 │
500
+ │ 驾驶员(键盘) 领航员(思考) │
501
+ │ ───────────────── ─────────────────── │
502
+ │ - 输入代码 - 思考设计 │
503
+ │ - 专注于语法 - 考虑测试用例 │
504
+ │ - 实现想法 - 检查错误 │
505
+ │ - 提出问题 - 建议方向 │
405
506
  │ │
406
- │ 任一方都可以隨时重構 │
507
+ │ 每 15-30 分钟交换角色 │
407
508
  │ │
408
509
  └─────────────────────────────────────────────────────────────────┘
409
510
  ```
410
511
 
411
- #### 駕駛員-領航員模式
512
+ **好处**:
513
+ - 角色清晰
514
+ - 领航员可以进行策略性思考
515
+ - 持续评审
516
+
517
+ ### 结合 TDD 的群体编程
412
518
 
413
519
  ```
414
520
  ┌─────────────────────────────────────────────────────────────────┐
415
- │ 駕駛員-領航員 TDD │
521
+ │ 群体编程 TDD(Mob Programming) │
416
522
  ├─────────────────────────────────────────────────────────────────┤
417
523
  │ │
418
- │ 駕駛員(鍵盤) 領航員(思考) │
419
- │ ───────────── ─────────────── │
420
- │ - 打字程序码 - 思考设计 │
421
- │ - 專注於語法 - 考慮测试案例 │
422
- │ - 实現想法 - 检查错误 │
423
- │ - 提問 - 建议方向 │
524
+ │ 团队(3-6 人) │
525
+ │ ───────────────── │
526
+ │ - 一名驾驶员(负责输入) │
527
+ │ - 多名领航员(负责引导) │
528
+ │ - 每 5-10 分钟轮换驾驶员 │
424
529
  │ │
425
- │ 每 15-30 分鐘交换角色 │
530
+ │ TDD 流程: │
531
+ │ 1. 团队讨论下一个测试 │
532
+ │ 2. 驾驶员编写测试(领航员引导) │
533
+ │ 3. 团队确认测试失败 │
534
+ │ 4. 团队讨论实现方式 │
535
+ │ 5. 驾驶员实现(领航员引导) │
536
+ │ 6. 轮换驾驶员 │
537
+ │ 7. 下一位成员进行重构或编写下一个测试 │
426
538
  │ │
427
539
  └─────────────────────────────────────────────────────────────────┘
428
540
  ```
429
541
 
542
+ **好处**:
543
+ - 全团队认知一致
544
+ - 集体所有权
545
+ - 实时知识传递
546
+
430
547
  ---
431
548
 
432
549
  ## CI/CD 集成
433
550
 
434
- ### 管线结构
551
+ ### 流水线结构
435
552
 
436
553
  ```yaml
437
554
  stages:
438
- - test:unit # 快速 (< 2 分鐘)
439
- - test:integration # 中等 (< 10 分鐘)
440
- - test:e2e # 慢速 (< 30 分鐘)
555
+ - test:unit # 快速 (< 2 分钟)
556
+ - test:integration # 中等 (< 10 分钟)
557
+ - test:e2e # 慢速 (< 30 分钟)
441
558
  - coverage-check
442
559
  - deploy
443
560
  ```
444
561
 
445
- ### 品质門檻
562
+ ### 质量门禁
446
563
 
447
- | 門檻 | 閾值 | 失败时动作 |
448
- |------|------|-----------|
449
- | 单元测试通過率 | 100% | 阻止合併 |
450
- | 集成测试通過率 | 100% | 阻止合併 |
451
- | 程序码覆蓋率 | 80% | 警告/阻止 |
452
- | 新程序码覆蓋率 | 90% | 警告 |
564
+ | 门禁 | 阈值 | 失败时的动作 |
565
+ |------|------|--------------|
566
+ | 单元测试通过率 | 100% | 阻止合并 |
567
+ | 集成测试通过率 | 100% | 阻止合并 |
568
+ | 代码覆盖率 | 80% | 警告 / 阻止 |
569
+ | 新代码覆盖率 | 90% | 警告 |
453
570
  | 测试执行时间 | < 基准 | 警告 |
454
571
 
572
+ ### CI 配置示例
573
+
574
+ ```yaml
575
+ # GitHub Actions
576
+ name: TDD Pipeline
577
+
578
+ on:
579
+ push:
580
+ branches: [main, develop]
581
+ pull_request:
582
+ branches: [main]
583
+
584
+ jobs:
585
+ unit-tests:
586
+ runs-on: ubuntu-latest
587
+ steps:
588
+ - uses: actions/checkout@v4
589
+ - uses: actions/setup-node@v4
590
+ - run: npm ci
591
+ - run: npm run test:unit -- --coverage
592
+ - uses: codecov/codecov-action@v4
593
+
594
+ integration-tests:
595
+ needs: unit-tests
596
+ runs-on: ubuntu-latest
597
+ services:
598
+ postgres:
599
+ image: postgres:15
600
+ env:
601
+ POSTGRES_PASSWORD: test
602
+ steps:
603
+ - uses: actions/checkout@v4
604
+ - run: npm run test:integration
605
+
606
+ e2e-tests:
607
+ needs: integration-tests
608
+ runs-on: ubuntu-latest
609
+ steps:
610
+ - uses: actions/checkout@v4
611
+ - run: npm run test:e2e
612
+ ```
613
+
614
+ ### 测试报告
615
+
616
+ ```yaml
617
+ # 添加测试报告
618
+ - name: Test Report
619
+ uses: dorny/test-reporter@v1
620
+ if: success() || failure()
621
+ with:
622
+ name: Test Results
623
+ path: reports/junit.xml
624
+ reporter: jest-junit
625
+ ```
626
+
455
627
  ---
456
628
 
457
629
  ## 快速决策指南
458
630
 
459
- ### 要撰写哪种测试?
631
+ ### 该编写哪种测试?
460
632
 
461
633
  ```
462
- 你在实現什麼?
634
+ 你正在实现什么?
463
635
  │
464
636
  ├─ 新功能
465
- │ └─ 從驗收标准開始 → BDD → TDD
637
+ │ └─ 从验收标准开始 → BDD → TDD
466
638
  │
467
- ├─ Bug 修復
468
- │ └─ 撰写重現 bug 的失败测试 → TDD
639
+ ├─ Bug 修复
640
+ │ └─ 编写能重现 bug 的失败测试 → TDD
469
641
  │
470
- ├─ 重構
471
- │ └─ 确保現有测试涵蓋行为 → 重構
642
+ ├─ 重构
643
+ │ └─ 确保现有测试已覆盖相关行为 → 重构
472
644
  │
473
- ├─ 效能改善
474
- │ └─ 撰写效能测试 → 实現 → 验证
645
+ ├─ 性能改进
646
+ │ └─ 编写性能测试 → 实现 → 验证
475
647
  │
476
648
  └─ 新 API 端点
477
- └─ 邏辑用 TDD + HTTP 用集成测试
649
+ └─ 逻辑用 TDD + HTTP 用集成测试
650
+ ```
651
+
652
+ ### 测试粒度
653
+
654
+ ```
655
+ 这个测试应该多具体?
656
+ │
657
+ ├─ 测试公开 API → 每个行为一个测试
658
+ ├─ 测试内部逻辑 → 将相关断言归为一组
659
+ └─ 测试边界情况 → 每个边界情况一个测试
478
660
  ```
479
661
 
480
662
  ---
481
663
 
482
- ## 相关文件
664
+ ## 相关文档
483
665
 
484
- - [SKILL.md](./SKILL.md) - TDD 助手概覽
485
- - [语言範例](./language-examples.md) - 语言特定 TDD
486
- - [TDD 核心标准](../../../../core/test-driven-development.md) - 完整 TDD 标准
666
+ - [SKILL.md](./SKILL.md) - TDD 助手概览
667
+ - [语言示例](./language-examples.md) - 特定语言的 TDD
668
+ - [TDD 核心标准](../../../../core/test-driven-development.md) - 完整的 TDD 标准