universal-dev-standards 6.14.0-beta.1 → 6.14.0-beta.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +13 -3
- package/bin/uds.js +75 -3
- package/bundled/ai/options/code-review/pr-review.ai.yaml +20 -1
- package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
- package/bundled/ai/standards/ai-response-navigation.ai.yaml +43 -3
- package/bundled/ai/standards/checkin-standards.ai.yaml +25 -6
- package/bundled/ai/standards/code-review.ai.yaml +15 -2
- package/bundled/ai/standards/commit-message.ai.yaml +18 -4
- package/bundled/ai/standards/developer-memory.ai.yaml +12 -2
- package/bundled/ai/standards/full-coverage-testing.ai.yaml +86 -7
- package/bundled/ai/standards/open-work-tracking.ai.yaml +196 -11
- package/bundled/ai/standards/pipeline-security-gates.ai.yaml +53 -4
- package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
- package/bundled/core/ai-response-navigation.md +128 -12
- package/bundled/core/code-review-checklist.md +20 -2
- package/bundled/core/commit-message-guide.md +22 -19
- package/bundled/core/developer-memory.md +12 -2
- package/bundled/core/full-coverage-testing.md +99 -5
- package/bundled/core/open-work-tracking.md +157 -17
- package/bundled/core/pipeline-security-gates.md +63 -0
- package/bundled/core/project-context-memory.md +10 -2
- package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
- package/bundled/extensions/languages/csharp-style.md +464 -0
- package/bundled/extensions/languages/php-style.md +700 -0
- package/bundled/extensions/locales/zh-cn.md +717 -0
- package/bundled/extensions/locales/zh-tw.md +717 -0
- package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
- package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
- package/bundled/locales/COVERAGE.md +5 -4
- package/bundled/locales/zh-CN/CHANGELOG.md +199 -3
- package/bundled/locales/zh-CN/README.md +3 -3
- package/bundled/locales/zh-CN/SECURITY.md +3 -2
- package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
- package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
- package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
- package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
- package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
- package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
- package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
- package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
- package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
- package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
- package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
- package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
- package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
- package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
- package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
- package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
- package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
- package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
- package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
- package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
- package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
- package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
- package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
- package/bundled/locales/zh-CN/core/code-review-checklist.md +54 -23
- package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
- package/bundled/locales/zh-CN/core/database-standards.md +115 -114
- package/bundled/locales/zh-CN/core/developer-memory.md +159 -60
- package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
- package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
- package/bundled/locales/zh-CN/core/execution-history.md +2 -1
- package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
- package/bundled/locales/zh-CN/core/full-coverage-testing.md +103 -9
- package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
- package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
- package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
- package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
- package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
- package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
- package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
- package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
- package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
- package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
- package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
- package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
- package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
- package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
- package/bundled/locales/zh-CN/core/security-decision.md +45 -70
- package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
- package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
- package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
- package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
- package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
- package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
- package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
- package/bundled/locales/zh-CN/core/test-governance.md +94 -43
- package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
- package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
- package/bundled/locales/zh-CN/core/token-budget.md +44 -80
- package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
- package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
- package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
- package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
- package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
- package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
- package/bundled/locales/zh-CN/docs/CHEATSHEET.md +9 -3
- package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +68 -33
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +29 -15
- package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
- package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
- package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
- package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
- package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
- package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +46 -0
- package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
- package/bundled/locales/zh-CN/docs/user/README.md +4 -2
- package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
- package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
- package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
- package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
- package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
- package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
- package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
- package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
- package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
- package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
- package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
- package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
- package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
- package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
- package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
- package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
- package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
- package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
- package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
- package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
- package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
- package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
- package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
- package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
- package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
- package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
- package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
- package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
- package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
- package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
- package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
- package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
- package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
- package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
- package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
- package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
- package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
- package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
- package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
- package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
- package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
- package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
- package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/skills/README.md +3 -1
- package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
- package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
- package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
- package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
- package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
- package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
- package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
- package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
- package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
- package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
- package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
- package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
- package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
- package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
- package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
- package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
- package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
- package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
- package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
- package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
- package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
- package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
- package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
- package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
- package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
- package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
- package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
- package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
- package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
- package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
- package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
- package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
- package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
- package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
- package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
- package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
- package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
- package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
- package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
- package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
- package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
- package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
- package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
- package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
- package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
- package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
- package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
- package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
- package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
- package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
- package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
- package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
- package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
- package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
- package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
- package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
- package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
- package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
- package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
- package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
- package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
- package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
- package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
- package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
- package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
- package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
- package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
- package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
- package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
- package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
- package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
- package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
- package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
- package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
- package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
- package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
- package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
- package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
- package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
- package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
- package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
- package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
- package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
- package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
- package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
- package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
- package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
- package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
- package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
- package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
- package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
- package/bundled/locales/zh-TW/CHANGELOG.md +199 -3
- package/bundled/locales/zh-TW/README.md +3 -3
- package/bundled/locales/zh-TW/SECURITY.md +3 -2
- package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
- package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
- package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
- package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
- package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
- package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
- package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
- package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
- package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
- package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
- package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
- package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
- package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
- package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
- package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
- package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
- package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
- package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
- package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
- package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
- package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
- package/bundled/locales/zh-TW/core/code-review-checklist.md +36 -7
- package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
- package/bundled/locales/zh-TW/core/database-standards.md +2 -1
- package/bundled/locales/zh-TW/core/developer-memory.md +111 -12
- package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
- package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
- package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
- package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
- package/bundled/locales/zh-TW/core/execution-history.md +2 -1
- package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
- package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
- package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
- package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
- package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
- package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
- package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
- package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
- package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
- package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
- package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
- package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
- package/bundled/locales/zh-TW/core/open-work-tracking.md +92 -16
- package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
- package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
- package/bundled/locales/zh-TW/core/project-context-memory.md +215 -31
- package/bundled/locales/zh-TW/core/project-structure.md +240 -19
- package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
- package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
- package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
- package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
- package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
- package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
- package/bundled/locales/zh-TW/core/security-decision.md +43 -84
- package/bundled/locales/zh-TW/core/security-standards.md +204 -25
- package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
- package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
- package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
- package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
- package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
- package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
- package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
- package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
- package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
- package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
- package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
- package/bundled/locales/zh-TW/core/test-governance.md +92 -32
- package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
- package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
- package/bundled/locales/zh-TW/core/token-budget.md +41 -112
- package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
- package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
- package/bundled/locales/zh-TW/core/versioning.md +6 -2
- package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
- package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
- package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
- package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
- package/bundled/locales/zh-TW/docs/CHEATSHEET.md +9 -3
- package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +61 -26
- package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +29 -15
- package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
- package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
- package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
- package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
- package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
- package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +46 -0
- package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
- package/bundled/locales/zh-TW/docs/user/README.md +2 -0
- package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
- package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
- package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
- package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
- package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
- package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
- package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
- package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
- package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
- package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
- package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
- package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
- package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
- package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
- package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
- package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
- package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
- package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
- package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
- package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
- package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
- package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
- package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
- package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
- package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
- package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
- package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
- package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
- package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
- package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
- package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
- package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
- package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
- package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
- package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
- package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
- package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
- package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
- package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
- package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
- package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/skills/README.md +3 -1
- package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
- package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
- package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
- package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
- package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
- package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
- package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
- package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
- package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
- package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
- package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
- package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
- package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
- package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
- package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
- package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
- package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
- package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
- package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
- package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
- package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
- package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
- package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
- package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
- package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
- package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
- package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
- package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
- package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
- package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
- package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
- package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
- package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
- package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
- package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
- package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
- package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
- package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
- package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
- package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
- package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
- package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
- package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
- package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
- package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
- package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
- package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
- package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
- package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
- package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
- package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
- package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
- package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
- package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
- package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
- package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
- package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
- package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
- package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
- package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
- package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
- package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
- package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
- package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
- package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
- package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
- package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
- package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
- package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
- package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
- package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
- package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
- package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
- package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
- package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
- package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
- package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
- package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
- package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
- package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
- package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
- package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
- package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
- package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
- package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
- package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
- package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
- package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
- package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
- package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
- package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
- package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
- package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
- package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
- package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
- package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
- package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
- package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
- package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
- package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
- package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
- package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
- package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
- package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
- package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
- package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
- package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
- package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
- package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
- package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
- package/bundled/skills/README.md +1 -0
- package/bundled/skills/SKILL_NAMING.md +9 -0
- package/bundled/skills/commit-standards/SKILL.md +2 -2
- package/bundled/skills/commit-standards/guide.md +3 -2
- package/bundled/skills/commit-standards/language-options.md +19 -17
- package/bundled/skills/comprehension-ladder/SKILL.md +283 -0
- package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
- package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
- package/bundled/templates/gates/check-stubs.mjs +644 -0
- package/package.json +5 -3
- package/src/commands/audit.js +20 -2
- package/src/commands/check.js +155 -28
- package/src/commands/deps.js +31 -1
- package/src/commands/hitl.js +3 -0
- package/src/commands/init.js +159 -48
- package/src/commands/list.js +12 -3
- package/src/commands/mcp.js +2 -3
- package/src/commands/open-work.js +123 -0
- package/src/commands/quickstart.js +29 -13
- package/src/commands/release.js +102 -19
- package/src/commands/run-intent.js +11 -0
- package/src/commands/simulate.js +20 -8
- package/src/commands/skills.js +59 -33
- package/src/commands/spec-split.js +30 -17
- package/src/commands/spec.js +55 -21
- package/src/commands/uninstall.js +146 -32
- package/src/commands/update.js +471 -93
- package/src/core/install-records.js +192 -0
- package/src/core/manifest.js +12 -10
- package/src/core/marketplace-sentinel.js +5 -0
- package/src/core/open-work-config.js +122 -0
- package/src/core/project-config.js +113 -38
- package/src/flows/init-flow.js +10 -0
- package/src/hitl/manager.js +4 -2
- package/src/i18n/messages.js +413 -78
- package/src/installers/hooks-installer.js +236 -27
- package/src/installers/integration-installer.js +5 -1
- package/src/installers/skills-installer.js +3 -1
- package/src/installers/standards-installer.js +16 -23
- package/src/mcp/__tests__/server.test.js +0 -1
- package/src/mcp/server.js +16 -4
- package/src/prompts/init.js +148 -13
- package/src/reconciler/backup-locations.js +80 -0
- package/src/reconciler/backup-manager.js +451 -123
- package/src/reconciler/index.js +86 -10
- package/src/reconciler/install-roots.js +90 -0
- package/src/reconciler/plan-executor.js +37 -15
- package/src/uninstallers/hook-uninstaller.js +220 -33
- package/src/uninstallers/integration-uninstaller.js +35 -5
- package/src/uninstallers/skills-uninstaller.js +95 -16
- package/src/uninstallers/standards-uninstaller.js +56 -7
- package/src/utils/agents-installer.js +10 -17
- package/src/utils/available-standards-report.js +144 -0
- package/src/utils/available-standards.js +216 -0
- package/src/utils/command-hash-ownership.js +103 -0
- package/src/utils/commit-message-judge.js +155 -0
- package/src/utils/copier.js +80 -2
- package/src/utils/deps-applicability.js +25 -0
- package/src/utils/detector.js +46 -1
- package/src/utils/friction-detector.js +27 -0
- package/src/utils/gate-scripts.js +141 -0
- package/src/utils/git-hooks.js +139 -7
- package/src/utils/hasher.js +36 -0
- package/src/utils/health-scorer.js +10 -7
- package/src/utils/installed-names-ownership.js +114 -0
- package/src/utils/integration-generator.js +36 -24
- package/src/utils/legacy-hook-migration.js +112 -0
- package/src/utils/locale.js +19 -0
- package/src/utils/open-work-tracking.mjs +1754 -0
- package/src/utils/prompt-closed.js +18 -0
- package/src/utils/sdd-header.js +66 -0
- package/src/utils/skill-frontmatter.js +102 -0
- package/src/utils/skill-hash-ownership.js +64 -0
- package/src/utils/skill-name-collision.js +169 -0
- package/src/utils/skills-install-paths.js +114 -0
- package/src/utils/skills-installer.js +75 -106
- package/src/utils/standard-validator.js +98 -27
- package/src/utils/test-change-check.js +160 -0
- package/src/utils/test-policy.js +214 -0
- package/src/utils/transient-fs.js +113 -0
- package/src/utils/update-summary.js +29 -0
- package/src/vibe/micro-spec.js +15 -0
- package/standards-registry.json +48 -9
|
@@ -1,18 +1,22 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../core/code-review-checklist.md
|
|
3
|
-
source_version: 1.
|
|
4
|
-
translation_version: 1.
|
|
5
|
-
last_synced: 2026-
|
|
6
|
-
|
|
3
|
+
source_version: 1.6.0
|
|
4
|
+
translation_version: 1.6.0
|
|
5
|
+
last_synced: 2026-10-11
|
|
6
|
+
source_hash: 405318729fc5
|
|
7
|
+
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
9
10
|
# 程式碼審查檢查清單
|
|
10
11
|
|
|
11
12
|
> **語言**: [English](../../../core/code-review-checklist.md) | 繁體中文
|
|
12
13
|
|
|
13
|
-
**版本**: 1.
|
|
14
|
-
**最後更新**: 2026-
|
|
14
|
+
**版本**: 1.6.0
|
|
15
|
+
**最後更新**: 2026-10-08
|
|
15
16
|
**適用範圍**: 所有進行程式碼審查的軟體專案
|
|
17
|
+
**範圍**: universal
|
|
18
|
+
**業界標準**: SWEBOK v4.0 第 10 章
|
|
19
|
+
**參考資料**: [google.github.io](https://google.github.io/eng-practices/review/)
|
|
16
20
|
|
|
17
21
|
---
|
|
18
22
|
|
|
@@ -146,6 +150,7 @@ status: stale
|
|
|
146
150
|
- Test names describe scenarios
|
|
147
151
|
- Assertions are clear
|
|
148
152
|
- No flaky tests
|
|
153
|
+
- 預期值獨立於被測程式碼:字面值、手算例或規格——不是同一個呼叫再寫一次,也不是同一套算式再打一遍(見[禁止:恆真斷言](full-coverage-testing.md))
|
|
149
154
|
|
|
150
155
|
- [ ] **測試覆蓋率維持**
|
|
151
156
|
- Coverage not decreased
|
|
@@ -252,6 +257,19 @@ status: stale
|
|
|
252
257
|
|
|
253
258
|
---
|
|
254
259
|
|
|
260
|
+
### 11. 合併風險(可逆性)
|
|
261
|
+
|
|
262
|
+
- [ ] **變更寫明了它的門與影響範圍**
|
|
263
|
+
- **雙向門**:合併後能輕鬆退回
|
|
264
|
+
- **單向門**:無法退回或很難退回——資料遷移、刪除、預設行為改變、結束碼改變、對外介面改名
|
|
265
|
+
- **影響範圍**:用一個詞說明波及多遠(例如 `docs`、`cli`、`adopters`)
|
|
266
|
+
|
|
267
|
+
- [ ] **單向門在合併前已讓決策者知情**
|
|
268
|
+
- 決定要不要合併的人,已在 PR 描述或交件報告中被告知這個變更無法輕易退回
|
|
269
|
+
- 欄位缺漏時,請對方補上;不要只憑差異內容推測是哪一種門
|
|
270
|
+
|
|
271
|
+
---
|
|
272
|
+
|
|
255
273
|
## 審查評論類型
|
|
256
274
|
|
|
257
275
|
Use these prefixes to clarify comment intent:
|
|
@@ -325,6 +343,7 @@ Is there a specific reason for this approach?
|
|
|
325
343
|
1. Read PR description and linked issues
|
|
326
344
|
2. Understand WHY the change is needed
|
|
327
345
|
3. Review design/spec documents if linked
|
|
346
|
+
4. 閱讀「合併風險」欄(門與影響範圍);若是單向門,確認決策者在合併前已知情
|
|
328
347
|
|
|
329
348
|
#### Step 2: 高層級審查
|
|
330
349
|
|
|
@@ -362,6 +381,7 @@ Is there a specific reason for this approach?
|
|
|
362
381
|
2. **本地執行測試**
|
|
363
382
|
3. **檢查 CI 狀態**
|
|
364
383
|
4. **撰寫清楚的 PR 描述**
|
|
384
|
+
5. **寫明合併風險**——門(雙向或單向)與影響範圍,一個詞
|
|
365
385
|
|
|
366
386
|
#### 審查期間
|
|
367
387
|
|
|
@@ -483,6 +503,12 @@ jobs:
|
|
|
483
503
|
| 200-500 lines | 1 day | 2 days |
|
|
484
504
|
| > 500 lines | 🚨 Consider splitting | 3+ days |
|
|
485
505
|
|
|
506
|
+
> **來源與可設定性**:PR 大小分級反映實證觀察到的現象——變更超過約 200–400 行後,
|
|
507
|
+
> 審查成效明顯下降(SmartBear/Cisco 程式碼審查研究;
|
|
508
|
+
> [Google engineering practices](https://google.github.io/eng-practices/review/))。
|
|
509
|
+
> 回應時間目標為 UDS 預設值——請替換為團隊自己的審查 SLA。
|
|
510
|
+
> **例外**:產生的或 vendored 的大量變更(lockfile、migration、snapshot)以抽查方式審查,不以行數計。
|
|
511
|
+
|
|
486
512
|
### 審查者可用性
|
|
487
513
|
|
|
488
514
|
- Set "review hours" in team calendar
|
|
@@ -648,6 +674,7 @@ All PRs must pass:
|
|
|
648
674
|
│ ✓ Errors - Properly handled? │
|
|
649
675
|
│ ✓ Docs - Updated? │
|
|
650
676
|
│ ✓ Dependencies - Necessary? │
|
|
677
|
+
│ ✓ Merge danger - One-way door told? │
|
|
651
678
|
└─────────────────────────────────────────┘
|
|
652
679
|
|
|
653
680
|
Comment Prefixes:
|
|
@@ -664,6 +691,9 @@ Comment Prefixes:
|
|
|
664
691
|
|
|
665
692
|
| Version | Date | Changes |
|
|
666
693
|
|---------|------|---------|
|
|
694
|
+
| 1.6.0 | 2026-10-08 | 新增:合併風險(門與影響範圍)作為檢查項 11,並加入審查者/作者步驟——單向門須在合併前讓決策者知情;於「測試品質良好」新增預期值須獨立於被測程式碼(XSPEC-470 R1、R2) |
|
|
695
|
+
| 1.5.0 | 2026-08-24 | 新增:指向 `deferred-item-exit`,適用於本次未改而被接受的非阻斷留言(XSPEC-391 R5) |
|
|
696
|
+
| 1.4.0 | 2026-06-18 | 新增:PR 大小/回應時間門檻的來源與可設定性說明(SmartBear/Cisco 研究、Google 實務)及大量變更例外(XSPEC-292 T8) |
|
|
667
697
|
| 1.3.0 | 2026-01-12 | 新增:完整重構 PR 段落,包含審查前檢查清單、審查重點、大型重構指南、警示信號及最佳實踐 |
|
|
668
698
|
| 1.2.0 | 2026-01-05 | 新增:SWEBOK v4.0 第 10 章(軟體品質)至參考資料 |
|
|
669
699
|
| 1.1.0 | 2025-12-22 | Added: Alternative text labels section for review comments (中文標籤支援) |
|
|
@@ -676,7 +706,6 @@ Comment Prefixes:
|
|
|
676
706
|
|
|
677
707
|
## 相關標準
|
|
678
708
|
|
|
679
|
-
- [Refactoring Standards](refactoring-standards.md) - 重構標準(遺留程式碼策略、大規模模式、度量指標)
|
|
680
709
|
- [Testing Standards](testing-standards.md) - 測試標準 (UT/IT/ST/E2E)(或使用 `/testing-guide` 技能)
|
|
681
710
|
- [Code Check-in Standards](checkin-standards.md) - 程式碼簽入標準
|
|
682
711
|
- [Commit Message Guide](commit-message-guide.md) - Commit 訊息規範
|
|
@@ -1,8 +1,9 @@
|
|
|
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-12
|
|
6
|
+
source_hash: 8bf9a79dc6d1
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
@@ -10,9 +11,12 @@ status: current
|
|
|
10
11
|
|
|
11
12
|
> **語言**: [English](../../../core/commit-message-guide.md) | 繁體中文
|
|
12
13
|
|
|
13
|
-
**版本**: 1.
|
|
14
|
-
**最後更新**:
|
|
14
|
+
**版本**: 1.4.0
|
|
15
|
+
**最後更新**: 2026-10-12
|
|
15
16
|
**適用範圍**: 所有使用 Git 版本控制的專案
|
|
17
|
+
**範圍**: universal
|
|
18
|
+
**業界標準**: Conventional Commits 1.0.0
|
|
19
|
+
**參考資料**: [conventionalcommits.org](https://www.conventionalcommits.org/)
|
|
16
20
|
|
|
17
21
|
---
|
|
18
22
|
|
|
@@ -69,22 +73,24 @@ status: current
|
|
|
69
73
|
|
|
70
74
|
### 選項 B: 繁體中文(台灣團隊適用)
|
|
71
75
|
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
| 類型
|
|
75
|
-
|
|
|
76
|
-
|
|
|
77
|
-
|
|
|
78
|
-
|
|
|
79
|
-
|
|
|
80
|
-
|
|
|
81
|
-
|
|
|
82
|
-
|
|
|
83
|
-
|
|
|
84
|
-
|
|
|
85
|
-
|
|
|
86
|
-
|
|
|
87
|
-
|
|
|
76
|
+
使用**選項 A 的英文類型**,主旨與本文使用繁體中文,適合偏好母語提交的本地團隊。類型維持英文,因為工具會讀它(commitlint `type-enum`、changelog 產生器、`uds simulate`);只有主旨與本文是中文。**不可**使用 `新增` 這類中文類型。
|
|
77
|
+
|
|
78
|
+
| 類型 | 使用時機 | 範例 |
|
|
79
|
+
| ---------- | -------------- | -------------------------------------- |
|
|
80
|
+
| `feat` | 新功能 | `feat(auth): 加入 OAuth2 登入` |
|
|
81
|
+
| `fix` | Bug 修復 | `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`)。
|
|
88
94
|
|
|
89
95
|
### 選項 C: 雙語對照模式(推薦)
|
|
90
96
|
|
|
@@ -122,6 +128,8 @@ Implement Google OAuth2 authentication flow for user login.
|
|
|
122
128
|
Closes #123
|
|
123
129
|
```
|
|
124
130
|
|
|
131
|
+
> **注意**: 此設定在專案 manifest 中名為 `output_language`,同時控制 commit 訊息語言與文件語言。關於此設定如何影響文件,詳見 [documentation-writing-standards.md](documentation-writing-standards.md#documentation-language-configuration)。
|
|
132
|
+
|
|
125
133
|
### 語言選擇指南
|
|
126
134
|
|
|
127
135
|
使用此指南為您的專案選擇適當的 commit 訊息語言:
|
|
@@ -154,7 +162,7 @@ Closes #123
|
|
|
154
162
|
本專案使用**英文** commit 類型(feat, fix, refactor 等)
|
|
155
163
|
|
|
156
164
|
<!-- 選項 B: 繁體中文 -->
|
|
157
|
-
|
|
165
|
+
本專案使用**英文** commit 類型(feat, fix, refactor 等),主旨與本文使用**繁體中文**
|
|
158
166
|
|
|
159
167
|
<!-- 選項 C: 雙語對照模式 -->
|
|
160
168
|
本專案使用**雙語對照模式**,type/scope 使用英文,subject/body 採用雙語對照。
|
|
@@ -221,16 +229,16 @@ database, config, middleware, api, tests, docs
|
|
|
221
229
|
4. **無句點**: 結尾不加句點(例外:雙語模式使用句點作為分隔符)
|
|
222
230
|
5. **語言**: 遵循專案政策(英文或母語)
|
|
223
231
|
|
|
224
|
-
###
|
|
232
|
+
### 良好範例
|
|
225
233
|
|
|
226
234
|
```
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
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
|
|
234
242
|
```
|
|
235
243
|
|
|
236
244
|
### 不良範例
|
|
@@ -308,23 +316,43 @@ database, config, middleware, api, tests, docs
|
|
|
308
316
|
#### 範例 1: 含上下文的功能
|
|
309
317
|
|
|
310
318
|
```
|
|
311
|
-
|
|
319
|
+
feat(payment): Add support for PayPal payment method
|
|
312
320
|
|
|
313
|
-
|
|
314
|
-
-
|
|
315
|
-
-
|
|
316
|
-
-
|
|
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
|
|
317
325
|
|
|
318
|
-
|
|
319
|
-
-
|
|
320
|
-
-
|
|
321
|
-
-
|
|
322
|
-
-
|
|
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
|
|
323
331
|
|
|
324
|
-
|
|
325
|
-
-
|
|
326
|
-
-
|
|
327
|
-
|
|
332
|
+
Technical notes:
|
|
333
|
+
- Used sandbox environment for testing
|
|
334
|
+
- Webhook signature validation implemented for security
|
|
335
|
+
```
|
|
336
|
+
|
|
337
|
+
#### 範例 2: 含根因分析的 Bug 修正
|
|
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)
|
|
328
356
|
```
|
|
329
357
|
|
|
330
358
|
---
|
|
@@ -382,7 +410,13 @@ Closes #123
|
|
|
382
410
|
|
|
383
411
|
### 破壞性變更
|
|
384
412
|
|
|
385
|
-
|
|
413
|
+
**關鍵**: 永遠在頁尾記錄破壞性變更,並附上遷移指引。
|
|
414
|
+
|
|
415
|
+
**要求**:
|
|
416
|
+
1. 在頁尾使用 `BREAKING CHANGE:` 前綴
|
|
417
|
+
2. 描述變更了什麼以及原因
|
|
418
|
+
3. **必須**包含具可執行步驟的遷移指南
|
|
419
|
+
4. 盡可能提供變更前/後的範例
|
|
386
420
|
|
|
387
421
|
**格式**:
|
|
388
422
|
|
|
@@ -390,22 +424,24 @@ Closes #123
|
|
|
390
424
|
BREAKING CHANGE: <描述>
|
|
391
425
|
|
|
392
426
|
遷移指南:
|
|
393
|
-
- 步驟 1
|
|
394
|
-
- 步驟 2
|
|
427
|
+
- 步驟 1: <具體動作>
|
|
428
|
+
- 步驟 2: <具體動作>
|
|
395
429
|
```
|
|
396
430
|
|
|
431
|
+
> **為何必須提供遷移指南**: 沒有遷移路徑的破壞性變更會讓使用者受挫並拖慢採用速度。每個破壞性變更都**必須**明確告訴使用者該怎麼做。
|
|
432
|
+
|
|
397
433
|
**範例**:
|
|
398
434
|
|
|
399
435
|
```
|
|
400
|
-
feat(api):
|
|
436
|
+
feat(api): Change user endpoint response format
|
|
401
437
|
|
|
402
|
-
-
|
|
403
|
-
-
|
|
404
|
-
-
|
|
438
|
+
- Flatten nested user object structure
|
|
439
|
+
- Remove deprecated `legacy_id` field
|
|
440
|
+
- Add `created_at` and `updated_at` timestamps
|
|
405
441
|
|
|
406
|
-
BREAKING CHANGE:
|
|
442
|
+
BREAKING CHANGE: User API response format changed
|
|
407
443
|
|
|
408
|
-
|
|
444
|
+
Old format:
|
|
409
445
|
```json
|
|
410
446
|
{
|
|
411
447
|
"data": {
|
|
@@ -418,7 +454,7 @@ BREAKING CHANGE: 使用者 API 回應格式已變更
|
|
|
418
454
|
}
|
|
419
455
|
```
|
|
420
456
|
|
|
421
|
-
|
|
457
|
+
New format:
|
|
422
458
|
|
|
423
459
|
```json
|
|
424
460
|
{
|
|
@@ -429,11 +465,11 @@ BREAKING CHANGE: 使用者 API 回應格式已變更
|
|
|
429
465
|
}
|
|
430
466
|
```
|
|
431
467
|
|
|
432
|
-
|
|
468
|
+
Migration guide:
|
|
433
469
|
|
|
434
|
-
-
|
|
435
|
-
-
|
|
436
|
-
-
|
|
470
|
+
- Update API clients to remove `.data` wrapper
|
|
471
|
+
- Remove references to `legacy_id` field
|
|
472
|
+
- Use `created_at` instead of `createdAt` (snake_case)
|
|
437
473
|
|
|
438
474
|
Closes #234
|
|
439
475
|
|
|
@@ -443,7 +479,55 @@ Closes #234
|
|
|
443
479
|
|
|
444
480
|
## 完整範例
|
|
445
481
|
|
|
446
|
-
### 範例 1:
|
|
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: 雙語對照模式 - 簡單修正
|
|
447
531
|
|
|
448
532
|
```
|
|
449
533
|
|
|
@@ -459,7 +543,7 @@ Fixes #445
|
|
|
459
543
|
|
|
460
544
|
---
|
|
461
545
|
|
|
462
|
-
### 範例
|
|
546
|
+
### 範例 4: 雙語對照模式 - 功能
|
|
463
547
|
|
|
464
548
|
```
|
|
465
549
|
|
|
@@ -508,7 +592,7 @@ Refs #234
|
|
|
508
592
|
|
|
509
593
|
---
|
|
510
594
|
|
|
511
|
-
### 範例
|
|
595
|
+
### 範例 5: 雙語對照模式 - 含根因分析的 Bug 修正
|
|
512
596
|
|
|
513
597
|
```
|
|
514
598
|
|
|
@@ -552,7 +636,53 @@ Fixes #789
|
|
|
552
636
|
|
|
553
637
|
---
|
|
554
638
|
|
|
555
|
-
### 範例
|
|
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: 雙語對照模式 - 破壞性變更
|
|
556
686
|
|
|
557
687
|
```
|
|
558
688
|
|
|
@@ -589,7 +719,7 @@ Estimated downtime: 2-4 hours
|
|
|
589
719
|
變更內容:
|
|
590
720
|
|
|
591
721
|
- 更新資料庫驅動從 mysql2 至 pg
|
|
592
|
-
- 將 MySQL 專用查詢轉換為 PostgreSQL
|
|
722
|
+
- 將 MySQL 專用查詢轉換為 PostgreSQL 語法
|
|
593
723
|
- 更新連線池設定
|
|
594
724
|
|
|
595
725
|
破壞性變更: 資料庫引擎從 MySQL 變更為 PostgreSQL
|
|
@@ -627,9 +757,9 @@ update: changes
|
|
|
627
757
|
**✅ 修正**:
|
|
628
758
|
```
|
|
629
759
|
|
|
630
|
-
fix(login):
|
|
631
|
-
refactor(utils):
|
|
632
|
-
feat(profile):
|
|
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
|
|
633
763
|
|
|
634
764
|
```
|
|
635
765
|
|
|
@@ -648,10 +778,10 @@ feat: add login, fix bugs, refactor database, update docs
|
|
|
648
778
|
**✅ 修正**: 拆分為多個 commit:
|
|
649
779
|
```
|
|
650
780
|
|
|
651
|
-
feat(auth):
|
|
652
|
-
fix(api):
|
|
653
|
-
refactor(database):
|
|
654
|
-
docs(api):
|
|
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
|
|
655
785
|
|
|
656
786
|
```
|
|
657
787
|
|
|
@@ -670,10 +800,10 @@ fix: change line 45 from getUserById to getUserByEmail because the function was
|
|
|
670
800
|
**✅ 修正**:
|
|
671
801
|
```
|
|
672
802
|
|
|
673
|
-
fix(api):
|
|
803
|
+
fix(api): Use correct user lookup method in password reset
|
|
674
804
|
|
|
675
|
-
|
|
676
|
-
|
|
805
|
+
The password reset flow was calling getUserById with an email parameter,
|
|
806
|
+
causing lookups to fail. Now correctly calls getUserByEmail.
|
|
677
807
|
|
|
678
808
|
Fixes #789
|
|
679
809
|
|
|
@@ -691,7 +821,7 @@ refactor(database): migrate to PostgreSQL
|
|
|
691
821
|
|
|
692
822
|
**問題**: 破壞性變更卻無遷移指南或上下文。
|
|
693
823
|
|
|
694
|
-
**✅ 修正**: 加入含上下文和遷移指南的主體(參見上方範例
|
|
824
|
+
**✅ 修正**: 加入含上下文和遷移指南的主體(參見上方範例 6)。
|
|
695
825
|
|
|
696
826
|
---
|
|
697
827
|
|
|
@@ -756,16 +886,16 @@ git-chglog --output CHANGELOG.md
|
|
|
756
886
|
本專案使用**[英文 / 繁體中文 / 雙語對照]** commit 類型。
|
|
757
887
|
|
|
758
888
|
### 允許的類型
|
|
759
|
-
- feat
|
|
760
|
-
- fix
|
|
761
|
-
- refactor
|
|
762
|
-
- docs
|
|
763
|
-
- test
|
|
764
|
-
- perf
|
|
765
|
-
- build
|
|
766
|
-
- ci
|
|
767
|
-
- chore
|
|
768
|
-
- security
|
|
889
|
+
- feat: 新功能
|
|
890
|
+
- fix: Bug 修復
|
|
891
|
+
- refactor: 程式碼重構
|
|
892
|
+
- docs: 文件
|
|
893
|
+
- test: 測試
|
|
894
|
+
- perf: 效能改進
|
|
895
|
+
- build: 建置系統
|
|
896
|
+
- ci: CI/CD 變更
|
|
897
|
+
- chore: 維護
|
|
898
|
+
- security: 安全修復
|
|
769
899
|
|
|
770
900
|
### 允許的範圍
|
|
771
901
|
- auth: 認證模組
|
|
@@ -779,11 +909,11 @@ Commit 主旨行應使用**[英文/繁體中文/雙語]**。
|
|
|
779
909
|
|
|
780
910
|
### 範例
|
|
781
911
|
|
|
782
|
-
|
|
912
|
+
**英文**:
|
|
783
913
|
```
|
|
784
914
|
|
|
785
|
-
|
|
786
|
-
|
|
915
|
+
feat(auth): Add OAuth2 support
|
|
916
|
+
fix(api): Resolve memory leak
|
|
787
917
|
|
|
788
918
|
```
|
|
789
919
|
|
|
@@ -817,6 +947,7 @@ Closes #123
|
|
|
817
947
|
|
|
818
948
|
| 版本 | 日期 | 變更 |
|
|
819
949
|
| ----- | ---------- | -------------------------------------------------------------------------- |
|
|
950
|
+
| 1.4.0 | 2026-10-12 | 變更:選項 B(繁體中文)改用英文類型加繁體中文主旨;不再允許中文類型(新增、修正……),並附遷移對照表(XSPEC-475) |
|
|
820
951
|
| 1.3.0 | 2026-03-16 | 新增自訂參考 Footer 慣例(Refs: PREFIX-ID) |
|
|
821
952
|
| 1.2.3 | 2025-12-24 | 新增相關標準區段 |
|
|
822
953
|
| 1.2.2 | 2025-12-16 | 新增語言選擇指南,含決策矩陣和快速選擇提示 |
|