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
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
source: ../../../templates/reverse-spec-template.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: 757daa9f44a3
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
@@ -197,6 +198,33 @@ status: current
|
|
|
197
198
|
|
|
198
199
|
---
|
|
199
200
|
|
|
201
|
+
## E2E 场景(必填)
|
|
202
|
+
|
|
203
|
+
> 定义用户或调用者视角的端到端场景。至少填写 1 条 Happy Path。
|
|
204
|
+
> 若确实不需要 E2E,填写 `e2e_not_required_reason` 并留空 Scenarios 区块。
|
|
205
|
+
|
|
206
|
+
**e2e_not_required_reason**(若 Scenarios 为空,此栏必填):
|
|
207
|
+
<!-- 有效理由:纯内部工具函数 | 已被 SPEC-NNN E2E 涵盖,见 [SPEC-NNN] -->
|
|
208
|
+
<!-- 无效理由:「之后再补」「现在没空」 -->
|
|
209
|
+
|
|
210
|
+
### Happy Path: [场景名称]
|
|
211
|
+
|
|
212
|
+
```gherkin
|
|
213
|
+
Given [用户或系统状态前提]
|
|
214
|
+
When [触发动作或 API 调用]
|
|
215
|
+
Then [可观察的预期结果:HTTP status、数据库状态、响应 body]
|
|
216
|
+
```
|
|
217
|
+
|
|
218
|
+
### Error Path: [场景名称](建议:安全相关、Quota、计费功能必填)
|
|
219
|
+
|
|
220
|
+
```gherkin
|
|
221
|
+
Given [异常前提条件]
|
|
222
|
+
When [触发动作]
|
|
223
|
+
Then [预期错误处理:status code、错误消息、无副作用]
|
|
224
|
+
```
|
|
225
|
+
|
|
226
|
+
---
|
|
227
|
+
|
|
200
228
|
## 验收标准
|
|
201
229
|
|
|
202
230
|
### 从测试提取
|
|
@@ -275,6 +303,27 @@ status: current
|
|
|
275
303
|
|
|
276
304
|
---
|
|
277
305
|
|
|
306
|
+
## 假设与待解问题
|
|
307
|
+
|
|
308
|
+
### 假设
|
|
309
|
+
|
|
310
|
+
| # | 假设 | 影响范围 | 验证方法 | 状态 |
|
|
311
|
+
|---|------|----------|----------|------|
|
|
312
|
+
| A1 | [假设] <!-- 描述假设 --> | <!-- 受影响区域 --> | <!-- 如何验证 --> | 未验证 |
|
|
313
|
+
|
|
314
|
+
<!-- 范例:
|
|
315
|
+
| A1 | [假设] 认证中间件在请求到达 controller 之前验证 JWT | AuthController, UserController | 检查 app.ts 中的中间件链 | 未验证 |
|
|
316
|
+
| A2 | [假设] 所有查询模式都有对应的数据库索引 | 性能 | 对常用查询执行 EXPLAIN | 未验证 |
|
|
317
|
+
-->
|
|
318
|
+
|
|
319
|
+
### 待解问题
|
|
320
|
+
|
|
321
|
+
| # | 问题 | 受影响区域 | 负责人 | 期限 |
|
|
322
|
+
|---|------|------------|--------|------|
|
|
323
|
+
| Q1 | [需确认] <!-- 问题 --> | <!-- 区域 --> | <!-- 谁 --> | <!-- 何时 --> |
|
|
324
|
+
|
|
325
|
+
---
|
|
326
|
+
|
|
278
327
|
## 范围外
|
|
279
328
|
|
|
280
329
|
[未知] **需要人类输入**
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../CHANGELOG.md
|
|
3
|
-
source_version: 6.
|
|
4
|
-
translation_version: 6.
|
|
5
|
-
last_synced: 2026-
|
|
3
|
+
source_version: 6.14.0-beta.10
|
|
4
|
+
translation_version: 6.14.0-beta.10
|
|
5
|
+
last_synced: 2026-10-12
|
|
6
6
|
status: current
|
|
7
7
|
---
|
|
8
8
|
|
|
@@ -17,6 +17,214 @@ status: current
|
|
|
17
17
|
|
|
18
18
|
## [Unreleased]
|
|
19
19
|
|
|
20
|
+
## [6.14.0-beta.9] - 2026-10-10
|
|
21
|
+
|
|
22
|
+
> **測試版**——以 `npm install -g universal-dev-standards@beta` 安裝。要測什麼、如何退回正式版:[docs/PRE-RELEASE.md](../../docs/PRE-RELEASE.md)。
|
|
23
|
+
>
|
|
24
|
+
> **行為改變:**對不存在的規格執行 `uds spec delete <id>`,現在不先詢問,直接以結束碼 1 結束。
|
|
25
|
+
|
|
26
|
+
### Fixed
|
|
27
|
+
|
|
28
|
+
- **`uds spec delete` 先說規格不存在再問要不要刪;`uds spec split` 在 `**Confirmed**` 前保留空行;`uds check` 與 `uds update` 的 error-exit 閘門提示改隨介面語言(6.14.0-beta.8 macOS 人工驗收時發現)。** 刪除不存在的規格 ID,過去會先問「要刪除嗎」,答 yes 後才印「找不到規格」;現在直接印「找不到規格:<id>」並以 1 結束,不再詢問。`uds spec split` 寫出的新規格,`**Confirmed**: No` 原本緊貼最後一條驗收條件,現在中間保留空行。`uds check`(「[error-exit] 沒有錯誤訊息單一出口檢查」)與 `uds update`(詢問是否寫入 `scripts/check-error-exit.mjs`)過去不論介面語言一律印繁體中文,現在與 CLI 其他部分一樣依介面語言顯示英文、繁體中文或簡體中文。閘門腳本本身(`templates/gates/check-error-exit.mjs`)仍印中文,本版未改。
|
|
29
|
+
- **CI:發版後驗收改為等待 `npm install` 實際讀取的文件,版本尚未可見時重試安裝(XSPEC-471 R1)。** 6.14.0-beta.8 發布後,`wait-for-npm.mjs` 在單一版本文件回 200 時就宣告找到,但緊接的 `npm install` 在前三個工作失敗(0 步執行)——`npm install` 讀的是套件總覽文件,當時尚未更新。現在依序確認套件總覽列出該版本、tarball 可取得、`npm view` 看得到;`run.mjs` 遇到 E404/ETARGET 會重試安裝(最多 5 次,間隔 5/10/20/40 秒,180 秒後不再開始新的嘗試),並把重試次數記進報告。其他安裝錯誤仍立即失敗。`--install-retries <n>` 與 `--install-retry-wait <sec>` 可調整上限。屬維護者工具,不在 npm 套件內。
|
|
30
|
+
|
|
31
|
+
## [6.14.0-beta.8] - 2026-10-10
|
|
32
|
+
|
|
33
|
+
> **測試版**——以 `npm install -g universal-dev-standards@beta` 安裝。要測什麼、如何退回正式版:[docs/PRE-RELEASE.md](../../docs/PRE-RELEASE.md)。
|
|
34
|
+
>
|
|
35
|
+
> **行為改變:**`uds hitl check` 無人可答時拒絕(結束碼 1);`uds release verify` 失敗以 1、無法驗證以 2 結束;`uds release promote` 不再為沒做的事印「✓」;移除 `uds mcp serve --root`;沒有終端機時 `uds spec delete/split` 以 2、`uds spec create` 以 0 結束;`uds uninstall` 只移除 UDS 寫的、你沒改過的檔。
|
|
36
|
+
|
|
37
|
+
### Added
|
|
38
|
+
|
|
39
|
+
- **CI:uds CLI 的每個指令、子指令與選項都要有驗收步驟,而且步驟必須讀回效果,不能只看結束碼(XSPEC-471 R2、R3)。** `node scripts/beta-acceptance/check-cli-coverage.mjs`(CI 工作「Beta Acceptance Coverage」)載入真正的 `cli/bin/uds.js`,記錄它建出的 commander 程式(含隱藏指令、隱藏選項與別名;不讀說明文字),當 `scripts/beta-acceptance/steps.json` 的任何步驟都沒用到某個指令、子指令或選項時,逐一列名並使 CI 變紅,並印出已用、豁免與缺少各幾個。要豁免只能在 `exemptions` 加 `{"command": ...}` 或 `{"option": ...}`,並附至少 20 字元的理由;空白或單字理由等於沒有豁免。加入這項檢查時已存在的缺口(31 個指令與子指令、115 個選項)列在 `scripts/beta-acceptance/coverage-baseline.json`,這份檔案只能減少:不在其中的缺口會紅,已被步驟用到的項目若沒移除也會紅(`--shrink-baseline`),所以檔案不會腐爛;`--baseline-not-larger-than <ref>` 會讓新增項目的變更變紅。`check-steps.mjs` 現在也會指名 `expect` 只有結束碼的步驟(含人工步驟;`{"step": ..., "reason": ...}` 可豁免一個步驟)。**未驗證**:CI 接線只由 YAML 解析器與測試讀過,尚未由 GitHub 實際執行。
|
|
40
|
+
- **CI:`scripts/bump-version.mjs` 遇到不帶預覽標記的版號,除非它最近一個預覽版已在三個平台驗收通過,否則拒絕(XSPEC-471 R5)。** 在改動任何檔案之前,它先確認:`scripts/beta-acceptance/reports/<預覽版>/` 有 Windows、macOS、Linux 三個平台、來自已發布套件的報告(用 `--local-bin`、`--source` 或注入的安裝器做出的報告不算;同一平台從多種殼層跑過時,每一種都要看,取最差的),其中沒有任何自動步驟失敗,`check-cli-coverage.mjs` 與 `check-steps.mjs` 為綠、`coverage-baseline.json` 為空,目前 `steps.json` 的每一步都在這些報告裡(預覽版發布之後新增的步驟需要更新的預覽版),而且 `steps.json` 沒有任何豁免寫明功能「已知壞掉」(R4 的寫法 "known broken",`已知壞掉` 也會讀)。缺的東西會在一次拒絕中全部列出,結束碼為 1。沒人確認的人工步驟會列出,但不擋。預覽版號不檢查。這道關卡沒有跳過的開關,連 `SKIP_BUNDLE_PARITY` 也管不到:修補版先以預覽版發出,發版後的驗收會自動跑。規則在 `scripts/beta-acceptance/lib/stable-gate.mjs`。
|
|
41
|
+
|
|
42
|
+
### 變更
|
|
43
|
+
|
|
44
|
+
- **行為變更——`uds release verify` 驗證失敗時改以結束碼 1 結束,無法驗證時以 2 結束(XSPEC-471 R4)。** 它印出「Manifest 驗證失敗」後仍以 0 結束,把驗證當作發布關卡的腳本或 CI 步驟會把每一次失敗都讀成通過。結束碼 0 表示 manifest 驗證通過;1 表示 commit 或 artifact 的 checksum 與 manifest 的紀錄不符;2 表示根本無法驗證:沒有 `build-manifest.json`、檔案不是合法 JSON、`--artifact` 指的檔案不存在,或發布模式(`ci-cd`)沒有 `verify`。分法與 `uds hitl check` 相同(1=答案是否,2=沒有答案)。缺少 staging 結果仍只是警告,不改變結束碼。若有腳本一直假設 `uds release verify` 必回 0,請處理 1 與 2。
|
|
45
|
+
- **`uds release promote <版本>` 不再為它沒做的事印出「✓ 晉升紀錄建立」與「✓ Git tag」(XSPEC-471 R4)。** 這個指令不寫晉升紀錄、也不建 tag,只印出文字;相信那些勾號的人可能把一個從未打過 tag 的版本拿去部署。現在它明說「這個指令不會建立晉升紀錄,也不會建立 Git tag」,並列出要你自己執行的下一步,包含 `git tag v<版本>`。沒有新增任何行為:它仍然什麼都不寫、什麼 tag 都不建。
|
|
46
|
+
- **行為變更——移除 `uds mcp serve` 的 `--root <path>` 選項(XSPEC-471 R4)。** 它被接受並存起來,但沒有任何程式讀它,所以 `--root /elsewhere` 不改變任何回答,卻看起來像在指定標準從哪裡來。伺服器照舊從已安裝的套件讀 UDS 隨附的檔案。`uds mcp serve --root <path>` 現在會以 `error: unknown option '--root'` 與結束碼 1 停下;請從任何傳入它的 MCP 用戶端設定中移除這個選項。
|
|
47
|
+
|
|
48
|
+
### 修正
|
|
49
|
+
|
|
50
|
+
- **`uds mcp serve`:`get_design_standards` 與 `get_design_token` 的 DESIGN.md 範本後備,在每一種安裝方式下都回 ENOENT(XSPEC-471 R4)。** 伺服器去「`cli/src/mcp/` 往上四層」找 UDS 隨附的檔案,那個位置在 repository 之外,已安裝的套件也一樣在套件之外。現在改找套件的 `bundled/` 資料夾,在原始碼檢出時則找 `cli/` 的上一層。伺服器的單元測試把檔案系統換掉了,所以從沒看到;新增的端對端測試會啟動真正的 `uds mcp serve` 並讀回回應。
|
|
51
|
+
- **`uds release deploy <env>` 在「`release-config.yaml` 是 UDS 自己產生」的專案裡,拒絕每一個環境(XSPEC-471 R4)。** `uds init` 與 `uds config` 把 `release.environments` 寫成物件(`- name: staging`),檢查卻拿使用者輸入的名稱去比那些物件,於是說「未知的環境」並列出 `[object Object]`。現在物件形式與純名稱都讀得懂。
|
|
52
|
+
- **`uds agent list` 與 `uds agent info` 顯示空白的說明,也沒有專長、工具、技能(XSPEC-471 R4)。** 代理檔是 YAML(`description: |`、清單),讀取程式一次只看一行 `key: value`,把說明看成 `|`。現在 front matter 以 YAML 解析。
|
|
53
|
+
- **行為變更——`uds hitl check` 在無法詢問時不再以結束碼 0 結束(XSPEC-471 R4)。** 沒有終端機可回答、也沒有 `CI` 變數時,高風險的 `--op` 會開一個永遠等不到回答的提示,印出堆疊追蹤後以 0 結束,腳本會把它當成「已核准」。現在印出「Blocked (Safety First)」與「Denied」並以 1 結束,與 CI 下相同。`uds hitl check` 沒給 `--op` 時以 2 結束(原本是 0)。
|
|
54
|
+
- **`uds list` 只顯示它所計算的 163 個標準中的 81 個,而且拒絕 `--category core`(撰寫 XSPEC-471 R4 驗收步驟時發現)。** 「Total」行計入登錄檔中的每一個標準,但列表只走固定的五個分類,所以 `core`、`testing`、`security`、`deployment`、`operations` 這五個分類裡的 82 個標準被計入卻從未顯示,`uds list --category core` 還回答「Unknown category」。現在列表會顯示登錄檔裡有標準的每一個分類,每個分類各有標題與數量,標題上的數字加起來等於 Total;這五個分類已宣告在 `cli/standards-registry.json`(並註明它們不由 `uds init` 安裝,要用 `uds update --apply --add-standard` 依編號加入),日後登錄檔新增的分類會以它自己的名稱列出,不會再被丟掉。「有效分類」提示現在列出全部十個。標題與 Total 不一致時 `npm test` 會失敗。
|
|
55
|
+
- **`uds quickstart`、`uds spec create`、`uds spec delete`、`uds spec split` 在沒有任何東西能回答它們的問題時,以 Node 堆疊追蹤結束,且結束碼為 0(撰寫 XSPEC-471 R4 驗收步驟時發現)。** 在沒有終端機的環境(AI 助理、CI、管線)執行時,它們畫出問題後就死在 `ExitPromptError`,整次執行看起來像成功。`uds update` 與 `uds uninstall` 早先已用同樣方式修正。現在:`uds quickstart` 印出四個流程與各自的指令(這份指南本來的工作就是列出指令);沒給 `--yes` 的 `uds spec create` 把已寫好的規格留作草稿並說明如何確認(結束碼 0);沒給 `--yes` 的 `uds spec delete` 什麼都不刪、說明要加 `--yes` 重跑,並以 2 結束(原為 0);`uds spec split` 什麼都不改、說明要在終端機執行,並以 2 結束(原為 0)。有終端機時行為不變。
|
|
56
|
+
- **驗收步驟 `init-locale-pack-missing-is-said` 在任何跑過 `prepack` 的 checkout 上,用 `run.mjs --local-bin cli/bin/uds.js` 會失敗(XSPEC-471 R5)。** 它以 `cli/bundled/` 是否存在來分辨已發布套件與原始碼 checkout,但原始碼 checkout 在 `prepack` 之後也有那個資料夾,於是「缺少 zh-TW 技能文字」的複本被建在 repository 根目錄,`skills-installer.js` 照樣在那裡找到 `locales/zh-TW`,裝了中文技能。現在步驟改問 `locales/zh-TW` 是否在 `cli/` 旁邊。已發布的套件從未受影響,`uds init` 也沒有。
|
|
57
|
+
|
|
58
|
+
## [6.14.0-beta.7] - 2026-10-08
|
|
59
|
+
|
|
60
|
+
> **測試版**——以 `npm install -g universal-dev-standards@beta` 安裝。要測什麼、如何退回正式版:[docs/PRE-RELEASE.md](../../docs/PRE-RELEASE.md)。
|
|
61
|
+
>
|
|
62
|
+
> **行為改變:**`uds init` 與 `uds init --yes` 會把 UDS 技能裝進專案;`uds init` 的命令約定步驟保留 `uds.project.yaml` 其餘內容;`uds skills` 輸出文字改變;`uds open-work next-action` 在唯一的違規是 OWT-022 判定完整的「已詢問、等回覆」列時以 0 結束(原為 1)。
|
|
63
|
+
|
|
64
|
+
### 新增
|
|
65
|
+
|
|
66
|
+
- **`uds update` 現在會說出 UDS 有出貨、專案沒有的標準,`--add-standard <id>` 可以挑著裝(XSPEC-458)。** 用舊版 UDS 設定的專案只保有 manifest 列出的標準,所以 `uds update --apply` 會回報「已是最新」,之後新增的標準(例如 `open-work-tracking`)卻從沒裝上,也沒有任何東西告訴你。現在:`uds update --plan` 結尾會印「上游有、專案沒裝(N 個)」並依類別分組,沒有時印「沒有」;`--apply` 結尾印出數量與指令;`uds check` 印一行「上游有 N 個標準未安裝」;`uds audit --friction` 列出一項低嚴重度發現。這些都不會改變計畫的動作、判定、結束碼或 `uds audit --score`。`uds update --plan|--apply --add-standard <id>`(可重複)會安裝標準並記入 `manifest.standards`,所以下一次 `--apply` 不會把它當多餘而刪;一次 `--rollback` 就能移除。未知的 id 以 1 結束並列出最相近的 id;已安裝的 id 說明後以 0 結束;`extension`、`integration`、`template`(由語言、工具、範本的選項安裝)會被拒絕並說明原因。「可用」的定義是:類別為 `reference` 或 `skill`、在專案格式下有來源檔、manifest 裡沒有同名檔案——舊的 `uds update` 路徑、`--plan`/`--apply`、`check`、`audit` 共用這一個定義。其他類別(`core`、`testing`、`security`、`deployment`、`operations` 等)`uds init` 從沒裝過,只以一行計數、不逐項列出;它們仍可用 id 指名安裝。規則與死欄位(`level`、`profile`)見 [docs/AVAILABLE-STANDARDS.md](../../docs/AVAILABLE-STANDARDS.md)。
|
|
67
|
+
- **CI:標準孤兒矩陣(XSPEC-458 R4)。** `npm run check:orphan-matrix` 替登記表 163 個標準各記五欄是或否(`uds init` 是否安裝、產生的索引是否提到、是否有技能包裝、是否有檢查、是否被 workflow/hook/技能呼叫),五欄全空的標準,以及沒有任何呼叫者的 `check-*` 腳本,都會讓它失敗。第一次執行找到 78 個孤兒標準與 2 個沒人呼叫的檢查腳本,已逐項附上理由與處理者列在 `cli/scripts/orphan-matrix-allowlist.json`,該清單於 2026-12-31 到期,條目不再是發現時也會失敗。另新增升級測試:用目前的 CLI 對照真正的 6.11.0 寫出的 manifest。
|
|
68
|
+
- **`open-work-tracking` 1.2.0——「還沒問」與「已問、等回覆」成為兩個有名字的狀態,且對沒有任何東西能推導的事實容許手寫列(OWT-020~OWT-026,XSPEC-459)。** 草擬了從沒送出的訊息,與已送出、沒人回的訊息看起來一模一樣;助理無法觀察的事實(有沒有寄出、對方有沒有回、有沒有核准)沒有被認可的地方可以寫。OWT-020~OWT-022 為 `not-yet-asked`(必須點名草稿或動作)與 `asked-awaiting`(必須帶 `asked-at`、在等什麼、解除事件)命名;兩者皆非的等待項目被逐項點名、絕不算成已完成。OWT-023~OWT-026 只對這類事實容許手寫列,必須有 `observed-by`、`observed-at` 與 `yes`/`no`/`unknown` 的值——`unknown` 單獨計數、單獨顯示、永遠不算完成,每筆觀察的年齡都印出來,超過門檻的回報為「觀察已舊」且絕不算已確認。這個例外不及於版本控制、規格標記或 CI 結果已能決定的東西。七條要求全是 `warning`;詞彙(中英文)與「觀察已舊」預設的 7 天都未校準;檢查只判定欄位存在且格式正確,絕不判定觀察為真。「刻意不採納」表中「手寫狀態檔」那一列已改寫成如實描述這件事;OWT-003 不變。
|
|
69
|
+
- **`uds open-work waiting` 與 `uds open-work observations`**——對應的參考檢查。`--now` 注入今天的日期(規則絕不讀時鐘)、`--stale-after` 宣告門檻,結束碼與其他 `open-work` 指令相同:0 無違反、1 違反(`warning` 等級的違反也是 1,與 OWT-019 相同)、2 判定不了。`uds open-work self-test` 現在對 OWT-020~OWT-026 每一條各跑一個違反與一個符合的樣本。`next-action`、`revision`、`separation` 印出的內容與 1.1.0 逐位元組相同(21 次執行、16 份載體逐位元組比對,含中文表頭的表格)。
|
|
70
|
+
- **`uds check` 在 UDS 技能裝了兩次時警告(XSPEC-462 R2)。** 專案裡有 UDS 技能(`.claude/skills/`),同時又從 Claude Code 市集裝了 UDS 外掛時,Claude Code 會把每個技能列出兩次(`/commit` 與 `/universal-dev-standards:commit`),而且每個技能的名稱與描述每回合都會放進脈絡。`uds check` 現在會說出這件事,並說明怎麼二擇一。純資訊:不改變判定與結束碼;任何一邊不存在、或讀不到 `~/.claude/plugins/installed_plugins.json` 時不出聲。
|
|
71
|
+
- **CI:外掛設定不得寫錯技能數(XSPEC-462 R3)。** `npm run check:plugin-manifest` 在 `.claude-plugin/plugin.json`、`marketplace.json` 或 `README.md` 的描述寫出的技能數,與 `skills/` 底下含 `SKILL.md` 的資料夾數不同時失敗。描述裡沒有數字則通過。
|
|
72
|
+
- **文件:`docs/user/GETTING-STARTED.md` 新增「技能怎麼裝」(XSPEC-462 R3)。** 並列兩種裝法與各自的限制、為什麼 `uds check` 與 `uds update` 建議 `uds update --apply --skills`、兩者都裝時怎麼辦(英文、繁體中文、簡體中文)。
|
|
73
|
+
- **`pipeline-security-gates` 1.1.0——pre-commit 機密掃描現在寫明掃描器自己的三個行為(PSG-1~PSG-3,XSPEC-463)。** 標準原本寫了閘門掃什麼、阻斷什麼,沒寫掃描器本身必須怎麼表現。第 1.1 節新增:PSG-1(必須)掃描輸出——終端機、CI 紀錄、報告檔——不得含被匹配到的機密值,只能指出檔案、行號與規則名稱;PSG-2(必須)掃描器跑不起來(執行檔不存在、設定檔無法讀取或無效、逾時、非預期的結束)視同閘門失敗並阻斷,不得以 `|| true` 或 `2>/dev/null` 吞掉;PSG-3(建議)團隊自己撰寫的偵測規則,每條都有一個紅樣本與一個綠樣本,且在測試中執行。三條各附採用者在自己的閘門上跑的三行判定程序;PSG-1 的程序第一步要求先證明閘門真的阻斷,所以沒有任何規則匹配的樣本無法讓它通過。工具註記只寫在廠商自己文件讀到的內容:gitleaks 的 README(2026-10-07 讀取)範例輸出在未加 `--redact` 時印出 `Secret:` 一行,且結束碼 1 同時代表「找到洩漏」與「發生錯誤」;detect-secrets 與 trufflehog 標示「採用者須自行確認」。UDS 不出貨掃描器,自己的 CI 與 hook 也沒有,標準本文已寫明。機器可讀:`.ai.yaml` 的 `gate_positions.pre_commit.output_redaction`、`.scanner_failure`、`.custom_rule_samples`;登記表描述與兩個譯本已同步,`meta.updated` 標為 2026-10-07。
|
|
74
|
+
- **`open-work-tracking` 1.3.0——等待可以點名另一個專案裡的物件,這台機器看不到的專案被單獨計數(OWT-027~OWT-029,XSPEC-460)。** 彼此相依的專案,過去沒有辦法說「這個項目在等那個專案的產出」。OWT-027 讓解除條件可以寫成 `<專案>:<物件>`:專案是**邏輯名稱**(`uds`、`vibeops`),絕不是目錄;物件是檔案路徑、測試名稱、指令、需求編號或版本控制標籤;載體裡出現機器專屬的絕對路徑(家目錄或磁碟區目錄、磁碟機代號、`~/`),或離開對方專案的路徑,即違反。名稱在某台機器上對應哪裡,宣告在載體之外。OWT-028:對每個這樣的條件,`uds open-work waiting` 說四種話之一並單獨計數:**已解除**(該路徑或標籤現在在那邊存在)、**尚未解除**、**從這裡看不到**(專案不在這台機器上、目錄不存在、或讀不到它的 git 標籤:不是已解除,也不是零)、**需要人判斷**(另一個專案裡的測試名稱、指令、需求編號,沒有任何檢查讀得到的東西)。它只讀這台機器上的檔案與 git,不連網。在等另一個專案之物件的項目,免於 OWT-020 的「有沒有問過」,並在自己那一行計數(`waiting-cross-project`)。OWT-029 說這類工作的紀錄放在每個相關專案的 session 都讀得到、受版本控制的 repo,不只放在某個人的 AI 工具記憶;檢查不判定載體放在哪。涵蓋的是一個人在一台機器上的各個 session,人與人之間的共享不在這版決定。三條都是 `warning`,且未校準。
|
|
75
|
+
- **`uds open-work waiting --root NAME=DIR`(可重複)與 `uds.project.yaml` 的 `open_work`。** 它一直接受的單一 `--root DIR` 行為與之前完全相同(用 1.2.0 檢查的凍結輸出逐位元組比對 14 次執行;第二個沒有名稱的 `--root` 現在會被拒絕,而不是被誤讀)。`--root NAME=DIR` 說明另一個專案在哪裡;`uds.project.yaml` 的 `open_work.projects` 不必打字就說同一件事,相對目錄以該檔所在目錄為基準,同一個名稱兩邊都有時以命令列為準。讀得到的檔案、但 `open_work` 區段格式不對,指令以 2 停下;完全讀不了的檔案只提示一句、指令繼續。同一個 `open_work` 區段也放 `next_action_words`(見下),所以兩件事共用一個設定命名空間。
|
|
76
|
+
- **`uds open-work next-action` 認得更多人們說「下一步」的詞、讓專案宣告自己的詞,並說清楚為什麼回 2(XSPEC-461)。** 一位使用者的載體一個狀態一張表,得到結束碼 2 卻沒被告知原因。現在 `下一個動作`、`下一個步驟`、`接下來要做什麼` 也會被讀到,與標題、表頭、行內標籤共用同一份清單。`待辦`、`後續`、`Next`、`TODO`、`Action` 與單獨的 `接下來` 刻意**不**加入(它們也標在不是下一步的欄位上),並有回歸測試釘住。`--next-action-word <詞>`(可重複;`separation` 也接受)與 `uds.project.yaml` 的 `open_work.next_action_words` 把詞加進同一份清單;詞是純文字、不分大小寫、絕不是正規表達式,空白的詞會被拒絕並以 2 結束。找不到任何欄位時結束碼仍是 2,文字現在會逐載體列出它看到的表頭與標題(約 20 個,其餘寫「還有 N 個」)、認得的詞(宣告的另列)、怎麼加,以及該載體是有表格但表頭都不符、還是根本沒有可讀的東西。`glab` 與 `dotnet` 現在是內建指令(有使用者寫的 `glab mr merge 486` 被讀成什麼都沒點名);`go`、`make`、`sh` 刻意不內建。`--command-word <程式名>`(可重複)與 `open_work.command_words` 可加入程式,`next-action` 與 `waiting` 都讀得到——`waiting` 以前問「這份草稿有沒有點名動作」時讀不到它們。`next-action` 現在也會說路徑是在哪個目錄下查找的、那個目錄來自 `--root` 還是目前目錄,載體在所有 git repo 之外又沒給 `--root` 時會明說,並把 `named-unresolved` 分成 `path-missing`(查過、不在)與 `not-resolvable`(指令、測試名稱、需求編號,從不查找);舊的計數行不變,新的兩個數字相加等於它。其餘既有載體上的 `next-action`、`revision`、`separation` 輸出不變:1.1.0 的凍結輸出仍逐位元組比對(拿掉新增的行之後),只有其中兩個「找不到欄位」的結束碼 2 案例變長,原文仍是它們的開頭。
|
|
77
|
+
- **`developer-memory` 與 `project-context-memory` 的邊界說明(兩者都是 1.2.1,XSPEC-460 R5)。** 個人、跨專案、可識別的資訊(誰負責什麼、怎麼連到某個環境)不是這裡的記憶條目:它們屬於使用者自己的 AI 工具記憶。專案之間的協調(誰在等誰)是開放工作,不是記憶,並指向 `open-work-tracking`。這兩份標準的 zh-TW 與 zh-CN 譯本本來就落後(1.0.0 與 1.1.0),現在仍然落後;只在它們裡面加了這一段。
|
|
78
|
+
- **`uds check` 在個人技能與專案裡裝的 UDS 技能同名時警告(XSPEC-465 R1)。** Claude Code 對同一個名稱只執行一個技能,而且個人層(`~/.claude/skills/`)優先序高於專案層(`.claude/skills/`,`uds init --skills-location project` 與 `uds update --apply --skills` 把 UDS 技能裝在這裡),所以採用者自己的 `plan`、`push` 或 `commit` 會靜默蓋掉 UDS 那個:沒有錯誤、沒有訊息。`uds check` 現在會比對兩個資料夾、點名每一組、說明執行的是個人那個,並說明怎麼解(把你的技能改名,或刪掉 UDS 那個);`uds init` 與 `uds update --apply --skills` 在安裝結尾印同一則警告。名稱是 `SKILL.md` frontmatter 的 `name:`,沒有就用資料夾名稱,兩者都會比對(資料夾名稱同樣能叫出技能)。只是資訊:有無 `--ci` 都不改變判定與結束碼;個人資料夾不存在、不是資料夾、讀不到或 `SKILL.md` 壞掉時,不印任何東西也不失敗;UDS 自己裝在使用者層的副本(`~/.claude/skills/.manifest.json` 的 source 是 `universal-dev-standards`)與「專案就是家目錄」的情況不列入。**它看不到企業層,也看不到它執行之後才新增的個人技能,文字裡也這樣說:沒有警告不等於沒有撞名。** 外掛技能(`/<外掛名>:<技能名>`)與 `.claude/commands/` 檔不列入。(英文、繁體中文、簡體中文。)
|
|
79
|
+
- **文件:`docs/user/GETTING-STARTED.md` 新增「個人技能與 UDS 技能同名時」,`skills/SKILL_NAMING.md` 新增命名規則 6(XSPEC-465 R3)。** 同一個名稱出現在多處時哪個技能執行(Claude Code 技能文件,2026-10-07 讀取)、這對名稱通用的 UDS 技能(`plan`、`push`、`sweep`、`orchestrate`)意味著什麼、怎麼用 `uds check` 看見、怎麼解。UDS 不為此替已出貨的技能改名(改名會破壞所有既有呼叫);新技能應避免單一通用單字。(英文、繁體中文、簡體中文;命名規則與該檔一樣是中文。)
|
|
80
|
+
- **`open-work-tracking` 1.4.0——已問、等回覆的項目由 OWT-022 判定,不由 OWT-019 判定(XSPEC-464)。** 一位使用者的 17 個下一步中有 14 個是「等對方回信、等排時間、等撤銷」;`uds open-work waiting` 接受這些列,`uds open-work next-action` 卻拒絕同一批列,因為「等回信」沒有點名任何檔案、指令、測試或編號。現在,處於 `asked-awaiting` 且 OWT-022 認為齊全的列(真的 `asked-at`、不在未來、寫了在等什麼、寫了什麼解除它)是 OWT-019 的第四種結果 `waiting-on-reply`:不是違反、不算已點名、不算完成,在自己的一節裡列出並顯示年齡,超過 `--stale-after`(預設 7 天,未校準)標為 STALE。它不是藏身處:缺三者之一的列、`not-yet-asked` 的列、其他狀態的列、寫成小節標題的下一步、沒有狀態欄的載體,判定與過去完全相同。`next-action` 以 `waiting` 所用的同一個函式讀這一列的狀態,所以兩者不可能對同一列給出相反的結論;一個自測臂與一個涵蓋中英文列的屬性測試守著這件事。`uds open-work next-action` 新增選項 `--now` 與 `--stale-after`;`waiting-on-reply=N` 只在 N 不為 0 時才附在計數行尾。沒有新的要求編號。凍結的 1.1.0 與 1.2.0 輸出仍逐位元組吻合。檢查只判定這三個欄位存在且格式正確,判定不了請求是否真的送出。
|
|
81
|
+
- **`open-work-tracking` 說明 OWT-007 的摘要可以由程式印出、完整版按需取得(XSPEC-465 R2)。** OWT-007 從未說摘要由誰產生、多長。新小節說明便宜的做法(回合結束時由程式印出簡短摘要,完整版在被要求時才產生,模型不花 token)與昂貴的做法(模型在每則回覆裡附一張完整的表,可行但不是要求),第一種仍適用 OWT-008 與 OWT-009,並以「建議」的身分提出摘要的分類詞彙(等決策、等外部回覆、等 CI、固定日期到期、無人看管),直說 UDS 沒有出貨任何產生這種摘要的程式、本標準也沒有東西檢查它存在。沒有新的要求編號,也沒有新的檢查。
|
|
82
|
+
- **測試版驗收:一支程式在每一台機器上對已發布的套件跑驗收步驟(XSPEC-469 R2、R3)。** `node scripts/beta-acceptance/run.mjs --version <版本>` 把該版本從 npm 裝進拋棄式資料夾(不是 repository 原始碼),執行 `scripts/beta-acceptance/steps.json` 裡適用於本機作業系統的步驟——每一步有自己的資料夾與自己的拋棄式 home,不碰真正的 home——並寫出可整份貼回的 Markdown 報告與可比對的 JSON 報告:作業系統與版本、殼層、Node 與 npm 版本、Windows 主控台字碼頁(讀不到就寫「取不到」與原因,不留空)、UDS 版本,以及每一步的通過、失敗、略過(平台不符)或未確認,附輸出摘要。只用 Node 標準庫、不經殼層啟動程式,所以同一行指令在 PowerShell、cmd、Git Bash、zsh、bash 都能用。它是維護者工具,不進 npm 套件。結束碼 0=有步驟通過且沒有失敗;1=有步驟失敗;2=無法執行(安裝失敗、裝到別的版本、步驟檔格式錯誤);3=零個步驟通過——什麼都沒測到的執行絕不算通過。需要人眼的步驟(例如 cp950 主控台的中文顯示)會在終端機詢問,或讀 `--answers` 檔;沒有回答就記為「未確認」,不計入通過。`steps.json` 為下面每一條至少安排一步,另含 beta.6 的修正(那些修正從未在 Windows 上跑過)。這些步驟已對 beta.6 的原始碼與 `main` 的原始碼比對過(功能步驟在前者紅、後者綠),並對真正已發布的 beta.6 在 macOS 上跑過一次。**未驗證**:還沒有任何一步在真的 Windows 機器上跑過;beta.7 的執行是第一次。
|
|
83
|
+
- **CI:`[Unreleased]` 的每一條都要有驗收步驟,`docs/PRE-RELEASE.md` 改為產生(XSPEC-469 R1、R5)。** `node scripts/beta-acceptance/check-steps.mjs`(CI 工作「Beta Acceptance Coverage」)在 `[Unreleased]` 底下的 Added、Changed 或 Fixed 條目既沒有 `steps.json` 裡的步驟、也沒有寫明「無使用者可見行為」理由的 `exemptions` 項目時失敗,並指名那一條。步驟用條目的開頭(至少 20 字元)指名它:改條目後半段的措辭不影響,改開頭則條目與步驟一起變紅、各自被點名。`generate-pre-release.mjs` 由 `steps.json` 產生 `docs/PRE-RELEASE.md` 的「請幫忙測什麼」清單(不再手寫),並且只由 `scripts/beta-acceptance/reports/<版本>/` 的 JSON 報告填「已在哪些機器驗過」:沒有報告的平台寫「尚未驗證」;來自 `--local-bin`、`--source` 或注入安裝器、來自別的版本、或什麼都沒測到的報告,都不會填入任何一格。`--check`(同一個 CI 工作)在文件與產生結果不同時失敗。
|
|
84
|
+
- **CI:推送到 `main` 時,端對端測試在 ubuntu、windows、macos 各跑一次(XSPEC-469 R4)。** 原本只在 pull request 且只在 Ubuntu 跑,Windows 工作只跑單元測試。pull request 維持只跑 Ubuntu,且只在 `cli/**` 有變動時。推送到 `main` 的那次執行不再被下一次推送取消(pull request 的執行仍會),因為被取消的執行和被略過的一樣不算通過。用 bash 執行 `scripts/check-*.sh` 的四支測試在 Windows 上呼叫 `ctx.skip()`;工作的最後一步(`scripts/ci-vitest-summary.mjs`)把跑了多少、通過、失敗、略過多少寫進工作摘要,並在一支都沒跑時失敗(略過不等於通過)。**未驗證**:workflow 只被 YAML 解析器與測試讀過,GitHub 沒有跑過它,也沒有 `actionlint` 可用;第一次推送到 `main` 才是第一次實跑,只在 Windows 或 macOS 會紅的測試屆時會讓它變紅。
|
|
85
|
+
- **`check-anti-fake-tests` 現在也會點名「預期值不獨立於被測程式碼」的測試(XSPEC-470 R1)。** `full-coverage-testing` 過去只在斷言「永遠不可能失敗」(`expect(true).toBe(true)`)時才叫恆真式。預期值來自被測程式碼本身的測試同樣必然通過:`expect(total(items)).toBe(total(items))`,或 `expect(total(items)).toBe(items.reduce((s, i) => s + i.price, 0))`——同一套算式再打一遍,實作算錯時它跟著一起錯而照樣通過。`uds init` 寫到 `scripts/check-anti-fake-tests.mjs` 的掃描腳本現在把這兩種形狀都回報為 `tautology`(JavaScript/TypeScript:`toBe`/`toEqual`/`toStrictEqual`、chai 的 `to.equal`/`to.eql`、node 的 `assert.equal`/`strictEqual`/`deepEqual`/`deepStrictEqual`):兩側是同一個函式、同樣的參數;以及預期值把被測呼叫自己的輸入送進 `reduce`、`map`、`flatMap` 或 `filter`,且回呼只用到自己的參數、不含任何字面值;只讀斷言本身的文字,前面幾行設定過的名稱一律不展開。`--json` 輸出附上 `forms` 與每個斷言所在的行。**判不了就沉默**:動作前後的狀態比較、與第二份實作比對、名稱說明是決定性/冪等/快取/同一性的測試裡比較兩次呼叫、查寫死表格的預期值(`ids.map(id => PRICES[id])`)、用字面值挑資料(`users.filter(u => u.id === 2)`)、呼叫裡又有呼叫(`render(now())`、`parse(serialize(rows))`)、只把參數原樣回傳或淺複製的回呼(`rows.map(r => r)`、`users.map(u => ({ ...u }))`、`pairs.map(([k, v]) => [k, v])`)、先存值、動作之後再比對(`const before = items.map(...); freezeCart(items); expect(pricesOf(items)).toEqual(before)`)、被測的值是結果的屬性(`sortUsers(users).length`)、沒有參數的呼叫、`new` 運算式、否定的比對,以及同一支測試裡還有別種斷言的情形(與 `expect(true).toBe(true)` 相同的「只有」規則)。在本儲存庫自己的 297 個測試檔(4,200 支測試)上沒有新增任何回報;第一版曾把「先前設定的名稱」當成「同一個呼叫」,回報了 6 支測試,全是正當的前後比對或決定性檢查,所以現在只讀寫在同一個敘述裡的內容。`full-coverage-testing` 1.3.0 把第二種恆真式定義為「斷言的預言(oracle)就是被測實作本身」,並指向 `verification-oracle`,不再另立一套獨立真值的定義;附一組好壞對照例,以及腳本判不了的情形該由審查者提出的問題。掃描腳本的自我檢查加入了新形狀與它們的相似物,所以被削弱過的腳本會以 `2` 結束,不會照跑。**誰會看到差異:** `uds init` 在本版之後寫入 `scripts/check-anti-fake-tests.mjs` 的專案;已存在的檔案絕不覆寫,想要這條規則請把 `templates/gates/check-anti-fake-tests.mjs` 複製過去。預設只警告;在 `.standards/test-policy.json` 設 `"mode": "block"` 時,新的回報可能擋下提交。**我們接受的兩個代價:** 拿參考實作當預期值的差分測試和教科書例一模一樣,會被點名(在同一支測試加一個對手算字面值的斷言,或把檔案列進 `ignore`);這條規則也很容易被繞過(把被測值包進 `Number(...)`、接 `.valueOf()` 或 `[0]`、或引數改成 `items.slice()`;對預期值做同樣的事仍會被點名),它是提醒審查者的線索,不是擋得住刻意規避的閘門。**該怎麼做:** 把重複的呼叫或重打的算式換成字面值或手算例;刻意為之的比較請放進名稱就在講這件事的測試。(XSPEC-470 R1)
|
|
86
|
+
- **`code-review-checklist` 1.6.0 與各 PR 範本要求每項變更寫明合併風險:雙向門或單向門,以及一個詞的影響範圍(XSPEC-470 R2)。** 雙向門合併後能輕鬆退回;單向門不可逆或很難退回(資料遷移、刪除、預設行為改變、結束碼改變、對外介面改名)。新增的檢查項 11 與審查者、作者的步驟都寫明:單向門必須在合併**之前**讓決定合併的人知情;`pr-review` 選項範本(1.1.0)與本儲存庫自己的 PR 範本都帶有這個欄位。檢查清單也請審查者確認測試的預期值獨立於被測程式碼。**誰會看到差異:** 複製 `pr-review` 範本或閱讀檢查清單的人;沒有任何程式強制執行。**該怎麼做:** 想要的話,把這個欄位加進你的 PR 範本。(XSPEC-470 R2)
|
|
87
|
+
|
|
88
|
+
### 變更
|
|
89
|
+
|
|
90
|
+
- 舊的 `uds update` 訊息「N new standard(s) available for your level」不再提到等級:沒有等級規則(manifest 的 `level` 是沒有任何程式讀取的殘值)。
|
|
91
|
+
- `uds audit --report` 不會把「可用標準未安裝」這項發現當成給維護者的回饋送出。
|
|
92
|
+
- **行為改變:`uds skills` 的輸出文字改了(XSPEC-462 R1)。** 專案層與使用者層安裝不再標 `(deprecated)`,外掛不再標 `(recommended)`,「手動安裝已棄用」與「建議:遷移到 Plugin Marketplace」兩段也拿掉了。取而代之的是,每次執行都以並列的兩種裝法收尾:裝進專案(`uds init --skills-location project`、`uds update --apply --skills`;支援多種 AI 工具、有繁體與簡體中文文字、跟著你裝的 UDS 版本走,含測試版),以及 Claude Code 外掛市集(只支援 Claude Code、只有英文文字、只跟正式版、專案內不放檔案)。「已棄用」這個字寫於 2026-01,與 `uds check`、`uds update` 一向建議的 `uds update --apply --skills` 互相矛盾。比對舊文字的腳本需要更新。(英文、繁體中文、簡體中文)
|
|
93
|
+
- **`uds update` 的「Skills 有可用更新」提示**,對專案層、使用者層與無法判定的安裝,現在說 `更新方式:uds update --apply --skills`。它原本稱這些安裝已棄用、指向一個泛用的外掛網址,並建議在技能資料夾裡 `git pull`。技能來自外掛時,現在寫出的市集名是 `asia-ostrich`(`/plugin marketplace update asia-ostrich`),不再是 `anthropic-agent-skills`。
|
|
94
|
+
- **行為變更——對「OWT-019 違反全都是 `asked-awaiting` 且 OWT-022 認為齊全的列」的載體,`uds open-work next-action` 回 0,不再回 1(XSPEC-464)。** 那些列現在是 `waiting-on-reply`。有其他違反的載體仍回 1;沒有狀態欄的載體與 1.3.0 的行為相同。
|
|
95
|
+
- **行為改變:`uds init` 與 `uds init --yes` 現在會把 UDS 技能裝進專案(XSPEC-462 之後的 XSPEC-468 R1)。** XSPEC-462 把「裝進專案」定為主要路徑,但 `uds init --yes` 偵測到 Claude Code 時仍選外掛、不寫任何技能檔;在沒有 AI 工具標記的資料夾則一個都不裝。既有腳本執行 `uds init --yes`,現在會多出 `.claude/skills/`(Claude Code;其他偵測到的工具各有自己的資料夾),`git status` 也會變長。互動提示預先勾選專案層,直接按 Enter 就會安裝。要維持舊結果,請明說:`uds init --yes --skills-location marketplace`(外掛:專案內不寫入任何技能檔,安裝結尾會說明技能從哪裡來、外掛做不到什麼、怎麼改裝進專案)或 `--skills-location none`。互動提示中,取消所有勾選即為略過。若已安裝 UDS 外掛,安裝結尾會印出與 `uds check` 相同的「技能裝了兩次」警告。`uds init --help` 中 `--skills-location` 的預設值現在是 `project`。
|
|
96
|
+
- **行為改變:`uds init` 的指令契約步驟不再整份重寫 `uds.project.yaml`(XSPEC-468 R5)。** 檔案已存在、你同意覆寫時,精靈原本以它詢問的四個指令整份重寫,其餘全部消失:`open_work:`(`uds open-work` 讀的設定)、`custom:`、註解。現在問題會列出會保留的區段,預設答案仍是否;答是時只改 `commands:` 底下的 `test`、`lint`、`build`、`security` 幾行(各題的預設值是檔內現有的值,留空就不動那一行),檔案其他位元組原樣保留。不是合法 YAML 的檔案無法只留一部分,所以問題會明說,並詢問是否整份取代。
|
|
97
|
+
- **文件與提示不再推薦外掛市集(XSPEC-468 R2)。** `docs/CLI-INIT-OPTIONS.md`、`docs/WINDOWS-GUIDE.md`、`docs/USAGE-MODES-COMPARISON.md`、採用指南與檢查清單、`uds init` 的提示文字與較舊的設計筆記,現在寫的是 XSPEC-462 的決定:裝進專案是主要路徑,外掛是替代方式,限制寫在旁邊(只支援 Claude Code、只有英文技能文字、只跟正式版、專案內不放檔案)。三語一致。3.2.x 的發行說明與本變更日誌仍照原樣引用當時的說法。`npm test` 現在會在 Markdown 檔或 CLI 自己的文字又推薦外掛時失敗,並指出檔名與行號。
|
|
98
|
+
|
|
99
|
+
### 修正
|
|
100
|
+
|
|
101
|
+
- **外掛設定裡的技能數是錯的(XSPEC-462 R3)。** `.claude-plugin/plugin.json` 寫「25 comprehensive skills」、`marketplace.json` 寫「23 skills」、`.claude-plugin/README.md` 列了 15 個,而外掛實際載入 56 個。描述不再帶數字,上面那個檢查會讓它維持這樣。
|
|
102
|
+
- **`uds open-work waiting` 把清單項目裡留白的欄位讀成被下面的 `Next action:` 那一行填滿了(做 XSPEC-464 時發現)。** 在清單項目裡,最後一個被認得的標籤的值會一路延伸到項目結尾,所以 `- release:` 留白、接著 `- Next action: wait for the vendor reply`,會被讀成有解除條件,OWT-022 於是放行一個沒寫解除條件的 `asked-awaiting` 項目。現在 `Next action:` 標籤(內建詞)會結束它前面那個值,本身也不再是欄位。缺解除條件、缺在等什麼或缺 `asked-at`、且下面有下一步那一行的清單項目,現在由 `waiting`(OWT-022)回報,`next-action` 也不再免除它;表格不受影響。
|
|
103
|
+
- **缺少中文技能文字的 UDS 會默默裝英文版(XSPEC-468 R3)。** `--locale zh-tw` 或 `zh-cn` 從套件的 `locales/` 資料夾取技能文字;那個資料夾不在時,原本一聲不響地複製英文技能並以 0 結束,與 XSPEC-451 的 `zh-CN` 變英文同一型態。現在 `uds init` 與 `uds update` 會說「這份 UDS 裡沒有 zh-TW 的技能文字,所以技能裝的是英文版」,說明原因是這份 UDS 不完整或已損毀而不是網路,並給出補救指令。安裝仍以英文繼續,不算錯誤。這些文字在 npm 套件內(zh-TW 約 4.6 MB、zh-CN 約 4.1 MB,由打包後的 tarball 量得),所以安裝它們不需要網路:安裝說明三語都寫了這一點。
|
|
104
|
+
- **`uds init` 與 `uds update` 在檔案只是被暫時鎖住時會重試複製,鎖不開時用白話說明(2026-10-08 的 Windows CI 發現)。** Windows 上防毒即時掃描、搜尋索引或雲端同步程式可能短暫佔住一個檔案;此時複製標準檔會以 `EBUSY: resource busy or locked, copyfile ...` 失敗,`uds init` 整個安裝因而回滾,但其實什麼都沒壞(`--locale zh-cn` 的端對端測試就在某次 CI 這樣失敗、下一次又通過)。現在複製標準檔與延伸檔(語系檔、語言或框架檔)時,最多重試 10 次,等待時間遞增(50 毫秒、100 毫秒……最多 500 毫秒;每個檔案約最多等 2.3 秒,硬上限 5 秒)。`EBUSY` 在所有平台都重試;`EPERM` 與 `EACCES` 只在 Windows 重試(防毒會造成它們),其他系統上它們是真正的權限錯誤,重試無用,仍立即失敗。鎖一直不放開時,安裝照舊回滾,訊息現在會點名是哪個檔、說明被其他程式鎖住、列出常見原因(防毒掃描、搜尋索引、雲端同步、編輯器),並建議關閉該程式或把資料夾加入防毒排除清單後重跑指令,原始錯誤碼也保留在文字中。本次重試**不涵蓋**其他寫入或複製檔案的地方(技能、hooks、`github.js` 的本機複製、舊式整合檔複製、更新計畫裡針對非標準檔與非延伸檔的直接複製、更新備份與還原、manifest 寫入),它們行為不變。`uds update` 因為用同一個函式複製標準檔而涵蓋在內,但測試驅動的是 `uds init`。
|
|
105
|
+
|
|
106
|
+
## [6.14.0-beta.6] - 2026-10-07
|
|
107
|
+
|
|
108
|
+
> **測試版**——以 `npm install -g universal-dev-standards@beta` 安裝。要測什麼、如何退回正式版:[docs/PRE-RELEASE.md](../../docs/PRE-RELEASE.md)。
|
|
109
|
+
>
|
|
110
|
+
> **行為改變:**`uds simulate` 對不可模擬的標準以 2 結束(原為 1);`uds update` 會從 manifest 移除 UDS 無法擔保的名稱;備份移到 `.uds-backups/`;`uds.project.yaml` 內雙引號的值依 YAML 解析。
|
|
111
|
+
|
|
112
|
+
> **行為改變:**`uds update` 的備份寫到 `.uds-backups/`,不再是專案根目錄的 `.uds-backup-*`;`uds simulate` 在無法得出結論時以 2(不是 1)結束,而且 `uds simulate -s commit-message` 改為在程序內判定,不再執行 `npx commitlint`;`uds update` 會把 UDS 無法擔保的技能與命令名稱從 `manifest.skills.names` / `commands.names` 移除;`uds run` 以 YAML 讀取 `uds.project.yaml`(不合法的 YAML 現在會失敗,空白後的 `#` 會結束一個值)。
|
|
113
|
+
|
|
114
|
+
### 變更
|
|
115
|
+
|
|
116
|
+
- **行為改變——`uds update` 的備份現在集中在單一資料夾 `.uds-backups/`,不再是專案根目錄下每一步一個 `.uds-backup-<時間>/`(XSPEC-456 R7)。** git 本來就看不到舊資料夾(每個都自己隱藏),但索引器、IDE 搜尋和 grep 不讀 `.gitignore`,把裡面你檔案的副本算成專案檔案。現在每份備份都是 `.uds-backups/<時間>-<NNNN>/`,`.uds-backups/` 帶一個內容為 `*` 的 `.gitignore`(不會改你自己的 `.gitignore`)。不讀 `.gitignore` 的工具請排除 `.uds-backups`,`uds update` 結束時會提醒。舊版 UDS 留在根目錄的備份不會搬動:`--rollback`、連續步驟之間的串鏈、清理與「最近五份」上限會同時看新舊兩處,依時間由新到舊。`uds uninstall` 仍然不碰備份。
|
|
117
|
+
|
|
118
|
+
### 修正
|
|
119
|
+
|
|
120
|
+
- **`uds run` 用手寫的逐行解析器讀 `uds.project.yaml`,行尾註解因此成了指令的一部分(XSPEC-456 R1)。** `test: dotnet test X.csproj # 90 tests pass` 執行時後面多了 `# 90 tests pass`;POSIX shell 會吃掉未加引號的 `#`,`cmd.exe` 不會。現在改以 YAML(js-yaml)讀取:空白後的 `#` 結束值、加引號的值保留 `#`、以引號參數結尾的指令保留最後的引號。不合法的 YAML 會回報行號;注意 YAML 的雙引號值裡反斜線是跳脫字元,Windows 路徑請不加引號或用單引號。
|
|
121
|
+
- **行為改變——`uds simulate` 不再對根本沒被判定的東西印「Simulation Failed」(XSPEC-456 R2)。** `commit-message` 原本是餵給 `npx commitlint`;專案沒有 commitlint 設定(沒有 package.json 的 .NET 專案)時工具拒絕執行,合規與不合規的訊息得到同一個答案,還先下載了工具。現在依標準本身的規則在程序內判定(標頭 `<type>(<scope>): <subject>`、已安裝選項檔的 type、`scope-lowercase` 與 `subject-max-length` 兩條規則),不呼叫 npx、不連網,輸出會列出沒檢查的項目。結束碼:**0** 通過、**1** 不合規、**2** 沒有結論(沒有定義 simulator、標準未安裝、被委派的工具不能用)——最後一種以前是 1,印「Simulation Failed」。`--json` 帶 `status`(`pass` / `fail` / `cannot-simulate`)。被委派的 simulator 指令不再把輸入貼進 shell 字串。指令說明現在寫明哪些標準有 simulator(目前只有 `commit-message`)。回報中的「失敗卻 exit 0」在 macOS 上沒有重現,不宣稱已修。
|
|
122
|
+
- **`uds skills` 在裝了 56 個技能時只列 27 個,並寫「27 / 30」(XSPEC-456 R3)。** 篩選與分母是 `standards-registry.json` 裡手工維護的 30 個名字。現在改為 UDS 出貨的技能(含 `SKILL.md` 的資料夾),與 `init`、`update`、`check` 用同一份;manifest 記錄的其他 AI 工具的技能也會列出,摘要並說明 `uds check` 為它們追蹤了多少個技能檔案。
|
|
123
|
+
- **行為改變——`uds update` 現在會把 UDS 無法擔保的名稱從 `manifest.skills.names` 與 `manifest.commands.names` 移除(XSPEC-456 R4)。** `update --apply --skills` 移除舊版 CLI 誤拷進技能資料夾的 `_shared`、`agents`、`ai`、`tools`、`workflows` 後,`skillHashes` 乾淨了,名稱清單卻仍有 61 筆(技能只有 56 個)。名稱要同時是 UDS 出貨的技能或命令,且(安裝後)在 manifest 記錄的安裝位置真的存在才保留;市集安裝,以及無法檢查磁碟的情況,不動。既有專案在下一次 `uds update` 自動修正,已是最新版的也一樣。manifest 中記錄名稱的四個欄位是 `skills.names`、`commands.names`、`skillHashes`、`commandHashes`。
|
|
124
|
+
- **`uds spec list` 把完整的 SDD 規格列成 `draft`、標題空白(XSPEC-456 R5)。** 它把每個檔案都當微規格讀並填預設值。現在會讀 SDD 標頭——表格(`| Status | Approved (...) |`)、欄位行(`- **Status**: Archived`)或 front matter——讀不出來的印「格式:SDD(狀態未解析)」,不填預設值。未改動:`spec show`、`confirm`、`archive` 仍會用微規格模板改寫檔案。
|
|
125
|
+
|
|
126
|
+
### 新增
|
|
127
|
+
|
|
128
|
+
- **`uds deps --if-present`(XSPEC-456 R6)。** 沒有 `package.json`,或套件沒有宣告執行期相依時,印出不適用、未檢查任何東西,並以 0 結束(`--json`:`notApplicable`)。不加旗標時行為不變:沒有 `package.json` 仍以 1 結束。
|
|
129
|
+
|
|
130
|
+
## [6.14.0-beta.5] - 2026-10-06
|
|
131
|
+
|
|
132
|
+
> **測試版**——以 `npm install -g universal-dev-standards@beta` 安裝。要測什麼、如何退回正式版:[docs/PRE-RELEASE.md](../../docs/PRE-RELEASE.md)。
|
|
133
|
+
>
|
|
134
|
+
> **行為改變:**`uds check` 計入技能與命令檔的遺失或修改(`--ci` 以 1 結束);`uds check --diff` 以所裝套件為原稿,不再抓 GitHub `main`;`uds init` 會加入兩支在提交時警告的掃描腳本。
|
|
135
|
+
|
|
136
|
+
### Changed
|
|
137
|
+
|
|
138
|
+
- **行為改變——`uds check --diff` 現在以你所安裝的 UDS 套件內的檔為原稿,不再對照 GitHub `main`。** 這個差異回答的是「我改了 UDS 給我的哪些地方」;它過去從 GitHub `main` 下載原稿,所以離線會失敗(擴充檔也一樣),而且 UDS 在你安裝後自己改過的內容,會被列成你改的差異。現在原稿一律從所裝套件讀取——標準、選項、擴充檔皆同——不下載任何東西。指令會印出比對基準(`installed UDS package (version X)`),並提示看 UDS 之後的變更請用 `uds update --plan`。若專案內的標準是從另一個 UDS 版本安裝的、與目前安裝的套件版本不同,也會明說,因為兩版之間 UDS 改過的檔會顯示成差異。套件內找不到某個受追蹤檔的原稿時,指令會**點名**該檔、不下載、以結束碼 1 結束;不再退回 GitHub,也不再靜默略過。沒有被修改的檔時,`--diff` 現在會說「沒有差異可顯示」,而不是什麼都不印。**誰會看到不同:**執行 `uds check --diff`(或在互動式 `uds check` 按「檢視」)的人——凡是 `main` 與你所裝版本不同之處,差異可能與以往不同;而原本在套件缺原稿時讀到結束碼 0 的腳本,現在會讀到 1。**要做什麼:**不用做任何事;要看上游有什麼新內容,請執行 `uds update --plan`。落實 dev-platform XSPEC-453 R1。
|
|
139
|
+
|
|
140
|
+
### Removed
|
|
141
|
+
|
|
142
|
+
- **移除 `extensions/languages/php/`**——兩個沒有任何東西引用的檔(`php-style.md`、`fat-free-patterns.md`,約 37 KB);安裝器、registry 與文件使用的是 `extensions/languages/php-style.md` 與 `extensions/frameworks/fat-free-patterns.md`,兩者不變。npm 套件因此少了這兩個檔,現在剛好只含安裝器裝得到的 5 個擴充檔;新增的測試會在有未宣告的擴充檔被打包時變紅。`uds init --lang php` 與 `--framework fat-free` 裝的檔與先前相同。落實 dev-platform XSPEC-453 R2。
|
|
143
|
+
|
|
144
|
+
### 修正
|
|
145
|
+
|
|
146
|
+
- **健康分數的覆蓋度維度不再回報永遠是 0 的 `has_tests`。**`calculateCoverage` 宣告了 `hasTests = 0` 卻從未改動它,所以 `uds audit --score` 印出一個看起來像「標準有沒有測試」的量測、實際上不會動的數字。它已從加總與 `details` 移除;**任何專案的覆蓋度分數都不變**(分母本來就是每個標準兩份——`check-<id>.sh` 與 `check-<id>-sync.sh`)。(XSPEC-444 R5)
|
|
147
|
+
- **行為改變——`uds check` 現在會把遺失或被改過的技能檔算進判定。它以前會印出紅色 ✗,結尾卻仍說「專案符合標準」、exit 0。** Skills 完整性檢查的結果算出來之後被丟掉了。現在刪掉或改過技能檔,`uds check` 會說「偵測到一些問題」並點名該檔,`uds check --ci` 會 exit 1(不帶 `--ci` 時 exit code 仍是 0,與其他各類發現一致;UDS 寫的 pre-commit hook 執行的是不帶參數的 `uds check`,所以不會因此被擋)。**誰會看到差別:**技能資料夾被改過或掉了檔的專案。**怎麼處理:**執行訊息印出的指令 `uds update --apply --skills`。**幽靈紀錄先處理,所以既有專案不會突然開始失敗:**專案的 manifest 可能列著 UDS 從未安裝的技能檔——採用者自己的技能,以及舊版 UDS 因為雜湊整個資料夾而誤拷進技能資料夾的 `agents/`、`workflows/`、`_shared/`,後來 `uds update` 把它們刪了卻沒忘掉紀錄(有個專案顯示 26 個「遺失」,6.11.0 與 6.14.0-beta.4 相同)。現在安裝器只記錄自己裝的技能(也不記錄自己的 `.manifest.json`);`uds update` 刪掉技能資料夾時一併刪掉它的紀錄;`uds check` 忽略不描述任何出貨技能的紀錄並說出有幾筆(`N skill record(s) ignored`);`uds update`(`--apply`、`--skills`,或已是最新版的路徑)會把它們從 `.standards/manifest.json` 永久清掉。**斜線命令檔同樣適用**——它的檢查結果原本也被丟棄:命令檔被刪或被改,`uds check` 現在會點名,`--ci` 會 exit 1(修復:`uds update --apply --commands`)。UDS 不出貨的命令紀錄由 `uds update` 清掉;裝在使用者層級(所有專案共用,本專案無從背書)的命令紀錄,檢查會忽略並說明。另外,當「改程式沒動測試」或「假測試」檢查設為 `"mode": "block"` 時,`uds check` 印出 BLOCKED 後不再以「符合標準」收尾。落實 dev-platform XSPEC-454 R2。
|
|
148
|
+
- **`uds update --rollback` 現在還原整個升級,而不只是標準檔。** 依序執行 `update --apply`、`update --apply --skills`、`update --apply --commands` 後,一次 `--rollback` 只還原標準檔與 `CLAUDE.md`/`AGENTS.md`,新增的技能資料夾(`comprehension-ladder`)、技能與命令的 `.manifest.json`、以及 `.standards/manifest.json` 裡的雜湊紀錄都留在新版,於是 `uds check` 報修改過的檔,專案同時不符合兩個版本。原因:備份只記錄計畫要覆寫的檔(沒有更新所建立的檔,也沒有 `.standards/manifest.json`);`--skills` 與 `--commands` 寫檔時完全沒有備份;還原用的 `copyFileSync` 還原不了資料夾。現在 `--apply`、`--apply --skills`、`--apply --commands` 的每一步都建立備份,並記錄它所建立的檔(`--skills`/`--commands` 自己建立備份,沒有備份就不寫;只備份 UDS 出貨的技能與命令,不碰你自己的);不帶 `--apply` 的一般 `uds update` 仍和以前一樣不建立備份;連續的步驟以 `.standards/manifest.json` 前後的雜湊串起來,所以一次 `--rollback` 會一路退過整串沒有被打斷的升級,並在中間有別的變更處停下來、明說;還原後會讀回驗證;指令會印出還原了什麼、移除了什麼,若有任何失敗,**不會以「成功」收尾**(exit 1,並說明怎麼重試)。**沒有涵蓋、並會如實印出:**使用者層級的技能/命令(`~/.claude/skills`,由所有專案共用),以及舊版本做的備份(它們從未記錄所建立的檔與 manifest)。落實 dev-platform XSPEC-454 R1。
|
|
149
|
+
- **`uds update --commands` 把命令數印成了工具數**(只有一個 OpenCode 卻印「為 51 個 AI 工具更新」)。該訊息鍵在每個語言都寫成「N 個 AI 工具」,卻被填入命令檔數。現在有獨立的訊息,兩個欄位各放各的數字:「Updated 51 commands for 1 AI tool(s)」/「已為 1 個 AI 工具更新 51 個斜線命令」/「已为 1 个 AI 工具更新 51 个斜线命令」。舊鍵的其他用法本來就傳工具數,不變。落實 dev-platform XSPEC-454 R4。
|
|
150
|
+
|
|
151
|
+
### 新增
|
|
152
|
+
|
|
153
|
+
- **`uds init` 現在會附上 `full-coverage-testing` 一直要你自己寫的假測試與空殼掃描腳本,`uds check` 會把它們找到的東西以警告印出。**標準一直寫著「新增 `scripts/check-stubs.sh` 與 `scripts/check-anti-fake-tests.sh`」,驗證器也只檢查這兩個檔案存在——但 UDS 兩個都沒附,這條指示根本照做不了。`uds init` 現在會寫入 `scripts/check-anti-fake-tests.mjs`(找**沒有斷言**的測試、唯一的斷言是 `expect(true).toBe(true)` 或 `assert 200 == 200` 這類**恆真式**的測試、**每支測試都被跳過或標 todo** 的測試檔)與 `scripts/check-stubs.mjs`(`// WARNING: STUB` 標記、宣稱**尚未實作**而旁邊沒有標記的函式本體、本體**為空**而旁邊沒有標記的具名函式)。純 Node、零相依、不預設測試框架;它們是你的檔案。單獨執行時,找到東西就以非 0 結束。**`uds check`——pre-commit hook 執行的指令——會執行它們並把找到的東西印成警告;不擋任何東西**,除非你在 `.standards/test-policy.json` 設 `"mode": "block"`。有暫存檔案時掃描那些檔案;沒有暫存任何東西時(CI 執行)掃描整個專案。**測試檔規則涵蓋 JavaScript/TypeScript、Python、Java/Kotlin/Scala/C#、Go、Rust、Ruby、Elixir、PHP、Swift、Dart、Lua 與 C/C++;其他語言的測試檔會被列為「未掃描」,絕不當成乾淨。**它們讀的是文字、不執行你的測試,所以用掃描器認不得的名稱做斷言的輔助函式會被報為「no-assertion」(請命名為 `assert*`/`verify*`/`expect*`,或把樣式列在 `assertionPatterns`)。每次執行都先拿已知的假測試與好測試檢驗自己,失敗就以 `2`(「無法判定」,絕不算通過)結束。已存在的檔案絕不覆寫;`uds uninstall` 只移除 `uds init` 寫入且未被改動的檔案;較早初始化的專案由 `uds update` 詢問是否寫入(提示的預設為否;**`uds update -y` 會直接回答是**,所以升級指令是 `uds update -y` 的專案,下次更新就會多這兩個檔案)。**誰會看到差別:**本版之後每次 `uds init` 會在 `scripts/` 多兩個檔案,每次提交 `uds check` 會多印兩行(或找到的東西)。**怎麼處理:**讀它的發現;想讓某類檔案不再被報,加一份 `test-policy.json`;想強制執行,設 `"mode": "block"` 或在 CI 跑這兩支腳本。`uds check --standard full-coverage-testing` 現在會執行這兩支腳本,不再只檢查它們存在。(XSPEC-444 R5)
|
|
154
|
+
- **`uds check` 在一次提交改了程式碼卻沒動任何測試時發出警告。**有檔案暫存時,`uds check` 會在「改了程式檔、同一次提交沒有測試檔變動」時列出那些程式檔,並列出它不認得類型的變更檔案(絕不當成沒事,也絕不擋)。刪除不需要測試;純重新命名(git `R100`)與符合 `exempt` 條目的路徑可免,輸出會記下理由。哪些路徑是測試、哪些是程式,是附有常見生態預設值的資料——`*.test.*`、`*_test.go`、`test_*.py`、`*Test.java`、`tests/` 等——由 `.standards/test-policy.json`(`testDirs`、`testPatterns`、`sourceExtensions`、`nonCodeExtensions`、`ignore`,以及每筆都必須附 `reason` 否則不生效的 `exempt`)**加進**而不是取代。**它只警告、放行提交。**同一份檔案裡的 `"mode": "block"` 會讓它擋下提交;這是目前提供的唯一收緊步驟。**沒有做,因為規格沒有定義:**未配測試的變更數棘輪(基線放在哪、以什麼計數),以及逐次提交的豁免理由(pre-commit hook 讀不到提交訊息)。(XSPEC-444 R2)
|
|
155
|
+
- **`uds audit --offline`。** `check` 與 `update` 早就有,`audit` 卻回「unknown option」。加上它之後,`audit` 不發任何網路請求——包含每個指令結束後的「有新版本」提示(它對 `check`、`update` 也忽略 `--offline`,現在都遵守);`--report` 會說「離線模式:不提交回報。」(並指出出路 `--dry-run`),而不是去啟動 `gh`、瀏覽器或剪貼簿。落實 dev-platform XSPEC-454 R3。
|
|
156
|
+
|
|
157
|
+
## [6.14.0-beta.4] - 2026-10-06
|
|
158
|
+
|
|
159
|
+
> **測試版**——以 `npm install -g universal-dev-standards@beta` 安裝。要測什麼、如何退回正式版:[docs/PRE-RELEASE.md](../../docs/PRE-RELEASE.md)。
|
|
160
|
+
>
|
|
161
|
+
> **行為改變:**`uds check --standard checkin-standards` 在 lint 或測試失敗時會失敗;非 Node 專案的原生 pre-commit hook 現在擋得住提交。見下方 Fixed 的相關條目。
|
|
162
|
+
|
|
163
|
+
### 修正
|
|
164
|
+
- **`extensions/` 現在放進 npm 套件,`uds init`、`uds update` 與 reconciler 只從套件內安裝擴充檔——三者都不再從 GitHub 下載。** 6.13.1 版套件裡 `extensions/` 底下的 7 個檔(語言風格規範、框架模式、繁中與簡中語系包)一個都沒有,所以 `uds init --lang csharp`、`--lang php`、`--framework fat-free`、`--locale zh-tw`/`zh-cn` 安裝時是去 GitHub `main` 下載。後果有兩個:離線或公司內網裝不了這些擴充;而且拿到的是 `main` 當天的內容,不是你所裝版本對應的那個檔。同一個備援也把缺少的 `zh-cn.md` 藏了好幾個月。現在 `cli/scripts/prepack.mjs` 會把整個目錄打包;套件內容一致性檢查會逐檔、逐位元比對 `extensions/` 與套件(以前只比對 `.ai.yaml` 標準,所以一個擴充檔都沒有的套件也會顯示「bundle parity holds」);宣告的擴充檔若不在套件內,安裝會**失敗並點名該檔**——不下載、也不靜默略過。**誰會看到差別:**從 npm 安裝的人多拿到 7 個檔(約 152 KB),且這些檔不再發出任何網路請求;`uds update` 也從套件內更新 `manifest.extensions` 的項目。**沒有改的:**其他在本機缺檔時仍會嘗試 GitHub 的地方(標準、選項、整合檔、技能),以及 `uds check --diff`——它仍會從 GitHub `main` 抓任何追蹤檔(含擴充檔)的原稿來比對。這份清單列在規格裡,本次不動。新增的測試會執行 `npm pack`、把壓縮檔裝進拋棄式目錄、封鎖並記錄網路,對已安裝套件宣告的每一個擴充選項執行 `uds init`,再逐位元讀回每個已安裝的檔;第二支測試從套件移除一個宣告的檔,要求安裝以該檔的名稱失敗,且沒有任何下載嘗試。落實 dev-platform XSPEC-452 的 R1、R2、R3。
|
|
165
|
+
- **`uds init --locale` 不分大小寫,且不支援的語系會明說**:`--locale zh-CN` 以前會安裝英文並回報成功,現在會裝簡體中文。不支援的值(例如 `fr`)仍改用英文安裝,但會印出警告,不再靜默。(dev-platform XSPEC-451 後續)
|
|
166
|
+
|
|
167
|
+
- **行為改變——`uds check --standard checkin-standards` 在你的 lint 或測試失敗時現在會失敗;它以前會說「通過」。** 該驗證器原本是 `(npm test --if-present || echo "No test script")`。`--if-present` 本來就處理「沒有測試腳本」的情況;`|| echo` 因此只做了一件事:把失敗的 `npm test` 或 `npm run lint` 變成 exit 0。UDS 自己的 `test-governance` 標準要求閘門 fail-closed,它自己出貨的檢查卻沒做到。現在:lint 或測試腳本失敗會回非 0,並指出是哪一個(`FAILED: npm run test exited with 1`,後面接該腳本自己的輸出);真的沒有該腳本不算失敗,並且**只有這時**才印 `No lint script`/`No test script`;`npm init` 為 `test` 寫的預設佔位(`echo "Error: no test specified" && exit 1`)視為沒有;沒有 `package.json` 的專案通過,並印出 lint 與測試**沒有**被執行;`package.json` 存在卻無法解析會失敗,不會被當成「沒有腳本」。缺 `CHANGELOG.md` 仍只是提示。**誰會看到差別:**pre-commit hook 執行 `check --standard checkin-standards` 的專案(UDS 在 2026-02-04 至 2026-03-04 寫的 hook,`uds update` 會把它保留成區塊的參數),以及在 CI 或腳本裡執行該指令的人。過去帶著失敗的測試也能提交成功的 commit,現在會被擋下——這正是目的。**怎麼處理:**執行 `npm test`/`npm run lint`,修掉它們回報的問題。沒有測試的專案不受影響。全新的 `uds init` 所寫的 hook 執行的是不帶參數的 `uds check`,它不評估這個驗證器;它該不該評估是另一個決定,本次不變。驗證器現在會執行 `node`,凡是在跑 `uds` CLI 的專案本來就有。
|
|
168
|
+
- **`pipeline-security-gates` 驗證器不再在沒有任何 pipeline 提到安全閘門時通過。**它把 `grep` 接到 `head -1`,再以 `|| echo 'no-ci-pipeline'` 兜底;`head` 永遠回 0,所以兜底從不執行,這個檢查不可能失敗。現在改用 `grep -q`,除非 `.github/workflows/`、`.gitlab-ci.yml` 或 `Jenkinsfile` 提到 `secrets`、`sast`、`sca` 或 `dast`,否則回非 0。只有 `uds check --standard pipeline-security-gates` 會執行它。
|
|
169
|
+
- **`uds init` 為非 Node 專案寫的原生 `.git/hooks/pre-commit` 現在真的能擋下 commit。**它原本把每個 linter 都寫成 `... 2>/dev/null || true`,把 `uds check 2>/dev/null || true` 也是,最後印出「Pre-commit checks passed」——什麼都擋不了,還把自己的錯誤藏起來。現在:已安裝的 linter(`ruff`、`go vet`、`cargo clippy`)失敗會擋下 commit,沒安裝的 linter 則略過;UDS 檢查改用與 husky hook 相同的標記區塊,所以它的結束碼會擋下 commit,而找不到 `universal-dev-standards` CLI 時會說明如何安裝並擋下,不再靜默略過。`uds uninstall` 會整段移除該區塊,連你改過的腳本也一樣。**磁碟上既有的 hook 維持原樣**——UDS 無法證明一個被改過的檔案是自己寫的,這一項也沒有隨本次變更附上遷移。
|
|
170
|
+
- **`uds init --locale zh-cn` 現在可用。它以前會失敗並把整個安裝回滾。** 安裝程式宣告了 `zh-cn`,並會複製 `extensions/locales/zh-cn.md`,但這個檔案不存在(只有 `zh-tw.md`),所以安裝以 `extensions/locales/zh-cn.md: File not available` 收場,並移除它裝過的所有東西——沒有人能用簡體中文安裝 UDS,而且沒有任何測試用簡體中文跑過安裝,所以一直壞著。現在這個檔案存在了:它是以大陸通行術語寫成的簡體中文語系包(不是把繁體版逐字轉換——它的術語表寫「Performance → 性能」,繁體版寫的正好相反)。它以 `zh-cn-locale` 登錄在 `zh-tw-locale` 旁邊。新增的測試對安裝程式宣告的每一個語系實際執行真正的 `uds init`(清單從安裝程式讀出,不寫在測試裡),並讀回語系包、manifest 與已安裝的技能;有語系宣告了卻沒有對應檔,測試就會變紅並指出是哪個語系。理解階梯的安裝測試現在也讓 zh-CN 走 `uds init`。**npm 安裝的注意事項:**寫下這一條時 `extensions/` 不在 npm 套件裡,語系包是安裝時從 GitHub(`main`)下載的;現在它已放進套件(見上方 `extensions/` 那一條)。落實 dev-platform XSPEC-451 的 R1、R2。
|
|
171
|
+
|
|
172
|
+
### 新增
|
|
173
|
+
|
|
174
|
+
- **`ai-response-navigation` 1.3.0 → 1.4.0——R12 受控語言,其中一條為必須。** 把文字簡化會讓它更好讀,而最好讀的句子是肯定的句子,所以「簡化」會朝肯定的方向漂移:「可能」變成「是」。R12 把答案分成兩半。**12.1 屬必須**:為非原作者的讀者縮短、簡化、改寫或翻譯文字時,要保留寫作者的不確定語氣(might、could、probably、可能、推斷、尚未確認),不可把不確定的論斷改成確定的,也不可加入原文沒說的事實。只有這一部分的失敗會讓讀者相信不真實的事,而且不需要校準:檢查就是拿改寫前後比對,任何語言都做得到。**12.2 屬選用**,理由已寫進標準:以該語言自己的單位計句長(起始範圍,依語言校準)、同物同名、主動語態、一步一動作、少用分號、數字帶單位。R10 現在指向 R12。
|
|
175
|
+
- **不附英文詞典,並在標準裡明說。** 這些原則取自 ASD-STE100,但它的核可字表與時態限制依賴英文,不適用於中文或其他非英文文字。標準只取原則、不附任何字表,並警告:以空白斷詞的計數器會把一整段中文看成一個詞,永遠通過。
|
|
176
|
+
- **一組中文範例**:同一段文字的原文、約 80%、嚴格三個版本,全部保留不確定語氣,外加第四個更短卻錯誤的改寫(把「可能」改成直接陳述的原因、把「尚未重現」改成「已確認」)。同步 zh-TW 與 zh-CN、兩份 `.ai.yaml`,以及一支讀取實際出貨檔案的測試——必須條款被削弱或刪除時它會變紅。
|
|
177
|
+
- **新增技能 `comprehension-ladder`(`/comprehend`)1.0.0 — 把一段難懂的 AI 輸出換成較好懂的形式,而且不改變事實。** 技能先從原文建立一份大綱,再從大綱做出最多三階:受控文字、Mermaid 圖、單檔 HTML 解說頁(可離線開啟,不從網路載入任何東西)。沒有影片階。**三條防護為必須**,各附正例與反例:不加原文沒有的事實、保留每一個不確定語氣(「可能」仍是「可能」)、每一項都附對應原文的位置與「沒涵蓋」註記。技能本身依 [ai-response-navigation](../../core/ai-response-navigation.md) 第 12 條(受控語言)寫成,防護 G2 就是 12.1 條。
|
|
178
|
+
- **尚未證明有幫助。** `skills/comprehension-ladder/eval-cases.md` 有 5 段為此撰寫的原文,各附理解題與標準答案,並附一套跑法,會產出兩個數字:前後的答對率,以及防護違反次數。實跑需要模型呼叫,目前還沒做。做完之前,技能不宣稱有效。
|
|
179
|
+
- 提供 `zh-TW` 與 `zh-CN` 版本,並登錄於 registry、manifest、`llms.txt` 與技能索引。有一支測試會在拋棄式專案裡執行真正的 `uds init`,讀回安裝後的技能:三條防護都在、且標為必須,HTML 階禁止外部資源,也沒有影片階。
|
|
180
|
+
|
|
181
|
+
## [6.14.0-beta.3] - 2026-09-30
|
|
182
|
+
|
|
183
|
+
> **測試版**——以 `npm install -g universal-dev-standards@beta` 安裝。要測什麼、如何退回正式版:[docs/PRE-RELEASE.md](../../docs/PRE-RELEASE.md)。
|
|
184
|
+
>
|
|
185
|
+
> **既有採用者:請執行一次 `uds update`。**舊版 `uds init` 寫進 pre-commit hook 的是單行 `npx uds check`,它可能請 npm 去拿一個叫 `uds`、但不是本專案的套件。新安裝不再寫這一行,而 `uds update` 會替換既有 `.husky/pre-commit` 裡 UDS 自己寫的那一行。另外:`uds uninstall` 只移除能證明是 UDS 寫的東西(早期 UDS 安裝的專案會保留一部分檔案並說明原因),`uds open-work next-action` 讀得懂寫成表格欄的下一步。
|
|
186
|
+
|
|
187
|
+
### 變更
|
|
188
|
+
|
|
189
|
+
- **`uds open-work next-action` 現在讀得懂寫成 Markdown 表格欄的「下一步」,不再只認小節標題與行內標籤。** 表頭在「下一步」詞彙內的欄(`Next action`、`Next step`、`下一步`、`下一動`,以及新加的 `回來要做什麼`)每一列都會被讀,回報帶行號與該列第一格內容,方便定位。詞彙仍然只有一份:標題、行內標籤與表頭都讀同一份。放在引用區塊(`> | … |`)裡的表格現在看得見;程式碼片段內或反斜線之後的 `|` 不再切開儲存格。欄數與表頭不一致的列會列為 `UNDECIDABLE`(判定不了),不會被當成空白;別處沒有違反時結束碼為 2,因為乾淨的結果只涵蓋了欄位的一部分。空白、`—`、`-` 的儲存格只計數、不評估,也不算 OWT-019 違反。此事是在真實工作紀錄上量測 DEC-122 H2 基準時發現的:80 列中有 32 列的欄數與表頭不同。`回來要做什麼` 是該工作紀錄實際使用的表頭(它的文字說明把該欄叫作 下一動),屬未校準判斷(OWT-016)。檢查器自己的突變測試新增八個表格突變,原有十七個仍然轉紅。
|
|
190
|
+
|
|
191
|
+
### 修正
|
|
192
|
+
|
|
193
|
+
- **`uds uninstall` 不再留下 UDS 自己寫的檔案,也不再移除它無法證明是 UDS 寫的東西。** 走過 `init` → `update --with-hooks` → `uninstall -y` 之後,它回報「已移除 5、已跳過 1、錯誤 0」,卻留下 `scripts/hooks/` 底下 15 個 hook 腳本、一個空的 `.codex/`、一份生成標頭仍指向已刪除 `.standards/` 的 AGENTS.md,以及 `uds init` 寫入的 `.git/hooks/pre-commit` 腳本主體。現在的規則是:整個檔案只有在 manifest 記錄了「UDS 寫的」(`installedArtifacts`,由 `init` 與 `update --with-hooks` 寫入)**而且**內容仍與記錄的雜湊相符時才會刪除。其他一律保留,並在輸出說明原因(`kept: modified since UDS wrote it`、`kept: no install record — ...`)。資料夾只有在 UDS 建立且現已為空時才移除;採用者自己的 `scripts/hooks/*.mjs`、`.agents/rules/*` 與 hook 項目都會保留。由舊版 UDS 安裝的專案沒有記錄,其腳本、AGENTS.md 生成文字與原生 pre-commit 主體會被保留並說明,而不是猜測。每一行「已移除」現在都對應一次真實的刪除或修改,帶著錯誤結束的執行也會以非 0 結束。
|
|
194
|
+
- **`uds uninstall` 在沒有人能回答時不再畫出提示或噴錯誤堆疊,做不了事時也不再以 0 結束。** `--dry-run` 從不提示(它不寫任何東西),並預覽所有類別。沒有 `--yes` 又沒有終端機時,實際執行會以結束碼 2 拒絕,而不是假定「是」;提示被關閉時結束碼為 130;專案未初始化時結束碼為 1。
|
|
195
|
+
- **`uds init --with-hooks` 在 Windows 上不再印出 `'chmod' is not recognized`。** pre-commit hook 原本用 try/catch 包住的 `execSync("chmod +x ...")` 賦予執行權限;catch 對程式碼藏起了失敗,但 `execSync` 已先把 cmd.exe 的錯誤送到終端機。現在改用 `fs.chmodSync`,並在沒有執行位元的 Windows 上略過此步驟。
|
|
196
|
+
- **安全性:`uds init` 寫入的 pre-commit hook 不再向 npm 要一個叫 `uds`、但不是本專案的套件。** 該 hook 原本是單行 `npx uds check`。`npx` 先找 `node_modules/.bin` 與 `PATH`,兩處都沒有才去 npm registry,而 registry 上的 `uds` 是不相干的專案(維護者 wizawu、`github.com/wizawu/uds`、v0.3.6、2022 年後未更新、目前沒有 `bin`)。裝了 UDS 的機器不受影響;沒裝的 clone 則會用名稱去抓陌生人的套件——目前無害只是因為該套件*尚*無可執行檔,對方一旦發布帶 `uds` bin 的版本,每位採用者的每次 commit 都會執行它。`--no-install` 不是解法:用會記錄每個請求的本機 registry 實測(npm 10.9.9、11.20.0、12.1.0,三者一致),`npx --no-install uds` 仍會發出 `GET /uds`,而 `npx --no-install --package=universal-dev-standards uds` 完全找不到全域安裝。hook 現在兩者都不用:它在專案的 `node_modules/.bin`、再到 `PATH` 找 `universal-dev-standards`(套件本名,只有本專案能發布)並執行 `check`;兩處都找不到時印出該裝什麼並以非 0 結束——不跳過檢查、不下載任何東西,而且即使採用者自己的指令排在後面,檢查失敗也會擋下 commit。`uds uninstall` 依標記整塊移除新寫法。給人看的文字同樣修正:產生的 `CLAUDE.md`/`AGENTS.md` 區塊內的警告行與 hook 提示改寫為 `npx universal-dev-standards init` / `update`(警告行多了幾個 token,所以 `scripts/prompt-footprint-baseline.json` 依實測值各調高 3–6)。**既有採用者:**`uds update`(除了 `--skills`、`--commands`、`--integrations-only`、`--standards-only` 與 `--rollback` 之外的所有模式,以及 `--with-hooks`;`--plan` 只回報不寫入)會替換 `.husky/pre-commit` 中 UDS 自己寫的那一行——只認 UDS 曾產生過的兩種確切寫法(`npx uds check`,以及較早的 `npx uds check --standard checkin-standards`),且必須緊接在 `# UDS Standard Check` 標記下方;你自己寫或改過的行不會被動,並會連同行號回報。此步驟在「已是最新版本」的提前返回**之前**執行,所以標準已是最新的採用者也會被處理。`uds check` 現在會警告仍使用裸名稱的 hook。新增一個測試走訪 `npm pack` 出貨的全部內容,只要有字串以套件執行器(npx、bunx、pnpm dlx、yarn dlx、npm exec)執行裸名稱 `uds` 就會失敗;非 Node 專案的原生 hook(`uds check`,只從 `PATH` 解析、不經 registry)不受影響,維持原樣。
|
|
197
|
+
|
|
198
|
+
## [6.14.0-beta.2] - 2026-09-30
|
|
199
|
+
|
|
200
|
+
> **測試版**——以 `npm install -g universal-dev-standards@beta` 安裝。要測什麼、如何退回正式版:[docs/PRE-RELEASE.md](../../docs/PRE-RELEASE.md)。
|
|
201
|
+
>
|
|
202
|
+
> **修正 6.14.0-beta.1 的已知限制:**既有專案現在可以用 `uds update --with-hooks` 補裝 Antigravity CLI 關卡(以及缺少的 Claude Code / Codex / Gemini CLI 關卡)。
|
|
203
|
+
|
|
204
|
+
### Added
|
|
205
|
+
|
|
206
|
+
- **`uds open-work next-action | revision | separation | self-test` —— `open-work-tracking` 1.1.0 的參考檢查(OWT-017/018/019)現在隨 npm 安裝包出貨。** 6.14.0-beta.1 的這些檢查只在 repo 的 `scripts/` 裡,而 npm 安裝包不含該目錄,採用者不 clone UDS 就跑不了。規則現在只住在一個地方,`cli/src/utils/open-work-tracking.mjs`(在安裝包內);`uds open-work` 與舊的 `node scripts/check-open-work-tracking.mjs`(現在是一個不含規則、只重新匯出該模組的薄殼)跑的是同一份,並有測試要求兩者輸出完全相同。檢查本身沒有任何改變:結束碼相同(0 沒有違反、1 有違反、2 判定不了——2 不是通過),檢查器仍先跑自己的自測臂,每次執行仍聲明涵蓋率未知(OWT-011)、詞彙未校準(OWT-016)。它仍是作為證據提供的參考判定程序,不是閘門。**每次測試都觀察到會紅:**新測試複製 CLI,讓指令吞掉結束碼(永遠 0)或讓共用規則永遠通過,並要求違反的樣本對副本變綠;並斷言 `npm pack --dry-run` 的清單包含該模組。標準的「什麼在執行本標準」一節改為指向該指令,而不是只在 repo 裡的路徑。
|
|
207
|
+
|
|
208
|
+
- **`uds update --with-hooks`——為已初始化的專案補裝強制執行 hooks,並放寬 Antigravity 的偵測規則。** Hooks 過去只有 `uds init --with-hooks` 會接線,而 `uds init` 不能跑第二次,所以既有採用者永遠拿不到 UDS 在他們初始化之後才開始支援的工具的 hook(這是把 6.14.0-beta.1 安裝包裝進全新專案時發現的,已記為那一版的已知限制)。`uds update --with-hooks` 會重新偵測工具(manifest 裡的工具,加上專案檔案現在看得出來的)並補裝缺少的 hooks;`--ai-tool <清單>`(`claude-code`、`codex`、`gemini-cli`、`antigravity`)可改為直接指定,找不到任何工具時它會說明如何指定並以 1 結束,而不是猜。已經裝好的 hook 不會被重寫(重跑一次不會有任何變化),採用者自己的 hooks 絕不會被移除或重排(Claude/Codex/Gemini 是合併進去;agy 的 `.agents/hooks.json` 只寫在 UDS 自己的 `uds-turn-completion-integrity` 鍵底下,不是合法 JSON 的檔案原樣保留),採用者改過的 hook 腳本會被保留、除非加 `--force`,`--plan` 則什麼都不寫。它與 `--claude-target`、`--sync-refs` 一樣是獨立模式;在已初始化的專案執行 `uds init --with-hooks`,現在會指向它,而不是默默什麼都沒做。**Antigravity 偵測:**原本要求 `.agents/AGENTS.md`,而一個專案可以長期使用 agy 卻從不建立這個檔。現在也接受 `.agents/rules/`、`.agents/workflows/`、`.agents/plugins/` 與 `.agents/hooks.json`——這些是 agy 自己的執行檔帶著、且 antigravity.google 有文件記載的名稱——並且刻意**不**把 `.agents/skills/` 算進去,因為 Codex 也讀它(根目錄 `AGENTS.md` 加 `.agents/skills/` 的 repo 仍是 Codex;有測試)。偵測只看專案目錄:agy 記錄已開啟專案的 `~/.gemini/projects.json` 有被考慮,但因為它是機器本地的而不採用。`.agents/hooks.json` 是標記,但它同時也是 UDS 自己寫的檔,所以安裝之後它證明的是「裝過」,不是「採用者在用 agy」。**每次測試都觀察到會紅:**測試把真的 CLI 當子行程對一個已初始化的專案跑,並要求把補裝拿掉的 CLI 複本——刪掉該分支、一個回報成功卻什麼都沒寫的安裝器、偵測退回只看 `.agents/AGENTS.md`——對真 CLI 會通過的同一組斷言失敗。agy 關卡仍然只驗證過 `agy -p` 模式下沒有用工具的單一回合。
|
|
209
|
+
|
|
210
|
+
### Fixed
|
|
211
|
+
|
|
212
|
+
- **`turn-completion-integrity` 在使用者的前提子句超過固定字數時,會把「正在等使用者」的一輪擋下——自 6.13 起就存在。** 條件式承諾(「你選好後,我會套用」)的豁免,在英文語言包是 `you` 到逗號之間最多 20 個字元,在 zh-TW 語言包是 `你` 到 `後` 之間 1–6 個字;兩個數字都是憑感覺訂的。以已發佈的 6.14.0-beta.1、真實的 Claude Code Stop hook 輸入實測:「Once you choose A, I will apply it.」放行,「Once you choose option A or B, I will apply it.」(21 個字元)被擋,「After you choose option A or B, I will apply it.」同樣被擋——決定結果的是子句長度,不是 `once`/`after`。此 hook 只看一輪的**最後**一則訊息,所以採用者看到的是:代理明明已經正確地停下來問人,卻被逼著繼續講話。修正:豁免改為延伸到子句邊界(逗號、句末標點或換行),不再是字數,因此「Once you've reviewed the three options above and picked one, I will apply it.」與「你看完上面三個選項並選好一個之後,我會接著套用。」都放行。放寬上限就是讓真承諾漏過的方向,所以改用兩道規則取代字數:英文的子句內不得含有我自己的承諾(「After you merged it I will follow up, I will push the tag.」仍被擋);zh-TW 的 `你` 必須是子句的開頭、且不能是「你的」(「我看了你的設定檔並判斷需要重構之後,我會接著改。」仍被擋——那裡的 `你` 是我自己那句話裡的所有格)。「I will apply it once the build finishes.」不是在等使用者,仍被擋。**每次測試都觀察到會紅:**新測試複製 hook 目錄、把兩個舊上限各自放回去,要求同樣那幾句話對複本重新被擋(且 `--self-test` 失敗)。**已知限制,沒有改變:**豁免以段落為單位,含有一個這種條件子句的段落,會連帶豁免旁邊不相干的無條件承諾(原本就如此);沒有逗號的條件句(「After you merged it I will follow up」)仍會被擋。
|
|
213
|
+
|
|
214
|
+
- **執行 `scripts/pre-release-check.sh`——以及在這個 repo 裡 `git commit`——會把 UDS 技能寫進執行者真實的家目錄。** 2026-09-29,維護者在自己的機器上跑發版前檢查,54 個技能資料夾與一個 `.manifest.json` 被寫進真實的 `~/.claude/skills/`。使用者層技能會遮蔽專案層技能,於是一個使用繁中技能的專案靜默地跑起英文測試版。每一步都是綠的:做這件事的那些步驟是在 `mkdtemp` 目錄裡跑 CLI,而那隔離的是**專案**,不是**使用者**——`uds init -y` 與 `uds update` 不論在哪裡跑,都會寫使用者層檔案(`~/.claude/skills`、`~/.uds`)。用拋棄式 `HOME` 重現並實測,不是推測:`scripts/check-upgrade-fidelity.sh` 寫入 115 個檔案(它的 `uds update` 與前一版的 `npx … init` 都繼承了真實 `HOME`);一開始被懷疑的 `check-adopter-instruction-files.ts` 什麼也沒寫。另外兩處寫入者是逐檔二分單元測試找到的:`tests/commands/update-language-fidelity.test.js` 與 `update-agents-md-generator-fidelity.test.js` 呼叫真的 `updateCommand`(115 個檔案進 `~/.claude/skills`),`tests/commands/check.test.js` 寫了 `~/.uds/update-check.json`——而 pre-commit hook 會跑單元測試,所以**這個 repo 的每一次 commit 都會這樣**;修正者自己在修正落地前的下一次 commit 就又對真實家目錄做了一次。修正分三層:每一支會跑 CLI 的腳本現在都在拋棄式 `HOME` 下跑,且統一出自 `scripts/lib/isolated-home.{mjs,sh}`(`HOME`、`USERPROFILE`、`XDG_*`、`APPDATA`、`CODEX_HOME`;變數清單只有一份,bash 端執行 mjs 來讀它),涵蓋 `pre-release-check.sh` 的自我採用步驟、`check-upgrade-fidelity.sh`、`check-prompt-footprint.mjs`、`check-adopter-instruction-files.ts`、`check-skills-install-paths.ts`、`generate-usage-docs.mjs`、`cli/scripts/check-command-existence.mjs`、`cli/scripts/test-upgrade-path.mjs` 與 `cli/scripts/test-refactoring.sh`;測試套件在 `cli/tests/setup.js` 為每個測試檔換掉 `HOME`;`pre-release-check.sh` 開始前先對 `HOME` 底下 UDS 會寫的位置拍快照,結束時若有任何新增或修改就在摘要失敗(`scripts/check-home-untouched.mjs`)。被監看的位置不是手列的:從安裝器的路徑表與 `cli/src` 裡以 `homedir()` 為根的路徑走訪得出,並印出數量,所以縮成空集合的守衛不可能通過。**每次測試都觀察到會紅,且是端到端:**不隔離地對一個代表真實家目錄的目錄跑 CLI,守衛 exit 1 並點名 `~/.claude/skills`;有隔離則 exit 0;一支測試走訪每一支會 spawn CLI 的腳本,某個呼叫點的隔離被拿掉就紅;一支探針測試在沒有 `tests/setup.js` 時會失敗。**如果你在這個修正之前跑過 `pre-release-check.sh`,或在這個 repo 裡 commit 過,**請檢查 `~/.claude/skills/`:若有 `installedDate` 是當天的 `.manifest.json` 與旁邊的 UDS 技能資料夾,而那不是你自己裝的,就移除它們(使用者層技能會遮蔽專案層)。**刻意不監看:**`~/.claude/skills/synced/`——Claude Code 自己在執行時會把帳號的 claude.ai 技能同步進去(在真實家目錄上的第一次完整執行就因它失敗,寫入者正是執行檢查的那個 Claude Code 工作階段);它是守衛排除清單裡唯一一項、附有理由,每次比對都會印出,且排除被拿掉或放寬成整個 `~/.claude/skills` 時測試會失敗。**未涵蓋:**沒有任何安裝器點名的路徑上的寫入;以及端到端(`tests/e2e`)測試——已逐檔二分過,沒有寫入。
|
|
215
|
+
|
|
216
|
+
## [6.14.0-beta.1] - 2026-09-29
|
|
217
|
+
|
|
218
|
+
> **測試版**——以 `npm install -g universal-dev-standards@beta` 安裝。要測什麼、如何退回正式版:[docs/PRE-RELEASE.md](../../docs/PRE-RELEASE.md)。
|
|
219
|
+
>
|
|
220
|
+
> **已知限制(2026-09-29 把安裝包裝進全新專案實測發現):** Antigravity CLI 的關卡**只有**在「**全新**專案、且已經有 `.agents/AGENTS.md`」時,由 `uds init --with-hooks` 裝上(init 靠這個檔案判斷專案在用 Antigravity)。既有專案執行 `uds update` **不會**補裝,而 `uds init` 不能對同一個專案跑第二次。因此這個測試版裡,既有專案拿不到 agy 關卡;預計下一版修正。
|
|
221
|
+
|
|
222
|
+
### Added
|
|
223
|
+
|
|
224
|
+
- **`open-work-tracking` 1.1.0:在 OWT-016 之後新增三條要求——意圖與進度分開存放、意圖被修改要留痕、下一步要點名對象。** OWT-017(warning):承載一件工作之目標、驗收條件或限制的載體,不同時承載它的進度或下一步,以走訪各載體的結構判定、絕不看檔名,所以更新進度不必碰目標。OWT-018(error):對該意圖的每次修改都留下改了什麼、誰核可、為什麼的紀錄;沒有核可者的修改在 OWT-007 交回點被列出、不得靜默,且列出永不阻斷(OWT-008)。OWT-019(warning):「下一步」欄位點名檔案路徑、測試名稱、指令或需求編號之一,只有動詞不算;這個檢查判斷有沒有點名對象,不判斷句子寫得好不好。嚴重度的理由寫在標準裡。標準也記下對促成本次修改之提示詞刻意**不**採納的部分——那是使用者轉貼、作者不明、沒有實作的文字,只借了設計形狀:以手寫狀態檔當狀態真相(會過期,而戳比過期內容新是隱形的)、固定的開工儀式(由各代理工具設定,且會變成沒有任何 artefact 檢查判定得了的要求)。新增 `scripts/check-open-work-tracking.mjs`,是這三條要求的參考判定程序,作為 OWT-015 證據而非閘門提供(UDS 仍不設閘門,也沒有接進 `pre-release-check.sh`):`next-action` 回報「點名且已找到/點名但未找到/未點名」,`revision` 比對兩個版本(或一個檔案對 `--base <git rev>`)的驗收/目標/限制區段並要求一筆新增且完整的紀錄、把沒有核可者的修改列給交回點,`separation` 檢查沒有任何載體同時裝著兩者。它判定前先跑自己的自測臂、判定不了時 exit 2(不是 0),並寫明自己判定不了的事——紀錄是否誠實描述了修改、被點名的對象是否正確。**每次跑測試都被觀察到會紅:**測試套件複製該腳本、改它的原始碼文字,要求對真腳本通過的斷言對 17 個突變版失敗(每條要求的永遠通過與永遠失敗、每個辨認分支逐一關掉、舊紀錄被當成新紀錄、不完整的紀錄被接受)。**未校準(OWT-016):標題詞彙、指令清單、副檔名清單與編號樣式都是初始判斷,不是量測**——例如 `已知限制` 會被讀成限制區段;採用者應傳入自己的編號樣式。在真實歷史上重放,它回報 XSPEC-436 的驗收條件有變動而沒有修訂紀錄,以及 dev-platform 工作紀錄裡一筆未點名的下一步。
|
|
225
|
+
|
|
226
|
+
- **`turn-completion-integrity` 1.5.0:Antigravity CLI(`agy`)現已支援,依據是真實工作階段觀察到的契約。** 這份標準過去寫 agy「尚未支援」,因為它的 Stop hook 契約還沒被觀察過(R3:不對未經觀察的契約出適配層)。2026-09-29 已觀察(agy 1.2.12、`agy -p`、單輪、無工具呼叫),適配層 `scripts/hooks/check-turn-completion-agy.mjs` 建立在那次實跑的產出上,而不只是文件:hook 傳入資料只有 `transcriptPath`,所以最後一則回覆取最後一筆 `MODEL`/`PLANNER_RESPONSE`,人的訊息取最後一筆 `USER_EXPLICIT`/`USER_INPUT`(從 `<USER_REQUEST>` 內取出,後面的系統區塊丟掉)。`SYSTEM_MESSAGE` 紀錄絕不當成人說的話——agy 會把這個 hook 自己的 `continue` 理由寫回成這種紀錄,讀成人的話會讓 R9 叫停豁免失效。攔截是 `{"decision":"continue","reason":...}`,放行是 `{}`,所有失敗路徑都放行。`uds init --with-hooks` 在選了 Google Antigravity 時寫入 `.agents/hooks.json`(遇到無法解析的 `hooks.json` 不覆蓋),`uds uninstall` 只移除 UDS 自己的 handler、保留使用者其他 hook。**已驗證範圍:單輪、無工具呼叫、`agy -p`。未驗證:多輪、含工具呼叫的回合、互動模式、`fullyIdle: false`、`error` 非空、`.agents/hooks.json` 是否需要已登記的 Antigravity 專案、以及工作目錄是否永遠是 `.agents/`**——標準、適配層與安裝輸出都寫明了這一點。**同日實測:agy 執行 hook 時的工作目錄是 `.agents/`(不是專案根目錄),且對啟動失敗的 hook 靜默放行,所以安裝的指令是 `node ../scripts/hooks/check-turn-completion-agy.mjs`。**
|
|
227
|
+
|
|
20
228
|
## [6.13.1] - 2026-09-28
|
|
21
229
|
|
|
22
230
|
> **修補版**:修正 6.13.0 暴露的兩個「以 `uds update` 升級既有專案」的缺陷(繁中的提交訊息語言段落變成英文;AGENTS.md 被改寫成另一種格式且少了「這是索引」提醒),並新增一道發版前檢查,實際從上一個正式版升級一次。**若你已用 `uds update` 升到 6.13.0,請在升級至 6.13.1 後再執行一次 `uds update`**,以還原那些段落。
|
|
@@ -15,7 +15,7 @@ status: current
|
|
|
15
15
|
|
|
16
16
|
> **語言**: [English](../../README.md) | 繁體中文 | [简体中文](../zh-CN/README.md)
|
|
17
17
|
|
|
18
|
-
**版本**: 6.
|
|
18
|
+
**版本**: 6.14.0-beta.10 (Pre-release) | **發布日期**: 2026-10-10 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
|
|
19
19
|
|
|
20
20
|
語言無關、框架無關的軟體專案文件標準。透過 AI 原生工作流,確保不同技術堆疊之間的一致性、品質和可維護性。
|
|
21
21
|
|
|
@@ -77,9 +77,9 @@ npx universal-dev-standards init
|
|
|
77
77
|
| 類別 | 數量 | 說明 |
|
|
78
78
|
|----------|-------|-------------|
|
|
79
79
|
| **核心標準** | 153 | 通用開發準則 |
|
|
80
|
-
| **AI Skills** |
|
|
80
|
+
| **AI Skills** | 56 | 互動式技能 |
|
|
81
81
|
| **斜線命令** | 51 | 快速操作 |
|
|
82
|
-
| **CLI 指令** |
|
|
82
|
+
| **CLI 指令** | 24 | 專案設定與維護 |
|
|
83
83
|
<!-- UDS_STATS_TABLE_END -->
|
|
84
84
|
|
|
85
85
|
> **5.0 新功能?** 請參閱[預發布說明](../../docs/PRE-RELEASE.md)了解新功能詳情。
|
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
source: ../../SECURITY.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: e897d42bcd9f
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
@@ -13,6 +14,7 @@ status: current
|
|
|
13
14
|
<!-- UDS_SUPPORTED_VERSIONS_START -->
|
|
14
15
|
| 版本 | 支援狀態 |
|
|
15
16
|
|------|--------|
|
|
17
|
+
| 6.14.0-beta.10 | ✅ 預發布版本 |
|
|
16
18
|
| 6.13.1 | ✅ 最新正式版 |
|
|
17
19
|
| < 6.0.0 | ❌ 已終止支援 |
|
|
18
20
|
<!-- UDS_SUPPORTED_VERSIONS_END -->
|