universal-dev-standards 6.14.0-beta.1 → 6.14.0-beta.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +13 -3
- package/bin/uds.js +75 -3
- package/bundled/ai/options/code-review/pr-review.ai.yaml +20 -1
- package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
- package/bundled/ai/standards/ai-response-navigation.ai.yaml +43 -3
- package/bundled/ai/standards/checkin-standards.ai.yaml +25 -6
- package/bundled/ai/standards/code-review.ai.yaml +15 -2
- package/bundled/ai/standards/commit-message.ai.yaml +18 -4
- package/bundled/ai/standards/developer-memory.ai.yaml +12 -2
- package/bundled/ai/standards/full-coverage-testing.ai.yaml +86 -7
- package/bundled/ai/standards/open-work-tracking.ai.yaml +196 -11
- package/bundled/ai/standards/pipeline-security-gates.ai.yaml +53 -4
- package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
- package/bundled/core/ai-response-navigation.md +128 -12
- package/bundled/core/code-review-checklist.md +20 -2
- package/bundled/core/commit-message-guide.md +22 -19
- package/bundled/core/developer-memory.md +12 -2
- package/bundled/core/full-coverage-testing.md +99 -5
- package/bundled/core/open-work-tracking.md +157 -17
- package/bundled/core/pipeline-security-gates.md +63 -0
- package/bundled/core/project-context-memory.md +10 -2
- package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
- package/bundled/extensions/languages/csharp-style.md +464 -0
- package/bundled/extensions/languages/php-style.md +700 -0
- package/bundled/extensions/locales/zh-cn.md +717 -0
- package/bundled/extensions/locales/zh-tw.md +717 -0
- package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
- package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
- package/bundled/locales/COVERAGE.md +5 -4
- package/bundled/locales/zh-CN/CHANGELOG.md +199 -3
- package/bundled/locales/zh-CN/README.md +3 -3
- package/bundled/locales/zh-CN/SECURITY.md +3 -2
- package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
- package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
- package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
- package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
- package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
- package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
- package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
- package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
- package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
- package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
- package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
- package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
- package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
- package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
- package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
- package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
- package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
- package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
- package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
- package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
- package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
- package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
- package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
- package/bundled/locales/zh-CN/core/code-review-checklist.md +54 -23
- package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
- package/bundled/locales/zh-CN/core/database-standards.md +115 -114
- package/bundled/locales/zh-CN/core/developer-memory.md +159 -60
- package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
- package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
- package/bundled/locales/zh-CN/core/execution-history.md +2 -1
- package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
- package/bundled/locales/zh-CN/core/full-coverage-testing.md +103 -9
- package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
- package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
- package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
- package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
- package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
- package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
- package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
- package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
- package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
- package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
- package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
- package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
- package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
- package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
- package/bundled/locales/zh-CN/core/security-decision.md +45 -70
- package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
- package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
- package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
- package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
- package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
- package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
- package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
- package/bundled/locales/zh-CN/core/test-governance.md +94 -43
- package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
- package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
- package/bundled/locales/zh-CN/core/token-budget.md +44 -80
- package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
- package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
- package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
- package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
- package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
- package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
- package/bundled/locales/zh-CN/docs/CHEATSHEET.md +9 -3
- package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +68 -33
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +29 -15
- package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
- package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
- package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
- package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
- package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
- package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +46 -0
- package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
- package/bundled/locales/zh-CN/docs/user/README.md +4 -2
- package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
- package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
- package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
- package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
- package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
- package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
- package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
- package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
- package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
- package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
- package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
- package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
- package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
- package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
- package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
- package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
- package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
- package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
- package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
- package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
- package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
- package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
- package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
- package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
- package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
- package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
- package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
- package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
- package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
- package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
- package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
- package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
- package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
- package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
- package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
- package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
- package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
- package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
- package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
- package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
- package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
- package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
- package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/skills/README.md +3 -1
- package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
- package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
- package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
- package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
- package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
- package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
- package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
- package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
- package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
- package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
- package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
- package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
- package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
- package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
- package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
- package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
- package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
- package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
- package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
- package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
- package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
- package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
- package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
- package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
- package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
- package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
- package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
- package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
- package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
- package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
- package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
- package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
- package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
- package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
- package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
- package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
- package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
- package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
- package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
- package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
- package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
- package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
- package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
- package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
- package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
- package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
- package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
- package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
- package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
- package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
- package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
- package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
- package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
- package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
- package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
- package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
- package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
- package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
- package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
- package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
- package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
- package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
- package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
- package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
- package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
- package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
- package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
- package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
- package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
- package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
- package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
- package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
- package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
- package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
- package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
- package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
- package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
- package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
- package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
- package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
- package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
- package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
- package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
- package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
- package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
- package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
- package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
- package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
- package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
- package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
- package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
- package/bundled/locales/zh-TW/CHANGELOG.md +199 -3
- package/bundled/locales/zh-TW/README.md +3 -3
- package/bundled/locales/zh-TW/SECURITY.md +3 -2
- package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
- package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
- package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
- package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
- package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
- package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
- package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
- package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
- package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
- package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
- package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
- package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
- package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
- package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
- package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
- package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
- package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
- package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
- package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
- package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
- package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
- package/bundled/locales/zh-TW/core/code-review-checklist.md +36 -7
- package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
- package/bundled/locales/zh-TW/core/database-standards.md +2 -1
- package/bundled/locales/zh-TW/core/developer-memory.md +111 -12
- package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
- package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
- package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
- package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
- package/bundled/locales/zh-TW/core/execution-history.md +2 -1
- package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
- package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
- package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
- package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
- package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
- package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
- package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
- package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
- package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
- package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
- package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
- package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
- package/bundled/locales/zh-TW/core/open-work-tracking.md +92 -16
- package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
- package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
- package/bundled/locales/zh-TW/core/project-context-memory.md +215 -31
- package/bundled/locales/zh-TW/core/project-structure.md +240 -19
- package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
- package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
- package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
- package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
- package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
- package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
- package/bundled/locales/zh-TW/core/security-decision.md +43 -84
- package/bundled/locales/zh-TW/core/security-standards.md +204 -25
- package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
- package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
- package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
- package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
- package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
- package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
- package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
- package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
- package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
- package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
- package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
- package/bundled/locales/zh-TW/core/test-governance.md +92 -32
- package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
- package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
- package/bundled/locales/zh-TW/core/token-budget.md +41 -112
- package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
- package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
- package/bundled/locales/zh-TW/core/versioning.md +6 -2
- package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
- package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
- package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
- package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
- package/bundled/locales/zh-TW/docs/CHEATSHEET.md +9 -3
- package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +61 -26
- package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +29 -15
- package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
- package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
- package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
- package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
- package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
- package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +46 -0
- package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
- package/bundled/locales/zh-TW/docs/user/README.md +2 -0
- package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
- package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
- package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
- package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
- package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
- package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
- package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
- package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
- package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
- package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
- package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
- package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
- package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
- package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
- package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
- package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
- package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
- package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
- package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
- package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
- package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
- package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
- package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
- package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
- package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
- package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
- package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
- package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
- package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
- package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
- package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
- package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
- package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
- package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
- package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
- package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
- package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
- package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
- package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
- package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
- package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/skills/README.md +3 -1
- package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
- package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
- package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
- package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
- package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
- package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
- package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
- package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
- package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
- package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
- package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
- package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
- package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
- package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
- package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
- package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
- package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
- package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
- package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
- package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
- package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
- package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
- package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
- package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
- package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
- package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
- package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
- package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
- package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
- package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
- package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
- package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
- package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
- package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
- package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
- package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
- package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
- package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
- package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
- package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
- package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
- package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
- package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
- package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
- package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
- package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
- package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
- package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
- package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
- package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
- package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
- package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
- package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
- package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
- package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
- package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
- package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
- package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
- package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
- package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
- package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
- package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
- package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
- package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
- package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
- package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
- package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
- package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
- package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
- package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
- package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
- package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
- package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
- package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
- package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
- package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
- package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
- package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
- package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
- package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
- package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
- package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
- package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
- package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
- package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
- package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
- package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
- package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
- package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
- package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
- package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
- package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
- package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
- package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
- package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
- package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
- package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
- package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
- package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
- package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
- package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
- package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
- package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
- package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
- package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
- package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
- package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
- package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
- package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
- package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
- package/bundled/skills/README.md +1 -0
- package/bundled/skills/SKILL_NAMING.md +9 -0
- package/bundled/skills/commit-standards/SKILL.md +2 -2
- package/bundled/skills/commit-standards/guide.md +3 -2
- package/bundled/skills/commit-standards/language-options.md +19 -17
- package/bundled/skills/comprehension-ladder/SKILL.md +283 -0
- package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
- package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
- package/bundled/templates/gates/check-stubs.mjs +644 -0
- package/package.json +5 -3
- package/src/commands/audit.js +20 -2
- package/src/commands/check.js +155 -28
- package/src/commands/deps.js +31 -1
- package/src/commands/hitl.js +3 -0
- package/src/commands/init.js +159 -48
- package/src/commands/list.js +12 -3
- package/src/commands/mcp.js +2 -3
- package/src/commands/open-work.js +123 -0
- package/src/commands/quickstart.js +29 -13
- package/src/commands/release.js +102 -19
- package/src/commands/run-intent.js +10 -0
- package/src/commands/simulate.js +20 -8
- package/src/commands/skills.js +59 -33
- package/src/commands/spec-split.js +30 -17
- package/src/commands/spec.js +55 -21
- package/src/commands/uninstall.js +146 -32
- package/src/commands/update.js +471 -93
- package/src/core/install-records.js +192 -0
- package/src/core/manifest.js +12 -10
- package/src/core/marketplace-sentinel.js +5 -0
- package/src/core/open-work-config.js +122 -0
- package/src/core/project-config.js +92 -38
- package/src/flows/init-flow.js +10 -0
- package/src/hitl/manager.js +4 -2
- package/src/i18n/messages.js +413 -78
- package/src/installers/hooks-installer.js +236 -27
- package/src/installers/integration-installer.js +5 -1
- package/src/installers/skills-installer.js +3 -1
- package/src/installers/standards-installer.js +16 -23
- package/src/mcp/__tests__/server.test.js +0 -1
- package/src/mcp/server.js +16 -4
- package/src/prompts/init.js +148 -13
- package/src/reconciler/backup-locations.js +80 -0
- package/src/reconciler/backup-manager.js +451 -123
- package/src/reconciler/index.js +86 -10
- package/src/reconciler/install-roots.js +90 -0
- package/src/reconciler/plan-executor.js +37 -15
- package/src/uninstallers/hook-uninstaller.js +220 -33
- package/src/uninstallers/integration-uninstaller.js +35 -5
- package/src/uninstallers/skills-uninstaller.js +95 -16
- package/src/uninstallers/standards-uninstaller.js +56 -7
- package/src/utils/agents-installer.js +10 -17
- package/src/utils/available-standards-report.js +144 -0
- package/src/utils/available-standards.js +216 -0
- package/src/utils/command-hash-ownership.js +103 -0
- package/src/utils/commit-message-judge.js +155 -0
- package/src/utils/copier.js +80 -2
- package/src/utils/deps-applicability.js +25 -0
- package/src/utils/detector.js +46 -1
- package/src/utils/friction-detector.js +27 -0
- package/src/utils/gate-scripts.js +141 -0
- package/src/utils/git-hooks.js +139 -7
- package/src/utils/hasher.js +36 -0
- package/src/utils/health-scorer.js +10 -7
- package/src/utils/installed-names-ownership.js +114 -0
- package/src/utils/integration-generator.js +36 -24
- package/src/utils/legacy-hook-migration.js +112 -0
- package/src/utils/locale.js +19 -0
- package/src/utils/open-work-tracking.mjs +1754 -0
- package/src/utils/prompt-closed.js +18 -0
- package/src/utils/sdd-header.js +66 -0
- package/src/utils/skill-frontmatter.js +102 -0
- package/src/utils/skill-hash-ownership.js +64 -0
- package/src/utils/skill-name-collision.js +169 -0
- package/src/utils/skills-install-paths.js +114 -0
- package/src/utils/skills-installer.js +75 -106
- package/src/utils/standard-validator.js +98 -27
- package/src/utils/test-change-check.js +160 -0
- package/src/utils/test-policy.js +214 -0
- package/src/utils/transient-fs.js +113 -0
- package/src/utils/update-summary.js +29 -0
- package/src/vibe/micro-spec.js +15 -0
- package/standards-registry.json +48 -9
|
@@ -50,11 +50,34 @@ const ASKING =
|
|
|
50
50
|
// request for information, so ASKING above never caught it (measured: the
|
|
51
51
|
// zh-TW mirror of this shape fired as an unkept commitment). Grammar-based, not
|
|
52
52
|
// a verb list, to match this pack's own design note above: "once/after/as soon
|
|
53
|
-
// as you", up to
|
|
54
|
-
//
|
|
55
|
-
//
|
|
56
|
-
// the
|
|
57
|
-
|
|
53
|
+
// as you", then everything up to the CLAUSE BOUNDARY, a comma, then "I".
|
|
54
|
+
//
|
|
55
|
+
// 🔴 The clause used to be capped at 20 characters, chosen by feel. Measured
|
|
56
|
+
// 2026-09-29 on the published 6.14.0-beta.1: "Once you choose, I will apply it."
|
|
57
|
+
// passed and "Once you choose option A or B, I will apply it." (21 characters)
|
|
58
|
+
// blocked — the cap, not the grammar, decided. A human's precondition is often a
|
|
59
|
+
// long clause ("Once you've reviewed the three options above and picked one,
|
|
60
|
+
// …"), so no count is the right count. The clause ends where the class stops:
|
|
61
|
+
// a comma, sentence punctuation, or a line break. A precondition cannot be
|
|
62
|
+
// longer than the sentence it sits in, and it cannot cross a sentence.
|
|
63
|
+
//
|
|
64
|
+
// What the boundary keeps out, and why the comma stays required: "I will apply
|
|
65
|
+
// it once the build finishes." is not conditional on the human (no "you"), and
|
|
66
|
+
// "After you merged it I will …" (no comma) still fires — see the corpus.
|
|
67
|
+
//
|
|
68
|
+
// A widened clause must not swallow a commitment of mine, so the clause may not
|
|
69
|
+
// contain "I will / I am going to / I am about to". Without that,
|
|
70
|
+
// "After you merged it I will follow up, I will …" — the no-comma shape above,
|
|
71
|
+
// then a comma and a second "I" — would match, where the 20-character cap used
|
|
72
|
+
// to stop it. The subject of the precondition is the human's; a clause that
|
|
73
|
+
// makes a promise of its own is not one. (Contractions are already expanded by
|
|
74
|
+
// normalize() before this runs.)
|
|
75
|
+
const CONDITIONAL_ON_YOU = new RegExp(
|
|
76
|
+
'\\b(once|after|as soon as) you\\b' +
|
|
77
|
+
'(?:(?!\\bI\\s+(?:will|am going to|am about to|going to|about to)\\b)[^,.;:!?\\n])*' +
|
|
78
|
+
',\\s*I\\b',
|
|
79
|
+
'i'
|
|
80
|
+
);
|
|
58
81
|
|
|
59
82
|
/**
|
|
60
83
|
* Expand contractions so the patterns below never have to fight an apostrophe.
|
|
@@ -171,6 +194,32 @@ export const corpus = [
|
|
|
171
194
|
'After you confirm the plan, I will kick off the deploy.'],
|
|
172
195
|
[false, 'conditional: once you decide, I will',
|
|
173
196
|
'Once you decide, I will draft the ADR and file the tickets.'],
|
|
197
|
+
// 🔴 Measured 2026-09-29 on 6.14.0-beta.1 (published): the SAME sentence
|
|
198
|
+
// blocked or passed depending on how many characters sat between "you" and the
|
|
199
|
+
// comma — the 20-character cap, not the grammar. Each of these is one of the
|
|
200
|
+
// sentences that was measured, and the last three are the long clauses real
|
|
201
|
+
// agents write.
|
|
202
|
+
[false, 'conditional: once you choose (short, always passed)',
|
|
203
|
+
'Once you choose, I will apply it.'],
|
|
204
|
+
[false, 'conditional: once you choose A (short, always passed)',
|
|
205
|
+
'Once you choose A, I will apply it.'],
|
|
206
|
+
[false, 'conditional: as soon as you choose A or B',
|
|
207
|
+
'As soon as you choose A or B, I will apply it.'],
|
|
208
|
+
[false, 'conditional: after you choose option A or B (was blocked: 21 chars)',
|
|
209
|
+
'After you choose option A or B, I will apply it.'],
|
|
210
|
+
[false, 'conditional: once you choose option A or B (was blocked: 21 chars)',
|
|
211
|
+
'Once you choose option A or B, I will apply it.'],
|
|
212
|
+
[false, 'conditional: a long precondition clause',
|
|
213
|
+
"Once you've reviewed the three options above and picked one, I will apply it."],
|
|
214
|
+
[false, 'conditional: a long precondition clause, no contraction',
|
|
215
|
+
'After you have read the summary and decided which of the two migrations to keep, I will start the rollout.'],
|
|
216
|
+
// The widening must not turn the clause into a place to hide a commitment.
|
|
217
|
+
[true, 'not conditional on the human: the condition is a build, not you',
|
|
218
|
+
'I will apply it once the build finishes.'],
|
|
219
|
+
[true, 'not conditional on the human: "you" appears only after the commitment',
|
|
220
|
+
'I will apply the fix now, and you can review it later.'],
|
|
221
|
+
[true, 'a promise of my own inside the clause is not the human\'s precondition',
|
|
222
|
+
'After you merged it I will follow up, I will push the tag.'],
|
|
174
223
|
[true, 'subject is not you, still commits',
|
|
175
224
|
"After I fix this, I'll push it up."],
|
|
176
225
|
// Known limit, not fixed here: no comma between the precondition and "I"
|
|
@@ -47,12 +47,26 @@ const ASKING = new RegExp(
|
|
|
47
47
|
'|(跟我說|告訴我|回報我|讓我知道)(一聲)?[,,]\\s*我' +
|
|
48
48
|
// 「你選定後,我會…」— the precondition is the human's decision, not a request
|
|
49
49
|
// for information or a report-back, so neither branch above caught it. Measured:
|
|
50
|
-
// fired as an unkept commitment.
|
|
51
|
-
//
|
|
52
|
-
//
|
|
53
|
-
//
|
|
54
|
-
//
|
|
55
|
-
'
|
|
50
|
+
// fired as an unkept commitment. Grammar, not a length: literal 你 as the SUBJECT
|
|
51
|
+
// of the clause, then everything up to the clause boundary that is not another
|
|
52
|
+
// 我/你, then 後 (or 之後), then a comma and 我.
|
|
53
|
+
//
|
|
54
|
+
// 🔴 The clause used to be capped at 1–6 characters "so it stays a short
|
|
55
|
+
// decision verb". That is the same mistake the en pack made with 20: a human's
|
|
56
|
+
// precondition is often a whole clause (「你看完上面三個選項並選好一個之後,我會…」),
|
|
57
|
+
// and a count decided it instead of the grammar. Measured 2026-09-29 (en side,
|
|
58
|
+
// 6.14.0-beta.1); this side had the identical cap and the identical miss.
|
|
59
|
+
// The clause ends at 逗號/句號/驚嘆/問號/分號/冒號/換行, and may not contain 我
|
|
60
|
+
// (a precondition that carries my own act is not the human's).
|
|
61
|
+
//
|
|
62
|
+
// What replaces the count as the thing keeping real commitments out:
|
|
63
|
+
// - 你 must OPEN the clause (line/clause start, or after 等/待/當/若/一旦/
|
|
64
|
+
// 如果/只要), and must not be 你的. 「我看了你的設定檔並判斷需要重構之後,
|
|
65
|
+
// 我會接著改」 has 你 in the middle as a possessive inside MY sentence; with
|
|
66
|
+
// the cap gone it would have been exempted, and it is my commitment.
|
|
67
|
+
// - no 後 right after 你…: 「你選定的那份我會接著處理」 falls through.
|
|
68
|
+
// - no 你 before it: 「改好後我接著合併」, 「他確認後,我會…」 fall through.
|
|
69
|
+
'|(?:^|[,,。!?;;::\\n]|等到|等|待|當|若|一旦|如果|只要)\\s*你(?!的)[^,,。!?;;::\\n我你]+(之)?後[,,]\\s*我)'
|
|
56
70
|
);
|
|
57
71
|
|
|
58
72
|
// First person + future marker + action verb, within one sentence.
|
|
@@ -185,6 +199,23 @@ export const corpus = [
|
|
|
185
199
|
'你選好後,我會接著跑一次測試。'],
|
|
186
200
|
[false, '條件式承諾:你點頭後',
|
|
187
201
|
'你點頭後,我會接著把這份規格送出。'],
|
|
202
|
+
// 🔴 2026-09-29 實測(6.14.0-beta.1):en 側同一句話因為「你」到逗號之間差一個字而擋或放,
|
|
203
|
+
// 是字數上限決定的,不是語法。本側原本的 1–6 字上限是同一個缺陷。下面三句是真實會出現的長前提子句。
|
|
204
|
+
[false, '條件式承諾:你選好方案 A 或 B 後(原本被擋:超過 6 字)',
|
|
205
|
+
'你選好方案 A 或 B 後,我會接著套用。'],
|
|
206
|
+
[false, '條件式承諾:長前提子句',
|
|
207
|
+
'你看完上面三個選項並選好一個之後,我會接著套用。'],
|
|
208
|
+
[false, '條件式承諾:長前提子句,含頓號',
|
|
209
|
+
'你把上面三個選項都看過、挑好一個後,我會接著套用。'],
|
|
210
|
+
[false, '條件式承諾:等你……後',
|
|
211
|
+
'等你把上面三個選項看完並選好後,我會接著套用。'],
|
|
212
|
+
// 放寬之後,子句不能變成藏承諾的地方。
|
|
213
|
+
[true, '「你的」是所有格,句子的主詞是我,仍必須擋',
|
|
214
|
+
'我看了你的設定檔並判斷需要重構之後,我會接著改。'],
|
|
215
|
+
[true, '「你」在受詞位置(我把你貼的…整理完),仍必須擋',
|
|
216
|
+
'我把你貼的那一段整理完之後,我會接著改。'],
|
|
217
|
+
[true, '前提不是你,是建置——沒有在等使用者,仍必須擋',
|
|
218
|
+
'建置跑完之後,我會接著套用修正。'],
|
|
188
219
|
[true, '主詞不是你,仍必須擋——「後」在,但前面不是你',
|
|
189
220
|
'改好後我接著合併。'],
|
|
190
221
|
[true, '主詞不是你,仍必須擋——第三人稱的「後」',
|
|
@@ -3,9 +3,9 @@
|
|
|
3
3
|
> Auto-generated by `scripts/generate-locale-coverage.mjs` on 2026-07-16.
|
|
4
4
|
> Do not edit manually — re-run the script.
|
|
5
5
|
|
|
6
|
-
> **Canonical**: `skills/` (
|
|
6
|
+
> **Canonical**: `skills/` (56) + `core/` (149). **Locales tracked**: `zh-CN`, `zh-TW`.
|
|
7
7
|
|
|
8
|
-
## Skills (
|
|
8
|
+
## Skills (56 canonical)
|
|
9
9
|
|
|
10
10
|
| Skill | zh-CN | zh-TW |
|
|
11
11
|
| :-- | :-: | :-: |
|
|
@@ -24,6 +24,7 @@
|
|
|
24
24
|
| ci-cd-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
|
|
25
25
|
| code-review-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
|
|
26
26
|
| commit-standards | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
|
|
27
|
+
| comprehension-ladder | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
|
|
27
28
|
| contract-test-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
|
|
28
29
|
| database-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
|
|
29
30
|
| deploy-assistant | :white_check_mark: 1.0.0 | :white_check_mark: 1.0.0 |
|
|
@@ -65,8 +66,8 @@
|
|
|
65
66
|
| test-coverage-assistant | :white_check_mark: 1.1.0 | :white_check_mark: 1.1.0 |
|
|
66
67
|
| testing-guide | :white_check_mark: 1.2.0 | :white_check_mark: 1.2.0 |
|
|
67
68
|
|
|
68
|
-
**zh-CN skills coverage**:
|
|
69
|
-
**zh-TW skills coverage**:
|
|
69
|
+
**zh-CN skills coverage**: 56/56 (100%)
|
|
70
|
+
**zh-TW skills coverage**: 56/56 (100%)
|
|
70
71
|
|
|
71
72
|
## Standards (`core/` — 149 canonical)
|
|
72
73
|
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../CHANGELOG.md
|
|
3
|
-
source_version: 6.14.0-beta.
|
|
4
|
-
translation_version: 6.14.0-beta.
|
|
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,202 @@ 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` 或注入的安装器做出的报告不算;同一平台从多种 shell 跑过时,每一种都要看,取最差的),其中没有任何自动步骤失败,`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 随附的文件,那个位置在仓库之外,已安装的包也一样在包之外。现在改找包的 `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 技能文本”的副本被建在仓库根目录,`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 都读得到、受版本控制的仓库,不只放在某个人的 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 仓库之外又没给 `--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 报告:操作系统与版本、shell、Node 与 npm 版本、Windows 控制台代码页(读不到就写「取不到」及原因,不留空)、UDS 版本,以及每一步的通过、失败、跳过(平台不符)或未确认,附输出摘要。只用 Node 标准库、不经 shell 启动程序,所以同一行命令在 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
|
+
|
|
20
216
|
## [6.14.0-beta.1] - 2026-09-29
|
|
21
217
|
|
|
22
218
|
> **测试版**——以 `npm install -g universal-dev-standards@beta` 安装。要测什么、如何退回正式版:[docs/PRE-RELEASE.md](../../docs/PRE-RELEASE.md)。
|
|
@@ -15,7 +15,7 @@ status: current
|
|
|
15
15
|
|
|
16
16
|
> **语言**: [English](../../README.md) | [繁體中文](../zh-TW/README.md) | 简体中文
|
|
17
17
|
|
|
18
|
-
**版本**: 6.14.0-beta.
|
|
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,7 +14,7 @@ status: current
|
|
|
13
14
|
<!-- UDS_SUPPORTED_VERSIONS_START -->
|
|
14
15
|
| 版本 | 支持状态 |
|
|
15
16
|
|------|--------|
|
|
16
|
-
| 6.14.0-beta.
|
|
17
|
+
| 6.14.0-beta.10 | ✅ 预发布版本 |
|
|
17
18
|
| 6.13.1 | ✅ 最新正式版 |
|
|
18
19
|
| < 6.0.0 | ❌ 已终止支持 |
|
|
19
20
|
<!-- UDS_SUPPORTED_VERSIONS_END -->
|