universal-dev-standards 6.14.0-beta.8 → 6.14.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/bin/uds.js +12 -1
- package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
- package/bundled/ai/standards/commit-message.ai.yaml +12 -2
- package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
- package/bundled/core/commit-message-guide.md +22 -19
- package/bundled/core/secret-management-standards.md +13 -1
- package/bundled/extensions/locales/zh-tw.md +19 -19
- package/bundled/hooks/validate-commit-msg.mjs +52 -9
- package/bundled/locales/zh-CN/CHANGELOG.md +2312 -1102
- package/bundled/locales/zh-CN/CLAUDE.md +987 -101
- package/bundled/locales/zh-CN/README.md +3 -3
- package/bundled/locales/zh-CN/SECURITY.md +3 -3
- package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
- package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
- package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
- package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
- package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
- package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
- package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
- package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
- package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
- package/bundled/locales/zh-CN/core/accessibility-standards.md +871 -62
- package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
- package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
- package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
- package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
- package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +311 -72
- package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
- package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
- package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
- package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
- package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
- package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
- package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
- package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
- package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
- package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
- package/bundled/locales/zh-CN/core/changelog-standards.md +485 -63
- package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
- package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
- package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
- package/bundled/locales/zh-CN/core/code-review-checklist.md +37 -23
- package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
- package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
- package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
- package/bundled/locales/zh-CN/core/database-standards.md +115 -114
- package/bundled/locales/zh-CN/core/deprecation-standards.md +155 -40
- package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
- package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
- package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
- package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
- package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
- package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
- package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
- package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
- package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
- package/bundled/locales/zh-CN/core/execution-history.md +2 -1
- package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
- package/bundled/locales/zh-CN/core/feature-flag-standards.md +202 -57
- package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
- package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
- package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
- package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
- package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
- package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
- package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
- package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
- package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
- package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
- package/bundled/locales/zh-CN/core/mutation-testing.md +45 -6
- package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
- package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
- package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
- package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
- package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
- package/bundled/locales/zh-CN/core/project-structure.md +550 -170
- package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
- package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
- package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
- package/bundled/locales/zh-CN/core/retrospective-standards.md +215 -22
- package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
- package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
- package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
- package/bundled/locales/zh-CN/core/security-decision.md +45 -70
- package/bundled/locales/zh-CN/core/security-standards.md +169 -16
- package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
- package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
- package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
- package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
- package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
- package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
- package/bundled/locales/zh-CN/core/supply-chain-security-standards.md +159 -32
- package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
- package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
- package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
- package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
- package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
- package/bundled/locales/zh-CN/core/test-governance.md +94 -43
- package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
- package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
- package/bundled/locales/zh-CN/core/token-budget.md +44 -80
- package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
- package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
- package/bundled/locales/zh-CN/core/versioning.md +737 -73
- package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
- package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
- package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
- package/bundled/locales/zh-CN/docs/CHEATSHEET.md +2 -1
- package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
- package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
- package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
- package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
- package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
- package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
- package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +2 -0
- package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
- package/bundled/locales/zh-CN/docs/user/README.md +4 -2
- package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
- package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
- package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
- package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
- package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
- package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
- package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
- package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
- package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
- package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
- package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
- package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
- package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
- package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
- package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
- package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
- package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
- package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
- package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
- package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
- package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
- package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
- package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
- package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
- package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
- package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
- package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
- package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
- package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
- package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
- package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
- package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
- package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
- package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
- package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
- package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
- package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
- package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
- package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
- package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
- package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
- package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
- package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/skills/README.md +2 -1
- package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
- package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
- package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
- package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
- package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
- package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
- package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +217 -137
- package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
- package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
- package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
- package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +148 -132
- package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
- package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
- package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
- package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +122 -121
- package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
- package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
- package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
- package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
- package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
- package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
- package/bundled/locales/zh-CN/skills/code-review-assistant/guide.md +119 -45
- package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
- package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
- package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
- package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
- package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
- package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
- package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
- package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
- package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
- package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
- package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
- package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
- package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
- package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
- package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
- package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
- package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
- package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
- package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
- package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
- package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
- package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
- package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
- package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
- package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
- package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
- package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
- package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +4 -4
- package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
- package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
- package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
- package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
- package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
- package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +4 -2
- package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
- package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
- package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/docs-generator/guide.md +8 -7
- package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
- package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
- package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
- package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
- package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
- package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
- package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
- package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
- package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
- package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
- package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
- package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
- package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
- package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
- package/bundled/locales/zh-CN/skills/project-discovery/guide.md +158 -157
- package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
- package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
- package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
- package/bundled/locales/zh-CN/skills/refactoring-assistant/guide.md +172 -171
- package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
- package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
- package/bundled/locales/zh-CN/skills/release-standards/guide.md +51 -43
- package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
- package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
- package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
- package/bundled/locales/zh-CN/skills/requirement-assistant/guide.md +88 -79
- package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
- package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
- package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
- package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
- package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
- package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
- package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
- package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
- package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
- package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
- package/bundled/locales/zh-CN/skills/tdd-assistant/guide.md +217 -156
- package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
- package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
- package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
- package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +25 -12
- package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
- package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
- package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
- package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
- package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
- package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
- package/bundled/locales/zh-TW/CHANGELOG.md +2291 -1110
- package/bundled/locales/zh-TW/CLAUDE.md +962 -76
- package/bundled/locales/zh-TW/README.md +3 -3
- package/bundled/locales/zh-TW/SECURITY.md +3 -3
- package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
- package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
- package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
- package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
- package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
- package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
- package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
- package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
- package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
- package/bundled/locales/zh-TW/core/accessibility-standards.md +895 -46
- package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
- package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
- package/bundled/locales/zh-TW/core/agent-dispatch.md +102 -33
- package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
- package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
- package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
- package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
- package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
- package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
- package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
- package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
- package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
- package/bundled/locales/zh-TW/core/branch-completion.md +130 -34
- package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
- package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
- package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
- package/bundled/locales/zh-TW/core/chaos-engineering-standards.md +138 -36
- package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
- package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
- package/bundled/locales/zh-TW/core/code-review-checklist.md +19 -7
- package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
- package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
- package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
- package/bundled/locales/zh-TW/core/database-standards.md +2 -1
- package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
- package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
- package/bundled/locales/zh-TW/core/developer-memory.md +102 -12
- package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
- package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
- package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
- package/bundled/locales/zh-TW/core/environment-standards.md +250 -72
- package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
- package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
- package/bundled/locales/zh-TW/core/execution-history.md +2 -1
- package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
- package/bundled/locales/zh-TW/core/feature-flag-standards.md +202 -57
- package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
- package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
- package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
- package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
- package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +234 -487
- package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
- package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
- package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
- package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
- package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
- package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
- package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
- package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
- package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
- package/bundled/locales/zh-TW/core/observability-standards.md +284 -40
- package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
- package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
- package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
- package/bundled/locales/zh-TW/core/project-context-memory.md +210 -31
- package/bundled/locales/zh-TW/core/project-structure.md +240 -19
- package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
- package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
- package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
- package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
- package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
- package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
- package/bundled/locales/zh-TW/core/runbook-standards.md +296 -23
- package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
- package/bundled/locales/zh-TW/core/security-decision.md +43 -84
- package/bundled/locales/zh-TW/core/security-standards.md +204 -25
- package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
- package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
- package/bundled/locales/zh-TW/core/slo-standards.md +301 -49
- package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
- package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
- package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
- package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
- package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
- package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
- package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
- package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
- package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
- package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
- package/bundled/locales/zh-TW/core/test-governance.md +92 -32
- package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
- package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
- package/bundled/locales/zh-TW/core/token-budget.md +41 -112
- package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
- package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
- package/bundled/locales/zh-TW/core/versioning.md +6 -2
- package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
- package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
- package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
- package/bundled/locales/zh-TW/docs/CHEATSHEET.md +2 -1
- package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
- package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
- package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
- package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
- package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
- package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
- package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
- package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +2 -0
- package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
- package/bundled/locales/zh-TW/docs/user/README.md +2 -0
- package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
- package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
- package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
- package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
- package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
- package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
- package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
- package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
- package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
- package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
- package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
- package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
- package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
- package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +584 -475
- package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
- package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
- package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
- package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
- package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
- package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
- package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
- package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
- package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
- package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
- package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
- package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
- package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
- package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
- package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
- package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
- package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
- package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
- package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
- package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
- package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
- package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
- package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
- package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
- package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
- package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
- package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
- package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/skills/README.md +2 -1
- package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
- package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
- package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
- package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
- package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
- package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
- package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
- package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
- package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
- package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
- package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
- package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
- package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
- package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
- package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
- package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
- package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
- package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
- package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
- package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
- package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
- package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
- package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
- package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
- package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
- package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
- package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
- package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
- package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
- package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
- package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
- package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
- package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
- package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
- package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
- package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
- package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
- package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
- package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
- package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
- package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
- package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
- package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
- package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
- package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
- package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
- package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
- package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
- package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
- package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
- package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
- package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
- package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
- package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
- package/bundled/locales/zh-TW/skills/commit-standards/guide.md +137 -17
- package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
- package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
- package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
- package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
- package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
- package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
- package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
- package/bundled/locales/zh-TW/skills/docs-generator/guide.md +4 -3
- package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
- package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
- package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
- package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
- package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
- package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
- package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
- package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
- package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
- package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
- package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
- package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
- package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +85 -18
- package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
- package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
- package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
- package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
- package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
- package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
- package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
- package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +91 -45
- package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
- package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
- package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
- package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
- package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
- package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
- package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
- package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
- package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
- package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
- package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
- package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
- package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
- package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
- package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
- package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
- package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
- package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
- package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
- package/bundled/locales/zh-TW/skills/tdd-assistant/language-examples.md +693 -47
- package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
- package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
- package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
- package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
- package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
- package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
- package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
- package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
- package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
- package/bundled/skills/.claude-plugin/plugin.json +71 -0
- package/bundled/skills/commit-standards/SKILL.md +2 -2
- package/bundled/skills/commit-standards/guide.md +3 -2
- package/bundled/skills/commit-standards/language-options.md +19 -17
- package/package.json +2 -2
- package/src/commands/audit.js +28 -1
- package/src/commands/check.js +77 -7
- package/src/commands/compile.js +37 -4
- package/src/commands/config.js +49 -24
- package/src/commands/init.js +78 -30
- package/src/commands/open-work.js +6 -2
- package/src/commands/release-messages.js +228 -0
- package/src/commands/release.js +127 -68
- package/src/commands/run-intent.js +11 -0
- package/src/commands/spec-split.js +2 -1
- package/src/commands/spec.js +11 -2
- package/src/commands/update.js +184 -30
- package/src/compilers/claude-code-compiler.js +9 -1
- package/src/config/ai-agent-paths.js +14 -1
- package/src/core/installed-formats.js +15 -0
- package/src/core/open-work-config.js +20 -1
- package/src/core/project-config.js +55 -0
- package/src/i18n/messages.js +160 -2
- package/src/installers/hooks-installer.js +1 -1
- package/src/installers/manifest-installer.js +1 -1
- package/src/installers/skills-installer.js +1 -1
- package/src/installers/standards-installer.js +3 -1
- package/src/mcp/server.js +9 -3
- package/src/prompts/init.js +26 -22
- package/src/reconciler/actual-state-scanner.js +2 -8
- package/src/reconciler/backup-locations.js +5 -0
- package/src/reconciler/backup-manager.js +19 -11
- package/src/reconciler/desired-state-calculator.js +89 -57
- package/src/reconciler/plan-executor.js +101 -8
- package/src/reconciler/recorded-versions.js +49 -0
- package/src/reconciler/relative-path.js +23 -0
- package/src/uninstallers/hook-uninstaller.js +9 -1
- package/src/uninstallers/skills-uninstaller.js +22 -3
- package/src/utils/available-standards-report.js +25 -4
- package/src/utils/available-standards.js +13 -3
- package/src/utils/build-manifest.js +1 -1
- package/src/utils/commit-message-judge.js +60 -13
- package/src/utils/friction-detector.js +23 -11
- package/src/utils/git-hooks.js +106 -4
- package/src/utils/integration-generator.js +95 -67
- package/src/utils/legacy-hook-migration.js +121 -2
- package/src/utils/open-work-tracking.mjs +105 -16
- package/src/utils/sdd-header.js +16 -4
- package/src/utils/skills-installer.js +2 -1
- package/src/utils/spinner.js +14 -4
- package/src/utils/standard-validator.js +3 -2
- package/standards-registry.json +10 -8
- package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
|
@@ -1,30 +1,32 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../core/commit-message-guide.md
|
|
3
|
-
source_version: 1.
|
|
4
|
-
translation_version: 1.
|
|
5
|
-
last_synced: 2026-
|
|
3
|
+
source_version: 1.4.0
|
|
4
|
+
translation_version: 1.4.0
|
|
5
|
+
last_synced: 2026-10-16
|
|
6
|
+
source_hash: 8bf9a79dc6d1
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
9
|
-
> **语言**: [English](../../../core/commit-message-guide.md) | [简体中文](../../zh-TW/core/commit-message-guide.md) | 简体中文
|
|
10
|
-
|
|
11
10
|
# 提交消息指南
|
|
12
11
|
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
12
|
+
> **语言**: [English](../../../core/commit-message-guide.md) | [繁體中文](../../zh-TW/core/commit-message-guide.md) | 简体中文
|
|
13
|
+
|
|
14
|
+
**版本**: 1.4.0
|
|
15
|
+
**最后更新**: 2026-10-12
|
|
16
|
+
**适用范围**: 所有使用 Git 版本控制的项目
|
|
17
|
+
**范畴**: 通用
|
|
18
|
+
**行业标准**: Conventional Commits 1.0.0
|
|
19
|
+
**参考资料**: [conventionalcommits.org](https://www.conventionalcommits.org/)
|
|
16
20
|
|
|
17
21
|
---
|
|
18
22
|
|
|
19
23
|
## 目的
|
|
20
24
|
|
|
21
|
-
|
|
25
|
+
标准化的提交消息可提高代码审查效率,促进自动化变更日志生成,并使项目历史易于搜索与理解。
|
|
22
26
|
|
|
23
27
|
---
|
|
24
28
|
|
|
25
|
-
##
|
|
26
|
-
|
|
27
|
-
### 标准格式
|
|
29
|
+
## 基本格式
|
|
28
30
|
|
|
29
31
|
```
|
|
30
32
|
<type>(<scope>): <subject>
|
|
@@ -34,115 +36,936 @@ status: current
|
|
|
34
36
|
<footer>
|
|
35
37
|
```
|
|
36
38
|
|
|
37
|
-
###
|
|
39
|
+
### 组成部分
|
|
38
40
|
|
|
39
|
-
|
|
|
40
|
-
|
|
41
|
-
| type
|
|
42
|
-
| scope
|
|
43
|
-
| subject |
|
|
44
|
-
| body
|
|
45
|
-
| footer
|
|
41
|
+
| 组成部分 | 必要性 | 说明 |
|
|
42
|
+
| ----------- | ----------- | ---------------------------------- |
|
|
43
|
+
| `type` | ✅ 是 | 变更类型 |
|
|
44
|
+
| `scope` | 可选 | 受影响的模块/组件 |
|
|
45
|
+
| `subject` | ✅ 是 | 简短描述(≤72 字符) |
|
|
46
|
+
| `body` | 建议提供 | 详细说明 |
|
|
47
|
+
| `footer` | 可选 | Issue 引用、破坏性变更 |
|
|
46
48
|
|
|
47
49
|
---
|
|
48
50
|
|
|
49
|
-
##
|
|
51
|
+
## 类型分类
|
|
50
52
|
|
|
51
|
-
|
|
52
|
-
|------|------|------|
|
|
53
|
-
| feat | 新功能 | 添加用户登录功能 |
|
|
54
|
-
| fix | 错误修复 | 修复支付金额计算错误 |
|
|
55
|
-
| docs | 文档变更 | 更新 API 文档 |
|
|
56
|
-
| style | 格式调整(不影响代码逻辑) | 调整代码缩进 |
|
|
57
|
-
| refactor | 重构(非新功能、非错误修复) | 重构用户认证模块 |
|
|
58
|
-
| perf | 性能优化 | 优化数据库查询 |
|
|
59
|
-
| test | 测试相关 | 添加单元测试 |
|
|
60
|
-
| build | 构建系统变更 | 更新 webpack 配置 |
|
|
61
|
-
| ci | CI 配置变更 | 更新 GitHub Actions |
|
|
62
|
-
| chore | 其他变更 | 更新依赖版本 |
|
|
63
|
-
| revert | 回滚提交 | 回滚上一次提交 |
|
|
53
|
+
**项目必须选择一种语言**作为类型并在整个项目中保持一致。
|
|
64
54
|
|
|
65
|
-
|
|
55
|
+
### 选项 A:英文(国际化)
|
|
56
|
+
|
|
57
|
+
适用于国际化团队以及需要最大工具兼容性的场景。
|
|
58
|
+
|
|
59
|
+
| 类型 | 使用时机 |
|
|
60
|
+
| ------------ | --------------------------------------------- |
|
|
61
|
+
| `feat` | 新功能 |
|
|
62
|
+
| `fix` | 错误修复 |
|
|
63
|
+
| `refactor` | 代码重构(无功能变更) |
|
|
64
|
+
| `docs` | 仅文档变更 |
|
|
65
|
+
| `style` | 格式调整、空白符(无代码逻辑变更) |
|
|
66
|
+
| `test` | 添加或更新测试 |
|
|
67
|
+
| `perf` | 性能改进 |
|
|
68
|
+
| `build` | 构建系统或外部依赖变更 |
|
|
69
|
+
| `ci` | CI/CD 流水线变更 |
|
|
70
|
+
| `chore` | 日常维护任务 |
|
|
71
|
+
| `revert` | 回滚先前的提交 |
|
|
72
|
+
| `security` | 安全漏洞修复 |
|
|
66
73
|
|
|
67
|
-
|
|
74
|
+
### 选项 B:繁体中文(中国台湾团队)
|
|
68
75
|
|
|
69
|
-
|
|
76
|
+
使用**选项 A 的英文类型**,搭配繁体中文的主题(subject)与正文(body),适用于偏好母语提交的本地团队。类型保持英文是因为工具需要读取它(commitlint 的 `type-enum`、变更日志生成器、`uds simulate`);只有主题和正文使用中文。**不允许**使用类似 `新增` 的中文类型。
|
|
77
|
+
|
|
78
|
+
| 类型 | 使用时机 | 示例 |
|
|
79
|
+
| ---------- | --------------------- | --------------------------------- |
|
|
80
|
+
| `feat` | 新功能 | `feat(auth): 加入 OAuth2 登入` |
|
|
81
|
+
| `fix` | 错误修复 | `fix(api): 處理空值回應` |
|
|
82
|
+
| `refactor` | 代码重构 | `refactor(core): 簡化驗證邏輯` |
|
|
83
|
+
| `docs` | 仅文档变更 | `docs(readme): 更新安裝指南` |
|
|
84
|
+
| `style` | 仅格式调整 | `style(lint): 修正縮排` |
|
|
85
|
+
| `test` | 添加/更新测试 | `test(auth): 新增登入單元測試` |
|
|
86
|
+
| `perf` | 性能改进 | `perf(query): 最佳化資料庫查詢` |
|
|
87
|
+
| `build` | 构建系统 | `build(deps): 升級 lodash` |
|
|
88
|
+
| `ci` | CI/CD 变更 | `ci(github): 新增覆蓋率工作流程` |
|
|
89
|
+
| `chore` | 日常维护 | `chore(deps): 更新開發相依套件` |
|
|
90
|
+
| `revert` | 回滚提交 | `revert: feat(auth): 加入 OAuth2 登入` |
|
|
91
|
+
| `security` | 安全修复 | `security(auth): 修正 XSS 漏洞` |
|
|
92
|
+
|
|
93
|
+
> **1.4.0 变更** (XSPEC-475):此选项的早期版本列出了中文类型(`新增`、`修正` 等)。它们已不再被允许;曾使用这些类型的项目应通过将其替换为英文等效项来进行迁移(`新增` → `feat`、`修正` → `fix`、`重構` → `refactor`、`文件` → `docs`、`樣式` → `style`、`測試` → `test`、`效能` → `perf`、`建置` → `build`、`整合` → `ci`、`維護` → `chore`、`回退` → `revert`、`安全` → `security`)。
|
|
94
|
+
|
|
95
|
+
### 选项 C:双语模式(推荐)
|
|
96
|
+
|
|
97
|
+
使用英文的 `type` 和 `scope` 以保证工具兼容性,主题/正文/页脚则采用双语。
|
|
98
|
+
|
|
99
|
+
**格式**:
|
|
70
100
|
|
|
71
101
|
```
|
|
72
|
-
|
|
102
|
+
<type>(<scope>): <English subject>. <Chinese subject>.
|
|
103
|
+
|
|
104
|
+
<English body>
|
|
105
|
+
|
|
106
|
+
<Chinese body>
|
|
107
|
+
|
|
108
|
+
<footer>
|
|
73
109
|
```
|
|
74
110
|
|
|
75
|
-
|
|
111
|
+
**示例**:
|
|
76
112
|
|
|
77
113
|
```
|
|
78
|
-
|
|
114
|
+
feat(auth): Add OAuth2 Google login support. 新增 OAuth2 Google 登入支援。
|
|
115
|
+
|
|
116
|
+
Implement Google OAuth2 authentication flow for user login.
|
|
117
|
+
|
|
118
|
+
- Add Google OAuth2 SDK integration
|
|
119
|
+
- Create callback endpoint for OAuth flow
|
|
120
|
+
- Store refresh tokens securely
|
|
121
|
+
|
|
122
|
+
實作 Google OAuth2 認證流程供使用者登入。
|
|
79
123
|
|
|
80
|
-
|
|
81
|
-
|
|
124
|
+
- 整合 Google OAuth2 SDK
|
|
125
|
+
- 建立 OAuth 流程回呼端點
|
|
126
|
+
- 安全儲存更新權杖
|
|
82
127
|
|
|
83
128
|
Closes #123
|
|
84
129
|
```
|
|
85
130
|
|
|
86
|
-
|
|
131
|
+
> **注意**: 此配置项在项目清单中名为 `output_language`。它同时控制提交消息语言与文档语言。关于此配置项如何影响文档的详细信息,请参阅 [documentation-writing-standards.md](documentation-writing-standards.md#documentation-language-configuration)。
|
|
132
|
+
|
|
133
|
+
### 语言选择指南
|
|
134
|
+
|
|
135
|
+
使用本指南为您的项目选择合适的提交消息语言:
|
|
136
|
+
|
|
137
|
+
| 考量因素 | 英文 | 繁体中文 | 双语 |
|
|
138
|
+
|--------|---------|---------------------|-----------|
|
|
139
|
+
| **团队构成** | 国际化/混合团队 | 本地团队(中国台湾) | 混合团队且以本地为主 |
|
|
140
|
+
| **工具兼容性** | ✅ 最佳 | ⚠️ 受限 | ✅ 良好 |
|
|
141
|
+
| **变更日志自动化** | ✅ 完全支持 | ⚠️ 需自定义配置 | ✅ 支持 |
|
|
142
|
+
| **新人入职培训** | 中立 | 本地成员更容易上手 | 双双获益 |
|
|
143
|
+
| **开源项目** | ✅ 推荐 | ❌ 不推荐 | ✅ 良好选择 |
|
|
144
|
+
|
|
145
|
+
**快速选择**:
|
|
146
|
+
- **开源项目** → 英文(选项 A)
|
|
147
|
+
- **本地团队、内部项目** → 繁体中文(选项 B)
|
|
148
|
+
- **有国际协作的本地团队** → 双语(选项 C)
|
|
149
|
+
|
|
150
|
+
**重要说明**: 一旦选定,必须在整个项目中**一致使用**。请勿混用多种语言配置。
|
|
151
|
+
|
|
152
|
+
---
|
|
153
|
+
|
|
154
|
+
**项目决策点**: 在 `CONTRIBUTING.md` 中记录您的选择(单选):
|
|
155
|
+
|
|
156
|
+
```markdown
|
|
157
|
+
## Output Language
|
|
158
|
+
|
|
159
|
+
<!-- Choose ONE of the following options: -->
|
|
160
|
+
|
|
161
|
+
<!-- Option A: English -->
|
|
162
|
+
This project uses **English** commit types (feat, fix, refactor, etc.)
|
|
163
|
+
|
|
164
|
+
<!-- Option B: Traditional Chinese -->
|
|
165
|
+
This project uses **English** commit types (feat, fix, refactor, etc.) with **Traditional Chinese** subjects and bodies
|
|
166
|
+
|
|
167
|
+
<!-- Option C: Bilingual Mode -->
|
|
168
|
+
This project uses **Bilingual Mode** with English types/scopes and bilingual subject/body.
|
|
169
|
+
```
|
|
170
|
+
|
|
171
|
+
---
|
|
172
|
+
|
|
173
|
+
## 作用域(Scope)指南
|
|
174
|
+
|
|
175
|
+
作用域用于指明代码库中受影响的部分。请使用简短且辨识度高的名称。
|
|
176
|
+
|
|
177
|
+
### 命名规则
|
|
178
|
+
|
|
179
|
+
1. **使用小写**: 所有作用域应使用小写字母(例如 `auth`,而非 `Auth`)
|
|
180
|
+
2. **多词使用连字符**: 词之间使用连字符分隔(例如 `user-profile`,而非 `userProfile`)
|
|
181
|
+
3. **保持简短**: 最多 1-2 个词
|
|
182
|
+
|
|
183
|
+
### 常用作用域
|
|
184
|
+
|
|
185
|
+
**按架构层/模块划分**:
|
|
186
|
+
|
|
187
|
+
- `api`: API 层
|
|
188
|
+
- `ui`: 用户界面
|
|
189
|
+
- `auth`: 认证/授权
|
|
190
|
+
- `database`: 数据库层
|
|
191
|
+
- `config`: 配置
|
|
192
|
+
- `middleware`: 中间件层
|
|
193
|
+
|
|
194
|
+
**按功能划分**:
|
|
195
|
+
|
|
196
|
+
- `login`: 登录功能
|
|
197
|
+
- `payment`: 支付处理
|
|
198
|
+
- `notification`: 通知
|
|
199
|
+
- `search`: 搜索功能
|
|
200
|
+
|
|
201
|
+
**按文件类型划分**:
|
|
202
|
+
|
|
203
|
+
- `tests`: 测试文件
|
|
204
|
+
- `docs`: 文档文件
|
|
205
|
+
- `build`: 构建脚本
|
|
206
|
+
- `deps`: 依赖项
|
|
207
|
+
|
|
208
|
+
**特殊作用域**:
|
|
209
|
+
|
|
210
|
+
- `*`: 涉及多个作用域
|
|
211
|
+
- (无 scope): 全局变更
|
|
212
|
+
|
|
213
|
+
**Web API 项目示例作用域**:
|
|
87
214
|
|
|
88
215
|
```
|
|
89
|
-
|
|
216
|
+
auth, user, product, order, payment, notification,
|
|
217
|
+
database, config, middleware, api, tests, docs
|
|
218
|
+
```
|
|
219
|
+
|
|
220
|
+
---
|
|
90
221
|
|
|
91
|
-
|
|
92
|
-
|
|
222
|
+
## 主题行
|
|
223
|
+
|
|
224
|
+
### 规则
|
|
225
|
+
|
|
226
|
+
1. **长度**:≤72 个字符(推荐 50 个字符)
|
|
227
|
+
2. **时态**:使用祈使语气("Add feature" 而非 "Added feature")
|
|
228
|
+
3. **大小写**:首字母大写
|
|
229
|
+
4. **无句号**:结尾不加句号(例外:双语模式使用句号作为分隔符)
|
|
230
|
+
5. **语言**:遵循项目规范(英文或母语)
|
|
231
|
+
|
|
232
|
+
### 良好示例
|
|
233
|
+
|
|
234
|
+
```
|
|
235
|
+
feat(auth): Add OAuth2 Google login support
|
|
236
|
+
fix(api): Resolve memory leak in user session cache
|
|
237
|
+
refactor(database): Extract query builder to separate class
|
|
238
|
+
docs(readme): Update installation instructions for Node 20
|
|
239
|
+
test(payment): Add unit tests for refund flow
|
|
240
|
+
perf(search): Implement index for full-text search
|
|
241
|
+
build(deps): Upgrade Express to 4.18.2
|
|
242
|
+
```
|
|
243
|
+
|
|
244
|
+
### 不良示例
|
|
245
|
+
|
|
246
|
+
```
|
|
247
|
+
❌ "fixed bug" - Too vague, no scope
|
|
248
|
+
❌ "feat(auth): added google login and fixed a bug and refactored code" - Too long, multiple concerns
|
|
249
|
+
❌ "Update stuff." - Has period, too vague
|
|
250
|
+
❌ "Added OAuth2 login feature" - Past tense instead of imperative
|
|
251
|
+
❌ "WIP" - Not descriptive
|
|
93
252
|
```
|
|
94
253
|
|
|
95
254
|
---
|
|
96
255
|
|
|
97
|
-
##
|
|
256
|
+
## 正文
|
|
257
|
+
|
|
258
|
+
使用正文解释**为什么**进行此变更,而不是变更了**什么**(代码本身已体现了改动内容)。
|
|
259
|
+
|
|
260
|
+
### 结构
|
|
261
|
+
|
|
262
|
+
- 针对多项变更使用项目符号列表
|
|
263
|
+
- 在 72 个字符处折行
|
|
264
|
+
- 与主题行之间用空行隔开
|
|
265
|
+
- 提供背景上下文与合理性理由
|
|
266
|
+
|
|
267
|
+
### 正文模板
|
|
268
|
+
|
|
269
|
+
根据变更类型使用符合上下文的标题。常见模式:
|
|
270
|
+
|
|
271
|
+
**针对新功能**:
|
|
272
|
+
|
|
273
|
+
```
|
|
274
|
+
Why this feature is needed:
|
|
275
|
+
What this implements:
|
|
276
|
+
Technical notes:
|
|
277
|
+
```
|
|
278
|
+
|
|
279
|
+
**针对错误修复**:
|
|
280
|
+
|
|
281
|
+
```
|
|
282
|
+
Why this occurred:
|
|
283
|
+
What this fix does:
|
|
284
|
+
Testing:
|
|
285
|
+
```
|
|
286
|
+
|
|
287
|
+
**针对重构**:
|
|
98
288
|
|
|
99
|
-
|
|
289
|
+
```
|
|
290
|
+
Why this refactoring:
|
|
291
|
+
What this changes:
|
|
292
|
+
Migration:
|
|
293
|
+
```
|
|
294
|
+
|
|
295
|
+
**通用模板**:
|
|
100
296
|
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
| 更新文档 | docs |
|
|
106
|
-
| 重构代码 | refactor |
|
|
107
|
-
| 优化性能 | perf |
|
|
108
|
-
| 添加测试 | test |
|
|
297
|
+
```
|
|
298
|
+
<Subject line>
|
|
299
|
+
|
|
300
|
+
<Blank line>
|
|
109
301
|
|
|
110
|
-
|
|
302
|
+
Why:
|
|
303
|
+
- Reason 1
|
|
304
|
+
- Reason 2
|
|
111
305
|
|
|
112
|
-
|
|
113
|
-
-
|
|
114
|
-
-
|
|
115
|
-
|
|
116
|
-
|
|
306
|
+
What:
|
|
307
|
+
- Change 1
|
|
308
|
+
- Change 2
|
|
309
|
+
|
|
310
|
+
Notes:
|
|
311
|
+
- Context or considerations
|
|
312
|
+
```
|
|
313
|
+
|
|
314
|
+
### 示例
|
|
315
|
+
|
|
316
|
+
#### 示例 1:带背景的新功能
|
|
317
|
+
|
|
318
|
+
```
|
|
319
|
+
feat(payment): Add support for PayPal payment method
|
|
320
|
+
|
|
321
|
+
Why this change is needed:
|
|
322
|
+
- Customer survey shows 40% prefer PayPal
|
|
323
|
+
- Competitor analysis indicates missing payment option
|
|
324
|
+
- Q4 goal to increase payment method diversity
|
|
325
|
+
|
|
326
|
+
What this change does:
|
|
327
|
+
- Integrate PayPal SDK v2.0
|
|
328
|
+
- Add PayPal button to checkout page
|
|
329
|
+
- Implement webhook for payment confirmation
|
|
330
|
+
- Update payment history to show PayPal transactions
|
|
331
|
+
|
|
332
|
+
Technical notes:
|
|
333
|
+
- Used sandbox environment for testing
|
|
334
|
+
- Webhook signature validation implemented for security
|
|
335
|
+
```
|
|
336
|
+
|
|
337
|
+
#### 示例 2:带根本原因的错误修复
|
|
338
|
+
|
|
339
|
+
```
|
|
340
|
+
fix(api): Resolve race condition in concurrent user updates
|
|
341
|
+
|
|
342
|
+
Why this occurred:
|
|
343
|
+
- Two simultaneous PUT requests to /users/:id could overwrite each other
|
|
344
|
+
- No optimistic locking or transaction isolation implemented
|
|
345
|
+
- Last write wins, causing data loss
|
|
346
|
+
|
|
347
|
+
What this fix does:
|
|
348
|
+
- Add version field to User model
|
|
349
|
+
- Implement optimistic locking check
|
|
350
|
+
- Return 409 Conflict if version mismatch
|
|
351
|
+
- Update API documentation with retry guidance
|
|
352
|
+
|
|
353
|
+
Testing:
|
|
354
|
+
- Added concurrent update test scenarios
|
|
355
|
+
- Verified with load test (100 concurrent updates)
|
|
356
|
+
```
|
|
117
357
|
|
|
118
358
|
---
|
|
119
359
|
|
|
120
|
-
##
|
|
360
|
+
## Footer
|
|
361
|
+
|
|
362
|
+
### Issue 引用
|
|
121
363
|
|
|
122
|
-
|
|
364
|
+
将提交关联到 Issue 追踪系统:
|
|
365
|
+
|
|
366
|
+
```
|
|
367
|
+
Closes #123
|
|
368
|
+
Fixes #456
|
|
369
|
+
Resolves #789
|
|
370
|
+
Refs #101, #102
|
|
371
|
+
See also #999
|
|
372
|
+
```
|
|
373
|
+
|
|
374
|
+
**支持的关键字**(GitHub、GitLab、Bitbucket):
|
|
375
|
+
|
|
376
|
+
- `Closes`、`Fixes`、`Resolves`:自动关闭 Issue
|
|
377
|
+
- `Refs`、`References`、`See also`:仅建立关联而不关闭
|
|
378
|
+
|
|
379
|
+
### 自定义引用 Footer
|
|
380
|
+
|
|
381
|
+
当提交关联到规格、设计文档或外部追踪系统时,在页脚中使用一致的前缀进行引用:
|
|
123
382
|
|
|
124
383
|
```
|
|
125
384
|
Refs: <PREFIX>-<ID>
|
|
126
385
|
```
|
|
127
386
|
|
|
387
|
+
**按项目类型的常见前缀**:
|
|
388
|
+
|
|
128
389
|
| 前缀 | 使用场景 | 示例 |
|
|
129
|
-
|
|
390
|
+
|--------|----------|---------|
|
|
130
391
|
| `SPEC-` | 规格驱动开发 | `Refs: SPEC-042` |
|
|
131
392
|
| `JIRA-` | Jira 工单 | `Refs: JIRA-1234` |
|
|
132
393
|
| `FEATURE-` | 内部功能追踪 | `Refs: FEATURE-001` |
|
|
133
394
|
| `RFC-` | 提案文档 | `Refs: RFC-012` |
|
|
134
395
|
|
|
135
|
-
|
|
396
|
+
**示例**:
|
|
397
|
+
|
|
398
|
+
```
|
|
399
|
+
feat(auth): Add OAuth2 login support
|
|
400
|
+
|
|
401
|
+
Implement OAuth2 authentication flow.
|
|
402
|
+
|
|
403
|
+
Refs: SPEC-042
|
|
404
|
+
Closes #123
|
|
405
|
+
```
|
|
406
|
+
|
|
407
|
+
选择与您项目追踪系统相符的前缀并保持一致使用。
|
|
408
|
+
|
|
409
|
+
---
|
|
410
|
+
|
|
411
|
+
### 破坏性变更
|
|
412
|
+
|
|
413
|
+
**关键要求**:务必在页脚中记录破坏性变更并提供迁移指引。
|
|
414
|
+
|
|
415
|
+
**要求**:
|
|
416
|
+
1. 在页脚中使用 `BREAKING CHANGE:` 前缀
|
|
417
|
+
2. 描述变更了什么以及为什么变更
|
|
418
|
+
3. **必须**包含带有可操作步骤的迁移指南
|
|
419
|
+
4. 尽可能包含变更前/变更后示例
|
|
420
|
+
|
|
421
|
+
**格式**:
|
|
422
|
+
|
|
423
|
+
```
|
|
424
|
+
BREAKING CHANGE: <description>
|
|
425
|
+
|
|
426
|
+
Migration guide:
|
|
427
|
+
- Step 1: <specific action>
|
|
428
|
+
- Step 2: <specific action>
|
|
429
|
+
```
|
|
430
|
+
|
|
431
|
+
> **为什么必须提供迁移指南**:没有迁移路径的破坏性变更会令用户受挫并延缓采用。每个破坏性变更都必须明确告知用户该怎么做。
|
|
432
|
+
|
|
433
|
+
**示例**:
|
|
434
|
+
|
|
435
|
+
```
|
|
436
|
+
feat(api): Change user endpoint response format
|
|
437
|
+
|
|
438
|
+
- Flatten nested user object structure
|
|
439
|
+
- Remove deprecated `legacy_id` field
|
|
440
|
+
- Add `created_at` and `updated_at` timestamps
|
|
441
|
+
|
|
442
|
+
BREAKING CHANGE: User API response format changed
|
|
443
|
+
|
|
444
|
+
Old format:
|
|
445
|
+
```json
|
|
446
|
+
{
|
|
447
|
+
"data": {
|
|
448
|
+
"user": {
|
|
449
|
+
"id": 123,
|
|
450
|
+
"name": "John",
|
|
451
|
+
"legacy_id": 456
|
|
452
|
+
}
|
|
453
|
+
}
|
|
454
|
+
}
|
|
455
|
+
```
|
|
456
|
+
|
|
457
|
+
New format:
|
|
458
|
+
|
|
459
|
+
```json
|
|
460
|
+
{
|
|
461
|
+
"id": 123,
|
|
462
|
+
"name": "John",
|
|
463
|
+
"created_at": "2025-11-12T10:00:00Z",
|
|
464
|
+
"updated_at": "2025-11-12T10:00:00Z"
|
|
465
|
+
}
|
|
466
|
+
```
|
|
467
|
+
|
|
468
|
+
Migration guide:
|
|
469
|
+
|
|
470
|
+
- Update API clients to remove `.data` wrapper
|
|
471
|
+
- Remove references to `legacy_id` field
|
|
472
|
+
- Use `created_at` instead of `createdAt` (snake_case)
|
|
473
|
+
|
|
474
|
+
Closes #234
|
|
475
|
+
|
|
476
|
+
```
|
|
477
|
+
|
|
478
|
+
---
|
|
479
|
+
|
|
480
|
+
## 完整示例
|
|
481
|
+
|
|
482
|
+
### 示例 1:简单修复(英文)
|
|
483
|
+
|
|
484
|
+
```
|
|
485
|
+
|
|
486
|
+
fix(auth): Correct JWT expiration time calculation
|
|
487
|
+
|
|
488
|
+
The token was expiring 1 hour early due to timezone offset not being accounted for. Now using UTC time consistently.
|
|
489
|
+
|
|
490
|
+
Fixes #445
|
|
491
|
+
|
|
492
|
+
```
|
|
493
|
+
|
|
494
|
+
---
|
|
495
|
+
|
|
496
|
+
### 示例 2:包含多个部分的功能(英文)
|
|
497
|
+
|
|
498
|
+
```
|
|
499
|
+
|
|
500
|
+
feat(export): Add CSV export functionality for user data
|
|
501
|
+
|
|
502
|
+
Why this feature is needed:
|
|
503
|
+
|
|
504
|
+
- Admins need to export user lists for compliance audits
|
|
505
|
+
- Manual copy-paste from UI is error-prone
|
|
506
|
+
- Requested by legal and compliance teams
|
|
507
|
+
|
|
508
|
+
What this implements:
|
|
509
|
+
|
|
510
|
+
- New `/api/users/export` endpoint
|
|
511
|
+
- CSV generation using csv-writer library
|
|
512
|
+
- Streaming response to handle large datasets
|
|
513
|
+
- Date range filtering options
|
|
514
|
+
- Column selection (PII vs non-PII fields)
|
|
515
|
+
|
|
516
|
+
Technical notes:
|
|
517
|
+
|
|
518
|
+
- Streaming prevents memory issues with 100k+ users
|
|
519
|
+
- Export limited to admin role only
|
|
520
|
+
- PII fields require additional permission flag
|
|
521
|
+
- Rate limited to prevent abuse
|
|
522
|
+
|
|
523
|
+
Closes #567
|
|
524
|
+
Refs #234 (related compliance requirement)
|
|
525
|
+
|
|
526
|
+
```
|
|
527
|
+
|
|
528
|
+
---
|
|
529
|
+
|
|
530
|
+
### 示例 3:双语模式 - 简单修复
|
|
531
|
+
|
|
532
|
+
```
|
|
533
|
+
|
|
534
|
+
fix(auth): Correct JWT expiration time calculation. 修正 JWT 過期時間計算。
|
|
535
|
+
|
|
536
|
+
The token was expiring 1 hour early due to timezone offset not being accounted for. Now using UTC time consistently.
|
|
537
|
+
|
|
538
|
+
權杖因未考慮時區偏移而提早 1 小時過期。現已統一使用 UTC 時間。
|
|
539
|
+
|
|
540
|
+
Fixes #445
|
|
541
|
+
|
|
542
|
+
```
|
|
543
|
+
|
|
544
|
+
---
|
|
545
|
+
|
|
546
|
+
### 示例 4:双语模式 - 功能
|
|
547
|
+
|
|
548
|
+
```
|
|
549
|
+
|
|
550
|
+
feat(export): Add CSV export functionality for user data. 新增使用者資料 CSV 匯出功能。
|
|
551
|
+
|
|
552
|
+
Why this feature is needed:
|
|
553
|
+
|
|
554
|
+
- Admins need to export user lists for compliance audits
|
|
555
|
+
- Manual copy-paste from UI is error-prone
|
|
556
|
+
- Requested by legal and compliance teams
|
|
557
|
+
|
|
558
|
+
What this implements:
|
|
559
|
+
|
|
560
|
+
- New `/api/users/export` endpoint
|
|
561
|
+
- CSV generation using csv-writer library
|
|
562
|
+
- Streaming response to handle large datasets
|
|
563
|
+
- Date range filtering options
|
|
564
|
+
|
|
565
|
+
Technical notes:
|
|
566
|
+
|
|
567
|
+
- Streaming prevents memory issues with 100k+ users
|
|
568
|
+
- Export limited to admin role only
|
|
569
|
+
|
|
570
|
+
為何需要此功能:
|
|
571
|
+
|
|
572
|
+
- 管理員需匯出使用者清單以進行合規稽核
|
|
573
|
+
- 從 UI 手動複製貼上容易出錯
|
|
574
|
+
- 法務與合規團隊要求此功能
|
|
575
|
+
|
|
576
|
+
此變更實作內容:
|
|
577
|
+
|
|
578
|
+
- 新增 `/api/users/export` 端點
|
|
579
|
+
- 使用 csv-writer 函式庫生成 CSV
|
|
580
|
+
- 串流回應以處理大型資料集
|
|
581
|
+
- 日期範圍篩選選項
|
|
582
|
+
|
|
583
|
+
技術備註:
|
|
584
|
+
|
|
585
|
+
- 串流處理可避免 10 萬筆以上使用者的記憶體問題
|
|
586
|
+
- 匯出功能僅限管理員角色使用
|
|
587
|
+
|
|
588
|
+
Closes #567
|
|
589
|
+
Refs #234
|
|
590
|
+
|
|
591
|
+
```
|
|
592
|
+
|
|
593
|
+
---
|
|
594
|
+
|
|
595
|
+
### 示例 5:双语模式 - 包含根本原因的错误修复
|
|
596
|
+
|
|
597
|
+
```
|
|
598
|
+
|
|
599
|
+
fix(api): Resolve race condition in concurrent user updates. 解決並發使用者更新的競爭條件。
|
|
600
|
+
|
|
601
|
+
Why this occurred:
|
|
602
|
+
|
|
603
|
+
- Two simultaneous PUT requests to /users/:id could overwrite each other
|
|
604
|
+
- No optimistic locking implemented
|
|
605
|
+
|
|
606
|
+
What this fix does:
|
|
607
|
+
|
|
608
|
+
- Add version field to User model
|
|
609
|
+
- Implement optimistic locking check
|
|
610
|
+
- Return 409 Conflict if version mismatch
|
|
611
|
+
|
|
612
|
+
Testing:
|
|
613
|
+
|
|
614
|
+
- Added concurrent update test scenarios
|
|
615
|
+
- Verified with load test (100 concurrent updates)
|
|
616
|
+
|
|
617
|
+
問題發生原因:
|
|
618
|
+
|
|
619
|
+
- 兩個同時發送至 /users/:id 的 PUT 請求可能互相覆蓋
|
|
620
|
+
- 未實作樂觀鎖定機制
|
|
621
|
+
|
|
622
|
+
修正內容:
|
|
623
|
+
|
|
624
|
+
- 新增版本欄位至 User 模型
|
|
625
|
+
- 實作樂觀鎖定檢查
|
|
626
|
+
- 版本不符時回傳 409 Conflict
|
|
627
|
+
|
|
628
|
+
測試:
|
|
629
|
+
|
|
630
|
+
- 新增並發更新測試情境
|
|
631
|
+
- 以負載測試驗證(100 個並發更新)
|
|
632
|
+
|
|
633
|
+
Fixes #789
|
|
634
|
+
|
|
635
|
+
```
|
|
636
|
+
|
|
637
|
+
---
|
|
638
|
+
|
|
639
|
+
### 示例 6:包含破坏性变更的重构(英文)
|
|
640
|
+
|
|
641
|
+
```
|
|
642
|
+
|
|
643
|
+
refactor(database): Migrate from MySQL to PostgreSQL
|
|
644
|
+
|
|
645
|
+
Why this refactoring:
|
|
646
|
+
|
|
647
|
+
- PostgreSQL offers better JSON support for our use case
|
|
648
|
+
- Need advanced indexing features for full-text search
|
|
649
|
+
- Licensing considerations for cloud deployment
|
|
650
|
+
|
|
651
|
+
What this changes:
|
|
652
|
+
|
|
653
|
+
- Update database driver from mysql2 to pg
|
|
654
|
+
- Convert MySQL-specific queries to PostgreSQL syntax
|
|
655
|
+
- Update connection pooling configuration
|
|
656
|
+
- Migrate schema using migration scripts
|
|
657
|
+
- Update ORM configurations
|
|
658
|
+
|
|
659
|
+
Migration:
|
|
660
|
+
|
|
661
|
+
- Run `npm run db:backup` before upgrading
|
|
662
|
+
- Run `npm run db:migrate` to apply schema changes
|
|
663
|
+
- Update environment variables (see .env.example)
|
|
664
|
+
|
|
665
|
+
BREAKING CHANGE: Database engine changed from MySQL to PostgreSQL
|
|
666
|
+
|
|
667
|
+
Migration guide:
|
|
668
|
+
|
|
669
|
+
1. Backup existing MySQL database
|
|
670
|
+
2. Install PostgreSQL 15+
|
|
671
|
+
3. Update .env:
|
|
672
|
+
- DATABASE_URL=postgresql://... (was mysql://...)
|
|
673
|
+
- Remove MYSQL_* variables
|
|
674
|
+
4. Run migration: npm run db:migrate
|
|
675
|
+
5. Verify data integrity: npm run db:verify
|
|
676
|
+
|
|
677
|
+
Estimated downtime: 2-4 hours for production migration
|
|
678
|
+
|
|
679
|
+
Closes #890
|
|
680
|
+
|
|
681
|
+
```
|
|
682
|
+
|
|
683
|
+
---
|
|
684
|
+
|
|
685
|
+
### 示例 7:双语模式 - 破坏性变更
|
|
686
|
+
|
|
687
|
+
```
|
|
688
|
+
|
|
689
|
+
refactor(database): Migrate from MySQL to PostgreSQL. 從 MySQL 遷移至 PostgreSQL。
|
|
690
|
+
|
|
691
|
+
Why this refactoring:
|
|
692
|
+
|
|
693
|
+
- PostgreSQL offers better JSON support for our use case
|
|
694
|
+
- Need advanced indexing features for full-text search
|
|
695
|
+
|
|
696
|
+
What this changes:
|
|
697
|
+
|
|
698
|
+
- Update database driver from mysql2 to pg
|
|
699
|
+
- Convert MySQL-specific queries to PostgreSQL syntax
|
|
700
|
+
- Update connection pooling configuration
|
|
701
|
+
|
|
702
|
+
BREAKING CHANGE: Database engine changed from MySQL to PostgreSQL
|
|
703
|
+
|
|
704
|
+
Migration guide:
|
|
705
|
+
|
|
706
|
+
1. Backup existing MySQL database
|
|
707
|
+
2. Install PostgreSQL 15+
|
|
708
|
+
3. Update .env: DATABASE_URL=postgresql://...
|
|
709
|
+
4. Run migration: npm run db:migrate
|
|
710
|
+
5. Verify data integrity: npm run db:verify
|
|
711
|
+
|
|
712
|
+
Estimated downtime: 2-4 hours
|
|
713
|
+
|
|
714
|
+
重構原因:
|
|
715
|
+
|
|
716
|
+
- PostgreSQL 提供更佳的 JSON 支援以符合我們的使用情境
|
|
717
|
+
- 需要進階索引功能支援全文檢索
|
|
718
|
+
|
|
719
|
+
變更內容:
|
|
720
|
+
|
|
721
|
+
- 更新資料庫驅動從 mysql2 至 pg
|
|
722
|
+
- 將 MySQL 專用查詢轉換為 PostgreSQL 語法
|
|
723
|
+
- 更新連線池設定
|
|
724
|
+
|
|
725
|
+
破壞性變更: 資料庫引擎從 MySQL 變更為 PostgreSQL
|
|
726
|
+
|
|
727
|
+
遷移指南:
|
|
728
|
+
|
|
729
|
+
1. 備份現有 MySQL 資料庫
|
|
730
|
+
2. 安裝 PostgreSQL 15+
|
|
731
|
+
3. 更新 .env 設定: DATABASE_URL=postgresql://...
|
|
732
|
+
4. 執行遷移腳本: npm run db:migrate
|
|
733
|
+
5. 驗證資料完整性: npm run db:verify
|
|
734
|
+
|
|
735
|
+
預估停機時間: 2-4 小時
|
|
736
|
+
|
|
737
|
+
Closes #890
|
|
738
|
+
|
|
739
|
+
```
|
|
740
|
+
|
|
741
|
+
---
|
|
742
|
+
|
|
743
|
+
## 反模式
|
|
744
|
+
|
|
745
|
+
### ❌ 反模式 1:模糊不清的消息
|
|
746
|
+
|
|
747
|
+
```
|
|
748
|
+
|
|
749
|
+
fix: bug fix
|
|
750
|
+
refactor: code improvements
|
|
751
|
+
update: changes
|
|
752
|
+
|
|
753
|
+
```
|
|
754
|
+
|
|
755
|
+
**问题**:缺乏上下文,不阅读代码就无法理解。
|
|
756
|
+
|
|
757
|
+
**✅ 修复**:
|
|
758
|
+
```
|
|
759
|
+
|
|
760
|
+
fix(login): Prevent duplicate session creation on rapid clicks
|
|
761
|
+
refactor(utils): Extract email validation regex to constants
|
|
762
|
+
feat(profile): Add avatar upload with image compression
|
|
763
|
+
|
|
764
|
+
```
|
|
765
|
+
|
|
766
|
+
---
|
|
767
|
+
|
|
768
|
+
### ❌ 反模式 2:混合多个关注点
|
|
769
|
+
|
|
770
|
+
```
|
|
771
|
+
|
|
772
|
+
feat: add login, fix bugs, refactor database, update docs
|
|
773
|
+
|
|
774
|
+
```
|
|
775
|
+
|
|
776
|
+
**问题**:为了便于审查与回滚,应拆分为独立的提交。
|
|
777
|
+
|
|
778
|
+
**✅ 修复**:拆分为独立的提交:
|
|
779
|
+
```
|
|
780
|
+
|
|
781
|
+
feat(auth): Add OAuth2 login support
|
|
782
|
+
fix(api): Resolve null pointer in user lookup
|
|
783
|
+
refactor(database): Extract connection pool to separate module
|
|
784
|
+
docs(api): Update authentication endpoint documentation
|
|
785
|
+
|
|
786
|
+
```
|
|
787
|
+
|
|
788
|
+
---
|
|
789
|
+
|
|
790
|
+
### ❌ 反模式 3:将提交消息当作代码注释
|
|
791
|
+
|
|
792
|
+
```
|
|
793
|
+
|
|
794
|
+
fix: change line 45 from getUserById to getUserByEmail because the function was renamed
|
|
795
|
+
|
|
796
|
+
```
|
|
797
|
+
|
|
798
|
+
**问题**:过于关注实现细节而非意图。
|
|
799
|
+
|
|
800
|
+
**✅ 修复**:
|
|
801
|
+
```
|
|
802
|
+
|
|
803
|
+
fix(api): Use correct user lookup method in password reset
|
|
804
|
+
|
|
805
|
+
The password reset flow was calling getUserById with an email parameter,
|
|
806
|
+
causing lookups to fail. Now correctly calls getUserByEmail.
|
|
807
|
+
|
|
808
|
+
Fixes #789
|
|
809
|
+
|
|
810
|
+
```
|
|
811
|
+
|
|
812
|
+
---
|
|
813
|
+
|
|
814
|
+
### ❌ 反模式 4:复杂变更未提供正文
|
|
815
|
+
|
|
816
|
+
```
|
|
817
|
+
|
|
818
|
+
refactor(database): migrate to PostgreSQL
|
|
819
|
+
|
|
820
|
+
```
|
|
821
|
+
|
|
822
|
+
**问题**:破坏性变更未提供迁移指南或上下文。
|
|
823
|
+
|
|
824
|
+
**✅ 修复**:添加包含上下文和迁移指南的正文(参见上文示例 6)。
|
|
825
|
+
|
|
826
|
+
---
|
|
827
|
+
|
|
828
|
+
## 自动化与工具链
|
|
829
|
+
|
|
830
|
+
### 提交消息检查工具(Linters)
|
|
831
|
+
|
|
832
|
+
**commitlint** (Node.js):
|
|
833
|
+
```bash
|
|
834
|
+
npm install --save-dev @commitlint/{cli,config-conventional}
|
|
835
|
+
|
|
836
|
+
# .commitlintrc.js
|
|
837
|
+
module.exports = {
|
|
838
|
+
extends: ['@commitlint/config-conventional']
|
|
839
|
+
};
|
|
840
|
+
```
|
|
841
|
+
|
|
842
|
+
**Git Hook**(在提交时强制执行):
|
|
843
|
+
|
|
844
|
+
```bash
|
|
845
|
+
# .git/hooks/commit-msg
|
|
846
|
+
#!/bin/sh
|
|
847
|
+
npx commitlint --edit $1
|
|
848
|
+
```
|
|
849
|
+
|
|
850
|
+
---
|
|
851
|
+
|
|
852
|
+
### 变更日志生成
|
|
853
|
+
|
|
854
|
+
**standard-version** (Node.js):
|
|
855
|
+
|
|
856
|
+
```bash
|
|
857
|
+
npm install --save-dev standard-version
|
|
858
|
+
|
|
859
|
+
# package.json
|
|
860
|
+
{
|
|
861
|
+
"scripts": {
|
|
862
|
+
"release": "standard-version"
|
|
863
|
+
}
|
|
864
|
+
}
|
|
865
|
+
|
|
866
|
+
# Generates CHANGELOG.md from commits
|
|
867
|
+
npm run release
|
|
868
|
+
```
|
|
869
|
+
|
|
870
|
+
**git-chglog** (Go):
|
|
871
|
+
|
|
872
|
+
```bash
|
|
873
|
+
git-chglog --output CHANGELOG.md
|
|
874
|
+
```
|
|
875
|
+
|
|
876
|
+
---
|
|
877
|
+
|
|
878
|
+
## 项目配置模板
|
|
879
|
+
|
|
880
|
+
添加到 `CONTRIBUTING.md`:
|
|
881
|
+
|
|
882
|
+
```markdown
|
|
883
|
+
## Commit Message Format
|
|
884
|
+
|
|
885
|
+
### Type Language
|
|
886
|
+
This project uses **[English / Traditional Chinese / Bilingual]** commit types.
|
|
887
|
+
|
|
888
|
+
### Allowed Types
|
|
889
|
+
- feat: New features
|
|
890
|
+
- fix: Bug fixes
|
|
891
|
+
- refactor: Code refactoring
|
|
892
|
+
- docs: Documentation
|
|
893
|
+
- test: Tests
|
|
894
|
+
- perf: Performance improvements
|
|
895
|
+
- build: Build system
|
|
896
|
+
- ci: CI/CD changes
|
|
897
|
+
- chore: Maintenance
|
|
898
|
+
- security: Security fixes
|
|
899
|
+
|
|
900
|
+
### Allowed Scopes
|
|
901
|
+
- auth: Authentication module
|
|
902
|
+
- api: API layer
|
|
903
|
+
- ui: User interface
|
|
904
|
+
- database: Database layer
|
|
905
|
+
- [add your project-specific scopes]
|
|
906
|
+
|
|
907
|
+
### Subject Language
|
|
908
|
+
Commit subject lines should be in **[English/繁體中文/Bilingual]**.
|
|
909
|
+
|
|
910
|
+
### Examples
|
|
911
|
+
|
|
912
|
+
**English**:
|
|
913
|
+
```
|
|
914
|
+
|
|
915
|
+
feat(auth): Add OAuth2 support
|
|
916
|
+
fix(api): Resolve memory leak
|
|
917
|
+
|
|
918
|
+
```
|
|
919
|
+
|
|
920
|
+
**Bilingual Mode** (English first, Chinese follows):
|
|
921
|
+
```
|
|
922
|
+
|
|
923
|
+
feat(auth): Add OAuth2 support. 新增 OAuth2 支援。
|
|
924
|
+
|
|
925
|
+
Implement OAuth2 authentication flow.
|
|
926
|
+
|
|
927
|
+
實作 OAuth2 認證流程。
|
|
928
|
+
|
|
929
|
+
Closes #123
|
|
930
|
+
|
|
931
|
+
```
|
|
932
|
+
|
|
933
|
+
```
|
|
136
934
|
|
|
137
935
|
---
|
|
138
936
|
|
|
139
937
|
## 相关标准
|
|
140
938
|
|
|
141
|
-
- [Git
|
|
142
|
-
- [
|
|
939
|
+
- [Git 工作流程标准](git-workflow.md)
|
|
940
|
+
- [代码签入标准](checkin-standards.md)
|
|
941
|
+
- [变更日志标准](changelog-standards.md)
|
|
942
|
+
- [版本控制标准](versioning.md)
|
|
943
|
+
|
|
944
|
+
---
|
|
945
|
+
|
|
946
|
+
## 版本历史
|
|
947
|
+
|
|
948
|
+
| 版本 | 日期 | 变更 |
|
|
949
|
+
| ------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
950
|
+
| 1.4.0 | 2026-10-12 | 变更:选项 B(繁体中文)采用英文类型配合繁体中文主题与正文;不再允许使用中文类型(新增、修正……)(XSPEC-475 OQ1)。新增迁移对照表 |
|
|
951
|
+
| 1.3.0 | 2026-03-16 | 新增:规格引用页脚规范(Refs: SPEC-XXX) |
|
|
952
|
+
| 1.2.3 | 2025-12-24 | 新增:相关标准章节 |
|
|
953
|
+
| 1.2.2 | 2025-12-16 | 新增:语言选择指南,包含决策矩阵与快速选择建议 |
|
|
954
|
+
| 1.2.1 | 2025-12-09 | 改进选项 A/B/C 的格式一致性:统一标题样式,补充说明文本 |
|
|
955
|
+
| 1.2.0 | 2025-12-05 | 修复选项 B 的类型映射(chore→维护);新增 security 类型;新增 scope 命名规则;阐明双语末尾句号例外规则;改进模板 |
|
|
956
|
+
| 1.1.0 | 2025-12-05 | 新增双语模式(选项 C)及示例 |
|
|
957
|
+
| 1.0.0 | 2025-11-12 | 初始指南发布 |
|
|
958
|
+
|
|
959
|
+
---
|
|
960
|
+
|
|
961
|
+
## 参考资料
|
|
962
|
+
|
|
963
|
+
- [Conventional Commits](https://www.conventionalcommits.org/)
|
|
964
|
+
- [Angular Commit Guidelines](https://github.com/angular/angular/blob/main/CONTRIBUTING.md#commit)
|
|
965
|
+
- [Semantic Versioning](https://semver.org/)
|
|
143
966
|
|
|
144
967
|
---
|
|
145
968
|
|
|
146
969
|
## 许可证
|
|
147
970
|
|
|
148
|
-
|
|
971
|
+
本指南采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 发布。
|