universal-dev-standards 6.14.0-beta.1 → 6.14.0-beta.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +13 -3
- package/bin/uds.js +75 -3
- package/bundled/ai/options/code-review/pr-review.ai.yaml +20 -1
- package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
- package/bundled/ai/standards/ai-response-navigation.ai.yaml +43 -3
- package/bundled/ai/standards/checkin-standards.ai.yaml +25 -6
- package/bundled/ai/standards/code-review.ai.yaml +15 -2
- package/bundled/ai/standards/commit-message.ai.yaml +18 -4
- package/bundled/ai/standards/developer-memory.ai.yaml +12 -2
- package/bundled/ai/standards/full-coverage-testing.ai.yaml +86 -7
- package/bundled/ai/standards/open-work-tracking.ai.yaml +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 +10 -0
- package/src/commands/simulate.js +20 -8
- package/src/commands/skills.js +59 -33
- package/src/commands/spec-split.js +30 -17
- package/src/commands/spec.js +55 -21
- package/src/commands/uninstall.js +146 -32
- package/src/commands/update.js +471 -93
- package/src/core/install-records.js +192 -0
- package/src/core/manifest.js +12 -10
- package/src/core/marketplace-sentinel.js +5 -0
- package/src/core/open-work-config.js +122 -0
- package/src/core/project-config.js +92 -38
- package/src/flows/init-flow.js +10 -0
- package/src/hitl/manager.js +4 -2
- package/src/i18n/messages.js +413 -78
- package/src/installers/hooks-installer.js +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
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
source: ../../../core/refactoring-standards.md
|
|
3
3
|
source_version: 2.2.0
|
|
4
4
|
translation_version: 2.2.0
|
|
5
|
-
last_synced: 2026-
|
|
5
|
+
last_synced: 2026-10-11
|
|
6
|
+
source_hash: e293ee5788ca
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
@@ -12,99 +13,202 @@ status: current
|
|
|
12
13
|
|
|
13
14
|
**版本**: 2.2.0
|
|
14
15
|
**最後更新**: 2026-07-01
|
|
15
|
-
**適用性**:
|
|
16
|
-
**範圍**:
|
|
16
|
+
**適用性**: 所有進行程式碼改善工作的軟體專案
|
|
17
|
+
**範圍**: 部分通用 (Partial)
|
|
18
|
+
**業界標準**: ISO/IEC 25010 可維護性
|
|
19
|
+
|
|
20
|
+
> **詳細模式與教學請參閱 [重構指南](guides/refactoring-guide.md)**
|
|
17
21
|
|
|
18
22
|
---
|
|
19
23
|
|
|
20
24
|
## 目的
|
|
21
25
|
|
|
22
|
-
|
|
26
|
+
本標準定義完整的程式碼重構指引,涵蓋從日常 TDD 重構循環到大規模遺留系統現代化的各種情境。
|
|
23
27
|
|
|
24
28
|
---
|
|
25
29
|
|
|
26
|
-
##
|
|
30
|
+
## 重構 vs. 重寫決策矩陣
|
|
27
31
|
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
+
| 因素 | 傾向重構 | 傾向重寫 |
|
|
33
|
+
|------|----------|----------|
|
|
34
|
+
| **程式碼庫規模** | 大型、複雜 | 小型、獨立 |
|
|
35
|
+
| **測試覆蓋率** | 良好(>60%) | 不足或沒有 |
|
|
36
|
+
| **業務連續性** | 關鍵 | 可容忍停機 |
|
|
37
|
+
| **團隊知識** | 團隊了解程式碼 | 缺乏組織知識 |
|
|
38
|
+
| **核心架構** | 健全,只是雜亂 | 根本性缺陷 |
|
|
39
|
+
| **時間壓力** | 期限緊迫 | 時程彈性 |
|
|
40
|
+
| **風險容忍度** | 低 | 較高 |
|
|
32
41
|
|
|
33
42
|
---
|
|
34
43
|
|
|
35
|
-
## 何時重構
|
|
44
|
+
## 何時重構
|
|
36
45
|
|
|
37
|
-
|
|
|
38
|
-
|
|
39
|
-
|
|
|
40
|
-
|
|
|
41
|
-
|
|
|
42
|
-
|
|
|
46
|
+
| 情境 | 建議策略 |
|
|
47
|
+
|------|----------|
|
|
48
|
+
| 功能開發受雜亂程式碼阻礙 | 準備性重構(Preparatory Refactoring) |
|
|
49
|
+
| 修 bug 時順手碰到程式碼 | 童子軍法則(Boy Scout Rule) |
|
|
50
|
+
| 以 TDD 撰寫新程式碼 | 紅-綠-重構(Red-Green-Refactor) |
|
|
51
|
+
| 替換整個遺留系統 | 絞殺者模式(Strangler Fig Pattern) |
|
|
52
|
+
| 需要與遺留系統整合但不被污染 | 防腐層(Anti-Corruption Layer) |
|
|
53
|
+
| 不使用 feature branch 重構共用程式碼 | 抽象分支(Branch by Abstraction) |
|
|
54
|
+
| 變更廣泛使用的介面 | 平行變更(Parallel Change,Expand-Migrate-Contract) |
|
|
55
|
+
| 處理沒有測試的遺留程式碼 | **先寫**特徵測試(Characterization Tests) |
|
|
43
56
|
|
|
44
57
|
---
|
|
45
58
|
|
|
46
|
-
##
|
|
59
|
+
## 策略摘要
|
|
47
60
|
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
-
|
|
53
|
-
|
|
61
|
+
| 策略 | 規模 | 風險 | 時程 | 主要使用情境 |
|
|
62
|
+
|------|------|------|------|--------------|
|
|
63
|
+
| **準備性重構** | 小 | 低 | 數小時 | 功能開發前降低阻力 |
|
|
64
|
+
| **童子軍法則** | 極小 | 低 | 數分鐘 | 持續償還技術債 |
|
|
65
|
+
| **紅-綠-重構** | 小 | 低 | 5-15 分鐘 | TDD 開發循環 |
|
|
66
|
+
| **絞殺者模式** | 大 | 中 | 數月 | 系統替換 |
|
|
67
|
+
| **防腐層** | 中 | 低 | 數週 | 新舊系統共存 |
|
|
68
|
+
| **抽象分支** | 大 | 中 | 數週 | 在主幹上進行長期重構 |
|
|
69
|
+
| **平行變更** | 中 | 低 | 數天至數週 | 介面/schema 遷移 |
|
|
70
|
+
| **特徵測試** | — | — | — | **所有遺留程式碼重構的先決條件** |
|
|
54
71
|
|
|
55
72
|
---
|
|
56
73
|
|
|
57
|
-
##
|
|
74
|
+
## 安全重構工作流程
|
|
75
|
+
|
|
76
|
+
### 重構前
|
|
77
|
+
|
|
78
|
+
- [ ] 定義成功標準(可量測)
|
|
79
|
+
- [ ] 確保足夠的測試覆蓋率(建議 >80%)
|
|
80
|
+
- [ ] 提交或暫存目前的工作(乾淨的工作目錄)
|
|
81
|
+
- [ ] 建立 feature 分支(或在主幹上搭配功能開關)
|
|
82
|
+
- [ ] 與團隊溝通以避免衝突
|
|
83
|
+
|
|
84
|
+
### 重構中
|
|
58
85
|
|
|
59
|
-
|
|
86
|
+
- [ ] 一次只做**一個**小變更
|
|
87
|
+
- [ ] **每次**變更後都執行測試
|
|
88
|
+
- [ ] 測試失敗時**立即**還原
|
|
89
|
+
- [ ] 頻繁提交(每次測試通過都是一個存檔點)
|
|
90
|
+
- [ ] 重構時絕不新增功能
|
|
60
91
|
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
92
|
+
### 重構後
|
|
93
|
+
|
|
94
|
+
- [ ] 所有測試通過(與重構前相同)
|
|
95
|
+
- [ ] 程式碼有可量測的改善(複雜度、重複度等)
|
|
96
|
+
- [ ] 必要時更新文件
|
|
97
|
+
- [ ] 完成團隊審查
|
|
98
|
+
- [ ] 沒有新增任何功能
|
|
64
99
|
|
|
65
100
|
---
|
|
66
101
|
|
|
67
|
-
##
|
|
102
|
+
## 程式碼品質指標
|
|
103
|
+
|
|
104
|
+
### 目標指標
|
|
105
|
+
|
|
106
|
+
| 指標 | 目標 | 工具 |
|
|
107
|
+
|------|------|------|
|
|
108
|
+
| **循環複雜度(Cyclomatic Complexity)** | 每個函式 < 10 | 靜態分析 |
|
|
109
|
+
| **認知複雜度(Cognitive Complexity)** | 越低越好 | SonarQube |
|
|
110
|
+
| **程式碼重複(文字)** | < 3% | 靜態分析 |
|
|
111
|
+
| **語意重複** | 0 個未受管理的 domain fact | Golden / architecture test(見下文) |
|
|
112
|
+
| **測試覆蓋率** | ≥ 80% | 覆蓋率工具 |
|
|
68
113
|
|
|
69
|
-
|
|
114
|
+
> **文字重複 vs. 語意重複**:`程式碼重複` 指標只能偵測*文字*重複(幾乎相同的 token 序列),無法偵測*語意*重複——同一個 domain fact 在多處被重新實作,或 derived aggregate 被持久化卻沒有與來源的強制綁定。並非逐位元組相同的 copy(改寫過的邏輯、一處正確另一處錯誤的公式)會通過靜態分析,卻仍持續各自漂移。語意重複必須由 golden test 與 architecture test 治理(見[語意重複與 Copy-Drift](#語意重複與-copy-drift)),而非上述靜態分析門檻。
|
|
115
|
+
|
|
116
|
+
### ISO/IEC 25010 可維護性目標
|
|
117
|
+
|
|
118
|
+
| 子特性 | 指標 | 目標 |
|
|
119
|
+
|--------|------|------|
|
|
120
|
+
| **模組化(Modularity)** | 耦合度、檔案大小 | 減少相依 |
|
|
121
|
+
| **可重用性(Reusability)** | 程式碼重複 | 提取方法、DRY |
|
|
122
|
+
| **可分析性(Analysability)** | 循環複雜度 | 簡化邏輯 |
|
|
123
|
+
| **可修改性(Modifiability)** | 內聚度、測試覆蓋率 | 單一職責 |
|
|
124
|
+
| **可測試性(Testability)** | 分支覆蓋率 | 依賴注入 |
|
|
125
|
+
|
|
126
|
+
---
|
|
127
|
+
|
|
128
|
+
## 語意重複與 Copy-Drift
|
|
129
|
+
|
|
130
|
+
文字重複指標能抓到複製貼上,卻漏掉更危險的情況:**同一個 domain fact 在多處被實作**。當這些實作不是逐位元組相同時——改寫過的分類邏輯、一個 call site 正確而另一個有細微錯誤的公式、與其彙總的 rows 分開儲存的 total——它們會通過靜態分析,然後**各自獨立地漂移**,產生看似無關、實則同源的 bug。
|
|
70
131
|
|
|
71
132
|
### 反模式:Copy-Drift
|
|
72
133
|
|
|
73
134
|
Copy-Drift 發生於下列任一情況:
|
|
74
135
|
|
|
75
136
|
- 單一 domain fact(分類、規則、計算)被**在多個 call site 重複實作**,而非由單一共用單元計算;或
|
|
76
|
-
- **derived value 被持久化**(stored aggregate、counter
|
|
137
|
+
- **derived value 被持久化**(stored aggregate、counter 或 denormalized 欄位)**卻沒有與來源的強制關係**,使每條 write path 都能各自更新它。
|
|
77
138
|
|
|
78
|
-
因為這些 copy
|
|
139
|
+
因為這些 copy 並非逐字相同,文字重複工具什麼都不會回報。漂移會在稍後以不一致的形式浮現:list view 與 detail view 對不上、stored counter 因某條更新路徑的 decrement 分支被註解掉而重複計數、或同一條公式在不同模組給出不同答案。
|
|
79
140
|
|
|
80
141
|
### 模式:Single Source of Truth / Derive-Don't-Duplicate
|
|
81
142
|
|
|
82
|
-
- **每個 fact 只有一個單元**:把每個 domain fact 抽成**唯一**的 classifier / calculator / resolver;所有 call site
|
|
83
|
-
-
|
|
84
|
-
- **若 aggregate
|
|
85
|
-
- **用測試鎖定**:用 **golden test** 鎖定 single source of truth
|
|
143
|
+
- **每個 fact 只有一個單元**:把每個 domain fact 抽成**唯一**的 classifier / calculator / resolver;所有 call site 都呼叫它——不重新實作、不改寫。
|
|
144
|
+
- **Derive,不要 store**:優先在讀取時計算,而非持久化第二份 copy;永遠被 derive 的值不會漂移。
|
|
145
|
+
- **若 aggregate 一定要儲存**,把它當成其 detail rows 的 **projection**,並在**單一 choke point**(例如 `SaveChanges` interceptor,或單一共用 `recompute()` 函式)重算,讓**每一條** write path(含 async job 與 failure write-back)都經過同一個重算而保持一致。**絕不**讓個別 path 對 stored aggregate 套用 incremental `col = col + delta` 調整;incremental 調整正是 decrement/rollback 分支被略過、counter 發生漂移的原因。
|
|
146
|
+
- **用測試鎖定**:用 **golden test** 鎖定 single source of truth,並加上 **architecture test**——若規則在別處被重新定義就 fail,讓未來的 copy 在 CI 被擋下,而非在 production 才被發現。
|
|
86
147
|
|
|
87
148
|
### 遷移推論——Intentional-Divergence Registry(刻意偏離登記)
|
|
88
149
|
|
|
89
|
-
當新系統**刻意**偏離 legacy
|
|
150
|
+
當新系統**刻意**偏離 legacy 行為時,必須記錄下來——否則日後某次「修正」會靜默地把它回退。port 過程中常見的情況:legacy *函式*回傳 X,但下游的 legacy *pipeline* 把它調和成 Y;port 把這個調和折進單一單元,讓函式直接回傳 Y。
|
|
90
151
|
|
|
91
|
-
- 把每個刻意偏離登記在 **intentional-divergence registry**(legacy
|
|
92
|
-
- 用 **golden test**
|
|
93
|
-
- 把 registry
|
|
152
|
+
- 把每個刻意偏離登記在 **intentional-divergence registry**(legacy 行為、新行為、理由、所屬 fact)。
|
|
153
|
+
- 用 **golden test** 鎖定新行為,讓未來「修正」回 legacy 時 build 會失敗。
|
|
154
|
+
- 把 registry 餵給任何對 legacy 的 **differential test**,使該偏離被視為*預期*,而非被標記為 regression。
|
|
94
155
|
|
|
95
156
|
### 給採用者的註記
|
|
96
157
|
|
|
97
|
-
- per-function 的 legacy-vs-new diffing
|
|
98
|
-
-
|
|
158
|
+
- per-function 的 legacy-vs-new diffing 產出的是**候選,而非裁決**。每個候選都必須對照**整條** legacy pipeline(而不只是那一個函式)裁決後,才能稱為 bug——legacy pipeline 可能已在下游調和了表面上的差異。
|
|
159
|
+
- 以 **programmatic / token-based** 方式(而非手抄)抽取 legacy 函式本體,避免在調查抄寫錯誤時又重新引入抄寫錯誤。
|
|
160
|
+
|
|
161
|
+
---
|
|
162
|
+
|
|
163
|
+
## PR 大小指引
|
|
164
|
+
|
|
165
|
+
| 大小 | 變更行數 | 審查時間 | 建議 |
|
|
166
|
+
|------|----------|----------|------|
|
|
167
|
+
| 小 | < 200 | < 30 分鐘 | ✅ 理想 |
|
|
168
|
+
| 中 | 200-500 | < 1 小時 | ⚠️ 可接受 |
|
|
169
|
+
| 大 | > 500 | — | ❌ **應拆分** |
|
|
170
|
+
|
|
171
|
+
**原則**:多個小 PR > 一個大 PR
|
|
172
|
+
|
|
173
|
+
---
|
|
174
|
+
|
|
175
|
+
## 技術債優先順序
|
|
176
|
+
|
|
177
|
+
| 優先級 | 判斷標準 | 行動 |
|
|
178
|
+
|--------|----------|------|
|
|
179
|
+
| **高** | 阻礙開發、頻繁造成 bug | 立即處理 |
|
|
180
|
+
| **中** | 拖慢開發、增加複雜度 | 規劃至下個 sprint |
|
|
181
|
+
| **低** | 輕微困擾、影響範圍有限 | 伺機處理 |
|
|
182
|
+
|
|
183
|
+
---
|
|
184
|
+
|
|
185
|
+
## 資料庫重構安全
|
|
186
|
+
|
|
187
|
+
### 遷移前檢查清單
|
|
188
|
+
|
|
189
|
+
- [ ] 已完成完整備份
|
|
190
|
+
- [ ] 遷移腳本已在 staging 測試
|
|
191
|
+
- [ ] 已準備回滾腳本
|
|
192
|
+
- [ ] 已估算遷移時間
|
|
193
|
+
- [ ] 已公告維護時段
|
|
194
|
+
|
|
195
|
+
### 遷移後檢查清單
|
|
196
|
+
|
|
197
|
+
- [ ] 資料一致性驗證
|
|
198
|
+
- [ ] 應用程式功能驗證
|
|
199
|
+
- [ ] 效能基準比較
|
|
200
|
+
- [ ] 備份保留至回滾期結束
|
|
99
201
|
|
|
100
202
|
---
|
|
101
203
|
|
|
102
204
|
## 相關標準
|
|
103
205
|
|
|
104
|
-
- [
|
|
105
|
-
- [測試標準](testing-standards.md) - golden test 與 architecture test 鎖定 single source of truth
|
|
206
|
+
- [測試驅動開發](test-driven-development.md) - 包含重構階段的 TDD 循環
|
|
207
|
+
- [測試標準](testing-standards.md) - 以 golden test 與 architecture test 鎖定 single source of truth
|
|
106
208
|
- [測試治理](test-governance.md) - 在 CI 治理語意重複與 intentional-divergence 檢查
|
|
107
|
-
- [程式碼審查清單](code-review-checklist.md)
|
|
209
|
+
- [程式碼審查清單](code-review-checklist.md) - 重構 PR 審查指引
|
|
210
|
+
- [Commit Message 指南](commit-message-guide.md) - `refactor` 提交類型
|
|
211
|
+
- [程式碼簽入標準](checkin-standards.md) - 提交前要求
|
|
108
212
|
|
|
109
213
|
---
|
|
110
214
|
|
|
@@ -112,9 +216,10 @@ Copy-Drift 發生於下列任一情況:
|
|
|
112
216
|
|
|
113
217
|
| 版本 | 日期 | 變更 |
|
|
114
218
|
|------|------|------|
|
|
115
|
-
| 2.2.0 | 2026-07-01 | 新增「語意重複與 Copy-Drift」(issue #142):Copy-Drift 反模式、Single Source of Truth / Derive-Don't-Duplicate 模式、Intentional-Divergence Registry
|
|
116
|
-
| 2.
|
|
117
|
-
|
|
|
219
|
+
| 2.2.0 | 2026-07-01 | 新增「語意重複與 Copy-Drift」(issue #142):Copy-Drift 反模式、Single Source of Truth / Derive-Don't-Duplicate 模式、Intentional-Divergence Registry 遷移推論;將重複指標拆分為文字重複與語意重複 |
|
|
220
|
+
| 2.1.0 | 2026-01-29 | 重構:拆分為規則 + 指南,詳細模式移至指南 |
|
|
221
|
+
| 2.0.0 | 2026-01-21 | 重大重組:新增戰術性策略、防腐層 |
|
|
222
|
+
| 1.0.0 | 2026-01-12 | 初始重構標準定義 |
|
|
118
223
|
|
|
119
224
|
---
|
|
120
225
|
|
|
@@ -1,17 +1,18 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../core/requirement-engineering.md
|
|
3
|
-
source_version: 1.
|
|
4
|
-
translation_version: 1.
|
|
5
|
-
last_synced: 2026-
|
|
6
|
-
|
|
3
|
+
source_version: 1.1.0
|
|
4
|
+
translation_version: 1.1.0
|
|
5
|
+
last_synced: 2026-10-11
|
|
6
|
+
source_hash: e8d346f82f79
|
|
7
|
+
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
9
10
|
# 需求工程標準
|
|
10
11
|
|
|
11
12
|
> **語言**: [English](../../../core/requirement-engineering.md) | 繁體中文
|
|
12
13
|
|
|
13
|
-
**版本**: 1.
|
|
14
|
-
**最後更新**: 2026-
|
|
14
|
+
**版本**: 1.1.0
|
|
15
|
+
**最後更新**: 2026-07-10
|
|
15
16
|
**適用性**: 所有軟體專案
|
|
16
17
|
**範圍**: 通用 (Universal)
|
|
17
18
|
**業界標準**: IEEE 830-1998、IEEE 29148-2018、SWEBOK v4.0
|
|
@@ -23,7 +24,7 @@ status: stale
|
|
|
23
24
|
|
|
24
25
|
需求工程是在整個開發生命週期中系統性地引出、分析、規格化和驗證軟體需求的過程。它提供撰寫、管理和驗證需求的理論基礎,基於業界標準包括 IEEE 830-1998、IEEE 29148-2018、SWEBOK v4.0 和 ISO/IEC 25010。
|
|
25
26
|
|
|
26
|
-
此過程涵蓋功能需求(系統應做什麼)、非功能需求(效能、安全、可用性等品質屬性)和約束條件。使用者故事(Agile 格式)搭配驗收條件(Given-When-Then)作為主要規格格式,透過 INVEST
|
|
27
|
+
此過程涵蓋功能需求(系統應做什麼)、非功能需求(效能、安全、可用性等品質屬性)和約束條件。使用者故事(Agile 格式)搭配驗收條件(Given-When-Then)作為主要規格格式,透過 INVEST 準則(Independent 獨立、Negotiable 可協商、Valuable 有價值、Estimable 可估算、Small 小型、Testable 可測試)驗證。
|
|
27
28
|
|
|
28
29
|
---
|
|
29
30
|
|
|
@@ -41,36 +42,6 @@ status: stale
|
|
|
41
42
|
| **品質模型** | ISO/IEC 25010(8 個特徵) |
|
|
42
43
|
| **標準** | IEEE 830、IEEE 29148、SWEBOK v4.0 |
|
|
43
44
|
|
|
44
|
-
## 使用者故事格式
|
|
45
|
-
|
|
46
|
-
```
|
|
47
|
-
作為 [角色]
|
|
48
|
-
我希望 [功能]
|
|
49
|
-
以便 [商業價值]
|
|
50
|
-
```
|
|
51
|
-
|
|
52
|
-
### INVEST 準則
|
|
53
|
-
|
|
54
|
-
| 準則 | 說明 |
|
|
55
|
-
|------|------|
|
|
56
|
-
| **I**ndependent | 獨立 — 故事之間盡量獨立 |
|
|
57
|
-
| **N**egotiable | 可協商 — 細節可以討論調整 |
|
|
58
|
-
| **V**aluable | 有價值 — 對使用者或業務有價值 |
|
|
59
|
-
| **E**stimable | 可估算 — 可以估算工作量 |
|
|
60
|
-
| **S**mall | 小型 — 可在一個迭代內完成 |
|
|
61
|
-
| **T**estable | 可測試 — 可以撰寫驗收條件 |
|
|
62
|
-
|
|
63
|
-
## 需求優先級
|
|
64
|
-
|
|
65
|
-
### MoSCoW 方法
|
|
66
|
-
|
|
67
|
-
| 分類 | 說明 |
|
|
68
|
-
|------|------|
|
|
69
|
-
| **Must have** | 必要 — 沒有就無法發布 |
|
|
70
|
-
| **Should have** | 應有 — 重要但可以延後 |
|
|
71
|
-
| **Could have** | 可有 — 增值但非必要 |
|
|
72
|
-
| **Won't have** | 不做 — 此版本明確排除 |
|
|
73
|
-
|
|
74
45
|
## 相關標準
|
|
75
46
|
|
|
76
47
|
- [規格驅動開發](spec-driven-development.md)
|
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
source: ../../../core/retrospective-standards.md
|
|
3
3
|
source_version: 1.1.0
|
|
4
4
|
translation_version: 1.1.0
|
|
5
|
-
last_synced: 2026-
|
|
5
|
+
last_synced: 2026-10-11
|
|
6
|
+
source_hash: c2c2bb863693
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
@@ -10,11 +11,12 @@ status: current
|
|
|
10
11
|
|
|
11
12
|
> **語言**: [English](../../../core/retrospective-standards.md) | 繁體中文
|
|
12
13
|
|
|
13
|
-
**版本**: 1.
|
|
14
|
-
**最後更新**: 2026-
|
|
14
|
+
**版本**: 1.1.0
|
|
15
|
+
**最後更新**: 2026-08-24
|
|
15
16
|
**適用範圍**: 所有實踐迭代開發的軟體團隊
|
|
16
17
|
**範疇**: universal
|
|
17
18
|
**產業標準**: Scrum Guide(Sprint 回顧)、CMMI Level 3、ISO/IEC 12207 §6.3.6
|
|
19
|
+
**參考資料**: [Scrum Guide](https://scrumguides.org/)、[Fun Retrospectives](https://www.funretrospectives.com/)
|
|
18
20
|
|
|
19
21
|
---
|
|
20
22
|
|
|
@@ -31,6 +33,15 @@ status: current
|
|
|
31
33
|
| **Sprint** | 每個迭代結束 | 30-60 分鐘 | 團隊流程、協作、工具 |
|
|
32
34
|
| **Release** | 每次發布後 | 60-90 分鐘 | 交付品質、循環指標、跨團隊協調 |
|
|
33
35
|
|
|
36
|
+
### 與事後檢討(Post-Mortem)的區別
|
|
37
|
+
|
|
38
|
+
| 面向 | 回顧 | 事後檢討(事故) |
|
|
39
|
+
|------|------|------------------|
|
|
40
|
+
| **觸發** | 計畫性(迭代/發布結束時) | 反應性(事故發生後) |
|
|
41
|
+
| **基調** | 以改善為焦點 | 以根因為焦點 |
|
|
42
|
+
| **範圍** | 整個流程 | 特定事故 |
|
|
43
|
+
| **頻率** | 定期(每 1-4 週) | 視需要 |
|
|
44
|
+
|
|
34
45
|
---
|
|
35
46
|
|
|
36
47
|
## 回顧工作流程
|
|
@@ -40,12 +51,57 @@ PREPARE ──► GATHER ──► ANALYZE ──► DECIDE ──► TRACK
|
|
|
40
51
|
準備資料 蒐集意見 分析歸納 決定行動 追蹤落實
|
|
41
52
|
```
|
|
42
53
|
|
|
54
|
+
### 階段 1:PREPARE(準備)
|
|
55
|
+
|
|
56
|
+
在會議前蒐集資料,讓討論以事實為基礎。
|
|
57
|
+
|
|
58
|
+
| 資料來源 | 要蒐集什麼 |
|
|
59
|
+
|----------|------------|
|
|
60
|
+
| Git log | Commit、已合併的 PR、分支 |
|
|
61
|
+
| Issue 追蹤系統 | 完成的故事、發現的 Bug |
|
|
62
|
+
| CI/CD | 建置成功率、部署頻率 |
|
|
63
|
+
| 指標 | Velocity、循環時間、測試覆蓋率 |
|
|
64
|
+
|
|
65
|
+
### 階段 2:GATHER(蒐集)
|
|
66
|
+
|
|
67
|
+
使用結構化技法蒐集團隊觀點(見下文)。
|
|
68
|
+
|
|
69
|
+
**基本規則:**
|
|
70
|
+
- 聚焦於流程,而非人
|
|
71
|
+
- 不指責——找出系統性原因
|
|
72
|
+
- 每個人都參與
|
|
73
|
+
- 每個段落都要控時
|
|
74
|
+
|
|
75
|
+
### 階段 3:ANALYZE(分析)
|
|
76
|
+
|
|
77
|
+
將相似項目分組,並找出跨主題的模式。
|
|
78
|
+
|
|
79
|
+
### 階段 4:DECIDE(決定)
|
|
80
|
+
|
|
81
|
+
選出前 1-3 項要聚焦的改善。每一項都成為一個行動項目。
|
|
82
|
+
|
|
83
|
+
**行動項目格式:**
|
|
84
|
+
|
|
85
|
+
| 欄位 | 說明 |
|
|
86
|
+
|------|------|
|
|
87
|
+
| **Action** | 具體、可執行的描述 |
|
|
88
|
+
| **Owner** | 單一負責人 |
|
|
89
|
+
| **Due Date** | 目標完成日期 |
|
|
90
|
+
| **Status** | Open → In Progress → Done |
|
|
91
|
+
| **Metric** | 如何衡量成功(選填) |
|
|
92
|
+
|
|
93
|
+
### 階段 5:TRACK(追蹤)
|
|
94
|
+
|
|
95
|
+
在下一次回顧開始時檢視先前的行動項目。
|
|
96
|
+
|
|
43
97
|
---
|
|
44
98
|
|
|
45
99
|
## 引導技法
|
|
46
100
|
|
|
47
101
|
### Start-Stop-Continue(預設)
|
|
48
102
|
|
|
103
|
+
最簡單也最常見的技法。適合快速回顧。
|
|
104
|
+
|
|
49
105
|
| 類別 | 問題 |
|
|
50
106
|
|------|------|
|
|
51
107
|
| **開始做** | 我們應該開始做什麼? |
|
|
@@ -54,6 +110,8 @@ PREPARE ──► GATHER ──► ANALYZE ──► DECIDE ──► TRACK
|
|
|
54
110
|
|
|
55
111
|
### Starfish
|
|
56
112
|
|
|
113
|
+
比 Start-Stop-Continue 更細緻。適合較深入的分析。
|
|
114
|
+
|
|
57
115
|
| 類別 | 問題 |
|
|
58
116
|
|------|------|
|
|
59
117
|
| **更多** | 什麼應該做更多? |
|
|
@@ -64,6 +122,8 @@ PREPARE ──► GATHER ──► ANALYZE ──► DECIDE ──► TRACK
|
|
|
64
122
|
|
|
65
123
|
### 4Ls
|
|
66
124
|
|
|
125
|
+
聚焦於情緒與學習。適合團隊建立。
|
|
126
|
+
|
|
67
127
|
| 類別 | 問題 |
|
|
68
128
|
|------|------|
|
|
69
129
|
| **喜歡** | 你享受什麼? |
|
|
@@ -73,12 +133,70 @@ PREPARE ──► GATHER ──► ANALYZE ──► DECIDE ──► TRACK
|
|
|
73
133
|
|
|
74
134
|
### 帆船法
|
|
75
135
|
|
|
136
|
+
視覺化隱喻。適合富創意的團隊。
|
|
137
|
+
|
|
76
138
|
| 元素 | 意義 |
|
|
77
139
|
|------|------|
|
|
78
140
|
| **風** | 推動我們前進的力量(優勢) |
|
|
79
141
|
| **錨** | 拖住我們的力量(阻礙) |
|
|
80
142
|
| **礁石** | 前方的風險 |
|
|
81
|
-
| **島嶼** |
|
|
143
|
+
| **島嶼** | 我們的目標/目的地 |
|
|
144
|
+
|
|
145
|
+
---
|
|
146
|
+
|
|
147
|
+
## 回顧報告範本
|
|
148
|
+
|
|
149
|
+
```markdown
|
|
150
|
+
# Retrospective: [Sprint N / Release vX.Y.Z]
|
|
151
|
+
|
|
152
|
+
- **Type**: [Sprint | Release]
|
|
153
|
+
- **Date**: YYYY-MM-DD
|
|
154
|
+
- **Participants**: [names]
|
|
155
|
+
- **Facilitator**: [name]
|
|
156
|
+
- **Technique**: [Start-Stop-Continue | Starfish | 4Ls | Sailboat]
|
|
157
|
+
|
|
158
|
+
## Previous Action Items Review
|
|
159
|
+
| # | Action | Owner | Status | Notes |
|
|
160
|
+
|---|--------|-------|--------|-------|
|
|
161
|
+
| 1 | [from last retro] | [person] | Done/Open | [update] |
|
|
162
|
+
|
|
163
|
+
## [Technique-specific sections]
|
|
164
|
+
(e.g., Start / Stop / Continue for SSC technique)
|
|
165
|
+
|
|
166
|
+
## Action Items
|
|
167
|
+
| # | Action | Owner | Due Date | Status |
|
|
168
|
+
|---|--------|-------|----------|--------|
|
|
169
|
+
| 1 | [description] | [person] | YYYY-MM-DD | Open |
|
|
170
|
+
|
|
171
|
+
## Key Learnings
|
|
172
|
+
- [learning 1]
|
|
173
|
+
- [learning 2]
|
|
174
|
+
|
|
175
|
+
## Metrics Summary (Release retrospective only)
|
|
176
|
+
| Metric | This Release | Previous | Trend |
|
|
177
|
+
|--------|-------------|----------|-------|
|
|
178
|
+
| Velocity | [value] | [value] | ↑/↓/→ |
|
|
179
|
+
| Bug Rate | [value] | [value] | ↑/↓/→ |
|
|
180
|
+
| Test Coverage | [%] | [%] | ↑/↓/→ |
|
|
181
|
+
| Cycle Time | [days] | [days] | ↑/↓/→ |
|
|
182
|
+
```
|
|
183
|
+
|
|
184
|
+
---
|
|
185
|
+
|
|
186
|
+
## 存放慣例
|
|
187
|
+
|
|
188
|
+
```
|
|
189
|
+
docs/retrospectives/
|
|
190
|
+
├── RETRO-2026-03-15-sprint-12.md
|
|
191
|
+
├── RETRO-2026-03-26-release-v5.1.0.md
|
|
192
|
+
└── README.md # Index (optional)
|
|
193
|
+
```
|
|
194
|
+
|
|
195
|
+
### 檔案命名
|
|
196
|
+
|
|
197
|
+
- 格式:`RETRO-YYYY-MM-DD-[type]-[identifier].md`
|
|
198
|
+
- Sprint:`RETRO-2026-03-15-sprint-12.md`
|
|
199
|
+
- Release:`RETRO-2026-03-26-release-v5.1.0.md`
|
|
82
200
|
|
|
83
201
|
---
|
|
84
202
|
|
|
@@ -95,9 +213,9 @@ Open ──► In Progress ──► Done
|
|
|
95
213
|
### 追蹤規則
|
|
96
214
|
|
|
97
215
|
1. 在每次回顧的**開頭**檢視所有未完成的行動項目。
|
|
98
|
-
2. 超過 **2
|
|
216
|
+
2. 超過 **2 個回顧循環**仍未完成的項目應重新評估(升級處理、重新定義或取消)。
|
|
99
217
|
3. 每次回顧最多 **3 個行動項目**。專注勝過廣度。
|
|
100
|
-
4.
|
|
218
|
+
4. 每個行動項目必須有**單一負責人**(不能是「整個團隊」)。
|
|
101
219
|
|
|
102
220
|
---
|
|
103
221
|
|
|
@@ -109,7 +227,9 @@ Open ──► In Progress ──► Done
|
|
|
109
227
|
| 指責 | 人們不再參與 | 執行「討論流程不討論人」規則 |
|
|
110
228
|
| 沒有行動項目 | 回顧變成發洩 | 一定以 1-3 個具體行動結尾 |
|
|
111
229
|
| 太多行動項目 | 什麼都做不完 | 最多 3 項,無情地排優先 |
|
|
112
|
-
| 從不檢視過去的行動 | 行動被遺忘 |
|
|
230
|
+
| 從不檢視過去的行動 | 行動被遺忘 | 每次回顧必先檢視先前的行動 |
|
|
231
|
+
| 永遠同一位引導者 | 觀點偏誤 | 輪替引導者角色 |
|
|
232
|
+
| 只有大聲的人發言 | 遺漏其他觀點 | 討論前先進行靜默書寫 |
|
|
113
233
|
|
|
114
234
|
---
|
|
115
235
|
|