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,27 +1,31 @@
|
|
|
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
|
-
> **语言**: [English](../../../core/forward-derivation-standards.md) | 简体中文
|
|
19
|
+
> **语言**: [English](../../../core/forward-derivation-standards.md) | [繁體中文](../../zh-TW/core/forward-derivation-standards.md) | 简体中文
|
|
16
20
|
|
|
17
21
|
---
|
|
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
|
- 减少手动转换错误
|
|
@@ -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
|
-
| **解析 SPEC** | 读取已批准的规格文档 | SPEC
|
|
60
|
-
| **提取 AC** | 解析验收条件(GWT 或条列) | 结构化 AC 列表 | [
|
|
61
|
-
| **生成 BDD** | 将 AC 转换为 Gherkin 场景 | .feature 文件 | [
|
|
62
|
-
| **生成 TDD** | 从 AC 创建测试骨架 | 带 TODO 的测试文件 | [
|
|
63
|
-
| **生成 ATDD** | 创建验收测试表格 | Markdown 测试表格 | [
|
|
64
|
-
|
|
|
64
|
+
| **解析 SPEC** | 读取已批准的规格文档 | SPEC 元数据、章节 | [Source] |
|
|
65
|
+
| **提取 AC** | 解析验收条件(GWT 或条列) | 结构化 AC 列表 | [Derived] |
|
|
66
|
+
| **生成 BDD** | 将 AC 转换为 Gherkin 场景 | .feature 文件 | [Generated] |
|
|
67
|
+
| **生成 TDD** | 从 AC 创建测试骨架 | 带 TODO 的测试文件 | [Generated] |
|
|
68
|
+
| **生成 ATDD** | 创建验收测试表格 | Markdown 测试表格 | [Generated] |
|
|
69
|
+
| **生成契约** | 提取前置/后置条件 | contract.json, schema.json | [Generated] |
|
|
70
|
+
| **人类审查** | 验证生成的输出 | 已批准的测试结构 | [Reviewed] |
|
|
65
71
|
|
|
66
72
|
---
|
|
67
73
|
|
|
@@ -69,73 +75,107 @@ 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
|
|
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. 确定性标签
|
|
130
138
|
|
|
131
139
|
使用这些标签标示推演确定性:
|
|
132
140
|
|
|
133
|
-
| 标签 | 定义 |
|
|
141
|
+
| 标签 | 定义 | 示例 |
|
|
134
142
|
|------|------|------|
|
|
135
|
-
| `[
|
|
136
|
-
| `[
|
|
137
|
-
| `[
|
|
138
|
-
| `[TODO]` |
|
|
143
|
+
| `[Source]` | 直接来自 SPEC 的内容 | 功能标题、AC 文本 |
|
|
144
|
+
| `[Derived]` | 从 SPEC 内容转换 | 从条列 AC 转换的 GWT |
|
|
145
|
+
| `[Generated]` | AI 生成的结构 | 测试骨架、TODO 注释 |
|
|
146
|
+
| `[TODO]` | 需要人工实现 | 测试断言、步骤定义 |
|
|
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
|
+
| 无清单 / 无 test_levels | 所有级别(与默认相同) |
|
|
166
|
+
|
|
167
|
+
**映射**:
|
|
168
|
+
|
|
169
|
+
| test_levels 值 | 推演输出 |
|
|
170
|
+
|-------------------|------------------|
|
|
171
|
+
| `unit-testing` | `/derive-tdd`(始终包含) |
|
|
172
|
+
| `integration-testing` | `/derive-it` |
|
|
173
|
+
| `system-testing` | `/derive-it`(system = 更广泛的集成) |
|
|
174
|
+
| `e2e-testing` | `/derive-e2e` |
|
|
175
|
+
|
|
176
|
+
**注意**:BDD(.feature)、ATDD(acceptance.md)和契约(contract.json)始终都会生成,不受 test_levels 影响,因为它们属于规格产物,而非特定于某个测试级别。
|
|
177
|
+
|
|
178
|
+
**AI Agent 指令**:执行 `/derive all` 时,首先检查 `test_levels` 配置。如果 `e2e-testing` 不在已配置的级别中,则跳过 E2E 骨架生成并通知用户:"Skipping E2E derivation — not in project test_levels configuration. Run `uds config --type test_levels` to add it."
|
|
139
179
|
|
|
140
180
|
---
|
|
141
181
|
|
|
@@ -146,140 +186,291 @@ 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
|
---
|
|
270
442
|
|
|
271
443
|
## 条列式转 GWT 转换
|
|
272
444
|
|
|
273
|
-
当 AC
|
|
445
|
+
当 AC 以条列点编写时,使用此模式转换:
|
|
274
446
|
|
|
275
447
|
### 转换规则
|
|
276
448
|
|
|
277
449
|
| 条列模式 | 对应到 | 范例 |
|
|
278
450
|
|----------|--------|------|
|
|
279
|
-
| 条件/状态 | Given |
|
|
280
|
-
| 用户动作 | When |
|
|
281
|
-
| 系统响应 | Then |
|
|
282
|
-
|
|
|
451
|
+
| 条件/状态 | Given | “用户已登录” → Given 用户已登录 |
|
|
452
|
+
| 用户动作 | When | “用户点击按钮” → When 用户点击按钮 |
|
|
453
|
+
| 系统响应 | Then | “显示消息” → Then 显示消息 |
|
|
454
|
+
| “可以/应该/必须” | When + Then | “用户可以删除项目” → When 用户删除项目 Then 项目已移除 |
|
|
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
|
+
```
|
|
283
474
|
|
|
284
475
|
---
|
|
285
476
|
|
|
@@ -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
|
└───────────────────────────────────────────────────────────────────────┘
|
|
@@ -327,27 +518,216 @@ spec-review → forward-derivation → discovery
|
|
|
327
518
|
|
|
328
519
|
1. **规格审查 (SDD)**:规格已批准
|
|
329
520
|
2. **正向推演**:自动生成 BDD 场景、TDD 骨架
|
|
330
|
-
3. **探索 (BDD)
|
|
521
|
+
3. **探索 (BDD)**:与利益相关者审查和完善生成的场景
|
|
331
522
|
4. **TDD 红灯**:使用生成的骨架开始实现测试
|
|
332
523
|
|
|
333
524
|
---
|
|
334
525
|
|
|
335
526
|
## 终端投影:用户指南
|
|
336
527
|
|
|
337
|
-
推演链不止于测试。**用户指南是同一条链的终端投影**——E2E
|
|
528
|
+
推演链不止于测试。**用户指南是同一条链的终端投影**——E2E/旅程测试以机器验证的那条工作流程,其供人阅读的视图。“用户读到的操作步骤”与“E2E 实际验证的行为”成为一个被维持的不变量。
|
|
338
529
|
|
|
339
|
-
- **单一真实来源**:SPEC 的验收条件(AC)。所有下游产物——BDD 场景、TDD
|
|
340
|
-
- **仅限 user-facing AC**:唯有**终端用户可直接观察或操作**的 AC(UI 流程、CLI
|
|
341
|
-
-
|
|
342
|
-
- ✅ 用户指南步骤 `T-012
|
|
343
|
-
- ❌ 用户指南自造 `UG-3` 却无对应测试 →
|
|
344
|
-
-
|
|
530
|
+
- **单一真实来源**:SPEC 的验收条件(AC)。所有下游产物——BDD 场景、TDD/IT/E2E 骨架、ATDD 表格、契约,**以及用户指南**——都是同一条 AC 主干的投影。用户指南不是另一个要互相对照的来源;它是又一个投影。
|
|
531
|
+
- **仅限 user-facing AC**:唯有**终端用户可直接观察或操作**的 AC(UI 流程、CLI 命令、面向用户的 API 语义)才需要用户指南步骤。纯内部 AC(重构、内部模块契约、性能阈值、安全控制)无用户指南义务。**拿不准时一律视作 user-facing**——保守默认;必须明确标记才能排除。
|
|
532
|
+
- **共享编号(`T-NNN`)**:每个用户指南步骤都标记 `T-NNN`,且该 `T-NNN` 必须是某个真实旅程/E2E 测试的 id。用户指南与 E2E 测试套件是同一工作流程的两个投影,共享一把尺子。模棱两可或缺失的标记均被报告为**未覆盖**(宁可冗余不可遗漏)。
|
|
533
|
+
- ✅ 用户指南步骤 `T-012 "Create a project"` ↔ 旅程规格中的 E2E 测试 `T-012`。
|
|
534
|
+
- ❌ 用户指南自造 `UG-3` 却无对应测试 → 漂移,报告为未覆盖。
|
|
535
|
+
- **漂移示例**:用户指南写着“2-click checkout”,而 E2E 仍验证“3-step payment”——若没有共享编号,无人会察觉。共享 `T-NNN` 将这种漂移转化为被报告的覆盖缺口。
|
|
345
536
|
|
|
346
537
|
### 单一主干原则(非平行对照)
|
|
347
538
|
|
|
348
|
-
|
|
539
|
+
测试与文档来源是**同一条 AC 主干的多层投影**,不是互相对照的独立真实来源。TDD/IT/E2E 是同一主干的金字塔*层级*(参见测试层级决策树),而非彼此竞争的来源。对 N 个来源两两对照(N×N)会滋生漂移;将每个产物投影回单一 AC 主干(N×1)则能消除它。
|
|
349
540
|
|
|
350
|
-
>
|
|
541
|
+
> **规则**:每个测试或文档产物都必须回溯到某个 AC。另立**平行编号体系**——即脱离 AC 主干的第二套 `T-NNN` 风格系列——属于违规。尺子只有一把:AC 主干,且 `T-NNN` 由旅程/E2E 测试与用户指南共享。
|
|
542
|
+
|
|
543
|
+
---
|
|
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
|
+
#### 数据库
|
|
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
|
+
#### 消息队列
|
|
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
|
+
#### 服务到服务
|
|
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 测试骨架。
|
|
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
|
+
此摘要仅供参考——开发人员可根据自身判断覆盖建议的层级。
|
|
351
731
|
|
|
352
732
|
---
|
|
353
733
|
|
|
@@ -356,34 +736,46 @@ spec-review → forward-derivation → discovery
|
|
|
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 或 .feature | .it.test.* | AC → 集成测试骨架 |
|
|
743
|
+
| `/derive-e2e` | SPEC-XXX.md 或 .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 + Contracts) |
|
|
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
|
-
| `--dry-run` | boolean | false |
|
|
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,8 +801,8 @@ spec-review → forward-derivation → discovery
|
|
|
409
801
|
推演步骤可通过 Pipeline 事件自动触发:
|
|
410
802
|
|
|
411
803
|
| Hook | 触发条件 | 动作 |
|
|
412
|
-
|
|
413
|
-
| `on-spec-approved` | Spec
|
|
804
|
+
|------|---------|--------|
|
|
805
|
+
| `on-spec-approved` | Spec 状态变更为“已批准” | 启动推演 Pipeline |
|
|
414
806
|
| `on-derivation-complete` | 所有推演输出已生成 | 转换至 TDD RED 阶段 |
|
|
415
807
|
| `on-tdd-green` | 所有推演测试通过 | 触发审查阶段 |
|
|
416
808
|
|
|
@@ -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
|
### 生成反模式
|
|
@@ -457,7 +874,7 @@ spec-review → forward-derivation → discovery
|
|
|
457
874
|
| 反模式 | 影响 | 正确做法 |
|
|
458
875
|
|--------|------|----------|
|
|
459
876
|
| **从草稿 SPEC 推演** | 无效输出 | 只使用已批准的规格 |
|
|
460
|
-
| **跳过人类审查** |
|
|
877
|
+
| **跳过人类审查** | 质量问题 | 永远审查生成的输出 |
|
|
461
878
|
| **将骨架视为完整** | 缺少断言 | 填写 [TODO] 区块 |
|
|
462
879
|
| **忽略语言惯例** | 不一致的代码 | 使用适当的语言模板 |
|
|
463
880
|
|
|
@@ -486,14 +903,54 @@ spec-review → forward-derivation → discovery
|
|
|
486
903
|
|
|
487
904
|
---
|
|
488
905
|
|
|
489
|
-
##
|
|
906
|
+
## 工具整合
|
|
907
|
+
|
|
908
|
+
### Skill 参考
|
|
909
|
+
|
|
910
|
+
- [Forward Derivation Skill](../skills/spec-derivation/SKILL.md) - 详细的工作流实现
|
|
911
|
+
- [Spec-Driven Development Skill](../skills/spec-driven-dev/SKILL.md) - SDD 工作流程
|
|
912
|
+
- [BDD Assistant Skill](../skills/bdd-assistant/SKILL.md) - Gherkin 精炼
|
|
913
|
+
- [TDD Assistant Skill](../skills/tdd-assistant/SKILL.md) - 测试实现
|
|
914
|
+
|
|
915
|
+
---
|
|
916
|
+
|
|
917
|
+
## 相关标准
|
|
490
918
|
|
|
491
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) - Double-Loop 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 整合章节 —— 自动 TDD 转换、pipeline hooks、自动 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/) 发布。
|