universal-dev-standards 6.13.1 → 6.14.0-beta.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +13 -3
- package/bin/uds.js +75 -3
- package/bundled/ai/options/code-review/pr-review.ai.yaml +20 -1
- package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
- package/bundled/ai/standards/ai-response-navigation.ai.yaml +43 -3
- package/bundled/ai/standards/checkin-standards.ai.yaml +25 -6
- package/bundled/ai/standards/code-review.ai.yaml +15 -2
- package/bundled/ai/standards/commit-message.ai.yaml +18 -4
- package/bundled/ai/standards/developer-memory.ai.yaml +12 -2
- package/bundled/ai/standards/full-coverage-testing.ai.yaml +86 -7
- package/bundled/ai/standards/open-work-tracking.ai.yaml +254 -4
- package/bundled/ai/standards/pipeline-security-gates.ai.yaml +53 -4
- package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
- package/bundled/ai/standards/turn-completion-integrity.ai.yaml +14 -7
- package/bundled/core/ai-response-navigation.md +128 -12
- package/bundled/core/code-review-checklist.md +20 -2
- package/bundled/core/commit-message-guide.md +22 -19
- package/bundled/core/developer-memory.md +12 -2
- package/bundled/core/full-coverage-testing.md +99 -5
- package/bundled/core/open-work-tracking.md +251 -8
- package/bundled/core/pipeline-security-gates.md +63 -0
- package/bundled/core/project-context-memory.md +10 -2
- package/bundled/core/turn-completion-integrity.md +58 -11
- package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
- package/bundled/extensions/languages/csharp-style.md +464 -0
- package/bundled/extensions/languages/php-style.md +700 -0
- package/bundled/extensions/locales/zh-cn.md +717 -0
- package/bundled/extensions/locales/zh-tw.md +717 -0
- package/bundled/hooks/check-turn-completion-agy.mjs +147 -0
- package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
- package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
- package/bundled/locales/COVERAGE.md +5 -4
- package/bundled/locales/zh-CN/CHANGELOG.md +211 -3
- package/bundled/locales/zh-CN/README.md +3 -3
- package/bundled/locales/zh-CN/SECURITY.md +3 -1
- package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
- package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
- package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
- package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
- package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
- package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
- package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
- package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
- package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
- package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
- package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
- package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
- package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
- package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
- package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
- package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
- package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
- package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
- package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
- package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
- package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
- package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
- package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
- package/bundled/locales/zh-CN/core/code-review-checklist.md +54 -23
- package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
- package/bundled/locales/zh-CN/core/database-standards.md +115 -114
- package/bundled/locales/zh-CN/core/developer-memory.md +159 -60
- package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
- package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
- package/bundled/locales/zh-CN/core/execution-history.md +2 -1
- package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
- package/bundled/locales/zh-CN/core/full-coverage-testing.md +103 -9
- package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
- package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
- package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
- package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
- package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
- package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
- package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
- package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
- package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
- package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
- package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
- package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
- package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
- package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
- package/bundled/locales/zh-CN/core/security-decision.md +45 -70
- package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
- package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
- package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
- package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
- package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
- package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
- package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
- package/bundled/locales/zh-CN/core/test-governance.md +94 -43
- package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
- package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
- package/bundled/locales/zh-CN/core/token-budget.md +44 -80
- package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
- package/bundled/locales/zh-CN/core/turn-completion-integrity.md +46 -13
- package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
- package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
- package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
- package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
- package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
- package/bundled/locales/zh-CN/docs/CHEATSHEET.md +11 -2
- package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +76 -40
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +32 -15
- package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
- package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
- package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
- package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
- package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
- package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +46 -0
- package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
- package/bundled/locales/zh-CN/docs/user/README.md +4 -2
- package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
- package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
- package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
- package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
- package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
- package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
- package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
- package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
- package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
- package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
- package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
- package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
- package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
- package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
- package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
- package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
- package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
- package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
- package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
- package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
- package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
- package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
- package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
- package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
- package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
- package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
- package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
- package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
- package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
- package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
- package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
- package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
- package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
- package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
- package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
- package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
- package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
- package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
- package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
- package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
- package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
- package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
- package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/skills/README.md +3 -1
- package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
- package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
- package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
- package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
- package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
- package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
- package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
- package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
- package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
- package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
- package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
- package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
- package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
- package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
- package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
- package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
- package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
- package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
- package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
- package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
- package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
- package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
- package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
- package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
- package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
- package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
- package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
- package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
- package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
- package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
- package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
- package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
- package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
- package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
- package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
- package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
- package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
- package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
- package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
- package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
- package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
- package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
- package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
- package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
- package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
- package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
- package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
- package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
- package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
- package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
- package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
- package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
- package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
- package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
- package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
- package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
- package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
- package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
- package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
- package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
- package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
- package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
- package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
- package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
- package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
- package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
- package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
- package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
- package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
- package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
- package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
- package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
- package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
- package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
- package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
- package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
- package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
- package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
- package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
- package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
- package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
- package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
- package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
- package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
- package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
- package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
- package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
- package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
- package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
- package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
- package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
- package/bundled/locales/zh-TW/CHANGELOG.md +211 -3
- package/bundled/locales/zh-TW/README.md +3 -3
- package/bundled/locales/zh-TW/SECURITY.md +3 -1
- package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
- package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
- package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
- package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
- package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
- package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
- package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
- package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
- package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
- package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
- package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
- package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
- package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
- package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
- package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
- package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
- package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
- package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
- package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
- package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
- package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
- package/bundled/locales/zh-TW/core/code-review-checklist.md +36 -7
- package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
- package/bundled/locales/zh-TW/core/database-standards.md +2 -1
- package/bundled/locales/zh-TW/core/developer-memory.md +111 -12
- package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
- package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
- package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
- package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
- package/bundled/locales/zh-TW/core/execution-history.md +2 -1
- package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
- package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
- package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
- package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
- package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
- package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
- package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
- package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
- package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
- package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
- package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
- package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
- package/bundled/locales/zh-TW/core/open-work-tracking.md +164 -9
- package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
- package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
- package/bundled/locales/zh-TW/core/project-context-memory.md +215 -31
- package/bundled/locales/zh-TW/core/project-structure.md +240 -19
- package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
- package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
- package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
- package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
- package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
- package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
- package/bundled/locales/zh-TW/core/security-decision.md +43 -84
- package/bundled/locales/zh-TW/core/security-standards.md +204 -25
- package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
- package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
- package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
- package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
- package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
- package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
- package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
- package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
- package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
- package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
- package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
- package/bundled/locales/zh-TW/core/test-governance.md +92 -32
- package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
- package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
- package/bundled/locales/zh-TW/core/token-budget.md +41 -112
- package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
- package/bundled/locales/zh-TW/core/turn-completion-integrity.md +46 -13
- package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
- package/bundled/locales/zh-TW/core/versioning.md +6 -2
- package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
- package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
- package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
- package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
- package/bundled/locales/zh-TW/docs/CHEATSHEET.md +11 -2
- package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +69 -33
- package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +32 -15
- package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
- package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
- package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
- package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
- package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
- package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +46 -0
- package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
- package/bundled/locales/zh-TW/docs/user/README.md +2 -0
- package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
- package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
- package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
- package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
- package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
- package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
- package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
- package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
- package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
- package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
- package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
- package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
- package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
- package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
- package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
- package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
- package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
- package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
- package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
- package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
- package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
- package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
- package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
- package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
- package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
- package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
- package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
- package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
- package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
- package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
- package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
- package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
- package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
- package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
- package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
- package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
- package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
- package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
- package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
- package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
- package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/skills/README.md +3 -1
- package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
- package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
- package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
- package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
- package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
- package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
- package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
- package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
- package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
- package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
- package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
- package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
- package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
- package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
- package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
- package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
- package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
- package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
- package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
- package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
- package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
- package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
- package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
- package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
- package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
- package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
- package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
- package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
- package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
- package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
- package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
- package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
- package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
- package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
- package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
- package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
- package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
- package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
- package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
- package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
- package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
- package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
- package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
- package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
- package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
- package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
- package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
- package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
- package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
- package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
- package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
- package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
- package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
- package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
- package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
- package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
- package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
- package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
- package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
- package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
- package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
- package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
- package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
- package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
- package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
- package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
- package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
- package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
- package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
- package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
- package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
- package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
- package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
- package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
- package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
- package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
- package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
- package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
- package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
- package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
- package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
- package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
- package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
- package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
- package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
- package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
- package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
- package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
- package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
- package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
- package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
- package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
- package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
- package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
- package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
- package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
- package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
- package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
- package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
- package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
- package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
- package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
- package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
- package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
- package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
- package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
- package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
- package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
- package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
- package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
- package/bundled/skills/README.md +1 -0
- package/bundled/skills/SKILL_NAMING.md +9 -0
- package/bundled/skills/commit-standards/SKILL.md +2 -2
- package/bundled/skills/commit-standards/guide.md +3 -2
- package/bundled/skills/commit-standards/language-options.md +19 -17
- package/bundled/skills/comprehension-ladder/SKILL.md +283 -0
- package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
- package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
- package/bundled/templates/gates/check-stubs.mjs +644 -0
- package/package.json +5 -3
- package/src/commands/audit.js +20 -2
- package/src/commands/check.js +155 -28
- package/src/commands/deps.js +31 -1
- package/src/commands/hitl.js +3 -0
- package/src/commands/init.js +173 -49
- package/src/commands/list.js +12 -3
- package/src/commands/mcp.js +2 -3
- package/src/commands/open-work.js +123 -0
- package/src/commands/quickstart.js +29 -13
- package/src/commands/release.js +102 -19
- package/src/commands/run-intent.js +10 -0
- package/src/commands/simulate.js +20 -8
- package/src/commands/skills.js +59 -33
- package/src/commands/spec-split.js +30 -17
- package/src/commands/spec.js +55 -21
- package/src/commands/uninstall.js +146 -32
- package/src/commands/update.js +471 -93
- package/src/core/install-records.js +192 -0
- package/src/core/manifest.js +12 -10
- package/src/core/marketplace-sentinel.js +5 -0
- package/src/core/open-work-config.js +122 -0
- package/src/core/project-config.js +92 -38
- package/src/flows/init-flow.js +10 -0
- package/src/hitl/manager.js +4 -2
- package/src/i18n/messages.js +413 -78
- package/src/installers/hooks-installer.js +320 -24
- package/src/installers/integration-installer.js +5 -1
- package/src/installers/skills-installer.js +3 -1
- package/src/installers/standards-installer.js +16 -23
- package/src/mcp/__tests__/server.test.js +0 -1
- package/src/mcp/server.js +16 -4
- package/src/prompts/init.js +148 -13
- package/src/reconciler/backup-locations.js +80 -0
- package/src/reconciler/backup-manager.js +451 -123
- package/src/reconciler/index.js +86 -10
- package/src/reconciler/install-roots.js +90 -0
- package/src/reconciler/plan-executor.js +37 -15
- package/src/uninstallers/hook-uninstaller.js +323 -33
- package/src/uninstallers/integration-uninstaller.js +35 -5
- package/src/uninstallers/skills-uninstaller.js +95 -16
- package/src/uninstallers/standards-uninstaller.js +56 -7
- package/src/utils/agents-installer.js +10 -17
- package/src/utils/available-standards-report.js +144 -0
- package/src/utils/available-standards.js +216 -0
- package/src/utils/command-hash-ownership.js +103 -0
- package/src/utils/commit-message-judge.js +155 -0
- package/src/utils/copier.js +80 -2
- package/src/utils/deps-applicability.js +25 -0
- package/src/utils/detector.js +46 -1
- package/src/utils/friction-detector.js +27 -0
- package/src/utils/gate-scripts.js +141 -0
- package/src/utils/git-hooks.js +139 -7
- package/src/utils/hasher.js +36 -0
- package/src/utils/health-scorer.js +10 -7
- package/src/utils/installed-names-ownership.js +114 -0
- package/src/utils/integration-generator.js +36 -24
- package/src/utils/legacy-hook-migration.js +112 -0
- package/src/utils/locale.js +19 -0
- package/src/utils/open-work-tracking.mjs +1754 -0
- package/src/utils/prompt-closed.js +18 -0
- package/src/utils/sdd-header.js +66 -0
- package/src/utils/skill-frontmatter.js +102 -0
- package/src/utils/skill-hash-ownership.js +64 -0
- package/src/utils/skill-name-collision.js +169 -0
- package/src/utils/skills-install-paths.js +114 -0
- package/src/utils/skills-installer.js +75 -106
- package/src/utils/standard-validator.js +98 -27
- package/src/utils/test-change-check.js +160 -0
- package/src/utils/test-policy.js +214 -0
- package/src/utils/transient-fs.js +113 -0
- package/src/utils/update-summary.js +29 -0
- package/src/vibe/micro-spec.js +15 -0
- package/standards-registry.json +48 -9
|
@@ -1,17 +1,20 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../core/acceptance-criteria-traceability.md
|
|
3
|
-
source_version: 1.
|
|
4
|
-
translation_version: 1.
|
|
5
|
-
last_synced: 2026-
|
|
6
|
-
|
|
3
|
+
source_version: 1.2.0
|
|
4
|
+
translation_version: 1.2.0
|
|
5
|
+
last_synced: 2026-10-11
|
|
6
|
+
source_hash: 06ca6a77af24
|
|
7
|
+
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
9
10
|
# 验收标准可追溯性规范
|
|
10
11
|
|
|
11
|
-
> **语言**: [English](../../../core/acceptance-criteria-traceability.md) | 简体中文
|
|
12
|
+
> **语言**: [English](../../../core/acceptance-criteria-traceability.md) | [繁體中文](../../zh-TW/core/acceptance-criteria-traceability.md) | 简体中文
|
|
12
13
|
|
|
14
|
+
**版本**: 1.2.0
|
|
15
|
+
**最后更新**: 2026-08-24
|
|
13
16
|
**适用范围**: 所有使用规格驱动或测试驱动工作流程的软件项目
|
|
14
|
-
|
|
17
|
+
**范围**: universal
|
|
15
18
|
|
|
16
19
|
---
|
|
17
20
|
|
|
@@ -78,6 +81,12 @@ class TestAC1_UserLogin:
|
|
|
78
81
|
Scenario: User login with valid credentials
|
|
79
82
|
```
|
|
80
83
|
|
|
84
|
+
> **键名拼法(刻意设计,不是冲突)。** `acceptance-criteria`(kebab-case)
|
|
85
|
+
> 是给人看的/识别字拼法——文档标题、标准 id、AI 格式的键。
|
|
86
|
+
> `acceptance_criteria`(snake_case)是 YAML **序列化**字段(例如
|
|
87
|
+
> `structured-task-definition`)。`acceptanceCriteria`(camelCase)不使用。
|
|
88
|
+
> 这些是各层适用的拼法(见词汇表的字段命名表),**不予统一**。
|
|
89
|
+
|
|
81
90
|
---
|
|
82
91
|
|
|
83
92
|
## 覆盖状态定义
|
|
@@ -89,28 +98,60 @@ Scenario: User login with valid credentials
|
|
|
89
98
|
| **已覆盖** | ✅ | AC 已完整测试 | AC 中所有条件都有对应的测试断言 |
|
|
90
99
|
| **部分覆盖** | ⚠️ | AC 已部分测试 | 部分条件已测试,但缺少边界情况或执行路径 |
|
|
91
100
|
| **未覆盖** | ❌ | AC 没有测试 | 没有任何测试用例引用此 AC |
|
|
101
|
+
| **未实现** | 🚫 | AC 没有对应的实现 | 功能代码不存在(不是测试缺口,而是代码缺口) |
|
|
102
|
+
|
|
103
|
+
### `not_implemented` 与 `uncovered` 判定树
|
|
104
|
+
|
|
105
|
+
```
|
|
106
|
+
Q1: Does the corresponding code exist in src/?
|
|
107
|
+
No → 🚫 not_implemented
|
|
108
|
+
Yes → Q2: Does any test reference this AC?
|
|
109
|
+
No → ❌ uncovered
|
|
110
|
+
Yes → Q3: Are all conditions in the AC tested?
|
|
111
|
+
Yes → ✅ covered
|
|
112
|
+
No → ⚠️ partial
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
`not_implemented` 的典型信号:`throw new NotImplementedException()`、空的 stub 函数体、`// FEATURE_STUB:` 标记。
|
|
92
116
|
|
|
93
117
|
### 覆盖率计算
|
|
94
118
|
|
|
95
119
|
```
|
|
96
|
-
AC Coverage % = (covered_count / total_ac_count) × 100
|
|
120
|
+
AC Coverage % = (covered_count + partial_count × 0.5) / (total_ac_count - not_implemented_count) × 100
|
|
97
121
|
|
|
98
122
|
Where:
|
|
99
123
|
covered_count = count of AC with status "covered"
|
|
100
124
|
total_ac_count = total number of AC in specification
|
|
125
|
+
not_implemented_count = count of AC with status "not_implemented" (excluded from denominator)
|
|
101
126
|
partial counts as 0.5 for coverage calculation
|
|
102
127
|
```
|
|
103
128
|
|
|
104
129
|
### 计算范例
|
|
105
130
|
|
|
106
131
|
```
|
|
107
|
-
SPEC-001:
|
|
108
|
-
-
|
|
109
|
-
-
|
|
110
|
-
-
|
|
132
|
+
SPEC-001: 20 AC total
|
|
133
|
+
- 15 covered (✅)
|
|
134
|
+
- 0 partial (⚠️)
|
|
135
|
+
- 2 uncovered (❌)
|
|
136
|
+
- 3 not_implemented (🚫)
|
|
137
|
+
|
|
138
|
+
Coverage = (15 + 0) / (20 - 3) × 100 = 88.2%
|
|
139
|
+
Status: BLOCKED by 3 not_implemented AC(s)
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
### `not_implemented` 的 CI 闸门
|
|
143
|
+
|
|
144
|
+
`not_implemented` 的 AC 会触发一道**阻断式** CI 闸门,与覆盖率百分比闸门各自独立:
|
|
111
145
|
|
|
112
|
-
Coverage = (5 + 2×0.5) / 8 = 6/8 = 75%
|
|
113
146
|
```
|
|
147
|
+
[AC-NOT-IMPL] 3 AC(s) marked not_implemented:
|
|
148
|
+
🚫 AC-007 OrderCancellation
|
|
149
|
+
🚫 AC-012 RefundCalculation
|
|
150
|
+
🚫 AC-019 ExportToPDF
|
|
151
|
+
All not_implemented ACs must be resolved before UAT.
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
只有当所有 `not_implemented` 的 AC 都更新为 `uncovered`、`partial` 或 `covered` 时,闸门才会解除。
|
|
114
155
|
|
|
115
156
|
---
|
|
116
157
|
|
|
@@ -195,6 +236,8 @@ Coverage = (5 + 2×0.5) / 8 = 6/8 = 75%
|
|
|
195
236
|
| 基础设施限制 | 测试环境限制 | 解决方案计划 |
|
|
196
237
|
| 延后至下一迭代 | 已与利害关系人确认 | Ticket 引用 |
|
|
197
238
|
|
|
239
|
+
> 本标准产出的**延后项目**(`Gaps` 的 Uncovered AC/Partial AC、上表的例外、报告的 `Action Items`)适用 [deferred-item-exit](../../../core/deferred-item-exit.md)。
|
|
240
|
+
|
|
198
241
|
---
|
|
199
242
|
|
|
200
243
|
## AC 覆盖率报告格式
|
|
@@ -205,7 +248,7 @@ Coverage = (5 + 2×0.5) / 8 = 6/8 = 75%
|
|
|
205
248
|
# AC Coverage Report
|
|
206
249
|
|
|
207
250
|
**Specification**: SPEC-001 — User Authentication
|
|
208
|
-
**Generated**: 2026-03-
|
|
251
|
+
**Generated**: 2026-03-18
|
|
209
252
|
**Coverage**: 75% (6/8 AC)
|
|
210
253
|
|
|
211
254
|
## Summary
|
|
@@ -246,7 +289,7 @@ Coverage = (5 + 2×0.5) / 8 = 6/8 = 75%
|
|
|
246
289
|
{
|
|
247
290
|
"specId": "SPEC-001",
|
|
248
291
|
"specName": "User Authentication",
|
|
249
|
-
"generatedAt": "2026-03-
|
|
292
|
+
"generatedAt": "2026-03-18T10:00:00Z",
|
|
250
293
|
"coverage": {
|
|
251
294
|
"percentage": 75,
|
|
252
295
|
"covered": 5,
|
|
@@ -325,6 +368,8 @@ Coverage = (5 + 2×0.5) / 8 = 6/8 = 75%
|
|
|
325
368
|
| 忽略未覆盖的 AC | 验证存在缺口 | 追踪并规划所有 AC 的覆盖工作 |
|
|
326
369
|
| AC 缺乏可测试性 | 无法验证 | 确保所有 AC 都可测试 |
|
|
327
370
|
| 覆盖但缺乏断言 | 测试执行但不验证任何内容 | 确认测试含有有意义的断言 |
|
|
371
|
+
| 代码不存在却标为 `uncovered` | 掩盖功能完整性的缺口 | 代码不存在时使用 `not_implemented` |
|
|
372
|
+
| 把 `not_implemented` 计入分母 | 灌水覆盖率指标 | 将 `not_implemented` 排除于分母之外 |
|
|
328
373
|
|
|
329
374
|
---
|
|
330
375
|
|
|
@@ -343,3 +388,5 @@ Coverage = (5 + 2×0.5) / 8 = 6/8 = 75%
|
|
|
343
388
|
| 版本 | 日期 | 变更内容 |
|
|
344
389
|
|------|------|---------|
|
|
345
390
|
| 1.0.0 | 2026-03-18 | 初始版本 — 可追溯性矩阵、覆盖率计算、规格生成规则 |
|
|
391
|
+
| 1.1.0 | 2026-05-12 | 新增第 4 种状态 `not_implemented`;更新 CI 闸门公式;新增判定树(XSPEC-199) |
|
|
392
|
+
| 1.2.0 | 2026-08-24 | 为覆盖缺口、门槛例外与报告行动项目加上指向 `deferred-item-exit` 的指标(XSPEC-391 R5) |
|
|
@@ -1,17 +1,18 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../core/adr-standards.md
|
|
3
|
-
source_version: 1.
|
|
4
|
-
translation_version: 1.
|
|
5
|
-
last_synced: 2026-
|
|
6
|
-
|
|
3
|
+
source_version: 1.1.0
|
|
4
|
+
translation_version: 1.1.0
|
|
5
|
+
last_synced: 2026-10-11
|
|
6
|
+
source_hash: 929da01fb617
|
|
7
|
+
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
9
10
|
# 架构决策记录(ADR)
|
|
10
11
|
|
|
11
|
-
> **语言**: [English](../../../core/adr-standards.md) | 简体中文
|
|
12
|
+
> **语言**: [English](../../../core/adr-standards.md) | [繁體中文](../../zh-TW/core/adr-standards.md) | 简体中文
|
|
12
13
|
|
|
13
|
-
**版本**: 1.
|
|
14
|
-
**最后更新**: 2026-
|
|
14
|
+
**版本**: 1.1.0
|
|
15
|
+
**最后更新**: 2026-08-24
|
|
15
16
|
**适用范围**: 所有进行架构决策的软件项目
|
|
16
17
|
**范畴**: universal
|
|
17
18
|
**行业标准**: ISO/IEC/IEEE 42010(架构描述)、TOGAF ADR
|
|
@@ -50,38 +51,68 @@ status: stale
|
|
|
50
51
|
- **Deciders**: [参与决策者]
|
|
51
52
|
- **Technical Story**: [相关 SPEC-ID、Issue 或 PR]
|
|
52
53
|
|
|
53
|
-
## Context
|
|
54
|
+
## Context
|
|
54
55
|
|
|
55
|
-
[描述引发此决策的技术或业务背景。
|
|
56
|
+
[描述引发此决策的技术或业务背景。
|
|
57
|
+
问题或机会是什么?存在哪些限制?]
|
|
56
58
|
|
|
57
|
-
## Decision Drivers
|
|
59
|
+
## Decision Drivers
|
|
58
60
|
|
|
59
|
-
- [驱动因素 1]
|
|
60
|
-
- [驱动因素 2]
|
|
61
|
+
- [驱动因素 1:例如性能要求]
|
|
62
|
+
- [驱动因素 2:例如团队专长]
|
|
63
|
+
- [驱动因素 3:例如预算限制]
|
|
61
64
|
|
|
62
|
-
## Considered Options
|
|
65
|
+
## Considered Options
|
|
63
66
|
|
|
64
67
|
1. [选项 1]
|
|
65
68
|
2. [选项 2]
|
|
66
69
|
3. [选项 3]
|
|
67
70
|
|
|
68
|
-
## Decision Outcome
|
|
71
|
+
## Decision Outcome
|
|
69
72
|
|
|
70
73
|
选择 **[选项 N]**,因为 [理由]。
|
|
71
74
|
|
|
72
|
-
### Consequences
|
|
75
|
+
### Consequences
|
|
73
76
|
|
|
74
77
|
**Good:**
|
|
75
|
-
- [正面结果]
|
|
78
|
+
- [正面结果 1]
|
|
79
|
+
- [正面结果 2]
|
|
76
80
|
|
|
77
81
|
**Bad:**
|
|
78
|
-
- [负面结果或取舍]
|
|
82
|
+
- [负面结果或取舍 1]
|
|
83
|
+
- [接受的风险 1]
|
|
79
84
|
|
|
80
|
-
|
|
85
|
+
**Neutral:**
|
|
86
|
+
- [既非正面也非负面的副作用]
|
|
81
87
|
|
|
82
|
-
|
|
88
|
+
## Links
|
|
89
|
+
|
|
90
|
+
- [相关 ADR、SPEC、PR 或外部参考]
|
|
83
91
|
```
|
|
84
92
|
|
|
93
|
+
> 此模板中记下的**延后项目**(`Consequences` 下的既受风险与负面后果、被考虑而未采用的选项)适用 [deferred-item-exit](../../../core/deferred-item-exit.md)。
|
|
94
|
+
|
|
95
|
+
---
|
|
96
|
+
|
|
97
|
+
## 验收标准放在 SPEC 里
|
|
98
|
+
|
|
99
|
+
一份 ADR 记录的是**决策**,它不带自己的一份验收标准。当一个决策有验收标准时,
|
|
100
|
+
它们**只在一处维护——SPEC**,而 ADR 以链接(`Technical Story` 或 `Links`)指向它。
|
|
101
|
+
|
|
102
|
+
一份被复制的 AC 清单有两个拥有者,而只有其中一个会被更新。实测后果是:
|
|
103
|
+
实现完成、SPEC 的勾选框打勾,ADR 那一份**整份留在未勾选状态**——
|
|
104
|
+
读 ADR 的人于是认为什么都没做,而读 SPEC 的 AC 覆盖率工具**根本看不到 ADR 里那一份**。
|
|
105
|
+
|
|
106
|
+
> 本条是关于 **AC 在哪里维护**的边界规则,不涉及 AC 的写法或标注惯例。AC 本身的格式见 [spec-driven-development](spec-driven-development.md);AC 到验证的可追溯性见 [acceptance-criteria-traceability](acceptance-criteria-traceability.md)。
|
|
107
|
+
|
|
108
|
+
---
|
|
109
|
+
|
|
110
|
+
## ADR 编号
|
|
111
|
+
|
|
112
|
+
- 使用连续编号:`ADR-001`、`ADR-002` 等。
|
|
113
|
+
- 编号永不重复使用,即使 ADR 已被 deprecated。
|
|
114
|
+
- 多项目组织可加上项目识别前缀:`[PROJECT]-ADR-001`。
|
|
115
|
+
|
|
85
116
|
---
|
|
86
117
|
|
|
87
118
|
## 状态生命周期
|
|
@@ -96,13 +127,15 @@ Proposed ──► Accepted ──► Deprecated
|
|
|
96
127
|
|------|------|
|
|
97
128
|
| **Proposed** | 讨论中,尚未决定 |
|
|
98
129
|
| **Accepted** | 决策生效,应遵循 |
|
|
99
|
-
| **Deprecated** |
|
|
100
|
-
| **Superseded** | 已被更新的 ADR
|
|
130
|
+
| **Deprecated** | 决策不再适用(例如功能已移除) |
|
|
131
|
+
| **Superseded** | 已被更新的 ADR 取代(附上链接) |
|
|
101
132
|
|
|
102
133
|
### 规则
|
|
103
134
|
|
|
104
|
-
1.
|
|
105
|
-
2. **Deprecated**
|
|
135
|
+
1. **Proposed** 的 ADR 可以变成 **Accepted**,或被删除(若遭否决)。
|
|
136
|
+
2. **Accepted** 的 ADR 可以变成 **Deprecated** 或 **Superseded**。
|
|
137
|
+
3. **Deprecated** 和 **Superseded** 是终态。
|
|
138
|
+
4. 永远不要将 **Accepted** 的 ADR 改回 **Proposed**。改为建立新 ADR 取代它。
|
|
106
139
|
|
|
107
140
|
---
|
|
108
141
|
|
|
@@ -112,18 +145,88 @@ Proposed ──► Accepted ──► Deprecated
|
|
|
112
145
|
docs/adr/
|
|
113
146
|
├── ADR-001-use-postgresql.md
|
|
114
147
|
├── ADR-002-adopt-event-sourcing.md
|
|
115
|
-
|
|
148
|
+
├── ADR-003-migrate-to-kubernetes.md
|
|
149
|
+
└── README.md # ADR index (optional)
|
|
116
150
|
```
|
|
117
151
|
|
|
152
|
+
### 文件命名
|
|
153
|
+
|
|
118
154
|
- 格式:`ADR-NNN-short-description.md`
|
|
119
155
|
- 描述部分使用 kebab-case。
|
|
156
|
+
- 描述保持在 5 个单词以内。
|
|
157
|
+
|
|
158
|
+
### 索引文件(可选)
|
|
159
|
+
|
|
160
|
+
在 `docs/adr/` 中维护一份列出所有 ADR 的 `README.md`:
|
|
161
|
+
|
|
162
|
+
```markdown
|
|
163
|
+
# Architecture Decision Records
|
|
164
|
+
|
|
165
|
+
| ADR | Title | Status | Date |
|
|
166
|
+
|-----|-------|--------|------|
|
|
167
|
+
| [ADR-001](ADR-001-use-postgresql.md) | Use PostgreSQL | Accepted | 2026-01-15 |
|
|
168
|
+
| [ADR-002](ADR-002-adopt-event-sourcing.md) | Adopt Event Sourcing | Superseded by ADR-005 | 2026-02-01 |
|
|
169
|
+
```
|
|
170
|
+
|
|
171
|
+
---
|
|
172
|
+
|
|
173
|
+
## 取代一份 ADR
|
|
174
|
+
|
|
175
|
+
当一个决策被取代时:
|
|
176
|
+
|
|
177
|
+
1. 以更新后的决策建立新的 ADR。
|
|
178
|
+
2. 在新 ADR 中加上:`Supersedes [ADR-NNN](ADR-NNN-old-title.md)`。
|
|
179
|
+
3. 将旧 ADR 的状态更新为:`Superseded by [ADR-NNN](ADR-NNN-new-title.md)`。
|
|
180
|
+
4. 保留旧 ADR 的内容不动,作为历史背景。
|
|
181
|
+
|
|
182
|
+
---
|
|
183
|
+
|
|
184
|
+
## 与其他产物的整合
|
|
185
|
+
|
|
186
|
+
| 产物 | 整合方式 |
|
|
187
|
+
|------|---------|
|
|
188
|
+
| **SDD 规格** | 在 Technical Design 区段引用 ADR |
|
|
189
|
+
| **代码注释** | 实现不明显的模式时链接 ADR:`// See ADR-003` |
|
|
190
|
+
| **PR 描述** | 架构变更时引用相关 ADR |
|
|
191
|
+
| **Commit 消息** | 在 footer 加上 `ADR-NNN` 以便追溯 |
|
|
192
|
+
|
|
193
|
+
---
|
|
194
|
+
|
|
195
|
+
## 质量检查清单
|
|
196
|
+
|
|
197
|
+
接受一份 ADR 前,确认:
|
|
198
|
+
|
|
199
|
+
- [ ] **Context** 清楚说明问题或机会
|
|
200
|
+
- [ ] 至少考虑过 **2 个选项**
|
|
201
|
+
- [ ] 明确列出 **决策驱动因素**
|
|
202
|
+
- [ ] **Consequences** 同时包含正面与负面结果
|
|
203
|
+
- [ ] **Status** 设置正确
|
|
204
|
+
- [ ] 附上相关产物的 **Links**
|
|
205
|
+
- [ ] 文件存放在 `docs/adr/` 且命名正确
|
|
206
|
+
- [ ] **没有把验收标准复制进 ADR**——改为链接到维护它们的 SPEC
|
|
207
|
+
- [ ] 每个**延后项目**都带有其出口的识别码([deferred-item-exit](../../../core/deferred-item-exit.md))
|
|
208
|
+
|
|
209
|
+
---
|
|
210
|
+
|
|
211
|
+
## 反模式
|
|
212
|
+
|
|
213
|
+
| 反模式 | 问题 | 修正 |
|
|
214
|
+
|-------|------|------|
|
|
215
|
+
| 事后才写 ADR | 缺少真实背景与替代方案 | 在决策之前或当下撰写 ADR |
|
|
216
|
+
| ADR 太多 | 决策疲劳、噪音 | 只记录重大决策 |
|
|
217
|
+
| ADR 太少 | 知识流失、重复争论 | 遵循上方的「6 个月法则」 |
|
|
218
|
+
| 没有后果 | 分析不完整 | 一律列出正面与负面结果 |
|
|
219
|
+
| 背景模糊 | 对未来读者毫无用处 | 写出具体的限制与驱动因素 |
|
|
220
|
+
| 编辑已接受的 ADR | 历史流失 | 改为取代,而非编辑 |
|
|
221
|
+
| 把 SPEC 的验收标准复制进 ADR | 两个拥有者、只有一个被更新;ADR 那份永远未勾选,覆盖率工具也看不到 | SPEC 只保留一份,以链接指向它 |
|
|
222
|
+
| 接受的风险没有出口 | ADR 是唯一的载体,而它现在已被批准 | 给它一个出口,并在此写明该出口 |
|
|
120
223
|
|
|
121
224
|
---
|
|
122
225
|
|
|
123
226
|
## 最佳实践
|
|
124
227
|
|
|
125
228
|
1. **在决策当下撰写 ADR** — 不要等到几周后背景已遗忘。
|
|
126
|
-
2. **保持简短** — 最多 1-2
|
|
229
|
+
2. **保持简短** — 最多 1-2 页。简短才会有人写、有人读。
|
|
127
230
|
3. **包含被排除的选项** — 知道什么没有被选择与知道什么被选择一样有价值。
|
|
128
231
|
4. **双向链接** — ADR 引用代码;代码引用 ADR。
|
|
129
232
|
5. **定期审查** — 在架构审查时标记过时的 ADR 为 deprecated。
|
|
@@ -180,9 +283,9 @@ docs/adr/
|
|
|
180
283
|
|
|
181
284
|
| 状态 | 含义 | 行动 |
|
|
182
285
|
|------|------|------|
|
|
183
|
-
| **Adopt** | 已验证有效,全面采用 |
|
|
184
|
-
| **Trial** | 正在评估中,有限范围试行 |
|
|
185
|
-
| **Assess** |
|
|
286
|
+
| **Adopt** | 已验证有效,全面采用 | 列为标准实践,记录证据 |
|
|
287
|
+
| **Trial** | 正在评估中,有限范围试行 | 持续测量,维护假设书 |
|
|
288
|
+
| **Assess** | 有限条件下有效 | 记录适用边界,不扩大采用 |
|
|
186
289
|
| **Hold** | 评估无效或有害 | 停止新增采用,规划移除 |
|
|
187
290
|
|
|
188
291
|
**默认值**:所有新建借鉴型 DEC 从 `Trial` 开始。
|
|
@@ -217,9 +320,14 @@ Step 3: 判定方法本身无效
|
|
|
217
320
|
> **移除原因**: 方法本身无效 | 场景不符 | 有反效果
|
|
218
321
|
> **紧急程度**: 正常流程 | 紧急(反效果,立即停用)
|
|
219
322
|
|
|
323
|
+
---
|
|
324
|
+
|
|
220
325
|
## 移除原因
|
|
221
326
|
|
|
222
|
-
[
|
|
327
|
+
[详述为何判定此方法无效。说明已确认:
|
|
328
|
+
1. 实作正确性(已对照原始论文/Repo 确认)
|
|
329
|
+
2. 应用场景符合性(已确认场景符合论文假设)
|
|
330
|
+
3. 方法在我们环境中的实际表现]
|
|
223
331
|
|
|
224
332
|
## 诊断过程
|
|
225
333
|
|
|
@@ -229,9 +337,18 @@ Step 3: 判定方法本身无效
|
|
|
229
337
|
| Step 2 | 应用场景是否符合论文假设 | ✅ 符合 |
|
|
230
338
|
| Step 3 | 方法本身有效性 | ❌ 无效 |
|
|
231
339
|
|
|
340
|
+
## 观察到的指标
|
|
341
|
+
|
|
342
|
+
| 指标 | 借鉴前 | 借鉴后 | 预期目标 | 判定 |
|
|
343
|
+
|------|-------|-------|---------|------|
|
|
344
|
+
| [指标名称] | [基准值] | [实际值] | [目标值] | ❌ 未达成 |
|
|
345
|
+
|
|
232
346
|
## 反模式记录
|
|
233
347
|
|
|
348
|
+
> 记录此方法在我们环境中的反模式,供未来避免相同错误。
|
|
349
|
+
|
|
234
350
|
- [反模式 1: 具体描述]
|
|
351
|
+
- [反模式 2: 具体描述]
|
|
235
352
|
|
|
236
353
|
## 移除步骤
|
|
237
354
|
|
|
@@ -239,16 +356,22 @@ Step 3: 判定方法本身无效
|
|
|
239
356
|
- [ ] 移除实作代码
|
|
240
357
|
- [ ] 更新 TECH-RADAR.md:状态改为 Hold
|
|
241
358
|
- [ ] 更新原始 DEC 状态为 `Superseded by DEC-NNN-reversal`
|
|
242
|
-
- [ ] 在下次 Retrospective
|
|
359
|
+
- [ ] 在下次 Retrospective 分享学习(紧急情况除外)
|
|
243
360
|
|
|
244
361
|
## 学习点
|
|
245
362
|
|
|
246
|
-
[
|
|
363
|
+
[从此次失败借鉴中学到什么?对未来借鉴决策的启示?]
|
|
364
|
+
|
|
365
|
+
## Links
|
|
366
|
+
|
|
367
|
+
- 原始 DEC: [DEC-NNN](DEC-NNN-original-title.md)
|
|
368
|
+
- 相关 Retrospective: [链接]
|
|
369
|
+
- TECH-RADAR: [cross-project/decisions/TECH-RADAR.md](../decisions/TECH-RADAR.md)
|
|
247
370
|
```
|
|
248
371
|
|
|
249
372
|
### Reversal DEC 规则
|
|
250
373
|
|
|
251
|
-
1. **必须建立** Reversal DEC
|
|
374
|
+
1. **必须建立** Reversal DEC:当方法本身被确认无效(不只是实作错误)。
|
|
252
375
|
2. **不建立** Reversal DEC:若是实作错误,修正后重启假设书计时即可。
|
|
253
376
|
3. 原始 DEC 状态应更新为 `Superseded by DEC-NNN-reversal`。
|
|
254
377
|
4. Reversal DEC 是终态,不会再被撤销。
|
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
source: ../../../core/agent-dispatch.md
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
|
-
last_synced: 2026-
|
|
5
|
+
last_synced: 2026-10-11
|
|
6
|
+
source_hash: d18ca22786b3
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
@@ -59,55 +60,89 @@ Prompt 包含执行所需的完整上下文,代理不需要额外提问或搜
|
|
|
59
60
|
|
|
60
61
|
---
|
|
61
62
|
|
|
62
|
-
##
|
|
63
|
+
## 状态协议
|
|
63
64
|
|
|
64
|
-
|
|
65
|
+
每个子代理完成时必须回报以下四种状态之一:
|
|
65
66
|
|
|
66
|
-
|
|
|
67
|
-
|
|
68
|
-
|
|
|
69
|
-
|
|
|
70
|
-
|
|
|
67
|
+
| 状态 | 说明 | 编排器动作 |
|
|
68
|
+
|------|------|-----------|
|
|
69
|
+
| `DONE` | 任务成功完成 | 继续下一个任务 |
|
|
70
|
+
| `DONE_WITH_CONCERNS` | 已完成,但有需要记录的疑虑 | 记录疑虑,继续 |
|
|
71
|
+
| `NEEDS_CONTEXT` | 需要更多上下文才能完成 | 注入上下文,重新派遣(不是重试) |
|
|
72
|
+
| `BLOCKED` | 无法完成,需要升级处理 | 升级模型等级或拆分任务 |
|
|
71
73
|
|
|
72
|
-
|
|
74
|
+
### 状态判定流程
|
|
73
75
|
|
|
74
|
-
|
|
76
|
+
```
|
|
77
|
+
Agent completes work
|
|
78
|
+
├── All acceptance criteria met? → DONE
|
|
79
|
+
├── Criteria met but concerns exist? → DONE_WITH_CONCERNS
|
|
80
|
+
├── Missing information to proceed? → NEEDS_CONTEXT
|
|
81
|
+
└── Fundamentally unable to complete? → BLOCKED
|
|
82
|
+
```
|
|
75
83
|
|
|
76
|
-
|
|
77
|
-
|------|------|---------|
|
|
78
|
-
| `SUCCESS` | 任务完成,所有验证通过 | 整合结果 |
|
|
79
|
-
| `FAILED` | 任务失败,附带错误详情 | 分析失败原因 |
|
|
80
|
-
| `BLOCKED` | 任务被外部依赖阻塞 | 解除阻塞后重试 |
|
|
81
|
-
| `PARTIAL` | 部分完成,附带进度说明 | 评估是否继续 |
|
|
84
|
+
---
|
|
82
85
|
|
|
83
|
-
##
|
|
86
|
+
## 冲突检测
|
|
84
87
|
|
|
85
|
-
|
|
88
|
+
并行代理返回时,编排器必须:
|
|
89
|
+
|
|
90
|
+
1. **检查文件冲突** — 是否有多个代理修改了同一文件?
|
|
91
|
+
2. **运行完整测试套件** — 合并所有变更后验证集成
|
|
92
|
+
3. **解决冲突** — 自动解决,或标记交由人工审查
|
|
86
93
|
|
|
87
94
|
```
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
95
|
+
Agent A (modifies: src/auth.ts, src/auth.test.ts) ─┐
|
|
96
|
+
├─→ Conflict check → Integration test
|
|
97
|
+
Agent B (modifies: src/api.ts, src/api.test.ts) ─┘
|
|
91
98
|
```
|
|
92
99
|
|
|
93
|
-
|
|
100
|
+
---
|
|
101
|
+
|
|
102
|
+
## 规则
|
|
94
103
|
|
|
95
|
-
|
|
|
96
|
-
|
|
97
|
-
|
|
|
98
|
-
|
|
|
99
|
-
|
|
|
104
|
+
| ID | 触发条件 | 动作 | 优先级 |
|
|
105
|
+
|----|---------|------|--------|
|
|
106
|
+
| AD-001 | 多个代理编辑同一文件 | 标记冲突,要求合并解决 | Critical |
|
|
107
|
+
| AD-002 | 代理回报 BLOCKED | 升级模型等级并重试一次 | High |
|
|
108
|
+
| AD-003 | 所有并行代理完成 | 运行完整测试套件验证集成 | High |
|
|
100
109
|
|
|
101
110
|
---
|
|
102
111
|
|
|
103
|
-
##
|
|
112
|
+
## 示例
|
|
104
113
|
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
114
|
+
### 正确:并行的独立任务
|
|
115
|
+
|
|
116
|
+
```yaml
|
|
117
|
+
# Two agents working on independent modules
|
|
118
|
+
Agent 1:
|
|
119
|
+
task: "Add rate limiting to /api/users endpoint"
|
|
120
|
+
files: [src/api/users.ts, src/api/users.test.ts]
|
|
121
|
+
|
|
122
|
+
Agent 2:
|
|
123
|
+
task: "Add caching to /api/products endpoint"
|
|
124
|
+
files: [src/api/products.ts, src/api/products.test.ts]
|
|
125
|
+
|
|
126
|
+
# No shared files → safe to parallelize
|
|
127
|
+
```
|
|
128
|
+
|
|
129
|
+
### 错误:并行的相依任务
|
|
130
|
+
|
|
131
|
+
```yaml
|
|
132
|
+
# Two agents modifying shared state
|
|
133
|
+
Agent 1:
|
|
134
|
+
task: "Refactor database connection pool"
|
|
135
|
+
files: [src/db.ts] # ⚠️ shared file
|
|
136
|
+
|
|
137
|
+
Agent 2:
|
|
138
|
+
task: "Add connection retry logic"
|
|
139
|
+
files: [src/db.ts] # ⚠️ conflict!
|
|
140
|
+
```
|
|
108
141
|
|
|
109
142
|
---
|
|
110
143
|
|
|
111
|
-
##
|
|
144
|
+
## 参考资料
|
|
112
145
|
|
|
113
|
-
|
|
146
|
+
- **Superpowers**: [dispatching-parallel-agents](https://github.com/obra/superpowers), [subagent-driven-development](https://github.com/obra/superpowers) (MIT)
|
|
147
|
+
- **MapReduce**: 概念性的并行执行模型
|
|
148
|
+
- **Actor Model**: 独立代理的通信模式
|
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
source: ../../../core/ai-agreement-standards.md
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
|
-
last_synced: 2026-
|
|
5
|
+
last_synced: 2026-10-11
|
|
6
|
+
source_hash: 9238a5b53f4e
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
@@ -22,7 +23,7 @@ status: current
|
|
|
22
23
|
|
|
23
24
|
## 目的
|
|
24
25
|
|
|
25
|
-
本标准将人类(获取方)与 AI(供应方)之间的交互形式化为可验证的协议。在 "Vibe Coding" 中,prompt
|
|
26
|
+
本标准将人类(获取方)与 AI(供应方)之间的交互形式化为可验证的协议。在 "Vibe Coding" 中,prompt 上下文即为约束 AI 行为和交付物的法律合约。
|
|
26
27
|
|
|
27
28
|
---
|
|
28
29
|
|
|
@@ -66,38 +67,38 @@ status: current
|
|
|
66
67
|
# 交付要求
|
|
67
68
|
1. [要求 A]
|
|
68
69
|
2. [要求 B]
|
|
70
|
+
|
|
71
|
+
# 验证计划
|
|
72
|
+
- [ ] [测试用例 1]
|
|
73
|
+
- [ ] [测试用例 2]
|
|
69
74
|
```
|
|
70
75
|
|
|
71
76
|
---
|
|
72
77
|
|
|
73
|
-
## 3.
|
|
74
|
-
|
|
75
|
-
### 3.1 范围变更协议
|
|
76
|
-
|
|
77
|
-
| 变更类型 | 处理方式 |
|
|
78
|
-
|---------|---------|
|
|
79
|
-
| **范围内** | 直接实现 |
|
|
80
|
-
| **小范围外** | 提出建议,等待确认 |
|
|
81
|
-
| **大范围外** | 暂停,要求新的 RFP |
|
|
82
|
-
|
|
83
|
-
### 3.2 冲突解决
|
|
78
|
+
## 3. 交付验收
|
|
84
79
|
|
|
85
|
-
|
|
80
|
+
### 3.1 AI 自我验证
|
|
81
|
+
在输出代码前,AI(供应方)必须依据上下文合约验证自己的输出:
|
|
82
|
+
- 这段代码是否违反任何约束法则?
|
|
83
|
+
- 是否满足所有验收条件?
|
|
86
84
|
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
85
|
+
### 3.2 人类签核
|
|
86
|
+
用户(获取方)在应用"交付物"(AI 输出)之前,必须严格审查:
|
|
87
|
+
- **审查**:阅读代码(不要直接信任)。
|
|
88
|
+
- **验证**:执行验证计划。
|
|
89
|
+
- **接受**:仅在验证通过后才提交变更。
|
|
91
90
|
|
|
92
91
|
---
|
|
93
92
|
|
|
94
93
|
## 相关标准
|
|
95
94
|
|
|
96
|
-
- [
|
|
97
|
-
- [
|
|
95
|
+
- [防幻觉协议](anti-hallucination.md)
|
|
96
|
+
- [需求工程](requirement-engineering.md)
|
|
98
97
|
|
|
99
98
|
---
|
|
100
99
|
|
|
101
|
-
##
|
|
100
|
+
## 版本历史
|
|
102
101
|
|
|
103
|
-
|
|
102
|
+
| 版本 | 日期 | 变更内容 |
|
|
103
|
+
|------|------|---------|
|
|
104
|
+
| 1.0.0 | 2026-01-29 | 初始发布,对应 ISO 12207 协议过程 |
|