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,9 +1,9 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../core/full-coverage-testing.md
|
|
3
|
-
source_version: 1.
|
|
4
|
-
translation_version: 1.
|
|
5
|
-
last_synced: 2026-
|
|
6
|
-
source_hash:
|
|
3
|
+
source_version: 1.3.0
|
|
4
|
+
translation_version: 1.3.0
|
|
5
|
+
last_synced: 2026-10-08
|
|
6
|
+
source_hash: 6962df9f7135
|
|
7
7
|
status: current
|
|
8
8
|
---
|
|
9
9
|
|
|
@@ -12,7 +12,7 @@ status: current
|
|
|
12
12
|
> **Language**: [English](../../../core/full-coverage-testing.md) | 繁體中文
|
|
13
13
|
|
|
14
14
|
> **AI 最佳化版本**: `ai/standards/full-coverage-testing.ai.yaml`
|
|
15
|
-
> **XSPEC**: XSPEC-178
|
|
15
|
+
> **XSPEC**: XSPEC-178、XSPEC-444(R2、R5——提交前警告與隨附閘門腳本)、XSPEC-470(R1——恆真式=預期值不獨立)
|
|
16
16
|
> **取代**: 金字塔門檻模型(UT≥80%、IT≥70%、E2E 僅 happy-path)
|
|
17
17
|
|
|
18
18
|
## 概述
|
|
@@ -61,18 +61,58 @@ Coverage improved: 91.3% → 92.0%. New baseline set.
|
|
|
61
61
|
|
|
62
62
|
### 禁止:恆真斷言(Tautology Assertions)
|
|
63
63
|
|
|
64
|
-
|
|
64
|
+
斷言若不可能與實作產生分歧,提供的就是虛假覆蓋率。恆真斷言有兩種:
|
|
65
|
+
|
|
66
|
+
1. **恆為真**——不管程式做什麼都會通過:`expect(true).toBe(true)`、`assert 200 == 200`。
|
|
67
|
+
2. **預期值不獨立**——預期值由被測的程式碼產生,或由測試裡再寫一遍的同一套邏輯產生。實作正確時它會通過;實作與那份複本以同樣方式出錯時,它照樣通過。
|
|
68
|
+
|
|
69
|
+
第二種用 [`verification-oracle`](verification-oracle.md) 的詞彙定義:斷言的**預言(oracle)**是「說明正確答案是什麼」的來源,恆真式就是**預言本身就是被測實作**的斷言。本標準不另立第二套「獨立真值」定義,直接採用該標準的:登錄的真值案例、已知的字面值、手算例,或規格(見其 *Oracle-ability Spectrum*)。
|
|
65
70
|
|
|
66
71
|
```typescript
|
|
67
72
|
// ❌ FORBIDDEN — always passes, tests nothing
|
|
68
73
|
expect(true).toBe(true)
|
|
69
74
|
expect(result).toBeDefined() // without specific value
|
|
70
75
|
|
|
71
|
-
//
|
|
76
|
+
// ❌ FORBIDDEN — the oracle is the implementation
|
|
77
|
+
expect(countInstalled(manifest)).toBe(countInstalled(manifest)) // the same call on both sides
|
|
78
|
+
expect(countInstalled(manifest)).toBe(manifest.standards.filter(s => s.installed).length) // the same logic, typed again
|
|
79
|
+
// ^ 這一例要靠審查者判斷:自動檢查只抓下方〈隨附掃描腳本判定什麼、哪些留給審查者〉列的子集,這一例不在其中
|
|
80
|
+
|
|
81
|
+
// ✅ REQUIRED — a value that was decided before the code ran
|
|
72
82
|
expect(result).toBe(90)
|
|
73
83
|
expect(result).toEqual({ discount: 10, total: 90 })
|
|
84
|
+
expect(countInstalled({ standards: [{ id: 'a', installed: true }, { id: 'b', installed: false }] })).toBe(1)
|
|
74
85
|
```
|
|
75
86
|
|
|
87
|
+
並非每個「兩個算出來的值互相比較」都是恆真式。下列是正常測試,**不會**被回報:
|
|
88
|
+
|
|
89
|
+
| 看起來相似 | 為什麼它是真測試 |
|
|
90
|
+
|------------|------------------|
|
|
91
|
+
| 動作之後 `expect(snapshot(dir)).toEqual(before)` | 問的是「有沒有任何東西變動?」——兩個值取自不同時間點 |
|
|
92
|
+
| `expect(parse(a)).toEqual(parseWithOldEngine(a))` | 預言是另一份獨立寫成的實作 |
|
|
93
|
+
| 名稱就是在講決定性的測試裡 `expect(hash(x)).toBe(hash(x))` | 比較兩次呼叫正是這支測試的目的 |
|
|
94
|
+
| `report` 與 `rows` 來自不同資料路徑時的 `expect(report.total).toBe(rows.reduce(...))` | 兩個來源之間的對帳 |
|
|
95
|
+
|
|
96
|
+
#### 隨附掃描腳本判定什麼、哪些留給審查者
|
|
97
|
+
|
|
98
|
+
`scripts/check-anti-fake-tests.mjs`(見下方〈兩支掃描腳本〉)只點名光看文字就能判定的兩種形狀。它讀 **JavaScript/TypeScript**(`toBe`、`toEqual`、`toStrictEqual`、chai 的 `to.equal`/`to.eql`、node 的 `assert.equal`/`strictEqual`/`deepEqual`/`deepStrictEqual`):
|
|
99
|
+
|
|
100
|
+
| 形狀 | 範例 | 回報條件 |
|
|
101
|
+
|------|------|----------|
|
|
102
|
+
| **同一個呼叫(same call)** | `expect(total(items)).toBe(total(items))` | 兩側是同一個函式、同樣的參數(呼叫裡沒有另一個呼叫或 `new`),寫在同一個敘述裡,且測試名稱不是在講「比較兩次呼叫」(決定性、冪等、快取、同一性) |
|
|
103
|
+
| **重算(recomputed)** | `expect(total(items)).toBe(items.reduce((s, i) => s + i.price, 0))` | 被測呼叫吃一個輸入,預期值把同一個輸入(就是引數本身,如 `items.reduce`,不是它的某個欄位)送進 `reduce`、`map`、`flatMap` 或 `filter`,且回呼只用到自己的參數(外加 `Math`、`Number`、`String` 這類純內建)、不含任何字面值、不是單純的複製(`(x) => x`、`(x) => ({ ...x })`);被測呼叫是單一呼叫,裡面沒有別的呼叫或 `new`,後面也沒有接 `.length` 之類的屬性存取。只讀斷言本身的文字:前面幾行設定過的名稱一律不展開 |
|
|
104
|
+
|
|
105
|
+
下列看起來相似的寫法**刻意放過**,因為光看文字分不出它們和正當測試的差別:`expect(priceOf(ids)).toEqual(ids.map(id => KNOWN_PRICES[id]))`(預期值查寫死的價目表,是獨立來源);`expect(activeOf(users)).toEqual(users.filter(u => u.id === 2))`(字面值是測試作者提供的知識);`expect(render(now())).toBe(render(now()))`(兩次 `now()` 是兩個值,兩側不一定相等);`expect(parse(serialize(rows))).toEqual(rows.map(r => r))`(往返測試:被測呼叫裡還有呼叫);`expect(clone(input)).toEqual(input.map(x => x))`(只把參數原樣回傳、或把參數淺複製的回呼(如 `u => ({ ...u })`)、或把解構參數原樣組回同一形狀的回呼(如 `([k, v]) => [k, v]`),是複製而不是邏輯;`filter(x => x)` 依真假值篩選,是有邏輯的,但光看文字分不出它和複製的差別,所以一併放過);`expect(sortUsers(users).length).toBe(users.filter(u => u.name).length)`(被測的值是結果的屬性,哪一側才對光看文字判不出)。`const before = items.map(i => i.price); freezeCart(items); expect(pricesOf(items)).toEqual(before)`(前面幾行設定的名稱存的是較早時刻的值,中間發生的事正是這支測試要問的;「同一呼叫」也是這樣讀的)。原則是:拿不準寧可漏抓,不可誤報。
|
|
106
|
+
|
|
107
|
+
**兩個已接受、不隱瞞的代價。**
|
|
108
|
+
|
|
109
|
+
1. **差分測試會被點名。** 拿參考實作當預期值的測試,`expect(fastTotal(items)).toBe(items.reduce((s, i) => s + i.price, 0))`,文字上和教科書例一模一樣,所以掃描腳本會點名它。這種測試是正當的(見上表「預言是另一份獨立寫成的實作」);處理方式有二:在同一支測試裡另外加一個對手算字面值的斷言(只有在測試的所有斷言都不是真斷言時才回報),或把該檔列進 `.standards/test-policy.json` 的 `ignore`(這會讓整個檔案不再被這支腳本的任何檢查看到,且 `ignore` 不收理由,請在註解寫明)。測試名稱寫「與參考實作一致」**不能**豁免,`exempt` 清單也不適用於這支腳本(它屬於「改了程式碼卻沒有測試」的檢查)。
|
|
110
|
+
2. **這條規則很容易被繞過。** 把**被測值**包進 `Number(...)`、在它後面接 `.valueOf()` 或 `[0]`、把引數改成 `items.slice()`,掃描腳本就看不到了。(對**預期值**做同樣的事沒有用:照樣會被點名。)它是提醒審查者的線索,不是擋得住刻意規避的閘門,寫測試的是 AI 代理時尤其如此:掃描乾淨不能當成預期值獨立的證據。下面審查者的問題才是控制手段,腳本只指出最容易判的情形。
|
|
111
|
+
|
|
112
|
+
與 `expect(true).toBe(true)` 相同,只有在測試的**所有**斷言都不是真斷言時才回報;自我比較旁邊還有一個對字面值的斷言,就留給審查者。文字判不了的,掃描腳本保持沉默——會亂叫的掃描腳本遲早被關掉。
|
|
113
|
+
|
|
114
|
+
其餘一律是**審查者的判斷題**,在程式碼審查時問(見[程式碼審查檢查清單](code-review-checklist.md)):這個預期值從哪裡來?能不能靠執行被測程式碼得到?如果實作錯得跟測試自己的算式一樣,這支測試還會過嗎?掃描腳本不判的典型情形:手寫迴圈重新推導答案、包著實作的輔助函式、拿實作第一次的輸出當快照,以及 JavaScript/TypeScript 以外的所有語言。
|
|
115
|
+
|
|
76
116
|
### 禁止:Mock 核心業務邏輯
|
|
77
117
|
|
|
78
118
|
Mock 自己的程式碼,意味著業務邏輯從未真正執行。
|
|
@@ -233,6 +273,60 @@ legacy 降級模式(外部服務失敗時的 fallback、重試、部分結果
|
|
|
233
273
|
|
|
234
274
|
---
|
|
235
275
|
|
|
276
|
+
## UDS 隨附的提交前警告與閘門腳本(XSPEC-444 R2、R5)
|
|
277
|
+
|
|
278
|
+
上面的規則過去要靠標準叫你自己寫的腳本來執行。現在 `uds init` 會直接把掃描腳本寫進你的專案,而 `uds check`——UDS 的 pre-commit hook 執行的指令——會印出這些腳本和另一項檢查找到的東西。**預設一律只警告、不擋任何東西**;要收緊是選擇性的(見「先警告,之後再收緊」)。
|
|
279
|
+
|
|
280
|
+
### 兩支掃描腳本(`uds init` 寫到 `scripts/`)
|
|
281
|
+
|
|
282
|
+
| 腳本 | 找什麼 |
|
|
283
|
+
|------|--------|
|
|
284
|
+
| `scripts/check-anti-fake-tests.mjs` | **沒有斷言**的測試;唯一的斷言是**恆真式**的測試(`expect(true).toBe(true)`、`assert 200 == 200`;JavaScript/TypeScript 另含「預期值就是被測的同一個呼叫」或「以同一個輸入經 `reduce`/`map`/`filter` 重算而得」,見〈禁止:恆真斷言〉);**每一支測試都被跳過或標為 todo** 的測試檔 |
|
|
285
|
+
| `scripts/check-stubs.mjs` | `// WARNING: STUB` 標記;宣稱**尚未實作**的函式本體(`raise NotImplementedError`、`todo!()`、`TODO()` 等)而旁邊沒有標記;本體**為空**的具名函式而旁邊沒有標記 |
|
|
286
|
+
|
|
287
|
+
- 純 Node、零相依、不預設任何測試框架。它們是**你的檔案**:可以改、可以接進 CI。單獨執行時,找到東西就以非 0 結束——`node scripts/check-stubs.mjs` 就是本標準部署閘門所說的 pre-push/部署閘門。
|
|
288
|
+
- `uds init` 不會覆寫已存在的檔案,`uds update` 也不會;較早初始化的專案,`uds update` 會詢問是否寫入(提示的預設為否;`uds update -y` 會直接回答是)。
|
|
289
|
+
- 有暫存檔案時只讀那些檔案;沒有暫存任何東西時(CI 執行、手動 `uds check`)每支都會走訪整個專案——走訪最多 200,000 個檔案,`uds check` 給每支 120 秒(超過就回報「無法判定」,絕不算通過)——所以在很大的儲存庫裡,請在 CI 執行,不要期待立刻完成。
|
|
290
|
+
- 同一行或上面三行內出現 `STUB` 或 `COVERAGE_EXEMPT`,該暫時實作就算已**宣告**;已宣告的只以標記回報一次。
|
|
291
|
+
- **語言範圍。**測試檔規則涵蓋 JavaScript/TypeScript、Python、Java/Kotlin/Scala/C#、Go、Rust、Ruby、Elixir、PHP、Swift、Dart、Lua 與 C/C++。其他語言的測試檔會被列為「未掃描」——絕不當成乾淨。空函式規則涵蓋 JavaScript/TypeScript、Python、Go、Rust、Ruby 與 PHP;其他語言仍會找標記與「尚未實作」的本體,輸出也會寫出哪些語言沒有空函式規則。
|
|
292
|
+
- 它們讀的是文字,不執行你的測試。若某個輔助函式用掃描器認不得的名稱做斷言,會被報為「no-assertion」:把它命名為 `assert*`/`verify*`/`expect*`,或把它的樣式列在政策檔的 `assertionPatterns`。
|
|
293
|
+
- 每次執行都先拿已知的假測試與已知的好測試檢驗自己;檢驗失敗就以 `2`(「無法判定」)結束,這絕不算通過。
|
|
294
|
+
|
|
295
|
+
### 改了程式碼卻沒動測試(`uds check`,針對已暫存的變更)
|
|
296
|
+
|
|
297
|
+
有檔案暫存準備提交時,`uds check` 會比對變更內容:
|
|
298
|
+
|
|
299
|
+
- 改了程式檔,**同一次提交沒有任何測試檔變動** → 警告,並列出程式檔;
|
|
300
|
+
- 變更中有 UDS 不認得的檔案類型 → 警告,列出它並說明如何分類(絕不當成沒事,也絕不擋);
|
|
301
|
+
- 刪除不算需要測試的變更;**純重新命名**(git 的 `R100`)與符合 `exempt` 條目的路徑可免,輸出會記下理由。
|
|
302
|
+
|
|
303
|
+
沒有暫存任何東西時(CI 執行、手動 `uds check`),差異檢查不出聲;兩支掃描腳本則改為掃整個專案。
|
|
304
|
+
|
|
305
|
+
### 政策檔 `.standards/test-policy.json`(選用)
|
|
306
|
+
|
|
307
|
+
哪些路徑是測試、哪些是程式,是附有常見生態預設值的資料,不是一份框架清單。每個清單都是**加進**預設值:
|
|
308
|
+
|
|
309
|
+
```json
|
|
310
|
+
{
|
|
311
|
+
"mode": "warn",
|
|
312
|
+
"testDirs": ["integration"],
|
|
313
|
+
"testPatterns": ["*.itest.*"],
|
|
314
|
+
"sourceExtensions": ["zig"],
|
|
315
|
+
"nonCodeExtensions": ["gradle"],
|
|
316
|
+
"ignore": ["generated/**"],
|
|
317
|
+
"exempt": [{ "pattern": "src/gen/**", "reason": "generated by protoc" }],
|
|
318
|
+
"assertionPatterns": ["\\bmustMatch\\w*\\s*\\("]
|
|
319
|
+
}
|
|
320
|
+
```
|
|
321
|
+
|
|
322
|
+
沒有 `reason` 的 `exempt` 條目不會生效,並會被回報:豁免必須說明原因。
|
|
323
|
+
|
|
324
|
+
### 先警告,之後再收緊
|
|
325
|
+
|
|
326
|
+
`"mode": "warn"`(預設)只印出警告、放行提交。`"mode": "block"` 會讓 `uds check` 在以下情況以非 0 結束,因此擋下提交:掃描腳本找到東西、掃描腳本無法判定、或改了程式碼卻沒動測試。UDS 不認得的檔案類型永遠不會擋。**尚未實作**(規格沒有定義基線放在哪裡、以什麼計數):未配測試的變更數棘輪,以及逐次提交的豁免理由(pre-commit hook 讀不到提交訊息)。
|
|
327
|
+
|
|
328
|
+
---
|
|
329
|
+
|
|
236
330
|
## 從金字塔模型遷移
|
|
237
331
|
|
|
238
332
|
若你的專案先前使用金字塔門檻:
|
|
@@ -240,8 +334,8 @@ legacy 降級模式(外部服務失敗時的 fallback、重試、部分結果
|
|
|
240
334
|
1. **刪除** `jest.config.js` / `vitest.config.ts` 中任何硬編碼的覆蓋率門檻(`coverageThreshold` 選項)
|
|
241
335
|
2. **安裝** `.coverage-baseline.json`,以目前的覆蓋率作為棘輪起點
|
|
242
336
|
3. **新增** `scripts/check-coverage-ratchet.sh` 到 CI
|
|
243
|
-
4. **新增** `scripts/check-stubs.
|
|
244
|
-
5. **新增** `scripts/check-anti-fake-tests.
|
|
337
|
+
4. **新增** `scripts/check-stubs.mjs` 到 deploy.sh 與 pre-push hook(由 `uds init` 寫入;既有專案由 `uds update` 提供)
|
|
338
|
+
5. **新增** `scripts/check-anti-fake-tests.mjs` 到 pre-commit 或 CI(由 `uds init` 寫入;`uds check` 已會執行並警告)
|
|
245
339
|
|
|
246
340
|
棘輪從你目前的覆蓋率開始。從那一刻起,它只能上升。
|
|
247
341
|
|
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
source: ../../../core/git-workflow.md
|
|
3
3
|
source_version: 1.4.0
|
|
4
4
|
translation_version: 1.4.0
|
|
5
|
-
last_synced: 2026-
|
|
5
|
+
last_synced: 2026-10-11
|
|
6
|
+
source_hash: dbbce0815e5e
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
@@ -11,81 +12,240 @@ status: current
|
|
|
11
12
|
> **語言**: [English](../../../core/git-workflow.md) | 繁體中文
|
|
12
13
|
|
|
13
14
|
**版本**: 1.4.0
|
|
14
|
-
**最後更新**: 2026-
|
|
15
|
-
**適用性**:
|
|
16
|
-
**範圍**:
|
|
15
|
+
**最後更新**: 2026-01-29
|
|
16
|
+
**適用性**: 所有使用 Git 進行版本控制的專案
|
|
17
|
+
**範圍**: universal(通用)
|
|
18
|
+
**業界標準**: 無(業界通行實踐)
|
|
19
|
+
**參考資料**: [atlassian.com](https://www.atlassian.com/git/tutorials)
|
|
20
|
+
|
|
21
|
+
> **詳細說明與教學請參閱 [Git 工作流程指南](guides/git-workflow-guide.md)**
|
|
17
22
|
|
|
18
23
|
---
|
|
19
24
|
|
|
20
25
|
## 目的
|
|
21
26
|
|
|
22
|
-
本標準定義 Git
|
|
27
|
+
本標準定義 Git 分支策略與工作流程,確保跨團隊、跨專案擁有一致且可預期的協作模式。
|
|
28
|
+
|
|
29
|
+
---
|
|
30
|
+
|
|
31
|
+
## 工作流程策略選擇
|
|
32
|
+
|
|
33
|
+
**專案必須擇一**採用工作流程策略,並清楚記錄。
|
|
34
|
+
|
|
35
|
+
| 因素 | GitFlow | GitHub Flow | Trunk-Based |
|
|
36
|
+
|--------|---------|-------------|-------------|
|
|
37
|
+
| **發布頻率** | 每月以上 | 每週 | 每天多次 |
|
|
38
|
+
| **團隊規模** | 大型(10+) | 中型(5-15) | 小至中型(3-10) |
|
|
39
|
+
| **CI/CD 成熟度** | 基礎 | 中等 | 進階 |
|
|
40
|
+
| **Feature flags** | 選用 | 選用 | 必要 |
|
|
41
|
+
| **複雜度** | 高 | 低 | 中 |
|
|
42
|
+
|
|
43
|
+
---
|
|
44
|
+
|
|
45
|
+
## 分支類型
|
|
46
|
+
|
|
47
|
+
### GitFlow 分支類型
|
|
48
|
+
|
|
49
|
+
| 分支類型 | 目的 | 基底分支 | 合併目標 | 生命週期 |
|
|
50
|
+
|-------------|---------|-------------|--------------|----------|
|
|
51
|
+
| `main` | 正式環境程式碼 | - | - | 永久 |
|
|
52
|
+
| `develop` | 整合分支 | - | - | 永久 |
|
|
53
|
+
| `feature/*` | 新功能 | `develop` | `develop` | 暫時 |
|
|
54
|
+
| `release/*` | 發布準備 | `develop` | `main` + `develop` | 暫時 |
|
|
55
|
+
| `hotfix/*` | 緊急修復 | `main` | `main` + `develop` | 暫時 |
|
|
56
|
+
|
|
57
|
+
### GitHub Flow 分支類型
|
|
58
|
+
|
|
59
|
+
| 分支類型 | 目的 | 基底分支 | 合併目標 | 生命週期 |
|
|
60
|
+
|-------------|---------|-------------|--------------|----------|
|
|
61
|
+
| `main` | 正式環境程式碼 | - | - | 永久 |
|
|
62
|
+
| `feature/*` | 新功能 | `main` | `main` | 暫時 |
|
|
63
|
+
| `bugfix/*` | Bug 修復 | `main` | `main` | 暫時 |
|
|
64
|
+
| `hotfix/*` | 緊急修復 | `main` | `main` | 暫時 |
|
|
65
|
+
|
|
66
|
+
### Trunk-Based 分支類型
|
|
67
|
+
|
|
68
|
+
| 分支類型 | 目的 | 基底分支 | 合併目標 | 生命週期 |
|
|
69
|
+
|-------------|---------|-------------|--------------|----------|
|
|
70
|
+
| `main` | 主幹 | - | - | 永久 |
|
|
71
|
+
| `feature/*` | 小型變更 | `main` | `main` | ≤2 天 |
|
|
23
72
|
|
|
24
73
|
---
|
|
25
74
|
|
|
26
75
|
## 分支命名慣例
|
|
27
76
|
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
77
|
+
### 標準格式
|
|
78
|
+
|
|
79
|
+
```
|
|
80
|
+
<type>/<short-description>
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
### 類型
|
|
84
|
+
|
|
85
|
+
| 類型 | 用途 | 範例 |
|
|
86
|
+
|------|-------|---------|
|
|
87
|
+
| `feature/` | 新功能 | `feature/oauth-login` |
|
|
88
|
+
| `fix/` 或 `bugfix/` | Bug 修復 | `fix/memory-leak` |
|
|
89
|
+
| `hotfix/` | 正式環境緊急修復 | `hotfix/security-patch` |
|
|
90
|
+
| `refactor/` | 程式碼重構 | `refactor/extract-service` |
|
|
91
|
+
| `docs/` | 僅文件變更 | `docs/api-reference` |
|
|
92
|
+
| `test/` | 新增測試 | `test/integration-tests` |
|
|
93
|
+
| `chore/` | 維護任務 | `chore/update-dependencies` |
|
|
94
|
+
| `release/` | 發布準備(GitFlow) | `release/v1.2.0` |
|
|
95
|
+
|
|
96
|
+
### 命名規則
|
|
97
|
+
|
|
98
|
+
1. **使用小寫**
|
|
99
|
+
2. **以連字號取代空格**
|
|
100
|
+
3. **具描述性但保持精簡**
|
|
101
|
+
4. **避免僅以 issue 編號作為識別**
|
|
102
|
+
|
|
103
|
+
---
|
|
104
|
+
|
|
105
|
+
## 合併策略
|
|
36
106
|
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
107
|
+
**專案必須**針對每種分支類型**擇一**採用。
|
|
108
|
+
|
|
109
|
+
| 策略 | 指令 | 最適用於 | 優點 | 缺點 |
|
|
110
|
+
|----------|---------|----------|------|------|
|
|
111
|
+
| **Merge Commit** | `git merge --no-ff` | GitFlow、長期存在的功能分支 | 完整歷史、易於還原 | 日誌雜亂 |
|
|
112
|
+
| **Squash Merge** | `git merge --squash` | GitHub Flow、功能分支 | 歷史乾淨、每個功能一個提交 | 遺失細節 |
|
|
113
|
+
| **Rebase + FF** | `git rebase && git merge --ff-only` | Trunk-Based、短期分支 | 線性歷史、保留提交 | 改寫歷史 |
|
|
41
114
|
|
|
42
115
|
---
|
|
43
116
|
|
|
44
|
-
##
|
|
117
|
+
## 建立分支前檢查清單
|
|
118
|
+
|
|
119
|
+
建立新分支前,請完成以下檢查:
|
|
120
|
+
|
|
121
|
+
### 適用於 GitFlow 與 GitHub Flow
|
|
45
122
|
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
| **Merge Commit** | `git merge --no-ff` | 發布分支 (Release) | 保留發布歷史節點 |
|
|
123
|
+
- [ ] 檢查未合併的分支:`git branch --no-merged main`
|
|
124
|
+
- [ ] 同步最新程式碼:`git checkout main && git pull origin main`
|
|
125
|
+
- [ ] 確認測試通過:執行專案測試套件
|
|
126
|
+
- [ ] 建立分支:`git checkout -b feature/description`
|
|
51
127
|
|
|
52
|
-
|
|
128
|
+
### 適用於 Trunk-Based 開發
|
|
129
|
+
|
|
130
|
+
- [ ] 同步最新程式碼:`git checkout main && git pull origin main`(關鍵)
|
|
131
|
+
- [ ] 確認測試通過(關鍵)
|
|
132
|
+
- [ ] 建立短期分支:`git checkout -b feature/description`
|
|
53
133
|
|
|
54
134
|
---
|
|
55
135
|
|
|
56
|
-
##
|
|
136
|
+
## 衝突解決
|
|
137
|
+
|
|
138
|
+
### 預防檢查清單
|
|
57
139
|
|
|
58
|
-
|
|
140
|
+
- [ ] 經常與基底分支同步
|
|
141
|
+
- [ ] 保持分支精簡(避免長期存在的功能分支)
|
|
142
|
+
- [ ] 重大重構事先告知團隊
|
|
59
143
|
|
|
60
|
-
|
|
144
|
+
### 解決步驟
|
|
61
145
|
|
|
62
|
-
|
|
146
|
+
```bash
|
|
147
|
+
git checkout main && git pull origin main
|
|
148
|
+
git checkout feature/my-feature && git merge main
|
|
149
|
+
# Resolve conflicts in marked files
|
|
150
|
+
git add resolved-file.js
|
|
151
|
+
git commit -m "chore: resolve merge conflicts with main"
|
|
152
|
+
npm test # Verify
|
|
153
|
+
git push origin feature/my-feature
|
|
154
|
+
```
|
|
63
155
|
|
|
64
156
|
---
|
|
65
157
|
|
|
66
|
-
##
|
|
158
|
+
## 標籤與發布
|
|
159
|
+
|
|
160
|
+
### 語意化版本
|
|
161
|
+
|
|
162
|
+
```
|
|
163
|
+
MAJOR.MINOR.PATCH
|
|
164
|
+
```
|
|
165
|
+
|
|
166
|
+
| 組成 | 何時遞增 | 範例 |
|
|
167
|
+
|-----------|-------------------|---------|
|
|
168
|
+
| **MAJOR** | 破壞性變更 | v2.0.0 |
|
|
169
|
+
| **MINOR** | 新功能(向下相容) | v1.2.0 |
|
|
170
|
+
| **PATCH** | Bug 修復(向下相容) | v1.2.1 |
|
|
171
|
+
|
|
172
|
+
### 預發布版本
|
|
173
|
+
|
|
174
|
+
| 類型 | 格式 | 範例 |
|
|
175
|
+
|------|--------|---------|
|
|
176
|
+
| Alpha | `X.Y.Z-alpha.N` | v1.2.0-alpha.1 |
|
|
177
|
+
| Beta | `X.Y.Z-beta.N` | v1.2.0-beta.2 |
|
|
178
|
+
| RC | `X.Y.Z-rc.N` | v1.2.0-rc.1 |
|
|
179
|
+
|
|
180
|
+
### 建立標籤
|
|
181
|
+
|
|
182
|
+
```bash
|
|
183
|
+
git tag -a v1.2.0 -m "Release version 1.2.0: Add OAuth2 support"
|
|
184
|
+
git push origin v1.2.0
|
|
185
|
+
```
|
|
186
|
+
|
|
187
|
+
---
|
|
188
|
+
|
|
189
|
+
## 受保護分支
|
|
190
|
+
|
|
191
|
+
### `main`/`develop` 建議保護設定
|
|
192
|
+
|
|
193
|
+
| 設定 | 是否需要 |
|
|
194
|
+
|---------|----------|
|
|
195
|
+
| 要求 pull request 審查 | ✅(1-2 位審查者) |
|
|
196
|
+
| 要求狀態檢查通過 | ✅(CI 測試、linting) |
|
|
197
|
+
| 要求分支保持最新 | ✅ |
|
|
198
|
+
| 包含管理員 | ✅ |
|
|
199
|
+
| 允許強制推送 | ❌ |
|
|
200
|
+
| 允許刪除 | ❌ |
|
|
201
|
+
|
|
202
|
+
---
|
|
203
|
+
|
|
204
|
+
## Pull Request 工作流程
|
|
205
|
+
|
|
206
|
+
### PR 建立檢查清單
|
|
207
|
+
|
|
208
|
+
- [ ] **標題遵循 commit 慣例**(例如 `feat(auth): add OAuth2`)
|
|
209
|
+
- [ ] **描述說明原因**(而不只是做了什麼)
|
|
210
|
+
- [ ] **連結到 issue**(例如「Closes #123」)
|
|
211
|
+
- [ ] **新功能附帶測試**
|
|
212
|
+
- [ ] **視需要更新文件**
|
|
213
|
+
- [ ] **在描述中標明破壞性變更**
|
|
214
|
+
- [ ] **UI 變更附上截圖/GIF**
|
|
215
|
+
|
|
216
|
+
### PR 類型參考
|
|
67
217
|
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
218
|
+
| 類型 | 目的 | 範例 |
|
|
219
|
+
|------|---------|---------|
|
|
220
|
+
| `feat` | 新功能 | `feat(auth): add OAuth2 login` |
|
|
221
|
+
| `fix` | Bug 修復 | `fix(api): handle null response` |
|
|
222
|
+
| `docs` | 文件 | `docs(readme): update install steps` |
|
|
223
|
+
| `refactor` | 程式碼重構 | `refactor(utils): extract validation` |
|
|
224
|
+
| `test` | 新增測試 | `test(auth): add login unit tests` |
|
|
225
|
+
| `chore` | 維護 | `chore(deps): update lodash` |
|
|
226
|
+
| `perf` | 效能 | `perf(query): optimize user lookup` |
|
|
72
227
|
|
|
73
228
|
---
|
|
74
229
|
|
|
75
230
|
## 相關標準
|
|
76
231
|
|
|
77
|
-
- [Git 工作流程指南](guides/git-workflow-guide.md) - 詳細教學與比較
|
|
78
232
|
- [Commit 訊息指南](commit-message-guide.md)
|
|
79
233
|
- [程式碼簽入標準](checkin-standards.md)
|
|
234
|
+
- [版本控制標準](versioning.md)
|
|
235
|
+
- [變更日誌標準](changelog-standards.md)
|
|
80
236
|
|
|
81
237
|
---
|
|
82
238
|
|
|
83
239
|
## 版本歷史
|
|
84
240
|
|
|
85
241
|
| 版本 | 日期 | 變更 |
|
|
86
|
-
|
|
87
|
-
| 1.
|
|
88
|
-
| 1.
|
|
242
|
+
|---------|------|---------|
|
|
243
|
+
| 1.4.0 | 2026-01-29 | 重構:拆分為規則 + 指南,教學內容移至指南 |
|
|
244
|
+
| 1.3.0 | 2026-01-24 | 新增:Trunk-Based + Feature Flags 整合、Ship/Show/Ask 決策模型、Stacked PRs 工作流程 |
|
|
245
|
+
| 1.2.1 | 2025-12-24 | 新增:相關標準章節 |
|
|
246
|
+
| 1.2.0 | 2025-12-16 | 新增:決策樹、選擇矩陣 |
|
|
247
|
+
| 1.1.0 | 2025-12-08 | 新增建立分支前檢查清單章節 |
|
|
248
|
+
| 1.0.0 | 2025-11-12 | 初始 Git 工作流程標準 |
|
|
89
249
|
|
|
90
250
|
---
|
|
91
251
|
|
|
@@ -1,19 +1,20 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../core/git-worktree.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: 12acb15a4884
|
|
7
|
+
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
9
10
|
# Git Worktree 隔離
|
|
10
11
|
|
|
11
12
|
> **語言**: [English](../../../core/git-worktree.md) | 繁體中文
|
|
12
13
|
|
|
13
|
-
**版本**: 1.
|
|
14
|
-
**最後更新**: 2026-
|
|
14
|
+
**版本**: 1.1.0
|
|
15
|
+
**最後更新**: 2026-06-18
|
|
15
16
|
**適用性**: 所有使用 Git 進行版本控制的專案
|
|
16
|
-
**範圍**:
|
|
17
|
+
**範圍**: universal(通用)
|
|
17
18
|
**靈感來源**: [Superpowers](https://github.com/obra/superpowers) — using-git-worktrees (MIT)
|
|
18
19
|
|
|
19
20
|
---
|
|
@@ -27,10 +28,10 @@ status: stale
|
|
|
27
28
|
## 術語表
|
|
28
29
|
|
|
29
30
|
| 術語 | 定義 |
|
|
30
|
-
|
|
31
|
-
| Worktree | Git
|
|
32
|
-
|
|
|
33
|
-
| Worktree 目錄 | worktree
|
|
31
|
+
|------|-----------|
|
|
32
|
+
| Worktree | Git 儲存庫在不同分支上的連結工作副本 |
|
|
33
|
+
| 基準測試(Baseline Test) | 在新建 worktree 上執行的測試,用於驗證環境是乾淨的 |
|
|
34
|
+
| Worktree 目錄 | 建立 worktree 的檔案系統路徑 |
|
|
34
35
|
|
|
35
36
|
---
|
|
36
37
|
|
|
@@ -42,63 +43,92 @@ status: stale
|
|
|
42
43
|
|
|
43
44
|
## 生命週期階段
|
|
44
45
|
|
|
45
|
-
### 階段 1
|
|
46
|
+
### 階段 1:Setup(建立)
|
|
47
|
+
|
|
48
|
+
1. **選擇 worktree 位置** — 優先順序:
|
|
49
|
+
- 既有的設定路徑
|
|
50
|
+
- `.uds/worktrees/` 或類似的專案內目錄
|
|
51
|
+
- 詢問使用者
|
|
52
|
+
2. **驗證 `.gitignore`** — 執行 `git check-ignore` 確認 worktree 目錄已被忽略
|
|
53
|
+
3. **建立 worktree** — `git worktree add <path> -b <branch-name>`
|
|
54
|
+
4. **安裝依賴** — 視需要執行套件管理器的安裝指令
|
|
46
55
|
|
|
47
56
|
```bash
|
|
48
|
-
#
|
|
49
|
-
git worktree add
|
|
57
|
+
# Example setup
|
|
58
|
+
git worktree add .worktrees/feature-auth -b feature/auth
|
|
59
|
+
cd .worktrees/feature-auth
|
|
60
|
+
pnpm install # or npm install, pip install, etc.
|
|
50
61
|
```
|
|
51
62
|
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
63
|
+
### 階段 2:Baseline(基準驗證)
|
|
64
|
+
|
|
65
|
+
1. 在新建的 worktree 中**執行測試套件**
|
|
66
|
+
2. **確認所有測試通過** — 藉此驗證環境乾淨
|
|
67
|
+
3. **若測試失敗** — 以退避方式最多重試 2 次,排除暫時性的不穩定/逾時;若仍失敗,則中止並報告環境問題(不得繼續)
|
|
68
|
+
|
|
69
|
+
```bash
|
|
70
|
+
# Baseline verification
|
|
71
|
+
pnpm test # Must pass before any work begins
|
|
72
|
+
```
|
|
57
73
|
|
|
58
|
-
|
|
74
|
+
基準測試失敗代表環境有問題,必須中止並報告。
|
|
59
75
|
|
|
60
|
-
|
|
61
|
-
- 各 worktree 之間完全隔離
|
|
62
|
-
- 不影響主工作目錄
|
|
76
|
+
### 階段 3:Execute(執行)
|
|
63
77
|
|
|
64
|
-
|
|
78
|
+
1. 將隔離的 worktree 當作一般開發環境進行工作
|
|
79
|
+
2. 照常提交
|
|
80
|
+
3. 變更後執行測試
|
|
65
81
|
|
|
66
|
-
|
|
67
|
-
|------|------|
|
|
68
|
-
| 合併 | 在主目錄中執行 `git merge feature/name` |
|
|
69
|
-
| 丟棄 | 執行清理流程 |
|
|
82
|
+
### 階段 4:Merge(合併)
|
|
70
83
|
|
|
71
|
-
|
|
84
|
+
1. 在 worktree 中**確認所有測試通過**
|
|
85
|
+
2. **合併回主線** — 使用 `--no-ff` 保留分支歷史
|
|
86
|
+
3. 若發生衝突,**處理衝突**
|
|
72
87
|
|
|
73
88
|
```bash
|
|
74
|
-
|
|
75
|
-
git
|
|
89
|
+
git checkout main
|
|
90
|
+
git merge --no-ff feature/auth
|
|
91
|
+
```
|
|
76
92
|
|
|
77
|
-
|
|
78
|
-
git worktree list
|
|
93
|
+
### 階段 5:Cleanup(清理)
|
|
79
94
|
|
|
80
|
-
|
|
95
|
+
1. **移除 worktree** — `git worktree remove <path>`
|
|
96
|
+
2. **刪除分支** — `git branch -d <branch-name>`
|
|
97
|
+
3. **清除過時的 worktree** — `git worktree prune`
|
|
98
|
+
|
|
99
|
+
```bash
|
|
100
|
+
git worktree remove .worktrees/feature-auth
|
|
101
|
+
git branch -d feature/auth
|
|
81
102
|
git worktree prune
|
|
82
103
|
```
|
|
83
104
|
|
|
84
|
-
|
|
105
|
+
**重要**:清理必須在異常退出時也執行,使用 try/finally 模式或清理 hook。
|
|
85
106
|
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
107
|
+
---
|
|
108
|
+
|
|
109
|
+
## 規則
|
|
110
|
+
|
|
111
|
+
| ID | 觸發條件 | 動作 | 優先級 |
|
|
112
|
+
|----|---------|--------|----------|
|
|
113
|
+
| GW-001 | Worktree 目錄不在 `.gitignore` 中 | 自動加入 `.gitignore` | Critical |
|
|
114
|
+
| GW-002 | 基準測試失敗 | 對暫時性失敗最多重試 2 次(指數退避);若持續失敗,中止任務並報告環境問題 | High |
|
|
115
|
+
| GW-003 | Worktree 操作期間異常退出 | 確保執行清理 | High |
|
|
116
|
+
| GW-004 | 分支合併/刪除後 worktree 仍存在 | 清除過時的 worktree 參照 | Medium |
|
|
117
|
+
|
|
118
|
+
---
|
|
90
119
|
|
|
91
120
|
## 最佳實踐
|
|
92
121
|
|
|
93
|
-
| 實踐 |
|
|
94
|
-
|
|
95
|
-
|
|
|
96
|
-
|
|
|
97
|
-
|
|
|
98
|
-
|
|
|
122
|
+
| 實踐 | 理由 |
|
|
123
|
+
|----------|-----------|
|
|
124
|
+
| 使用一致的 worktree 目錄(例如 `.worktrees/`) | 易於加入 `.gitignore` 與定位 |
|
|
125
|
+
| 一律執行基準測試 | 避免環境問題造成的假性失敗 |
|
|
126
|
+
| 合併時使用 `--no-ff` | 在歷史中保留分支拓樸 |
|
|
127
|
+
| 合併後立即清理 | 避免過時 worktree 累積 |
|
|
128
|
+
|
|
129
|
+
---
|
|
99
130
|
|
|
100
|
-
##
|
|
131
|
+
## 參考資料
|
|
101
132
|
|
|
102
|
-
- [
|
|
103
|
-
- [
|
|
104
|
-
- [Git 工作流](git-workflow.md)
|
|
133
|
+
- **Superpowers**:[using-git-worktrees](https://github.com/obra/superpowers) (MIT)
|
|
134
|
+
- **Git 文件**:[git-worktree](https://git-scm.com/docs/git-worktree)
|