universal-dev-standards 6.14.0-beta.9 → 6.14.1-beta.1
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/mock-boundary.ai.yaml +138 -2
- package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
- package/bundled/ai/standards/turn-completion-integrity.ai.yaml +6 -2
- package/bundled/core/commit-message-guide.md +22 -19
- package/bundled/core/mock-boundary.md +70 -2
- package/bundled/core/secret-management-standards.md +13 -1
- package/bundled/core/turn-completion-integrity.md +8 -2
- package/bundled/extensions/locales/zh-tw.md +19 -19
- package/bundled/hooks/check-dangerous-cmd.mjs +161 -26
- package/bundled/hooks/check-logging-standard.mjs +35 -6
- package/bundled/hooks/validate-commit-msg.mjs +317 -28
- package/bundled/locales/zh-CN/CHANGELOG.md +2323 -1099
- 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 +4 -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/mock-boundary.md +74 -6
- 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/turn-completion-integrity.md +8 -6
- 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 +2323 -1128
- 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 +4 -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/mock-boundary.md +74 -6
- 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/turn-completion-integrity.md +8 -6
- 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 +72 -3
- 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.js +4 -2
- package/src/commands/update.js +227 -47
- 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 +106 -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: ../../../../options/testing/integration-testing.md
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
|
-
last_synced:
|
|
5
|
+
last_synced: 2026-10-11
|
|
6
|
+
source_hash: 4ac1711a8097
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
@@ -53,14 +54,16 @@ status: current
|
|
|
53
54
|
|
|
54
55
|
```
|
|
55
56
|
/\
|
|
56
|
-
/ \ E2E
|
|
57
|
+
/ \ E2E Tests (few)
|
|
57
58
|
/----\
|
|
58
|
-
/ ★★★ \
|
|
59
|
+
/ ★★★ \ Integration Tests (this level)
|
|
59
60
|
/--------\
|
|
60
|
-
/ \
|
|
61
|
+
/ \ Unit Tests (many)
|
|
61
62
|
/------------\
|
|
62
63
|
```
|
|
63
64
|
|
|
65
|
+
整合測試位於中間層:驗證元件之間的互動。
|
|
66
|
+
|
|
64
67
|
## 整合測試類型
|
|
65
68
|
|
|
66
69
|
### 1. 元件整合
|
|
@@ -68,7 +71,7 @@ status: current
|
|
|
68
71
|
測試內部元件間的互動:
|
|
69
72
|
|
|
70
73
|
```javascript
|
|
71
|
-
//
|
|
74
|
+
// Test: UserService + UserRepository + Database
|
|
72
75
|
describe('UserService Integration', () => {
|
|
73
76
|
let userService;
|
|
74
77
|
let database;
|
|
@@ -102,30 +105,62 @@ describe('UserService Integration', () => {
|
|
|
102
105
|
使用真實服務測試 REST/GraphQL 端點:
|
|
103
106
|
|
|
104
107
|
```python
|
|
105
|
-
# Python/pytest
|
|
108
|
+
# Python/pytest example
|
|
106
109
|
class TestUserAPI:
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
+
@pytest.fixture(autouse=True)
|
|
111
|
+
def setup(self, test_client, test_database):
|
|
112
|
+
self.client = test_client
|
|
113
|
+
self.db = test_database
|
|
114
|
+
|
|
115
|
+
def test_create_user_endpoint(self):
|
|
116
|
+
# Act
|
|
117
|
+
response = self.client.post('/api/users', json={
|
|
110
118
|
'name': 'John Doe',
|
|
111
119
|
'email': 'john@example.com'
|
|
112
120
|
})
|
|
113
121
|
|
|
114
|
-
#
|
|
122
|
+
# Assert
|
|
115
123
|
assert response.status_code == 201
|
|
116
124
|
assert response.json()['name'] == 'John Doe'
|
|
117
125
|
|
|
118
|
-
#
|
|
119
|
-
user =
|
|
126
|
+
# Verify database
|
|
127
|
+
user = self.db.query(User).filter_by(email='john@example.com').first()
|
|
120
128
|
assert user is not None
|
|
121
129
|
```
|
|
122
130
|
|
|
123
|
-
### 3.
|
|
131
|
+
### 3. 服務整合
|
|
132
|
+
|
|
133
|
+
測試微服務之間的通訊:
|
|
134
|
+
|
|
135
|
+
```javascript
|
|
136
|
+
describe('Order Service Integration', () => {
|
|
137
|
+
it('should process order with inventory check', async () => {
|
|
138
|
+
// Arrange
|
|
139
|
+
const inventoryService = new InventoryService(inventoryApi);
|
|
140
|
+
const paymentService = new PaymentService(paymentApi);
|
|
141
|
+
const orderService = new OrderService(inventoryService, paymentService);
|
|
142
|
+
|
|
143
|
+
// Act
|
|
144
|
+
const order = await orderService.processOrder({
|
|
145
|
+
productId: 'SKU-001',
|
|
146
|
+
quantity: 2,
|
|
147
|
+
paymentMethod: 'credit_card'
|
|
148
|
+
});
|
|
149
|
+
|
|
150
|
+
// Assert
|
|
151
|
+
expect(order.status).toBe('confirmed');
|
|
152
|
+
expect(order.inventoryReserved).toBe(true);
|
|
153
|
+
expect(order.paymentProcessed).toBe(true);
|
|
154
|
+
});
|
|
155
|
+
});
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
### 4. 資料庫整合
|
|
124
159
|
|
|
125
160
|
使用真實資料庫測試資料存取層:
|
|
126
161
|
|
|
127
162
|
```java
|
|
128
|
-
// Java/JUnit
|
|
163
|
+
// Java/JUnit example
|
|
129
164
|
@SpringBootTest
|
|
130
165
|
@Transactional
|
|
131
166
|
class UserRepositoryIntegrationTest {
|
|
@@ -135,19 +170,67 @@ class UserRepositoryIntegrationTest {
|
|
|
135
170
|
|
|
136
171
|
@Test
|
|
137
172
|
void shouldFindUsersByRole() {
|
|
138
|
-
//
|
|
173
|
+
// Arrange
|
|
139
174
|
userRepository.save(new User("admin", Role.ADMIN));
|
|
140
175
|
userRepository.save(new User("user1", Role.USER));
|
|
176
|
+
userRepository.save(new User("user2", Role.USER));
|
|
141
177
|
|
|
142
|
-
//
|
|
178
|
+
// Act
|
|
143
179
|
List<User> admins = userRepository.findByRole(Role.ADMIN);
|
|
144
180
|
|
|
145
|
-
//
|
|
181
|
+
// Assert
|
|
146
182
|
assertThat(admins).hasSize(1);
|
|
183
|
+
assertThat(admins.get(0).getUsername()).isEqualTo("admin");
|
|
147
184
|
}
|
|
148
185
|
}
|
|
149
186
|
```
|
|
150
187
|
|
|
188
|
+
## 測試環境設置
|
|
189
|
+
|
|
190
|
+
### 資料庫設置
|
|
191
|
+
|
|
192
|
+
```javascript
|
|
193
|
+
// Using test containers (JavaScript)
|
|
194
|
+
const { GenericContainer } = require('testcontainers');
|
|
195
|
+
|
|
196
|
+
let postgresContainer;
|
|
197
|
+
|
|
198
|
+
beforeAll(async () => {
|
|
199
|
+
postgresContainer = await new GenericContainer('postgres:14')
|
|
200
|
+
.withEnvironment({
|
|
201
|
+
POSTGRES_DB: 'testdb',
|
|
202
|
+
POSTGRES_USER: 'test',
|
|
203
|
+
POSTGRES_PASSWORD: 'test'
|
|
204
|
+
})
|
|
205
|
+
.withExposedPorts(5432)
|
|
206
|
+
.start();
|
|
207
|
+
|
|
208
|
+
process.env.DATABASE_URL = `postgresql://test:test@localhost:${postgresContainer.getMappedPort(5432)}/testdb`;
|
|
209
|
+
});
|
|
210
|
+
|
|
211
|
+
afterAll(async () => {
|
|
212
|
+
await postgresContainer.stop();
|
|
213
|
+
});
|
|
214
|
+
```
|
|
215
|
+
|
|
216
|
+
### 外部服務的 API 模擬
|
|
217
|
+
|
|
218
|
+
```javascript
|
|
219
|
+
// Mock external APIs while using real internal services
|
|
220
|
+
const nock = require('nock');
|
|
221
|
+
|
|
222
|
+
beforeEach(() => {
|
|
223
|
+
// Mock external payment API
|
|
224
|
+
nock('https://api.payment-provider.com')
|
|
225
|
+
.post('/v1/charges')
|
|
226
|
+
.reply(200, { id: 'ch_test', status: 'succeeded' });
|
|
227
|
+
});
|
|
228
|
+
|
|
229
|
+
afterEach(() => {
|
|
230
|
+
nock.cleanAll();
|
|
231
|
+
});
|
|
232
|
+
```
|
|
233
|
+
|
|
151
234
|
## 最佳實踐
|
|
152
235
|
|
|
153
236
|
### 1. 隔離測試資料
|
|
@@ -155,8 +238,10 @@ class UserRepositoryIntegrationTest {
|
|
|
155
238
|
```javascript
|
|
156
239
|
describe('Order Integration', () => {
|
|
157
240
|
beforeEach(async () => {
|
|
158
|
-
//
|
|
241
|
+
// Clean slate for each test
|
|
159
242
|
await database.truncate(['orders', 'order_items']);
|
|
243
|
+
|
|
244
|
+
// Seed required reference data
|
|
160
245
|
await seedProducts();
|
|
161
246
|
});
|
|
162
247
|
});
|
|
@@ -167,7 +252,7 @@ describe('Order Integration', () => {
|
|
|
167
252
|
```python
|
|
168
253
|
@pytest.fixture
|
|
169
254
|
def db_session():
|
|
170
|
-
"""
|
|
255
|
+
"""Provide a transactional scope for tests."""
|
|
171
256
|
connection = engine.connect()
|
|
172
257
|
transaction = connection.begin()
|
|
173
258
|
session = Session(bind=connection)
|
|
@@ -182,22 +267,40 @@ def db_session():
|
|
|
182
267
|
### 3. 測試真實情境
|
|
183
268
|
|
|
184
269
|
```javascript
|
|
270
|
+
// Good: Tests real workflow
|
|
185
271
|
it('should handle checkout with out-of-stock item', async () => {
|
|
186
|
-
//
|
|
272
|
+
// Setup: Product with limited stock
|
|
187
273
|
await inventory.setStock('SKU-001', 1);
|
|
188
274
|
|
|
189
|
-
//
|
|
275
|
+
// First order succeeds
|
|
190
276
|
const order1 = await checkout.process({ sku: 'SKU-001', qty: 1 });
|
|
191
277
|
expect(order1.status).toBe('confirmed');
|
|
192
278
|
|
|
193
|
-
//
|
|
279
|
+
// Second order fails due to stock
|
|
194
280
|
await expect(checkout.process({ sku: 'SKU-001', qty: 1 }))
|
|
195
281
|
.rejects.toThrow('Out of stock');
|
|
196
282
|
});
|
|
197
283
|
```
|
|
198
284
|
|
|
285
|
+
### 4. 處理非同步操作
|
|
286
|
+
|
|
287
|
+
```javascript
|
|
288
|
+
// Wait for eventual consistency
|
|
289
|
+
it('should update search index after product create', async () => {
|
|
290
|
+
const product = await productService.create({ name: 'Widget' });
|
|
291
|
+
|
|
292
|
+
// Wait for async index update
|
|
293
|
+
await waitFor(async () => {
|
|
294
|
+
const results = await searchService.search('Widget');
|
|
295
|
+
expect(results).toContainEqual(expect.objectContaining({ id: product.id }));
|
|
296
|
+
}, { timeout: 5000 });
|
|
297
|
+
});
|
|
298
|
+
```
|
|
299
|
+
|
|
199
300
|
## 應該測試什麼
|
|
200
301
|
|
|
302
|
+
### 應該測試
|
|
303
|
+
|
|
201
304
|
| 情境 | 原因 |
|
|
202
305
|
|------|------|
|
|
203
306
|
| 資料庫查詢 | 驗證 SQL/ORM 正確運作 |
|
|
@@ -206,6 +309,15 @@ it('should handle checkout with out-of-stock item', async () => {
|
|
|
206
309
|
| 交易邊界 | 確保資料一致性 |
|
|
207
310
|
| 錯誤傳播 | 測試跨層錯誤處理 |
|
|
208
311
|
|
|
312
|
+
### 不應該測試
|
|
313
|
+
|
|
314
|
+
| 情境 | 原因 |
|
|
315
|
+
|------|------|
|
|
316
|
+
| 框架內部 | 信任框架 |
|
|
317
|
+
| 正式環境中的第三方服務 | 使用模擬或沙箱 |
|
|
318
|
+
| UI 渲染 | 使用 E2E 測試 |
|
|
319
|
+
| 單元層級邏輯 | 使用單元測試 |
|
|
320
|
+
|
|
209
321
|
## 常見框架與工具
|
|
210
322
|
|
|
211
323
|
| 類別 | 工具 |
|
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
source: ../../../../options/testing/system-testing.md
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
|
-
last_synced:
|
|
5
|
+
last_synced: 2026-10-11
|
|
6
|
+
source_hash: accc907c60d0
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
@@ -36,6 +37,20 @@ status: current
|
|
|
36
37
|
- 安全性測試
|
|
37
38
|
- 發布前回歸測試
|
|
38
39
|
|
|
40
|
+
## 在測試金字塔中的位置
|
|
41
|
+
|
|
42
|
+
```
|
|
43
|
+
/\
|
|
44
|
+
/★★\ E2E/System Tests (this level)
|
|
45
|
+
/----\
|
|
46
|
+
/ \ Integration Tests
|
|
47
|
+
/--------\
|
|
48
|
+
/ \ Unit Tests
|
|
49
|
+
/------------\
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
系統測試位於頂端:涵蓋全面,但數量較少。
|
|
53
|
+
|
|
39
54
|
## 系統測試類型
|
|
40
55
|
|
|
41
56
|
### 1. 功能測試
|
|
@@ -53,6 +68,12 @@ Feature: 使用者註冊
|
|
|
53
68
|
Then 我應該收到確認郵件
|
|
54
69
|
And 我的帳戶應該在資料庫中建立
|
|
55
70
|
And 我應該被重導到歡迎頁面
|
|
71
|
+
|
|
72
|
+
Scenario: 使用已存在的電子郵件註冊失敗
|
|
73
|
+
Given 已存在電子郵件為 "user@example.com" 的使用者
|
|
74
|
+
When 我嘗試以電子郵件 "user@example.com" 註冊
|
|
75
|
+
Then 我應該看到錯誤訊息 "Email already registered"
|
|
76
|
+
And 不應建立任何新帳戶
|
|
56
77
|
```
|
|
57
78
|
|
|
58
79
|
### 2. 效能測試
|
|
@@ -61,6 +82,9 @@ Feature: 使用者註冊
|
|
|
61
82
|
|
|
62
83
|
```javascript
|
|
63
84
|
// k6 負載測試範例
|
|
85
|
+
import http from 'k6/http';
|
|
86
|
+
import { check, sleep } from 'k6';
|
|
87
|
+
|
|
64
88
|
export const options = {
|
|
65
89
|
stages: [
|
|
66
90
|
{ duration: '2m', target: 100 }, // 升溫
|
|
@@ -74,6 +98,17 @@ export const options = {
|
|
|
74
98
|
http_req_failed: ['rate<0.01'], // 錯誤率低於 1%
|
|
75
99
|
},
|
|
76
100
|
};
|
|
101
|
+
|
|
102
|
+
export default function () {
|
|
103
|
+
const res = http.get('https://api.example.com/products');
|
|
104
|
+
|
|
105
|
+
check(res, {
|
|
106
|
+
'status is 200': (r) => r.status === 200,
|
|
107
|
+
'response time OK': (r) => r.timings.duration < 500,
|
|
108
|
+
});
|
|
109
|
+
|
|
110
|
+
sleep(1);
|
|
111
|
+
}
|
|
77
112
|
```
|
|
78
113
|
|
|
79
114
|
### 3. 安全性測試
|
|
@@ -95,6 +130,20 @@ security_tests:
|
|
|
95
130
|
- 登入並取得 session token
|
|
96
131
|
- 驗證 token 在逾時後過期
|
|
97
132
|
- 驗證登出時 token 失效
|
|
133
|
+
|
|
134
|
+
authorization:
|
|
135
|
+
- test: "角色型存取控制"
|
|
136
|
+
steps:
|
|
137
|
+
- 以一般使用者登入
|
|
138
|
+
- 嘗試存取僅限管理員的端點
|
|
139
|
+
- 驗證回應為 403 Forbidden
|
|
140
|
+
|
|
141
|
+
data_protection:
|
|
142
|
+
- test: "敏感資料加密"
|
|
143
|
+
steps:
|
|
144
|
+
- 建立帶有密碼的使用者
|
|
145
|
+
- 驗證密碼在資料庫中已雜湊
|
|
146
|
+
- 驗證 PII 在靜態儲存時已加密
|
|
98
147
|
```
|
|
99
148
|
|
|
100
149
|
### 4. 可靠性測試
|
|
@@ -117,6 +166,55 @@ class ReliabilityTest:
|
|
|
117
166
|
response = app.client.get('/api/health')
|
|
118
167
|
assert response.status_code == 200
|
|
119
168
|
assert response.json()['database'] == 'degraded'
|
|
169
|
+
|
|
170
|
+
# 驗證故障轉移後的資料一致性
|
|
171
|
+
user = app.client.get('/api/users/1')
|
|
172
|
+
assert user.status_code == 200
|
|
173
|
+
|
|
174
|
+
def test_external_service_timeout(self):
|
|
175
|
+
"""系統應能處理外部服務逾時。"""
|
|
176
|
+
# 安排
|
|
177
|
+
app = TestApplication()
|
|
178
|
+
app.mock_external_service('payment', delay=30) # 延遲 30 秒
|
|
179
|
+
|
|
180
|
+
# 執行
|
|
181
|
+
response = app.client.post('/api/orders', json={
|
|
182
|
+
'items': [{'sku': 'ABC', 'qty': 1}]
|
|
183
|
+
}, timeout=10)
|
|
184
|
+
|
|
185
|
+
# 驗證:優雅處理逾時
|
|
186
|
+
assert response.status_code == 202 # 已接受,非同步處理中
|
|
187
|
+
assert 'retry' in response.json()
|
|
188
|
+
```
|
|
189
|
+
|
|
190
|
+
### 5. 相容性測試
|
|
191
|
+
|
|
192
|
+
在不同環境中進行測試:
|
|
193
|
+
|
|
194
|
+
```yaml
|
|
195
|
+
# 跨瀏覽器/裝置測試矩陣
|
|
196
|
+
compatibility_matrix:
|
|
197
|
+
browsers:
|
|
198
|
+
- Chrome (latest)
|
|
199
|
+
- Firefox (latest)
|
|
200
|
+
- Safari (latest)
|
|
201
|
+
- Edge (latest)
|
|
202
|
+
|
|
203
|
+
mobile:
|
|
204
|
+
- iOS Safari (iPhone 12+)
|
|
205
|
+
- Android Chrome (API 30+)
|
|
206
|
+
|
|
207
|
+
screen_sizes:
|
|
208
|
+
- 1920x1080 (Desktop)
|
|
209
|
+
- 1366x768 (Laptop)
|
|
210
|
+
- 768x1024 (Tablet)
|
|
211
|
+
- 375x667 (Mobile)
|
|
212
|
+
|
|
213
|
+
test_cases:
|
|
214
|
+
- 登入流程正確呈現
|
|
215
|
+
- 表單具備無障礙性
|
|
216
|
+
- 響應式版面正常運作
|
|
217
|
+
- 觸控互動功能正常
|
|
120
218
|
```
|
|
121
219
|
|
|
122
220
|
## 測試環境
|
|
@@ -131,6 +229,74 @@ class ReliabilityTest:
|
|
|
131
229
|
| 隔離 | 與開發/測試環境分離 |
|
|
132
230
|
| 監控 | 啟用完整可觀測性 |
|
|
133
231
|
|
|
232
|
+
### 環境建置
|
|
233
|
+
|
|
234
|
+
```yaml
|
|
235
|
+
# docker-compose.system-test.yml
|
|
236
|
+
version: '3.8'
|
|
237
|
+
|
|
238
|
+
services:
|
|
239
|
+
app:
|
|
240
|
+
image: myapp:${VERSION}
|
|
241
|
+
environment:
|
|
242
|
+
- DATABASE_URL=postgresql://db:5432/app
|
|
243
|
+
- REDIS_URL=redis://cache:6379
|
|
244
|
+
- ENV=system-test
|
|
245
|
+
depends_on:
|
|
246
|
+
- db
|
|
247
|
+
- cache
|
|
248
|
+
|
|
249
|
+
db:
|
|
250
|
+
image: postgres:14
|
|
251
|
+
volumes:
|
|
252
|
+
- ./test-data:/docker-entrypoint-initdb.d
|
|
253
|
+
|
|
254
|
+
cache:
|
|
255
|
+
image: redis:7
|
|
256
|
+
|
|
257
|
+
monitoring:
|
|
258
|
+
image: grafana/grafana
|
|
259
|
+
ports:
|
|
260
|
+
- "3000:3000"
|
|
261
|
+
```
|
|
262
|
+
|
|
263
|
+
## 測試資料管理
|
|
264
|
+
|
|
265
|
+
### 資料策略
|
|
266
|
+
|
|
267
|
+
| 策略 | 使用情境 |
|
|
268
|
+
|------|----------|
|
|
269
|
+
| 匿名化生產資料 | 貼近真實的情境 |
|
|
270
|
+
| 合成資料產生 | 規模測試 |
|
|
271
|
+
| 子集擷取 | 特定工作流程 |
|
|
272
|
+
| 按需建立 | 全新狀態的測試 |
|
|
273
|
+
|
|
274
|
+
### 資料建置範例
|
|
275
|
+
|
|
276
|
+
```python
|
|
277
|
+
class SystemTestDataFactory:
|
|
278
|
+
def create_complete_test_scenario(self):
|
|
279
|
+
"""建立完整的電子商務情境。"""
|
|
280
|
+
# 使用者
|
|
281
|
+
admin = self.create_user(role='admin')
|
|
282
|
+
customers = [self.create_user(role='customer') for _ in range(100)]
|
|
283
|
+
|
|
284
|
+
# 商品
|
|
285
|
+
categories = self.create_categories(count=10)
|
|
286
|
+
products = self.create_products(count=1000, categories=categories)
|
|
287
|
+
|
|
288
|
+
# 歷史資料
|
|
289
|
+
for customer in customers[:50]:
|
|
290
|
+
self.create_order_history(customer, products, count=5)
|
|
291
|
+
|
|
292
|
+
return {
|
|
293
|
+
'admin': admin,
|
|
294
|
+
'customers': customers,
|
|
295
|
+
'products': products,
|
|
296
|
+
'categories': categories
|
|
297
|
+
}
|
|
298
|
+
```
|
|
299
|
+
|
|
134
300
|
## 測試報告
|
|
135
301
|
|
|
136
302
|
### 報告結構
|
|
@@ -150,6 +316,14 @@ class ReliabilityTest:
|
|
|
150
316
|
| 功能 | 145 | 3 | 2 |
|
|
151
317
|
| 效能 | 12 | 0 | 0 |
|
|
152
318
|
| 安全 | 28 | 1 | 0 |
|
|
319
|
+
| 相容性 | 32 | 0 | 4 |
|
|
320
|
+
|
|
321
|
+
## 失敗的測試
|
|
322
|
+
### FUNC-042: 使用過期優惠券結帳
|
|
323
|
+
- **預期**: 顯示錯誤訊息
|
|
324
|
+
- **實際**: 系統錯誤 500
|
|
325
|
+
- **優先級**: 高
|
|
326
|
+
- **截圖**: [link]
|
|
153
327
|
|
|
154
328
|
## 效能指標
|
|
155
329
|
- 平均回應時間: 234ms
|
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
source: ../../../../options/testing/unit-testing.md
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
|
-
last_synced:
|
|
5
|
+
last_synced: 2026-10-11
|
|
6
|
+
source_hash: a6f360d666c8
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
@@ -40,14 +41,16 @@ status: current
|
|
|
40
41
|
|
|
41
42
|
```
|
|
42
43
|
/\
|
|
43
|
-
/ \ E2E
|
|
44
|
+
/ \ E2E Tests (few)
|
|
44
45
|
/----\
|
|
45
|
-
/ \
|
|
46
|
+
/ \ Integration Tests (some)
|
|
46
47
|
/--------\
|
|
47
|
-
/ \
|
|
48
|
+
/ \ Unit Tests (many)
|
|
48
49
|
/------------\
|
|
49
50
|
```
|
|
50
51
|
|
|
52
|
+
單元測試構成基礎層:快速、數量多且聚焦。
|
|
53
|
+
|
|
51
54
|
## 結構:Arrange-Act-Assert
|
|
52
55
|
|
|
53
56
|
```javascript
|
|
@@ -68,6 +71,21 @@ describe('calculateDiscount', () => {
|
|
|
68
71
|
});
|
|
69
72
|
```
|
|
70
73
|
|
|
74
|
+
```python
|
|
75
|
+
# Python 範例
|
|
76
|
+
def test_calculate_discount_applies_ten_percent_for_orders_over_100():
|
|
77
|
+
# Arrange(安排)
|
|
78
|
+
order_total = 150
|
|
79
|
+
discount_threshold = 100
|
|
80
|
+
discount_rate = 0.10
|
|
81
|
+
|
|
82
|
+
# Act(執行)
|
|
83
|
+
result = calculate_discount(order_total, discount_threshold, discount_rate)
|
|
84
|
+
|
|
85
|
+
# Assert(驗證)
|
|
86
|
+
assert result == 15
|
|
87
|
+
```
|
|
88
|
+
|
|
71
89
|
## 應該測試什麼
|
|
72
90
|
|
|
73
91
|
### 應該測試
|
|
@@ -88,6 +106,7 @@ describe('calculateDiscount', () => {
|
|
|
88
106
|
| 框架程式碼 | 已被框架測試 |
|
|
89
107
|
| 簡單 getter/setter | 無邏輯可驗證 |
|
|
90
108
|
| 外部系統 | 使用整合測試 |
|
|
109
|
+
| 設定 | 測試行為,而非設定 |
|
|
91
110
|
|
|
92
111
|
## 模擬指南
|
|
93
112
|
|
|
@@ -104,25 +123,52 @@ const userService = new UserService(mockDatabase);
|
|
|
104
123
|
|
|
105
124
|
### 何時不使用模擬
|
|
106
125
|
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
126
|
+
```javascript
|
|
127
|
+
// 不要模擬被測試的單元
|
|
128
|
+
// 不要模擬簡單的值物件
|
|
129
|
+
// 不要模擬所有東西——某些真實物件是可以的
|
|
130
|
+
```
|
|
131
|
+
|
|
132
|
+
### 模擬類型
|
|
133
|
+
|
|
134
|
+
| 類型 | 目的 | 範例 |
|
|
135
|
+
|------|------|------|
|
|
136
|
+
| Stub | 回傳固定值 | `mockFn.mockReturnValue(42)` |
|
|
137
|
+
| Mock | 驗證互動 | `expect(mockFn).toHaveBeenCalled()` |
|
|
138
|
+
| Spy | 觀察真實實作 | `jest.spyOn(obj, 'method')` |
|
|
139
|
+
| Fake | 簡化的實作 | 記憶體內資料庫 |
|
|
110
140
|
|
|
111
141
|
## 測試命名慣例
|
|
112
142
|
|
|
143
|
+
### 格式選項
|
|
144
|
+
|
|
113
145
|
```javascript
|
|
114
146
|
// 行為導向
|
|
115
147
|
it('should return null when user is not found')
|
|
116
|
-
// 當找不到使用者時應該回傳 null
|
|
117
148
|
|
|
118
149
|
// Given-When-Then
|
|
119
150
|
it('given an invalid email, when validating, then throws ValidationError')
|
|
120
|
-
// 給定無效的 email,當驗證時,拋出 ValidationError
|
|
121
151
|
|
|
122
152
|
// Method_Scenario_Expectation
|
|
123
153
|
it('validateEmail_withInvalidFormat_throwsError')
|
|
124
154
|
```
|
|
125
155
|
|
|
156
|
+
### 好的命名
|
|
157
|
+
|
|
158
|
+
```javascript
|
|
159
|
+
it('calculates tax correctly for multiple items')
|
|
160
|
+
it('throws error when dividing by zero')
|
|
161
|
+
it('returns empty array when no matches found')
|
|
162
|
+
```
|
|
163
|
+
|
|
164
|
+
### 不好的命名
|
|
165
|
+
|
|
166
|
+
```javascript
|
|
167
|
+
it('test1')
|
|
168
|
+
it('works')
|
|
169
|
+
it('should work correctly')
|
|
170
|
+
```
|
|
171
|
+
|
|
126
172
|
## 覆蓋率指南
|
|
127
173
|
|
|
128
174
|
| 指標 | 目標 | 備註 |
|
|
@@ -139,6 +185,74 @@ it('validateEmail_withInvalidFormat_throwsError')
|
|
|
139
185
|
- 關鍵程式碼值得 100% 覆蓋
|
|
140
186
|
- 不要只為了覆蓋率測試瑣碎程式碼
|
|
141
187
|
|
|
188
|
+
## 最佳實踐
|
|
189
|
+
|
|
190
|
+
### 1. 每個測試一個斷言(理想情況)
|
|
191
|
+
|
|
192
|
+
```javascript
|
|
193
|
+
// 好:聚焦的測試
|
|
194
|
+
it('should return user name', () => {
|
|
195
|
+
const user = new User('John');
|
|
196
|
+
expect(user.getName()).toBe('John');
|
|
197
|
+
});
|
|
198
|
+
|
|
199
|
+
// 可接受:相關的多個斷言
|
|
200
|
+
it('should create valid user', () => {
|
|
201
|
+
const user = new User('John', 'john@example.com');
|
|
202
|
+
expect(user.getName()).toBe('John');
|
|
203
|
+
expect(user.getEmail()).toBe('john@example.com');
|
|
204
|
+
});
|
|
205
|
+
```
|
|
206
|
+
|
|
207
|
+
### 2. 測試行為,而非實作
|
|
208
|
+
|
|
209
|
+
```javascript
|
|
210
|
+
// 好:測試行為
|
|
211
|
+
it('should mark order as paid', () => {
|
|
212
|
+
order.pay();
|
|
213
|
+
expect(order.isPaid()).toBe(true);
|
|
214
|
+
});
|
|
215
|
+
|
|
216
|
+
// 不好:測試實作細節
|
|
217
|
+
it('should set _paid flag to true', () => {
|
|
218
|
+
order.pay();
|
|
219
|
+
expect(order._paid).toBe(true);
|
|
220
|
+
});
|
|
221
|
+
```
|
|
222
|
+
|
|
223
|
+
### 3. 保持測試彼此獨立
|
|
224
|
+
|
|
225
|
+
```javascript
|
|
226
|
+
// 不好:測試依賴前一個測試
|
|
227
|
+
let user;
|
|
228
|
+
it('should create user', () => {
|
|
229
|
+
user = createUser();
|
|
230
|
+
});
|
|
231
|
+
it('should update user', () => {
|
|
232
|
+
user.update({ name: 'New' }); // 依賴前一個測試!
|
|
233
|
+
});
|
|
234
|
+
|
|
235
|
+
// 好:每個測試都是獨立的
|
|
236
|
+
it('should update user name', () => {
|
|
237
|
+
const user = createUser();
|
|
238
|
+
user.update({ name: 'New' });
|
|
239
|
+
expect(user.name).toBe('New');
|
|
240
|
+
});
|
|
241
|
+
```
|
|
242
|
+
|
|
243
|
+
### 4. 使用具描述性的測試資料
|
|
244
|
+
|
|
245
|
+
```javascript
|
|
246
|
+
// 不好
|
|
247
|
+
const user = { a: 'b', c: 'd' };
|
|
248
|
+
|
|
249
|
+
// 好
|
|
250
|
+
const validUser = {
|
|
251
|
+
name: 'John Doe',
|
|
252
|
+
email: 'john@example.com'
|
|
253
|
+
};
|
|
254
|
+
```
|
|
255
|
+
|
|
142
256
|
## 常見框架
|
|
143
257
|
|
|
144
258
|
| 語言 | 框架 | 備註 |
|