universal-dev-standards 6.13.1 → 6.14.0-beta.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +13 -3
- package/bin/uds.js +75 -3
- package/bundled/ai/options/code-review/pr-review.ai.yaml +20 -1
- package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
- package/bundled/ai/standards/ai-response-navigation.ai.yaml +43 -3
- package/bundled/ai/standards/checkin-standards.ai.yaml +25 -6
- package/bundled/ai/standards/code-review.ai.yaml +15 -2
- package/bundled/ai/standards/commit-message.ai.yaml +18 -4
- package/bundled/ai/standards/developer-memory.ai.yaml +12 -2
- package/bundled/ai/standards/full-coverage-testing.ai.yaml +86 -7
- package/bundled/ai/standards/open-work-tracking.ai.yaml +254 -4
- package/bundled/ai/standards/pipeline-security-gates.ai.yaml +53 -4
- package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
- package/bundled/ai/standards/turn-completion-integrity.ai.yaml +14 -7
- package/bundled/core/ai-response-navigation.md +128 -12
- package/bundled/core/code-review-checklist.md +20 -2
- package/bundled/core/commit-message-guide.md +22 -19
- package/bundled/core/developer-memory.md +12 -2
- package/bundled/core/full-coverage-testing.md +99 -5
- package/bundled/core/open-work-tracking.md +251 -8
- package/bundled/core/pipeline-security-gates.md +63 -0
- package/bundled/core/project-context-memory.md +10 -2
- package/bundled/core/turn-completion-integrity.md +58 -11
- package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
- package/bundled/extensions/languages/csharp-style.md +464 -0
- package/bundled/extensions/languages/php-style.md +700 -0
- package/bundled/extensions/locales/zh-cn.md +717 -0
- package/bundled/extensions/locales/zh-tw.md +717 -0
- package/bundled/hooks/check-turn-completion-agy.mjs +147 -0
- package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
- package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
- package/bundled/locales/COVERAGE.md +5 -4
- package/bundled/locales/zh-CN/CHANGELOG.md +211 -3
- package/bundled/locales/zh-CN/README.md +3 -3
- package/bundled/locales/zh-CN/SECURITY.md +3 -1
- package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
- package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
- package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
- package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
- package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
- package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
- package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
- package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
- package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
- package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
- package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
- package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
- package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
- package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
- package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
- package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
- package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
- package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
- package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
- package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
- package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
- package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
- package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
- package/bundled/locales/zh-CN/core/code-review-checklist.md +54 -23
- package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
- package/bundled/locales/zh-CN/core/database-standards.md +115 -114
- package/bundled/locales/zh-CN/core/developer-memory.md +159 -60
- package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
- package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
- package/bundled/locales/zh-CN/core/execution-history.md +2 -1
- package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
- package/bundled/locales/zh-CN/core/full-coverage-testing.md +103 -9
- package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
- package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
- package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
- package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
- package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
- package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
- package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
- package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
- package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
- package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
- package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
- package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
- package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
- package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
- package/bundled/locales/zh-CN/core/security-decision.md +45 -70
- package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
- package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
- package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
- package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
- package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
- package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
- package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
- package/bundled/locales/zh-CN/core/test-governance.md +94 -43
- package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
- package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
- package/bundled/locales/zh-CN/core/token-budget.md +44 -80
- package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
- package/bundled/locales/zh-CN/core/turn-completion-integrity.md +46 -13
- package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
- package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
- package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
- package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
- package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
- package/bundled/locales/zh-CN/docs/CHEATSHEET.md +11 -2
- package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +76 -40
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +32 -15
- package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
- package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
- package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
- package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
- package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
- package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +46 -0
- package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
- package/bundled/locales/zh-CN/docs/user/README.md +4 -2
- package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
- package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
- package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
- package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
- package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
- package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
- package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
- package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
- package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
- package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
- package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
- package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
- package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
- package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
- package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
- package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
- package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
- package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
- package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
- package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
- package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
- package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
- package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
- package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
- package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
- package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
- package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
- package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
- package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
- package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
- package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
- package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
- package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
- package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
- package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
- package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
- package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
- package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
- package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
- package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
- package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
- package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
- package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/skills/README.md +3 -1
- package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
- package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
- package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
- package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
- package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
- package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
- package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
- package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
- package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
- package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
- package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
- package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
- package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
- package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
- package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
- package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
- package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
- package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
- package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
- package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
- package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
- package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
- package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
- package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
- package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
- package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
- package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
- package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
- package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
- package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
- package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
- package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
- package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
- package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
- package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
- package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
- package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
- package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
- package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
- package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
- package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
- package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
- package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
- package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
- package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
- package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
- package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
- package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
- package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
- package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
- package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
- package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
- package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
- package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
- package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
- package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
- package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
- package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
- package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
- package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
- package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
- package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
- package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
- package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
- package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
- package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
- package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
- package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
- package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
- package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
- package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
- package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
- package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
- package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
- package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
- package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
- package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
- package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
- package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
- package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
- package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
- package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
- package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
- package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
- package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
- package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
- package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
- package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
- package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
- package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
- package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
- package/bundled/locales/zh-TW/CHANGELOG.md +211 -3
- package/bundled/locales/zh-TW/README.md +3 -3
- package/bundled/locales/zh-TW/SECURITY.md +3 -1
- package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
- package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
- package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
- package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
- package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
- package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
- package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
- package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
- package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
- package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
- package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
- package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
- package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
- package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
- package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
- package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
- package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
- package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
- package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
- package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
- package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
- package/bundled/locales/zh-TW/core/code-review-checklist.md +36 -7
- package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
- package/bundled/locales/zh-TW/core/database-standards.md +2 -1
- package/bundled/locales/zh-TW/core/developer-memory.md +111 -12
- package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
- package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
- package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
- package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
- package/bundled/locales/zh-TW/core/execution-history.md +2 -1
- package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
- package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
- package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
- package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
- package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
- package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
- package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
- package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
- package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
- package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
- package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
- package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
- package/bundled/locales/zh-TW/core/open-work-tracking.md +164 -9
- package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
- package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
- package/bundled/locales/zh-TW/core/project-context-memory.md +215 -31
- package/bundled/locales/zh-TW/core/project-structure.md +240 -19
- package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
- package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
- package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
- package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
- package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
- package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
- package/bundled/locales/zh-TW/core/security-decision.md +43 -84
- package/bundled/locales/zh-TW/core/security-standards.md +204 -25
- package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
- package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
- package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
- package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
- package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
- package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
- package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
- package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
- package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
- package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
- package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
- package/bundled/locales/zh-TW/core/test-governance.md +92 -32
- package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
- package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
- package/bundled/locales/zh-TW/core/token-budget.md +41 -112
- package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
- package/bundled/locales/zh-TW/core/turn-completion-integrity.md +46 -13
- package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
- package/bundled/locales/zh-TW/core/versioning.md +6 -2
- package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
- package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
- package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
- package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
- package/bundled/locales/zh-TW/docs/CHEATSHEET.md +11 -2
- package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +69 -33
- package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +32 -15
- package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
- package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
- package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
- package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
- package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
- package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +46 -0
- package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
- package/bundled/locales/zh-TW/docs/user/README.md +2 -0
- package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
- package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
- package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
- package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
- package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
- package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
- package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
- package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
- package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
- package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
- package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
- package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
- package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
- package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
- package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
- package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
- package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
- package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
- package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
- package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
- package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
- package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
- package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
- package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
- package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
- package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
- package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
- package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
- package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
- package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
- package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
- package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
- package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
- package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
- package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
- package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
- package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
- package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
- package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
- package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
- package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/skills/README.md +3 -1
- package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
- package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
- package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
- package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
- package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
- package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
- package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
- package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
- package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
- package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
- package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
- package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
- package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
- package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
- package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
- package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
- package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
- package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
- package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
- package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
- package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
- package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
- package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
- package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
- package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
- package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
- package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
- package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
- package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
- package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
- package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
- package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
- package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
- package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
- package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
- package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
- package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
- package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
- package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
- package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
- package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
- package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
- package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
- package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
- package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
- package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
- package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
- package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
- package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
- package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
- package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
- package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
- package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
- package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
- package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
- package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
- package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
- package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
- package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
- package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
- package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
- package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
- package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
- package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
- package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
- package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
- package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
- package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
- package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
- package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
- package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
- package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
- package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
- package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
- package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
- package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
- package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
- package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
- package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
- package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
- package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
- package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
- package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
- package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
- package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
- package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
- package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
- package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
- package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
- package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
- package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
- package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
- package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
- package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
- package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
- package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
- package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
- package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
- package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
- package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
- package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
- package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
- package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
- package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
- package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
- package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
- package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
- package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
- package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
- package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
- package/bundled/skills/README.md +1 -0
- package/bundled/skills/SKILL_NAMING.md +9 -0
- package/bundled/skills/commit-standards/SKILL.md +2 -2
- package/bundled/skills/commit-standards/guide.md +3 -2
- package/bundled/skills/commit-standards/language-options.md +19 -17
- package/bundled/skills/comprehension-ladder/SKILL.md +283 -0
- package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
- package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
- package/bundled/templates/gates/check-stubs.mjs +644 -0
- package/package.json +5 -3
- package/src/commands/audit.js +20 -2
- package/src/commands/check.js +155 -28
- package/src/commands/deps.js +31 -1
- package/src/commands/hitl.js +3 -0
- package/src/commands/init.js +173 -49
- package/src/commands/list.js +12 -3
- package/src/commands/mcp.js +2 -3
- package/src/commands/open-work.js +123 -0
- package/src/commands/quickstart.js +29 -13
- package/src/commands/release.js +102 -19
- package/src/commands/run-intent.js +10 -0
- package/src/commands/simulate.js +20 -8
- package/src/commands/skills.js +59 -33
- package/src/commands/spec-split.js +30 -17
- package/src/commands/spec.js +55 -21
- package/src/commands/uninstall.js +146 -32
- package/src/commands/update.js +471 -93
- package/src/core/install-records.js +192 -0
- package/src/core/manifest.js +12 -10
- package/src/core/marketplace-sentinel.js +5 -0
- package/src/core/open-work-config.js +122 -0
- package/src/core/project-config.js +92 -38
- package/src/flows/init-flow.js +10 -0
- package/src/hitl/manager.js +4 -2
- package/src/i18n/messages.js +413 -78
- package/src/installers/hooks-installer.js +320 -24
- package/src/installers/integration-installer.js +5 -1
- package/src/installers/skills-installer.js +3 -1
- package/src/installers/standards-installer.js +16 -23
- package/src/mcp/__tests__/server.test.js +0 -1
- package/src/mcp/server.js +16 -4
- package/src/prompts/init.js +148 -13
- package/src/reconciler/backup-locations.js +80 -0
- package/src/reconciler/backup-manager.js +451 -123
- package/src/reconciler/index.js +86 -10
- package/src/reconciler/install-roots.js +90 -0
- package/src/reconciler/plan-executor.js +37 -15
- package/src/uninstallers/hook-uninstaller.js +323 -33
- package/src/uninstallers/integration-uninstaller.js +35 -5
- package/src/uninstallers/skills-uninstaller.js +95 -16
- package/src/uninstallers/standards-uninstaller.js +56 -7
- package/src/utils/agents-installer.js +10 -17
- package/src/utils/available-standards-report.js +144 -0
- package/src/utils/available-standards.js +216 -0
- package/src/utils/command-hash-ownership.js +103 -0
- package/src/utils/commit-message-judge.js +155 -0
- package/src/utils/copier.js +80 -2
- package/src/utils/deps-applicability.js +25 -0
- package/src/utils/detector.js +46 -1
- package/src/utils/friction-detector.js +27 -0
- package/src/utils/gate-scripts.js +141 -0
- package/src/utils/git-hooks.js +139 -7
- package/src/utils/hasher.js +36 -0
- package/src/utils/health-scorer.js +10 -7
- package/src/utils/installed-names-ownership.js +114 -0
- package/src/utils/integration-generator.js +36 -24
- package/src/utils/legacy-hook-migration.js +112 -0
- package/src/utils/locale.js +19 -0
- package/src/utils/open-work-tracking.mjs +1754 -0
- package/src/utils/prompt-closed.js +18 -0
- package/src/utils/sdd-header.js +66 -0
- package/src/utils/skill-frontmatter.js +102 -0
- package/src/utils/skill-hash-ownership.js +64 -0
- package/src/utils/skill-name-collision.js +169 -0
- package/src/utils/skills-install-paths.js +114 -0
- package/src/utils/skills-installer.js +75 -106
- package/src/utils/standard-validator.js +98 -27
- package/src/utils/test-change-check.js +160 -0
- package/src/utils/test-policy.js +214 -0
- package/src/utils/transient-fs.js +113 -0
- package/src/utils/update-summary.js +29 -0
- package/src/vibe/micro-spec.js +15 -0
- package/standards-registry.json +48 -9
|
@@ -1,8 +1,9 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../core/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 | 新增語言選擇指南,含決策矩陣和快速選擇提示 |
|
|
@@ -1,19 +1,21 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../core/developer-memory.md
|
|
3
|
-
source_version: 1.
|
|
4
|
-
translation_version: 1.
|
|
5
|
-
last_synced: 2026-
|
|
6
|
-
|
|
3
|
+
source_version: 1.2.1
|
|
4
|
+
translation_version: 1.2.1
|
|
5
|
+
last_synced: 2026-10-11
|
|
6
|
+
source_hash: 4f480ae3038e
|
|
7
|
+
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
9
10
|
# 開發者持久記憶標準
|
|
10
11
|
|
|
11
12
|
> [English](../../../core/developer-memory.md) | **繁體中文**
|
|
12
13
|
|
|
13
|
-
**版本**: 1.
|
|
14
|
-
**最後更新**: 2026-
|
|
14
|
+
**版本**: 1.2.1
|
|
15
|
+
**最後更新**: 2026-10-07
|
|
15
16
|
**適用範圍**: 所有使用 AI 助手的軟體專案
|
|
16
17
|
**範圍**: 通用 (Universal)
|
|
18
|
+
**負責規格**: XSPEC-291(developer-memory 沒有專屬的功能 XSPEC;由 XSPEC-291 負責)
|
|
17
19
|
**產業標準**: 無 (UDS 原創)
|
|
18
20
|
|
|
19
21
|
---
|
|
@@ -241,11 +243,13 @@ AI 掃描記憶庫並產生審查報告,涵蓋:
|
|
|
241
243
|
|
|
242
244
|
#### 退役建議
|
|
243
245
|
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
|
247
|
-
|
|
248
|
-
|
|
|
246
|
+
以下閾值為 UDS 預設值(可依專案設定);每個值都記錄了理由,使其可供稽核而非任意設定。
|
|
247
|
+
|
|
248
|
+
| 觸發條件 | 動作 | 理由 |
|
|
249
|
+
|---------|------|------|
|
|
250
|
+
| `confidence < 0.2` | 建議退役 | 一再被判定無效的知識,雜訊多於訊號 |
|
|
251
|
+
| 超過 180 天未浮現且 `confidence < 0.5` | 建議退役 | 半年未被使用再加上低信心度,代表此記憶已與當前工作無關;180 天的時間窗與下方「過時偵測」的過時/衰減模型一致 |
|
|
252
|
+
| 5+ 筆 `invalid` 回饋 | 建議退役 | 持續的負面回饋表示此記憶有誤或已過時 |
|
|
249
253
|
|
|
250
254
|
#### 過時偵測
|
|
251
255
|
|
|
@@ -254,6 +258,26 @@ AI 掃描記憶庫並產生審查報告,涵蓋:
|
|
|
254
258
|
| `validity.type == "versioned"` 且版本已過時 | 標記為過時 |
|
|
255
259
|
| `validity.type == "temporal"` 且 `expires_at` 已過 | 標記為已過期 |
|
|
256
260
|
| `validity.type == "evergreen"` | 跳過版本檢查 |
|
|
261
|
+
| 被召回的記憶引用的檔案路徑或符號(函式/類別)已不存在於該位置,或已移動 | 標記為 `code-reference` 過時——見下方 |
|
|
262
|
+
|
|
263
|
+
#### 程式碼參照過時(`code-reference`)
|
|
264
|
+
|
|
265
|
+
程式碼會移動;針對舊位置記錄的記憶不會自行更新。此檢查用於捕捉以下情況:記憶的洞察仍然成立,但其引用(檔案路徑或函式/類別名稱)已不成立。
|
|
266
|
+
|
|
267
|
+
此檢查沿用 **[Knowledge Graph Memory](knowledge-graph-memory.md) §2 已定義的兩種運作模式**,而不另創第三種:
|
|
268
|
+
|
|
269
|
+
| 模式 | 時機 | 方式 |
|
|
270
|
+
|------|------|------|
|
|
271
|
+
| 降級模式(無圖引擎) | 任何工具皆可、無需額外設定——預設模式 | 使用記憶前,助手自行確認所引用的路徑/符號仍存在(`Glob`/`Grep`/`Read`)——與 §5 記憶驗證原則既有要求的機制相同 |
|
|
272
|
+
| 引擎模式(已建立圖引擎索引,例如 [EngramGraph](https://github.com/AsiaOstrich/EngramGraph) 的 `egr refs check`) | 可用時 | 引擎回報每個引用的狀態:`present`/`moved`(附新位置)/`missing`/`unresolvable` |
|
|
273
|
+
|
|
274
|
+
> 正確實作在兩種模式下產生相同形狀的答案(Knowledge Graph Memory §2.2)——引擎模式只是更快更完整,並非本質不同。
|
|
275
|
+
|
|
276
|
+
**`unresolvable` 不得(MUST NOT)被視為 `present` 或 `missing`。** 它表示檢查器無法對該引用得出答案(例如超出索引範圍的跨 repo 參照,見 Knowledge Graph Memory §2.2 的跨域注意事項)——這種不確定性必須以獨立狀態傳達給助手,而不是悄悄變成偽陽性(視為仍有效)或偽陰性(視為已消失)。
|
|
277
|
+
|
|
278
|
+
**時機**:此檢查作為 `proactive-surfacing`(§4.1)的一部分執行——在記憶顯示之前,而非之後。引用解析為 `missing` 的記憶,不會被當作沒有任何變化般悄悄浮現。
|
|
279
|
+
|
|
280
|
+
**範圍(第一批)**:僅限檔案路徑與符號名稱(函式/類別名稱)。`file:line` 參照明確**不在範圍內**——行號會隨該檔案任何無關的編輯而漂移,這與「此檔案/符號已不存在」屬於不同種類的過時(見 DEC-115 OQ-1;預定於 2027-01-31 前重新檢視)。
|
|
257
281
|
|
|
258
282
|
#### 修訂建議
|
|
259
283
|
|
|
@@ -284,6 +308,7 @@ AI 掃描記憶庫並產生審查報告,涵蓋:
|
|
|
284
308
|
| 冷卻期 | 每條目 7 天 | 防止重複建議 |
|
|
285
309
|
| 每次觸發上限 | 3–5 條 | 防止資訊過載 |
|
|
286
310
|
| 溢出處理 | AI 歸納為分組洞察 | 當 > 5 個匹配時 |
|
|
311
|
+
| 程式碼參照檢查 | 浮現前執行(§3.4 `code-reference` 過時檢查,降級或引擎模式) | 檔案/符號引用已無法解析的記憶,不得未加標記就浮現 |
|
|
287
312
|
|
|
288
313
|
#### 浮現格式
|
|
289
314
|
|
|
@@ -337,7 +362,35 @@ AI 應偵測這些開發者信號並建議記錄:
|
|
|
337
362
|
|
|
338
363
|
---
|
|
339
364
|
|
|
340
|
-
## 5.
|
|
365
|
+
## 5. Memory Verification Principle(記憶是線索,非結論)
|
|
366
|
+
|
|
367
|
+
> 借鑑 lintsinghua/claude-code-book 記憶驗證原則。
|
|
368
|
+
|
|
369
|
+
記憶提供方向,但**不能直接作為事實使用**。使用記憶前須獨立驗證:
|
|
370
|
+
|
|
371
|
+
| 記憶內容 | 驗證方法 | 衝突時處理 |
|
|
372
|
+
|---------|---------|-----------|
|
|
373
|
+
| 檔案路徑 | 確認檔案仍存在(Glob/Read) | 標記記憶為 `needs-revision` |
|
|
374
|
+
| 函式名稱/API flag | 確認仍存在(Grep/文件) | 標記記憶為 `needs-revision` |
|
|
375
|
+
| 架構快照/Repo 狀態 | 優先信任 `git log`/原始碼 | 更新記憶為當前狀態 |
|
|
376
|
+
| 套件版本/相依 | 確認 package.json/lockfile | 以實際版本為準 |
|
|
377
|
+
|
|
378
|
+
### 禁止行為
|
|
379
|
+
|
|
380
|
+
- 直接引用記憶中的具體 API/路徑/函式名稱推薦給使用者,未先驗證
|
|
381
|
+
- 宣稱「根據記憶,X 存在」而未執行獨立確認
|
|
382
|
+
- 因記憶內容與現況衝突時,選擇信任記憶而非當前觀察
|
|
383
|
+
|
|
384
|
+
### 記憶用途場景
|
|
385
|
+
|
|
386
|
+
記憶適合提供:
|
|
387
|
+
- **搜尋方向**:「這類問題上次在 X 模組找到答案」
|
|
388
|
+
- **模式線索**:「這個錯誤模式對應已知 pitfall MEM-2026-0042」
|
|
389
|
+
- **決策背景**:「此設計決策的歷史背景是...」
|
|
390
|
+
|
|
391
|
+
---
|
|
392
|
+
|
|
393
|
+
## 6. 雜訊控制
|
|
341
394
|
|
|
342
395
|
### 推送層級
|
|
343
396
|
|
|
@@ -517,6 +570,7 @@ by_category:
|
|
|
517
570
|
- [AI 指令標準](ai-instruction-standards.md) — Token 效率優化的記憶系統指令格式
|
|
518
571
|
- [AI 友善架構](ai-friendly-architecture.md) — 支援記憶整合的專案結構
|
|
519
572
|
- [文件撰寫標準](documentation-writing-standards.md) — 記憶條目的撰寫品質
|
|
573
|
+
- [知識圖記憶](knowledge-graph-memory.md) — `code-reference` 過時檢查(§3.4)所沿用的降級/引擎雙模式來源
|
|
520
574
|
|
|
521
575
|
---
|
|
522
576
|
|
|
@@ -563,10 +617,55 @@ AI 載入 developer-memory.ai.yaml
|
|
|
563
617
|
|
|
564
618
|
---
|
|
565
619
|
|
|
620
|
+
## 11. 工具採用範例:程式碼參照檢查(非規範性)
|
|
621
|
+
|
|
622
|
+
本節示範一種將 `code-reference` 過時檢查(§3.4)接入工具自身自動化的方式。這僅是說明文件——UDS 不提供此 hook,`uds init`/`uds update` 也不會安裝它。
|
|
623
|
+
|
|
624
|
+
### Claude Code
|
|
625
|
+
|
|
626
|
+
Claude Code 的自動記憶位於 repo 之外的 `~/.claude/projects/<project-path>/memory/`。`SessionStart` hook 可在該 session 第一次浮現記憶前,對該目錄執行檢查;沒有圖引擎時則退回降級模式:
|
|
627
|
+
|
|
628
|
+
```bash
|
|
629
|
+
#!/usr/bin/env bash
|
|
630
|
+
# Illustrative only — not installed by any UDS command.
|
|
631
|
+
MEMORY_DIR="$HOME/.claude/projects/$(pwd | tr '/' '-')/memory"
|
|
632
|
+
|
|
633
|
+
if command -v egr >/dev/null 2>&1 && [ -f .engram/graph.db ]; then
|
|
634
|
+
# Engine mode (§3.4): egr resolves each cited path/symbol.
|
|
635
|
+
egr refs check "$MEMORY_DIR"
|
|
636
|
+
else
|
|
637
|
+
# Degraded mode (§3.4): no engine configured — nothing to run up
|
|
638
|
+
# front; the assistant verifies each citation itself before use (§5).
|
|
639
|
+
echo "[developer-memory] no graph engine detected; degraded mode applies"
|
|
640
|
+
fi
|
|
641
|
+
```
|
|
642
|
+
|
|
643
|
+
### 其他工具
|
|
644
|
+
|
|
645
|
+
沒有 session 啟動 hook 的工具,仍可透過以下任一方式符合本標準:
|
|
646
|
+
|
|
647
|
+
- 在 repo 自身的指令檔(`CLAUDE.md`、`AGENTS.md`、`.cursorrules`、`.clinerules`、`.windsurfrules`、`copilot-instructions.md`、`GEMINI.md`、`.roo/rules/` 等)中加入規則,指示助手在依賴某筆記憶前先驗證其引用的路徑/符號;或
|
|
648
|
+
- 以 pre-commit 檢查掃描 repo 自身的指令檔,找出已無法解析的引用。
|
|
649
|
+
|
|
650
|
+
---
|
|
651
|
+
|
|
652
|
+
## 邊界:本標準不放什麼
|
|
653
|
+
|
|
654
|
+
下面兩種資訊不在本標準的範圍內,寫進這裡是錯的:
|
|
655
|
+
|
|
656
|
+
- **個人、跨專案、可識別的資訊**(誰負責什麼、怎麼連到某個環境)。去識別化(見上方的 schema)會把這些剝掉,所以它們不能是一筆記憶條目。它們屬於使用者自己的 AI 工具的記憶——那種記憶綁定該使用者與該機器,不被分享。
|
|
657
|
+
- **專案之間的協調**(哪件工作在等哪件工作)。那是開放工作,不是記憶:見 [Open Work Tracking](open-work-tracking.md)(OWT-027–OWT-029)。
|
|
658
|
+
|
|
659
|
+
---
|
|
660
|
+
|
|
566
661
|
## 版本歷史
|
|
567
662
|
|
|
568
663
|
| 版本 | 日期 | 變更 |
|
|
569
664
|
|------|------|------|
|
|
665
|
+
| 1.2.1 | 2026-10-07 | 新增:邊界章節——個人、跨專案、可識別的資訊,以及專案之間的協調,都不是記憶條目(XSPEC-460 R5;patch,無行為變更) |
|
|
666
|
+
| 1.2.0 | 2026-09-25 | 新增:審查(§3.4)的 `code-reference` 過時檢查——引用已移動/遺失之檔案路徑或符號的記憶會在浮現前被標記;沿用 Knowledge Graph Memory 的降級/引擎雙模式而非另創第三種;`unresolvable` 不得被解讀為 present 或 missing;範圍僅限檔案路徑與符號名稱(`file:line` 明確排除,DEC-115 OQ-1);§11 新增非規範性的 Claude Code 採用範例(DEC-115-L1) |
|
|
667
|
+
| 1.1.1 | 2026-06-18 | 新增:指向 XSPEC-291 的 `Owning Spec` 標頭(patch,無行為變更;XSPEC-291 §11 處置) |
|
|
668
|
+
| 1.1.0 | 2026-06-18 | 新增:退役建議閾值加上理由欄與可設定說明(XSPEC-292 T8) |
|
|
570
669
|
| 1.0.0 | 2026-02-07 | 初始標準:schema、4 項操作、主動協議、雜訊控制、架構決策(Always-On Protocol) |
|
|
571
670
|
|
|
572
671
|
---
|