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: ../../../docs/CLI-INIT-OPTIONS.md
|
|
3
|
-
source_version: 3.7.
|
|
4
|
-
translation_version: 3.7.
|
|
5
|
-
last_synced: 2026-
|
|
3
|
+
source_version: 3.7.1
|
|
4
|
+
translation_version: 3.7.1
|
|
5
|
+
last_synced: 2026-10-11
|
|
6
|
+
source_hash: 6e5aadbbb51d
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
@@ -10,8 +11,8 @@ status: current
|
|
|
10
11
|
|
|
11
12
|
> **語言**: [English](../../../docs/CLI-INIT-OPTIONS.md) | 繁體中文 | [简体中文](../../zh-CN/docs/CLI-INIT-OPTIONS.md)
|
|
12
13
|
>
|
|
13
|
-
> **版本**: 3.7.
|
|
14
|
-
> **最後更新**: 2026-09-
|
|
14
|
+
> **版本**: 3.7.1
|
|
15
|
+
> **最後更新**: 2026-09-29
|
|
15
16
|
|
|
16
17
|
本文件詳細說明 `uds init` 命令的每一個選項,包含使用情境、影響範圍和建議選擇。
|
|
17
18
|
|
|
@@ -112,9 +113,8 @@ status: current
|
|
|
112
113
|
```
|
|
113
114
|
? Select AI agents to install Skills for:
|
|
114
115
|
── Claude Code ──
|
|
115
|
-
❯ ◉ Claude Code (Plugin Marketplace) - Auto-managed (Recommended)
|
|
116
116
|
◯ Claude Code (User Level) - ~/.claude/skills/
|
|
117
|
-
|
|
117
|
+
❯ ◉ Claude Code (Project Level) - .claude/skills/ (預先勾選:主要路徑)
|
|
118
118
|
── OpenCode ──
|
|
119
119
|
◯ OpenCode (User Level) - ~/.config/opencode/skill/
|
|
120
120
|
◯ OpenCode (Project Level) - .opencode/skill/
|
|
@@ -148,22 +148,26 @@ status: current
|
|
|
148
148
|
|
|
149
149
|
### 詳細說明
|
|
150
150
|
|
|
151
|
-
#### Plugin Marketplace
|
|
151
|
+
#### Plugin Marketplace(替代方式,有限制)
|
|
152
|
+
|
|
153
|
+
它不是提示裡的選項,而是 Claude Code 自己的外掛系統。要用它,請取消提示中的所有勾選(或加 `--skills-location marketplace`),再在 Claude Code 內執行:
|
|
152
154
|
|
|
153
155
|
```bash
|
|
154
|
-
# 如果尚未安裝,執行:
|
|
155
156
|
/plugin marketplace add AsiaOstrich/universal-dev-standards
|
|
156
157
|
/plugin install universal-dev-standards@asia-ostrich
|
|
157
158
|
```
|
|
158
159
|
|
|
159
160
|
**優點**:
|
|
160
|
-
-
|
|
161
|
-
-
|
|
162
|
-
- 所有 15 個 Skills 一次安裝
|
|
161
|
+
- 由 Claude Code 更新,不用自己下指令
|
|
162
|
+
- 專案內不放檔案
|
|
163
163
|
|
|
164
|
-
|
|
165
|
-
-
|
|
164
|
+
**限制**:
|
|
165
|
+
- 只支援 Claude Code
|
|
166
|
+
- 只有英文技能文字(外掛設定沒有語系選擇)
|
|
167
|
+
- 只跟正式版:UDS 的測試版不會有測試版技能,也無法鎖定特定版本
|
|
166
168
|
- 需要網路連線
|
|
169
|
+
- `uds check` 無法逐檔比對它的技能檔
|
|
170
|
+
- 專案內也裝了技能時,Claude Code 會把每個技能列兩次;`uds check` 會警告
|
|
167
171
|
|
|
168
172
|
#### User Level
|
|
169
173
|
|
|
@@ -184,7 +188,10 @@ status: current
|
|
|
184
188
|
- 需要手動更新
|
|
185
189
|
- 不會隨專案版本控制
|
|
186
190
|
|
|
187
|
-
#### Project Level
|
|
191
|
+
#### Project Level(主要路徑,也是 `uds init --yes` 的預設)
|
|
192
|
+
|
|
193
|
+
繁體與簡體中文技能文字都放在 npm 套件內(`--locale zh-tw` 或 `zh-cn`),所以安裝它們不需要網路。如果某份 UDS 缺少這些文字,UDS 會明說,並改裝英文版。
|
|
194
|
+
|
|
188
195
|
|
|
189
196
|
```
|
|
190
197
|
your-project/
|
|
@@ -208,19 +215,15 @@ your-project/
|
|
|
208
215
|
### 決策流程
|
|
209
216
|
|
|
210
217
|
```
|
|
211
|
-
|
|
218
|
+
你用哪些 AI 工具?
|
|
212
219
|
│
|
|
213
|
-
├─
|
|
220
|
+
├─ 任何讀 SKILL.md 的工具(Claude Code、OpenCode、Codex、Copilot……)
|
|
221
|
+
│ → Project Level(主要路徑,預先勾選)
|
|
222
|
+
│ └─ 也想讓這台機器上每個專案都有技能? → 再加 User Level
|
|
214
223
|
│
|
|
215
|
-
└─
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
│
|
|
219
|
-
└─ 否 → 是否需要團隊共享?
|
|
220
|
-
│
|
|
221
|
-
├─ 是 → Project Level
|
|
222
|
-
│
|
|
223
|
-
└─ 否 → User Level
|
|
224
|
+
└─ 只用 Claude Code,且英文文字、只跟正式版、
|
|
225
|
+
專案內不放檔案都可以?
|
|
226
|
+
→ Plugin Marketplace(--skills-location marketplace)
|
|
224
227
|
```
|
|
225
228
|
|
|
226
229
|
---
|
|
@@ -472,7 +475,7 @@ main ─────────────────────────
|
|
|
472
475
|
| 語言 | 範例 | 適用情境 |
|
|
473
476
|
|------|------|----------|
|
|
474
477
|
| **English** (推薦) | `feat(auth): add OAuth2 support` | 國際團隊、開源專案 |
|
|
475
|
-
| **Traditional Chinese** |
|
|
478
|
+
| **Traditional Chinese** | `feat(auth): 實作 OAuth2 支援` | 繁體中文團隊(英文類型,中文主旨) |
|
|
476
479
|
| **Bilingual** | `feat(auth): add OAuth2 / 新增 OAuth2` | 雙語環境 |
|
|
477
480
|
|
|
478
481
|
### 5.4 Test Levels
|
|
@@ -812,7 +815,7 @@ uds init --experimental
|
|
|
812
815
|
| 選項 | 互動式提示 | CLI 參數 | 預設值 |
|
|
813
816
|
|------|------------|----------|--------|
|
|
814
817
|
| AI Tools | `promptAITools()` | - (偵測) | 自動偵測 |
|
|
815
|
-
| Skills Location | `promptSkillsInstallLocation()` | `--skills-location` | `
|
|
818
|
+
| Skills Location | `promptSkillsInstallLocation()` | `--skills-location` | `project` |
|
|
816
819
|
| Standards Scope | `promptStandardsScope()` | - | 依 Skills 決定 |
|
|
817
820
|
| Format | `promptFormat()` | `-f, --format` | `ai` |
|
|
818
821
|
| Git Workflow | `promptGitWorkflow()` | `--workflow` | `github-flow` |
|
|
@@ -836,7 +839,9 @@ uds init --experimental
|
|
|
836
839
|
| 強制執行 Hooks | `--with-hooks` | 安裝強制執行 hooks(commit-msg、security、logging) |
|
|
837
840
|
| 內容佈局 | `--content-layout` | 內容佈局(`flat`、`layered`)- 預設:`flat` |
|
|
838
841
|
| Claude Code 目標檔 | `--claude-target` | Claude Code 整合內容要寫到哪裡:`project`(`CLAUDE.md`,預設)或 `local`(`CLAUDE.local.md`) |
|
|
842
|
+
| 介面語言 | `--ui-lang` | 提示訊息的介面語言(`en`、`zh-tw`、`auto`)- 預設:`auto` |
|
|
839
843
|
| 模式(已棄用) | `-m, --mode` | 安裝模式(skills, full)- 請改用 `--skills-location` |
|
|
844
|
+
| 強制覆寫 | `-f, --force` | 覆寫既有配置(供 `uds ai-context init` 使用) |
|
|
840
845
|
|
|
841
846
|
### 提交前標準檢查(git hook 接線)
|
|
842
847
|
|
|
@@ -856,7 +861,7 @@ git repo 就會執行。Node.js 專案(偵測到 `package.json`)寫入
|
|
|
856
861
|
這是錦上添花,不是這道接線能不能生效的關鍵。
|
|
857
862
|
- **覆蓋你自己的 git hook 設定。** 若 `core.hooksPath` 已經指向別處,或
|
|
858
863
|
`.git/hooks/pre-commit` 已經存在,`uds init` 會兩者都不動,並印出檢查
|
|
859
|
-
|
|
864
|
+
**未啟用**,並附上原因與手動修復方式。
|
|
860
865
|
|
|
861
866
|
`git config core.hooksPath` 是**本機、per-clone 的設定——不會進版控。**
|
|
862
867
|
跑 `uds init` 只會讓「跑過這個指令的那個 clone」生效;其他人 clone 這個
|
|
@@ -870,21 +875,46 @@ UDS 的專案——並在 `[pre-commit]` 底下回報同樣的修復方式;此
|
|
|
870
875
|
|
|
871
876
|
`--with-hooks` 一定會安裝進 `.claude/settings.json`。四個有 hook 支援的標準
|
|
872
877
|
之一——`turn-completion-integrity`(見 CHANGELOG,Unreleased)——也會裝進
|
|
873
|
-
**Codex
|
|
878
|
+
**Codex**、**Gemini CLI**(過時)與 **Antigravity CLI**(`agy`),門檻是你有沒有在 [AI 工具選擇](#1-ai-工具選擇)
|
|
874
879
|
裡選了那個工具(或用非互動模式的工具旗標帶入):
|
|
875
880
|
|
|
876
881
|
| 工具 | 寫入的設定檔 | 觸發條件 |
|
|
877
882
|
|------|-------------|---------|
|
|
878
883
|
| Codex | `.codex/hooks.json` | 選了 **OpenAI Codex** |
|
|
879
884
|
| Gemini CLI | `.gemini/settings.json` | 選了 **Gemini CLI** |
|
|
885
|
+
| Antigravity CLI | `.agents/hooks.json` | 選了 **Google Antigravity** |
|
|
880
886
|
|
|
881
|
-
沒選的工具不會寫入任何東西——`uds init` 不會在沒用到 Codex 或
|
|
882
|
-
的專案裡建立 `.codex/` 或 `.
|
|
887
|
+
沒選的工具不會寫入任何東西——`uds init` 不會在沒用到 Codex、Gemini CLI 或 Antigravity
|
|
888
|
+
的專案裡建立 `.codex/`、`.gemini/` 或 `.agents/` 目錄。其餘三個有 hook 支援的標準
|
|
883
889
|
(commit message 驗證、logging、security)目前仍只支援 Claude Code;
|
|
884
890
|
為什麼目前只推廣 turn-completion-integrity,以及 Cursor 的現況
|
|
885
891
|
(已評估、不支援),見
|
|
886
892
|
[支援的執行環境](../../../core/turn-completion-integrity.md#supported-harnesses)。
|
|
887
893
|
|
|
894
|
+
### 為已初始化的專案補裝 Hooks(`uds update --with-hooks`)
|
|
895
|
+
|
|
896
|
+
`uds init` 不能跑第二次,所以 `--with-hooks` 到不了已經初始化的專案——包括在 UDS 支援某個工具**之前**
|
|
897
|
+
(或在偵測認得它之前)就初始化的專案。`uds update --with-hooks` 就是那扇門:
|
|
898
|
+
|
|
899
|
+
```bash
|
|
900
|
+
uds update --with-hooks --plan # 列出會裝什麼;不寫任何檔
|
|
901
|
+
uds update --with-hooks # 補裝缺少的 hooks
|
|
902
|
+
uds update --with-hooks --ai-tool antigravity # 直接指定工具,不做偵測
|
|
903
|
+
```
|
|
904
|
+
|
|
905
|
+
- **裝給哪些工具。** `.standards/manifest.json` 裡的工具,加上專案檔案現在看得出來的(Claude Code:
|
|
906
|
+
`.claude/` 或 `CLAUDE.md`;Codex:根目錄 `AGENTS.md`;Gemini CLI:`GEMINI.md`;Antigravity:
|
|
907
|
+
`.agents/AGENTS.md`、`.agents/rules/`、`.agents/workflows/`、`.agents/plugins/` 或
|
|
908
|
+
`.agents/hooks.json`)。**`.agents/skills/` 不算 Antigravity 的標記**——Codex 也從同一個目錄讀專案技能,
|
|
909
|
+
所以它分不出是哪個工具。`--ai-tool <清單>`(`claude-code`、`codex`、`gemini-cli`、`antigravity`,
|
|
910
|
+
以逗號分隔)會取代偵測。找不到任何工具時,它會說明、印出如何指定,並以 1 結束。
|
|
911
|
+
- **不會動什麼。** 已經裝好的 hook 不會被重寫。你自己的 hooks 不會被移除或重排:Claude、Codex、Gemini 的
|
|
912
|
+
項目是合併進去;Antigravity 的 `.agents/hooks.json` 只寫在 `uds-turn-completion-integrity` 這個鍵底下
|
|
913
|
+
(不是合法 JSON 的 `hooks.json` 會原樣保留並回報)。`scripts/hooks/` 裡與隨附版本不同的 hook 腳本會被保留並回報;
|
|
914
|
+
加上 `--force` 才會覆寫。
|
|
915
|
+
- **它不做什麼。** 不更新標準、技能或整合檔(那是一般的 `uds update`),也不會把工具加進 manifest。
|
|
916
|
+
它不能與 `--skills`、`--commands` 等其他 update 模式合用,合用時會明說。
|
|
917
|
+
|
|
888
918
|
### Claude Code 整合目標檔(`--claude-target`)
|
|
889
919
|
|
|
890
920
|
UDS 預設把 Claude Code 內容寫進 `CLAUDE.md`——團隊共用、會進版控的那個檔案。
|
|
@@ -937,7 +967,7 @@ uds init -y
|
|
|
937
967
|
# 指定所有選項
|
|
938
968
|
uds init -y \
|
|
939
969
|
--format ai \
|
|
940
|
-
--skills-location
|
|
970
|
+
--skills-location project \
|
|
941
971
|
--workflow github-flow \
|
|
942
972
|
--merge-strategy squash \
|
|
943
973
|
--output-lang english \
|
|
@@ -962,6 +992,12 @@ uds init -y --content-layout layered
|
|
|
962
992
|
# 繁體中文團隊
|
|
963
993
|
uds init -y --output-lang traditional-chinese --locale zh-tw
|
|
964
994
|
|
|
995
|
+
# 強制使用英文提示
|
|
996
|
+
uds init --ui-lang en
|
|
997
|
+
|
|
998
|
+
# 強制使用繁體中文提示
|
|
999
|
+
uds init --ui-lang zh-tw
|
|
1000
|
+
|
|
965
1001
|
# PHP 專案
|
|
966
1002
|
uds init -y --lang php --framework fat-free
|
|
967
1003
|
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# UDS 功能參考手冊
|
|
2
2
|
|
|
3
3
|
> Universal Development Standards - 完整功能文件
|
|
4
|
-
> Auto-generated | Last updated: 2026-
|
|
4
|
+
> Auto-generated | Last updated: 2026-10-12
|
|
5
5
|
|
|
6
6
|
**Language**: [English](../../../docs/reference/FEATURE-REFERENCE.md) | 繁體中文 | [简体中文](../../zh-CN/docs/FEATURE-REFERENCE.md)
|
|
7
7
|
|
|
@@ -9,15 +9,15 @@
|
|
|
9
9
|
|
|
10
10
|
## 目錄
|
|
11
11
|
|
|
12
|
-
1. [CLI 指令](#cli-commands) (
|
|
12
|
+
1. [CLI 指令](#cli-commands) (24)
|
|
13
13
|
2. [斜線命令](#slash-commands) (51)
|
|
14
|
-
3. [技能](#skills) (
|
|
14
|
+
3. [技能](#skills) (56)
|
|
15
15
|
4. [代理](#agents) (5)
|
|
16
16
|
5. [工作流程](#workflows) (5)
|
|
17
17
|
6. [核心規範](#core-standards) (153)
|
|
18
|
-
7. [腳本](#scripts) (
|
|
18
|
+
7. [腳本](#scripts) (66)
|
|
19
19
|
|
|
20
|
-
**Total Features:
|
|
20
|
+
**Total Features: 360**
|
|
21
21
|
|
|
22
22
|
---
|
|
23
23
|
|
|
@@ -48,7 +48,7 @@
|
|
|
48
48
|
| `--lang` | Language extension (csharp, php) |
|
|
49
49
|
| `--framework` | Framework extension (fat-free) |
|
|
50
50
|
| `--locale` | Locale extension (zh-tw) |
|
|
51
|
-
| `--skills-location` | Skills location (
|
|
51
|
+
| `--skills-location` | Skills location (project, user, marketplace, none) [default: project] |
|
|
52
52
|
| `--content-mode` | Content mode for integration files (minimal, index) [default: index]; full is retired and resolves to index |
|
|
53
53
|
| `--agents-md` | Generate AGENTS.md universal summary |
|
|
54
54
|
| `--no-agents-md` | Skip AGENTS.md generation |
|
|
@@ -116,7 +116,7 @@
|
|
|
116
116
|
|
|
117
117
|
### `uds simulate`
|
|
118
118
|
|
|
119
|
-
**說明**: Simulate a standard check with input (Predictive Validation)
|
|
119
|
+
**說明**: Simulate a standard check with input (Predictive Validation). Exit 0 = passes, 1 = does not comply, 2 = no verdict (cannot simulate; not a pass). Only commit-message defines a simulator today
|
|
120
120
|
|
|
121
121
|
**選項**:
|
|
122
122
|
| Option | 說明 |
|
|
@@ -156,8 +156,11 @@
|
|
|
156
156
|
| `--force` | Force update all files, ignoring hash comparison |
|
|
157
157
|
| `--prune` | Delete .standards/ files UDS wrote but no longer ships (listed without this flag; never touches files UDS did not write) |
|
|
158
158
|
| `--rollback` | Rollback to the most recent backup |
|
|
159
|
+
| `--add-standard` | With --plan or --apply: also install this standard UDS ships and the project lacks, and record it in the manifest (repeatable; `uds update --plan` lists what is available) |
|
|
159
160
|
| `--claude-target` | Switch an existing install to a different Claude Code integration target: project (CLAUDE.md) or local (CLAUDE.local.md) — moves the UDS block, keeps your content, no reinstall |
|
|
160
161
|
| `--locale` | Override locale for skills install (zh-tw, zh-cn, en); also reads .uds/install.yaml + UDS_LOCALE env |
|
|
162
|
+
| `--with-hooks` | Install the enforcement hooks that are missing from this already-initialized project (re-detects tools; hooks already there and your own hooks are not touched; with --plan, writes nothing; --force also overwrites edited hook scripts) |
|
|
163
|
+
| `--ai-tool` | With --with-hooks: comma-separated tools to install hooks for (claude-code, codex, gemini-cli, antigravity) instead of detecting them |
|
|
161
164
|
|
|
162
165
|
### `uds skills`
|
|
163
166
|
|
|
@@ -179,6 +182,7 @@
|
|
|
179
182
|
| `--gh` | Force gh CLI for submission |
|
|
180
183
|
| `--format` | Output format (json) |
|
|
181
184
|
| `--quiet` | Summary only |
|
|
185
|
+
| `--offline` | No network access at all: no CLI version check, and --report does not submit |
|
|
182
186
|
| `--score` | Run multi-dimensional health score analysis |
|
|
183
187
|
| `--self` | Self mode: analyze UDS repo itself (use with --score) |
|
|
184
188
|
| `--save` | Save score snapshot for trend tracking (use with --score) |
|
|
@@ -198,6 +202,7 @@
|
|
|
198
202
|
| `--path` | Directory containing package.json (default: cwd) |
|
|
199
203
|
| `--json` | Output raw JSON |
|
|
200
204
|
| `--concurrency` | Parallel registry lookups (default: 8) |
|
|
205
|
+
| `--if-present` | Exit 0 and say that nothing was checked when there is no package.json or no runtime dependency (default: exit 1) |
|
|
201
206
|
|
|
202
207
|
### `uds uninstall`
|
|
203
208
|
|
|
@@ -276,6 +281,10 @@
|
|
|
276
281
|
|
|
277
282
|
**說明**: MCP server commands for AI tool integration
|
|
278
283
|
|
|
284
|
+
### `uds open-work`
|
|
285
|
+
|
|
286
|
+
**說明**: Reference checks for open-work-tracking (OWT-017 to OWT-028). Exit 0 no violation, 1 violation, 2 cannot decide (not a pass)
|
|
287
|
+
|
|
279
288
|
### `uds run`
|
|
280
289
|
|
|
281
290
|
**說明**: Run a project command by intent (test/lint/build/security) via uds.project.yaml
|
|
@@ -359,6 +368,7 @@
|
|
|
359
368
|
| `ci-cd-assistant` | 引導 CI/CD 管線的設計、設定與最佳化。 |
|
|
360
369
|
| `code-review-assistant` | [UDS] 系統性程式碼審查的參考資料:八大審查類別,以及 BLOCKING/IMPORTANT/SUGGESTION 評論前綴。 |
|
|
361
370
|
| `commit-standards` | [UDS] 產生符合 Conventional Commits 規範的 commit message,包含雙語格式。 |
|
|
371
|
+
| `comprehension-ladder` | [UDS] 把一段難懂的 AI 輸出換成較好懂的形式:受控文字、Mermaid 圖、單檔 HTML 解說頁。所有形式都來自同一份大綱,所以形式會變,事實不會變。 |
|
|
362
372
|
| `contract-test-assistant` | [UDS] 引導 API 與微服務的合約測試策略。 |
|
|
363
373
|
| `database-assistant` | 引導資料庫設計、遷移與查詢最佳化。 |
|
|
364
374
|
| `deploy-assistant` | 引導在沒有 CI/CD 平台(GitHub Actions/GitLab CI)的情況下完成可靠部署。 |
|
|
@@ -442,7 +452,7 @@
|
|
|
442
452
|
| `ai-command-behavior` | 1.0.0 | This standard defines a structure for specifying AI Agent runtime behavior in co |
|
|
443
453
|
| `ai-friendly-architecture` | 1.0.0 | This standard defines architecture and documentation practices that maximize the |
|
|
444
454
|
| `ai-instruction-standards` | 1.1.1 | This standard defines best practices for creating and maintaining AI instruction |
|
|
445
|
-
| `ai-response-navigation` | 1.
|
|
455
|
+
| `ai-response-navigation` | 1.4.0 | This standard defines navigation behavior for AI responses: every substantive AI |
|
|
446
456
|
| `alerting-standards` | 1.0.0 | |
|
|
447
457
|
| `anti-hallucination` | 1.5.1 | This standard defines strict guidelines for AI assistants to prevent hallucinati |
|
|
448
458
|
| `anti-sycophancy-prompting` | 1.0.0 | This standard defines techniques and rules for designing prompts that elicit gen |
|
|
@@ -461,8 +471,8 @@
|
|
|
461
471
|
| `checkin-standards` | 1.8.0 | This standard defines quality gates that MUST be passed before committing code t |
|
|
462
472
|
| `circuit-breaker` | - | |
|
|
463
473
|
| `class-level-fix` | 1.1.0 | A defect is almost never alone. It is one member of a set — one flag in a dispat |
|
|
464
|
-
| `code-review-checklist` | 1.
|
|
465
|
-
| `commit-message-guide` | 1.
|
|
474
|
+
| `code-review-checklist` | 1.6.0 | This standard provides a comprehensive checklist for reviewing code changes, ens |
|
|
475
|
+
| `commit-message-guide` | 1.4.0 | Standardized commit messages improve code review efficiency, facilitate automate |
|
|
466
476
|
| `container-image-standards` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
|
|
467
477
|
| `container-security` | - | |
|
|
468
478
|
| `containerization-standards` | 1.0.0 | |
|
|
@@ -478,7 +488,7 @@
|
|
|
478
488
|
| `deployment-standards` | 1.1.0 | This standard defines guidelines for safely deploying software to production, co |
|
|
479
489
|
| `deprecation-standards` | 1.1.0 | |
|
|
480
490
|
| `design-document-standards` | 1.0.0 | |
|
|
481
|
-
| `developer-memory` | 1.
|
|
491
|
+
| `developer-memory` | 1.2.1 | This standard defines a structured system for capturing, retrieving, and surfaci |
|
|
482
492
|
| `disaster-recovery-drill` | - | |
|
|
483
493
|
| `documentation-lifecycle` | 1.0.0 | This standard defines **when** to update documentation, **when** to check it, an |
|
|
484
494
|
| `documentation-structure` | 1.5.0 | This standard defines a consistent documentation structure for software projects |
|
|
@@ -516,18 +526,18 @@
|
|
|
516
526
|
| `mutation-testing` | 1.1.0 | Mutation testing evaluates test suite effectiveness by injecting artificial bugs |
|
|
517
527
|
| `no-cicd-deployment` | - | |
|
|
518
528
|
| `observability-standards` | 1.0.0 | |
|
|
519
|
-
| `open-work-tracking` | 1.
|
|
529
|
+
| `open-work-tracking` | 1.4.0 | The deferred-item-exit standard requires that a deferred item leave its document |
|
|
520
530
|
| `packaging-standards` | 1.1.0 | This standard defines a Recipe-based packaging framework that enables user proje |
|
|
521
531
|
| `performance-standards` | 1.2.0 | This standard defines comprehensive guidelines for software performance engineer |
|
|
522
532
|
| `pii-classification` | 1.1.0 | **Status**: Active | **Updated**: 2026-06-19 | |
|
|
523
533
|
| `pipeline-integration-standards` | - | |
|
|
524
|
-
| `pipeline-security-gates` |
|
|
534
|
+
| `pipeline-security-gates` | 1.1.0 | |
|
|
525
535
|
| `policy-as-code-testing` | - | |
|
|
526
536
|
| `postmortem-standards` | 1.0.0 | |
|
|
527
537
|
| `prd-standards` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
|
|
528
538
|
| `privacy-standards` | 1.1.0 | |
|
|
529
539
|
| `product-metrics-standards` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
|
|
530
|
-
| `project-context-memory` | 1.2.
|
|
540
|
+
| `project-context-memory` | 1.2.1 | This standard defines a structured system for capturing, retrieving, and enforci |
|
|
531
541
|
| `project-structure` | 1.2.0 | This standard defines conventions for project directory structure beyond documen |
|
|
532
542
|
| `prompt-regression` | - | |
|
|
533
543
|
| `property-based-testing` | - | |
|
|
@@ -574,7 +584,7 @@
|
|
|
574
584
|
| `timeout-standards` | - | |
|
|
575
585
|
| `token-budget` | - | |
|
|
576
586
|
| `translation-lifecycle-standards` | 1.0.1 | Translation lifecycle standards: MISSING vs OUTDATED distinction, semver-aware s |
|
|
577
|
-
| `turn-completion-integrity` | 1.
|
|
587
|
+
| `turn-completion-integrity` | 1.5.0 | An agent writes *"I'll do X next"* and then ends the turn without doing X. |
|
|
578
588
|
| `user-journey-testing` | - | |
|
|
579
589
|
| `user-story-mapping` | 1.0.0 | **Status**: Active | **Updated**: 2026-06-17 | |
|
|
580
590
|
| `verification-evidence` | 1.3.0 | Establish an "Iron Law" that no task can be claimed as complete without verifica |
|
|
@@ -598,6 +608,7 @@
|
|
|
598
608
|
| `check-ai-agent-sync.ps1` | Check Ai Agent Sync |
|
|
599
609
|
| `check-ai-agent-sync.sh` | AI Agent Sync Checker |
|
|
600
610
|
| `check-ai-yaml-parses.mjs` | Every shipped .ai.yaml must parse, and must parse into what it says. |
|
|
611
|
+
| `check-bats-assertions.mjs` | check-bats-assertions.mjs — find .bats assertions that can pass silently. |
|
|
601
612
|
| `check-bump-sync-roundtrip.mjs` | check-bump-sync-roundtrip — 測「跑完 bump 之後 check 必須通過」這個不變量。 |
|
|
602
613
|
| `check-cli-docs-sync.ps1` | Check Cli Docs Sync |
|
|
603
614
|
| `check-cli-docs-sync.sh` | CLI-to-Documentation Sync Checker |
|
|
@@ -610,8 +621,11 @@
|
|
|
610
621
|
| `check-docs-sync.sh` | Documentation Sync Checker |
|
|
611
622
|
| `check-error-exit.mjs` | 🔴 沒填就是沒設定,而沒設定會 exit 2, |
|
|
612
623
|
| `check-external-references.mjs` | External Reference Checker (SPEC-SELFDIAG-001 REQ-5, AC-7) |
|
|
624
|
+
| `check-home-untouched.mjs` | check-home-untouched — did this run write anywhere UDS writes under HOME? |
|
|
625
|
+
| `check-open-work-tracking.mjs` | Open-work-tracking reference checks for OWT-017 to OWT-028 — repo entry point. |
|
|
613
626
|
| `check-orphan-specs.ps1` | Check Orphan Specs |
|
|
614
627
|
| `check-orphan-specs.sh` | Orphan Spec Detection Script |
|
|
628
|
+
| `check-prompt-footprint.mjs` | Prompt Footprint Ratchet — DEC-117 D2/L2 |
|
|
615
629
|
| `check-scope-sync.ps1` | Check Scope Sync |
|
|
616
630
|
| `check-scope-sync.sh` | Scope Consistency Check Script |
|
|
617
631
|
| `check-skill-next-steps-sync.ps1` | Check Skill Next Steps Sync |
|
|
@@ -625,11 +639,13 @@
|
|
|
625
639
|
| `check-translation-hash-ratchet.sh` | XSPEC-392 R6 棘輪:新的翻譯必須帶 source_hash,既有的欠債冷凍為基線。 |
|
|
626
640
|
| `check-translation-sync.ps1` | Check Translation Sync |
|
|
627
641
|
| `check-translation-sync.sh` | Translation Sync Checker |
|
|
642
|
+
| `check-upgrade-fidelity.sh` | Upgrade Fidelity Checker |
|
|
628
643
|
| `check-usage-docs-sync.ps1` | Check if usage documentation needs to be regenerated |
|
|
629
644
|
| `check-usage-docs-sync.sh` | check-usage-docs-sync.sh |
|
|
630
645
|
| `check-version-sync.ps1` | Check Version Sync |
|
|
631
646
|
| `check-version-sync.sh` | Version Sync Checker |
|
|
632
647
|
| `check-workflow-compliance.sh` | Thin wrapper — scripts/check-workflow-compliance.ts is the only copy of the |
|
|
648
|
+
| `ci-vitest-summary.mjs` | ci-vitest-summary — say how many tests ran, passed, failed and were skipped (dev-platform XSPEC-469 R4). |
|
|
633
649
|
| `commitlint-bilingual-rule.mjs` | commitlint-bilingual-rule.mjs — custom commitlint rules enforcing the |
|
|
634
650
|
| `convert-md-to-yaml.mjs` | Markdown to AI-YAML Conversion Script |
|
|
635
651
|
| `fix-manifest-paths.ps1` | Fix Manifest Paths |
|
|
@@ -641,6 +657,7 @@
|
|
|
641
657
|
| `generate-version-manifest.mjs` | Generate Version Manifest (SPEC-SELFDIAG-001 REQ-9, AC-14) |
|
|
642
658
|
| `install-hooks.mjs` | Install Hooks |
|
|
643
659
|
| `install-hooks.sh` | Thin wrapper — scripts/install-hooks.mjs is the only copy of the installer |
|
|
660
|
+
| `npm-pack-files.mjs` | @param {string} stdout @returns {string[]} package-relative file paths |
|
|
644
661
|
| `pre-commit.mjs` | Build a platform-aware shell command for a .sh script. |
|
|
645
662
|
| `pre-release-check.ps1` | Pre Release Check |
|
|
646
663
|
| `pre-release-check.sh` | Pre-release Check Script |
|
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
source: ../../../docs/USAGE-MODES-COMPARISON.md
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
|
-
last_synced: 2026-
|
|
5
|
+
last_synced: 2026-10-11
|
|
6
|
+
source_hash: 65e48ed292b6
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
@@ -35,7 +36,7 @@ status: current
|
|
|
35
36
|
|
|
36
37
|
**配置方式**:
|
|
37
38
|
- 安裝時選擇 `standardsScope: minimal`
|
|
38
|
-
- Skills
|
|
39
|
+
- Skills 位置:裝進專案(`--skills-location project`,預設);外掛市集是有限制的替代方式(只支援 Claude Code、只有英文技能文字、只跟正式版)
|
|
39
40
|
- 最小化規範文件複製到專案
|
|
40
41
|
|
|
41
42
|
**包含內容**:
|
|
@@ -147,7 +148,7 @@ status: current
|
|
|
147
148
|
| 團隊同步 | 需各自安裝 | Git 同步 | 混合 |
|
|
148
149
|
|
|
149
150
|
**說明**:
|
|
150
|
-
- Skills
|
|
151
|
+
- 裝進專案的 Skills(預設)可以提交到 Git;來自外掛市集的 Skills 由 Claude Code 管理,不在專案內
|
|
151
152
|
- 規範文件可放入 Git,團隊自動同步
|
|
152
153
|
- 自訂規則需要修改規範文件
|
|
153
154
|
|
|
@@ -180,7 +181,7 @@ status: current
|
|
|
180
181
|
|
|
181
182
|
**配置方式**:
|
|
182
183
|
```bash
|
|
183
|
-
uds init -y --skills-location
|
|
184
|
+
uds init -y --skills-location project
|
|
184
185
|
# standardsScope 將自動設為 minimal
|
|
185
186
|
```
|
|
186
187
|
|
|
@@ -195,7 +196,7 @@ uds init -y --skills-location marketplace
|
|
|
195
196
|
|
|
196
197
|
**配置方式**:
|
|
197
198
|
```bash
|
|
198
|
-
uds init -y --skills-location
|
|
199
|
+
uds init -y --skills-location project --content-mode index
|
|
199
200
|
# 在互動提示中選擇多個 AI 工具
|
|
200
201
|
```
|
|
201
202
|
|
|
@@ -296,11 +297,11 @@ uds init -y --skills-location none --content-mode index
|
|
|
296
297
|
```
|
|
297
298
|
個人開發者 + Claude Code
|
|
298
299
|
└─ 推薦:僅 Skills(模式 A)
|
|
299
|
-
└─ 配置:standardsScope: minimal +
|
|
300
|
+
└─ 配置:standardsScope: minimal + 技能裝進專案
|
|
300
301
|
|
|
301
302
|
團隊開發 + 混合工具
|
|
302
303
|
└─ 推薦:Skills + 規範文件(模式 C)
|
|
303
|
-
└─ 配置:standardsScope: full +
|
|
304
|
+
└─ 配置:standardsScope: full + 技能裝進專案
|
|
304
305
|
└─ 規範文件納入 Git 管理
|
|
305
306
|
|
|
306
307
|
企業環境 + 合規要求
|
|
@@ -2,10 +2,18 @@
|
|
|
2
2
|
source: docs/USER-MANUAL.md
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
|
+
last_synced: 2026-10-11
|
|
6
|
+
source_hash: 5c3253bd60b5
|
|
5
7
|
status: current
|
|
6
8
|
---
|
|
7
9
|
|
|
8
|
-
|
|
10
|
+
> **⚠️ 已棄用(DEPRECATED)** — 本手冊已過時(最後更新於 2026-03-24),不再維護。
|
|
11
|
+
> 最新指南請參閱新版使用者文件 **[docs/user/README.md](user/README.md)**。
|
|
12
|
+
> 封存位置:[docs/archive/USER-MANUAL-2026-03-24.md](../../../docs/archive/USER-MANUAL-2026-03-24.md)
|
|
13
|
+
|
|
14
|
+
---
|
|
15
|
+
|
|
16
|
+
# 使用者手冊(已封存)
|
|
9
17
|
|
|
10
18
|
**Version**: 1.0.0
|
|
11
19
|
**Last Updated**: 2026-03-24
|
|
@@ -2,12 +2,15 @@
|
|
|
2
2
|
source: ../../../docs/WINDOWS-GUIDE.md
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
|
-
last_synced:
|
|
5
|
+
last_synced: 2026-10-11
|
|
6
|
+
source_hash: 4416025824b3
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
9
10
|
# Windows 開發指南
|
|
10
11
|
|
|
12
|
+
> **語言**: [English](../../../docs/WINDOWS-GUIDE.md) | 繁體中文 | [简体中文](../../zh-CN/docs/WINDOWS-GUIDE.md)
|
|
13
|
+
|
|
11
14
|
本指南提供使用和貢獻 Universal Development Standards 的 Windows 特定說明。
|
|
12
15
|
|
|
13
16
|
---
|
|
@@ -59,7 +62,13 @@ npm link
|
|
|
59
62
|
|
|
60
63
|
## 安裝 Claude Code Skills
|
|
61
64
|
|
|
62
|
-
|
|
65
|
+
**主要路徑:裝進專案**(支援多種 AI 工具、有繁體與簡體中文文字、跟著你裝的 UDS 版本)
|
|
66
|
+
```bash
|
|
67
|
+
npx universal-dev-standards init # 新專案
|
|
68
|
+
npx universal-dev-standards update --apply --skills # 已設定好的專案
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
**替代方式(有限制):Claude Code 外掛市集**(只支援 Claude Code、只有英文技能文字、只跟正式版、專案內不放檔案)
|
|
63
72
|
```bash
|
|
64
73
|
/plugin marketplace add AsiaOstrich/universal-dev-standards
|
|
65
74
|
/plugin install universal-dev-standards@asia-ostrich
|
|
@@ -2,6 +2,8 @@
|
|
|
2
2
|
source: docs/user/GETTING-STARTED.md
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
|
+
last_synced: 2026-10-11
|
|
6
|
+
source_hash: a71a0848b809
|
|
5
7
|
status: current
|
|
6
8
|
---
|
|
7
9
|
|
|
@@ -57,6 +59,50 @@ CLAUDE.md ← 已更新 UDS 指引(Claude Code)
|
|
|
57
59
|
|
|
58
60
|
---
|
|
59
61
|
|
|
62
|
+
## 技能怎麼裝
|
|
63
|
+
|
|
64
|
+
取得 UDS 技能有兩種方式,兩種都受支援。主要路徑是裝進專案;Claude Code 外掛市集是有限制的替代方式。
|
|
65
|
+
|
|
66
|
+
> **預設是裝進專案。** `uds init` 與不帶 `--skills-location` 的 `uds init --yes` 會把技能裝進專案(Claude Code 是 `.claude/skills/`)。6.14 之前它們一個技能檔都不裝,把 Claude Code 的技能留給外掛。要改用外掛,請加 `--skills-location marketplace`:專案內不會寫入任何技能檔,安裝結尾會說明技能從哪裡來。
|
|
67
|
+
|
|
68
|
+
| | 裝進專案(主要路徑) | Claude Code 外掛市集(替代方式) |
|
|
69
|
+
|---|---|---|
|
|
70
|
+
| 指令 | 新專案:`uds init`(這是預設)<br>已設定過的專案:`uds update --apply --skills` | `/plugin marketplace add AsiaOstrich/universal-dev-standards`,再 `/plugin install universal-dev-standards@asia-ostrich` |
|
|
71
|
+
| AI 工具 | Claude Code、OpenCode、Cursor、Codex、Copilot、Windsurf 等 | 只支援 Claude Code |
|
|
72
|
+
| 技能文字的語言 | 英文、繁體中文、簡體中文。中文文字放在 npm 套件內,所以安裝它們不需要網路;缺少這些文字的 UDS 會改裝英文並明說 | 只有英文:外掛設定沒有語系選擇 |
|
|
73
|
+
| UDS 版本 | 你裝的那個版本,包含測試版 | 只跟正式版 |
|
|
74
|
+
| 專案內的檔案 | 有,例如 `.claude/skills/`;`uds check` 會逐檔驗證 | 沒有 |
|
|
75
|
+
| 更新 | 升級 UDS 後,自己再跑一次 `uds update --apply --skills` | 由 Claude Code 管理外掛(`/plugin`) |
|
|
76
|
+
|
|
77
|
+
**請二擇一。** Claude Code 執行外掛技能是 `/<外掛名>:<技能名>`,執行專案技能是 `/<技能名>`,所以兩種都裝時每個技能會出現兩次(例如 `/commit` 與 `/universal-dev-standards:commit`),而且每個技能的名稱與描述每回合都會放進脈絡,重複裝等於重複占用。`uds check` 發現專案內有 UDS 技能、同時又裝了 UDS 外掛時,會印出警告;警告只是資訊,不改變判定與結束碼。要留專案這份,在 Claude Code 執行 `/plugin uninstall universal-dev-standards@asia-ostrich`。要留外掛,刪掉 `.claude/skills/` 底下的 UDS 技能資料夾。
|
|
78
|
+
|
|
79
|
+
**為什麼 `uds check` 與 `uds update` 叫你跑 `uds update --apply --skills`。** `uds check` 在專案裡的技能檔遺失或被改過時說這句,`uds update` 在已裝的技能版本落後時說這句。只有裝進專案的技能有檔案,UDS 才能拿它和當初裝的內容比對、放回去,所以修法就是那個指令。外掛不在你的專案裡放檔案,`uds check` 沒有東西可比對,也就沒有這類訊息。
|
|
80
|
+
|
|
81
|
+
`uds skills` 會列出裝了什麼、裝在哪裡,並印出同樣的兩種方式與各自的限制。
|
|
82
|
+
|
|
83
|
+
### 個人技能與 UDS 技能同名時
|
|
84
|
+
|
|
85
|
+
Claude Code 對同一個名稱只執行一個技能,而且漏掉另一個時不會告訴你。哪一個執行,取決於各自從哪裡來(Claude Code 技能文件,2026-10-07 讀取):
|
|
86
|
+
|
|
87
|
+
| 同名出現在 | 執行哪一個 |
|
|
88
|
+
|---|---|
|
|
89
|
+
| 企業層(組織下發的 managed settings 目錄)、個人層(`~/.claude/skills/<名稱>/`)、專案層(`.claude/skills/<名稱>/`) | 企業層高於個人層,個人層高於專案層 |
|
|
90
|
+
| 專案技能與子目錄裡的巢狀技能 | 兩個都載入:`/<名稱>` 執行專案根目錄那個,巢狀那個是 `/<目錄>:<名稱>` |
|
|
91
|
+
| 外掛技能與上面任一處的技能 | 兩個都載入:外掛技能是 `/<外掛名>:<名稱>` |
|
|
92
|
+
| 技能與 `.claude/commands/<名稱>.md` 檔 | 技能 |
|
|
93
|
+
|
|
94
|
+
技能的名稱是 `SKILL.md` frontmatter 裡的 `name:`,沒有就用資料夾名稱;資料夾名稱同樣能叫出該技能,所以兩者任一撞名都算。
|
|
95
|
+
|
|
96
|
+
**對 UDS 的意思。** `uds init --skills-location project` 與 `uds update --apply --skills` 寫進去的是專案技能。你若已有同名的個人技能,執行的是你的,UDS 那個永遠不會執行,而且沒有任何訊息說明。UDS 有幾個技能名稱短而通用(`plan`、`push`、`sweep`、`orchestrate`,以及資料夾叫 `commit-standards` 的 `/commit`),所以有個人技能庫的人都可能遇到。UDS 不為此改名:改名會破壞所有既有的呼叫。
|
|
97
|
+
|
|
98
|
+
**怎麼看見。** `uds check` 會拿專案裡的 UDS 技能與 `~/.claude/skills/` 的技能比對,印出一則警告並點名每一組;`uds init` 與 `uds update --apply --skills` 在安裝結尾印同一則警告。它只是資訊,不改變判定也不改變結束碼。它有限制,而且**沒有警告不等於沒有撞名**:它看不到組織以企業層下發的技能(優先序高於個人層),也看不到它執行之後你才新增的個人技能,所以新增之後請再跑一次 `uds check`。
|
|
99
|
+
|
|
100
|
+
**怎麼解。** 二擇一。兩個都留:把你的個人技能改名(資料夾名稱,以及 `SKILL.md` 裡的 `name:`)。只留你的:刪掉 `.claude/skills/` 底下那個 UDS 技能資料夾。
|
|
101
|
+
|
|
102
|
+
替新的 UDS 技能取名以避免撞名,屬於貢獻者的事:見 `skills/SKILL_NAMING.md`。
|
|
103
|
+
|
|
104
|
+
---
|
|
105
|
+
|
|
60
106
|
## 步驟 3 — 你的第一份 Spec(`/sdd`)
|
|
61
107
|
|
|
62
108
|
在寫程式碼之前,先建立一份 spec:
|