universal-dev-standards 6.14.0-beta.1 → 6.14.0-beta.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +13 -3
- package/bin/uds.js +75 -3
- package/bundled/ai/options/code-review/pr-review.ai.yaml +20 -1
- package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
- package/bundled/ai/standards/ai-response-navigation.ai.yaml +43 -3
- package/bundled/ai/standards/checkin-standards.ai.yaml +25 -6
- package/bundled/ai/standards/code-review.ai.yaml +15 -2
- package/bundled/ai/standards/commit-message.ai.yaml +18 -4
- package/bundled/ai/standards/developer-memory.ai.yaml +12 -2
- package/bundled/ai/standards/full-coverage-testing.ai.yaml +86 -7
- package/bundled/ai/standards/open-work-tracking.ai.yaml +196 -11
- package/bundled/ai/standards/pipeline-security-gates.ai.yaml +53 -4
- package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
- package/bundled/core/ai-response-navigation.md +128 -12
- package/bundled/core/code-review-checklist.md +20 -2
- package/bundled/core/commit-message-guide.md +22 -19
- package/bundled/core/developer-memory.md +12 -2
- package/bundled/core/full-coverage-testing.md +99 -5
- package/bundled/core/open-work-tracking.md +157 -17
- package/bundled/core/pipeline-security-gates.md +63 -0
- package/bundled/core/project-context-memory.md +10 -2
- package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
- package/bundled/extensions/languages/csharp-style.md +464 -0
- package/bundled/extensions/languages/php-style.md +700 -0
- package/bundled/extensions/locales/zh-cn.md +717 -0
- package/bundled/extensions/locales/zh-tw.md +717 -0
- package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
- package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
- package/bundled/locales/COVERAGE.md +5 -4
- package/bundled/locales/zh-CN/CHANGELOG.md +199 -3
- package/bundled/locales/zh-CN/README.md +3 -3
- package/bundled/locales/zh-CN/SECURITY.md +3 -2
- package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
- package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
- package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
- package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
- package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
- package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
- package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
- package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
- package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
- package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
- package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
- package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
- package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
- package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
- package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
- package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
- package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
- package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
- package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
- package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
- package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
- package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
- package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
- package/bundled/locales/zh-CN/core/code-review-checklist.md +54 -23
- package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
- package/bundled/locales/zh-CN/core/database-standards.md +115 -114
- package/bundled/locales/zh-CN/core/developer-memory.md +159 -60
- package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
- package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
- package/bundled/locales/zh-CN/core/execution-history.md +2 -1
- package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
- package/bundled/locales/zh-CN/core/full-coverage-testing.md +103 -9
- package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
- package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
- package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
- package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
- package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
- package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
- package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
- package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
- package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
- package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
- package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
- package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
- package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
- package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
- package/bundled/locales/zh-CN/core/security-decision.md +45 -70
- package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
- package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
- package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
- package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
- package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
- package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
- package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
- package/bundled/locales/zh-CN/core/test-governance.md +94 -43
- package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
- package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
- package/bundled/locales/zh-CN/core/token-budget.md +44 -80
- package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
- package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
- package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
- package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
- package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
- package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
- package/bundled/locales/zh-CN/docs/CHEATSHEET.md +9 -3
- package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +68 -33
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +29 -15
- package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
- package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
- package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
- package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
- package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
- package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +46 -0
- package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
- package/bundled/locales/zh-CN/docs/user/README.md +4 -2
- package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
- package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
- package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
- package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
- package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
- package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
- package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
- package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
- package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
- package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
- package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
- package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
- package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
- package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
- package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
- package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
- package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
- package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
- package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
- package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
- package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
- package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
- package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
- package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
- package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
- package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
- package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
- package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
- package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
- package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
- package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
- package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
- package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
- package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
- package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
- package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
- package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
- package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
- package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
- package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
- package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
- package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
- package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/skills/README.md +3 -1
- package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
- package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
- package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
- package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
- package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
- package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
- package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
- package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
- package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
- package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
- package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
- package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
- package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
- package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
- package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
- package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
- package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
- package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
- package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
- package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
- package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
- package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
- package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
- package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
- package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
- package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
- package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
- package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
- package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
- package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
- package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
- package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
- package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
- package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
- package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
- package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
- package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
- package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
- package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
- package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
- package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
- package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
- package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
- package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
- package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
- package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
- package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
- package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
- package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
- package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
- package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
- package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
- package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
- package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
- package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
- package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
- package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
- package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
- package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
- package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
- package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
- package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
- package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
- package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
- package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
- package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
- package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
- package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
- package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
- package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
- package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
- package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
- package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
- package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
- package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
- package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
- package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
- package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
- package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
- package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
- package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
- package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
- package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
- package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
- package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
- package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
- package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
- package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
- package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
- package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
- package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
- package/bundled/locales/zh-TW/CHANGELOG.md +199 -3
- package/bundled/locales/zh-TW/README.md +3 -3
- package/bundled/locales/zh-TW/SECURITY.md +3 -2
- package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
- package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
- package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
- package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
- package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
- package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
- package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
- package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
- package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
- package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
- package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
- package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
- package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
- package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
- package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
- package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
- package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
- package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
- package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
- package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
- package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
- package/bundled/locales/zh-TW/core/code-review-checklist.md +36 -7
- package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
- package/bundled/locales/zh-TW/core/database-standards.md +2 -1
- package/bundled/locales/zh-TW/core/developer-memory.md +111 -12
- package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
- package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
- package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
- package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
- package/bundled/locales/zh-TW/core/execution-history.md +2 -1
- package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
- package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
- package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
- package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
- package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
- package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
- package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
- package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
- package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
- package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
- package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
- package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
- package/bundled/locales/zh-TW/core/open-work-tracking.md +92 -16
- package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
- package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
- package/bundled/locales/zh-TW/core/project-context-memory.md +215 -31
- package/bundled/locales/zh-TW/core/project-structure.md +240 -19
- package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
- package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
- package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
- package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
- package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
- package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
- package/bundled/locales/zh-TW/core/security-decision.md +43 -84
- package/bundled/locales/zh-TW/core/security-standards.md +204 -25
- package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
- package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
- package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
- package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
- package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
- package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
- package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
- package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
- package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
- package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
- package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
- package/bundled/locales/zh-TW/core/test-governance.md +92 -32
- package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
- package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
- package/bundled/locales/zh-TW/core/token-budget.md +41 -112
- package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
- package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
- package/bundled/locales/zh-TW/core/versioning.md +6 -2
- package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
- package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
- package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
- package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
- package/bundled/locales/zh-TW/docs/CHEATSHEET.md +9 -3
- package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +61 -26
- package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +29 -15
- package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
- package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
- package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
- package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
- package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
- package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +46 -0
- package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
- package/bundled/locales/zh-TW/docs/user/README.md +2 -0
- package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
- package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
- package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
- package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
- package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
- package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
- package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
- package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
- package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
- package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
- package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
- package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
- package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
- package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
- package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
- package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
- package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
- package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
- package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
- package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
- package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
- package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
- package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
- package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
- package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
- package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
- package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
- package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
- package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
- package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
- package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
- package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
- package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
- package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
- package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
- package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
- package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
- package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
- package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
- package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
- package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/skills/README.md +3 -1
- package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
- package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
- package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
- package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
- package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
- package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
- package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
- package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
- package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
- package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
- package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
- package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
- package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
- package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
- package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
- package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
- package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
- package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
- package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
- package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
- package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
- package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
- package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
- package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
- package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
- package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
- package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
- package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
- package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
- package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
- package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
- package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
- package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
- package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
- package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
- package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
- package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
- package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
- package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
- package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
- package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
- package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
- package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
- package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
- package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
- package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
- package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
- package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
- package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
- package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
- package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
- package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
- package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
- package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
- package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
- package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
- package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
- package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
- package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
- package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
- package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
- package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
- package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
- package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
- package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
- package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
- package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
- package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
- package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
- package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
- package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
- package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
- package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
- package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
- package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
- package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
- package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
- package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
- package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
- package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
- package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
- package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
- package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
- package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
- package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
- package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
- package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
- package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
- package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
- package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
- package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
- package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
- package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
- package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
- package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
- package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
- package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
- package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
- package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
- package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
- package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
- package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
- package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
- package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
- package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
- package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
- package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
- package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
- package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
- package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
- package/bundled/skills/README.md +1 -0
- package/bundled/skills/SKILL_NAMING.md +9 -0
- package/bundled/skills/commit-standards/SKILL.md +2 -2
- package/bundled/skills/commit-standards/guide.md +3 -2
- package/bundled/skills/commit-standards/language-options.md +19 -17
- package/bundled/skills/comprehension-ladder/SKILL.md +283 -0
- package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
- package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
- package/bundled/templates/gates/check-stubs.mjs +644 -0
- package/package.json +5 -3
- package/src/commands/audit.js +20 -2
- package/src/commands/check.js +155 -28
- package/src/commands/deps.js +31 -1
- package/src/commands/hitl.js +3 -0
- package/src/commands/init.js +159 -48
- package/src/commands/list.js +12 -3
- package/src/commands/mcp.js +2 -3
- package/src/commands/open-work.js +123 -0
- package/src/commands/quickstart.js +29 -13
- package/src/commands/release.js +102 -19
- package/src/commands/run-intent.js +10 -0
- package/src/commands/simulate.js +20 -8
- package/src/commands/skills.js +59 -33
- package/src/commands/spec-split.js +30 -17
- package/src/commands/spec.js +55 -21
- package/src/commands/uninstall.js +146 -32
- package/src/commands/update.js +471 -93
- package/src/core/install-records.js +192 -0
- package/src/core/manifest.js +12 -10
- package/src/core/marketplace-sentinel.js +5 -0
- package/src/core/open-work-config.js +122 -0
- package/src/core/project-config.js +92 -38
- package/src/flows/init-flow.js +10 -0
- package/src/hitl/manager.js +4 -2
- package/src/i18n/messages.js +413 -78
- package/src/installers/hooks-installer.js +236 -27
- package/src/installers/integration-installer.js +5 -1
- package/src/installers/skills-installer.js +3 -1
- package/src/installers/standards-installer.js +16 -23
- package/src/mcp/__tests__/server.test.js +0 -1
- package/src/mcp/server.js +16 -4
- package/src/prompts/init.js +148 -13
- package/src/reconciler/backup-locations.js +80 -0
- package/src/reconciler/backup-manager.js +451 -123
- package/src/reconciler/index.js +86 -10
- package/src/reconciler/install-roots.js +90 -0
- package/src/reconciler/plan-executor.js +37 -15
- package/src/uninstallers/hook-uninstaller.js +220 -33
- package/src/uninstallers/integration-uninstaller.js +35 -5
- package/src/uninstallers/skills-uninstaller.js +95 -16
- package/src/uninstallers/standards-uninstaller.js +56 -7
- package/src/utils/agents-installer.js +10 -17
- package/src/utils/available-standards-report.js +144 -0
- package/src/utils/available-standards.js +216 -0
- package/src/utils/command-hash-ownership.js +103 -0
- package/src/utils/commit-message-judge.js +155 -0
- package/src/utils/copier.js +80 -2
- package/src/utils/deps-applicability.js +25 -0
- package/src/utils/detector.js +46 -1
- package/src/utils/friction-detector.js +27 -0
- package/src/utils/gate-scripts.js +141 -0
- package/src/utils/git-hooks.js +139 -7
- package/src/utils/hasher.js +36 -0
- package/src/utils/health-scorer.js +10 -7
- package/src/utils/installed-names-ownership.js +114 -0
- package/src/utils/integration-generator.js +36 -24
- package/src/utils/legacy-hook-migration.js +112 -0
- package/src/utils/locale.js +19 -0
- package/src/utils/open-work-tracking.mjs +1754 -0
- package/src/utils/prompt-closed.js +18 -0
- package/src/utils/sdd-header.js +66 -0
- package/src/utils/skill-frontmatter.js +102 -0
- package/src/utils/skill-hash-ownership.js +64 -0
- package/src/utils/skill-name-collision.js +169 -0
- package/src/utils/skills-install-paths.js +114 -0
- package/src/utils/skills-installer.js +75 -106
- package/src/utils/standard-validator.js +98 -27
- package/src/utils/test-change-check.js +160 -0
- package/src/utils/test-policy.js +214 -0
- package/src/utils/transient-fs.js +113 -0
- package/src/utils/update-summary.js +29 -0
- package/src/vibe/micro-spec.js +15 -0
- package/standards-registry.json +48 -9
|
@@ -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-
|
|
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
|
-
|
|
14
|
+
**最后更新**: 2026-01-07
|
|
15
15
|
|
|
16
16
|
---
|
|
17
17
|
|
|
18
|
-
##
|
|
18
|
+
## 概述
|
|
19
19
|
|
|
20
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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{
|
|
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
|
-
|
|
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
|
-
####
|
|
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
|
-
|
|
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
|
|
956
|
+
void placeOrder_withValidOrder_processesPaymentAndUpdatesInventory() {
|
|
498
957
|
// Arrange
|
|
499
958
|
Order order = new Order("PROD-1", 2, 50.0);
|
|
500
|
-
when(
|
|
501
|
-
|
|
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
|
-
|
|
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
|
-
|
|
563
|
-
|
|
564
|
-
|
|
565
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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(
|
|
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 标准
|