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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (711) hide show
  1. package/bin/uds.js +12 -1
  2. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  3. package/bundled/ai/standards/commit-message.ai.yaml +12 -2
  4. package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
  5. package/bundled/core/commit-message-guide.md +22 -19
  6. package/bundled/core/secret-management-standards.md +13 -1
  7. package/bundled/extensions/locales/zh-tw.md +19 -19
  8. package/bundled/hooks/validate-commit-msg.mjs +52 -9
  9. package/bundled/locales/zh-CN/CHANGELOG.md +2309 -1110
  10. package/bundled/locales/zh-CN/CLAUDE.md +987 -101
  11. package/bundled/locales/zh-CN/README.md +3 -3
  12. package/bundled/locales/zh-CN/SECURITY.md +3 -3
  13. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  14. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
  15. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  16. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
  17. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
  18. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
  19. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
  20. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  21. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  22. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  23. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  24. package/bundled/locales/zh-CN/core/accessibility-standards.md +871 -62
  25. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  26. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  27. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  28. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  29. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  30. package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +311 -72
  31. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  32. package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
  33. package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
  34. package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
  35. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  36. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  37. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  38. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  39. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  40. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  41. package/bundled/locales/zh-CN/core/changelog-standards.md +485 -63
  42. package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
  43. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  44. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  45. package/bundled/locales/zh-CN/core/code-review-checklist.md +37 -23
  46. package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
  47. package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
  48. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  49. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  50. package/bundled/locales/zh-CN/core/deprecation-standards.md +155 -40
  51. package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
  52. package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
  53. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  54. package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
  55. package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
  56. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  57. package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
  58. package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
  59. package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
  60. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  61. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  62. package/bundled/locales/zh-CN/core/feature-flag-standards.md +202 -57
  63. package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
  64. package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
  65. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  66. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  67. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  68. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  69. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  70. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  71. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  72. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  73. package/bundled/locales/zh-CN/core/mutation-testing.md +45 -6
  74. package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
  75. package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
  76. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  77. package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
  78. package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
  79. package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
  80. package/bundled/locales/zh-CN/core/project-structure.md +550 -170
  81. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  82. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  83. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  84. package/bundled/locales/zh-CN/core/retrospective-standards.md +215 -22
  85. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  86. package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
  87. package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
  88. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  89. package/bundled/locales/zh-CN/core/security-standards.md +169 -16
  90. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  91. package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
  92. package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
  93. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  94. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  95. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  96. package/bundled/locales/zh-CN/core/supply-chain-security-standards.md +159 -32
  97. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  98. package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
  99. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  100. package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
  101. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  102. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  103. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  104. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  105. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  106. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  107. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  108. package/bundled/locales/zh-CN/core/versioning.md +737 -73
  109. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  110. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  111. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  112. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +2 -1
  113. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  114. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
  115. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
  116. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  117. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
  118. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  119. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
  120. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  121. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  122. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +2 -0
  123. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  124. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  125. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  126. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  127. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  128. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  129. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  130. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  131. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  132. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  133. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  134. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  135. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  136. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  137. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  138. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  139. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  140. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  141. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  142. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  143. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  144. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  145. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  146. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  147. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  148. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  149. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  150. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  151. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  152. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  153. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  154. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  155. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  156. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  157. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  158. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  159. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  160. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  161. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  162. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  163. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  164. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  165. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  166. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  167. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  168. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  169. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  170. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  171. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  172. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  173. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  174. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  175. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  176. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  177. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  178. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  179. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  180. package/bundled/locales/zh-CN/skills/README.md +2 -1
  181. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  182. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  183. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  184. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  185. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  186. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  187. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  188. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  189. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  190. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  191. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  192. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  193. package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +217 -137
  194. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  195. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  196. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  197. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  198. package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +148 -132
  199. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  200. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  201. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  202. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  203. package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +122 -121
  204. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  205. package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
  206. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  207. package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
  208. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  209. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  210. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  211. package/bundled/locales/zh-CN/skills/code-review-assistant/guide.md +119 -45
  212. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  213. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  214. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  215. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  216. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  217. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  218. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  219. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  220. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  221. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  222. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  223. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  224. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  225. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  226. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  227. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  228. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  229. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  230. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  231. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  232. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  233. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  234. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  235. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  236. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  237. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  238. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  239. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  240. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  241. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  242. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  243. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  244. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  245. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  246. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  247. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  248. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  249. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  250. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  251. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  252. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  253. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  254. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  255. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  256. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  257. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  258. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  259. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  260. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  261. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +4 -4
  262. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  263. package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
  264. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  265. package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
  266. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  267. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  268. package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +4 -2
  269. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  270. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  271. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  272. package/bundled/locales/zh-CN/skills/docs-generator/guide.md +8 -7
  273. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  274. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  275. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  276. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  277. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  278. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  279. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  280. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  281. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  282. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  283. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  284. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  285. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  286. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  287. package/bundled/locales/zh-CN/skills/project-discovery/guide.md +158 -157
  288. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  289. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  290. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  291. package/bundled/locales/zh-CN/skills/refactoring-assistant/guide.md +172 -171
  292. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  293. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  294. package/bundled/locales/zh-CN/skills/release-standards/guide.md +51 -43
  295. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  296. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  297. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  298. package/bundled/locales/zh-CN/skills/requirement-assistant/guide.md +88 -79
  299. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  300. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  301. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  302. package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +2 -2
  303. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  304. package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
  305. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  306. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  307. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  308. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  309. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  310. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  311. package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +2 -2
  312. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  313. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  314. package/bundled/locales/zh-CN/skills/tdd-assistant/guide.md +217 -156
  315. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  316. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  317. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  318. package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +25 -12
  319. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  320. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  321. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  322. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  323. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  324. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  325. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  326. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  327. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  328. package/bundled/locales/zh-TW/CHANGELOG.md +2282 -1112
  329. package/bundled/locales/zh-TW/CLAUDE.md +962 -76
  330. package/bundled/locales/zh-TW/README.md +3 -3
  331. package/bundled/locales/zh-TW/SECURITY.md +3 -3
  332. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  333. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
  334. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  335. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
  336. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
  337. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
  338. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
  339. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  340. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  341. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  342. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  343. package/bundled/locales/zh-TW/core/accessibility-standards.md +895 -46
  344. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  345. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  346. package/bundled/locales/zh-TW/core/agent-dispatch.md +102 -33
  347. package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
  348. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  349. package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
  350. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  351. package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
  352. package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
  353. package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
  354. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  355. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  356. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  357. package/bundled/locales/zh-TW/core/branch-completion.md +130 -34
  358. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  359. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  360. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  361. package/bundled/locales/zh-TW/core/chaos-engineering-standards.md +138 -36
  362. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  363. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  364. package/bundled/locales/zh-TW/core/code-review-checklist.md +19 -7
  365. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  366. package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
  367. package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
  368. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  369. package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
  370. package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
  371. package/bundled/locales/zh-TW/core/developer-memory.md +102 -12
  372. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  373. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  374. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  375. package/bundled/locales/zh-TW/core/environment-standards.md +250 -72
  376. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  377. package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
  378. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  379. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  380. package/bundled/locales/zh-TW/core/feature-flag-standards.md +202 -57
  381. package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
  382. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  383. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  384. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  385. package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +234 -487
  386. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  387. package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
  388. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  389. package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
  390. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  391. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  392. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  393. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  394. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  395. package/bundled/locales/zh-TW/core/observability-standards.md +284 -40
  396. package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
  397. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  398. package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
  399. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  400. package/bundled/locales/zh-TW/core/project-context-memory.md +210 -31
  401. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  402. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  403. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  404. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  405. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  406. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  407. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  408. package/bundled/locales/zh-TW/core/runbook-standards.md +296 -23
  409. package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
  410. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  411. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  412. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  413. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  414. package/bundled/locales/zh-TW/core/slo-standards.md +301 -49
  415. package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
  416. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  417. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  418. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  419. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  420. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  421. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  422. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  423. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  424. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  425. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  426. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  427. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  428. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  429. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  430. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  431. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  432. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  433. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  434. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  435. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +2 -1
  436. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  437. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
  438. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  439. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
  440. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  441. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
  442. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  443. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
  444. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  445. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  446. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +2 -0
  447. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  448. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  449. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  450. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  451. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  452. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  453. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  454. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  455. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  456. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  457. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  458. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  459. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  460. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  461. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  462. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  463. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  464. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  465. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  466. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  467. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  468. package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +584 -475
  469. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  470. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  471. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  472. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  473. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  474. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  475. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  476. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  477. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  478. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  479. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  480. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  481. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  482. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  483. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  484. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  485. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  486. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  487. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  488. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  489. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  490. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  491. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  492. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  493. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  494. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  495. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  496. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  497. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  498. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  499. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  500. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  501. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  502. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  503. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  504. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  505. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  506. package/bundled/locales/zh-TW/skills/README.md +2 -1
  507. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  508. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  509. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  510. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  511. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  512. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  513. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  514. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  515. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  516. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  517. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  518. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  519. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  520. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  521. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  522. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  523. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  524. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  525. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  526. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  527. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  528. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  529. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  530. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  531. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  532. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  533. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  534. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  535. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  536. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  537. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  538. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  539. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  540. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  541. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  542. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  543. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  544. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  545. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  546. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  547. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  548. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  549. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  550. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  551. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  552. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  553. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  554. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  555. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  556. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  557. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  558. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  559. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  560. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  561. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  562. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  563. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  564. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  565. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  566. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  567. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  568. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  569. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  570. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  571. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  572. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  573. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  574. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  575. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  576. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  577. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  578. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  579. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  580. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  581. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  582. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  583. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  584. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  585. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  586. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  587. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  588. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  589. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  590. package/bundled/locales/zh-TW/skills/commit-standards/guide.md +137 -17
  591. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  592. package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
  593. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  594. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  595. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  596. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  597. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  598. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  599. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  600. package/bundled/locales/zh-TW/skills/docs-generator/guide.md +4 -3
  601. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  602. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  603. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  604. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  605. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  606. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  607. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  608. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  609. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  610. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  611. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  612. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  613. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  614. package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +85 -18
  615. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  616. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  617. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  618. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  619. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  620. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  621. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  622. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  623. package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +91 -45
  624. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  625. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  626. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  627. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  628. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  629. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  630. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  631. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  632. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  633. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  634. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  635. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  636. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  637. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  638. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  639. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  640. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  641. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  642. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  643. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  644. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  645. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  646. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  647. package/bundled/locales/zh-TW/skills/tdd-assistant/language-examples.md +693 -47
  648. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  649. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  650. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  651. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  652. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  653. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  654. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  655. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  656. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  657. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  658. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  659. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  660. package/bundled/skills/.claude-plugin/plugin.json +71 -0
  661. package/bundled/skills/commit-standards/SKILL.md +2 -2
  662. package/bundled/skills/commit-standards/guide.md +3 -2
  663. package/bundled/skills/commit-standards/language-options.md +19 -17
  664. package/package.json +2 -2
  665. package/src/commands/audit.js +28 -1
  666. package/src/commands/check.js +72 -3
  667. package/src/commands/compile.js +37 -4
  668. package/src/commands/config.js +49 -24
  669. package/src/commands/init.js +78 -30
  670. package/src/commands/open-work.js +6 -2
  671. package/src/commands/release-messages.js +228 -0
  672. package/src/commands/release.js +127 -68
  673. package/src/commands/run-intent.js +11 -0
  674. package/src/commands/spec.js +4 -2
  675. package/src/commands/update.js +173 -20
  676. package/src/compilers/claude-code-compiler.js +9 -1
  677. package/src/config/ai-agent-paths.js +14 -1
  678. package/src/core/installed-formats.js +15 -0
  679. package/src/core/open-work-config.js +20 -1
  680. package/src/core/project-config.js +55 -0
  681. package/src/i18n/messages.js +106 -2
  682. package/src/installers/hooks-installer.js +1 -1
  683. package/src/installers/manifest-installer.js +1 -1
  684. package/src/installers/skills-installer.js +1 -1
  685. package/src/installers/standards-installer.js +3 -1
  686. package/src/mcp/server.js +9 -3
  687. package/src/prompts/init.js +26 -22
  688. package/src/reconciler/actual-state-scanner.js +2 -8
  689. package/src/reconciler/backup-locations.js +5 -0
  690. package/src/reconciler/backup-manager.js +19 -11
  691. package/src/reconciler/desired-state-calculator.js +89 -57
  692. package/src/reconciler/plan-executor.js +101 -8
  693. package/src/reconciler/recorded-versions.js +49 -0
  694. package/src/reconciler/relative-path.js +23 -0
  695. package/src/uninstallers/hook-uninstaller.js +9 -1
  696. package/src/uninstallers/skills-uninstaller.js +22 -3
  697. package/src/utils/available-standards-report.js +25 -4
  698. package/src/utils/available-standards.js +13 -3
  699. package/src/utils/build-manifest.js +1 -1
  700. package/src/utils/commit-message-judge.js +60 -13
  701. package/src/utils/friction-detector.js +23 -11
  702. package/src/utils/git-hooks.js +106 -4
  703. package/src/utils/integration-generator.js +95 -67
  704. package/src/utils/legacy-hook-migration.js +121 -2
  705. package/src/utils/open-work-tracking.mjs +105 -16
  706. package/src/utils/sdd-header.js +16 -4
  707. package/src/utils/skills-installer.js +2 -1
  708. package/src/utils/spinner.js +14 -4
  709. package/src/utils/standard-validator.js +3 -2
  710. package/standards-registry.json +10 -8
  711. package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
