universal-dev-standards 6.14.0-beta.8 → 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.
- package/bin/uds.js +12 -1
- package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
- package/bundled/ai/standards/commit-message.ai.yaml +12 -2
- package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
- package/bundled/core/commit-message-guide.md +22 -19
- package/bundled/core/secret-management-standards.md +13 -1
- package/bundled/extensions/locales/zh-tw.md +19 -19
- package/bundled/hooks/validate-commit-msg.mjs +52 -9
- package/bundled/locales/zh-CN/CHANGELOG.md +2312 -1102
- package/bundled/locales/zh-CN/CLAUDE.md +987 -101
- package/bundled/locales/zh-CN/README.md +3 -3
- package/bundled/locales/zh-CN/SECURITY.md +3 -3
- package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
- package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
- package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
- package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
- package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
- 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/accessibility-standards.md +871 -62
- 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-friendly-architecture.md +311 -72
- package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
- package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
- package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
- package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
- 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/changelog-standards.md +485 -63
- package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
- 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 +37 -23
- package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
- package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
- 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/deprecation-standards.md +155 -40
- package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
- package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
- package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
- package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
- package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
- package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
- package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
- package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
- package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
- 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/feature-flag-standards.md +202 -57
- package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
- package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
- 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/mutation-testing.md +45 -6
- package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
- package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
- package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
- package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
- package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
- package/bundled/locales/zh-CN/core/project-structure.md +550 -170
- 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/retrospective-standards.md +215 -22
- package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
- package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
- package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
- package/bundled/locales/zh-CN/core/security-decision.md +45 -70
- package/bundled/locales/zh-CN/core/security-standards.md +169 -16
- package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
- package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
- package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
- 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/supply-chain-security-standards.md +159 -32
- package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
- package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
- package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
- package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
- 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/versioning.md +737 -73
- 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/CHEATSHEET.md +2 -1
- package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
- package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
- package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
- package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
- 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 +2 -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/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 +2 -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/ai-instruction-standards/SKILL.md +217 -137
- 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/atdd-assistant/guide.md +148 -132
- 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/bdd-assistant/guide.md +122 -121
- package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
- package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
- package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
- 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/guide.md +119 -45
- 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 +4 -4
- package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
- package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
- package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
- package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
- 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/SKILL.md +4 -2
- 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/docs-generator/guide.md +8 -7
- 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-discovery/guide.md +158 -157
- 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/refactoring-assistant/guide.md +172 -171
- 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/guide.md +51 -43
- 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/guide.md +88 -79
- 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/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
- 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-derivation/SKILL.md +2 -2
- 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/guide.md +217 -156
- 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/test-coverage-assistant/guide.md +25 -12
- 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 +2291 -1110
- package/bundled/locales/zh-TW/CLAUDE.md +962 -76
- package/bundled/locales/zh-TW/README.md +3 -3
- package/bundled/locales/zh-TW/SECURITY.md +3 -3
- package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
- package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
- package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
- package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
- package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
- 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/accessibility-standards.md +895 -46
- 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/agent-dispatch.md +102 -33
- package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
- package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
- package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
- package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
- package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
- package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
- 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/branch-completion.md +130 -34
- 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/chaos-engineering-standards.md +138 -36
- 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 +19 -7
- package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
- package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
- package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
- package/bundled/locales/zh-TW/core/database-standards.md +2 -1
- package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
- package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
- package/bundled/locales/zh-TW/core/developer-memory.md +102 -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/environment-standards.md +250 -72
- package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
- package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
- 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/feature-flag-standards.md +202 -57
- package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
- package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
- 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/anti-hallucination-guide.md +234 -487
- package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
- package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
- package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
- package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
- 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/observability-standards.md +284 -40
- package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
- package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
- package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
- package/bundled/locales/zh-TW/core/project-context-memory.md +210 -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/runbook-standards.md +296 -23
- package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
- 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/slo-standards.md +301 -49
- package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
- 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/CHEATSHEET.md +2 -1
- package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
- package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
- package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
- package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
- package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
- 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 +2 -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/methodologies/guides/tdd-guide.md +584 -475
- 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/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 +2 -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/guide.md +137 -17
- package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
- package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
- 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/docs-generator/guide.md +4 -3
- 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/observability-assistant/SKILL.md +85 -18
- 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/SKILL.md +91 -45
- 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/language-examples.md +693 -47
- 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/.claude-plugin/plugin.json +71 -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/package.json +2 -2
- package/src/commands/audit.js +28 -1
- package/src/commands/check.js +77 -7
- package/src/commands/compile.js +37 -4
- package/src/commands/config.js +49 -24
- package/src/commands/init.js +78 -30
- package/src/commands/open-work.js +6 -2
- package/src/commands/release-messages.js +228 -0
- package/src/commands/release.js +127 -68
- package/src/commands/run-intent.js +11 -0
- package/src/commands/spec-split.js +2 -1
- package/src/commands/spec.js +11 -2
- package/src/commands/update.js +184 -30
- package/src/compilers/claude-code-compiler.js +9 -1
- package/src/config/ai-agent-paths.js +14 -1
- package/src/core/installed-formats.js +15 -0
- package/src/core/open-work-config.js +20 -1
- package/src/core/project-config.js +55 -0
- package/src/i18n/messages.js +160 -2
- package/src/installers/hooks-installer.js +1 -1
- package/src/installers/manifest-installer.js +1 -1
- package/src/installers/skills-installer.js +1 -1
- package/src/installers/standards-installer.js +3 -1
- package/src/mcp/server.js +9 -3
- package/src/prompts/init.js +26 -22
- package/src/reconciler/actual-state-scanner.js +2 -8
- package/src/reconciler/backup-locations.js +5 -0
- package/src/reconciler/backup-manager.js +19 -11
- package/src/reconciler/desired-state-calculator.js +89 -57
- package/src/reconciler/plan-executor.js +101 -8
- package/src/reconciler/recorded-versions.js +49 -0
- package/src/reconciler/relative-path.js +23 -0
- package/src/uninstallers/hook-uninstaller.js +9 -1
- package/src/uninstallers/skills-uninstaller.js +22 -3
- package/src/utils/available-standards-report.js +25 -4
- package/src/utils/available-standards.js +13 -3
- package/src/utils/build-manifest.js +1 -1
- package/src/utils/commit-message-judge.js +60 -13
- package/src/utils/friction-detector.js +23 -11
- package/src/utils/git-hooks.js +106 -4
- package/src/utils/integration-generator.js +95 -67
- package/src/utils/legacy-hook-migration.js +121 -2
- package/src/utils/open-work-tracking.mjs +105 -16
- package/src/utils/sdd-header.js +16 -4
- package/src/utils/skills-installer.js +2 -1
- package/src/utils/spinner.js +14 -4
- package/src/utils/standard-validator.js +3 -2
- package/standards-registry.json +10 -8
- package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
|
@@ -2,7 +2,8 @@
|
|
|
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-16
|
|
6
|
+
source_hash: 481f97a74878
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
@@ -48,9 +49,20 @@ npm install --save-dev jest @types/jest ts-jest
|
|
|
48
49
|
npm install --save-dev vitest
|
|
49
50
|
```
|
|
50
51
|
|
|
52
|
+
```json
|
|
53
|
+
// package.json
|
|
54
|
+
{
|
|
55
|
+
"scripts": {
|
|
56
|
+
"test": "jest",
|
|
57
|
+
"test:watch": "jest --watch",
|
|
58
|
+
"test:coverage": "jest --coverage"
|
|
59
|
+
}
|
|
60
|
+
}
|
|
61
|
+
```
|
|
62
|
+
|
|
51
63
|
#### 完整 TDD 範例:購物車
|
|
52
64
|
|
|
53
|
-
**步驟 1
|
|
65
|
+
**步驟 1:紅燈 - 撰寫失敗測試**
|
|
54
66
|
|
|
55
67
|
```typescript
|
|
56
68
|
// cart.test.ts
|
|
@@ -59,13 +71,13 @@ import { ShoppingCart } from './cart';
|
|
|
59
71
|
describe('ShoppingCart', () => {
|
|
60
72
|
describe('calculateTotal', () => {
|
|
61
73
|
test('should return 0 for empty cart', () => {
|
|
62
|
-
// Arrange
|
|
74
|
+
// Arrange
|
|
63
75
|
const cart = new ShoppingCart();
|
|
64
76
|
|
|
65
|
-
// Act
|
|
77
|
+
// Act
|
|
66
78
|
const total = cart.calculateTotal();
|
|
67
79
|
|
|
68
|
-
// Assert
|
|
80
|
+
// Assert
|
|
69
81
|
expect(total).toBe(0);
|
|
70
82
|
});
|
|
71
83
|
});
|
|
@@ -74,20 +86,20 @@ describe('ShoppingCart', () => {
|
|
|
74
86
|
|
|
75
87
|
執行測試 - 它失敗因為 `ShoppingCart` 不存在。
|
|
76
88
|
|
|
77
|
-
**步驟 2
|
|
89
|
+
**步驟 2:綠燈 - 最少實現**
|
|
78
90
|
|
|
79
91
|
```typescript
|
|
80
92
|
// cart.ts
|
|
81
93
|
export class ShoppingCart {
|
|
82
94
|
calculateTotal(): number {
|
|
83
|
-
return 0; //
|
|
95
|
+
return 0; // Fake it!
|
|
84
96
|
}
|
|
85
97
|
}
|
|
86
98
|
```
|
|
87
99
|
|
|
88
100
|
測試通過。
|
|
89
101
|
|
|
90
|
-
**步驟 3
|
|
102
|
+
**步驟 3:紅燈 - 新增下一個測試**
|
|
91
103
|
|
|
92
104
|
```typescript
|
|
93
105
|
test('should return sum of item prices', () => {
|
|
@@ -101,7 +113,7 @@ test('should return sum of item prices', () => {
|
|
|
101
113
|
});
|
|
102
114
|
```
|
|
103
115
|
|
|
104
|
-
**步驟 4
|
|
116
|
+
**步驟 4:綠燈 - 實現**
|
|
105
117
|
|
|
106
118
|
```typescript
|
|
107
119
|
export class ShoppingCart {
|
|
@@ -117,6 +129,43 @@ export class ShoppingCart {
|
|
|
117
129
|
}
|
|
118
130
|
```
|
|
119
131
|
|
|
132
|
+
**步驟 5:紅燈 - 包含折扣的測試**
|
|
133
|
+
|
|
134
|
+
```typescript
|
|
135
|
+
test('should apply percentage discount', () => {
|
|
136
|
+
const cart = new ShoppingCart();
|
|
137
|
+
cart.addItem({ name: 'Widget', price: 100 });
|
|
138
|
+
cart.applyDiscount(20); // 20% off
|
|
139
|
+
|
|
140
|
+
const total = cart.calculateTotal();
|
|
141
|
+
|
|
142
|
+
expect(total).toBe(80);
|
|
143
|
+
});
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
**步驟 6:綠燈與重構**
|
|
147
|
+
|
|
148
|
+
```typescript
|
|
149
|
+
export class ShoppingCart {
|
|
150
|
+
private items: Array<{ name: string; price: number }> = [];
|
|
151
|
+
private discountPercent = 0;
|
|
152
|
+
|
|
153
|
+
addItem(item: { name: string; price: number }): void {
|
|
154
|
+
this.items.push(item);
|
|
155
|
+
}
|
|
156
|
+
|
|
157
|
+
applyDiscount(percent: number): void {
|
|
158
|
+
this.discountPercent = percent;
|
|
159
|
+
}
|
|
160
|
+
|
|
161
|
+
calculateTotal(): number {
|
|
162
|
+
const subtotal = this.items.reduce((sum, item) => sum + item.price, 0);
|
|
163
|
+
const discount = subtotal * (this.discountPercent / 100);
|
|
164
|
+
return subtotal - discount;
|
|
165
|
+
}
|
|
166
|
+
}
|
|
167
|
+
```
|
|
168
|
+
|
|
120
169
|
#### Mock 範例
|
|
121
170
|
|
|
122
171
|
```typescript
|
|
@@ -127,16 +176,21 @@ import { PaymentGateway } from './paymentGateway';
|
|
|
127
176
|
jest.mock('./paymentGateway');
|
|
128
177
|
|
|
129
178
|
describe('OrderService', () => {
|
|
179
|
+
let orderService: OrderService;
|
|
180
|
+
let mockPaymentGateway: jest.Mocked<PaymentGateway>;
|
|
181
|
+
|
|
182
|
+
beforeEach(() => {
|
|
183
|
+
mockPaymentGateway = new PaymentGateway() as jest.Mocked<PaymentGateway>;
|
|
184
|
+
orderService = new OrderService(mockPaymentGateway);
|
|
185
|
+
});
|
|
186
|
+
|
|
130
187
|
test('should process payment and return order confirmation', async () => {
|
|
131
188
|
// Arrange
|
|
132
|
-
const mockPaymentGateway = new PaymentGateway() as jest.Mocked<PaymentGateway>;
|
|
133
189
|
mockPaymentGateway.charge.mockResolvedValue({
|
|
134
190
|
success: true,
|
|
135
191
|
transactionId: 'TXN123'
|
|
136
192
|
});
|
|
137
193
|
|
|
138
|
-
const orderService = new OrderService(mockPaymentGateway);
|
|
139
|
-
|
|
140
194
|
// Act
|
|
141
195
|
const result = await orderService.checkout({
|
|
142
196
|
amount: 100,
|
|
@@ -145,11 +199,53 @@ describe('OrderService', () => {
|
|
|
145
199
|
|
|
146
200
|
// Assert
|
|
147
201
|
expect(result.confirmed).toBe(true);
|
|
202
|
+
expect(result.transactionId).toBe('TXN123');
|
|
148
203
|
expect(mockPaymentGateway.charge).toHaveBeenCalledWith(100, '4111111111111111');
|
|
149
204
|
});
|
|
150
205
|
});
|
|
151
206
|
```
|
|
152
207
|
|
|
208
|
+
#### 搭配 Cucumber.js 的 BDD
|
|
209
|
+
|
|
210
|
+
```gherkin
|
|
211
|
+
# features/shopping_cart.feature
|
|
212
|
+
Feature: Shopping Cart
|
|
213
|
+
As a customer
|
|
214
|
+
I want to add items to my cart
|
|
215
|
+
So that I can purchase them
|
|
216
|
+
|
|
217
|
+
Scenario: Add item to empty cart
|
|
218
|
+
Given I have an empty shopping cart
|
|
219
|
+
When I add a "Widget" priced at $10
|
|
220
|
+
Then the cart total should be $10
|
|
221
|
+
|
|
222
|
+
Scenario: Apply discount code
|
|
223
|
+
Given I have a cart with items totaling $100
|
|
224
|
+
When I apply discount code "SAVE20"
|
|
225
|
+
Then the cart total should be $80
|
|
226
|
+
```
|
|
227
|
+
|
|
228
|
+
```typescript
|
|
229
|
+
// features/step_definitions/cart_steps.ts
|
|
230
|
+
import { Given, When, Then } from '@cucumber/cucumber';
|
|
231
|
+
import { expect } from 'chai';
|
|
232
|
+
import { ShoppingCart } from '../src/cart';
|
|
233
|
+
|
|
234
|
+
let cart: ShoppingCart;
|
|
235
|
+
|
|
236
|
+
Given('I have an empty shopping cart', function () {
|
|
237
|
+
cart = new ShoppingCart();
|
|
238
|
+
});
|
|
239
|
+
|
|
240
|
+
When('I add a {string} priced at ${int}', function (name: string, price: number) {
|
|
241
|
+
cart.addItem({ name, price });
|
|
242
|
+
});
|
|
243
|
+
|
|
244
|
+
Then('the cart total should be ${int}', function (expected: number) {
|
|
245
|
+
expect(cart.calculateTotal()).to.equal(expected);
|
|
246
|
+
});
|
|
247
|
+
```
|
|
248
|
+
|
|
153
249
|
---
|
|
154
250
|
|
|
155
251
|
## Python
|
|
@@ -162,6 +258,15 @@ describe('OrderService', () => {
|
|
|
162
258
|
pip install pytest pytest-cov pytest-mock
|
|
163
259
|
```
|
|
164
260
|
|
|
261
|
+
```ini
|
|
262
|
+
# pytest.ini
|
|
263
|
+
[pytest]
|
|
264
|
+
testpaths = tests
|
|
265
|
+
python_files = test_*.py
|
|
266
|
+
python_functions = test_*
|
|
267
|
+
addopts = -v --tb=short
|
|
268
|
+
```
|
|
269
|
+
|
|
165
270
|
#### 完整 TDD 範例:計算機
|
|
166
271
|
|
|
167
272
|
**步驟 1:紅色**
|
|
@@ -173,13 +278,13 @@ from calculator import Calculator
|
|
|
173
278
|
|
|
174
279
|
class TestCalculator:
|
|
175
280
|
def test_add_two_positive_numbers(self):
|
|
176
|
-
# Arrange
|
|
281
|
+
# Arrange
|
|
177
282
|
calc = Calculator()
|
|
178
283
|
|
|
179
|
-
# Act
|
|
284
|
+
# Act
|
|
180
285
|
result = calc.add(2, 3)
|
|
181
286
|
|
|
182
|
-
# Assert
|
|
287
|
+
# Assert
|
|
183
288
|
assert result == 5
|
|
184
289
|
```
|
|
185
290
|
|
|
@@ -189,7 +294,7 @@ class TestCalculator:
|
|
|
189
294
|
# calculator.py
|
|
190
295
|
class Calculator:
|
|
191
296
|
def add(self, a: float, b: float) -> float:
|
|
192
|
-
return 5 #
|
|
297
|
+
return 5 # Fake it!
|
|
193
298
|
```
|
|
194
299
|
|
|
195
300
|
**步驟 3:紅色 - 強制泛化**
|
|
@@ -201,7 +306,7 @@ def test_add_different_numbers(self):
|
|
|
201
306
|
assert result == 30
|
|
202
307
|
```
|
|
203
308
|
|
|
204
|
-
**步驟 4:綠色 -
|
|
309
|
+
**步驟 4:綠色 - 實作**
|
|
205
310
|
|
|
206
311
|
```python
|
|
207
312
|
class Calculator:
|
|
@@ -209,10 +314,41 @@ class Calculator:
|
|
|
209
314
|
return a + b
|
|
210
315
|
```
|
|
211
316
|
|
|
317
|
+
**步驟 5:紅色 - 新增更多運算**
|
|
318
|
+
|
|
319
|
+
```python
|
|
320
|
+
def test_subtract_returns_difference(self):
|
|
321
|
+
calc = Calculator()
|
|
322
|
+
result = calc.subtract(10, 3)
|
|
323
|
+
assert result == 7
|
|
324
|
+
|
|
325
|
+
def test_divide_by_zero_raises_error(self):
|
|
326
|
+
calc = Calculator()
|
|
327
|
+
with pytest.raises(ValueError, match="Cannot divide by zero"):
|
|
328
|
+
calc.divide(10, 0)
|
|
329
|
+
```
|
|
330
|
+
|
|
331
|
+
**步驟 6:綠色與重構**
|
|
332
|
+
|
|
333
|
+
```python
|
|
334
|
+
class Calculator:
|
|
335
|
+
def add(self, a: float, b: float) -> float:
|
|
336
|
+
return a + b
|
|
337
|
+
|
|
338
|
+
def subtract(self, a: float, b: float) -> float:
|
|
339
|
+
return a - b
|
|
340
|
+
|
|
341
|
+
def divide(self, a: float, b: float) -> float:
|
|
342
|
+
if b == 0:
|
|
343
|
+
raise ValueError("Cannot divide by zero")
|
|
344
|
+
return a / b
|
|
345
|
+
```
|
|
346
|
+
|
|
212
347
|
#### Mock 範例
|
|
213
348
|
|
|
214
349
|
```python
|
|
215
350
|
# tests/test_user_service.py
|
|
351
|
+
import pytest
|
|
216
352
|
from unittest.mock import Mock, patch
|
|
217
353
|
from user_service import UserService
|
|
218
354
|
|
|
@@ -233,6 +369,63 @@ class TestUserService:
|
|
|
233
369
|
subject="Welcome!",
|
|
234
370
|
body="Hello John, welcome to our service!"
|
|
235
371
|
)
|
|
372
|
+
|
|
373
|
+
def test_get_user_returns_user_from_repository(self):
|
|
374
|
+
# Arrange
|
|
375
|
+
mock_repo = Mock()
|
|
376
|
+
mock_repo.find_by_id.return_value = {"id": 1, "name": "John"}
|
|
377
|
+
service = UserService(repository=mock_repo)
|
|
378
|
+
|
|
379
|
+
# Act
|
|
380
|
+
user = service.get_user(1)
|
|
381
|
+
|
|
382
|
+
# Assert
|
|
383
|
+
assert user["name"] == "John"
|
|
384
|
+
mock_repo.find_by_id.assert_called_once_with(1)
|
|
385
|
+
```
|
|
386
|
+
|
|
387
|
+
#### 搭配 Behave 的 BDD
|
|
388
|
+
|
|
389
|
+
```gherkin
|
|
390
|
+
# features/calculator.feature
|
|
391
|
+
Feature: Calculator
|
|
392
|
+
As a user
|
|
393
|
+
I want to perform calculations
|
|
394
|
+
So that I can solve math problems
|
|
395
|
+
|
|
396
|
+
Scenario: Add two numbers
|
|
397
|
+
Given I have a calculator
|
|
398
|
+
When I add 5 and 3
|
|
399
|
+
Then the result should be 8
|
|
400
|
+
|
|
401
|
+
Scenario Outline: Multiple additions
|
|
402
|
+
Given I have a calculator
|
|
403
|
+
When I add <a> and <b>
|
|
404
|
+
Then the result should be <result>
|
|
405
|
+
|
|
406
|
+
Examples:
|
|
407
|
+
| a | b | result |
|
|
408
|
+
| 1 | 1 | 2 |
|
|
409
|
+
| 10 | 20 | 30 |
|
|
410
|
+
| -5 | 5 | 0 |
|
|
411
|
+
```
|
|
412
|
+
|
|
413
|
+
```python
|
|
414
|
+
# features/steps/calculator_steps.py
|
|
415
|
+
from behave import given, when, then
|
|
416
|
+
from calculator import Calculator
|
|
417
|
+
|
|
418
|
+
@given('I have a calculator')
|
|
419
|
+
def step_impl(context):
|
|
420
|
+
context.calculator = Calculator()
|
|
421
|
+
|
|
422
|
+
@when('I add {a:d} and {b:d}')
|
|
423
|
+
def step_impl(context, a, b):
|
|
424
|
+
context.result = context.calculator.add(a, b)
|
|
425
|
+
|
|
426
|
+
@then('the result should be {expected:d}')
|
|
427
|
+
def step_impl(context, expected):
|
|
428
|
+
assert context.result == expected
|
|
236
429
|
```
|
|
237
430
|
|
|
238
431
|
---
|
|
@@ -264,14 +457,14 @@ public class OrderProcessorTests
|
|
|
264
457
|
[Fact]
|
|
265
458
|
public void ProcessOrder_WithValidOrder_ReturnsSuccess()
|
|
266
459
|
{
|
|
267
|
-
// Arrange
|
|
460
|
+
// Arrange
|
|
268
461
|
var processor = new OrderProcessor();
|
|
269
462
|
var order = new Order { Id = 1, Amount = 100 };
|
|
270
463
|
|
|
271
|
-
// Act
|
|
464
|
+
// Act
|
|
272
465
|
var result = processor.Process(order);
|
|
273
466
|
|
|
274
|
-
// Assert
|
|
467
|
+
// Assert
|
|
275
468
|
result.IsSuccess.Should().BeTrue();
|
|
276
469
|
}
|
|
277
470
|
}
|
|
@@ -285,15 +478,74 @@ public class OrderProcessor
|
|
|
285
478
|
{
|
|
286
479
|
public ProcessResult Process(Order order)
|
|
287
480
|
{
|
|
288
|
-
return new ProcessResult { IsSuccess = true }; //
|
|
481
|
+
return new ProcessResult { IsSuccess = true }; // Fake it!
|
|
482
|
+
}
|
|
483
|
+
}
|
|
484
|
+
|
|
485
|
+
public class Order
|
|
486
|
+
{
|
|
487
|
+
public int Id { get; set; }
|
|
488
|
+
public decimal Amount { get; set; }
|
|
489
|
+
}
|
|
490
|
+
|
|
491
|
+
public class ProcessResult
|
|
492
|
+
{
|
|
493
|
+
public bool IsSuccess { get; set; }
|
|
494
|
+
public string? ErrorMessage { get; set; }
|
|
495
|
+
}
|
|
496
|
+
```
|
|
497
|
+
|
|
498
|
+
**步驟 3:紅色 - 新增驗證**
|
|
499
|
+
|
|
500
|
+
```csharp
|
|
501
|
+
[Fact]
|
|
502
|
+
public void ProcessOrder_WithZeroAmount_ReturnsFailure()
|
|
503
|
+
{
|
|
504
|
+
var processor = new OrderProcessor();
|
|
505
|
+
var order = new Order { Id = 1, Amount = 0 };
|
|
506
|
+
|
|
507
|
+
var result = processor.Process(order);
|
|
508
|
+
|
|
509
|
+
result.IsSuccess.Should().BeFalse();
|
|
510
|
+
result.ErrorMessage.Should().Be("Order amount must be greater than zero");
|
|
511
|
+
}
|
|
512
|
+
```
|
|
513
|
+
|
|
514
|
+
**步驟 4:綠色與重構**
|
|
515
|
+
|
|
516
|
+
```csharp
|
|
517
|
+
public class OrderProcessor
|
|
518
|
+
{
|
|
519
|
+
public ProcessResult Process(Order order)
|
|
520
|
+
{
|
|
521
|
+
if (order.Amount <= 0)
|
|
522
|
+
{
|
|
523
|
+
return ProcessResult.Failure("Order amount must be greater than zero");
|
|
524
|
+
}
|
|
525
|
+
|
|
526
|
+
return ProcessResult.Success();
|
|
289
527
|
}
|
|
290
528
|
}
|
|
529
|
+
|
|
530
|
+
public class ProcessResult
|
|
531
|
+
{
|
|
532
|
+
public bool IsSuccess { get; private set; }
|
|
533
|
+
public string? ErrorMessage { get; private set; }
|
|
534
|
+
|
|
535
|
+
public static ProcessResult Success() =>
|
|
536
|
+
new() { IsSuccess = true };
|
|
537
|
+
|
|
538
|
+
public static ProcessResult Failure(string message) =>
|
|
539
|
+
new() { IsSuccess = false, ErrorMessage = message };
|
|
540
|
+
}
|
|
291
541
|
```
|
|
292
542
|
|
|
293
|
-
#### Moq 範例
|
|
543
|
+
#### 使用 Moq 的 Mock 範例
|
|
294
544
|
|
|
295
545
|
```csharp
|
|
296
546
|
using Moq;
|
|
547
|
+
using Xunit;
|
|
548
|
+
using FluentAssertions;
|
|
297
549
|
|
|
298
550
|
public class PaymentServiceTests
|
|
299
551
|
{
|
|
@@ -302,18 +554,87 @@ public class PaymentServiceTests
|
|
|
302
554
|
{
|
|
303
555
|
// Arrange
|
|
304
556
|
var mockGateway = new Mock<IPaymentGateway>();
|
|
557
|
+
var mockEmailService = new Mock<IEmailService>();
|
|
558
|
+
|
|
305
559
|
mockGateway
|
|
306
560
|
.Setup(g => g.ChargeAsync(It.IsAny<decimal>(), It.IsAny<string>()))
|
|
307
561
|
.ReturnsAsync(new ChargeResult { TransactionId = "TXN123" });
|
|
308
562
|
|
|
309
|
-
var service = new PaymentService(mockGateway.Object);
|
|
563
|
+
var service = new PaymentService(mockGateway.Object, mockEmailService.Object);
|
|
310
564
|
|
|
311
565
|
// Act
|
|
312
|
-
var result = await service.ProcessPaymentAsync(100, "4111111111111111");
|
|
566
|
+
var result = await service.ProcessPaymentAsync(100, "4111111111111111", "user@example.com");
|
|
313
567
|
|
|
314
568
|
// Assert
|
|
315
569
|
result.TransactionId.Should().Be("TXN123");
|
|
316
|
-
|
|
570
|
+
|
|
571
|
+
mockGateway.Verify(
|
|
572
|
+
g => g.ChargeAsync(100, "4111111111111111"),
|
|
573
|
+
Times.Once);
|
|
574
|
+
|
|
575
|
+
mockEmailService.Verify(
|
|
576
|
+
e => e.SendReceiptAsync("user@example.com", It.Is<Receipt>(r => r.TransactionId == "TXN123")),
|
|
577
|
+
Times.Once);
|
|
578
|
+
}
|
|
579
|
+
}
|
|
580
|
+
```
|
|
581
|
+
|
|
582
|
+
#### 使用 SpecFlow 的 BDD
|
|
583
|
+
|
|
584
|
+
```gherkin
|
|
585
|
+
# Features/OrderProcessing.feature
|
|
586
|
+
Feature: Order Processing
|
|
587
|
+
As an e-commerce system
|
|
588
|
+
I want to process customer orders
|
|
589
|
+
So that customers can receive their products
|
|
590
|
+
|
|
591
|
+
Scenario: Process valid order
|
|
592
|
+
Given I have an order with amount $100
|
|
593
|
+
When I process the order
|
|
594
|
+
Then the order should be marked as processed
|
|
595
|
+
And a confirmation email should be sent
|
|
596
|
+
|
|
597
|
+
Scenario: Reject order with zero amount
|
|
598
|
+
Given I have an order with amount $0
|
|
599
|
+
When I process the order
|
|
600
|
+
Then the order should be rejected
|
|
601
|
+
And the error message should be "Order amount must be greater than zero"
|
|
602
|
+
```
|
|
603
|
+
|
|
604
|
+
```csharp
|
|
605
|
+
// StepDefinitions/OrderProcessingSteps.cs
|
|
606
|
+
using TechTalk.SpecFlow;
|
|
607
|
+
using FluentAssertions;
|
|
608
|
+
|
|
609
|
+
[Binding]
|
|
610
|
+
public class OrderProcessingSteps
|
|
611
|
+
{
|
|
612
|
+
private Order _order;
|
|
613
|
+
private ProcessResult _result;
|
|
614
|
+
private readonly OrderProcessor _processor = new();
|
|
615
|
+
|
|
616
|
+
[Given(@"I have an order with amount \$(.*)")]
|
|
617
|
+
public void GivenIHaveAnOrderWithAmount(decimal amount)
|
|
618
|
+
{
|
|
619
|
+
_order = new Order { Id = 1, Amount = amount };
|
|
620
|
+
}
|
|
621
|
+
|
|
622
|
+
[When(@"I process the order")]
|
|
623
|
+
public void WhenIProcessTheOrder()
|
|
624
|
+
{
|
|
625
|
+
_result = _processor.Process(_order);
|
|
626
|
+
}
|
|
627
|
+
|
|
628
|
+
[Then(@"the order should be marked as processed")]
|
|
629
|
+
public void ThenTheOrderShouldBeMarkedAsProcessed()
|
|
630
|
+
{
|
|
631
|
+
_result.IsSuccess.Should().BeTrue();
|
|
632
|
+
}
|
|
633
|
+
|
|
634
|
+
[Then(@"the error message should be ""(.*)""")]
|
|
635
|
+
public void ThenTheErrorMessageShouldBe(string expectedMessage)
|
|
636
|
+
{
|
|
637
|
+
_result.ErrorMessage.Should().Be(expectedMessage);
|
|
317
638
|
}
|
|
318
639
|
}
|
|
319
640
|
```
|
|
@@ -344,14 +665,14 @@ import (
|
|
|
344
665
|
)
|
|
345
666
|
|
|
346
667
|
func TestUserRepository_FindById_ReturnsUser(t *testing.T) {
|
|
347
|
-
// Arrange
|
|
668
|
+
// Arrange
|
|
348
669
|
repo := NewUserRepository()
|
|
349
670
|
repo.Save(&User{ID: 1, Name: "John"})
|
|
350
671
|
|
|
351
|
-
// Act
|
|
672
|
+
// Act
|
|
352
673
|
user, err := repo.FindById(1)
|
|
353
674
|
|
|
354
|
-
// Assert
|
|
675
|
+
// Assert
|
|
355
676
|
assert.NoError(t, err)
|
|
356
677
|
assert.Equal(t, "John", user.Name)
|
|
357
678
|
}
|
|
@@ -363,12 +684,21 @@ func TestUserRepository_FindById_ReturnsUser(t *testing.T) {
|
|
|
363
684
|
// user_repository.go
|
|
364
685
|
package repository
|
|
365
686
|
|
|
687
|
+
import "errors"
|
|
688
|
+
|
|
689
|
+
type User struct {
|
|
690
|
+
ID int
|
|
691
|
+
Name string
|
|
692
|
+
}
|
|
693
|
+
|
|
366
694
|
type UserRepository struct {
|
|
367
695
|
users map[int]*User
|
|
368
696
|
}
|
|
369
697
|
|
|
370
698
|
func NewUserRepository() *UserRepository {
|
|
371
|
-
return &UserRepository{
|
|
699
|
+
return &UserRepository{
|
|
700
|
+
users: make(map[int]*User),
|
|
701
|
+
}
|
|
372
702
|
}
|
|
373
703
|
|
|
374
704
|
func (r *UserRepository) Save(user *User) {
|
|
@@ -384,6 +714,19 @@ func (r *UserRepository) FindById(id int) (*User, error) {
|
|
|
384
714
|
}
|
|
385
715
|
```
|
|
386
716
|
|
|
717
|
+
**步驟 3:紅色 - 錯誤案例**
|
|
718
|
+
|
|
719
|
+
```go
|
|
720
|
+
func TestUserRepository_FindById_ReturnsErrorWhenNotFound(t *testing.T) {
|
|
721
|
+
repo := NewUserRepository()
|
|
722
|
+
|
|
723
|
+
user, err := repo.FindById(999)
|
|
724
|
+
|
|
725
|
+
assert.Nil(t, user)
|
|
726
|
+
assert.EqualError(t, err, "user not found")
|
|
727
|
+
}
|
|
728
|
+
```
|
|
729
|
+
|
|
387
730
|
#### 表格驅動測試(Go 慣例)
|
|
388
731
|
|
|
389
732
|
```go
|
|
@@ -419,6 +762,44 @@ func TestUserRepository_Save(t *testing.T) {
|
|
|
419
762
|
}
|
|
420
763
|
```
|
|
421
764
|
|
|
765
|
+
#### 使用 testify/mock 進行 Mock
|
|
766
|
+
|
|
767
|
+
```go
|
|
768
|
+
// email_service_test.go
|
|
769
|
+
package service
|
|
770
|
+
|
|
771
|
+
import (
|
|
772
|
+
"testing"
|
|
773
|
+
"github.com/stretchr/testify/assert"
|
|
774
|
+
"github.com/stretchr/testify/mock"
|
|
775
|
+
)
|
|
776
|
+
|
|
777
|
+
// Mock
|
|
778
|
+
type MockEmailSender struct {
|
|
779
|
+
mock.Mock
|
|
780
|
+
}
|
|
781
|
+
|
|
782
|
+
func (m *MockEmailSender) Send(to, subject, body string) error {
|
|
783
|
+
args := m.Called(to, subject, body)
|
|
784
|
+
return args.Error(0)
|
|
785
|
+
}
|
|
786
|
+
|
|
787
|
+
func TestNotificationService_SendWelcome(t *testing.T) {
|
|
788
|
+
// Arrange
|
|
789
|
+
mockSender := new(MockEmailSender)
|
|
790
|
+
mockSender.On("Send", "user@example.com", "Welcome!", mock.Anything).Return(nil)
|
|
791
|
+
|
|
792
|
+
service := NewNotificationService(mockSender)
|
|
793
|
+
|
|
794
|
+
// Act
|
|
795
|
+
err := service.SendWelcome("user@example.com")
|
|
796
|
+
|
|
797
|
+
// Assert
|
|
798
|
+
assert.NoError(t, err)
|
|
799
|
+
mockSender.AssertExpectations(t)
|
|
800
|
+
}
|
|
801
|
+
```
|
|
802
|
+
|
|
422
803
|
---
|
|
423
804
|
|
|
424
805
|
## Java
|
|
@@ -441,6 +822,12 @@ func TestUserRepository_Save(t *testing.T) {
|
|
|
441
822
|
<version>5.5.0</version>
|
|
442
823
|
<scope>test</scope>
|
|
443
824
|
</dependency>
|
|
825
|
+
<dependency>
|
|
826
|
+
<groupId>org.assertj</groupId>
|
|
827
|
+
<artifactId>assertj-core</artifactId>
|
|
828
|
+
<version>3.24.2</version>
|
|
829
|
+
<scope>test</scope>
|
|
830
|
+
</dependency>
|
|
444
831
|
</dependencies>
|
|
445
832
|
```
|
|
446
833
|
|
|
@@ -457,14 +844,14 @@ class AccountServiceTest {
|
|
|
457
844
|
|
|
458
845
|
@Test
|
|
459
846
|
void deposit_withPositiveAmount_increasesBalance() {
|
|
460
|
-
// Arrange
|
|
847
|
+
// Arrange
|
|
461
848
|
AccountService service = new AccountService();
|
|
462
849
|
Account account = new Account(100.0);
|
|
463
850
|
|
|
464
|
-
// Act
|
|
851
|
+
// Act
|
|
465
852
|
service.deposit(account, 50.0);
|
|
466
853
|
|
|
467
|
-
// Assert
|
|
854
|
+
// Assert
|
|
468
855
|
assertThat(account.getBalance()).isEqualTo(150.0);
|
|
469
856
|
}
|
|
470
857
|
}
|
|
@@ -479,37 +866,176 @@ public class AccountService {
|
|
|
479
866
|
account.setBalance(account.getBalance() + amount);
|
|
480
867
|
}
|
|
481
868
|
}
|
|
869
|
+
|
|
870
|
+
// Account.java
|
|
871
|
+
public class Account {
|
|
872
|
+
private double balance;
|
|
873
|
+
|
|
874
|
+
public Account(double initialBalance) {
|
|
875
|
+
this.balance = initialBalance;
|
|
876
|
+
}
|
|
877
|
+
|
|
878
|
+
public double getBalance() { return balance; }
|
|
879
|
+
public void setBalance(double balance) { this.balance = balance; }
|
|
880
|
+
}
|
|
482
881
|
```
|
|
483
882
|
|
|
484
|
-
|
|
883
|
+
**步驟 3:紅色 - 驗證**
|
|
485
884
|
|
|
486
885
|
```java
|
|
886
|
+
@Test
|
|
887
|
+
void deposit_withNegativeAmount_throwsException() {
|
|
888
|
+
AccountService service = new AccountService();
|
|
889
|
+
Account account = new Account(100.0);
|
|
890
|
+
|
|
891
|
+
assertThatThrownBy(() -> service.deposit(account, -50.0))
|
|
892
|
+
.isInstanceOf(IllegalArgumentException.class)
|
|
893
|
+
.hasMessage("Deposit amount must be positive");
|
|
894
|
+
}
|
|
895
|
+
|
|
896
|
+
@Test
|
|
897
|
+
void withdraw_withInsufficientFunds_throwsException() {
|
|
898
|
+
AccountService service = new AccountService();
|
|
899
|
+
Account account = new Account(100.0);
|
|
900
|
+
|
|
901
|
+
assertThatThrownBy(() -> service.withdraw(account, 150.0))
|
|
902
|
+
.isInstanceOf(InsufficientFundsException.class)
|
|
903
|
+
.hasMessage("Insufficient funds");
|
|
904
|
+
}
|
|
905
|
+
```
|
|
906
|
+
|
|
907
|
+
**步驟 4:綠色與重構**
|
|
908
|
+
|
|
909
|
+
```java
|
|
910
|
+
public class AccountService {
|
|
911
|
+
|
|
912
|
+
public void deposit(Account account, double amount) {
|
|
913
|
+
validatePositiveAmount(amount, "Deposit");
|
|
914
|
+
account.setBalance(account.getBalance() + amount);
|
|
915
|
+
}
|
|
916
|
+
|
|
917
|
+
public void withdraw(Account account, double amount) {
|
|
918
|
+
validatePositiveAmount(amount, "Withdrawal");
|
|
919
|
+
if (account.getBalance() < amount) {
|
|
920
|
+
throw new InsufficientFundsException("Insufficient funds");
|
|
921
|
+
}
|
|
922
|
+
account.setBalance(account.getBalance() - amount);
|
|
923
|
+
}
|
|
924
|
+
|
|
925
|
+
private void validatePositiveAmount(double amount, String operation) {
|
|
926
|
+
if (amount <= 0) {
|
|
927
|
+
throw new IllegalArgumentException(operation + " amount must be positive");
|
|
928
|
+
}
|
|
929
|
+
}
|
|
930
|
+
}
|
|
931
|
+
```
|
|
932
|
+
|
|
933
|
+
#### 使用 Mockito 進行 Mock
|
|
934
|
+
|
|
935
|
+
```java
|
|
936
|
+
import org.junit.jupiter.api.Test;
|
|
937
|
+
import org.junit.jupiter.api.extension.ExtendWith;
|
|
938
|
+
import org.mockito.InjectMocks;
|
|
939
|
+
import org.mockito.Mock;
|
|
940
|
+
import org.mockito.junit.jupiter.MockitoExtension;
|
|
941
|
+
import static org.mockito.Mockito.*;
|
|
942
|
+
import static org.assertj.core.api.Assertions.*;
|
|
943
|
+
|
|
487
944
|
@ExtendWith(MockitoExtension.class)
|
|
488
945
|
class OrderServiceTest {
|
|
489
946
|
|
|
490
947
|
@Mock
|
|
491
948
|
private PaymentGateway paymentGateway;
|
|
492
949
|
|
|
950
|
+
@Mock
|
|
951
|
+
private InventoryService inventoryService;
|
|
952
|
+
|
|
493
953
|
@InjectMocks
|
|
494
954
|
private OrderService orderService;
|
|
495
955
|
|
|
496
956
|
@Test
|
|
497
|
-
void
|
|
957
|
+
void placeOrder_withValidOrder_processesPaymentAndUpdatesInventory() {
|
|
498
958
|
// Arrange
|
|
499
959
|
Order order = new Order("PROD-1", 2, 50.0);
|
|
500
|
-
when(
|
|
501
|
-
|
|
960
|
+
when(inventoryService.checkStock("PROD-1")).thenReturn(10);
|
|
961
|
+
when(paymentGateway.charge(100.0)).thenReturn(new PaymentResult("TXN-123", true));
|
|
502
962
|
|
|
503
963
|
// Act
|
|
504
964
|
OrderResult result = orderService.placeOrder(order);
|
|
505
965
|
|
|
506
966
|
// Assert
|
|
507
967
|
assertThat(result.isSuccess()).isTrue();
|
|
968
|
+
assertThat(result.getTransactionId()).isEqualTo("TXN-123");
|
|
969
|
+
|
|
970
|
+
verify(inventoryService).checkStock("PROD-1");
|
|
971
|
+
verify(inventoryService).reserve("PROD-1", 2);
|
|
508
972
|
verify(paymentGateway).charge(100.0);
|
|
509
973
|
}
|
|
510
974
|
}
|
|
511
975
|
```
|
|
512
976
|
|
|
977
|
+
#### 使用 Cucumber-JVM 進行 BDD
|
|
978
|
+
|
|
979
|
+
```gherkin
|
|
980
|
+
# src/test/resources/features/account.feature
|
|
981
|
+
Feature: Account Management
|
|
982
|
+
As a bank customer
|
|
983
|
+
I want to manage my account balance
|
|
984
|
+
So that I can track my finances
|
|
985
|
+
|
|
986
|
+
Scenario: Deposit money
|
|
987
|
+
Given I have an account with balance $100
|
|
988
|
+
When I deposit $50
|
|
989
|
+
Then my balance should be $150
|
|
990
|
+
|
|
991
|
+
Scenario: Withdraw with insufficient funds
|
|
992
|
+
Given I have an account with balance $100
|
|
993
|
+
When I try to withdraw $150
|
|
994
|
+
Then I should see an error "Insufficient funds"
|
|
995
|
+
And my balance should be $100
|
|
996
|
+
```
|
|
997
|
+
|
|
998
|
+
```java
|
|
999
|
+
// StepDefinitions.java
|
|
1000
|
+
import io.cucumber.java.en.*;
|
|
1001
|
+
import static org.assertj.core.api.Assertions.*;
|
|
1002
|
+
|
|
1003
|
+
public class AccountStepDefinitions {
|
|
1004
|
+
private Account account;
|
|
1005
|
+
private AccountService service = new AccountService();
|
|
1006
|
+
private Exception caughtException;
|
|
1007
|
+
|
|
1008
|
+
@Given("I have an account with balance ${double}")
|
|
1009
|
+
public void iHaveAccountWithBalance(double balance) {
|
|
1010
|
+
account = new Account(balance);
|
|
1011
|
+
}
|
|
1012
|
+
|
|
1013
|
+
@When("I deposit ${double}")
|
|
1014
|
+
public void iDeposit(double amount) {
|
|
1015
|
+
service.deposit(account, amount);
|
|
1016
|
+
}
|
|
1017
|
+
|
|
1018
|
+
@When("I try to withdraw ${double}")
|
|
1019
|
+
public void iTryToWithdraw(double amount) {
|
|
1020
|
+
try {
|
|
1021
|
+
service.withdraw(account, amount);
|
|
1022
|
+
} catch (Exception e) {
|
|
1023
|
+
caughtException = e;
|
|
1024
|
+
}
|
|
1025
|
+
}
|
|
1026
|
+
|
|
1027
|
+
@Then("my balance should be ${double}")
|
|
1028
|
+
public void myBalanceShouldBe(double expected) {
|
|
1029
|
+
assertThat(account.getBalance()).isEqualTo(expected);
|
|
1030
|
+
}
|
|
1031
|
+
|
|
1032
|
+
@Then("I should see an error {string}")
|
|
1033
|
+
public void iShouldSeeAnError(String message) {
|
|
1034
|
+
assertThat(caughtException).hasMessage(message);
|
|
1035
|
+
}
|
|
1036
|
+
}
|
|
1037
|
+
```
|
|
1038
|
+
|
|
513
1039
|
---
|
|
514
1040
|
|
|
515
1041
|
## Ruby
|
|
@@ -526,6 +1052,11 @@ group :test do
|
|
|
526
1052
|
end
|
|
527
1053
|
```
|
|
528
1054
|
|
|
1055
|
+
```bash
|
|
1056
|
+
bundle install
|
|
1057
|
+
rspec --init
|
|
1058
|
+
```
|
|
1059
|
+
|
|
529
1060
|
#### 完整 TDD 範例:購物車
|
|
530
1061
|
|
|
531
1062
|
**步驟 1:紅色**
|
|
@@ -551,20 +1082,22 @@ end
|
|
|
551
1082
|
# lib/shopping_cart.rb
|
|
552
1083
|
class ShoppingCart
|
|
553
1084
|
def total
|
|
554
|
-
0 #
|
|
1085
|
+
0 # Fake it!
|
|
555
1086
|
end
|
|
556
1087
|
end
|
|
557
1088
|
```
|
|
558
1089
|
|
|
559
|
-
**步驟 3:紅色 -
|
|
1090
|
+
**步驟 3:紅色 - 新增品項**
|
|
560
1091
|
|
|
561
1092
|
```ruby
|
|
562
|
-
|
|
563
|
-
|
|
564
|
-
|
|
565
|
-
|
|
1093
|
+
describe '#total' do
|
|
1094
|
+
it 'returns sum of item prices' do
|
|
1095
|
+
cart = ShoppingCart.new
|
|
1096
|
+
cart.add_item(name: 'Widget', price: 10)
|
|
1097
|
+
cart.add_item(name: 'Gadget', price: 20)
|
|
566
1098
|
|
|
567
|
-
|
|
1099
|
+
expect(cart.total).to eq(30)
|
|
1100
|
+
end
|
|
568
1101
|
end
|
|
569
1102
|
```
|
|
570
1103
|
|
|
@@ -586,9 +1119,49 @@ class ShoppingCart
|
|
|
586
1119
|
end
|
|
587
1120
|
```
|
|
588
1121
|
|
|
589
|
-
|
|
1122
|
+
**步驟 5:紅色 - 折扣**
|
|
1123
|
+
|
|
1124
|
+
```ruby
|
|
1125
|
+
describe '#apply_discount' do
|
|
1126
|
+
it 'reduces total by percentage' do
|
|
1127
|
+
cart = ShoppingCart.new
|
|
1128
|
+
cart.add_item(name: 'Widget', price: 100)
|
|
1129
|
+
cart.apply_discount(20) # 20% off
|
|
1130
|
+
|
|
1131
|
+
expect(cart.total).to eq(80)
|
|
1132
|
+
end
|
|
1133
|
+
end
|
|
1134
|
+
```
|
|
1135
|
+
|
|
1136
|
+
**步驟 6:綠色**
|
|
590
1137
|
|
|
591
1138
|
```ruby
|
|
1139
|
+
class ShoppingCart
|
|
1140
|
+
def initialize
|
|
1141
|
+
@items = []
|
|
1142
|
+
@discount_percent = 0
|
|
1143
|
+
end
|
|
1144
|
+
|
|
1145
|
+
def add_item(item)
|
|
1146
|
+
@items << item
|
|
1147
|
+
end
|
|
1148
|
+
|
|
1149
|
+
def apply_discount(percent)
|
|
1150
|
+
@discount_percent = percent
|
|
1151
|
+
end
|
|
1152
|
+
|
|
1153
|
+
def total
|
|
1154
|
+
subtotal = @items.sum { |item| item[:price] }
|
|
1155
|
+
discount = subtotal * (@discount_percent / 100.0)
|
|
1156
|
+
subtotal - discount
|
|
1157
|
+
end
|
|
1158
|
+
end
|
|
1159
|
+
```
|
|
1160
|
+
|
|
1161
|
+
#### RSpec Mock
|
|
1162
|
+
|
|
1163
|
+
```ruby
|
|
1164
|
+
# spec/order_service_spec.rb
|
|
592
1165
|
RSpec.describe OrderService do
|
|
593
1166
|
describe '#process' do
|
|
594
1167
|
it 'charges payment and sends confirmation' do
|
|
@@ -606,17 +1179,90 @@ RSpec.describe OrderService do
|
|
|
606
1179
|
email_service: email_service
|
|
607
1180
|
)
|
|
608
1181
|
|
|
1182
|
+
order = Order.new(amount: 100, email: 'user@example.com')
|
|
1183
|
+
|
|
609
1184
|
# Act
|
|
610
|
-
result = service.process(
|
|
1185
|
+
result = service.process(order)
|
|
611
1186
|
|
|
612
1187
|
# Assert
|
|
613
1188
|
expect(result.success?).to be true
|
|
614
1189
|
expect(payment_gateway).to have_received(:charge).with(100)
|
|
1190
|
+
expect(email_service).to have_received(:send_confirmation)
|
|
1191
|
+
.with('user@example.com', hash_including(transaction_id: 'TXN123'))
|
|
615
1192
|
end
|
|
616
1193
|
end
|
|
617
1194
|
end
|
|
618
1195
|
```
|
|
619
1196
|
|
|
1197
|
+
#### 使用 RSpec 進行 BDD(原生)
|
|
1198
|
+
|
|
1199
|
+
RSpec 內建了 BDD 風格的語法:
|
|
1200
|
+
|
|
1201
|
+
```ruby
|
|
1202
|
+
# spec/features/shopping_cart_spec.rb
|
|
1203
|
+
RSpec.feature 'Shopping Cart', type: :feature do
|
|
1204
|
+
scenario 'User adds items to cart' do
|
|
1205
|
+
# Given
|
|
1206
|
+
cart = ShoppingCart.new
|
|
1207
|
+
|
|
1208
|
+
# When
|
|
1209
|
+
cart.add_item(name: 'Widget', price: 10)
|
|
1210
|
+
cart.add_item(name: 'Gadget', price: 20)
|
|
1211
|
+
|
|
1212
|
+
# Then
|
|
1213
|
+
expect(cart.total).to eq(30)
|
|
1214
|
+
expect(cart.item_count).to eq(2)
|
|
1215
|
+
end
|
|
1216
|
+
|
|
1217
|
+
scenario 'User applies discount code' do
|
|
1218
|
+
# Given
|
|
1219
|
+
cart = ShoppingCart.new
|
|
1220
|
+
cart.add_item(name: 'Widget', price: 100)
|
|
1221
|
+
|
|
1222
|
+
# When
|
|
1223
|
+
cart.apply_discount(20)
|
|
1224
|
+
|
|
1225
|
+
# Then
|
|
1226
|
+
expect(cart.total).to eq(80)
|
|
1227
|
+
end
|
|
1228
|
+
end
|
|
1229
|
+
```
|
|
1230
|
+
|
|
1231
|
+
#### 使用 Cucumber 進行 BDD
|
|
1232
|
+
|
|
1233
|
+
```gherkin
|
|
1234
|
+
# features/shopping_cart.feature
|
|
1235
|
+
Feature: Shopping Cart
|
|
1236
|
+
As a customer
|
|
1237
|
+
I want to manage my shopping cart
|
|
1238
|
+
So that I can purchase products
|
|
1239
|
+
|
|
1240
|
+
Scenario: Add item to cart
|
|
1241
|
+
Given I have an empty cart
|
|
1242
|
+
When I add a "Widget" priced at $10
|
|
1243
|
+
Then my cart total should be $10
|
|
1244
|
+
|
|
1245
|
+
Scenario: Apply discount
|
|
1246
|
+
Given I have a cart with total $100
|
|
1247
|
+
When I apply a 20% discount
|
|
1248
|
+
Then my cart total should be $80
|
|
1249
|
+
```
|
|
1250
|
+
|
|
1251
|
+
```ruby
|
|
1252
|
+
# features/step_definitions/cart_steps.rb
|
|
1253
|
+
Given('I have an empty cart') do
|
|
1254
|
+
@cart = ShoppingCart.new
|
|
1255
|
+
end
|
|
1256
|
+
|
|
1257
|
+
When('I add a {string} priced at ${int}') do |name, price|
|
|
1258
|
+
@cart.add_item(name: name, price: price)
|
|
1259
|
+
end
|
|
1260
|
+
|
|
1261
|
+
Then('my cart total should be ${int}') do |expected|
|
|
1262
|
+
expect(@cart.total).to eq(expected)
|
|
1263
|
+
end
|
|
1264
|
+
```
|
|
1265
|
+
|
|
620
1266
|
---
|
|
621
1267
|
|
|
622
1268
|
## 框架比較摘要
|
|
@@ -635,5 +1281,5 @@ end
|
|
|
635
1281
|
## 相關文件
|
|
636
1282
|
|
|
637
1283
|
- [SKILL.md](./SKILL.md) - TDD 助手概覽
|
|
638
|
-
- [TDD
|
|
639
|
-
- [TDD
|
|
1284
|
+
- [TDD Workflow](./tdd-workflow.md) - 詳細工作流程指南
|
|
1285
|
+
- [TDD Core Standard](../../core/test-driven-development.md) - 完整 TDD 標準
|