universal-dev-standards 6.14.0-beta.9 → 6.14.1-beta.1
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/mock-boundary.ai.yaml +138 -2
- package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
- package/bundled/ai/standards/turn-completion-integrity.ai.yaml +6 -2
- package/bundled/core/commit-message-guide.md +22 -19
- package/bundled/core/mock-boundary.md +70 -2
- package/bundled/core/secret-management-standards.md +13 -1
- package/bundled/core/turn-completion-integrity.md +8 -2
- package/bundled/extensions/locales/zh-tw.md +19 -19
- package/bundled/hooks/check-dangerous-cmd.mjs +161 -26
- package/bundled/hooks/check-logging-standard.mjs +35 -6
- package/bundled/hooks/validate-commit-msg.mjs +317 -28
- package/bundled/locales/zh-CN/CHANGELOG.md +2323 -1099
- 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 +4 -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/mock-boundary.md +74 -6
- 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/turn-completion-integrity.md +8 -6
- 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 +2323 -1128
- 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 +4 -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/mock-boundary.md +74 -6
- 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/turn-completion-integrity.md +8 -6
- 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 +72 -3
- 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.js +4 -2
- package/src/commands/update.js +227 -47
- 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 +106 -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,44 @@
|
|
|
1
1
|
---
|
|
2
|
-
source:
|
|
3
|
-
source_version: 1.
|
|
4
|
-
translation_version: 1.
|
|
5
|
-
last_synced: 2026-
|
|
2
|
+
source: ../../../../core/guides/git-workflow-guide.md
|
|
3
|
+
source_version: 1.0.0
|
|
4
|
+
translation_version: 1.0.0
|
|
5
|
+
last_synced: 2026-10-16
|
|
6
|
+
source_hash: f27182c48509
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
9
|
-
# Git
|
|
10
|
+
# Git 工作流程指南
|
|
10
11
|
|
|
11
|
-
> **語言**: [English](../../../../core/git-workflow.md) | 繁體中文
|
|
12
|
+
> **語言**: [English](../../../../core/guides/git-workflow-guide.md) | 繁體中文
|
|
12
13
|
|
|
13
|
-
**版本**: 1.
|
|
14
|
-
**最後更新**: 2026-01-
|
|
15
|
-
|
|
14
|
+
**版本**: 1.0.0
|
|
15
|
+
**最後更新**: 2026-01-29
|
|
16
|
+
**相關標準**: [Git 工作流程標準](../git-workflow.md)
|
|
16
17
|
|
|
17
18
|
---
|
|
18
19
|
|
|
19
20
|
## 目的
|
|
20
21
|
|
|
21
|
-
|
|
22
|
+
本指南提供 Git 工作流程策略的詳細說明、教學與範例。有關可執行的規則與檢查清單,請參閱 [Git 工作流程標準](../git-workflow.md)。
|
|
22
23
|
|
|
23
24
|
---
|
|
24
25
|
|
|
25
|
-
##
|
|
26
|
+
## 目錄
|
|
26
27
|
|
|
27
|
-
|
|
28
|
+
1. [工作流程選擇指南](#workflow-selection-guide)
|
|
29
|
+
2. [GitFlow 詳細教學](#gitflow-detailed-tutorial)
|
|
30
|
+
3. [GitHub Flow 詳細教學](#github-flow-detailed-tutorial)
|
|
31
|
+
4. [Trunk-Based Development 教學](#trunk-based-development-tutorial)
|
|
32
|
+
5. [功能開關實作](#feature-flags-implementation)
|
|
33
|
+
6. [Ship/Show/Ask 決策模型](#shipshowask-decision-model)
|
|
34
|
+
7. [堆疊式 PR 工作流程](#stacked-prs-workflow)
|
|
35
|
+
8. [傳統式 PR 標題指南](#conventional-pr-titles-guide)
|
|
36
|
+
9. [Git 指令參考](#git-commands-reference)
|
|
37
|
+
10. [疑難排解指南](#troubleshooting-guide)
|
|
38
|
+
|
|
39
|
+
---
|
|
40
|
+
|
|
41
|
+
## 工作流程選擇指南
|
|
28
42
|
|
|
29
43
|
### 決策樹
|
|
30
44
|
|
|
@@ -34,7 +48,6 @@ status: current
|
|
|
34
48
|
┌─────────────────────────────────────┐
|
|
35
49
|
│ How often do you deploy to │
|
|
36
50
|
│ production? │
|
|
37
|
-
│ 您多常部署到正式環境? │
|
|
38
51
|
└───────────────┬─────────────────────┘
|
|
39
52
|
│
|
|
40
53
|
┌───────────────────────┼───────────────────────┐
|
|
@@ -42,7 +55,6 @@ status: current
|
|
|
42
55
|
┌────────────────┐ ┌────────────────┐ ┌────────────────┐
|
|
43
56
|
│ Multiple times │ │ Weekly to │ │ Monthly or │
|
|
44
57
|
│ per day │ │ bi-weekly │ │ longer │
|
|
45
|
-
│ 每天多次 │ │ 每週或雙週 │ │ 每月或更久 │
|
|
46
58
|
└───────┬────────┘ └───────┬────────┘ └───────┬────────┘
|
|
47
59
|
│ │ │
|
|
48
60
|
▼ ▼ ▼
|
|
@@ -97,11 +109,11 @@ status: current
|
|
|
97
109
|
|
|
98
110
|
1. **記錄在專案 README** 或 CONTRIBUTING.md 中:
|
|
99
111
|
```markdown
|
|
100
|
-
## Git
|
|
101
|
-
|
|
102
|
-
-
|
|
103
|
-
-
|
|
104
|
-
-
|
|
112
|
+
## Git Workflow
|
|
113
|
+
This project uses **GitHub Flow**.
|
|
114
|
+
- Decision date: 2025-01-15
|
|
115
|
+
- Decision maker: @techlead
|
|
116
|
+
- Rationale: Weekly deployments, single production version
|
|
105
117
|
```
|
|
106
118
|
|
|
107
119
|
2. **設定分支保護**規則以強制執行所選的工作流程。
|
|
@@ -112,10 +124,13 @@ status: current
|
|
|
112
124
|
|
|
113
125
|
---
|
|
114
126
|
|
|
115
|
-
##
|
|
127
|
+
## GitFlow 詳細教學
|
|
116
128
|
|
|
117
129
|
**最適合**:
|
|
118
|
-
|
|
130
|
+
- 定期發布(每月、每季)
|
|
131
|
+
- 同時維護多個正式版本
|
|
132
|
+
- 開發與正式環境明確分離
|
|
133
|
+
- 擁有正式發布流程的大型團隊
|
|
119
134
|
|
|
120
135
|
### 分支結構
|
|
121
136
|
|
|
@@ -131,16 +146,6 @@ release/* ●───● (Release preparation)
|
|
|
131
146
|
hotfix/* ────● (Emergency fixes)
|
|
132
147
|
```
|
|
133
148
|
|
|
134
|
-
### 分支類型
|
|
135
|
-
|
|
136
|
-
| 分支類型 | 目的 | 基礎分支 | 合併目標 | 生命週期 |
|
|
137
|
-
|---------|------|---------|----------|---------|
|
|
138
|
-
| `main` | 正式環境程式碼 | - | - | 永久 |
|
|
139
|
-
| `develop` | 整合分支 | - | - | 永久 |
|
|
140
|
-
| `feature/*` | 新功能 | `develop` | `develop` | 暫時 |
|
|
141
|
-
| `release/*` | 發布準備 | `develop` | `main` + `develop` | 暫時 |
|
|
142
|
-
| `hotfix/*` | 緊急修復 | `main` | `main` + `develop` | 暫時 |
|
|
143
|
-
|
|
144
149
|
### 工作流程步驟
|
|
145
150
|
|
|
146
151
|
#### 1. 功能開發
|
|
@@ -171,7 +176,7 @@ git push origin --delete feature/oauth-login
|
|
|
171
176
|
|
|
172
177
|
#### 2. 發布準備
|
|
173
178
|
|
|
174
|
-
>
|
|
179
|
+
> **CHANGELOG 更新**:將條目從 `[Unreleased]` 移至新版本區段並加上發布日期。詳細指南請參閱 [changelog-standards.md](../changelog-standards.md)。
|
|
175
180
|
|
|
176
181
|
```bash
|
|
177
182
|
# Create release branch from develop
|
|
@@ -232,10 +237,13 @@ git push origin --delete hotfix/critical-security-fix
|
|
|
232
237
|
|
|
233
238
|
---
|
|
234
239
|
|
|
235
|
-
##
|
|
240
|
+
## GitHub Flow 詳細教學
|
|
236
241
|
|
|
237
242
|
**最適合**:
|
|
238
|
-
|
|
243
|
+
- 持續部署
|
|
244
|
+
- Web 應用程式
|
|
245
|
+
- 中小型團隊
|
|
246
|
+
- 快速迭代週期
|
|
239
247
|
|
|
240
248
|
### 分支結構
|
|
241
249
|
|
|
@@ -247,15 +255,6 @@ feature/* ●───●───● ╱ (Feature + PR)
|
|
|
247
255
|
bugfix/* ────● (Bug fixes)
|
|
248
256
|
```
|
|
249
257
|
|
|
250
|
-
### 分支類型
|
|
251
|
-
|
|
252
|
-
| 分支類型 | 目的 | 基礎分支 | 合併目標 | 生命週期 |
|
|
253
|
-
|---------|------|---------|----------|---------|
|
|
254
|
-
| `main` | 正式環境程式碼 | - | - | 永久 |
|
|
255
|
-
| `feature/*` | 新功能 | `main` | `main` | 暫時 |
|
|
256
|
-
| `bugfix/*` | Bug 修復 | `main` | `main` | 暫時 |
|
|
257
|
-
| `hotfix/*` | 緊急修復 | `main` | `main` | 暫時 |
|
|
258
|
-
|
|
259
258
|
### 工作流程步驟
|
|
260
259
|
|
|
261
260
|
```bash
|
|
@@ -292,10 +291,13 @@ git pull origin main
|
|
|
292
291
|
|
|
293
292
|
---
|
|
294
293
|
|
|
295
|
-
##
|
|
294
|
+
## Trunk-Based Development 教學
|
|
296
295
|
|
|
297
296
|
**最適合**:
|
|
298
|
-
成熟的 CI/CD
|
|
297
|
+
- 成熟的 CI/CD 管線
|
|
298
|
+
- 高信任度且經驗豐富的團隊
|
|
299
|
+
- 頻繁整合(每天多次)
|
|
300
|
+
- 使用功能開關控制未完成功能
|
|
299
301
|
|
|
300
302
|
### 分支結構
|
|
301
303
|
|
|
@@ -305,13 +307,6 @@ main ────●─●─●─●─●─●─●──► (Single long-
|
|
|
305
307
|
feature/* ● ● ● (Very short-lived, ≤2 days)
|
|
306
308
|
```
|
|
307
309
|
|
|
308
|
-
### 分支類型
|
|
309
|
-
|
|
310
|
-
| 分支類型 | 目的 | 基礎分支 | 合併目標 | 生命週期 |
|
|
311
|
-
|---------|------|---------|----------|---------|
|
|
312
|
-
| `main` | 主幹 | - | - | 永久 |
|
|
313
|
-
| `feature/*` | 小型變更 | `main` | `main` | ≤2 天 |
|
|
314
|
-
|
|
315
310
|
### 工作流程步驟
|
|
316
311
|
|
|
317
312
|
```bash
|
|
@@ -350,7 +345,7 @@ git push origin --delete feature/add-validation
|
|
|
350
345
|
|
|
351
346
|
---
|
|
352
347
|
|
|
353
|
-
##
|
|
348
|
+
## 功能開關實作
|
|
354
349
|
|
|
355
350
|
### 為何功能開關不可或缺
|
|
356
351
|
|
|
@@ -358,20 +353,61 @@ git push origin --delete feature/add-validation
|
|
|
358
353
|
|
|
359
354
|
```
|
|
360
355
|
┌─────────────────────────────────────────────────────────────────┐
|
|
361
|
-
│
|
|
356
|
+
│ Code Lifecycle │
|
|
362
357
|
├─────────────────────────────────────────────────────────────────┤
|
|
363
|
-
│
|
|
364
|
-
│
|
|
365
|
-
│
|
|
358
|
+
│ │
|
|
359
|
+
│ Merge to main Deploy to Prod Enable for Users │
|
|
360
|
+
│ │ │ │ │
|
|
361
|
+
│ ▼ ▼ ▼ │
|
|
366
362
|
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
|
|
367
|
-
│ │
|
|
368
|
-
│ │ (
|
|
363
|
+
│ │ Commit │─────►│ Deploy │───────►│ Release │ │
|
|
364
|
+
│ │ (Code) │ │ (Binary)│ │ (Users) │ │
|
|
369
365
|
│ └─────────┘ └─────────┘ └─────────┘ │
|
|
370
|
-
│
|
|
371
|
-
│
|
|
366
|
+
│ │ │ │
|
|
367
|
+
│ │ Feature Flag │ │
|
|
368
|
+
│ └───────────────────┘ │
|
|
369
|
+
│ (Decoupled) │
|
|
372
370
|
└─────────────────────────────────────────────────────────────────┘
|
|
373
371
|
```
|
|
374
372
|
|
|
373
|
+
### 實作模式
|
|
374
|
+
|
|
375
|
+
**基本切換**:
|
|
376
|
+
|
|
377
|
+
```javascript
|
|
378
|
+
// Simple on/off flag
|
|
379
|
+
if (featureFlags.isEnabled('new-checkout-flow')) {
|
|
380
|
+
return newCheckoutFlow(cart);
|
|
381
|
+
} else {
|
|
382
|
+
return legacyCheckoutFlow(cart);
|
|
383
|
+
}
|
|
384
|
+
```
|
|
385
|
+
|
|
386
|
+
**逐步推出**:
|
|
387
|
+
|
|
388
|
+
```javascript
|
|
389
|
+
// Percentage-based rollout
|
|
390
|
+
const flag = featureFlags.get('new-checkout-flow');
|
|
391
|
+
if (flag.isEnabledForPercentage(user.id, 10)) {
|
|
392
|
+
// 10% of users see new flow
|
|
393
|
+
return newCheckoutFlow(cart);
|
|
394
|
+
}
|
|
395
|
+
```
|
|
396
|
+
|
|
397
|
+
**使用者分群鎖定**:
|
|
398
|
+
|
|
399
|
+
```javascript
|
|
400
|
+
// Target specific user segments
|
|
401
|
+
if (featureFlags.isEnabledFor('new-checkout-flow', {
|
|
402
|
+
userId: user.id,
|
|
403
|
+
plan: user.plan, // e.g., 'enterprise'
|
|
404
|
+
region: user.region, // e.g., 'asia-pacific'
|
|
405
|
+
betaTester: user.isBetaTester
|
|
406
|
+
})) {
|
|
407
|
+
return newCheckoutFlow(cart);
|
|
408
|
+
}
|
|
409
|
+
```
|
|
410
|
+
|
|
375
411
|
### 功能開關生命週期
|
|
376
412
|
|
|
377
413
|
| 階段 | 開關狀態 | 動作 |
|
|
@@ -383,6 +419,25 @@ git push origin --delete feature/add-validation
|
|
|
383
419
|
| 完整發布 | 對所有人開啟 | 預設行為 |
|
|
384
420
|
| 清理 | 移除開關 | 技術債清理 |
|
|
385
421
|
|
|
422
|
+
### 開關衛生最佳實踐
|
|
423
|
+
|
|
424
|
+
1. **具描述性地命名開關**:`enable-new-checkout-v2` 而非 `flag-123`
|
|
425
|
+
2. **設定到期日**:審查並移除陳舊開關
|
|
426
|
+
3. **限制使用中開關數量**:過多開關 = 複雜度
|
|
427
|
+
4. **記錄開關用途**:內容、原因以及何時移除
|
|
428
|
+
|
|
429
|
+
```javascript
|
|
430
|
+
// Flag metadata example
|
|
431
|
+
{
|
|
432
|
+
"name": "enable-new-checkout-v2",
|
|
433
|
+
"description": "New checkout flow with improved UX",
|
|
434
|
+
"owner": "checkout-team",
|
|
435
|
+
"createdAt": "2026-01-15",
|
|
436
|
+
"targetRemovalDate": "2026-03-15",
|
|
437
|
+
"status": "gradual-rollout"
|
|
438
|
+
}
|
|
439
|
+
```
|
|
440
|
+
|
|
386
441
|
---
|
|
387
442
|
|
|
388
443
|
## Ship/Show/Ask 決策模型
|
|
@@ -391,25 +446,131 @@ git push origin --delete feature/add-validation
|
|
|
391
446
|
|
|
392
447
|
並非所有變更都需要相同的審查流程。Ship/Show/Ask 模型幫助團隊決定:
|
|
393
448
|
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
397
|
-
|
|
398
|
-
|
|
449
|
+
```
|
|
450
|
+
┌─────────────────────────────────────────────────────────────────┐
|
|
451
|
+
│ Ship / Show / Ask │
|
|
452
|
+
├─────────────────────────────────────────────────────────────────┤
|
|
453
|
+
│ │
|
|
454
|
+
│ SHIP SHOW ASK │
|
|
455
|
+
│ ──── ──── ─── │
|
|
456
|
+
│ Push directly Merge, then Open PR, wait │
|
|
457
|
+
│ to main notify team for approval │
|
|
458
|
+
│ │
|
|
459
|
+
│ Low risk Medium risk High risk │
|
|
460
|
+
│ High confidence Need awareness Need discussion │
|
|
461
|
+
│ │
|
|
462
|
+
└─────────────────────────────────────────────────────────────────┘
|
|
463
|
+
```
|
|
399
464
|
|
|
400
465
|
### 何時 Ship(直接推送)
|
|
401
466
|
|
|
467
|
+
**準則**:
|
|
468
|
+
- 小型、低風險變更
|
|
469
|
+
- 對正確性具有高度信心
|
|
470
|
+
- 若出錯容易還原
|
|
471
|
+
- 健全的測試覆蓋率
|
|
472
|
+
|
|
473
|
+
**範例**:
|
|
402
474
|
- 文件中的錯字修正
|
|
403
475
|
- 新增除錯日誌
|
|
404
476
|
- 更新依賴(CI 通過時)
|
|
477
|
+
- 設定變更(非破壞性)
|
|
405
478
|
- 明顯的 bug 修復(有測試)
|
|
406
479
|
|
|
480
|
+
```bash
|
|
481
|
+
# Ship: Direct push to main
|
|
482
|
+
git checkout main
|
|
483
|
+
git pull origin main
|
|
484
|
+
# Make small change
|
|
485
|
+
git add .
|
|
486
|
+
git commit -m "fix: correct typo in error message"
|
|
487
|
+
git push origin main
|
|
488
|
+
```
|
|
489
|
+
|
|
490
|
+
### 何時 Show(合併後通知)
|
|
491
|
+
|
|
492
|
+
**準則**:
|
|
493
|
+
- 團隊應該知悉
|
|
494
|
+
- 程式碼審查是可有可無(錦上添花),不具阻塞性
|
|
495
|
+
- 變更單純直接
|
|
496
|
+
- 希望獲得回饋但非阻塞式核准
|
|
497
|
+
|
|
498
|
+
**範例**:
|
|
499
|
+
- 改善程式碼品質的重構
|
|
500
|
+
- 為既有功能新增測試
|
|
501
|
+
- 非關鍵的功能增強
|
|
502
|
+
- 更新內部文件
|
|
503
|
+
|
|
504
|
+
```bash
|
|
505
|
+
# Show: Merge and notify
|
|
506
|
+
git checkout -b refactor/extract-validation
|
|
507
|
+
# Make changes
|
|
508
|
+
git add .
|
|
509
|
+
git commit -m "refactor: extract validation logic"
|
|
510
|
+
git push origin refactor/extract-validation
|
|
511
|
+
|
|
512
|
+
# Create PR and immediately merge (no blocking review)
|
|
513
|
+
gh pr create --title "refactor: extract validation logic" --body "FYI: Extracting validation for reuse"
|
|
514
|
+
gh pr merge --auto --squash
|
|
515
|
+
|
|
516
|
+
# Notify team in Slack/Teams
|
|
517
|
+
```
|
|
518
|
+
|
|
407
519
|
### 何時 Ask(PR 加阻塞審查)
|
|
408
520
|
|
|
521
|
+
**準則**:
|
|
409
522
|
- 架構決策
|
|
410
523
|
- 重大變更
|
|
411
524
|
- 安全敏感程式碼
|
|
525
|
+
- 新模式或慣例
|
|
526
|
+
- 您不確定的變更
|
|
527
|
+
|
|
528
|
+
**範例**:
|
|
529
|
+
- 新 API 端點
|
|
530
|
+
- 資料庫 schema 變更
|
|
531
|
+
- 身分驗證/授權變更
|
|
412
532
|
- 共用函式庫的變更
|
|
533
|
+
- 效能關鍵程式碼
|
|
534
|
+
|
|
535
|
+
```bash
|
|
536
|
+
# Ask: Full PR process
|
|
537
|
+
git checkout -b feature/new-auth-flow
|
|
538
|
+
# Make changes
|
|
539
|
+
git push origin feature/new-auth-flow
|
|
540
|
+
|
|
541
|
+
# Create PR and request review
|
|
542
|
+
gh pr create --title "feat(auth): implement OAuth2 PKCE flow" \
|
|
543
|
+
--body "## What\nNew authentication flow\n\n## Why\nImproved security" \
|
|
544
|
+
--reviewer security-team,backend-team
|
|
545
|
+
```
|
|
546
|
+
|
|
547
|
+
### 決策流程圖
|
|
548
|
+
|
|
549
|
+
```
|
|
550
|
+
┌────────────────────────────────────────┐
|
|
551
|
+
│ Is this change risky or complex? │
|
|
552
|
+
└────────────────────┬───────────────────┘
|
|
553
|
+
│
|
|
554
|
+
┌───────────┴───────────┐
|
|
555
|
+
▼ ▼
|
|
556
|
+
YES NO
|
|
557
|
+
│ │
|
|
558
|
+
▼ ▼
|
|
559
|
+
┌─────────────────┐ ┌────────────────────────┐
|
|
560
|
+
│ Does it need │ │ Should team be aware? │
|
|
561
|
+
│ discussion? │ └───────────┬────────────┘
|
|
562
|
+
└────────┬────────┘ │
|
|
563
|
+
│ ┌────────┴────────┐
|
|
564
|
+
┌────┴────┐ ▼ ▼
|
|
565
|
+
▼ ▼ YES NO
|
|
566
|
+
YES NO │ │
|
|
567
|
+
│ │ ▼ ▼
|
|
568
|
+
▼ ▼ ┌──────────┐ ┌──────────┐
|
|
569
|
+
┌───────┐ ┌───────┐ │ SHOW │ │ SHIP │
|
|
570
|
+
│ ASK │ │ ASK │ │ (notify) │ │ (direct) │
|
|
571
|
+
│(review)│ │(review)│ └──────────┘ └──────────┘
|
|
572
|
+
└───────┘ └───────┘
|
|
573
|
+
```
|
|
413
574
|
|
|
414
575
|
---
|
|
415
576
|
|
|
@@ -420,402 +581,209 @@ git push origin --delete feature/add-validation
|
|
|
420
581
|
堆疊式 PR 將大型功能拆分為可漸進審查的較小、相依的 pull request:
|
|
421
582
|
|
|
422
583
|
```
|
|
423
|
-
|
|
424
|
-
|
|
425
|
-
|
|
426
|
-
|
|
427
|
-
|
|
428
|
-
|
|
429
|
-
|
|
584
|
+
┌─────────────────────────────────────────────────────────────────┐
|
|
585
|
+
│ Stacked PRs Structure │
|
|
586
|
+
├─────────────────────────────────────────────────────────────────┤
|
|
587
|
+
│ │
|
|
588
|
+
│ main ────●─────────────────────────────────────────► │
|
|
589
|
+
│ ╲ │
|
|
590
|
+
│ PR #1 (Database schema) ────● │
|
|
591
|
+
│ ╲ │
|
|
592
|
+
│ PR #2 (API) ────● │
|
|
593
|
+
│ ╲ │
|
|
594
|
+
│ PR #3 (UI) ●│
|
|
595
|
+
│ │
|
|
596
|
+
│ Review: PR #1 first, then #2, then #3 │
|
|
597
|
+
│ Merge: PR #1 → PR #2 → PR #3 │
|
|
598
|
+
└─────────────────────────────────────────────────────────────────┘
|
|
430
599
|
```
|
|
431
600
|
|
|
432
601
|
### 何時使用堆疊式 PR
|
|
433
602
|
|
|
434
603
|
| 情境 | 推薦使用堆疊式 PR |
|
|
435
604
|
|------|-----------------|
|
|
436
|
-
| 功能 > 500 行 |
|
|
437
|
-
| 多個邏輯元件 |
|
|
438
|
-
| 需要早期回饋 |
|
|
439
|
-
| 簡單 bug 修復 |
|
|
440
|
-
|
|
441
|
-
---
|
|
442
|
-
|
|
443
|
-
## 傳統式 PR 標題
|
|
444
|
-
|
|
445
|
-
### 格式
|
|
446
|
-
|
|
447
|
-
PR 標題應遵循與 commit 訊息相同的格式:
|
|
448
|
-
|
|
449
|
-
```
|
|
450
|
-
<type>(<scope>): <subject>
|
|
451
|
-
```
|
|
452
|
-
|
|
453
|
-
### 類型參考
|
|
605
|
+
| 功能 > 500 行 | 是 |
|
|
606
|
+
| 多個邏輯元件 | 是 |
|
|
607
|
+
| 需要早期回饋 | 是 |
|
|
608
|
+
| 簡單 bug 修復 | 否,使用單一 PR |
|
|
609
|
+
| 獨立變更 | 否,使用平行 PR |
|
|
454
610
|
|
|
455
|
-
|
|
456
|
-
|------|------|------|
|
|
457
|
-
| `feat` | 新功能 | `feat(auth): 新增 OAuth2 登入` |
|
|
458
|
-
| `fix` | Bug 修復 | `fix(api): 處理空值回應` |
|
|
459
|
-
| `docs` | 文件 | `docs(readme): 更新安裝步驟` |
|
|
460
|
-
| `refactor` | 重構 | `refactor(utils): 抽取驗證邏輯` |
|
|
461
|
-
| `test` | 新增測試 | `test(auth): 新增登入單元測試` |
|
|
462
|
-
| `chore` | 維護 | `chore(deps): 更新 lodash 到 4.17.21` |
|
|
611
|
+
### 建立堆疊式 PR
|
|
463
612
|
|
|
464
|
-
|
|
465
|
-
|
|
466
|
-
用 `!` 在類型後面表示重大變更:
|
|
613
|
+
**步驟 1:規劃堆疊**
|
|
467
614
|
|
|
468
615
|
```
|
|
469
|
-
|
|
616
|
+
Feature: User Authentication
|
|
617
|
+
├── PR #1: Database schema for users table
|
|
618
|
+
├── PR #2: User service and repository
|
|
619
|
+
├── PR #3: REST API endpoints
|
|
620
|
+
└── PR #4: Frontend login form
|
|
470
621
|
```
|
|
471
622
|
|
|
472
|
-
|
|
473
|
-
|
|
474
|
-
## 開新分支前檢查清單
|
|
475
|
-
|
|
476
|
-
開始新功能開發前,完成以下檢查以避免常見問題。
|
|
477
|
-
|
|
478
|
-
### 適用於 GitFlow 和 GitHub Flow
|
|
479
|
-
|
|
480
|
-
#### 1. 確認無未合併分支
|
|
623
|
+
**步驟 2:建立基礎分支**
|
|
481
624
|
|
|
482
625
|
```bash
|
|
483
|
-
|
|
484
|
-
|
|
485
|
-
git branch --no-merged develop
|
|
486
|
-
```
|
|
487
|
-
|
|
488
|
-
- **如有未合併分支,必須先處理**(合併或關閉)
|
|
489
|
-
- **禁止在有未合併分支的情況下開新功能分支**
|
|
490
|
-
|
|
491
|
-
#### 2. 同步最新程式碼
|
|
492
|
-
|
|
493
|
-
```bash
|
|
494
|
-
git checkout main # or develop for GitFlow
|
|
626
|
+
# Start from main
|
|
627
|
+
git checkout main
|
|
495
628
|
git pull origin main
|
|
496
|
-
```
|
|
497
|
-
|
|
498
|
-
#### 3. 確認測試通過
|
|
499
629
|
|
|
500
|
-
|
|
501
|
-
|
|
502
|
-
|
|
503
|
-
|
|
504
|
-
|
|
630
|
+
# Create first PR branch
|
|
631
|
+
git checkout -b feature/auth-1-schema
|
|
632
|
+
# Make database changes
|
|
633
|
+
git add .
|
|
634
|
+
git commit -m "feat(db): add users table schema"
|
|
635
|
+
git push origin feature/auth-1-schema
|
|
505
636
|
```
|
|
506
637
|
|
|
507
|
-
|
|
638
|
+
**步驟 3:堆疊下一個分支**
|
|
508
639
|
|
|
509
640
|
```bash
|
|
510
|
-
|
|
511
|
-
|
|
512
|
-
|
|
513
|
-
|
|
514
|
-
|
|
515
|
-
|
|
516
|
-
|--------------|------|
|
|
517
|
-
| 修復散落各處 | `main` 仍有 bug |
|
|
518
|
-
| 功能互相依賴 | 新分支缺少前一個功能的程式碼 |
|
|
519
|
-
| 合併順序混亂 | 衝突變多、歷史難追蹤 |
|
|
520
|
-
| 測試不完整 | 每個分支只測自己的部分 |
|
|
521
|
-
|
|
522
|
-
### 適用於 Trunk-Based Development
|
|
523
|
-
|
|
524
|
-
Trunk-Based Development 因其短命分支特性(≤2 天)有**不同的要求**:
|
|
525
|
-
|
|
526
|
-
| 檢查項目 | 適用性 | 說明 |
|
|
527
|
-
|---------|-------|------|
|
|
528
|
-
| 確認無未合併分支 | ⚠️ **較不適用** | 設計上分支不應存在超過 2 天 |
|
|
529
|
-
| 同步最新程式碼 | ✅ **關鍵** | 因頻繁整合,更為重要 |
|
|
530
|
-
| 確認測試通過 | ✅ **關鍵** | 自動化是此工作流程的核心 |
|
|
531
|
-
|
|
532
|
-
**關鍵差異**:若在 Trunk-Based Development 中有超過 2 天的未合併分支,這本身就違反了工作流程原則。重點應放在**頻繁整合**而非檢查未合併分支。
|
|
533
|
-
|
|
534
|
-
---
|
|
535
|
-
|
|
536
|
-
## 分支命名慣例
|
|
537
|
-
|
|
538
|
-
### 標準格式
|
|
539
|
-
|
|
540
|
-
```
|
|
541
|
-
<type>/<short-description>
|
|
542
|
-
```
|
|
543
|
-
|
|
544
|
-
### 類型
|
|
545
|
-
|
|
546
|
-
| 類型 | 用途 | 範例 |
|
|
547
|
-
|------|------|------|
|
|
548
|
-
| `feature/` | 新功能 | `feature/oauth-login` |
|
|
549
|
-
| `fix/` 或 `bugfix/` | Bug 修復 | `fix/memory-leak` |
|
|
550
|
-
| `hotfix/` | 緊急正式環境修復 | `hotfix/security-patch` |
|
|
551
|
-
| `refactor/` | 程式碼重構 | `refactor/extract-service` |
|
|
552
|
-
| `docs/` | 僅文件更新 | `docs/api-reference` |
|
|
553
|
-
| `test/` | 測試新增 | `test/integration-tests` |
|
|
554
|
-
| `chore/` | 維護任務 | `chore/update-dependencies` |
|
|
555
|
-
| `release/` | 發布準備 (僅 GitFlow) | `release/v1.2.0` |
|
|
556
|
-
|
|
557
|
-
### 命名規則
|
|
558
|
-
|
|
559
|
-
1. **使用小寫**
|
|
560
|
-
2. **使用連字號分隔單詞**
|
|
561
|
-
3. **具描述性但簡潔**
|
|
562
|
-
4. **避免僅用 issue 編號**
|
|
563
|
-
|
|
564
|
-
**良好範例**:
|
|
565
|
-
```
|
|
566
|
-
feature/user-authentication
|
|
567
|
-
fix/null-pointer-in-payment
|
|
568
|
-
hotfix/critical-data-loss
|
|
569
|
-
refactor/database-connection-pool
|
|
570
|
-
docs/update-installation-guide
|
|
571
|
-
```
|
|
572
|
-
|
|
573
|
-
**不良範例**:
|
|
574
|
-
```
|
|
575
|
-
feature/123 # ❌ 沒有描述性
|
|
576
|
-
Fix-Bug # ❌ 非小寫,過於籠統
|
|
577
|
-
feature/add_new_feature # ❌ 使用底線,過於籠統
|
|
578
|
-
myFeature # ❌ 駝峰式命名,無類型前綴
|
|
641
|
+
# Branch from previous, NOT from main
|
|
642
|
+
git checkout -b feature/auth-2-service feature/auth-1-schema
|
|
643
|
+
# Make service changes
|
|
644
|
+
git add .
|
|
645
|
+
git commit -m "feat(auth): add user service"
|
|
646
|
+
git push origin feature/auth-2-service
|
|
579
647
|
```
|
|
580
648
|
|
|
581
|
-
|
|
582
|
-
|
|
583
|
-
## 合併策略
|
|
584
|
-
|
|
585
|
-
**專案必須為每種分支類型選擇一種**。
|
|
586
|
-
|
|
587
|
-
### 選項 1: 合併提交 (--no-ff)
|
|
588
|
-
|
|
589
|
-
**保留分支歷史**
|
|
649
|
+
**步驟 4:建立連結的 PR**
|
|
590
650
|
|
|
591
651
|
```bash
|
|
592
|
-
|
|
593
|
-
|
|
594
|
-
|
|
595
|
-
|
|
596
|
-
- ✅ 完整保留歷史
|
|
597
|
-
- ✅ 易於還原整個功能
|
|
598
|
-
- ✅ 清楚的功能邊界
|
|
599
|
-
|
|
600
|
-
**缺點**:
|
|
601
|
-
- ❌ Git 日誌雜亂
|
|
602
|
-
- ❌ 複雜的圖形視覺化
|
|
603
|
-
|
|
604
|
-
**最適合**: GitFlow、長期功能分支
|
|
605
|
-
|
|
606
|
-
---
|
|
607
|
-
|
|
608
|
-
### 選項 2: 壓縮合併
|
|
652
|
+
# PR #1: Against main
|
|
653
|
+
gh pr create --base main --head feature/auth-1-schema \
|
|
654
|
+
--title "feat(db): add users table schema" \
|
|
655
|
+
--body "Part 1/4 of user authentication feature"
|
|
609
656
|
|
|
610
|
-
|
|
611
|
-
|
|
612
|
-
|
|
613
|
-
|
|
614
|
-
git commit -m "feat(auth): add user authentication"
|
|
657
|
+
# PR #2: Against PR #1's branch
|
|
658
|
+
gh pr create --base feature/auth-1-schema --head feature/auth-2-service \
|
|
659
|
+
--title "feat(auth): add user service" \
|
|
660
|
+
--body "Part 2/4 - depends on #1"
|
|
615
661
|
```
|
|
616
662
|
|
|
617
|
-
|
|
618
|
-
- ✅ 乾淨、線性的歷史
|
|
619
|
-
- ✅ 每個功能一個提交
|
|
620
|
-
- ✅ 易於閱讀的 git 日誌
|
|
621
|
-
|
|
622
|
-
**缺點**:
|
|
623
|
-
- ❌ 失去詳細歷史
|
|
624
|
-
- ❌ 無法精選個別提交
|
|
625
|
-
|
|
626
|
-
**最適合**: GitHub Flow、功能分支
|
|
663
|
+
### 處理基礎 PR 的更新
|
|
627
664
|
|
|
628
|
-
|
|
629
|
-
|
|
630
|
-
### 選項 3: 變基與快轉
|
|
631
|
-
|
|
632
|
-
**在目標分支上重播提交**
|
|
665
|
+
當 PR #1 在 PR #2 建立後發生變更時:
|
|
633
666
|
|
|
634
667
|
```bash
|
|
635
|
-
|
|
636
|
-
git checkout
|
|
637
|
-
git
|
|
668
|
+
# Rebase PR #2 on updated PR #1
|
|
669
|
+
git checkout feature/auth-2-service
|
|
670
|
+
git fetch origin
|
|
671
|
+
git rebase origin/feature/auth-1-schema
|
|
672
|
+
git push --force-with-lease origin feature/auth-2-service
|
|
638
673
|
```
|
|
639
674
|
|
|
640
|
-
|
|
641
|
-
- ✅ 線性、乾淨的歷史
|
|
642
|
-
- ✅ 保留個別提交
|
|
643
|
-
- ✅ 無合併提交
|
|
644
|
-
|
|
645
|
-
**缺點**:
|
|
646
|
-
- ❌ 改寫歷史(不要用於共享分支)
|
|
647
|
-
- ❌ 解決衝突可能繁瑣
|
|
648
|
-
|
|
649
|
-
**最適合**: Trunk-Based Development、短期分支
|
|
650
|
-
|
|
651
|
-
---
|
|
652
|
-
|
|
653
|
-
## 衝突解決
|
|
654
|
-
|
|
655
|
-
### 預防
|
|
656
|
-
|
|
657
|
-
1. **頻繁同步**
|
|
658
|
-
```bash
|
|
659
|
-
git checkout main
|
|
660
|
-
git pull origin main
|
|
661
|
-
git checkout feature/my-feature
|
|
662
|
-
git merge main # or git rebase main
|
|
663
|
-
```
|
|
664
|
-
|
|
665
|
-
2. **保持分支小型化**
|
|
666
|
-
- 避免長期功能分支
|
|
667
|
-
- 將大型功能拆分為小型 PR
|
|
668
|
-
|
|
669
|
-
3. **溝通**
|
|
670
|
-
- 宣告重大重構
|
|
671
|
-
- 協調共享檔案的修改
|
|
672
|
-
|
|
673
|
-
### 解決步驟
|
|
675
|
+
### 合併堆疊式 PR
|
|
674
676
|
|
|
675
677
|
```bash
|
|
676
|
-
#
|
|
677
|
-
|
|
678
|
-
|
|
679
|
-
git checkout feature/my-feature
|
|
680
|
-
git merge main
|
|
678
|
+
# Merge in order
|
|
679
|
+
# 1. Merge PR #1 to main (squash or merge commit)
|
|
680
|
+
gh pr merge 1 --squash
|
|
681
681
|
|
|
682
|
-
# 2.
|
|
683
|
-
#
|
|
684
|
-
|
|
685
|
-
# Current branch changes
|
|
686
|
-
# =======
|
|
687
|
-
# Incoming changes
|
|
688
|
-
# >>>>>>> main
|
|
682
|
+
# 2. Update PR #2 base to main (GitHub auto-updates)
|
|
683
|
+
# 3. Merge PR #2 to main
|
|
684
|
+
gh pr merge 2 --squash
|
|
689
685
|
|
|
690
|
-
#
|
|
691
|
-
|
|
686
|
+
# Continue for remaining PRs...
|
|
687
|
+
```
|
|
692
688
|
|
|
693
|
-
|
|
694
|
-
git commit -m "chore: resolve merge conflicts with main"
|
|
689
|
+
### 堆疊式 PR 的工具
|
|
695
690
|
|
|
696
|
-
|
|
697
|
-
|
|
698
|
-
|
|
699
|
-
|
|
700
|
-
git
|
|
701
|
-
|
|
691
|
+
| 工具 | 說明 |
|
|
692
|
+
|------|------|
|
|
693
|
+
| [Graphite](https://graphite.dev/) | 專為堆疊式 PR 打造 |
|
|
694
|
+
| [ghstack](https://github.com/ezyang/ghstack) | 用於堆疊 PR 的 CLI |
|
|
695
|
+
| [git-branchless](https://github.com/arxanas/git-branchless) | 進階 Git 工作流程 |
|
|
696
|
+
| 手動 | 使用 git rebase 和 gh CLI |
|
|
702
697
|
|
|
703
698
|
---
|
|
704
699
|
|
|
705
|
-
##
|
|
700
|
+
## 傳統式 PR 標題指南
|
|
706
701
|
|
|
707
|
-
###
|
|
702
|
+
### 格式
|
|
708
703
|
|
|
709
|
-
|
|
704
|
+
PR 標題應遵循與 commit 訊息相同的格式:
|
|
710
705
|
|
|
711
706
|
```
|
|
712
|
-
|
|
713
|
-
|
|
714
|
-
例如: v2.3.1
|
|
707
|
+
<type>(<scope>): <subject>
|
|
715
708
|
```
|
|
716
709
|
|
|
717
|
-
|
|
718
|
-
- **MINOR**: 新功能(向後相容)
|
|
719
|
-
- **PATCH**: Bug 修復(向後相容)
|
|
720
|
-
|
|
721
|
-
### 建立標籤
|
|
710
|
+
### 類型參考
|
|
722
711
|
|
|
723
|
-
|
|
724
|
-
|
|
725
|
-
|
|
712
|
+
| 類型 | 用途 | 範例 |
|
|
713
|
+
|------|------|------|
|
|
714
|
+
| `feat` | 新功能 | `feat(auth): add OAuth2 login` |
|
|
715
|
+
| `fix` | Bug 修復 | `fix(api): handle null response` |
|
|
716
|
+
| `docs` | 文件 | `docs(readme): update install steps` |
|
|
717
|
+
| `refactor` | 程式碼重構 | `refactor(utils): extract validation` |
|
|
718
|
+
| `test` | 新增測試 | `test(auth): add login unit tests` |
|
|
719
|
+
| `chore` | 維護 | `chore(deps): update lodash to 4.17.21` |
|
|
720
|
+
| `perf` | 效能 | `perf(query): optimize user lookup` |
|
|
721
|
+
| `style` | 程式碼風格 | `style(lint): fix eslint warnings` |
|
|
722
|
+
| `ci` | CI/CD 變更 | `ci(actions): add caching step` |
|
|
723
|
+
| `build` | 建置系統 | `build(webpack): upgrade to v5` |
|
|
726
724
|
|
|
727
|
-
|
|
728
|
-
git push origin v1.2.0
|
|
725
|
+
### 重大變更
|
|
729
726
|
|
|
730
|
-
|
|
731
|
-
git push origin --tags
|
|
727
|
+
在類型後加上 `!` 表示重大變更:
|
|
732
728
|
|
|
733
|
-
|
|
734
|
-
|
|
729
|
+
```
|
|
730
|
+
feat(api)!: change response format for users endpoint
|
|
735
731
|
```
|
|
736
732
|
|
|
737
|
-
###
|
|
733
|
+
### PR 標題最佳實踐
|
|
738
734
|
|
|
735
|
+
**良好範例**:
|
|
739
736
|
```
|
|
740
|
-
|
|
741
|
-
|
|
742
|
-
|
|
737
|
+
feat(checkout): add Apple Pay support
|
|
738
|
+
fix(auth): prevent session fixation attack
|
|
739
|
+
refactor(orders): extract shipping calculator
|
|
740
|
+
docs(api): document rate limiting headers
|
|
741
|
+
chore(deps): update security patches
|
|
743
742
|
```
|
|
744
743
|
|
|
745
|
-
|
|
746
|
-
|
|
747
|
-
## 保護分支
|
|
748
|
-
|
|
749
|
-
設定分支保護規則:
|
|
750
|
-
|
|
751
|
-
### 建議的 `main`/`develop` 保護:
|
|
752
|
-
|
|
753
|
-
- ✅ **需要 pull request 審查** (1-2 位審查者)
|
|
754
|
-
- ✅ **需要狀態檢查通過** (CI 測試、linting)
|
|
755
|
-
- ✅ **需要分支保持最新** 才能合併
|
|
756
|
-
- ✅ **管理員也受限制**
|
|
757
|
-
- ❌ **不允許強制推送**
|
|
758
|
-
- ❌ **不允許刪除**
|
|
759
|
-
|
|
760
|
-
**設定範例 (GitHub)**:
|
|
744
|
+
**不良範例**:
|
|
761
745
|
```
|
|
762
|
-
|
|
763
|
-
|
|
764
|
-
|
|
765
|
-
|
|
766
|
-
|
|
767
|
-
☑ Require status checks before merging
|
|
768
|
-
☑ Require branches to be up to date
|
|
769
|
-
☑ Status checks: CI/Build, Lint, Tests
|
|
770
|
-
☑ Do not allow bypassing the above settings
|
|
771
|
-
☐ Allow force pushes
|
|
772
|
-
☐ Allow deletions
|
|
746
|
+
❌ Update code (too vague)
|
|
747
|
+
❌ fix bug (not descriptive)
|
|
748
|
+
❌ WIP: working on auth (WIP shouldn't be in title)
|
|
749
|
+
❌ JIRA-1234 (no description)
|
|
750
|
+
❌ Final fixes (meaningless)
|
|
773
751
|
```
|
|
774
752
|
|
|
775
|
-
|
|
776
|
-
|
|
777
|
-
## Pull Request 工作流程
|
|
778
|
-
|
|
779
|
-
### PR 建立檢查清單
|
|
780
|
-
|
|
781
|
-
- [ ] **標題遵循提交慣例** (例如 `feat(auth): add OAuth2`)
|
|
782
|
-
- [ ] **描述說明原因** (不只是做了什麼)
|
|
783
|
-
- [ ] **連結到 issue** (例如 "Closes #123")
|
|
784
|
-
- [ ] **新功能包含測試**
|
|
785
|
-
- [ ] **必要時更新文件**
|
|
786
|
-
- [ ] **在描述中標示重大變更**
|
|
787
|
-
- [ ] **UI 變更包含截圖/GIF**
|
|
788
|
-
|
|
789
|
-
### PR 描述範本
|
|
790
|
-
|
|
791
|
-
```markdown
|
|
792
|
-
## What
|
|
793
|
-
|
|
794
|
-
[簡短描述此 PR 做了什麼]
|
|
795
|
-
|
|
796
|
-
## Why
|
|
797
|
-
|
|
798
|
-
[說明為什麼需要此變更]
|
|
799
|
-
|
|
800
|
-
## Changes
|
|
801
|
-
|
|
802
|
-
- [主要變更的條列清單]
|
|
803
|
-
- [用 ⚠️ 標記重大變更]
|
|
753
|
+
### 自動化強制執行
|
|
804
754
|
|
|
805
|
-
|
|
755
|
+
設定 GitHub Actions 來驗證 PR 標題:
|
|
806
756
|
|
|
807
|
-
|
|
808
|
-
-
|
|
809
|
-
|
|
757
|
+
```yaml
|
|
758
|
+
# .github/workflows/pr-title.yml
|
|
759
|
+
name: PR Title Check
|
|
760
|
+
on:
|
|
761
|
+
pull_request:
|
|
762
|
+
types: [opened, edited, synchronize]
|
|
810
763
|
|
|
811
|
-
|
|
812
|
-
|
|
813
|
-
|
|
814
|
-
|
|
815
|
-
|
|
816
|
-
|
|
817
|
-
|
|
818
|
-
|
|
764
|
+
jobs:
|
|
765
|
+
validate:
|
|
766
|
+
runs-on: ubuntu-latest
|
|
767
|
+
steps:
|
|
768
|
+
- uses: amannn/action-semantic-pull-request@v5
|
|
769
|
+
env:
|
|
770
|
+
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
|
|
771
|
+
with:
|
|
772
|
+
types: |
|
|
773
|
+
feat
|
|
774
|
+
fix
|
|
775
|
+
docs
|
|
776
|
+
refactor
|
|
777
|
+
test
|
|
778
|
+
chore
|
|
779
|
+
perf
|
|
780
|
+
style
|
|
781
|
+
ci
|
|
782
|
+
build
|
|
783
|
+
requireScope: false
|
|
784
|
+
subjectPattern: ^[A-Z].+$
|
|
785
|
+
subjectPatternError: |
|
|
786
|
+
Subject must start with uppercase letter
|
|
819
787
|
```
|
|
820
788
|
|
|
821
789
|
---
|
|
@@ -896,50 +864,9 @@ git rebase -i HEAD~3
|
|
|
896
864
|
|
|
897
865
|
---
|
|
898
866
|
|
|
899
|
-
##
|
|
900
|
-
|
|
901
|
-
在 `CONTRIBUTING.md` 中記錄您的工作流程:
|
|
902
|
-
|
|
903
|
-
```markdown
|
|
904
|
-
## Git Workflow
|
|
867
|
+
## 疑難排解指南
|
|
905
868
|
|
|
906
|
-
###
|
|
907
|
-
This project uses **[GitFlow / GitHub Flow / Trunk-Based Development]**.
|
|
908
|
-
|
|
909
|
-
### Branch Types
|
|
910
|
-
- `main`: Production code
|
|
911
|
-
- `develop`: Development mainline (GitFlow only)
|
|
912
|
-
- `feature/*`: New features
|
|
913
|
-
- `fix/*`: Bug fixes
|
|
914
|
-
- `hotfix/*`: Urgent production fixes
|
|
915
|
-
|
|
916
|
-
### Branch Naming
|
|
917
|
-
Format: `<type>/<description>`
|
|
918
|
-
Example: `feature/oauth-login`, `fix/memory-leak`
|
|
919
|
-
|
|
920
|
-
### Merge Strategy
|
|
921
|
-
- Feature branches: **[Squash / Merge commit / Rebase]**
|
|
922
|
-
- Release branches: Merge commit (--no-ff)
|
|
923
|
-
- Hotfix branches: Merge commit (--no-ff)
|
|
924
|
-
|
|
925
|
-
### Protected Branches
|
|
926
|
-
- `main`: Requires 1 review, CI must pass
|
|
927
|
-
- `develop`: Requires 1 review (if using GitFlow)
|
|
928
|
-
|
|
929
|
-
### Pull Request Process
|
|
930
|
-
1. Create branch from `[main/develop]`
|
|
931
|
-
2. Make changes and push
|
|
932
|
-
3. Open PR with description
|
|
933
|
-
4. Wait for review approval
|
|
934
|
-
5. Ensure CI passes
|
|
935
|
-
6. Merge using **[strategy]**
|
|
936
|
-
```
|
|
937
|
-
|
|
938
|
-
---
|
|
939
|
-
|
|
940
|
-
## 疑難排解
|
|
941
|
-
|
|
942
|
-
### 不小心提交到錯誤的分支
|
|
869
|
+
### 不小心提交到錯誤分支
|
|
943
870
|
|
|
944
871
|
```bash
|
|
945
872
|
# Undo last commit but keep changes
|
|
@@ -965,7 +892,7 @@ git checkout feature/my-feature
|
|
|
965
892
|
git rebase main
|
|
966
893
|
```
|
|
967
894
|
|
|
968
|
-
###
|
|
895
|
+
### 不小心強制推送到受保護分支
|
|
969
896
|
|
|
970
897
|
```bash
|
|
971
898
|
# ⚠️ Contact team immediately
|
|
@@ -977,40 +904,60 @@ git reset --hard <previous-commit-hash>
|
|
|
977
904
|
|
|
978
905
|
---
|
|
979
906
|
|
|
980
|
-
##
|
|
907
|
+
## 專案設定範本
|
|
981
908
|
|
|
982
|
-
|
|
983
|
-
- [Code Check-in Standards](../../../../core/checkin-standards.md) - 程式碼簽入標準
|
|
984
|
-
- [Versioning Standard](../../../../core/versioning.md) - 語義化版本標準
|
|
985
|
-
- [Changelog Standards](../../../../core/changelog-standards.md) - 變更日誌標準
|
|
909
|
+
在 `CONTRIBUTING.md` 中記錄您的工作流程:
|
|
986
910
|
|
|
987
|
-
|
|
911
|
+
```markdown
|
|
912
|
+
## Git Workflow
|
|
988
913
|
|
|
989
|
-
|
|
914
|
+
### Branching Strategy
|
|
915
|
+
This project uses **[GitFlow / GitHub Flow / Trunk-Based Development]**.
|
|
990
916
|
|
|
991
|
-
|
|
992
|
-
|
|
993
|
-
|
|
994
|
-
|
|
995
|
-
|
|
996
|
-
|
|
997
|
-
|
|
917
|
+
### Branch Types
|
|
918
|
+
- `main`: Production code
|
|
919
|
+
- `develop`: Development mainline (GitFlow only)
|
|
920
|
+
- `feature/*`: New features
|
|
921
|
+
- `fix/*`: Bug fixes
|
|
922
|
+
- `hotfix/*`: Urgent production fixes
|
|
923
|
+
|
|
924
|
+
### Branch Naming
|
|
925
|
+
Format: `<type>/<description>`
|
|
926
|
+
Example: `feature/oauth-login`, `fix/memory-leak`
|
|
927
|
+
|
|
928
|
+
### Merge Strategy
|
|
929
|
+
- Feature branches: **[Squash / Merge commit / Rebase]**
|
|
930
|
+
- Release branches: Merge commit (--no-ff)
|
|
931
|
+
- Hotfix branches: Merge commit (--no-ff)
|
|
932
|
+
|
|
933
|
+
### Protected Branches
|
|
934
|
+
- `main`: Requires 1 review, CI must pass
|
|
935
|
+
- `develop`: Requires 1 review (if using GitFlow)
|
|
936
|
+
|
|
937
|
+
### Pull Request Process
|
|
938
|
+
1. Create branch from `[main/develop]`
|
|
939
|
+
2. Make changes and push
|
|
940
|
+
3. Open PR with description
|
|
941
|
+
4. Wait for review approval
|
|
942
|
+
5. Ensure CI passes
|
|
943
|
+
6. Merge using **[strategy]**
|
|
944
|
+
```
|
|
998
945
|
|
|
999
946
|
---
|
|
1000
947
|
|
|
1001
948
|
## 參考資料
|
|
1002
949
|
|
|
1003
|
-
- [GitFlow
|
|
1004
|
-
- [GitHub Flow
|
|
950
|
+
- [GitFlow 原始文章](https://nvie.com/posts/a-successful-git-branching-model/)
|
|
951
|
+
- [GitHub Flow 指南](https://guides.github.com/introduction/flow/)
|
|
1005
952
|
- [Trunk-Based Development](https://trunkbaseddevelopment.com/)
|
|
1006
953
|
- [Semantic Versioning](https://semver.org/)
|
|
1007
954
|
- [Ship/Show/Ask](https://martinfowler.com/articles/ship-show-ask.html) - Rouan Wilsenach 的程式碼變更決策模型
|
|
1008
|
-
- [
|
|
1009
|
-
- [
|
|
1010
|
-
- [
|
|
955
|
+
- [Feature Flags 最佳實踐](https://launchdarkly.com/blog/best-practices-feature-flags/) - LaunchDarkly 的完整指南
|
|
956
|
+
- [Stacked Diffs](https://graphite.dev/guides/stacked-diffs) - Graphite 的堆疊式 PR 工作流程指南
|
|
957
|
+
- [Conventional Commits](https://www.conventionalcommits.org/) - commit 訊息規範
|
|
1011
958
|
|
|
1012
959
|
---
|
|
1013
960
|
|
|
1014
|
-
##
|
|
961
|
+
## 授權條款
|
|
1015
962
|
|
|
1016
|
-
|
|
963
|
+
本指南採用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 釋出。
|