@@ -2,22 +2,22 @@
2
2
  source: ../../../../skills/tdd-assistant/language-examples.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: 481f97a74878
6
7
  status: current
7
8
  ---
8
-
9
- # TDD 语言範例
9
+ # TDD 语言示例
10
10
 
11
11
  > **语言**: [English](../../../../skills/tdd-assistant/language-examples.md) | 简体中文
12
12
 
13
13
  **版本**: 1.0.0
14
- **最後更新**: 2026-01-07
14
+ **最后更新**: 2026-01-07
15
15
 
16
16
  ---
17
17
 
18
- ## 概覽
18
+ ## 概述
19
19
 
20
- 本文件提供六种主流程序语言的完整 TDD 範例:
20
+ 本文档提供六种主流编程语言的完整 TDD 示例:
21
21
 
22
22
  1. [JavaScript/TypeScript](#javascripttypescript)
23
23
  2. [Python](#python)
@@ -26,11 +26,11 @@ status: current
26
26
  5. [Java](#java)
27
27
  6. [Ruby](#ruby)
28
28
 
29
- 每个區段包含:
30
- - 完整的紅-綠-重構範例
29
+ 每个部分包含:
30
+ - 完整的红-绿-重构示例
31
31
  - 测试框架设置
32
- - Mock/Stub 使用
33
- - BDD 範例(如適用)
32
+ - Mock/Stub 用法
33
+ - BDD 示例(如适用)
34
34
 
35
35
  ---
36
36
 
@@ -48,9 +48,20 @@ npm install --save-dev jest @types/jest ts-jest
48
48
  npm install --save-dev vitest
49
49
  ```
50
50
 
51
- #### 完整 TDD 範例:購物車
51
+ ```json
52
+ // package.json
53
+ {
54
+ "scripts": {
55
+ "test": "jest",
56
+ "test:watch": "jest --watch",
57
+ "test:coverage": "jest --coverage"
58
+ }
59
+ }
60
+ ```
61
+
62
+ #### 完整 TDD 示例:购物车
52
63
 
53
- **步骤 1:紅色 - 撰写失败测试**
64
+ **步骤 1:RED - 编写失败的测试**
54
65
 
55
66
  ```typescript
56
67
  // cart.test.ts
@@ -59,35 +70,35 @@ import { ShoppingCart } from './cart';
59
70
  describe('ShoppingCart', () => {
60
71
  describe('calculateTotal', () => {
61
72
  test('should return 0 for empty cart', () => {
62
- // Arrange(准备)
73
+ // Arrange
63
74
  const cart = new ShoppingCart();
64
75
 
65
- // Act(执行)
76
+ // Act
66
77
  const total = cart.calculateTotal();
67
78
 
68
- // Assert(斷言)
79
+ // Assert
69
80
  expect(total).toBe(0);
70
81
  });
71
82
  });
72
83
  });
73
84
  ```
74
85
 
75
- 执行测试 - 它失败因为 `ShoppingCart` 不存在。
86
+ 运行测试 - 因为 `ShoppingCart` 不存在而失败。
76
87
 
77
- **步骤 2:綠色 - 最少实現**
88
+ **步骤 2:GREEN - 最少实现**
78
89
 
79
90
  ```typescript
80
91
  // cart.ts
81
92
  export class ShoppingCart {
82
93
  calculateTotal(): number {
83
- return 0; // 假裝!
94
+ return 0; // Fake it!
84
95
  }
85
96
  }
86
97
  ```
87
98
 
88
- 测试通過。
99
+ 测试通过。
89
100
 
90
- **步骤 3:紅色 - 新增下一个测试**
101
+ **步骤 3:RED - 添加下一个测试**
91
102
 
92
103
  ```typescript
93
104
  test('should return sum of item prices', () => {
@@ -101,7 +112,7 @@ test('should return sum of item prices', () => {
101
112
  });
102
113
  ```
103
114
 
104
- **步骤 4:綠色 - 实現**
115
+ **步骤 4:GREEN - 实现**
105
116
 
106
117
  ```typescript
107
118
  export class ShoppingCart {
@@ -117,7 +128,44 @@ export class ShoppingCart {
117
128
  }
118
129
  ```
119
130
 
120
- #### Mock 範例
131
+ **步骤 5:RED - 测试折扣**
132
+
133
+ ```typescript
134
+ test('should apply percentage discount', () => {
135
+ const cart = new ShoppingCart();
136
+ cart.addItem({ name: 'Widget', price: 100 });
137
+ cart.applyDiscount(20); // 20% off
138
+
139
+ const total = cart.calculateTotal();
140
+
141
+ expect(total).toBe(80);
142
+ });
143
+ ```
144
+
145
+ **步骤 6:GREEN 与 REFACTOR**
146
+
147
+ ```typescript
148
+ export class ShoppingCart {
149
+ private items: Array<{ name: string; price: number }> = [];
150
+ private discountPercent = 0;
151
+
152
+ addItem(item: { name: string; price: number }): void {
153
+ this.items.push(item);
154
+ }
155
+
156
+ applyDiscount(percent: number): void {
157
+ this.discountPercent = percent;
158
+ }
159
+
160
+ calculateTotal(): number {
161
+ const subtotal = this.items.reduce((sum, item) => sum + item.price, 0);
162
+ const discount = subtotal * (this.discountPercent / 100);
163
+ return subtotal - discount;
164
+ }
165
+ }
166
+ ```
167
+
168
+ #### Mock 示例
121
169
 
122
170
  ```typescript
123
171
  // orderService.test.ts
@@ -127,16 +175,21 @@ import { PaymentGateway } from './paymentGateway';
127
175
  jest.mock('./paymentGateway');
128
176
 
129
177
  describe('OrderService', () => {
178
+ let orderService: OrderService;
179
+ let mockPaymentGateway: jest.Mocked<PaymentGateway>;
180
+
181
+ beforeEach(() => {
182
+ mockPaymentGateway = new PaymentGateway() as jest.Mocked<PaymentGateway>;
183
+ orderService = new OrderService(mockPaymentGateway);
184
+ });
185
+
130
186
  test('should process payment and return order confirmation', async () => {
131
187
  // Arrange
132
- const mockPaymentGateway = new PaymentGateway() as jest.Mocked<PaymentGateway>;
133
188
  mockPaymentGateway.charge.mockResolvedValue({
134
189
  success: true,
135
190
  transactionId: 'TXN123'
136
191
  });
137
192
 
138
- const orderService = new OrderService(mockPaymentGateway);
139
-
140
193
  // Act
141
194
  const result = await orderService.checkout({
142
195
  amount: 100,
@@ -145,11 +198,53 @@ describe('OrderService', () => {
145
198
 
146
199
  // Assert
147
200
  expect(result.confirmed).toBe(true);
201
+ expect(result.transactionId).toBe('TXN123');
148
202
  expect(mockPaymentGateway.charge).toHaveBeenCalledWith(100, '4111111111111111');
149
203
  });
150
204
  });
151
205
  ```
152
206
 
207
+ #### 使用 Cucumber.js 进行 BDD
208
+
209
+ ```gherkin
210
+ # features/shopping_cart.feature
211
+ Feature: Shopping Cart
212
+ As a customer
213
+ I want to add items to my cart
214
+ So that I can purchase them
215
+
216
+ Scenario: Add item to empty cart
217
+ Given I have an empty shopping cart
218
+ When I add a "Widget" priced at $10
219
+ Then the cart total should be $10
220
+
221
+ Scenario: Apply discount code
222
+ Given I have a cart with items totaling $100
223
+ When I apply discount code "SAVE20"
224
+ Then the cart total should be $80
225
+ ```
226
+
227
+ ```typescript
228
+ // features/step_definitions/cart_steps.ts
229
+ import { Given, When, Then } from '@cucumber/cucumber';
230
+ import { expect } from 'chai';
231
+ import { ShoppingCart } from '../src/cart';
232
+
233
+ let cart: ShoppingCart;
234
+
235
+ Given('I have an empty shopping cart', function () {
236
+ cart = new ShoppingCart();
237
+ });
238
+
239
+ When('I add a {string} priced at ${int}', function (name: string, price: number) {
240
+ cart.addItem({ name, price });
241
+ });
242
+
243
+ Then('the cart total should be ${int}', function (expected: number) {
244
+ expect(cart.calculateTotal()).to.equal(expected);
245
+ });
246
+ ```
247
+
153
248
  ---
154
249
 
155
250
  ## Python
@@ -162,9 +257,18 @@ describe('OrderService', () => {
162
257
  pip install pytest pytest-cov pytest-mock
163
258
  ```
164
259
 
165
- #### 完整 TDD 範例:计算机
260
+ ```ini
261
+ # pytest.ini
262
+ [pytest]
263
+ testpaths = tests
264
+ python_files = test_*.py
265
+ python_functions = test_*
266
+ addopts = -v --tb=short
267
+ ```
166
268
 
167
- **步骤 1:紅色**
269
+ #### 完整 TDD 示例:计算器
270
+
271
+ **步骤 1:RED**
168
272
 
169
273
  ```python
170
274
  # tests/test_calculator.py
@@ -173,26 +277,26 @@ from calculator import Calculator
173
277
 
174
278
  class TestCalculator:
175
279
  def test_add_two_positive_numbers(self):
176
- # Arrange(准备)
280
+ # Arrange
177
281
  calc = Calculator()
178
282
 
179
- # Act(执行)
283
+ # Act
180
284
  result = calc.add(2, 3)
181
285
 
182
- # Assert(斷言)
286
+ # Assert
183
287
  assert result == 5
184
288
  ```
185
289
 
186
- **步骤 2:綠色**
290
+ **步骤 2:GREEN**
187
291
 
188
292
  ```python
189
293
  # calculator.py
190
294
  class Calculator:
191
295
  def add(self, a: float, b: float) -> float:
192
- return 5 # 假裝!
296
+ return 5 # Fake it!
193
297
  ```
194
298
 
195
- **步骤 3:紅色 - 強制泛化**
299
+ **步骤 3:RED - 强制泛化**
196
300
 
197
301
  ```python
198
302
  def test_add_different_numbers(self):
@@ -201,7 +305,7 @@ def test_add_different_numbers(self):
201
305
  assert result == 30
202
306
  ```
203
307
 
204
- **步骤 4:綠色 - 实現**
308
+ **步骤 4:GREEN - 实现**
205
309
 
206
310
  ```python
207
311
  class Calculator:
@@ -209,10 +313,41 @@ class Calculator:
209
313
  return a + b
210
314
  ```
211
315
 
212
- #### Mock 範例
316
+ **步骤 5:RED - 添加更多运算**
317
+
318
+ ```python
319
+ def test_subtract_returns_difference(self):
320
+ calc = Calculator()
321
+ result = calc.subtract(10, 3)
322
+ assert result == 7
323
+
324
+ def test_divide_by_zero_raises_error(self):
325
+ calc = Calculator()
326
+ with pytest.raises(ValueError, match="Cannot divide by zero"):
327
+ calc.divide(10, 0)
328
+ ```
329
+
330
+ **步骤 6:GREEN 与 REFACTOR**
331
+
332
+ ```python
333
+ class Calculator:
334
+ def add(self, a: float, b: float) -> float:
335
+ return a + b
336
+
337
+ def subtract(self, a: float, b: float) -> float:
338
+ return a - b
339
+
340
+ def divide(self, a: float, b: float) -> float:
341
+ if b == 0:
342
+ raise ValueError("Cannot divide by zero")
343
+ return a / b
344
+ ```
345
+
346
+ #### Mock 示例
213
347
 
214
348
  ```python
215
349
  # tests/test_user_service.py
350
+ import pytest
216
351
  from unittest.mock import Mock, patch
217
352
  from user_service import UserService
218
353
 
@@ -233,6 +368,63 @@ class TestUserService:
233
368
  subject="Welcome!",
234
369
  body="Hello John, welcome to our service!"
235
370
  )
371
+
372
+ def test_get_user_returns_user_from_repository(self):
373
+ # Arrange
374
+ mock_repo = Mock()
375
+ mock_repo.find_by_id.return_value = {"id": 1, "name": "John"}
376
+ service = UserService(repository=mock_repo)
377
+
378
+ # Act
379
+ user = service.get_user(1)
380
+
381
+ # Assert
382
+ assert user["name"] == "John"
383
+ mock_repo.find_by_id.assert_called_once_with(1)
384
+ ```
385
+
386
+ #### 使用 Behave 进行 BDD
387
+
388
+ ```gherkin
389
+ # features/calculator.feature
390
+ Feature: Calculator
391
+ As a user
392
+ I want to perform calculations
393
+ So that I can solve math problems
394
+
395
+ Scenario: Add two numbers
396
+ Given I have a calculator
397
+ When I add 5 and 3
398
+ Then the result should be 8
399
+
400
+ Scenario Outline: Multiple additions
401
+ Given I have a calculator
402
+ When I add <a> and <b>
403
+ Then the result should be <result>
404
+
405
+ Examples:
406
+ | a | b | result |
407
+ | 1 | 1 | 2 |
408
+ | 10 | 20 | 30 |
409
+ | -5 | 5 | 0 |
410
+ ```
411
+
412
+ ```python
413
+ # features/steps/calculator_steps.py
414
+ from behave import given, when, then
415
+ from calculator import Calculator
416
+
417
+ @given('I have a calculator')
418
+ def step_impl(context):
419
+ context.calculator = Calculator()
420
+
421
+ @when('I add {a:d} and {b:d}')
422
+ def step_impl(context, a, b):
423
+ context.result = context.calculator.add(a, b)
424
+
425
+ @then('the result should be {expected:d}')
426
+ def step_impl(context, expected):
427
+ assert context.result == expected
236
428
  ```
237
429
 
238
430
  ---
@@ -250,9 +442,9 @@ dotnet add package Moq
250
442
  dotnet add package FluentAssertions
251
443
  ```
252
444
 
253
- #### 完整 TDD 範例:订单处理器
445
+ #### 完整 TDD 示例:订单处理器
254
446
 
255
- **步骤 1:紅色**
447
+ **步骤 1:RED**
256
448
 
257
449
  ```csharp
258
450
  // OrderProcessorTests.cs
@@ -264,20 +456,20 @@ public class OrderProcessorTests
264
456
  [Fact]
265
457
  public void ProcessOrder_WithValidOrder_ReturnsSuccess()
266
458
  {
267
- // Arrange(准备)
459
+ // Arrange
268
460
  var processor = new OrderProcessor();
269
461
  var order = new Order { Id = 1, Amount = 100 };
270
462
 
271
- // Act(执行)
463
+ // Act
272
464
  var result = processor.Process(order);
273
465
 
274
- // Assert(斷言)
466
+ // Assert
275
467
  result.IsSuccess.Should().BeTrue();
276
468
  }
277
469
  }
278
470
  ```
279
471
 
280
- **步骤 2:綠色**
472
+ **步骤 2:GREEN**
281
473
 
282
474
  ```csharp
283
475
  // OrderProcessor.cs
@@ -285,15 +477,74 @@ public class OrderProcessor
285
477
  {
286
478
  public ProcessResult Process(Order order)
287
479
  {
288
- return new ProcessResult { IsSuccess = true }; // 假裝!
480
+ return new ProcessResult { IsSuccess = true }; // Fake it!
289
481
  }
290
482
  }
483
+
484
+ public class Order
485
+ {
486
+ public int Id { get; set; }
487
+ public decimal Amount { get; set; }
488
+ }
489
+
490
+ public class ProcessResult
491
+ {
492
+ public bool IsSuccess { get; set; }
493
+ public string? ErrorMessage { get; set; }
494
+ }
495
+ ```
496
+
497
+ **步骤 3:RED - 添加验证**
498
+
499
+ ```csharp
500
+ [Fact]
501
+ public void ProcessOrder_WithZeroAmount_ReturnsFailure()
502
+ {
503
+ var processor = new OrderProcessor();
504
+ var order = new Order { Id = 1, Amount = 0 };
505
+
506
+ var result = processor.Process(order);
507
+
508
+ result.IsSuccess.Should().BeFalse();
509
+ result.ErrorMessage.Should().Be("Order amount must be greater than zero");
510
+ }
291
511
  ```
292
512
 
293
- #### Moq 範例
513
+ **步骤 4:GREEN 与 REFACTOR**
514
+
515
+ ```csharp
516
+ public class OrderProcessor
517
+ {
518
+ public ProcessResult Process(Order order)
519
+ {
520
+ if (order.Amount <= 0)
521
+ {
522
+ return ProcessResult.Failure("Order amount must be greater than zero");
523
+ }
524
+
525
+ return ProcessResult.Success();
526
+ }
527
+ }
528
+
529
+ public class ProcessResult
530
+ {
531
+ public bool IsSuccess { get; private set; }
532
+ public string? ErrorMessage { get; private set; }
533
+
534
+ public static ProcessResult Success() =>
535
+ new() { IsSuccess = true };
536
+
537
+ public static ProcessResult Failure(string message) =>
538
+ new() { IsSuccess = false, ErrorMessage = message };
539
+ }
540
+ ```
541
+
542
+ #### 使用 Moq 的 Mock 示例
294
543
 
295
544
  ```csharp
296
545
  using Moq;
546
+ using Xunit;
547
+ using FluentAssertions;
297
548
 
298
549
  public class PaymentServiceTests
299
550
  {
@@ -302,18 +553,87 @@ public class PaymentServiceTests
302
553
  {
303
554
  // Arrange
304
555
  var mockGateway = new Mock<IPaymentGateway>();
556
+ var mockEmailService = new Mock<IEmailService>();
557
+
305
558
  mockGateway
306
559
  .Setup(g => g.ChargeAsync(It.IsAny<decimal>(), It.IsAny<string>()))
307
560
  .ReturnsAsync(new ChargeResult { TransactionId = "TXN123" });
308
561
 
309
- var service = new PaymentService(mockGateway.Object);
562
+ var service = new PaymentService(mockGateway.Object, mockEmailService.Object);
310
563
 
311
564
  // Act
312
- var result = await service.ProcessPaymentAsync(100, "4111111111111111");
565
+ var result = await service.ProcessPaymentAsync(100, "4111111111111111", "user@example.com");
313
566
 
314
567
  // Assert
315
568
  result.TransactionId.Should().Be("TXN123");
316
- mockGateway.Verify(g => g.ChargeAsync(100, "4111111111111111"), Times.Once);
569
+
570
+ mockGateway.Verify(
571
+ g => g.ChargeAsync(100, "4111111111111111"),
572
+ Times.Once);
573
+
574
+ mockEmailService.Verify(
575
+ e => e.SendReceiptAsync("user@example.com", It.Is<Receipt>(r => r.TransactionId == "TXN123")),
576
+ Times.Once);
577
+ }
578
+ }
579
+ ```
580
+
581
+ #### 使用 SpecFlow 进行 BDD
582
+
583
+ ```gherkin
584
+ # Features/OrderProcessing.feature
585
+ Feature: Order Processing
586
+ As an e-commerce system
587
+ I want to process customer orders
588
+ So that customers can receive their products
589
+
590
+ Scenario: Process valid order
591
+ Given I have an order with amount $100
592
+ When I process the order
593
+ Then the order should be marked as processed
594
+ And a confirmation email should be sent
595
+
596
+ Scenario: Reject order with zero amount
597
+ Given I have an order with amount $0
598
+ When I process the order
599
+ Then the order should be rejected
600
+ And the error message should be "Order amount must be greater than zero"
601
+ ```
602
+
603
+ ```csharp
604
+ // StepDefinitions/OrderProcessingSteps.cs
605
+ using TechTalk.SpecFlow;
606
+ using FluentAssertions;
607
+
608
+ [Binding]
609
+ public class OrderProcessingSteps
610
+ {
611
+ private Order _order;
612
+ private ProcessResult _result;
613
+ private readonly OrderProcessor _processor = new();
614
+
615
+ [Given(@"I have an order with amount \$(.*)")]
616
+ public void GivenIHaveAnOrderWithAmount(decimal amount)
617
+ {
618
+ _order = new Order { Id = 1, Amount = amount };
619
+ }
620
+
621
+ [When(@"I process the order")]
622
+ public void WhenIProcessTheOrder()
623
+ {
624
+ _result = _processor.Process(_order);
625
+ }
626
+
627
+ [Then(@"the order should be marked as processed")]
628
+ public void ThenTheOrderShouldBeMarkedAsProcessed()
629
+ {
630
+ _result.IsSuccess.Should().BeTrue();
631
+ }
632
+
633
+ [Then(@"the error message should be ""(.*)""")]
634
+ public void ThenTheErrorMessageShouldBe(string expectedMessage)
635
+ {
636
+ _result.ErrorMessage.Should().Be(expectedMessage);
317
637
  }
318
638
  }
319
639
  ```
@@ -330,9 +650,9 @@ public class PaymentServiceTests
330
650
  go get github.com/stretchr/testify
331
651
  ```
332
652
 
333
- #### 完整 TDD 範例:使用者储存庫
653
+ #### 完整 TDD 示例:用户仓储
334
654
 
335
- **步骤 1:紅色**
655
+ **步骤 1:RED**
336
656
 
337
657
  ```go
338
658
  // user_repository_test.go
@@ -344,31 +664,40 @@ import (
344
664
  )
345
665
 
346
666
  func TestUserRepository_FindById_ReturnsUser(t *testing.T) {
347
- // Arrange(准备)
667
+ // Arrange
348
668
  repo := NewUserRepository()
349
669
  repo.Save(&User{ID: 1, Name: "John"})
350
670
 
351
- // Act(执行)
671
+ // Act
352
672
  user, err := repo.FindById(1)
353
673
 
354
- // Assert(斷言)
674
+ // Assert
355
675
  assert.NoError(t, err)
356
676
  assert.Equal(t, "John", user.Name)
357
677
  }
358
678
  ```
359
679
 
360
- **步骤 2:綠色**
680
+ **步骤 2:GREEN**
361
681
 
362
682
  ```go
363
683
  // user_repository.go
364
684
  package repository
365
685
 
686
+ import "errors"
687
+
688
+ type User struct {
689
+ ID int
690
+ Name string
691
+ }
692
+
366
693
  type UserRepository struct {
367
694
  users map[int]*User
368
695
  }
369
696
 
370
697
  func NewUserRepository() *UserRepository {
371
- return &UserRepository{users: make(map[int]*User)}
698
+ return &UserRepository{
699
+ users: make(map[int]*User),
700
+ }
372
701
  }
373
702
 
374
703
  func (r *UserRepository) Save(user *User) {
@@ -384,7 +713,20 @@ func (r *UserRepository) FindById(id int) (*User, error) {
384
713
  }
385
714
  ```
386
715
 
387
- #### 表格驅动测试(Go 慣例)
716
+ **步骤 3:RED - 错误情形**
717
+
718
+ ```go
719
+ func TestUserRepository_FindById_ReturnsErrorWhenNotFound(t *testing.T) {
720
+ repo := NewUserRepository()
721
+
722
+ user, err := repo.FindById(999)
723
+
724
+ assert.Nil(t, user)
725
+ assert.EqualError(t, err, "user not found")
726
+ }
727
+ ```
728
+
729
+ #### 表格驱动测试(Go 惯用法)
388
730
 
389
731
  ```go
390
732
  func TestUserRepository_Save(t *testing.T) {
@@ -419,13 +761,51 @@ func TestUserRepository_Save(t *testing.T) {
419
761
  }
420
762
  ```
421
763
 
764
+ #### 使用 testify/mock 进行 Mock
765
+
766
+ ```go
767
+ // email_service_test.go
768
+ package service
769
+
770
+ import (
771
+ "testing"
772
+ "github.com/stretchr/testify/assert"
773
+ "github.com/stretchr/testify/mock"
774
+ )
775
+
776
+ // Mock
777
+ type MockEmailSender struct {
778
+ mock.Mock
779
+ }
780
+
781
+ func (m *MockEmailSender) Send(to, subject, body string) error {
782
+ args := m.Called(to, subject, body)
783
+ return args.Error(0)
784
+ }
785
+
786
+ func TestNotificationService_SendWelcome(t *testing.T) {
787
+ // Arrange
788
+ mockSender := new(MockEmailSender)
789
+ mockSender.On("Send", "user@example.com", "Welcome!", mock.Anything).Return(nil)
790
+
791
+ service := NewNotificationService(mockSender)
792
+
793
+ // Act
794
+ err := service.SendWelcome("user@example.com")
795
+
796
+ // Assert
797
+ assert.NoError(t, err)
798
+ mockSender.AssertExpectations(t)
799
+ }
800
+ ```
801
+
422
802
  ---
423
803
 
424
804
  ## Java
425
805
 
426
806
  ### 测试框架:JUnit 5 + Mockito
427
807
 
428
- #### 设置 (Maven)
808
+ #### 设置(Maven)
429
809
 
430
810
  ```xml
431
811
  <dependencies>
@@ -441,12 +821,18 @@ func TestUserRepository_Save(t *testing.T) {
441
821
  <version>5.5.0</version>
442
822
  <scope>test</scope>
443
823
  </dependency>
824
+ <dependency>
825
+ <groupId>org.assertj</groupId>
826
+ <artifactId>assertj-core</artifactId>
827
+ <version>3.24.2</version>
828
+ <scope>test</scope>
829
+ </dependency>
444
830
  </dependencies>
445
831
  ```
446
832
 
447
- #### 完整 TDD 範例:帳戶服务
833
+ #### 完整 TDD 示例:账户服务
448
834
 
449
- **步骤 1:紅色**
835
+ **步骤 1:RED**
450
836
 
451
837
  ```java
452
838
  // AccountServiceTest.java
@@ -457,20 +843,20 @@ class AccountServiceTest {
457
843
 
458
844
  @Test
459
845
  void deposit_withPositiveAmount_increasesBalance() {
460
- // Arrange(准备)
846
+ // Arrange
461
847
  AccountService service = new AccountService();
462
848
  Account account = new Account(100.0);
463
849
 
464
- // Act(执行)
850
+ // Act
465
851
  service.deposit(account, 50.0);
466
852
 
467
- // Assert(斷言)
853
+ // Assert
468
854
  assertThat(account.getBalance()).isEqualTo(150.0);
469
855
  }
470
856
  }
471
857
  ```
472
858
 
473
- **步骤 2:綠色**
859
+ **步骤 2:GREEN**
474
860
 
475
861
  ```java
476
862
  // AccountService.java
@@ -479,37 +865,176 @@ public class AccountService {
479
865
  account.setBalance(account.getBalance() + amount);
480
866
  }
481
867
  }
868
+
869
+ // Account.java
870
+ public class Account {
871
+ private double balance;
872
+
873
+ public Account(double initialBalance) {
874
+ this.balance = initialBalance;
875
+ }
876
+
877
+ public double getBalance() { return balance; }
878
+ public void setBalance(double balance) { this.balance = balance; }
879
+ }
482
880
  ```
483
881
 
484
- #### Mockito 範例
882
+ **步骤 3:RED - 验证**
485
883
 
486
884
  ```java
885
+ @Test
886
+ void deposit_withNegativeAmount_throwsException() {
887
+ AccountService service = new AccountService();
888
+ Account account = new Account(100.0);
889
+
890
+ assertThatThrownBy(() -> service.deposit(account, -50.0))
891
+ .isInstanceOf(IllegalArgumentException.class)
892
+ .hasMessage("Deposit amount must be positive");
893
+ }
894
+
895
+ @Test
896
+ void withdraw_withInsufficientFunds_throwsException() {
897
+ AccountService service = new AccountService();
898
+ Account account = new Account(100.0);
899
+
900
+ assertThatThrownBy(() -> service.withdraw(account, 150.0))
901
+ .isInstanceOf(InsufficientFundsException.class)
902
+ .hasMessage("Insufficient funds");
903
+ }
904
+ ```
905
+
906
+ **步骤 4:GREEN 与 REFACTOR**
907
+
908
+ ```java
909
+ public class AccountService {
910
+
911
+ public void deposit(Account account, double amount) {
912
+ validatePositiveAmount(amount, "Deposit");
913
+ account.setBalance(account.getBalance() + amount);
914
+ }
915
+
916
+ public void withdraw(Account account, double amount) {
917
+ validatePositiveAmount(amount, "Withdrawal");
918
+ if (account.getBalance() < amount) {
919
+ throw new InsufficientFundsException("Insufficient funds");
920
+ }
921
+ account.setBalance(account.getBalance() - amount);
922
+ }
923
+
924
+ private void validatePositiveAmount(double amount, String operation) {
925
+ if (amount <= 0) {
926
+ throw new IllegalArgumentException(operation + " amount must be positive");
927
+ }
928
+ }
929
+ }
930
+ ```
931
+
932
+ #### 使用 Mockito 进行 Mock
933
+
934
+ ```java
935
+ import org.junit.jupiter.api.Test;
936
+ import org.junit.jupiter.api.extension.ExtendWith;
937
+ import org.mockito.InjectMocks;
938
+ import org.mockito.Mock;
939
+ import org.mockito.junit.jupiter.MockitoExtension;
940
+ import static org.mockito.Mockito.*;
941
+ import static org.assertj.core.api.Assertions.*;
942
+
487
943
  @ExtendWith(MockitoExtension.class)
488
944
  class OrderServiceTest {
489
945
 
490
946
  @Mock
491
947
  private PaymentGateway paymentGateway;
492
948
 
949
+ @Mock
950
+ private InventoryService inventoryService;
951
+
493
952
  @InjectMocks
494
953
  private OrderService orderService;
495
954
 
496
955
  @Test
497
- void placeOrder_withValidOrder_processesPayment() {
956
+ void placeOrder_withValidOrder_processesPaymentAndUpdatesInventory() {
498
957
  // Arrange
499
958
  Order order = new Order("PROD-1", 2, 50.0);
500
- when(paymentGateway.charge(100.0))
501
- .thenReturn(new PaymentResult("TXN-123", true));
959
+ when(inventoryService.checkStock("PROD-1")).thenReturn(10);
960
+ when(paymentGateway.charge(100.0)).thenReturn(new PaymentResult("TXN-123", true));
502
961
 
503
962
  // Act
504
963
  OrderResult result = orderService.placeOrder(order);
505
964
 
506
965
  // Assert
507
966
  assertThat(result.isSuccess()).isTrue();
967
+ assertThat(result.getTransactionId()).isEqualTo("TXN-123");
968
+
969
+ verify(inventoryService).checkStock("PROD-1");
970
+ verify(inventoryService).reserve("PROD-1", 2);
508
971
  verify(paymentGateway).charge(100.0);
509
972
  }
510
973
  }
511
974
  ```
512
975
 
976
+ #### 使用 Cucumber-JVM 进行 BDD
977
+
978
+ ```gherkin
979
+ # src/test/resources/features/account.feature
980
+ Feature: Account Management
981
+ As a bank customer
982
+ I want to manage my account balance
983
+ So that I can track my finances
984
+
985
+ Scenario: Deposit money
986
+ Given I have an account with balance $100
987
+ When I deposit $50
988
+ Then my balance should be $150
989
+
990
+ Scenario: Withdraw with insufficient funds
991
+ Given I have an account with balance $100
992
+ When I try to withdraw $150
993
+ Then I should see an error "Insufficient funds"
994
+ And my balance should be $100
995
+ ```
996
+
997
+ ```java
998
+ // StepDefinitions.java
999
+ import io.cucumber.java.en.*;
1000
+ import static org.assertj.core.api.Assertions.*;
1001
+
1002
+ public class AccountStepDefinitions {
1003
+ private Account account;
1004
+ private AccountService service = new AccountService();
1005
+ private Exception caughtException;
1006
+
1007
+ @Given("I have an account with balance ${double}")
1008
+ public void iHaveAccountWithBalance(double balance) {
1009
+ account = new Account(balance);
1010
+ }
1011
+
1012
+ @When("I deposit ${double}")
1013
+ public void iDeposit(double amount) {
1014
+ service.deposit(account, amount);
1015
+ }
1016
+
1017
+ @When("I try to withdraw ${double}")
1018
+ public void iTryToWithdraw(double amount) {
1019
+ try {
1020
+ service.withdraw(account, amount);
1021
+ } catch (Exception e) {
1022
+ caughtException = e;
1023
+ }
1024
+ }
1025
+
1026
+ @Then("my balance should be ${double}")
1027
+ public void myBalanceShouldBe(double expected) {
1028
+ assertThat(account.getBalance()).isEqualTo(expected);
1029
+ }
1030
+
1031
+ @Then("I should see an error {string}")
1032
+ public void iShouldSeeAnError(String message) {
1033
+ assertThat(caughtException).hasMessage(message);
1034
+ }
1035
+ }
1036
+ ```
1037
+
513
1038
  ---
514
1039
 
515
1040
  ## Ruby
@@ -526,9 +1051,14 @@ group :test do
526
1051
  end
527
1052
  ```
528
1053
 
529
- #### 完整 TDD 範例:購物車
1054
+ ```bash
1055
+ bundle install
1056
+ rspec --init
1057
+ ```
1058
+
1059
+ #### 完整 TDD 示例:购物车
530
1060
 
531
- **步骤 1:紅色**
1061
+ **步骤 1:RED**
532
1062
 
533
1063
  ```ruby
534
1064
  # spec/shopping_cart_spec.rb
@@ -545,30 +1075,32 @@ RSpec.describe ShoppingCart do
545
1075
  end
546
1076
  ```
547
1077
 
548
- **步骤 2:綠色**
1078
+ **步骤 2:GREEN**
549
1079
 
550
1080
  ```ruby
551
1081
  # lib/shopping_cart.rb
552
1082
  class ShoppingCart
553
1083
  def total
554
- 0 # 假裝!
1084
+ 0 # Fake it!
555
1085
  end
556
1086
  end
557
1087
  ```
558
1088
 
559
- **步骤 3:紅色 - 新增商品**
1089
+ **步骤 3:RED - 添加商品**
560
1090
 
561
1091
  ```ruby
562
- it 'returns sum of item prices' do
563
- cart = ShoppingCart.new
564
- cart.add_item(name: 'Widget', price: 10)
565
- cart.add_item(name: 'Gadget', price: 20)
1092
+ describe '#total' do
1093
+ it 'returns sum of item prices' do
1094
+ cart = ShoppingCart.new
1095
+ cart.add_item(name: 'Widget', price: 10)
1096
+ cart.add_item(name: 'Gadget', price: 20)
566
1097
 
567
- expect(cart.total).to eq(30)
1098
+ expect(cart.total).to eq(30)
1099
+ end
568
1100
  end
569
1101
  ```
570
1102
 
571
- **步骤 4:綠色与重構**
1103
+ **步骤 4:GREEN 与 REFACTOR**
572
1104
 
573
1105
  ```ruby
574
1106
  class ShoppingCart
@@ -586,9 +1118,49 @@ class ShoppingCart
586
1118
  end
587
1119
  ```
588
1120
 
589
- #### RSpec Mock 範例
1121
+ **步骤 5:RED - 折扣**
1122
+
1123
+ ```ruby
1124
+ describe '#apply_discount' do
1125
+ it 'reduces total by percentage' do
1126
+ cart = ShoppingCart.new
1127
+ cart.add_item(name: 'Widget', price: 100)
1128
+ cart.apply_discount(20) # 20% off
1129
+
1130
+ expect(cart.total).to eq(80)
1131
+ end
1132
+ end
1133
+ ```
1134
+
1135
+ **步骤 6:GREEN**
590
1136
 
591
1137
  ```ruby
1138
+ class ShoppingCart
1139
+ def initialize
1140
+ @items = []
1141
+ @discount_percent = 0
1142
+ end
1143
+
1144
+ def add_item(item)
1145
+ @items << item
1146
+ end
1147
+
1148
+ def apply_discount(percent)
1149
+ @discount_percent = percent
1150
+ end
1151
+
1152
+ def total
1153
+ subtotal = @items.sum { |item| item[:price] }
1154
+ discount = subtotal * (@discount_percent / 100.0)
1155
+ subtotal - discount
1156
+ end
1157
+ end
1158
+ ```
1159
+
1160
+ #### RSpec Mock
1161
+
1162
+ ```ruby
1163
+ # spec/order_service_spec.rb
592
1164
  RSpec.describe OrderService do
593
1165
  describe '#process' do
594
1166
  it 'charges payment and sends confirmation' do
@@ -606,23 +1178,96 @@ RSpec.describe OrderService do
606
1178
  email_service: email_service
607
1179
  )
608
1180
 
1181
+ order = Order.new(amount: 100, email: 'user@example.com')
1182
+
609
1183
  # Act
610
- result = service.process(Order.new(amount: 100, email: 'user@example.com'))
1184
+ result = service.process(order)
611
1185
 
612
1186
  # Assert
613
1187
  expect(result.success?).to be true
614
1188
  expect(payment_gateway).to have_received(:charge).with(100)
1189
+ expect(email_service).to have_received(:send_confirmation)
1190
+ .with('user@example.com', hash_including(transaction_id: 'TXN123'))
615
1191
  end
616
1192
  end
617
1193
  end
618
1194
  ```
619
1195
 
1196
+ #### 使用 RSpec 进行 BDD(原生)
1197
+
1198
+ RSpec 内置 BDD 风格的语法:
1199
+
1200
+ ```ruby
1201
+ # spec/features/shopping_cart_spec.rb
1202
+ RSpec.feature 'Shopping Cart', type: :feature do
1203
+ scenario 'User adds items to cart' do
1204
+ # Given
1205
+ cart = ShoppingCart.new
1206
+
1207
+ # When
1208
+ cart.add_item(name: 'Widget', price: 10)
1209
+ cart.add_item(name: 'Gadget', price: 20)
1210
+
1211
+ # Then
1212
+ expect(cart.total).to eq(30)
1213
+ expect(cart.item_count).to eq(2)
1214
+ end
1215
+
1216
+ scenario 'User applies discount code' do
1217
+ # Given
1218
+ cart = ShoppingCart.new
1219
+ cart.add_item(name: 'Widget', price: 100)
1220
+
1221
+ # When
1222
+ cart.apply_discount(20)
1223
+
1224
+ # Then
1225
+ expect(cart.total).to eq(80)
1226
+ end
1227
+ end
1228
+ ```
1229
+
1230
+ #### 使用 Cucumber 进行 BDD
1231
+
1232
+ ```gherkin
1233
+ # features/shopping_cart.feature
1234
+ Feature: Shopping Cart
1235
+ As a customer
1236
+ I want to manage my shopping cart
1237
+ So that I can purchase products
1238
+
1239
+ Scenario: Add item to cart
1240
+ Given I have an empty cart
1241
+ When I add a "Widget" priced at $10
1242
+ Then my cart total should be $10
1243
+
1244
+ Scenario: Apply discount
1245
+ Given I have a cart with total $100
1246
+ When I apply a 20% discount
1247
+ Then my cart total should be $80
1248
+ ```
1249
+
1250
+ ```ruby
1251
+ # features/step_definitions/cart_steps.rb
1252
+ Given('I have an empty cart') do
1253
+ @cart = ShoppingCart.new
1254
+ end
1255
+
1256
+ When('I add a {string} priced at ${int}') do |name, price|
1257
+ @cart.add_item(name: name, price: price)
1258
+ end
1259
+
1260
+ Then('my cart total should be ${int}') do |expected|
1261
+ expect(@cart.total).to eq(expected)
1262
+ end
1263
+ ```
1264
+
620
1265
  ---
621
1266
 
622
- ## 框架比較摘要
1267
+ ## 框架比较摘要
623
1268
 
624
1269
  | 语言 | 单元测试 | Mock | BDD | Watch 模式 |
625
- |------|---------|------|-----|-----------|
1270
+ |----------|-----------|------|-----|------------|
626
1271
  | **JavaScript** | Jest/Vitest | jest.mock | Cucumber.js | `--watch` |
627
1272
  | **Python** | pytest | unittest.mock | Behave | pytest-watch |
628
1273
  | **C#** | xUnit/NUnit | Moq | SpecFlow | dotnet watch |
@@ -632,8 +1277,8 @@ end
632
1277
 
633
1278
  ---
634
1279
 
635
- ## 相关文件
1280
+ ## 相关文档
636
1281
 
637
- - [SKILL.md](./SKILL.md) - TDD 助手概覽
1282
+ - [SKILL.md](./SKILL.md) - TDD 助手概述
638
1283
  - [TDD 工作流程](./tdd-workflow.md) - 详细工作流程指南
639
1284
  - [TDD 核心标准](../../../../core/test-driven-development.md) - 完整 TDD 标准