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
|
@@ -1,16 +1,20 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../core/forward-derivation-standards.md
|
|
3
|
-
source_version: 1.
|
|
4
|
-
translation_version: 1.
|
|
5
|
-
last_synced: 2026-
|
|
6
|
-
|
|
3
|
+
source_version: 1.3.0
|
|
4
|
+
translation_version: 1.3.0
|
|
5
|
+
last_synced: 2026-10-16
|
|
6
|
+
source_hash: aaa890a7c159
|
|
7
|
+
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
9
10
|
# 正向推演標準 | Forward Derivation Standards
|
|
10
11
|
|
|
11
|
-
**版本**: 1.
|
|
12
|
+
**版本**: 1.3.0
|
|
12
13
|
**最後更新**: 2026-03-18
|
|
13
14
|
**適用範圍**: 所有使用規格驅動開發的專案
|
|
15
|
+
**範疇**: uds-specific
|
|
16
|
+
**業界標準**: JSON Schema 2020-12
|
|
17
|
+
**參考資料**: [specmatic.io](https://specmatic.io/)
|
|
14
18
|
|
|
15
19
|
> **語言**: [English](../../../core/forward-derivation-standards.md) | 繁體中文
|
|
16
20
|
|
|
@@ -18,12 +22,12 @@ status: stale
|
|
|
18
22
|
|
|
19
23
|
## 目的
|
|
20
24
|
|
|
21
|
-
|
|
25
|
+
本標準定義正向推演的原則與工作流程——從已核准的 SDD 規格自動生成 BDD 場景、TDD 測試骨架與 ATDD 驗收測試。正向推演與[反向工程標準](reverse-engineering-standards.md)互補,形成對稱的推演系統。
|
|
22
26
|
|
|
23
27
|
**主要優點**:
|
|
24
28
|
- 一致的測試結構與規格對齊
|
|
25
29
|
- 從需求到測試的可追溯性(@SPEC-XXX、@AC-N 標籤)
|
|
26
|
-
-
|
|
30
|
+
- 從已核准的規格更快啟動 TDD
|
|
27
31
|
- 減少手動轉換錯誤
|
|
28
32
|
|
|
29
33
|
---
|
|
@@ -32,22 +36,23 @@ status: stale
|
|
|
32
36
|
|
|
33
37
|
```
|
|
34
38
|
┌──────────────────────────────────────────────────────────────────────────┐
|
|
35
|
-
│
|
|
39
|
+
│ Forward Derivation Workflow │
|
|
36
40
|
├──────────────────────────────────────────────────────────────────────────┤
|
|
37
41
|
│ │
|
|
38
42
|
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌───────────┐ │
|
|
39
|
-
│ │
|
|
40
|
-
│ │
|
|
43
|
+
│ │ Parse SPEC │───▶│Extract AC │───▶│Generate BDD │───▶│Generate │ │
|
|
44
|
+
│ │ 解析規格 │ │提取驗收條件 │ │生成 BDD │ │TDD/ATDD │ │
|
|
41
45
|
│ └─────────────┘ └─────────────┘ └─────────────┘ └───────────┘ │
|
|
42
46
|
│ │ │ │ │ │
|
|
43
47
|
│ │ │ │ ▼ │
|
|
44
48
|
│ │ │ │ ┌───────────────┐ │
|
|
45
|
-
│ │ │ │ │
|
|
49
|
+
│ │ │ │ │ Human Review │ │
|
|
50
|
+
│ │ │ │ │ 人類審查 │ │
|
|
46
51
|
│ │ │ │ └───────────────┘ │
|
|
47
52
|
│ │ │ │ │ │
|
|
48
53
|
│ ▼ ▼ ▼ ▼ │
|
|
49
|
-
│ [
|
|
50
|
-
│ SPEC-XXX.md
|
|
54
|
+
│ [Source] [Parsed] [Generated] [Reviewed] │
|
|
55
|
+
│ SPEC-XXX.md AC List .feature/.test Ready to use │
|
|
51
56
|
│ │
|
|
52
57
|
└──────────────────────────────────────────────────────────────────────────┘
|
|
53
58
|
```
|
|
@@ -56,12 +61,13 @@ status: stale
|
|
|
56
61
|
|
|
57
62
|
| 階段 | 描述 | 輸出 | 確定性等級 |
|
|
58
63
|
|------|------|------|-----------|
|
|
59
|
-
|
|
|
60
|
-
|
|
|
61
|
-
|
|
|
62
|
-
|
|
|
63
|
-
|
|
|
64
|
-
|
|
|
64
|
+
| **Parse SPEC** | 讀取已核准的規格文件 | SPEC 元資料、章節 | [Source] |
|
|
65
|
+
| **Extract AC** | 解析驗收條件(GWT 或條列) | 結構化 AC 列表 | [Derived] |
|
|
66
|
+
| **Generate BDD** | 將 AC 轉換為 Gherkin 場景 | .feature 檔案 | [Generated] |
|
|
67
|
+
| **Generate TDD** | 從 AC 建立測試骨架 | 包含 TODO 的測試檔案 | [Generated] |
|
|
68
|
+
| **Generate ATDD** | 建立驗收測試表格 | Markdown 測試表格 | [Generated] |
|
|
69
|
+
| **Generate Contracts** | 提取前置/後置條件 | contract.json、schema.json | [Generated] |
|
|
70
|
+
| **Human Review** | 驗證生成的輸出 | 已核准的測試結構 | [Reviewed] |
|
|
65
71
|
|
|
66
72
|
---
|
|
67
73
|
|
|
@@ -69,61 +75,63 @@ status: stale
|
|
|
69
75
|
|
|
70
76
|
### 1. 規格限定生成
|
|
71
77
|
|
|
72
|
-
|
|
78
|
+
**規則**:僅推演已核准規格中存在的內容。絕不添加超出 AC 明確定義範圍的功能、場景或測試。
|
|
73
79
|
|
|
74
|
-
|
|
80
|
+
**正向推演原則**:只推演規格中明確存在的內容。不添加 AC 未明確定義的功能、場景或測試。
|
|
81
|
+
|
|
82
|
+
**正確**:
|
|
75
83
|
```markdown
|
|
76
84
|
# SPEC AC
|
|
77
|
-
- [ ]
|
|
85
|
+
- [ ] User can login with email and password
|
|
78
86
|
|
|
79
|
-
#
|
|
80
|
-
Scenario:
|
|
87
|
+
# Generated BDD (correct)
|
|
88
|
+
Scenario: User login with email and password
|
|
81
89
|
```
|
|
82
90
|
|
|
83
|
-
|
|
91
|
+
**錯誤**:
|
|
84
92
|
```markdown
|
|
85
|
-
#
|
|
86
|
-
Scenario:
|
|
87
|
-
Scenario:
|
|
88
|
-
Scenario:
|
|
93
|
+
# Generated BDD (wrong - adding beyond spec)
|
|
94
|
+
Scenario: User login with email and password
|
|
95
|
+
Scenario: User login with social auth # <-- NOT in AC
|
|
96
|
+
Scenario: User password recovery # <-- NOT in AC
|
|
89
97
|
```
|
|
90
98
|
|
|
91
99
|
### 2. 反幻覺合規
|
|
92
100
|
|
|
93
|
-
|
|
101
|
+
**規則**:本標準嚴格遵循[反幻覺標準](anti-hallucination.md):
|
|
94
102
|
|
|
95
|
-
- **1:1 對應**:每個 AC
|
|
96
|
-
-
|
|
97
|
-
-
|
|
103
|
+
- **1:1 對應**:每個 AC 恰好產生一個場景/測試群組
|
|
104
|
+
- **禁止捏造**:絕不捏造驗收條件或測試案例
|
|
105
|
+
- **來源標註**:所有生成項目皆參照來源 SPEC 與 AC 編號
|
|
98
106
|
|
|
99
107
|
**反幻覺檢查**:
|
|
100
108
|
```
|
|
101
|
-
|
|
102
|
-
|
|
109
|
+
Input: SPEC with N acceptance criteria
|
|
110
|
+
Output: Exactly N scenarios (BDD), N test groups (TDD), N acceptance tables (ATDD)
|
|
103
111
|
|
|
104
|
-
|
|
112
|
+
If output count ≠ input count → VIOLATION
|
|
105
113
|
```
|
|
106
114
|
|
|
107
115
|
### 3. 來源標註
|
|
108
116
|
|
|
109
|
-
|
|
117
|
+
**規則**:每個生成的項目都必須包含可追溯性:
|
|
110
118
|
|
|
111
119
|
```gherkin
|
|
112
|
-
# BDD
|
|
120
|
+
# BDD Example
|
|
113
121
|
# Generated from: specs/SPEC-001.md
|
|
114
122
|
# AC: AC-1
|
|
115
123
|
|
|
116
124
|
@SPEC-001 @AC-1
|
|
117
|
-
Scenario:
|
|
125
|
+
Scenario: User login with valid credentials
|
|
118
126
|
```
|
|
119
127
|
|
|
120
128
|
```typescript
|
|
121
|
-
// TDD
|
|
129
|
+
// TDD Example
|
|
122
130
|
/**
|
|
123
131
|
* Generated from: specs/SPEC-001.md
|
|
124
132
|
* AC: AC-1
|
|
125
133
|
*/
|
|
126
|
-
describe('AC-1:
|
|
134
|
+
describe('AC-1: User login with valid credentials', () => {
|
|
127
135
|
```
|
|
128
136
|
|
|
129
137
|
### 4. 確定性標籤
|
|
@@ -132,11 +140,43 @@ describe('AC-1: 使用者以有效憑證登入', () => {
|
|
|
132
140
|
|
|
133
141
|
| 標籤 | 定義 | 範例 |
|
|
134
142
|
|------|------|------|
|
|
135
|
-
| `[
|
|
136
|
-
| `[
|
|
137
|
-
| `[
|
|
143
|
+
| `[Source]` | 直接來自 SPEC 的內容 | 功能標題、AC 文字 |
|
|
144
|
+
| `[Derived]` | 從 SPEC 內容轉換 | 從條列 AC 轉換的 GWT |
|
|
145
|
+
| `[Generated]` | AI 生成的結構 | 測試骨架、TODO 註解 |
|
|
138
146
|
| `[TODO]` | 需要人類實作 | 測試斷言、步驟定義 |
|
|
139
147
|
|
|
148
|
+
### 5. 測試層級組態感知
|
|
149
|
+
|
|
150
|
+
**規則**:在推演測試之前,`/derive` 應檢查專案的 `test_levels` 組態,以決定要生成哪些測試層級。這可確保推演遵循團隊的測試策略。
|
|
151
|
+
|
|
152
|
+
**組態來源**(依序檢查):
|
|
153
|
+
1. `.standards/.uds.manifest.json` → `options.test_levels`
|
|
154
|
+
2. `uds-manifest.json` → `stats` 或根層級的 `test_levels`
|
|
155
|
+
3. 若未找到任何組態 → 預設為所有層級(`unit-testing`、`integration-testing`、`system-testing`、`e2e-testing`)
|
|
156
|
+
|
|
157
|
+
**行為**:
|
|
158
|
+
|
|
159
|
+
| 設定的 test_levels | `/derive all` 產出 |
|
|
160
|
+
|-------------------|-------------------|
|
|
161
|
+
| `['unit-testing']` | 僅 BDD + TDD |
|
|
162
|
+
| `['unit-testing', 'integration-testing']` | BDD + TDD + IT |
|
|
163
|
+
| `['unit-testing', 'integration-testing', 'e2e-testing']` | BDD + TDD + IT + E2E |
|
|
164
|
+
| `['unit-testing', 'integration-testing', 'system-testing', 'e2e-testing']`(預設) | BDD + TDD + IT + E2E(全部) |
|
|
165
|
+
| 無 manifest / 無 test_levels | 所有層級(同預設) |
|
|
166
|
+
|
|
167
|
+
**對應**:
|
|
168
|
+
|
|
169
|
+
| test_levels 值 | 推演輸出 |
|
|
170
|
+
|----------------|---------|
|
|
171
|
+
| `unit-testing` | `/derive-tdd`(一律包含) |
|
|
172
|
+
| `integration-testing` | `/derive-it` |
|
|
173
|
+
| `system-testing` | `/derive-it`(系統 = 涵蓋範圍更廣的整合) |
|
|
174
|
+
| `e2e-testing` | `/derive-e2e` |
|
|
175
|
+
|
|
176
|
+
**附註**:無論 `test_levels` 為何,BDD(.feature)、ATDD(acceptance.md)與契約(contract.json)都會生成,因為它們屬於規格產物,而非特定測試層級專用。
|
|
177
|
+
|
|
178
|
+
**AI Agent 指令**:執行 `/derive all` 時,請先檢查 `test_levels` 組態。如果 `e2e-testing` 不在設定的層級中,請略過 E2E 骨架生成並通知使用者:「略過 E2E 推演——未包含在專案 test_levels 組態中。請執行 `uds config --type test_levels` 以加入。」
|
|
179
|
+
|
|
140
180
|
---
|
|
141
181
|
|
|
142
182
|
## 輸入格式要求
|
|
@@ -146,124 +186,256 @@ describe('AC-1: 使用者以有效憑證登入', () => {
|
|
|
146
186
|
#### 格式 1:Given-When-Then(推薦)
|
|
147
187
|
|
|
148
188
|
```markdown
|
|
149
|
-
### AC-1:
|
|
150
|
-
**Given**
|
|
151
|
-
**When**
|
|
152
|
-
**Then**
|
|
153
|
-
**And**
|
|
189
|
+
### AC-1: User Login
|
|
190
|
+
**Given** a registered user with valid credentials
|
|
191
|
+
**When** the user submits login form with email and password
|
|
192
|
+
**Then** the user is redirected to dashboard
|
|
193
|
+
**And** a session token is created
|
|
154
194
|
```
|
|
155
195
|
|
|
156
196
|
#### 格式 2:條列式
|
|
157
197
|
|
|
158
198
|
```markdown
|
|
159
|
-
### AC-1:
|
|
160
|
-
-
|
|
161
|
-
-
|
|
162
|
-
-
|
|
199
|
+
### AC-1: User Login
|
|
200
|
+
- User can login with email and password
|
|
201
|
+
- Login redirects to dashboard on success
|
|
202
|
+
- Login shows error for invalid credentials
|
|
163
203
|
```
|
|
164
204
|
|
|
165
205
|
#### 格式 3:勾選清單
|
|
166
206
|
|
|
167
207
|
```markdown
|
|
168
|
-
##
|
|
169
|
-
- [ ]
|
|
170
|
-
- [ ]
|
|
171
|
-
- [ ]
|
|
208
|
+
## Acceptance Criteria
|
|
209
|
+
- [ ] User can login with email and password
|
|
210
|
+
- [ ] Session is created on successful login
|
|
211
|
+
- [ ] Error message shown for invalid credentials
|
|
172
212
|
```
|
|
173
213
|
|
|
174
214
|
---
|
|
175
215
|
|
|
176
216
|
## 輸出格式
|
|
177
217
|
|
|
178
|
-
### BDD
|
|
218
|
+
### BDD 輸出 (.feature)
|
|
179
219
|
|
|
180
220
|
```gherkin
|
|
181
221
|
# Generated from: specs/SPEC-001.md
|
|
182
222
|
# Generator: forward-derivation v1.0.0
|
|
183
223
|
# Generated at: 2026-01-19T10:00:00Z
|
|
184
224
|
|
|
185
|
-
Feature:
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
225
|
+
Feature: User Authentication
|
|
226
|
+
As a user
|
|
227
|
+
I want to login to the system
|
|
228
|
+
So that I can access my dashboard
|
|
189
229
|
|
|
190
230
|
@SPEC-001 @AC-1 @happy-path
|
|
191
|
-
Scenario:
|
|
192
|
-
# [
|
|
193
|
-
Given
|
|
194
|
-
When
|
|
195
|
-
Then
|
|
231
|
+
Scenario: User login with valid credentials
|
|
232
|
+
# [Source] From SPEC-001 AC-1
|
|
233
|
+
Given a registered user with valid credentials
|
|
234
|
+
When the user submits login form with email and password
|
|
235
|
+
Then the user is redirected to dashboard
|
|
236
|
+
And a session token is created
|
|
196
237
|
|
|
197
238
|
@SPEC-001 @AC-2 @error-handling
|
|
198
|
-
Scenario:
|
|
199
|
-
# [
|
|
200
|
-
Given
|
|
201
|
-
When
|
|
202
|
-
Then
|
|
239
|
+
Scenario: Login fails with invalid credentials
|
|
240
|
+
# [Source] From SPEC-001 AC-2
|
|
241
|
+
Given a user with invalid credentials
|
|
242
|
+
When the user submits login form
|
|
243
|
+
Then an error message is displayed
|
|
244
|
+
And no session is created
|
|
203
245
|
```
|
|
204
246
|
|
|
205
|
-
### TDD
|
|
247
|
+
### TDD 輸出 (.test.ts)
|
|
206
248
|
|
|
207
249
|
```typescript
|
|
208
250
|
/**
|
|
209
|
-
* Tests for SPEC-001:
|
|
251
|
+
* Tests for SPEC-001: User Authentication
|
|
210
252
|
* Generated from: specs/SPEC-001.md
|
|
211
253
|
* Generated at: 2026-01-19T10:00:00Z
|
|
212
254
|
* AC Coverage: AC-1, AC-2
|
|
213
255
|
*
|
|
214
|
-
* [
|
|
215
|
-
* [TODO]
|
|
256
|
+
* [Generated] This file contains test skeletons.
|
|
257
|
+
* [TODO] Implement test logic and assertions.
|
|
216
258
|
*/
|
|
217
259
|
|
|
218
|
-
describe('SPEC-001:
|
|
260
|
+
describe('SPEC-001: User Authentication', () => {
|
|
219
261
|
/**
|
|
220
|
-
* AC-1:
|
|
221
|
-
* [
|
|
262
|
+
* AC-1: User login with valid credentials
|
|
263
|
+
* [Source] specs/SPEC-001.md#AC-1
|
|
222
264
|
*/
|
|
223
|
-
describe('AC-1:
|
|
265
|
+
describe('AC-1: User login with valid credentials', () => {
|
|
224
266
|
it('should redirect to dashboard on successful login', async () => {
|
|
225
267
|
// Arrange
|
|
226
|
-
// [TODO]
|
|
268
|
+
// [TODO] Set up registered user with valid credentials
|
|
227
269
|
|
|
228
270
|
// Act
|
|
229
|
-
// [TODO]
|
|
271
|
+
// [TODO] Submit login form with email and password
|
|
230
272
|
|
|
231
273
|
// Assert
|
|
232
|
-
// [TODO]
|
|
233
|
-
|
|
274
|
+
// [TODO] Verify redirect to dashboard
|
|
275
|
+
// [TODO] Verify session token is created
|
|
276
|
+
expect(true).toBe(true); // Placeholder - replace with actual assertion
|
|
277
|
+
});
|
|
278
|
+
});
|
|
279
|
+
|
|
280
|
+
/**
|
|
281
|
+
* AC-2: Login fails with invalid credentials
|
|
282
|
+
* [Source] specs/SPEC-001.md#AC-2
|
|
283
|
+
*/
|
|
284
|
+
describe('AC-2: Login fails with invalid credentials', () => {
|
|
285
|
+
it('should display error message for invalid credentials', async () => {
|
|
286
|
+
// Arrange
|
|
287
|
+
// [TODO] Set up user with invalid credentials
|
|
288
|
+
|
|
289
|
+
// Act
|
|
290
|
+
// [TODO] Submit login form
|
|
291
|
+
|
|
292
|
+
// Assert
|
|
293
|
+
// [TODO] Verify error message is displayed
|
|
294
|
+
// [TODO] Verify no session is created
|
|
295
|
+
expect(true).toBe(true); // Placeholder - replace with actual assertion
|
|
234
296
|
});
|
|
235
297
|
});
|
|
236
298
|
});
|
|
237
299
|
```
|
|
238
300
|
|
|
239
|
-
### ATDD
|
|
301
|
+
### ATDD 輸出 (acceptance.md)
|
|
240
302
|
|
|
241
303
|
```markdown
|
|
242
|
-
# SPEC-001
|
|
304
|
+
# SPEC-001 Acceptance Tests
|
|
305
|
+
|
|
306
|
+
**Specification**: [SPEC-001](../specs/SPEC-001.md)
|
|
307
|
+
**Generated**: 2026-01-19
|
|
308
|
+
**Status**: Pending Review
|
|
309
|
+
|
|
310
|
+
---
|
|
311
|
+
|
|
312
|
+
## AT-001: User login with valid credentials
|
|
313
|
+
|
|
314
|
+
**Source**: AC-1 from SPEC-001
|
|
315
|
+
|
|
316
|
+
| Step | Action | Expected Result | Pass/Fail |
|
|
317
|
+
|------|--------|-----------------|-----------|
|
|
318
|
+
| 1 | Navigate to login page | Login form is displayed | [ ] |
|
|
319
|
+
| 2 | Enter valid email | Email field accepts input | [ ] |
|
|
320
|
+
| 3 | Enter valid password | Password field accepts input (masked) | [ ] |
|
|
321
|
+
| 4 | Click "Login" button | Form is submitted | [ ] |
|
|
322
|
+
| 5 | Verify redirect | User is on dashboard page | [ ] |
|
|
323
|
+
| 6 | Verify session | Session token exists in storage | [ ] |
|
|
243
324
|
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
325
|
+
**Prerequisites**: User account exists in system
|
|
326
|
+
|
|
327
|
+
**Tester**: _______________
|
|
328
|
+
**Date**: _______________
|
|
329
|
+
**Result**: [ ] Pass / [ ] Fail
|
|
330
|
+
**Notes**: _______________
|
|
247
331
|
|
|
248
332
|
---
|
|
249
333
|
|
|
250
|
-
## AT-
|
|
334
|
+
## AT-002: Login fails with invalid credentials
|
|
335
|
+
|
|
336
|
+
**Source**: AC-2 from SPEC-001
|
|
251
337
|
|
|
252
|
-
|
|
338
|
+
| Step | Action | Expected Result | Pass/Fail |
|
|
339
|
+
|------|--------|-----------------|-----------|
|
|
340
|
+
| 1 | Navigate to login page | Login form is displayed | [ ] |
|
|
341
|
+
| 2 | Enter invalid email | Email field accepts input | [ ] |
|
|
342
|
+
| 3 | Enter invalid password | Password field accepts input | [ ] |
|
|
343
|
+
| 4 | Click "Login" button | Form is submitted | [ ] |
|
|
344
|
+
| 5 | Verify error | Error message is displayed | [ ] |
|
|
345
|
+
| 6 | Verify no session | No session token in storage | [ ] |
|
|
253
346
|
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
| 4 | 點擊「登入」按鈕 | 表單已提交 | [ ] |
|
|
260
|
-
| 5 | 驗證導向 | 使用者在儀表板頁面 | [ ] |
|
|
347
|
+
**Tester**: _______________
|
|
348
|
+
**Date**: _______________
|
|
349
|
+
**Result**: [ ] Pass / [ ] Fail
|
|
350
|
+
**Notes**: _______________
|
|
351
|
+
```
|
|
261
352
|
|
|
262
|
-
|
|
353
|
+
### 契約輸出 (contract.json)
|
|
354
|
+
|
|
355
|
+
```json
|
|
356
|
+
{
|
|
357
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
358
|
+
"metadata": {
|
|
359
|
+
"generatedFrom": "specs/SPEC-001.md",
|
|
360
|
+
"generatedAt": "2026-01-25T10:00:00Z",
|
|
361
|
+
"generator": "forward-derivation v1.1.0",
|
|
362
|
+
"acCoverage": ["AC-1", "AC-2"]
|
|
363
|
+
},
|
|
364
|
+
"contracts": [
|
|
365
|
+
{
|
|
366
|
+
"id": "AC-1",
|
|
367
|
+
"name": "User login with valid credentials",
|
|
368
|
+
"preconditions": [
|
|
369
|
+
{ "type": "state", "description": "User is registered in system" },
|
|
370
|
+
{ "type": "input", "description": "Valid email and password provided" }
|
|
371
|
+
],
|
|
372
|
+
"postconditions": [
|
|
373
|
+
{ "type": "state", "description": "User session created" },
|
|
374
|
+
{ "type": "output", "description": "Redirect to dashboard" }
|
|
375
|
+
],
|
|
376
|
+
"invariants": [
|
|
377
|
+
{ "description": "Session token is cryptographically secure" }
|
|
378
|
+
]
|
|
379
|
+
},
|
|
380
|
+
{
|
|
381
|
+
"id": "AC-2",
|
|
382
|
+
"name": "Login fails with invalid credentials",
|
|
383
|
+
"preconditions": [
|
|
384
|
+
{ "type": "input", "description": "Invalid credentials provided" }
|
|
385
|
+
],
|
|
386
|
+
"postconditions": [
|
|
387
|
+
{ "type": "state", "description": "No session created" },
|
|
388
|
+
{ "type": "output", "description": "Error message displayed" }
|
|
389
|
+
]
|
|
390
|
+
}
|
|
391
|
+
]
|
|
392
|
+
}
|
|
393
|
+
```
|
|
263
394
|
|
|
264
|
-
|
|
265
|
-
|
|
266
|
-
|
|
395
|
+
### Schema 輸出 (schema.json)
|
|
396
|
+
|
|
397
|
+
```json
|
|
398
|
+
{
|
|
399
|
+
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
400
|
+
"metadata": {
|
|
401
|
+
"generatedFrom": "specs/SPEC-001.md",
|
|
402
|
+
"generatedAt": "2026-01-25T10:00:00Z",
|
|
403
|
+
"generator": "forward-derivation v1.1.0"
|
|
404
|
+
},
|
|
405
|
+
"schemas": {
|
|
406
|
+
"LoginRequest": {
|
|
407
|
+
"type": "object",
|
|
408
|
+
"required": ["email", "password"],
|
|
409
|
+
"properties": {
|
|
410
|
+
"email": {
|
|
411
|
+
"type": "string",
|
|
412
|
+
"format": "email",
|
|
413
|
+
"description": "[Source] SPEC-001 AC-1: Valid email required"
|
|
414
|
+
},
|
|
415
|
+
"password": {
|
|
416
|
+
"type": "string",
|
|
417
|
+
"minLength": 8,
|
|
418
|
+
"description": "[Source] SPEC-001 AC-1: Password required"
|
|
419
|
+
}
|
|
420
|
+
}
|
|
421
|
+
},
|
|
422
|
+
"LoginResponse": {
|
|
423
|
+
"type": "object",
|
|
424
|
+
"required": ["success"],
|
|
425
|
+
"properties": {
|
|
426
|
+
"success": { "type": "boolean" },
|
|
427
|
+
"sessionToken": {
|
|
428
|
+
"type": "string",
|
|
429
|
+
"description": "[Source] SPEC-001 AC-1: Session token on success"
|
|
430
|
+
},
|
|
431
|
+
"errorMessage": {
|
|
432
|
+
"type": "string",
|
|
433
|
+
"description": "[Source] SPEC-001 AC-2: Error message on failure"
|
|
434
|
+
}
|
|
435
|
+
}
|
|
436
|
+
}
|
|
437
|
+
}
|
|
438
|
+
}
|
|
267
439
|
```
|
|
268
440
|
|
|
269
441
|
---
|
|
@@ -281,6 +453,25 @@ describe('SPEC-001: 使用者認證', () => {
|
|
|
281
453
|
| 系統回應 | Then | 「顯示訊息」→ Then 顯示訊息 |
|
|
282
454
|
| 「可以/應該/必須」 | When + Then | 「使用者可以刪除項目」→ When 使用者刪除項目 Then 項目已移除 |
|
|
283
455
|
|
|
456
|
+
### 轉換範例
|
|
457
|
+
|
|
458
|
+
**輸入(條列式)**:
|
|
459
|
+
```markdown
|
|
460
|
+
- [ ] User can add item to cart
|
|
461
|
+
- [ ] Cart displays item count
|
|
462
|
+
- [ ] Cart total updates automatically
|
|
463
|
+
```
|
|
464
|
+
|
|
465
|
+
**輸出(GWT)**:
|
|
466
|
+
```gherkin
|
|
467
|
+
Scenario: Add item to cart
|
|
468
|
+
Given user is on product page
|
|
469
|
+
When user clicks "Add to Cart" button
|
|
470
|
+
Then item is added to cart
|
|
471
|
+
And cart displays updated item count
|
|
472
|
+
And cart total updates automatically
|
|
473
|
+
```
|
|
474
|
+
|
|
284
475
|
---
|
|
285
476
|
|
|
286
477
|
## 與開發方法論的整合
|
|
@@ -289,14 +480,14 @@ describe('SPEC-001: 使用者認證', () => {
|
|
|
289
480
|
|
|
290
481
|
```
|
|
291
482
|
┌───────────────────────────────────────────────────────────────────────┐
|
|
292
|
-
│
|
|
483
|
+
│ Symmetrical Derivation System │
|
|
293
484
|
├───────────────────────────────────────────────────────────────────────┤
|
|
294
485
|
│ │
|
|
295
|
-
│
|
|
296
|
-
│ (
|
|
486
|
+
│ REVERSE ENGINEERING FORWARD DERIVATION │
|
|
487
|
+
│ (Code → Spec) (Spec → Tests) │
|
|
297
488
|
│ │
|
|
298
489
|
│ ┌───────────────┐ ┌───────────────┐ │
|
|
299
|
-
│ │
|
|
490
|
+
│ │ Existing Code │ │ Approved SPEC │ │
|
|
300
491
|
│ └───────┬───────┘ └───────┬───────┘ │
|
|
301
492
|
│ │ │ │
|
|
302
493
|
│ ▼ ▼ │
|
|
@@ -308,10 +499,10 @@ describe('SPEC-001: 使用者認證', () => {
|
|
|
308
499
|
│ │ │ │
|
|
309
500
|
│ ▼ ▼ │
|
|
310
501
|
│ ┌───────────────┐ ┌───────────────┐ │
|
|
311
|
-
│ │
|
|
312
|
-
│ │ [
|
|
313
|
-
│ │ [
|
|
314
|
-
│ │ [
|
|
502
|
+
│ │ Draft SPEC │ │ .feature │ │
|
|
503
|
+
│ │ [Confirmed] │ │ .test.ts │ │
|
|
504
|
+
│ │ [Inferred] │ │ acceptance.md │ │
|
|
505
|
+
│ │ [Unknown] │ │ [Generated] │ │
|
|
315
506
|
│ └───────────────┘ └───────────────┘ │
|
|
316
507
|
│ │
|
|
317
508
|
└───────────────────────────────────────────────────────────────────────┘
|
|
@@ -339,51 +530,252 @@ spec-review → forward-derivation → discovery
|
|
|
339
530
|
- **單一真實來源**:SPEC 的驗收條件(AC)。所有下游產物——BDD 場景、TDD/IT/E2E 骨架、ATDD 表格、契約,**以及使用者指南**——都是同一條 AC 主幹的投影。使用者指南不是另一個要互相對照的來源,而是又一個投影。
|
|
340
531
|
- **僅限 user-facing AC**:唯有**終端使用者可直接觀察或操作**的 AC(UI 流程、CLI 指令、對外 API 的使用者語意)才需要使用者指南步驟。純內部 AC(重構、內部模組契約、效能門檻、安全內控)無使用者指南義務。**判不準時一律歸 user-facing**——保守預設;必須明確標記才能排除。
|
|
341
532
|
- **共用編號(`T-NNN`)**:每個使用者指南步驟標 `T-NNN`,且該 `T-NNN` 必須是某個真實 journey/E2E 測試的 id。使用者指南與 E2E 套件是同一作業流程的兩個投影、共用一把尺。模稜兩可或未標記一律報為**未覆蓋**(寧可冗餘不要遺漏)。
|
|
342
|
-
- ✅ 使用者指南步驟 `T-012
|
|
533
|
+
- ✅ 使用者指南步驟 `T-012 "Create a project"` ↔ journey spec 中的 E2E 測試 `T-012`。
|
|
343
534
|
- ❌ 使用者指南自造 `UG-3` 卻無對應測試 → drift,報為未覆蓋。
|
|
344
|
-
- **Drift
|
|
535
|
+
- **Drift 反例**:使用者指南寫 "2-click checkout"、E2E 卻仍驗 "3-step payment"——沒有共用編號就無人察覺。共用 `T-NNN` 把這種 drift 變成被報出的覆蓋缺口。
|
|
345
536
|
|
|
346
537
|
### 單一主幹原則(非平行對照)
|
|
347
538
|
|
|
348
|
-
測試與文件來源是**同一條 AC 主幹的多層投影**,不是互相對照的獨立真實來源。TDD/IT/E2E
|
|
539
|
+
測試與文件來源是**同一條 AC 主幹的多層投影**,不是互相對照的獨立真實來源。TDD/IT/E2E 是同一主幹的金字塔*層級*(參見測試層級決策樹),非彼此競爭的來源。兩兩對照 N 個來源(N×N)會滋生 drift;把每個產物投影回單一 AC 主幹(N×1)則消除它。
|
|
349
540
|
|
|
350
541
|
> **規則**:每個測試或文件產物都必須回溯到某個 AC。另立**平行編號體系**——一條脫離 AC 主幹的第二套 `T-NNN` 系列——即為違規。只有一把尺:AC 主幹,且 `T-NNN` 由 journey/E2E 測試與使用者指南共用。
|
|
351
542
|
|
|
352
543
|
---
|
|
353
544
|
|
|
545
|
+
## 測試層級決策樹
|
|
546
|
+
|
|
547
|
+
根據 AC 的性質決定應生成哪種測試層級:
|
|
548
|
+
|
|
549
|
+
```
|
|
550
|
+
AC 涉及使用者介面操作(點擊、瀏覽、重導向、表單填寫)?
|
|
551
|
+
├─ Yes → E2E Test
|
|
552
|
+
└─ No
|
|
553
|
+
├─ AC 涉及多個服務/元件互動(API 呼叫、DB 查詢、Queue)?
|
|
554
|
+
│ ├─ Yes → Integration Test
|
|
555
|
+
│ └─ No → Unit Test(已由 /derive-tdd 覆蓋)
|
|
556
|
+
└─ AC 涉及外部系統呼叫(第三方 API、外部 DB)?
|
|
557
|
+
└─ Yes → Integration Test
|
|
558
|
+
```
|
|
559
|
+
|
|
560
|
+
---
|
|
561
|
+
|
|
562
|
+
## 整合測試推演
|
|
563
|
+
|
|
564
|
+
當 AC 涉及多個服務/元件互動或外部系統呼叫時,生成 Integration Test 骨架。
|
|
565
|
+
|
|
566
|
+
### 介面範本
|
|
567
|
+
|
|
568
|
+
#### HTTP API
|
|
569
|
+
|
|
570
|
+
```
|
|
571
|
+
Setup:
|
|
572
|
+
- Start test server / mock server
|
|
573
|
+
- Seed test data (DB fixtures, mock responses)
|
|
574
|
+
|
|
575
|
+
Request:
|
|
576
|
+
- Send HTTP request (method, path, headers, body)
|
|
577
|
+
- [TODO] Fill in request details from AC
|
|
578
|
+
|
|
579
|
+
Assert:
|
|
580
|
+
- Verify response status code
|
|
581
|
+
- Verify response body structure
|
|
582
|
+
- Verify side effects (DB state, event published)
|
|
583
|
+
- [TODO] Fill in expected values from AC
|
|
584
|
+
|
|
585
|
+
Teardown:
|
|
586
|
+
- Clean up test data
|
|
587
|
+
- Stop test server / mock server
|
|
588
|
+
```
|
|
589
|
+
|
|
590
|
+
#### Database
|
|
591
|
+
|
|
592
|
+
```
|
|
593
|
+
Setup:
|
|
594
|
+
- Connect to test database
|
|
595
|
+
- Run migrations / seed schema
|
|
596
|
+
- Insert prerequisite data
|
|
597
|
+
|
|
598
|
+
Action:
|
|
599
|
+
- Execute query / repository method
|
|
600
|
+
- [TODO] Fill in operation details from AC
|
|
601
|
+
|
|
602
|
+
Assert:
|
|
603
|
+
- Verify returned data matches expected
|
|
604
|
+
- Verify data persistence (read-after-write)
|
|
605
|
+
- Verify constraints (unique, foreign key)
|
|
606
|
+
- [TODO] Fill in expected results from AC
|
|
607
|
+
|
|
608
|
+
Teardown:
|
|
609
|
+
- Rollback transaction / truncate tables
|
|
610
|
+
- Disconnect from test database
|
|
611
|
+
```
|
|
612
|
+
|
|
613
|
+
#### Message Queue
|
|
614
|
+
|
|
615
|
+
```
|
|
616
|
+
Setup:
|
|
617
|
+
- Connect to test queue (or in-memory broker)
|
|
618
|
+
- Subscribe to target topic/queue
|
|
619
|
+
- Prepare message payload
|
|
620
|
+
|
|
621
|
+
Action:
|
|
622
|
+
- Publish message to queue
|
|
623
|
+
- [TODO] Fill in message details from AC
|
|
624
|
+
|
|
625
|
+
Assert:
|
|
626
|
+
- Verify message received by consumer
|
|
627
|
+
- Verify message payload structure
|
|
628
|
+
- Verify consumer side effects (DB write, API call)
|
|
629
|
+
- [TODO] Fill in expected behavior from AC
|
|
630
|
+
|
|
631
|
+
Teardown:
|
|
632
|
+
- Drain queue
|
|
633
|
+
- Disconnect from broker
|
|
634
|
+
```
|
|
635
|
+
|
|
636
|
+
#### Service-to-Service
|
|
637
|
+
|
|
638
|
+
```
|
|
639
|
+
Setup:
|
|
640
|
+
- Start dependent service (or mock/stub)
|
|
641
|
+
- Configure service discovery / endpoints
|
|
642
|
+
- Prepare request context
|
|
643
|
+
|
|
644
|
+
Action:
|
|
645
|
+
- Call target service method / endpoint
|
|
646
|
+
- [TODO] Fill in service call details from AC
|
|
647
|
+
|
|
648
|
+
Assert:
|
|
649
|
+
- Verify response from target service
|
|
650
|
+
- Verify downstream service was called correctly
|
|
651
|
+
- Verify error propagation (if applicable)
|
|
652
|
+
- [TODO] Fill in expected interactions from AC
|
|
653
|
+
|
|
654
|
+
Teardown:
|
|
655
|
+
- Stop mock services
|
|
656
|
+
- Clean up shared state
|
|
657
|
+
```
|
|
658
|
+
|
|
659
|
+
---
|
|
660
|
+
|
|
661
|
+
## E2E 測試推演
|
|
662
|
+
|
|
663
|
+
當 AC 涉及使用者介面操作時,生成 E2E Test 骨架。
|
|
664
|
+
|
|
665
|
+
### Browser E2E Skeleton | 瀏覽器 E2E 骨架
|
|
666
|
+
|
|
667
|
+
```
|
|
668
|
+
Environment:
|
|
669
|
+
- Launch browser (headless or headed)
|
|
670
|
+
- Set viewport, locale, auth state
|
|
671
|
+
- [TODO] Configure environment from AC prerequisites
|
|
672
|
+
|
|
673
|
+
Navigation:
|
|
674
|
+
- Navigate to target URL / page
|
|
675
|
+
- Wait for page load / element visibility
|
|
676
|
+
- [TODO] Fill in target page from AC
|
|
677
|
+
|
|
678
|
+
Interaction:
|
|
679
|
+
- Perform user actions (click, type, select, scroll)
|
|
680
|
+
- [TODO] Fill in user actions from AC steps
|
|
681
|
+
|
|
682
|
+
Assertion:
|
|
683
|
+
- Verify page state (URL, title, element text)
|
|
684
|
+
- Verify visual elements (visible, hidden, enabled)
|
|
685
|
+
- Verify data changes reflected in UI
|
|
686
|
+
- [TODO] Fill in expected outcomes from AC
|
|
687
|
+
|
|
688
|
+
Cleanup:
|
|
689
|
+
- Reset application state
|
|
690
|
+
- Close browser context
|
|
691
|
+
```
|
|
692
|
+
|
|
693
|
+
### Gherkin Step Mapping | Gherkin 步驟映射
|
|
694
|
+
|
|
695
|
+
| Gherkin 關鍵字 | 對應到 | E2E 階段 |
|
|
696
|
+
|-----------------|---------|-----------|
|
|
697
|
+
| `Given` | 設定 + 導航 | 環境準備、頁面導航、前置狀態 |
|
|
698
|
+
| `When` | 互動 | 使用者動作(點擊、輸入、提交) |
|
|
699
|
+
| `Then` | 斷言 | 驗證預期結果(頁面狀態、UI 元素、資料) |
|
|
700
|
+
| `And` / `But` | 延伸前一項 | 額外的設定、互動或斷言 |
|
|
701
|
+
|
|
702
|
+
**映射範例**:
|
|
703
|
+
|
|
704
|
+
```gherkin
|
|
705
|
+
# Gherkin (from BDD)
|
|
706
|
+
Given a logged-in user on the dashboard → Environment: set auth state; Navigation: go to /dashboard
|
|
707
|
+
When the user clicks "Create Project" → Interaction: click button "Create Project"
|
|
708
|
+
And fills in the project name "My Project" → Interaction: type "My Project" into name field
|
|
709
|
+
And clicks "Submit" → Interaction: click button "Submit"
|
|
710
|
+
Then a success message is displayed → Assertion: verify success message visible
|
|
711
|
+
And the project appears in the project list → Assertion: verify "My Project" in project list
|
|
712
|
+
```
|
|
713
|
+
|
|
714
|
+
---
|
|
715
|
+
|
|
716
|
+
## AC 層級摘要標記
|
|
717
|
+
|
|
718
|
+
當 `/derive all` 產生多層級輸出時,在輸出的末尾包含一份 **AC 層級摘要**(AC Level Summary),以協助開發人員理解每個 AC 為何被分配到特定測試層級:
|
|
719
|
+
|
|
720
|
+
```markdown
|
|
721
|
+
## AC Level Summary
|
|
722
|
+
| AC | Suggested Level | Rationale |
|
|
723
|
+
|----|----------------|-----------|
|
|
724
|
+
| AC-1 | E2E | Involves UI redirect and page navigation |
|
|
725
|
+
| AC-2 | Integration | API endpoint with database interaction |
|
|
726
|
+
| AC-3 | Unit | Pure calculation, no external dependencies |
|
|
727
|
+
| AC-4 | Integration | Calls external payment gateway API |
|
|
728
|
+
```
|
|
729
|
+
|
|
730
|
+
此摘要僅供參考——開發人員可根據自身判斷覆寫建議的層級。
|
|
731
|
+
|
|
732
|
+
---
|
|
733
|
+
|
|
354
734
|
## 命令
|
|
355
735
|
|
|
356
736
|
### 命令參考
|
|
357
737
|
|
|
358
738
|
| 命令 | 輸入 | 輸出 | 目的 |
|
|
359
|
-
|
|
739
|
+
|---------|-------|--------|---------|
|
|
360
740
|
| `/derive-bdd` | SPEC-XXX.md | .feature | AC → Gherkin 場景 |
|
|
361
741
|
| `/derive-tdd` | SPEC-XXX.md | .test.ts | AC → 測試骨架 |
|
|
742
|
+
| `/derive-it` | SPEC-XXX.md or .feature | .it.test.* | AC → 整合測試骨架 |
|
|
743
|
+
| `/derive-e2e` | SPEC-XXX.md or .feature | .e2e.test.* | AC → E2E 測試骨架 |
|
|
362
744
|
| `/derive-atdd` | SPEC-XXX.md | acceptance.md | AC → 驗收測試表格 |
|
|
363
|
-
| `/derive-
|
|
745
|
+
| `/derive-contracts` | SPEC-XXX.md | contract.json, schema.json | AC → 合約與 schema 定義 |
|
|
746
|
+
| `/derive-all` | SPEC-XXX.md | 以上全部 | 完整推演管線(BDD + TDD + IT + E2E + ATDD + 合約) |
|
|
364
747
|
|
|
365
748
|
### 命令參數
|
|
366
749
|
|
|
367
750
|
| 參數 | 類型 | 預設值 | 描述 |
|
|
368
|
-
|
|
369
|
-
| `--lang` | string | typescript |
|
|
370
|
-
| `--framework` | string | vitest |
|
|
751
|
+
|-----------|------|---------|-------------|
|
|
752
|
+
| `--lang` | string | typescript | 目標:ts, js, python, java, go |
|
|
753
|
+
| `--framework` | string | vitest | 框架:vitest, jest, pytest, junit, go-test |
|
|
371
754
|
| `--output-dir` | string | ./generated | 輸出目錄 |
|
|
372
755
|
| `--dry-run` | boolean | false | 預覽不建立檔案 |
|
|
373
756
|
|
|
374
757
|
### 使用範例
|
|
375
758
|
|
|
376
759
|
```bash
|
|
377
|
-
#
|
|
760
|
+
# Generate BDD scenarios from specification
|
|
378
761
|
/derive-bdd specs/SPEC-001.md
|
|
379
762
|
|
|
380
|
-
#
|
|
763
|
+
# Generate TDD test skeleton with Python/pytest
|
|
381
764
|
/derive-tdd specs/SPEC-001.md --lang python --framework pytest
|
|
382
765
|
|
|
383
|
-
#
|
|
766
|
+
# Generate contract and schema definitions for verification
|
|
767
|
+
/derive-contracts specs/SPEC-001.md --output-dir ./contracts
|
|
768
|
+
|
|
769
|
+
# Generate integration test skeletons
|
|
770
|
+
/derive-it specs/SPEC-001.md --lang python --framework pytest
|
|
771
|
+
|
|
772
|
+
# Generate E2E test skeletons
|
|
773
|
+
/derive-e2e specs/SPEC-001.md --framework playwright
|
|
774
|
+
|
|
775
|
+
# Generate all outputs (BDD + TDD + IT + E2E + ATDD + Contracts)
|
|
384
776
|
/derive-all specs/SPEC-001.md --output-dir ./generated
|
|
385
777
|
|
|
386
|
-
#
|
|
778
|
+
# Preview without creating files
|
|
387
779
|
/derive-all specs/SPEC-001.md --dry-run
|
|
388
780
|
```
|
|
389
781
|
|
|
@@ -398,7 +790,7 @@ spec-review → forward-derivation → discovery
|
|
|
398
790
|
#### Auto-TDD 進入規則
|
|
399
791
|
|
|
400
792
|
| 規則 | 說明 |
|
|
401
|
-
|
|
793
|
+
|------|-------------|
|
|
402
794
|
| **推演完整性** | 所有推演輸出(BDD、TDD、ATDD)必須在進入 TDD 前完成生成 |
|
|
403
795
|
| **RED 狀態初始化** | Pipeline 在生成測試骨架後將 TDD 狀態設為 RED |
|
|
404
796
|
| **測試骨架驗證** | 生成的測試檔案必須能編譯/解析無誤後才能進入 RED |
|
|
@@ -409,7 +801,7 @@ spec-review → forward-derivation → discovery
|
|
|
409
801
|
推演步驟可透過 Pipeline 事件自動觸發:
|
|
410
802
|
|
|
411
803
|
| Hook | 觸發條件 | 動作 |
|
|
412
|
-
|
|
804
|
+
|------|---------|--------|
|
|
413
805
|
| `on-spec-approved` | Spec 狀態變更為「已批准」 | 啟動推演 Pipeline |
|
|
414
806
|
| `on-derivation-complete` | 所有推演輸出已生成 | 轉換至 TDD RED 階段 |
|
|
415
807
|
| `on-tdd-green` | 所有推演測試通過 | 觸發審查階段 |
|
|
@@ -426,20 +818,45 @@ spec-review → forward-derivation → discovery
|
|
|
426
818
|
1. **Spec 批准**:Pipeline 偵測到 Spec 批准(透過 hook 或輪詢)
|
|
427
819
|
2. **完整推演**:Pipeline 以專案配置的語言/框架執行 `/derive-all`
|
|
428
820
|
3. **計數驗證**:Pipeline 驗證輸出數量與 AC 數量匹配(反幻覺)
|
|
429
|
-
4. **RED 狀態**:Pipeline 將 TDD 狀態設為 RED
|
|
821
|
+
4. **RED 狀態**:Pipeline 將 TDD 狀態設為 RED;測試骨架存在但斷言為 [TODO]
|
|
430
822
|
|
|
431
823
|
#### 與 Pipeline 階段的整合
|
|
432
824
|
|
|
433
825
|
正向推演對應 [Pipeline 整合標準](pipeline-integration-standards.md) 6 階段模型中的 **DERIVE** 階段:
|
|
434
826
|
|
|
435
827
|
| Pipeline 階段 | 正向推演角色 |
|
|
436
|
-
|
|
828
|
+
|---------------|------------------------|
|
|
437
829
|
| SPEC | 輸入:已批准的規格 |
|
|
438
830
|
| **DERIVE** | 執行:解析 AC → 生成 BDD/TDD/ATDD 輸出 |
|
|
439
831
|
| BUILD | 輸出:測試骨架進入 TDD RED→GREEN 循環 |
|
|
440
832
|
|
|
441
833
|
---
|
|
442
834
|
|
|
835
|
+
## 失敗處理與復原
|
|
836
|
+
|
|
837
|
+
正向推演定義了數個關卡(AC 解析、計數驗證、骨架驗證、人類審查)。本節定義當關卡**失敗**時的處理方式——即 失敗 → 回滾 → 重試/升級呈報 → 重新驗證 的路徑——確保失敗的推演絕不靜默產出部分或幻覺輸出。
|
|
838
|
+
|
|
839
|
+
### 失敗 → 復原矩陣
|
|
840
|
+
|
|
841
|
+
| 失敗情況 | 偵測階段 | 復原動作 | 重新驗證 |
|
|
842
|
+
|---------|-------------|-----------------|-----------|
|
|
843
|
+
| **解析錯誤**——AC 不在支援的格式中(GWT / 條列式) | DERIVE(解析 AC) | 中止該 AC 的生成;回報 `file:line` 與預期格式;不為其產出骨架。待 SPEC 修復後重新排隊。 | 修正後的 AC 解析成功 |
|
|
844
|
+
| **AC 計數不符**——生成的測試數量 ≠ AC 數量 | 計數驗證 | **[違反反幻覺規則]** 回滾整批並在嚴格 1:1 對應下重新生成。絕不可透過新增或刪除測試來「湊齊數量」——這會掩蓋幻覺。 | 計數檢查通過(測試數 = AC 數) |
|
|
845
|
+
| **骨架無法解析/編譯** | 骨架驗證 | 回滾有問題的檔案;使用正確的語言範本重新生成。若第二次仍失敗,將該 AC 標記為 `[BLOCKED]` 並呈報給人工處理。 | 檔案解析/編譯通過 |
|
|
846
|
+
| **人類審查退回**——審查者指出邏輯錯誤或未填寫的 `[TODO]` | 人類審查關卡 | 記錄退回原因;將該回饋作為額外限制,僅重新生成被退回的項目。絕不可自動批准。 | 審查者接受 |
|
|
847
|
+
| **缺少來源標註**——輸出缺少 `@SPEC-XXX` / `@AC-N` | 任何階段 | 阻止轉換至 TDD RED;補上來源標註後重新產出。 | 每個輸出皆帶有來源標註 |
|
|
848
|
+
|
|
849
|
+
### 復原規則
|
|
850
|
+
|
|
851
|
+
| 規則 | 說明 | 嚴重程度 |
|
|
852
|
+
|------|-------------|----------|
|
|
853
|
+
| **FD-FAIL-001** | 關卡失敗必須中斷流程——絕不可在有未解決失敗的情況下進入 TDD RED。 | 必要 |
|
|
854
|
+
| **FD-FAIL-002** | 計數不符屬於強制回滾,而非調節對帳;嚴禁透過新增或刪除測試來湊數(這會掩蓋幻覺)。 | 必要 |
|
|
855
|
+
| **FD-FAIL-003** | 自動重試有次數限制(最多 2 次,針對瞬時或範本錯誤);重試耗盡時將 AC 標記為 `[BLOCKED]` 並呈報給人工處理。 | 必要 |
|
|
856
|
+
| **FD-FAIL-004** | 每個復原路徑皆以重新驗證失敗的關卡結束——在原始檢查通過之前,復原不算完成。 | 必要 |
|
|
857
|
+
|
|
858
|
+
---
|
|
859
|
+
|
|
443
860
|
## 應避免的反模式
|
|
444
861
|
|
|
445
862
|
### 生成反模式
|
|
@@ -486,14 +903,54 @@ spec-review → forward-derivation → discovery
|
|
|
486
903
|
|
|
487
904
|
---
|
|
488
905
|
|
|
906
|
+
## 工具整合
|
|
907
|
+
|
|
908
|
+
### Skill 參考
|
|
909
|
+
|
|
910
|
+
- [正向推演 Skill](../skills/spec-derivation/SKILL.md) - 詳細工作流程實作
|
|
911
|
+
- [規格驅動開發 Skill](../skills/spec-driven-dev/SKILL.md) - SDD 工作流程
|
|
912
|
+
- [BDD 助理 Skill](../skills/bdd-assistant/SKILL.md) - Gherkin 精煉
|
|
913
|
+
- [TDD 助理 Skill](../skills/tdd-assistant/SKILL.md) - 測試實作
|
|
914
|
+
|
|
915
|
+
---
|
|
916
|
+
|
|
489
917
|
## 相關規範
|
|
490
918
|
|
|
491
|
-
- [反向工程標準](reverse-engineering-standards.md) -
|
|
919
|
+
- [反向工程標準](reverse-engineering-standards.md) - 對稱的對應標準(程式碼 → 規格)
|
|
492
920
|
- [規格驅動開發](spec-driven-development.md) - 輸入規格格式
|
|
493
|
-
- [行為驅動開發](
|
|
494
|
-
- [測試驅動開發](test-driven-development.md) - TDD
|
|
495
|
-
- [驗收測試驅動開發](
|
|
496
|
-
- [
|
|
921
|
+
- [行為驅動開發](behavior-driven-development.md) - BDD 輸出格式
|
|
922
|
+
- [測試驅動開發](test-driven-development.md) - TDD 輸出使用方式
|
|
923
|
+
- [驗收測試驅動開發](acceptance-test-driven-development.md) - ATDD 輸出格式
|
|
924
|
+
- [反幻覺指引](anti-hallucination.md) - 生成合規性
|
|
925
|
+
|
|
926
|
+
---
|
|
927
|
+
|
|
928
|
+
## 參考資料
|
|
929
|
+
|
|
930
|
+
### 書籍
|
|
931
|
+
|
|
932
|
+
- Steve Freeman & Nat Pryce - "Growing Object-Oriented Software, Guided by Tests" (2009) - 雙迴圈 TDD 模式基礎
|
|
933
|
+
- Gojko Adzic - "Specification by Example" (2011) - 從規格到測試推演的概念
|
|
934
|
+
|
|
935
|
+
### 線上資源
|
|
936
|
+
|
|
937
|
+
#### 合約測試
|
|
938
|
+
|
|
939
|
+
- [Microsoft: Consumer-Driven Contract Testing](https://microsoft.github.io/code-with-engineering-playbook/automated-testing/cdc-testing/) - 關於 CDC 測試的工程實務手冊
|
|
940
|
+
- [BrowserStack: Contract Testing Guide](https://www.browserstack.com/guide/contract-testing) - 全面的合約測試概述
|
|
941
|
+
- [Specmatic: AI-powered API Contract Testing](https://specmatic.io/) - 現代合約優先開發工具
|
|
942
|
+
|
|
943
|
+
#### 驗證理論
|
|
944
|
+
|
|
945
|
+
- [Wikipedia: Formal Verification](https://en.wikipedia.org/wiki/Formal_verification) - 驗證的理論基礎
|
|
946
|
+
- [Wikipedia: Design by Contract](https://en.wikipedia.org/wiki/Design_by_contract) - Bertrand Meyer 的 DbC 概念 (1986)
|
|
947
|
+
|
|
948
|
+
#### SDD 與正向推演
|
|
949
|
+
|
|
950
|
+
- [Thoughtworks: Spec-Driven Development](https://www.thoughtworks.com/en-us/insights/blog/agile-engineering-practices/spec-driven-development-unpacking-2025-new-engineering-practices) - SDD 方法論定義
|
|
951
|
+
- [Martin Fowler: SDD Tools (Kiro, spec-kit, Tessl)](https://martinfowler.com/articles/exploring-gen-ai/sdd-3-tools.html) - AI 時代 SDD 工具探索
|
|
952
|
+
- [GitHub spec-kit](https://github.com/github/spec-kit/blob/main/spec-driven.md) - GitHub 的 SDD 實作
|
|
953
|
+
- [InfoQ: Spec-Driven Development](https://www.infoq.com/articles/spec-driven-development/) - SDD 實務概述
|
|
497
954
|
|
|
498
955
|
---
|
|
499
956
|
|
|
@@ -501,11 +958,13 @@ spec-review → forward-derivation → discovery
|
|
|
501
958
|
|
|
502
959
|
| 版本 | 日期 | 變更 |
|
|
503
960
|
|------|------|------|
|
|
504
|
-
| 1.
|
|
961
|
+
| 1.3.0 | 2026-06-18 | 新增:失敗處理與復原章節 — failure→rollback→retry/escalate→re-verify 矩陣 + 復原規則 FD-FAIL-001..004(XSPEC-292 T7) |
|
|
962
|
+
| 1.2.0 | 2026-03-18 | 新增:Pipeline 整合章節 — auto-TDD 轉換、Pipeline hooks、auto-TDD 進入工作流程 |
|
|
963
|
+
| 1.1.0 | 2026-01-25 | 新增:合約輸出 (contract.json)、Schema 輸出 (schema.json)、用於驗證產物生成的 /derive-contracts 命令 |
|
|
505
964
|
| 1.0.0 | 2026-01-19 | 初始發布 |
|
|
506
965
|
|
|
507
966
|
---
|
|
508
967
|
|
|
509
968
|
## 授權
|
|
510
969
|
|
|
511
|
-
|
|
970
|
+
本標準以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 釋出。
|