universal-dev-standards 6.14.0-beta.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 +196 -11
- package/bundled/ai/standards/pipeline-security-gates.ai.yaml +53 -4
- package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
- 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 +157 -17
- package/bundled/core/pipeline-security-gates.md +63 -0
- package/bundled/core/project-context-memory.md +10 -2
- 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/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 +199 -3
- package/bundled/locales/zh-CN/README.md +3 -3
- package/bundled/locales/zh-CN/SECURITY.md +3 -2
- 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/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 +9 -3
- package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +68 -33
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +29 -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 +199 -3
- package/bundled/locales/zh-TW/README.md +3 -3
- package/bundled/locales/zh-TW/SECURITY.md +3 -2
- 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 +92 -16
- 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/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 +9 -3
- package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +61 -26
- package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +29 -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 +159 -48
- 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 +236 -27
- 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 +220 -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
|
@@ -2,16 +2,17 @@
|
|
|
2
2
|
source: ../../../core/database-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: b21566b7d853
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
9
10
|
# 数据库标准
|
|
10
11
|
|
|
11
|
-
> **语言**: [English](../../../core/database-standards.md) | 简体中文
|
|
12
|
-
|
|
13
|
-
> 版本: 1.0.0 | 最后更新: 2026-03-18
|
|
12
|
+
> **语言**: [English](../../../core/database-standards.md) | [繁體中文](../../zh-TW/core/database-standards.md) | 简体中文
|
|
14
13
|
|
|
14
|
+
**版本**: 1.0.0
|
|
15
|
+
**最后更新**: 2026-03-18
|
|
15
16
|
**适用性**: 所有软件项目
|
|
16
17
|
**范围**: universal
|
|
17
18
|
**产业标准**: ISO/IEC 9075 (SQL)、ACID 特性、BASE 定理
|
|
@@ -21,11 +22,11 @@ status: current
|
|
|
21
22
|
|
|
22
23
|
## 目的
|
|
23
24
|
|
|
24
|
-
本标准定义数据库设计、查询、迁移与运维的指导方针,涵盖关系型与非关系型数据库。包含 Schema
|
|
25
|
+
本标准定义数据库设计、查询、迁移与运维的指导方针,涵盖关系型与非关系型数据库。包含 Schema 设计原则、索引策略、迁移工作流程、查询优化、事务管理与数据完整性 — 确保数据库具备高性能、可维护且安全的特性。
|
|
25
26
|
|
|
26
27
|
**参考标准**:
|
|
27
28
|
- [ISO/IEC 9075 — SQL 标准](https://www.iso.org/standard/76583.html)
|
|
28
|
-
- [Use The Index, Luke — SQL
|
|
29
|
+
- [Use The Index, Luke — SQL 索引与调优](https://use-the-index-luke.com/)
|
|
29
30
|
- [Martin Fowler — 演进式数据库设计](https://martinfowler.com/articles/evodb.html)
|
|
30
31
|
- [Designing Data-Intensive Applications (Martin Kleppmann)](https://dataintensive.net/)
|
|
31
32
|
|
|
@@ -38,7 +39,7 @@ status: current
|
|
|
38
39
|
| **数据完整性优先** | 约束、验证与引用完整性在数据库层级强制执行,而非仅在应用代码 |
|
|
39
40
|
| **Schema 即代码** | 数据库 Schema 通过迁移脚本进行版本控制且可重现 |
|
|
40
41
|
| **最小权限** | 数据库账号使用其功能所需的最低权限 |
|
|
41
|
-
|
|
|
42
|
+
| **先测量再调优** | 使用 EXPLAIN 计划与指标后再进行优化;避免过早优化 |
|
|
42
43
|
| **纵深防御** | 在多个层级使用加密、遮蔽与访问控制来保护敏感数据 |
|
|
43
44
|
| **向后兼容** | Schema 变更必须在部署窗口期间维持向后兼容 |
|
|
44
45
|
|
|
@@ -48,7 +49,7 @@ status: current
|
|
|
48
49
|
|
|
49
50
|
### 正规化
|
|
50
51
|
|
|
51
|
-
|
|
52
|
+
应用正规化以消除冗余并确保数据完整性。以第三正规形式(3NF)作为事务系统的基准。
|
|
52
53
|
|
|
53
54
|
| 正规形式 | 规则 | 违反范例 |
|
|
54
55
|
|----------|------|----------|
|
|
@@ -71,7 +72,7 @@ status: current
|
|
|
71
72
|
**进行反正规化时:**
|
|
72
73
|
- 记录数据来源(source of truth)与同步机制
|
|
73
74
|
- 加入注释说明选择反正规化的原因
|
|
74
|
-
-
|
|
75
|
+
- 实现一致性检查或对账作业
|
|
75
76
|
|
|
76
77
|
### 命名惯例
|
|
77
78
|
|
|
@@ -118,7 +119,7 @@ status: current
|
|
|
118
119
|
| 分布式生成 | 需要协调 | 无需协调 |
|
|
119
120
|
| 安全性 | 可预测(可枚举) | 不可猜测 |
|
|
120
121
|
| URL 暴露 | 揭露记录数量 | 可安全用于公开 URL |
|
|
121
|
-
|
|
|
122
|
+
| 合并/复制 | 容易冲突 | 无冲突 |
|
|
122
123
|
|
|
123
124
|
**建议:**
|
|
124
125
|
- 单一数据库系统的内部 ID 使用**自动递增**
|
|
@@ -126,14 +127,14 @@ status: current
|
|
|
126
127
|
- 新项目考虑以 **UUIDv7** 为默认 — 兼具可排序性与唯一性
|
|
127
128
|
|
|
128
129
|
```sql
|
|
129
|
-
-- PostgreSQL
|
|
130
|
+
-- PostgreSQL: UUIDv7 as primary key
|
|
130
131
|
CREATE TABLE user_account (
|
|
131
132
|
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
|
|
132
133
|
email VARCHAR(255) NOT NULL,
|
|
133
134
|
created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
|
|
134
135
|
);
|
|
135
136
|
|
|
136
|
-
--
|
|
137
|
+
-- Auto-increment alternative
|
|
137
138
|
CREATE TABLE user_account (
|
|
138
139
|
id BIGSERIAL PRIMARY KEY,
|
|
139
140
|
public_id UUID NOT NULL DEFAULT gen_random_uuid(),
|
|
@@ -161,13 +162,13 @@ CREATE TABLE user_account (
|
|
|
161
162
|
复合索引的字段顺序影响重大。遵循**等值优先、范围最后**规则:
|
|
162
163
|
|
|
163
164
|
```sql
|
|
164
|
-
--
|
|
165
|
+
-- Query pattern:
|
|
165
166
|
-- WHERE status = 'active' AND created_at > '2026-01-01' ORDER BY created_at
|
|
166
167
|
|
|
167
|
-
--
|
|
168
|
+
-- GOOD: equality columns first, range/sort columns last
|
|
168
169
|
CREATE INDEX idx_order_status_created ON order_record (status, created_at);
|
|
169
170
|
|
|
170
|
-
--
|
|
171
|
+
-- BAD: range column first eliminates effectiveness for equality filter
|
|
171
172
|
CREATE INDEX idx_order_created_status ON order_record (created_at, status);
|
|
172
173
|
```
|
|
173
174
|
|
|
@@ -182,9 +183,9 @@ CREATE INDEX idx_order_created_status ON order_record (created_at, status);
|
|
|
182
183
|
覆盖索引包含查询所需的所有字段,实现仅索引扫描:
|
|
183
184
|
|
|
184
185
|
```sql
|
|
185
|
-
--
|
|
186
|
+
-- Query: SELECT email, first_name FROM user_account WHERE status = 'active';
|
|
186
187
|
|
|
187
|
-
--
|
|
188
|
+
-- Covering index — no table lookup needed
|
|
188
189
|
CREATE INDEX idx_user_account_status_covering
|
|
189
190
|
ON user_account (status) INCLUDE (email, first_name);
|
|
190
191
|
```
|
|
@@ -194,12 +195,12 @@ CREATE INDEX idx_user_account_status_covering
|
|
|
194
195
|
对数据行的子集创建索引,以减少索引大小并改善写入性能:
|
|
195
196
|
|
|
196
197
|
```sql
|
|
197
|
-
--
|
|
198
|
+
-- Only index active records (90% of queries filter on active)
|
|
198
199
|
CREATE INDEX idx_order_active
|
|
199
200
|
ON order_record (created_at)
|
|
200
201
|
WHERE status = 'active';
|
|
201
202
|
|
|
202
|
-
--
|
|
203
|
+
-- Only index non-null values
|
|
203
204
|
CREATE INDEX idx_user_account_phone
|
|
204
205
|
ON user_account (phone_number)
|
|
205
206
|
WHERE phone_number IS NOT NULL;
|
|
@@ -217,10 +218,10 @@ CREATE INDEX idx_user_account_phone
|
|
|
217
218
|
| **索引字段上使用函数** | 索引被绕过 | 创建函数/表达式索引 |
|
|
218
219
|
|
|
219
220
|
```sql
|
|
220
|
-
--
|
|
221
|
+
-- Anti-pattern: function prevents index usage
|
|
221
222
|
SELECT * FROM user_account WHERE LOWER(email) = 'test@example.com';
|
|
222
223
|
|
|
223
|
-
--
|
|
224
|
+
-- Solution: expression index
|
|
224
225
|
CREATE INDEX idx_user_account_email_lower ON user_account (LOWER(email));
|
|
225
226
|
```
|
|
226
227
|
|
|
@@ -243,7 +244,7 @@ CREATE INDEX idx_user_account_email_lower ON user_account (LOWER(email));
|
|
|
243
244
|
```
|
|
244
245
|
YYYYMMDDHHMMSS_description.sql
|
|
245
246
|
|
|
246
|
-
|
|
247
|
+
Examples:
|
|
247
248
|
20260318120000_create_user_account_table.sql
|
|
248
249
|
20260318120100_add_email_index_to_user_account.sql
|
|
249
250
|
20260318120200_add_phone_column_to_user_account.sql
|
|
@@ -264,21 +265,21 @@ YYYYMMDDHHMMSS_description.sql
|
|
|
264
265
|
|
|
265
266
|
**第一阶段 — Expand(向后兼容)**
|
|
266
267
|
```sql
|
|
267
|
-
--
|
|
268
|
+
-- Add new column (nullable, no constraint yet)
|
|
268
269
|
ALTER TABLE user_account ADD COLUMN phone VARCHAR(20);
|
|
269
270
|
```
|
|
270
271
|
|
|
271
272
|
**第二阶段 — Migrate(双写)**
|
|
272
273
|
```sql
|
|
273
|
-
--
|
|
274
|
+
-- Backfill existing data
|
|
274
275
|
UPDATE user_account SET phone = legacy_phone WHERE phone IS NULL;
|
|
275
276
|
```
|
|
276
277
|
|
|
277
278
|
**第三阶段 — Contract(所有消费者更新后)**
|
|
278
279
|
```sql
|
|
279
|
-
--
|
|
280
|
+
-- Add constraint now that all data is populated
|
|
280
281
|
ALTER TABLE user_account ALTER COLUMN phone SET NOT NULL;
|
|
281
|
-
--
|
|
282
|
+
-- Drop old column (only after verifying no consumers use it)
|
|
282
283
|
ALTER TABLE user_account DROP COLUMN legacy_phone;
|
|
283
284
|
```
|
|
284
285
|
|
|
@@ -304,17 +305,17 @@ ALTER TABLE user_account DROP COLUMN legacy_phone;
|
|
|
304
305
|
N+1 问题发生在代码执行一个查询获取清单,再对每个项目额外执行 N 个查询。
|
|
305
306
|
|
|
306
307
|
```sql
|
|
307
|
-
-- N+1
|
|
308
|
-
--
|
|
309
|
-
--
|
|
308
|
+
-- N+1 PROBLEM (application issues N queries)
|
|
309
|
+
-- Query 1: SELECT * FROM order_record WHERE user_id = 42;
|
|
310
|
+
-- Query 2..N: SELECT * FROM order_item WHERE order_id = ?; (for each order)
|
|
310
311
|
|
|
311
|
-
--
|
|
312
|
+
-- SOLUTION: JOIN or subquery
|
|
312
313
|
SELECT o.*, oi.*
|
|
313
314
|
FROM order_record o
|
|
314
315
|
JOIN order_item oi ON oi.order_id = o.id
|
|
315
316
|
WHERE o.user_id = 42;
|
|
316
317
|
|
|
317
|
-
--
|
|
318
|
+
-- Or batch loading
|
|
318
319
|
SELECT * FROM order_item
|
|
319
320
|
WHERE order_id IN (SELECT id FROM order_record WHERE user_id = 42);
|
|
320
321
|
```
|
|
@@ -332,11 +333,11 @@ WHERE order_id IN (SELECT id FROM order_record WHERE user_id = 42);
|
|
|
332
333
|
EXPLAIN (ANALYZE, BUFFERS, FORMAT TEXT)
|
|
333
334
|
SELECT * FROM order_record WHERE status = 'pending' AND created_at > '2026-01-01';
|
|
334
335
|
|
|
335
|
-
--
|
|
336
|
-
--
|
|
337
|
-
--
|
|
338
|
-
--
|
|
339
|
-
--
|
|
336
|
+
-- Key indicators to watch:
|
|
337
|
+
-- Seq Scan on large tables → missing index
|
|
338
|
+
-- Nested Loop with high rows → consider Hash Join
|
|
339
|
+
-- Sort with high cost → add index matching ORDER BY
|
|
340
|
+
-- Rows (estimated vs actual) → stale statistics, run ANALYZE
|
|
340
341
|
```
|
|
341
342
|
|
|
342
343
|
### 分页
|
|
@@ -347,16 +348,16 @@ SELECT * FROM order_record WHERE status = 'pending' AND created_at > '2026-01-01
|
|
|
347
348
|
| **Keyset(游标)分页** | 性能一致、结果稳定 | 无法随机跳页、多字段排序时较复杂 | API、无限滚动、大型数据集 |
|
|
348
349
|
|
|
349
350
|
```sql
|
|
350
|
-
-- Offset
|
|
351
|
+
-- Offset-based (avoid for large tables)
|
|
351
352
|
SELECT * FROM order_record ORDER BY id LIMIT 20 OFFSET 10000;
|
|
352
|
-
--
|
|
353
|
+
-- Performance degrades: DB must scan and discard 10,000 rows
|
|
353
354
|
|
|
354
|
-
-- Keyset
|
|
355
|
+
-- Keyset-based (preferred)
|
|
355
356
|
SELECT * FROM order_record
|
|
356
357
|
WHERE id > :last_seen_id
|
|
357
358
|
ORDER BY id
|
|
358
359
|
LIMIT 20;
|
|
359
|
-
--
|
|
360
|
+
-- Consistent performance regardless of page depth
|
|
360
361
|
```
|
|
361
362
|
|
|
362
363
|
### 查询反模式
|
|
@@ -371,10 +372,10 @@ LIMIT 20;
|
|
|
371
372
|
| `LIKE '%prefix'` | 前导通配符阻止索引使用 | 使用全文搜索或反向索引 |
|
|
372
373
|
|
|
373
374
|
```sql
|
|
374
|
-
--
|
|
375
|
+
-- ANTI-PATTERN: SQL injection risk
|
|
375
376
|
query = "SELECT * FROM user_account WHERE email = '" + email + "'";
|
|
376
377
|
|
|
377
|
-
--
|
|
378
|
+
-- CORRECT: Parameterized query
|
|
378
379
|
query = "SELECT * FROM user_account WHERE email = $1";
|
|
379
380
|
params = [email];
|
|
380
381
|
```
|
|
@@ -409,15 +410,15 @@ params = [email];
|
|
|
409
410
|
|------|----------|
|
|
410
411
|
| **一致的锁定顺序** | 在所有事务中以相同顺序获取数据表/行的锁定 |
|
|
411
412
|
| **短事务** | 尽可能保持事务简短;将非数据库工作移出事务外 |
|
|
412
|
-
| **锁定超时** |
|
|
413
|
+
| **锁定超时** | 设置 `lock_timeout` 以快速失败而非无限等待 |
|
|
413
414
|
| **重试逻辑** | 对死锁错误(SQLSTATE 40P01)实现指数退避重试 |
|
|
414
415
|
| **避免用户交互** | 绝不在等待用户输入时保持事务开启 |
|
|
415
416
|
|
|
416
417
|
```sql
|
|
417
|
-
--
|
|
418
|
+
-- Set lock timeout to prevent indefinite waiting
|
|
418
419
|
SET lock_timeout = '5s';
|
|
419
420
|
|
|
420
|
-
--
|
|
421
|
+
-- Keep transactions short
|
|
421
422
|
BEGIN;
|
|
422
423
|
UPDATE account SET balance = balance - 100 WHERE id = 1;
|
|
423
424
|
UPDATE account SET balance = balance + 100 WHERE id = 2;
|
|
@@ -435,16 +436,16 @@ COMMIT;
|
|
|
435
436
|
| 死锁风险 | 无 | 可能 |
|
|
436
437
|
|
|
437
438
|
```sql
|
|
438
|
-
--
|
|
439
|
+
-- Optimistic locking
|
|
439
440
|
UPDATE order_record
|
|
440
441
|
SET status = 'shipped', version = version + 1
|
|
441
442
|
WHERE id = 42 AND version = 3;
|
|
442
|
-
--
|
|
443
|
+
-- If affected rows = 0, another transaction modified it → retry or error
|
|
443
444
|
|
|
444
|
-
--
|
|
445
|
+
-- Pessimistic locking
|
|
445
446
|
BEGIN;
|
|
446
447
|
SELECT * FROM order_record WHERE id = 42 FOR UPDATE;
|
|
447
|
-
--
|
|
448
|
+
-- Row is locked; other transactions wait
|
|
448
449
|
UPDATE order_record SET status = 'shipped' WHERE id = 42;
|
|
449
450
|
COMMIT;
|
|
450
451
|
```
|
|
@@ -455,7 +456,7 @@ COMMIT;
|
|
|
455
456
|
|
|
456
457
|
| 判断条件 | 关系型 (SQL) | 文档型 (NoSQL) | 键值型 | 图形型 |
|
|
457
458
|
|----------|-------------|---------------|--------|--------|
|
|
458
|
-
| **数据结构** | 结构化、明确定义的 Schema | 半结构化、弹性 Schema | 简单的 key→value 配对 |
|
|
459
|
+
| **数据结构** | 结构化、明确定义的 Schema | 半结构化、弹性 Schema | 简单的 key→value 配对 | 高度关联的实体 |
|
|
459
460
|
| **一致性** | 强一致(ACID) | 最终一致(BASE),部分支持 ACID | 最终一致 | 依实现而异 |
|
|
460
461
|
| **查询复杂度** | 复杂 JOIN、聚合 | 简单查询、嵌套文档 | 单键查询 | 关系遍历 |
|
|
461
462
|
| **扩展模式** | 垂直扩展(scale-up) | 水平扩展(scale-out) | 水平扩展 | 依实现而异 |
|
|
@@ -466,13 +467,13 @@ COMMIT;
|
|
|
466
467
|
### 决策指南
|
|
467
468
|
|
|
468
469
|
```
|
|
469
|
-
|
|
470
|
-
├──
|
|
471
|
-
└──
|
|
472
|
-
├──
|
|
473
|
-
└──
|
|
474
|
-
├──
|
|
475
|
-
└──
|
|
470
|
+
Is your data highly relational with complex queries?
|
|
471
|
+
├── Yes → Relational (SQL)
|
|
472
|
+
└── No → Is your data simple key-value pairs?
|
|
473
|
+
├── Yes → Key-Value store
|
|
474
|
+
└── No → Are relationships the primary query pattern?
|
|
475
|
+
├── Yes → Graph database
|
|
476
|
+
└── No → Document database
|
|
476
477
|
```
|
|
477
478
|
|
|
478
479
|
**Polyglot Persistence(多语言持久化):** 许多系统受益于使用多种数据库类型。范例:
|
|
@@ -505,10 +506,10 @@ COMMIT;
|
|
|
505
506
|
```
|
|
506
507
|
pool_size = (core_count * 2) + effective_spindle_count
|
|
507
508
|
|
|
508
|
-
|
|
509
|
-
- 4
|
|
510
|
-
- 8
|
|
511
|
-
- 4
|
|
509
|
+
Examples:
|
|
510
|
+
- 4-core server, SSD: (4 * 2) + 1 = 9-10 connections
|
|
511
|
+
- 8-core server, SSD: (8 * 2) + 1 = 17 connections
|
|
512
|
+
- 4-core server, 4 HDDs: (4 * 2) + 4 = 12 connections
|
|
512
513
|
```
|
|
513
514
|
|
|
514
515
|
**重要:** 更多连接不一定更好。过多连接会导致:
|
|
@@ -519,13 +520,13 @@ pool_size = (core_count * 2) + effective_spindle_count
|
|
|
519
520
|
### 健康检查
|
|
520
521
|
|
|
521
522
|
```sql
|
|
522
|
-
--
|
|
523
|
+
-- Basic health check
|
|
523
524
|
SELECT 1;
|
|
524
525
|
|
|
525
|
-
--
|
|
526
|
+
-- Advanced health check (verify read/write capability)
|
|
526
527
|
SELECT NOW();
|
|
527
528
|
|
|
528
|
-
--
|
|
529
|
+
-- Connection validation before use
|
|
529
530
|
SET statement_timeout = '2s';
|
|
530
531
|
SELECT 1;
|
|
531
532
|
```
|
|
@@ -576,20 +577,20 @@ CREATE TABLE order_record (
|
|
|
576
577
|
| 因素 | 软删除 | 硬删除 |
|
|
577
578
|
|------|--------|--------|
|
|
578
579
|
| 实现方式 | `deleted_at TIMESTAMPTZ` 字段 | `DELETE FROM table` |
|
|
579
|
-
| 数据恢复 | 简单 —
|
|
580
|
+
| 数据恢复 | 简单 — 设置 `deleted_at = NULL` | 需从备份还原 |
|
|
580
581
|
| 查询复杂度 | 每处都须加 `WHERE deleted_at IS NULL` | 查询较简单 |
|
|
581
582
|
| 存储 | 随时间增长 | 回收空间 |
|
|
582
583
|
| 合规性 | 保留审计轨迹 | 可能违反保留要求 |
|
|
583
584
|
| 性能 | 大量软删除行的大型数据表 | 更干净的表统计数据 |
|
|
584
585
|
|
|
585
586
|
```sql
|
|
586
|
-
--
|
|
587
|
+
-- Soft delete implementation
|
|
587
588
|
ALTER TABLE user_account ADD COLUMN deleted_at TIMESTAMPTZ;
|
|
588
589
|
|
|
589
|
-
--
|
|
590
|
+
-- Create partial index for active records
|
|
590
591
|
CREATE INDEX idx_user_account_active ON user_account (email) WHERE deleted_at IS NULL;
|
|
591
592
|
|
|
592
|
-
--
|
|
593
|
+
-- Application query pattern
|
|
593
594
|
SELECT * FROM user_account WHERE deleted_at IS NULL AND email = $1;
|
|
594
595
|
```
|
|
595
596
|
|
|
@@ -611,17 +612,17 @@ SELECT * FROM user_account WHERE deleted_at IS NULL AND email = $1;
|
|
|
611
612
|
|
|
612
613
|
| 指标 | 定义 | 目标范例 |
|
|
613
614
|
|------|------|----------|
|
|
614
|
-
| **RPO**(恢复点目标) | 可接受的最大数据损失(时间) | 1 小时:每小时备份;0
|
|
615
|
+
| **RPO**(恢复点目标) | 可接受的最大数据损失(时间) | 1 小时:每小时备份;0:持续复制 |
|
|
615
616
|
| **RTO**(恢复时间目标) | 可接受的最大停机时间 | 15 分钟:自动容错切换;4 小时:手动还原 |
|
|
616
617
|
|
|
617
|
-
###
|
|
618
|
+
### 备份调度建议
|
|
618
619
|
|
|
619
620
|
| 层级 | RPO | RTO | 策略 |
|
|
620
621
|
|------|-----|-----|------|
|
|
621
|
-
| **关键**(财务、医疗) | < 1 分钟 | < 15 分钟 |
|
|
622
|
-
| **重要**(电子商务、SaaS) | < 1 小时 | < 1 小时 |
|
|
622
|
+
| **关键**(财务、医疗) | < 1 分钟 | < 15 分钟 | 同步复制 + 持续 WAL 归档 |
|
|
623
|
+
| **重要**(电子商务、SaaS) | < 1 小时 | < 1 小时 | 流式复制 + 每小时 WAL 归档 |
|
|
623
624
|
| **标准**(内部工具) | < 24 小时 | < 4 小时 | 每日完整 + 每小时增量 |
|
|
624
|
-
|
|
|
625
|
+
| **低**(开发、预发布环境) | < 1 周 | < 1 天 | 每周完整备份 |
|
|
625
626
|
|
|
626
627
|
### 备份测试
|
|
627
628
|
|
|
@@ -629,7 +630,7 @@ SELECT * FROM user_account WHERE deleted_at IS NULL AND email = $1;
|
|
|
629
630
|
|------|------|
|
|
630
631
|
| 还原测试至独立环境 | 每月 |
|
|
631
632
|
| 还原后验证数据完整性 | 每次还原测试 |
|
|
632
|
-
|
|
|
633
|
+
| 测量实际 RTO vs 目标 | 每季 |
|
|
633
634
|
| 测试时间点恢复 | 每半年 |
|
|
634
635
|
| 更新文档与执行手册 | 每次测试后 |
|
|
635
636
|
|
|
@@ -640,11 +641,11 @@ SELECT * FROM user_account WHERE deleted_at IS NULL AND email = $1;
|
|
|
640
641
|
### 字段层级加密
|
|
641
642
|
|
|
642
643
|
```sql
|
|
643
|
-
--
|
|
644
|
+
-- Encrypt at write time
|
|
644
645
|
INSERT INTO user_account (email, ssn_encrypted)
|
|
645
646
|
VALUES ($1, pgp_sym_encrypt($2, $encryption_key));
|
|
646
647
|
|
|
647
|
-
--
|
|
648
|
+
-- Decrypt at read time (only by authorized roles)
|
|
648
649
|
SELECT email, pgp_sym_decrypt(ssn_encrypted, $encryption_key) AS ssn
|
|
649
650
|
FROM user_account WHERE id = $1;
|
|
650
651
|
```
|
|
@@ -661,7 +662,7 @@ FROM user_account WHERE id = $1;
|
|
|
661
662
|
### 数据遮蔽
|
|
662
663
|
|
|
663
664
|
```sql
|
|
664
|
-
--
|
|
665
|
+
-- View-based masking for support staff
|
|
665
666
|
CREATE VIEW user_account_masked AS
|
|
666
667
|
SELECT
|
|
667
668
|
id,
|
|
@@ -671,7 +672,7 @@ SELECT
|
|
|
671
672
|
created_at
|
|
672
673
|
FROM user_account;
|
|
673
674
|
|
|
674
|
-
--
|
|
675
|
+
-- Grant support team access to masked view only
|
|
675
676
|
GRANT SELECT ON user_account_masked TO support_role;
|
|
676
677
|
```
|
|
677
678
|
|
|
@@ -684,12 +685,12 @@ GRANT SELECT ON user_account_masked TO support_role;
|
|
|
684
685
|
- [ ] 定义并执行保留策略
|
|
685
686
|
- [ ] 支持数据主体请求(GDPR 删除权、访问权)
|
|
686
687
|
- [ ] 记录所有对 PII 字段的访问
|
|
687
|
-
- [ ]
|
|
688
|
+
- [ ] 在开发与预发布环境中匿名化数据
|
|
688
689
|
|
|
689
690
|
### 审计日志
|
|
690
691
|
|
|
691
692
|
```sql
|
|
692
|
-
--
|
|
693
|
+
-- Audit log table
|
|
693
694
|
CREATE TABLE audit_log (
|
|
694
695
|
id BIGSERIAL PRIMARY KEY,
|
|
695
696
|
table_name VARCHAR(100) NOT NULL,
|
|
@@ -701,7 +702,7 @@ CREATE TABLE audit_log (
|
|
|
701
702
|
changed_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
|
|
702
703
|
);
|
|
703
704
|
|
|
704
|
-
--
|
|
705
|
+
-- Trigger-based audit (PostgreSQL example)
|
|
705
706
|
CREATE OR REPLACE FUNCTION audit_trigger_fn()
|
|
706
707
|
RETURNS TRIGGER AS $$
|
|
707
708
|
BEGIN
|
|
@@ -737,7 +738,7 @@ $$ LANGUAGE plpgsql;
|
|
|
737
738
|
|------|----------|----------|------|
|
|
738
739
|
| **活跃连接数** | > 最大值的 70% | > 最大值的 90% | 数据库仪表板 |
|
|
739
740
|
| **缓存/缓冲命中率** | < 95% | < 90% | `pg_stat_bgwriter`、InnoDB buffer pool |
|
|
740
|
-
|
|
|
741
|
+
| **复制延迟** | > 1 秒 | > 10 秒 | 复制监控 |
|
|
741
742
|
| **事务速率** | 偏离基线 > 20% | 偏离 > 50% | 应用程序指标 |
|
|
742
743
|
| **锁定等待时间** | 平均 > 1 秒 | > 5 秒 | 锁定监控查询 |
|
|
743
744
|
| **每分钟死锁数** | > 1 | > 5 | 数据库日志 |
|
|
@@ -747,21 +748,21 @@ $$ LANGUAGE plpgsql;
|
|
|
747
748
|
### 查询计划分析工作流程
|
|
748
749
|
|
|
749
750
|
```
|
|
750
|
-
1.
|
|
751
|
+
1. Identify slow query (slow query log or APM)
|
|
751
752
|
↓
|
|
752
|
-
2.
|
|
753
|
+
2. Run EXPLAIN ANALYZE on staging with production-like data
|
|
753
754
|
↓
|
|
754
|
-
3.
|
|
755
|
-
-
|
|
756
|
-
-
|
|
757
|
-
-
|
|
758
|
-
-
|
|
755
|
+
3. Look for:
|
|
756
|
+
- Sequential scans on large tables → add index
|
|
757
|
+
- High actual vs estimated rows → run ANALYZE (update statistics)
|
|
758
|
+
- Nested loops with many iterations → restructure query or add index
|
|
759
|
+
- Sort operations with high cost → add index matching sort order
|
|
759
760
|
↓
|
|
760
|
-
4.
|
|
761
|
+
4. Apply fix (add index, rewrite query, update statistics)
|
|
761
762
|
↓
|
|
762
|
-
5.
|
|
763
|
+
5. Re-run EXPLAIN ANALYZE to verify improvement
|
|
763
764
|
↓
|
|
764
|
-
6.
|
|
765
|
+
6. Deploy and monitor execution time in production
|
|
765
766
|
```
|
|
766
767
|
|
|
767
768
|
---
|
|
@@ -771,34 +772,34 @@ $$ LANGUAGE plpgsql;
|
|
|
771
772
|
### Schema 设计
|
|
772
773
|
|
|
773
774
|
```
|
|
774
|
-
✅
|
|
775
|
-
✅
|
|
776
|
-
✅
|
|
777
|
-
✅
|
|
778
|
-
✅
|
|
779
|
-
✅
|
|
775
|
+
✅ Use snake_case for all identifiers
|
|
776
|
+
✅ Singular table names (user_account, not user_accounts)
|
|
777
|
+
✅ Use _id suffix for foreign keys
|
|
778
|
+
✅ Always have id, created_at, updated_at columns
|
|
779
|
+
✅ Enforce constraints at database level
|
|
780
|
+
✅ Normalize to 3NF, denormalize with documented reasoning
|
|
780
781
|
```
|
|
781
782
|
|
|
782
783
|
### 查询
|
|
783
784
|
|
|
784
785
|
```
|
|
785
|
-
✅
|
|
786
|
-
✅
|
|
787
|
-
✅
|
|
788
|
-
✅
|
|
789
|
-
✅
|
|
790
|
-
✅
|
|
786
|
+
✅ Always use parameterized queries
|
|
787
|
+
✅ List specific columns instead of SELECT *
|
|
788
|
+
✅ Use EXPLAIN ANALYZE for query optimization
|
|
789
|
+
✅ Prefer keyset pagination over offset for large datasets
|
|
790
|
+
✅ Batch operations to prevent N+1 queries
|
|
791
|
+
✅ Set statement_timeout to prevent runaway queries
|
|
791
792
|
```
|
|
792
793
|
|
|
793
794
|
### 运维
|
|
794
795
|
|
|
795
796
|
```
|
|
796
|
-
✅
|
|
797
|
-
✅
|
|
798
|
-
✅
|
|
799
|
-
✅
|
|
800
|
-
✅
|
|
801
|
-
✅
|
|
797
|
+
✅ Use connection pooling (never open per-request connections)
|
|
798
|
+
✅ Version-control all migrations
|
|
799
|
+
✅ Test migrations with production-like data
|
|
800
|
+
✅ Use expand-contract for zero-downtime schema changes
|
|
801
|
+
✅ Monitor slow queries, connections, cache hit ratio
|
|
802
|
+
✅ Test backup restoration regularly
|
|
802
803
|
```
|
|
803
804
|
|
|
804
805
|
---
|
|
@@ -806,7 +807,7 @@ $$ LANGUAGE plpgsql;
|
|
|
806
807
|
## 相关标准
|
|
807
808
|
|
|
808
809
|
- [安全标准](../../../core/security-standards.md) — 数据加密、访问控制、PII 处理
|
|
809
|
-
- [性能标准](../../../core/performance-standards.md) —
|
|
810
|
+
- [性能标准](../../../core/performance-standards.md) — 应用程序层级的性能优化
|
|
810
811
|
- [日志标准](../../../core/logging-standards.md) — 数据库操作的结构化日志
|
|
811
812
|
- [部署标准](../../../core/deployment-standards.md) — 数据库迁移作为部署管线的一部分
|
|
812
813
|
|
|
@@ -823,7 +824,7 @@ $$ LANGUAGE plpgsql;
|
|
|
823
824
|
## 参考资源
|
|
824
825
|
|
|
825
826
|
- [ISO/IEC 9075 — SQL 标准](https://www.iso.org/standard/76583.html)
|
|
826
|
-
- [Use The Index, Luke](https://use-the-index-luke.com/) — SQL
|
|
827
|
+
- [Use The Index, Luke](https://use-the-index-luke.com/) — SQL 索引与调优
|
|
827
828
|
- [SQL Style Guide](https://www.sqlstyle.guide/) — 一致的 SQL 格式
|
|
828
829
|
- [Martin Fowler — 演进式数据库设计](https://martinfowler.com/articles/evodb.html)
|
|
829
830
|
- [Designing Data-Intensive Applications](https://dataintensive.net/) — Martin Kleppmann
|
|
@@ -831,6 +832,6 @@ $$ LANGUAGE plpgsql;
|
|
|
831
832
|
|
|
832
833
|
---
|
|
833
834
|
|
|
834
|
-
##
|
|
835
|
+
## 许可
|
|
835
836
|
|
|
836
|
-
本标准以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/)
|
|
837
|
+
本标准以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 许可发布。
|