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,8 +1,9 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../core/refactoring-standards.md
|
|
3
|
-
source_version: 2.
|
|
4
|
-
translation_version: 2.
|
|
5
|
-
last_synced: 2026-
|
|
3
|
+
source_version: 2.2.0
|
|
4
|
+
translation_version: 2.2.0
|
|
5
|
+
last_synced: 2026-10-11
|
|
6
|
+
source_hash: e293ee5788ca
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
@@ -10,634 +11,218 @@ status: current
|
|
|
10
11
|
|
|
11
12
|
> **语言**: [English](../../../core/refactoring-standards.md) | 简体中文
|
|
12
13
|
|
|
13
|
-
**版本**: 2.
|
|
14
|
-
**最后更新**: 2026-01
|
|
15
|
-
**适用范围**:
|
|
14
|
+
**版本**: 2.2.0
|
|
15
|
+
**最后更新**: 2026-07-01
|
|
16
|
+
**适用范围**: 所有进行代码改进工作的软件项目
|
|
17
|
+
**范围**: partial
|
|
18
|
+
**业界标准**: ISO/IEC 25010 可维护性
|
|
19
|
+
|
|
20
|
+
> **详细模式与教程,请参阅 [重构指南](../../../core/guides/refactoring-guide.md)**
|
|
16
21
|
|
|
17
22
|
---
|
|
18
23
|
|
|
19
24
|
## 目的
|
|
20
25
|
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
**主要優点**:
|
|
24
|
-
- 系统化的程序码品质改善方法
|
|
25
|
-
- 降低重構過程中引入错误的風險
|
|
26
|
-
- 清晰的重構 vs 重写决策框架
|
|
27
|
-
- 可衡量的成果与投資报酬率追蹤
|
|
26
|
+
本标准定义代码重构的完整指引,涵盖从日常 TDD 重构循环到大型遗留系统现代化的所有场景。
|
|
28
27
|
|
|
29
28
|
---
|
|
30
29
|
|
|
31
|
-
##
|
|
32
|
-
|
|
33
|
-
1. [重構 vs 重写决策矩陣](#重構-vs-重写决策矩陣)
|
|
34
|
-
2. [依規模的重構策略](#依規模的重構策略)
|
|
35
|
-
3. [遺留程序码策略](#遺留程序码策略)
|
|
36
|
-
4. [大型重構模式](#大型重構模式)
|
|
37
|
-
5. [数据庫重構](#数据庫重構)
|
|
38
|
-
6. [安全重構工作流程](#安全重構工作流程)
|
|
39
|
-
7. [重構度量指標](#重構度量指標)
|
|
40
|
-
8. [团队协作](#团队协作)
|
|
41
|
-
9. [技術債管理](#技術債管理)
|
|
42
|
-
10. [相关标准](#相关标准)
|
|
43
|
-
11. [參考数据](#參考数据)
|
|
44
|
-
12. [版本歷程](#版本歷程)
|
|
45
|
-
|
|
46
|
-
---
|
|
30
|
+
## 重构 vs 重写决策矩阵
|
|
47
31
|
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
├─────────────────────────────────────────────────────────────────┤
|
|
58
|
-
│ │
|
|
59
|
-
│ 程序码目前在生产環境运行嗎? │
|
|
60
|
-
│ ├─ 否 → 考慮重写(風險較低) │
|
|
61
|
-
│ └─ 是 ↓ │
|
|
62
|
-
│ │
|
|
63
|
-
│ 你了解程序码在做什麼嗎? │
|
|
64
|
-
│ ├─ 否 → 先写特徵测试,再决定 │
|
|
65
|
-
│ └─ 是 ↓ │
|
|
66
|
-
│ │
|
|
67
|
-
│ 测试覆蓋率足夠嗎(>60%)? │
|
|
68
|
-
│ ├─ 否 → 先補测试,再决定 │
|
|
69
|
-
│ └─ 是 ↓ │
|
|
70
|
-
│ │
|
|
71
|
-
│ 核心架構可以保留嗎? │
|
|
72
|
-
│ ├─ 否 → Strangler Fig(漸进替换) │
|
|
73
|
-
│ └─ 是 → 漸进式重構 ✓ │
|
|
74
|
-
│ │
|
|
75
|
-
└─────────────────────────────────────────────────────────────────┘
|
|
76
|
-
```
|
|
77
|
-
|
|
78
|
-
### 比較矩陣
|
|
79
|
-
|
|
80
|
-
| 因素 | 傾向重構 | 傾向重写 |
|
|
81
|
-
|------|---------|---------|
|
|
82
|
-
| **程序码規模** | 大型、複雜 | 小型、獨立 |
|
|
83
|
-
| **测试覆蓋率** | 良好(>60%)| 差或没有 |
|
|
84
|
-
| **业务連續性** | 关鍵 | 可容忍停机 |
|
|
85
|
-
| **团队知識** | 团队理解程序码 | 無組織知識 |
|
|
86
|
-
| **核心架構** | 健全,只是混亂 | 根本性缺陷 |
|
|
87
|
-
| **时间壓力** | 緊迫期限 | 彈性时间 |
|
|
88
|
-
| **風險容忍度** | 低 | 較高 |
|
|
89
|
-
|
|
90
|
-
### 警告:第二系统效应
|
|
91
|
-
|
|
92
|
-
> 「第二个系统是一个人设计過最危險的系统。」— Fred Brooks
|
|
93
|
-
|
|
94
|
-
重写时,团队常常過度工程化。避免:
|
|
95
|
-
- 新增原本没有的功能
|
|
96
|
-
- 「为了未來彈性」過度抽象
|
|
97
|
-
- 忽视現有系统的教訓
|
|
32
|
+
| 因素 | 倾向重构 | 倾向重写 |
|
|
33
|
+
|------|----------|----------|
|
|
34
|
+
| **代码库规模** | 大型、复杂 | 小型、独立 |
|
|
35
|
+
| **测试覆盖率** | 良好(>60%) | 不足或没有 |
|
|
36
|
+
| **业务连续性** | 关键 | 可容忍停机 |
|
|
37
|
+
| **团队知识** | 团队理解代码 | 缺乏组织内的知识传承 |
|
|
38
|
+
| **核心架构** | 健全,只是凌乱 | 根本性缺陷 |
|
|
39
|
+
| **时间压力** | 期限紧迫 | 时程弹性 |
|
|
40
|
+
| **风险容忍度** | 低 | 较高 |
|
|
98
41
|
|
|
99
42
|
---
|
|
100
43
|
|
|
101
|
-
##
|
|
44
|
+
## 何时重构
|
|
102
45
|
|
|
103
|
-
|
|
46
|
+
| 情境 | 建议策略 |
|
|
47
|
+
|------|----------|
|
|
48
|
+
| 功能开发被凌乱的代码阻碍 | 预备性重构(Preparatory Refactoring) |
|
|
49
|
+
| 修复缺陷时顺带接触到代码 | 童子军规则(Boy Scout Rule) |
|
|
50
|
+
| 以 TDD 编写新代码 | 红-绿-重构(Red-Green-Refactor) |
|
|
51
|
+
| 替换整个遗留系统 | 绞杀者模式(Strangler Fig Pattern) |
|
|
52
|
+
| 需要与遗留系统集成但不被污染 | 防腐层(Anti-Corruption Layer) |
|
|
53
|
+
| 不使用功能分支重构共享代码 | 抽象分支(Branch by Abstraction) |
|
|
54
|
+
| 变更被广泛使用的接口 | 并行变更(Parallel Change,扩展-迁移-收缩) |
|
|
55
|
+
| 处理没有测试的遗留代码 | **先写**特征测试(Characterization Tests) |
|
|
104
56
|
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
**特点**:
|
|
108
|
-
- 时長:5-15 分鐘
|
|
109
|
-
- 範圍:单一方法或类别
|
|
110
|
-
- 测试:必須保持綠色
|
|
57
|
+
---
|
|
111
58
|
|
|
112
|
-
|
|
113
|
-
- 提取方法(Extract Method)
|
|
114
|
-
- 重新命名(Rename)
|
|
115
|
-
- 內联变數(Inline Variable)
|
|
116
|
-
- 以常數取代魔術數字(Replace Magic Number with Constant)
|
|
59
|
+
## 策略摘要
|
|
117
60
|
|
|
118
|
-
|
|
61
|
+
| 策略 | 规模 | 风险 | 时长 | 主要使用情境 |
|
|
62
|
+
|------|------|------|------|--------------|
|
|
63
|
+
| **预备性重构** | 小 | 低 | 数小时 | 在功能开发前降低阻力 |
|
|
64
|
+
| **童子军规则** | 极小 | 低 | 数分钟 | 持续偿还技术债 |
|
|
65
|
+
| **红-绿-重构** | 小 | 低 | 5-15 分钟 | TDD 开发循环 |
|
|
66
|
+
| **绞杀者模式** | 大 | 中 | 数月 | 系统替换 |
|
|
67
|
+
| **防腐层** | 中 | 低 | 数周 | 新旧系统共存 |
|
|
68
|
+
| **抽象分支** | 大 | 中 | 数周 | 在主干上进行长期重构 |
|
|
69
|
+
| **并行变更** | 中 | 低 | 数天至数周 | 接口/schema 迁移 |
|
|
70
|
+
| **特征测试** | — | — | — | **所有遗留代码重构的前提** |
|
|
119
71
|
|
|
120
|
-
|
|
72
|
+
---
|
|
121
73
|
|
|
122
|
-
|
|
123
|
-
- 时長:數小时到數天
|
|
124
|
-
- 範圍:单一功能或模組
|
|
125
|
-
- 测试:若缺少則補充特徵测试
|
|
74
|
+
## 安全重构工作流程
|
|
126
75
|
|
|
127
|
-
|
|
76
|
+
### 重构前
|
|
128
77
|
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
□ 与团队溝通(避免合併衝突)
|
|
135
|
-
```
|
|
78
|
+
- [ ] 定义成功标准(可衡量)
|
|
79
|
+
- [ ] 确保足够的测试覆盖率(建议 >80%)
|
|
80
|
+
- [ ] 提交或暂存(stash)当前工作(保持干净的工作目录)
|
|
81
|
+
- [ ] 创建功能分支(或在主干上配合功能开关工作)
|
|
82
|
+
- [ ] 与团队沟通以避免冲突
|
|
136
83
|
|
|
137
|
-
###
|
|
84
|
+
### 重构中
|
|
138
85
|
|
|
139
|
-
|
|
86
|
+
- [ ] 一次只做**一个**小变更
|
|
87
|
+
- [ ] **每次**变更后都运行测试
|
|
88
|
+
- [ ] 若测试失败,**立即**回退
|
|
89
|
+
- [ ] 频繁提交(每次测试通过都是一个保存点)
|
|
90
|
+
- [ ] 重构时绝不新增功能
|
|
140
91
|
|
|
141
|
-
|
|
142
|
-
- 时長:數周到數月
|
|
143
|
-
- 範圍:多个模組或整个系统
|
|
144
|
-
- 测试:需要完整的集成测试
|
|
92
|
+
### 重构后
|
|
145
93
|
|
|
146
|
-
|
|
94
|
+
- [ ] 所有测试通过(与重构前相同)
|
|
95
|
+
- [ ] 代码有可衡量的改善(复杂度、重复度等)
|
|
96
|
+
- [ ] 必要时更新文档
|
|
97
|
+
- [ ] 完成团队审查
|
|
98
|
+
- [ ] 没有新增功能
|
|
147
99
|
|
|
148
100
|
---
|
|
149
101
|
|
|
150
|
-
##
|
|
102
|
+
## 代码质量指标
|
|
151
103
|
|
|
152
|
-
|
|
104
|
+
### 目标指标
|
|
153
105
|
|
|
154
|
-
|
|
106
|
+
| 指标 | 目标 | 工具 |
|
|
107
|
+
|------|------|------|
|
|
108
|
+
| **圈复杂度** | 每个函数 < 10 | 静态分析 |
|
|
109
|
+
| **认知复杂度** | 越低越好 | SonarQube |
|
|
110
|
+
| **代码重复(文本)** | < 3% | 静态分析 |
|
|
111
|
+
| **语义重复** | 0 个未受管控的领域事实 | Golden 测试 / 架构测试(见下文) |
|
|
112
|
+
| **测试覆盖率** | ≥ 80% | 覆盖率工具 |
|
|
155
113
|
|
|
156
|
-
|
|
114
|
+
> **文本重复 vs 语义重复**:`Code Duplication` 指标只能检测*文本*重复(几乎相同的 token 序列),无法检测*语义*重复——同一个领域事实在多处被重新实现,或派生的聚合值被持久化却没有与其来源建立强制绑定。不是逐字节相同的副本(改写过的逻辑、在一处正确而在另一处错误的公式)能通过静态分析,却会持续各自漂移。语义重复必须由 golden 测试与架构测试来管控(参见[语义重复与复制漂移](#语义重复与复制漂移)),而非依赖上述静态分析阈值。
|
|
157
115
|
|
|
158
|
-
|
|
159
|
-
- 要安全地修改程序码,我們需要测试
|
|
160
|
-
- 要加测试,我們常常需要修改程序码
|
|
161
|
-
- 没有测试就修改程序码是有風險的
|
|
116
|
+
### ISO/IEC 25010 可维护性目标
|
|
162
117
|
|
|
163
|
-
|
|
118
|
+
| 子特性 | 指标 | 目标 |
|
|
119
|
+
|--------|------|------|
|
|
120
|
+
| **模块化(Modularity)** | 耦合度、文件大小 | 减少依赖 |
|
|
121
|
+
| **可复用性(Reusability)** | 代码重复 | 提取方法、DRY |
|
|
122
|
+
| **可分析性(Analysability)** | 圈复杂度 | 简化逻辑 |
|
|
123
|
+
| **可修改性(Modifiability)** | 内聚度、测试覆盖率 | 单一职责 |
|
|
124
|
+
| **可测试性(Testability)** | 分支覆盖率 | 依赖注入 |
|
|
164
125
|
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
**目的**:捕獲現有行为(不是验证正确性)
|
|
168
|
-
|
|
169
|
-
**流程**:
|
|
170
|
-
|
|
171
|
-
```
|
|
172
|
-
1. 呼叫你想了解的程序码
|
|
173
|
-
2. 写一个你预期会失败的斷言
|
|
174
|
-
3. 执行测试看实际發生什麼
|
|
175
|
-
4. 更新斷言以符合实际行为
|
|
176
|
-
5. 重複直到覆蓋你需要修改的行为
|
|
177
|
-
```
|
|
178
|
-
|
|
179
|
-
**範例**:
|
|
180
|
-
|
|
181
|
-
```javascript
|
|
182
|
-
// 步骤 1:初始(预期会失败)
|
|
183
|
-
test('calculateDiscount 回传... 某个值', () => {
|
|
184
|
-
const result = calculateDiscount(100, 'GOLD');
|
|
185
|
-
expect(result).toBe(0); // 猜测 - 可能会失败
|
|
186
|
-
});
|
|
126
|
+
---
|
|
187
127
|
|
|
188
|
-
|
|
189
|
-
test('calculateDiscount 对 GOLD 客戶回传 15', () => {
|
|
190
|
-
const result = calculateDiscount(100, 'GOLD');
|
|
191
|
-
expect(result).toBe(15); // 实际行为
|
|
192
|
-
});
|
|
193
|
-
```
|
|
128
|
+
## 语义重复与复制漂移
|
|
194
129
|
|
|
195
|
-
|
|
130
|
+
文本重复指标能抓到复制粘贴,却会漏掉更危险的情况:**同一个领域事实在不止一处被实现**。当这些实现并非逐字节相同时——改写过的分类逻辑、在某个调用点正确而在另一个调用点有细微错误的公式、与其汇总的明细行分开存储的总计——它们能通过静态分析,然后**各自独立地漂移**,产生看似无关、实则同一根因的缺陷。
|
|
196
131
|
|
|
197
|
-
|
|
132
|
+
### 反模式:复制漂移(Copy-Drift)
|
|
198
133
|
|
|
199
|
-
|
|
200
|
-
|---------|---------|------|
|
|
201
|
-
| **物件接縫** | 透過多型覆写 | 透過界面注入测试替身 |
|
|
202
|
-
| **预处理接縫** | 编譯时替换 | 条件编譯、巨集 |
|
|
203
|
-
| **連結接縫** | 連結时替换 | 依賴注入、模組替换 |
|
|
134
|
+
复制漂移在以下任一情况发生:
|
|
204
135
|
|
|
205
|
-
|
|
136
|
+
- 单一领域事实(分类、规则、计算)在**多个调用点被重新实现**,而不是由一个共享单元计算;或
|
|
137
|
+
- **派生值被持久化**(存储的聚合值、计数器或反规范化字段)**却没有与其来源建立强制关系**,导致每条写入路径都能独立更新它。
|
|
206
138
|
|
|
207
|
-
|
|
208
|
-
|-----|---------|-----|
|
|
209
|
-
| **Sprout Method** | 在現有方法中加入新邏辑 | 建立新方法,從舊方法呼叫 |
|
|
210
|
-
| **Sprout Class** | 新邏辑需要獨立演进 | 建立新类别,從舊程序码參照 |
|
|
211
|
-
| **Wrap Method** | 需要在前後加入行为 | 重命名原方法,建立包裝器 |
|
|
212
|
-
| **Wrap Class** | 裝飾現有类别 | 裝飾者模式 |
|
|
139
|
+
由于这些副本并非字面上完全相同,文本重复工具不会报告任何问题。分歧日后会以不一致的形式浮现:列表视图与详情视图不一致、存储的计数器因某条更新路径的递减分支被注释掉而重复计数,或同一个公式在不同模块中得出不同答案。
|
|
213
140
|
|
|
214
|
-
|
|
141
|
+
### 模式:单一事实来源 / 派生而非复制(Derive-Don't-Duplicate)
|
|
215
142
|
|
|
216
|
-
|
|
143
|
+
- **一个事实一个单元。** 将每个领域事实提取为**单一**的分类器 / 计算器 / 解析器。每个调用点都调用它——不重新实现,也不改写。
|
|
144
|
+
- **派生,而非存储。** 优先在读取时计算值,而不是持久化第二份副本。始终派生的值不会漂移。
|
|
145
|
+
- **若聚合值必须存储**,应将其视为**明细行的投影**,并在**单一关卡点**重新计算——例如 `SaveChanges` 拦截器,或一个共享的 `recompute()` 函数——让*每条*写入路径(包括异步作业与失败回写)都经过同一套重新计算并保持一致。**绝不**让个别路径对存储的聚合值做 `col = col + delta` 这类增量调整;增量调整正是递减/回滚分支被跳过、计数器出现分歧的根源。
|
|
146
|
+
- **用测试锁定。** 使用 **golden 测试**固定单一事实来源,并加入**架构测试**,一旦该规则在其他地方被重新定义就失败,让未来的副本在 CI 阶段就被拒绝,而不是在生产环境中才被发现。
|
|
217
147
|
|
|
218
|
-
|
|
148
|
+
### 迁移推论——刻意分歧登记表
|
|
219
149
|
|
|
220
|
-
|
|
221
|
-
1. 草稿重構(Scratch Refactoring)
|
|
222
|
-
├─ 重構以理解,不是保留
|
|
223
|
-
├─ 使用 git stash 或分支
|
|
224
|
-
└─ 完成後捨棄(git reset --hard)
|
|
150
|
+
当新系统**刻意**与遗留行为产生分歧时,必须记录下来——否则日后的“修复”会悄悄把它改回去。移植时常见的情况:遗留*函数*返回 X,但下游的遗留*流水线*会把它调和为 Y;移植时将这个调和过程并入单一单元,于是该函数现在直接返回 Y。
|
|
225
151
|
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
└─ 邊發現邊记录
|
|
152
|
+
- 将每项刻意分歧登记在**刻意分歧登记表**中(遗留行为、新行为、理由、所属事实)。
|
|
153
|
+
- 用 **golden 测试**固定新行为,让未来“修正”回遗留行为时构建失败。
|
|
154
|
+
- 将登记表提供给任何针对遗留系统的**差异测试**,使该分歧被视为*预期*,而不是被标记为回归。
|
|
230
155
|
|
|
231
|
-
|
|
232
|
-
├─ 加入暫时性日誌
|
|
233
|
-
├─ 使用除錯器逐步执行
|
|
234
|
-
└─ 建立心智模型
|
|
156
|
+
### 采用者注意事项
|
|
235
157
|
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
├─ git blame(找到原作者)
|
|
239
|
-
└─ 搜尋提交消息找脈络
|
|
240
|
-
```
|
|
158
|
+
- 逐函数比较遗留与新实现所得到的是**候选项,而非结论**。每个候选项都必须对照**整条**遗留流水线(而不只是单一函数)判定后,才能称为缺陷——遗留流水线可能已在下游调和了表面上的差异。
|
|
159
|
+
- 以**程序化 / 基于 token** 的方式(而非手动)提取遗留函数主体,以免在调查抄写错误时又引入新的抄写错误。
|
|
241
160
|
|
|
242
161
|
---
|
|
243
162
|
|
|
244
|
-
##
|
|
245
|
-
|
|
246
|
-
### Strangler Fig 模式
|
|
247
|
-
|
|
248
|
-
**使用时机**:漸进替换遺留系统
|
|
249
|
-
|
|
250
|
-
```
|
|
251
|
-
┌─────────────────────────────────────────────────────────────────┐
|
|
252
|
-
│ Strangler Fig 模式 │
|
|
253
|
-
├─────────────────────────────────────────────────────────────────┤
|
|
254
|
-
│ │
|
|
255
|
-
│ 阶段 1: 攔截(INTERCEPT) │
|
|
256
|
-
│ ┌─────────┐ ┌─────────┐ ┌─────────────┐ │
|
|
257
|
-
│ │ 请求 │────▶│ 門面 │────▶│ 舊系统(100%)│ │
|
|
258
|
-
│ └─────────┘ └─────────┘ └─────────────┘ │
|
|
259
|
-
│ │
|
|
260
|
-
│ 阶段 2: 迁移(MIGRATE) │
|
|
261
|
-
│ ┌─────────┐ ┌─────────┐ ┌─────────────┐ │
|
|
262
|
-
│ │ 请求 │────▶│ 門面 │──┬─▶│ 新系统(功能A)│ │
|
|
263
|
-
│ └─────────┘ └─────────┘ │ └─────────────┘ │
|
|
264
|
-
│ └─▶│ 舊系统(其餘) │ │
|
|
265
|
-
│ └─────────────┘ │
|
|
266
|
-
│ │
|
|
267
|
-
│ 阶段 3: 完成(COMPLETE) │
|
|
268
|
-
│ ┌─────────┐ ┌─────────────┐ │
|
|
269
|
-
│ │ 请求 │────▶│ 新系统(100%)│ [舊系统已下线] │
|
|
270
|
-
│ └─────────┘ └─────────────┘ │
|
|
271
|
-
│ │
|
|
272
|
-
└─────────────────────────────────────────────────────────────────┘
|
|
273
|
-
```
|
|
274
|
-
|
|
275
|
-
**检查清单**:
|
|
276
|
-
- [ ] 識别攔截点(API 閘道、門面、代理)
|
|
277
|
-
- [ ] 建立事件捕獲层
|
|
278
|
-
- [ ] 在新系统中实作第一个功能
|
|
279
|
-
- [ ] 漸进式路由流量
|
|
280
|
-
- [ ] 監控并比較結果
|
|
281
|
-
- [ ] 下线舊元件
|
|
282
|
-
|
|
283
|
-
### Branch by Abstraction
|
|
284
|
-
|
|
285
|
-
**使用时机**:在不用長期分支的情况下重構共享程序码
|
|
286
|
-
|
|
287
|
-
```
|
|
288
|
-
步骤 1:引入抽象
|
|
289
|
-
客户端 → 抽象(界面)→ 舊实作
|
|
290
|
-
|
|
291
|
-
步骤 2:新增新实作
|
|
292
|
-
客户端 → 抽象 → 舊实作
|
|
293
|
-
└─→ 新实作(功能開关控制)
|
|
294
|
-
|
|
295
|
-
步骤 3:切换并移除
|
|
296
|
-
客户端 → 新实作
|
|
297
|
-
[舊实作已移除]
|
|
298
|
-
```
|
|
299
|
-
|
|
300
|
-
**关鍵原則**:
|
|
301
|
-
- 所有变更在主幹(trunk)上(没有長期分支)
|
|
302
|
-
- 功能開关控制哪个实作是活躍的
|
|
303
|
-
- 兩个实作可以在過渡期共存
|
|
304
|
-
|
|
305
|
-
### 平行变更(Expand-Migrate-Contract)
|
|
306
|
-
|
|
307
|
-
**使用时机**:变更多个客户端使用的界面
|
|
308
|
-
|
|
309
|
-
```
|
|
310
|
-
阶段 1: 擴展(EXPAND)
|
|
311
|
-
├─ 在舊的旁邊新增新欄位/方法
|
|
312
|
-
├─ 新程序码使用新界面
|
|
313
|
-
└─ 舊程序码仍然运作
|
|
314
|
-
|
|
315
|
-
阶段 2: 迁移(MIGRATE)
|
|
316
|
-
├─ 更新所有客户端使用新界面
|
|
317
|
-
├─ 验证所有客户端已迁移
|
|
318
|
-
└─ 数据迁移(如需要)
|
|
319
|
-
|
|
320
|
-
阶段 3: 收縮(CONTRACT)
|
|
321
|
-
├─ 移除舊欄位/方法
|
|
322
|
-
├─ 清理迁移程序码
|
|
323
|
-
└─ 更新文件
|
|
324
|
-
```
|
|
163
|
+
## PR 大小指南
|
|
325
164
|
|
|
326
|
-
|
|
165
|
+
| 大小 | 变更行数 | 审查时间 | 建议 |
|
|
166
|
+
|------|----------|----------|------|
|
|
167
|
+
| 小 | < 200 | < 30 分钟 | ✅ 理想 |
|
|
168
|
+
| 中 | 200-500 | < 1 小时 | ⚠️ 可接受 |
|
|
169
|
+
| 大 | > 500 | — | ❌ **应拆分** |
|
|
327
170
|
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
### Schema 变更的 Expand-Contract 模式
|
|
331
|
-
|
|
332
|
-
```
|
|
333
|
-
┌─────────────────────────────────────────────────────────────────┐
|
|
334
|
-
│ 数据庫重構(Expand-Contract) │
|
|
335
|
-
├─────────────────────────────────────────────────────────────────┤
|
|
336
|
-
│ │
|
|
337
|
-
│ 阶段 1: 擴展(新增新的,保留舊的) │
|
|
338
|
-
│ ├─ 新增新欄位/表 │
|
|
339
|
-
│ ├─ 应用程序同时写入新舊 │
|
|
340
|
-
│ └─ 此时可安全回滾 │
|
|
341
|
-
│ │
|
|
342
|
-
│ 阶段 2: 迁移(搬移数据) │
|
|
343
|
-
│ ├─ 從舊複制数据到新 │
|
|
344
|
-
│ ├─ 验证数据一致性 │
|
|
345
|
-
│ └─ 应用程序開始從新读取 │
|
|
346
|
-
│ │
|
|
347
|
-
│ 阶段 3: 收縮(移除舊的) │
|
|
348
|
-
│ ├─ 确认舊欄位/表不再被读取 │
|
|
349
|
-
│ ├─ 移除舊欄位/表 │
|
|
350
|
-
│ └─ 清理雙写程序码 │
|
|
351
|
-
│ │
|
|
352
|
-
└─────────────────────────────────────────────────────────────────┘
|
|
353
|
-
```
|
|
354
|
-
|
|
355
|
-
### 常見 Schema 重構場景
|
|
356
|
-
|
|
357
|
-
| 場景 | 策略 | 風險等级 |
|
|
358
|
-
|-----|------|---------|
|
|
359
|
-
| **重命名欄位** | 新增新的 → 迁移 → 刪除舊的 | 中 |
|
|
360
|
-
| **拆分表格** | 新表 + 外鍵 → 迁移 → 調整应用程序 | 高 |
|
|
361
|
-
| **合併表格** | 新表 → 合併数据 → 切换应用程序 | 高 |
|
|
362
|
-
| **变更数据型别** | 新欄位 → 转换 → 切换应用程序 | 中 |
|
|
363
|
-
| **新增 NOT NULL** | 填入预设值 → 新增約束 | 低 |
|
|
364
|
-
|
|
365
|
-
### 数据庫迁移安全检查清单
|
|
366
|
-
|
|
367
|
-
```
|
|
368
|
-
迁移前:
|
|
369
|
-
□ 完整备份已完成
|
|
370
|
-
□ 迁移脚本已在测试環境验证
|
|
371
|
-
□ 回滾脚本已准备
|
|
372
|
-
□ 迁移时间已估算(考慮数据量)
|
|
373
|
-
□ 維護窗口已通知
|
|
374
|
-
|
|
375
|
-
迁移中:
|
|
376
|
-
□ 監控数据庫效能
|
|
377
|
-
□ 增量验证数据完整性
|
|
378
|
-
□ 应用程序健康检查通過
|
|
379
|
-
|
|
380
|
-
迁移後:
|
|
381
|
-
□ 数据一致性验证
|
|
382
|
-
□ 应用程序功能验证
|
|
383
|
-
□ 效能基线比較
|
|
384
|
-
□ 备份保留一段时间以供回滾
|
|
385
|
-
```
|
|
386
|
-
|
|
387
|
-
### 零停机迁移技術
|
|
388
|
-
|
|
389
|
-
| 技術 | 说明 | 使用場景 |
|
|
390
|
-
|-----|------|---------|
|
|
391
|
-
| **Online Schema Change** | pt-osc, gh-ost | MySQL 大表变更 |
|
|
392
|
-
| **Blue-Green Database** | 雙数据庫切换 | 高可用需求 |
|
|
393
|
-
| **Shadow Write** | 同时写入兩个数据庫并比較 | 验证迁移正确性 |
|
|
394
|
-
| **Feature Flag** | 控制读取來源 | 漸进式切换 |
|
|
171
|
+
**原则**:多个小 PR > 一个大 PR
|
|
395
172
|
|
|
396
173
|
---
|
|
397
174
|
|
|
398
|
-
##
|
|
175
|
+
## 技术债优先级
|
|
399
176
|
|
|
400
|
-
|
|
401
|
-
|
|
402
|
-
|
|
403
|
-
|
|
404
|
-
|
|
405
|
-
□ 提交/暫存當前工作(乾淨的工作目录)
|
|
406
|
-
□ 建立功能分支(或在主幹上使用功能開关)
|
|
407
|
-
□ 与团队溝通以避免衝突
|
|
408
|
-
```
|
|
409
|
-
|
|
410
|
-
### 重構中
|
|
411
|
-
|
|
412
|
-
```
|
|
413
|
-
□ 一次只做一个小变更
|
|
414
|
-
□ 每次变更後执行测试
|
|
415
|
-
□ 如果测试失败,立即復原
|
|
416
|
-
□ 頻繁提交(每次测试通過都是一个存檔点)
|
|
417
|
-
□ 重構时絕不加入新功能
|
|
418
|
-
```
|
|
419
|
-
|
|
420
|
-
### 重構後
|
|
421
|
-
|
|
422
|
-
```
|
|
423
|
-
□ 所有测试通過(与之前相同)
|
|
424
|
-
□ 程序码可衡量地更好(複雜度、重複等)
|
|
425
|
-
□ 如需要則更新文件
|
|
426
|
-
□ 团队审查完成
|
|
427
|
-
□ 没有新增功能
|
|
428
|
-
```
|
|
177
|
+
| 优先级 | 标准 | 行动 |
|
|
178
|
+
|--------|------|------|
|
|
179
|
+
| **高** | 阻碍开发、频繁引发缺陷 | 立即处理 |
|
|
180
|
+
| **中** | 拖慢开发、增加复杂度 | 排入下一个迭代 |
|
|
181
|
+
| **低** | 轻微困扰、影响范围局限 | 视机会处理 |
|
|
429
182
|
|
|
430
183
|
---
|
|
431
184
|
|
|
432
|
-
##
|
|
433
|
-
|
|
434
|
-
### 程序码品质指標
|
|
435
|
-
|
|
436
|
-
| 指標 | 测量方式 | 目標 |
|
|
437
|
-
|-----|---------|-----|
|
|
438
|
-
| **循環複雜度** | 静态分析工具 | 每函式 < 10 |
|
|
439
|
-
| **认知複雜度** | SonarQube 等 | 越低越好 |
|
|
440
|
-
| **耦合度** | 模組间依賴數 | 降低 |
|
|
441
|
-
| **內聚性** | LCOM 指標 | 提高 |
|
|
442
|
-
| **程序码重複** | 重複程序码百分比 | < 3% |
|
|
443
|
-
| **程序码行數** | 僅供參考 | 較少 ≠ 一定更好 |
|
|
185
|
+
## 数据库重构安全
|
|
444
186
|
|
|
445
|
-
###
|
|
187
|
+
### 迁移前检查清单
|
|
446
188
|
|
|
447
|
-
|
|
448
|
-
|
|
449
|
-
|
|
450
|
-
|
|
451
|
-
|
|
189
|
+
- [ ] 已完成完整备份
|
|
190
|
+
- [ ] 迁移脚本已在预发布(staging)环境测试
|
|
191
|
+
- [ ] 已准备回滚脚本
|
|
192
|
+
- [ ] 已估算迁移时间
|
|
193
|
+
- [ ] 已通知维护时段
|
|
452
194
|
|
|
453
|
-
###
|
|
195
|
+
### 迁移后检查清单
|
|
454
196
|
|
|
455
|
-
|
|
456
|
-
|
|
457
|
-
|
|
458
|
-
|
|
459
|
-
| **平均恢復时间** | 事故记录 | 縮短 |
|
|
460
|
-
| **前置时间** | 從提交到部署 | 縮短 |
|
|
461
|
-
|
|
462
|
-
### 团队效率指標
|
|
463
|
-
|
|
464
|
-
| 指標 | 测量方式 | 备註 |
|
|
465
|
-
|-----|---------|------|
|
|
466
|
-
| **新人上手时间** | 新員工熟悉时间 | 縮短 = 更好的可读性 |
|
|
467
|
-
| **PR 审查时间** | Git 记录 | 縮短 = 更好的可理解性 |
|
|
468
|
-
| **Bug 修復时间** | Issue 追蹤 | 縮短 = 更好的可維護性 |
|
|
469
|
-
|
|
470
|
-
### 重構 ROI 框架
|
|
471
|
-
|
|
472
|
-
```
|
|
473
|
-
成本:
|
|
474
|
-
├─ 开发时间 × 时薪
|
|
475
|
-
├─ 测试时间
|
|
476
|
-
├─ 部署風險成本
|
|
477
|
-
└─ 机会成本(未建置的功能)
|
|
478
|
-
|
|
479
|
-
收益:
|
|
480
|
-
├─ 減少的維護时间 × 未來年數
|
|
481
|
-
├─ 減少的 Bug × 修復成本
|
|
482
|
-
├─ 更快的功能开发
|
|
483
|
-
└─ 更低的人員流动成本
|
|
484
|
-
```
|
|
485
|
-
|
|
486
|
-
---
|
|
487
|
-
|
|
488
|
-
## 团队协作
|
|
489
|
-
|
|
490
|
-
### 重構项目啟动
|
|
491
|
-
|
|
492
|
-
```
|
|
493
|
-
啟动会議議程:
|
|
494
|
-
1. 範圍定義
|
|
495
|
-
├─ 哪些模組/文件在範圍內
|
|
496
|
-
└─ 明确排除什麼
|
|
497
|
-
|
|
498
|
-
2. 成功标准对齊
|
|
499
|
-
├─ 量化目標(複雜度降低 X%)
|
|
500
|
-
└─ 功能目標(行为不变)
|
|
501
|
-
|
|
502
|
-
3. 工作分配
|
|
503
|
-
├─ 按模組(垂直切分)
|
|
504
|
-
└─ 按层级(水平切分)
|
|
505
|
-
|
|
506
|
-
4. 風險评估
|
|
507
|
-
├─ 最高風險區域
|
|
508
|
-
└─ 回滾策略
|
|
509
|
-
```
|
|
510
|
-
|
|
511
|
-
### 分工策略
|
|
512
|
-
|
|
513
|
-
| 策略 | 使用时机 | 注意事项 |
|
|
514
|
-
|-----|---------|---------|
|
|
515
|
-
| **垂直切分** | 獨立模組 | 确保界面不变 |
|
|
516
|
-
| **水平切分** | 跨模組重構(如命名规范)| 需嚴格同步 |
|
|
517
|
-
| **Strangler 分工** | 大型系统替换 | 一人一个 Strangler 切片 |
|
|
518
|
-
| **Mob Programming** | 核心/高風險區域 | 全团队一起,降低風險 |
|
|
519
|
-
|
|
520
|
-
### 溝通机制
|
|
521
|
-
|
|
522
|
-
```
|
|
523
|
-
日常溝通:
|
|
524
|
-
├─ 站立会議同步重構进度
|
|
525
|
-
├─ 共享的重構看板(Kanban)
|
|
526
|
-
└─ 專用頻道(#refactoring-xxx)
|
|
527
|
-
|
|
528
|
-
PR 规范:
|
|
529
|
-
├─ 標題加 [Refactor] 前綴
|
|
530
|
-
├─ 说明改了什麼以及为什麼
|
|
531
|
-
├─ 包含前後複雜度比較
|
|
532
|
-
└─ 遺留程序码需要特徵测试
|
|
533
|
-
|
|
534
|
-
衝突处理:
|
|
535
|
-
├─ 小範圍:立即解决
|
|
536
|
-
├─ 中範圍:每日同步会議
|
|
537
|
-
└─ 大範圍:考慮 Branch by Abstraction
|
|
538
|
-
```
|
|
539
|
-
|
|
540
|
-
### PR 大小指引
|
|
541
|
-
|
|
542
|
-
| 大小 | 变更行數 | 审查时间 |
|
|
543
|
-
|-----|---------|---------|
|
|
544
|
-
| 小 | < 200 | < 30 分鐘 |
|
|
545
|
-
| 中 | 200-500 | < 1 小时 |
|
|
546
|
-
| 大 | > 500 | **应該拆分** |
|
|
547
|
-
|
|
548
|
-
**原則**:多个小 PR > 一个大 PR
|
|
549
|
-
|
|
550
|
-
---
|
|
551
|
-
|
|
552
|
-
## 技術債管理
|
|
553
|
-
|
|
554
|
-
### 技術債象限
|
|
555
|
-
|
|
556
|
-
基於 Martin Fowler 的技術債象限:
|
|
557
|
-
|
|
558
|
-
```
|
|
559
|
-
刻意的
|
|
560
|
-
│
|
|
561
|
-
┌────────────────┼────────────────┐
|
|
562
|
-
│ │ │
|
|
563
|
-
│ 审慎的 │ 魯莽的 │
|
|
564
|
-
│ 「我們知道 │ 「我們没时间 │
|
|
565
|
-
│ 这是債务」 │ 做设计」 │
|
|
566
|
-
│ │ │
|
|
567
|
-
审慎的 ├────────────────┼────────────────┤ 魯莽的
|
|
568
|
-
│ │ │
|
|
569
|
-
│ 审慎的 │ 魯莽的 │
|
|
570
|
-
│ 「現在我們 │ 「什麼是 │
|
|
571
|
-
│ 知道該怎麼 │ 分层?」 │
|
|
572
|
-
│ 做了」 │ │
|
|
573
|
-
│ │ │
|
|
574
|
-
└────────────────┼────────────────┘
|
|
575
|
-
│
|
|
576
|
-
無意的
|
|
577
|
-
```
|
|
578
|
-
|
|
579
|
-
### 債务優先順序
|
|
580
|
-
|
|
581
|
-
| 優先级 | 标准 | 行动 |
|
|
582
|
-
|-------|------|-----|
|
|
583
|
-
| **高** | 阻擋开发、導致頻繁 Bug | 立即处理 |
|
|
584
|
-
| **中** | 拖慢开发、增加複雜度 | 排入下个 Sprint |
|
|
585
|
-
| **低** | 小煩惱、影響隔離 | 隨机处理 |
|
|
586
|
-
|
|
587
|
-
### 追蹤技術債
|
|
588
|
-
|
|
589
|
-
```
|
|
590
|
-
每个債务项目记录:
|
|
591
|
-
├─ 描述:問題是什麼?
|
|
592
|
-
├─ 影響:如何影響开发?
|
|
593
|
-
├─ 估计工作量:修復需要多久?
|
|
594
|
-
├─ 忽视的風險:不处理会怎样?
|
|
595
|
-
└─ 相关程序码:受影響的文件/模組連結
|
|
596
|
-
```
|
|
197
|
+
- [ ] 数据一致性验证
|
|
198
|
+
- [ ] 应用功能验证
|
|
199
|
+
- [ ] 性能基线比较
|
|
200
|
+
- [ ] 在回滚期间保留备份
|
|
597
201
|
|
|
598
202
|
---
|
|
599
203
|
|
|
600
204
|
## 相关标准
|
|
601
205
|
|
|
602
|
-
- [
|
|
603
|
-
- [
|
|
604
|
-
- [
|
|
605
|
-
- [
|
|
606
|
-
|
|
607
|
-
|
|
608
|
-
|
|
609
|
-
## 參考数据
|
|
610
|
-
|
|
611
|
-
### 書籍
|
|
612
|
-
|
|
613
|
-
- Martin Fowler -《重構:改善既有程序的设计》第二版(2018)
|
|
614
|
-
- Michael Feathers -《Working Effectively with Legacy Code》(2004)
|
|
615
|
-
- Joshua Kerievsky -《Refactoring to Patterns》(2004)
|
|
616
|
-
|
|
617
|
-
### 文章
|
|
618
|
-
|
|
619
|
-
- Martin Fowler - [Strangler Fig Application](https://martinfowler.com/bliki/StranglerFigApplication.html)
|
|
620
|
-
- Martin Fowler - [Branch by Abstraction](https://martinfowler.com/bliki/BranchByAbstraction.html)
|
|
621
|
-
- Pete Hodgson - [Feature Toggles](https://martinfowler.com/articles/feature-toggles.html)
|
|
622
|
-
- Martin Fowler - [Technical Debt Quadrant](https://martinfowler.com/bliki/TechnicalDebtQuadrant.html)
|
|
623
|
-
|
|
624
|
-
### 工具
|
|
625
|
-
|
|
626
|
-
- [Refactoring Guru](https://refactoring.guru/) - 重構技術目录
|
|
627
|
-
- [SonarQube](https://www.sonarqube.org/) - 程序码品质与複雜度分析
|
|
628
|
-
- [ApprovalTests](https://approvaltests.com/) - Golden Master 测试
|
|
206
|
+
- [测试驱动开发](test-driven-development.md) - 包含重构阶段的 TDD 循环
|
|
207
|
+
- [测试标准](testing-standards.md) - 用于锁定单一事实来源的 golden 测试与架构测试
|
|
208
|
+
- [测试治理](test-governance.md) - 在 CI 中管控语义重复与刻意分歧检查
|
|
209
|
+
- [代码审查检查清单](code-review-checklist.md) - 重构 PR 审查指引
|
|
210
|
+
- [提交信息指南](commit-message-guide.md) - `refactor` 提交类型
|
|
211
|
+
- [代码签入标准](checkin-standards.md) - 提交前要求
|
|
629
212
|
|
|
630
213
|
---
|
|
631
214
|
|
|
632
|
-
##
|
|
215
|
+
## 版本历史
|
|
633
216
|
|
|
634
217
|
| 版本 | 日期 | 变更 |
|
|
635
|
-
|
|
636
|
-
| 2.
|
|
218
|
+
|------|------|------|
|
|
219
|
+
| 2.2.0 | 2026-07-01 | 新增语义重复与复制漂移(issue #142):复制漂移反模式、单一事实来源 / 派生而非复制模式、刻意分歧登记表迁移推论;将重复指标拆分为文本与语义两类 |
|
|
220
|
+
| 2.1.0 | 2026-01-29 | 重构:拆分为规则 + 指南,将详细模式移至指南 |
|
|
221
|
+
| 2.0.0 | 2026-01-21 | 重大重组:新增战术性策略、防腐层 |
|
|
637
222
|
| 1.0.0 | 2026-01-12 | 初始重构标准定义 |
|
|
638
223
|
|
|
639
224
|
---
|
|
640
225
|
|
|
641
226
|
## 授权
|
|
642
227
|
|
|
643
|
-
本标准以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/)
|
|
228
|
+
本标准以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权发布。
|