universal-dev-standards 6.14.0-beta.8 → 6.14.0
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/bin/uds.js +12 -1
- package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
- package/bundled/ai/standards/commit-message.ai.yaml +12 -2
- package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
- package/bundled/core/commit-message-guide.md +22 -19
- package/bundled/core/secret-management-standards.md +13 -1
- package/bundled/extensions/locales/zh-tw.md +19 -19
- package/bundled/hooks/validate-commit-msg.mjs +52 -9
- package/bundled/locales/zh-CN/CHANGELOG.md +2312 -1102
- package/bundled/locales/zh-CN/CLAUDE.md +987 -101
- package/bundled/locales/zh-CN/README.md +3 -3
- package/bundled/locales/zh-CN/SECURITY.md +3 -3
- package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
- package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
- package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
- package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
- package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
- 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/accessibility-standards.md +871 -62
- 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-friendly-architecture.md +311 -72
- package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
- package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
- package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
- package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
- 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/changelog-standards.md +485 -63
- package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
- 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 +37 -23
- package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
- package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
- 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/deprecation-standards.md +155 -40
- package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
- package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
- package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
- package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
- package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
- package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
- package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
- package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
- package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
- 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/feature-flag-standards.md +202 -57
- package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
- package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
- 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/mutation-testing.md +45 -6
- package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
- package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
- package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
- package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
- package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
- package/bundled/locales/zh-CN/core/project-structure.md +550 -170
- 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/retrospective-standards.md +215 -22
- package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
- package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
- package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
- package/bundled/locales/zh-CN/core/security-decision.md +45 -70
- package/bundled/locales/zh-CN/core/security-standards.md +169 -16
- package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
- package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
- package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
- 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/supply-chain-security-standards.md +159 -32
- package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
- package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
- package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
- package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
- 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/versioning.md +737 -73
- 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/CHEATSHEET.md +2 -1
- package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
- package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
- package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
- package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
- 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 +2 -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/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 +2 -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/ai-instruction-standards/SKILL.md +217 -137
- 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/atdd-assistant/guide.md +148 -132
- 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/bdd-assistant/guide.md +122 -121
- package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
- package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
- package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
- 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/guide.md +119 -45
- 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 +4 -4
- package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
- package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
- package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
- package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
- 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/SKILL.md +4 -2
- 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/docs-generator/guide.md +8 -7
- 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-discovery/guide.md +158 -157
- 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/refactoring-assistant/guide.md +172 -171
- 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/guide.md +51 -43
- 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/guide.md +88 -79
- 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/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
- 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-derivation/SKILL.md +2 -2
- 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/guide.md +217 -156
- 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/test-coverage-assistant/guide.md +25 -12
- 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 +2291 -1110
- package/bundled/locales/zh-TW/CLAUDE.md +962 -76
- package/bundled/locales/zh-TW/README.md +3 -3
- package/bundled/locales/zh-TW/SECURITY.md +3 -3
- package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
- package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
- package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
- package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
- package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
- 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/accessibility-standards.md +895 -46
- 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/agent-dispatch.md +102 -33
- package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
- package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
- package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
- package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
- package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
- package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
- 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/branch-completion.md +130 -34
- 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/chaos-engineering-standards.md +138 -36
- 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 +19 -7
- package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
- package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
- package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
- package/bundled/locales/zh-TW/core/database-standards.md +2 -1
- package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
- package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
- package/bundled/locales/zh-TW/core/developer-memory.md +102 -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/environment-standards.md +250 -72
- package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
- package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
- 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/feature-flag-standards.md +202 -57
- package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
- package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
- 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/anti-hallucination-guide.md +234 -487
- package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
- package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
- package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
- package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
- 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/observability-standards.md +284 -40
- package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
- package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
- package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
- package/bundled/locales/zh-TW/core/project-context-memory.md +210 -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/runbook-standards.md +296 -23
- package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
- 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/slo-standards.md +301 -49
- package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
- 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/CHEATSHEET.md +2 -1
- package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
- package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
- package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
- package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
- package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
- 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 +2 -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/methodologies/guides/tdd-guide.md +584 -475
- 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/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 +2 -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/guide.md +137 -17
- package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
- package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
- 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/docs-generator/guide.md +4 -3
- 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/observability-assistant/SKILL.md +85 -18
- 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/SKILL.md +91 -45
- 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/language-examples.md +693 -47
- 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/.claude-plugin/plugin.json +71 -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/package.json +2 -2
- package/src/commands/audit.js +28 -1
- package/src/commands/check.js +77 -7
- package/src/commands/compile.js +37 -4
- package/src/commands/config.js +49 -24
- package/src/commands/init.js +78 -30
- package/src/commands/open-work.js +6 -2
- package/src/commands/release-messages.js +228 -0
- package/src/commands/release.js +127 -68
- package/src/commands/run-intent.js +11 -0
- package/src/commands/spec-split.js +2 -1
- package/src/commands/spec.js +11 -2
- package/src/commands/update.js +184 -30
- package/src/compilers/claude-code-compiler.js +9 -1
- package/src/config/ai-agent-paths.js +14 -1
- package/src/core/installed-formats.js +15 -0
- package/src/core/open-work-config.js +20 -1
- package/src/core/project-config.js +55 -0
- package/src/i18n/messages.js +160 -2
- package/src/installers/hooks-installer.js +1 -1
- package/src/installers/manifest-installer.js +1 -1
- package/src/installers/skills-installer.js +1 -1
- package/src/installers/standards-installer.js +3 -1
- package/src/mcp/server.js +9 -3
- package/src/prompts/init.js +26 -22
- package/src/reconciler/actual-state-scanner.js +2 -8
- package/src/reconciler/backup-locations.js +5 -0
- package/src/reconciler/backup-manager.js +19 -11
- package/src/reconciler/desired-state-calculator.js +89 -57
- package/src/reconciler/plan-executor.js +101 -8
- package/src/reconciler/recorded-versions.js +49 -0
- package/src/reconciler/relative-path.js +23 -0
- package/src/uninstallers/hook-uninstaller.js +9 -1
- package/src/uninstallers/skills-uninstaller.js +22 -3
- package/src/utils/available-standards-report.js +25 -4
- package/src/utils/available-standards.js +13 -3
- package/src/utils/build-manifest.js +1 -1
- package/src/utils/commit-message-judge.js +60 -13
- package/src/utils/friction-detector.js +23 -11
- package/src/utils/git-hooks.js +106 -4
- package/src/utils/integration-generator.js +95 -67
- package/src/utils/legacy-hook-migration.js +121 -2
- package/src/utils/open-work-tracking.mjs +105 -16
- package/src/utils/sdd-header.js +16 -4
- package/src/utils/skills-installer.js +2 -1
- package/src/utils/spinner.js +14 -4
- package/src/utils/standard-validator.js +3 -2
- package/standards-registry.json +10 -8
- package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
|
@@ -2,38 +2,49 @@
|
|
|
2
2
|
source: ../../CLAUDE.md
|
|
3
3
|
source_version: 1.2.0
|
|
4
4
|
translation_version: 1.2.0
|
|
5
|
-
last_synced: 2026-
|
|
5
|
+
last_synced: 2026-10-16
|
|
6
|
+
source_hash: a1de69c3a838
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
9
|
-
#
|
|
10
|
+
# Universal Development Standards - 项目指南
|
|
10
11
|
|
|
11
|
-
|
|
12
|
+
本文档定义 Universal Development Standards 项目本身的开发标准。作为一个向其他项目提供开发标准的框架,我们身体力行践行自身所倡导的理念(“吃自己的狗粮”)。
|
|
12
13
|
|
|
13
|
-
##
|
|
14
|
+
## 项目概述
|
|
14
15
|
|
|
15
|
-
Universal Development Standards
|
|
16
|
+
Universal Development Standards 是一个语言无关、框架无关的开发标准框架。它提供:
|
|
16
17
|
|
|
17
|
-
-
|
|
18
|
+
- **核心标准** (`core/`):70+ 个基础开发标准
|
|
18
19
|
- **AI 技能** (`skills/`):用于 AI 辅助开发的 Claude Code 技能
|
|
19
20
|
- **CLI 工具** (`cli/`):用于采用标准的 Node.js CLI
|
|
20
|
-
-
|
|
21
|
-
- **本地化** (`locales/`)
|
|
21
|
+
- **集成** (`integrations/`):针对各种 AI 工具的配置
|
|
22
|
+
- **本地化** (`locales/`):多语言支持(英语、繁体中文)
|
|
22
23
|
|
|
23
24
|
## 技术栈
|
|
24
25
|
|
|
25
|
-
|
|
|
26
|
-
|
|
27
|
-
|
|
|
28
|
-
|
|
|
29
|
-
|
|
|
30
|
-
|
|
|
26
|
+
| 组件 | 技术 | 版本 |
|
|
27
|
+
|-----------|------------|---------|
|
|
28
|
+
| 运行时 | Node.js | >= 18.0.0 |
|
|
29
|
+
| 模块系统 | ES Modules | - |
|
|
30
|
+
| 测试 | Vitest | ^4.0.16 |
|
|
31
|
+
| 代码检查 | ESLint | ^8.56.0 |
|
|
31
32
|
| CLI 框架 | Commander.js | ^12.1.0 |
|
|
32
|
-
|
|
|
33
|
+
| 交互式提示 | Inquirer.js | ^9.2.12 |
|
|
34
|
+
|
|
35
|
+
## 开发标准
|
|
33
36
|
|
|
34
|
-
|
|
37
|
+
> **核心标准使用规则**:
|
|
38
|
+
> 在验证标准、检查代码或执行任务时,**优先**阅读 `core/` 中的简明规则(例如 `core/testing-standards.md`)。
|
|
39
|
+
> **仅在**明确要求提供教学内容、详细解释或教程时,才阅读 `core/guides/` 或 `methodologies/guides/`。
|
|
40
|
+
> 这能确保 token 效率并聚焦上下文。
|
|
35
41
|
|
|
36
|
-
|
|
42
|
+
> **单一事实来源优先级(仅限源码仓库)**:
|
|
43
|
+
> 在此 UDS 源码仓库中,`core/*.md` 是**实时单一事实来源**。
|
|
44
|
+
> `<!-- UDS:STANDARDS:START -->` 区块内的 `.standards/*.ai.yaml` 文件是由 `npx universal-dev-standards install/update` 维护的**采用者狗粮快照**——根据 DEC-044,`uds update` 不能在源码仓库内运行,因此该快照会滞后于 `core/`。
|
|
45
|
+
> 当两者出现分歧时,**始终以 `core/` 为准**。从该仓库 CWD 启动的子代理必须将 `core/*.md` 视为权威依据。
|
|
46
|
+
|
|
47
|
+
### 1. Commit 信息格式
|
|
37
48
|
|
|
38
49
|
遵循 `core/commit-message-guide.md` 中定义的 Conventional Commits 规范:
|
|
39
50
|
|
|
@@ -46,20 +57,20 @@ Universal Development Standards 是一个语言无关、框架无关的文件化
|
|
|
46
57
|
```
|
|
47
58
|
|
|
48
59
|
**类型:**
|
|
49
|
-
- `feat
|
|
50
|
-
- `fix
|
|
51
|
-
- `docs
|
|
52
|
-
- `chore
|
|
53
|
-
- `test
|
|
54
|
-
- `refactor
|
|
55
|
-
- `style
|
|
56
|
-
|
|
57
|
-
|
|
60
|
+
- `feat`: 新功能或标准
|
|
61
|
+
- `fix`: Bug 修复或错误更正
|
|
62
|
+
- `docs`: 文档更新
|
|
63
|
+
- `chore`: 维护任务
|
|
64
|
+
- `test`: 测试相关变更
|
|
65
|
+
- `refactor`: 代码重构
|
|
66
|
+
- `style`: 格式化变更
|
|
67
|
+
|
|
68
|
+
**示例:**
|
|
58
69
|
```bash
|
|
59
|
-
feat(core):
|
|
60
|
-
docs(skills):
|
|
61
|
-
fix(cli):
|
|
62
|
-
chore(i18n):
|
|
70
|
+
feat(core): add new testing completeness dimensions
|
|
71
|
+
docs(skills): update Claude Code skill documentation
|
|
72
|
+
fix(cli): resolve path resolution issue on Windows
|
|
73
|
+
chore(i18n): sync translations with source files
|
|
63
74
|
```
|
|
64
75
|
|
|
65
76
|
### 2. 分支策略
|
|
@@ -67,17 +78,17 @@ chore(i18n): 同步翻译与原始档案
|
|
|
67
78
|
遵循 `core/git-workflow.md` 中定义的 Git 工作流:
|
|
68
79
|
|
|
69
80
|
| 分支 | 用途 |
|
|
70
|
-
|
|
71
|
-
| `main` |
|
|
72
|
-
| `feature/*` |
|
|
73
|
-
| `fix/*` |
|
|
74
|
-
| `docs/*` |
|
|
81
|
+
|--------|---------|
|
|
82
|
+
| `main` | 稳定、可用于生产环境的发布版本 |
|
|
83
|
+
| `feature/*` | 新功能与增强 |
|
|
84
|
+
| `fix/*` | Bug 修复 |
|
|
85
|
+
| `docs/*` | 文档更新 |
|
|
75
86
|
| `chore/*` | 维护任务 |
|
|
76
87
|
|
|
77
|
-
### 3.
|
|
88
|
+
### 3. 代码风格
|
|
78
89
|
|
|
79
90
|
**JavaScript:**
|
|
80
|
-
-
|
|
91
|
+
- 字符串使用单引号
|
|
81
92
|
- 语句以分号结尾
|
|
82
93
|
- 使用 ES Module 语法(`import`/`export`)
|
|
83
94
|
- 遵循 `cli/.eslintrc.json` 中的 ESLint 配置
|
|
@@ -85,70 +96,86 @@ chore(i18n): 同步翻译与原始档案
|
|
|
85
96
|
**Markdown:**
|
|
86
97
|
- 使用 ATX 风格标题(`#`、`##`、`###`)
|
|
87
98
|
- 标题前后包含空行
|
|
88
|
-
-
|
|
99
|
+
- 使用带有语言说明的围栏式代码块
|
|
89
100
|
|
|
90
101
|
### 4. 测试要求
|
|
91
102
|
|
|
92
|
-
- 所有 CLI
|
|
93
|
-
-
|
|
94
|
-
-
|
|
103
|
+
- 所有 CLI 功能都必须有对应的测试
|
|
104
|
+
- 提交前运行测试:`npm test`(在 `cli/` 目录中)
|
|
105
|
+
- 运行代码检查:`npm run lint`(在 `cli/` 目录中)
|
|
95
106
|
- 测试覆盖率报告:`npm run test:coverage`
|
|
96
107
|
|
|
97
108
|
### 5. 翻译同步
|
|
98
109
|
|
|
99
|
-
|
|
100
|
-
1.
|
|
101
|
-
2.
|
|
102
|
-
3.
|
|
110
|
+
修改核心标准时:
|
|
111
|
+
1. 先更新英文源文件
|
|
112
|
+
2. 将变更同步到 `locales/zh-TW/` 目录
|
|
113
|
+
3. 运行翻译检查:`./scripts/check-translation-sync.sh`
|
|
103
114
|
|
|
104
|
-
##
|
|
115
|
+
## 快捷命令
|
|
105
116
|
|
|
106
117
|
### macOS / Linux
|
|
107
118
|
|
|
108
119
|
```bash
|
|
109
|
-
# CLI
|
|
120
|
+
# CLI development (run from cli/ directory)
|
|
110
121
|
cd cli
|
|
111
|
-
npm install #
|
|
112
|
-
npm test #
|
|
113
|
-
npm run test:watch #
|
|
114
|
-
npm run lint #
|
|
115
|
-
npm run test:coverage #
|
|
122
|
+
npm install # Install dependencies
|
|
123
|
+
npm test # Run tests
|
|
124
|
+
npm run test:watch # Run tests in watch mode
|
|
125
|
+
npm run lint # Check code style
|
|
126
|
+
npm run test:coverage # Generate coverage report
|
|
116
127
|
|
|
117
|
-
#
|
|
128
|
+
# Translation sync check (run from root)
|
|
118
129
|
./scripts/check-translation-sync.sh
|
|
119
130
|
|
|
120
|
-
#
|
|
131
|
+
# Version sync check (run from root)
|
|
121
132
|
./scripts/check-version-sync.sh
|
|
122
133
|
|
|
123
|
-
#
|
|
134
|
+
# Standards consistency check (run from root)
|
|
124
135
|
./scripts/check-standards-sync.sh
|
|
125
136
|
|
|
126
|
-
#
|
|
137
|
+
# Pre-release check (run all checks at once)
|
|
138
|
+
./scripts/pre-release-check.sh
|
|
139
|
+
|
|
140
|
+
# Local CLI testing
|
|
127
141
|
node cli/bin/uds.js list
|
|
128
142
|
node cli/bin/uds.js init --help
|
|
143
|
+
|
|
144
|
+
# Health score (self-diagnosis)
|
|
145
|
+
node cli/bin/uds.js audit --score --self
|
|
146
|
+
node cli/bin/uds.js audit --score --self --format json
|
|
147
|
+
|
|
148
|
+
# External reference check
|
|
149
|
+
node scripts/check-external-references.mjs
|
|
150
|
+
|
|
151
|
+
# Hook statistics analysis (requires opt-in: .uds/config.json {"hookStats": true})
|
|
152
|
+
node scripts/analyze-hook-stats.mjs
|
|
129
153
|
```
|
|
130
154
|
|
|
131
155
|
### Windows (PowerShell)
|
|
132
156
|
|
|
133
157
|
```powershell
|
|
134
|
-
# CLI
|
|
158
|
+
# CLI development (run from cli\ directory)
|
|
135
159
|
cd cli
|
|
136
|
-
npm install #
|
|
137
|
-
npm test #
|
|
138
|
-
npm run test:watch #
|
|
139
|
-
npm run lint #
|
|
140
|
-
npm run test:coverage #
|
|
160
|
+
npm install # Install dependencies
|
|
161
|
+
npm test # Run tests
|
|
162
|
+
npm run test:watch # Run tests in watch mode
|
|
163
|
+
npm run lint # Check code style
|
|
164
|
+
npm run test:coverage # Generate coverage report
|
|
141
165
|
|
|
142
|
-
#
|
|
166
|
+
# Translation sync check (run from root)
|
|
143
167
|
.\scripts\check-translation-sync.ps1
|
|
144
168
|
|
|
145
|
-
#
|
|
169
|
+
# Version sync check (run from root)
|
|
146
170
|
.\scripts\check-version-sync.ps1
|
|
147
171
|
|
|
148
|
-
#
|
|
172
|
+
# Standards consistency check (run from root)
|
|
149
173
|
.\scripts\check-standards-sync.ps1
|
|
150
174
|
|
|
151
|
-
#
|
|
175
|
+
# Pre-release check (run all checks at once)
|
|
176
|
+
.\scripts\pre-release-check.ps1
|
|
177
|
+
|
|
178
|
+
# Local CLI testing
|
|
152
179
|
node cli\bin\uds.js list
|
|
153
180
|
node cli\bin\uds.js init --help
|
|
154
181
|
```
|
|
@@ -156,63 +183,844 @@ node cli\bin\uds.js init --help
|
|
|
156
183
|
### Windows (Git Bash)
|
|
157
184
|
|
|
158
185
|
```bash
|
|
159
|
-
#
|
|
186
|
+
# Same commands as macOS / Linux work in Git Bash
|
|
160
187
|
./scripts/check-translation-sync.sh
|
|
161
188
|
./scripts/check-version-sync.sh
|
|
162
189
|
./scripts/check-standards-sync.sh
|
|
190
|
+
./scripts/pre-release-check.sh
|
|
191
|
+
```
|
|
192
|
+
|
|
193
|
+
## Testing Workflow / 测试工作流程
|
|
194
|
+
|
|
195
|
+
### When to Run Tests / 何时运行测试
|
|
196
|
+
|
|
197
|
+
| Timing | Command | Purpose |
|
|
198
|
+
|--------|---------|---------|
|
|
199
|
+
| 开发期间 | `npm run test:watch` | 即时反馈 |
|
|
200
|
+
| 提交前 | 自动(git hook) | 防止回归 |
|
|
201
|
+
| PR 之前 | `./scripts/pre-release-check.sh` | 完整验证 |
|
|
202
|
+
| CI/CD | 自动(GitHub Actions) | 持续集成 |
|
|
203
|
+
|
|
204
|
+
### Git Hooks (Automatic) / Git Hooks(自动运行)
|
|
205
|
+
|
|
206
|
+
Pre-commit hook (`cli/.husky/pre-commit`) 自动运行:
|
|
207
|
+
- `npm run test:unit` - 仅单元测试,不包含 E2E(快速,< 5 秒)
|
|
208
|
+
- `eslint --fix` - 通过 lint-staged 自动修复代码风格
|
|
209
|
+
- `check-standards-sync.sh` - 如果修改了 core/*.md 文件
|
|
210
|
+
- `check-cli-docs-sync.sh` - 如果修改了 cli/bin/*.js 文件
|
|
211
|
+
|
|
212
|
+
> **Note**:如果任何检查失败,提交将被中止。
|
|
213
|
+
|
|
214
|
+
### Manual Testing Commands / 手动测试命令
|
|
215
|
+
|
|
216
|
+
```bash
|
|
217
|
+
# In cli/ directory
|
|
218
|
+
npm test # Run all tests once
|
|
219
|
+
npm run test:watch # Watch mode for development
|
|
220
|
+
npm run test:coverage # Generate coverage report
|
|
221
|
+
npm run lint # Check code style
|
|
222
|
+
```
|
|
223
|
+
|
|
224
|
+
### AI Assistant Testing Guidelines / AI 助手测试指南
|
|
225
|
+
|
|
226
|
+
> **Important**:本节为 AI 助手(Claude Code 等)提供关于如何在此项目中高效运行测试的指导。
|
|
227
|
+
|
|
228
|
+
**Test Suite Characteristics / 测试套件特性:**
|
|
229
|
+
- 完整测试套件:跨 30+ 个文件的约 1,000 个测试(单元测试 + E2E)
|
|
230
|
+
- 单元测试:< 10 秒运行时间
|
|
231
|
+
- E2E 测试:约 6 分钟(启动 CLI 子进程)
|
|
232
|
+
- 完整套件运行时间:约 6 分钟
|
|
233
|
+
|
|
234
|
+
**🚀 Recommended AI Agent Commands / 推荐的 AI Agent 命令:**
|
|
235
|
+
|
|
236
|
+
| Scenario | Command | Execution Time |
|
|
237
|
+
|----------|---------|----------------|
|
|
238
|
+
| **快速开发** | `cd cli && npm run test:quick` | < 6 秒(864 个测试) |
|
|
239
|
+
| **测试发现** | `cd cli && npm run test:discover` | < 1 秒 |
|
|
240
|
+
| **仅单元测试** | `cd cli && npm run test:unit` | < 3 秒 |
|
|
241
|
+
| **排除 E2E 测试** | `cd cli && npm run test:fast` | < 5 秒 |
|
|
242
|
+
| **特定变更** | `npm test -- tests/unit/core/ tests/commands/` | < 2 秒 |
|
|
243
|
+
|
|
244
|
+
**📋 Test Discovery Tool / 测试发现工具:**
|
|
245
|
+
```bash
|
|
246
|
+
# Discover all tests and get execution commands
|
|
247
|
+
cd cli && npm run test:discover
|
|
248
|
+
|
|
249
|
+
# Show commands for different scenarios
|
|
250
|
+
cd cli && node scripts/test-discovery.mjs commands development
|
|
163
251
|
```
|
|
164
252
|
|
|
253
|
+
**⚠️ Avoid / 避免:**
|
|
254
|
+
- 使用 `--reporter=summary` 或自定义 reporter(兼容性问题)
|
|
255
|
+
- 在未检查当前工作目录的情况下运行测试
|
|
256
|
+
|
|
257
|
+
**✅ Best Practice / 最佳实践:**
|
|
258
|
+
```bash
|
|
259
|
+
# ✅ Recommended: Quick development testing
|
|
260
|
+
cd cli && npm run test:quick
|
|
261
|
+
|
|
262
|
+
# ✅ Good: Test specific modules
|
|
263
|
+
npm test -- tests/commands/ai-context.test.js tests/unit/utils/workflows-installer.test.js
|
|
264
|
+
|
|
265
|
+
# ✅ Good: Use test discovery for targeted testing
|
|
266
|
+
cd cli && npm run test:discover
|
|
267
|
+
|
|
268
|
+
# ✅ Full test suite is now fast enough to run directly
|
|
269
|
+
cd cli && npm test # ~6 minutes
|
|
270
|
+
```
|
|
271
|
+
|
|
272
|
+
### Test Certificate System (Optional) / 测试凭证系统(可选)
|
|
273
|
+
|
|
274
|
+
测试凭证系统可用于高级工作流程,但由于完整测试套件运行迅速(约 6 分钟),默认情况下未在预发布检查中使用。
|
|
275
|
+
|
|
276
|
+
**Commands / 命令:**
|
|
277
|
+
```bash
|
|
278
|
+
# Generate certificate after passing tests (optional)
|
|
279
|
+
cd cli && npm run test:with-cert
|
|
280
|
+
|
|
281
|
+
# Verify existing certificate
|
|
282
|
+
cd cli && npm run test:verify
|
|
283
|
+
```
|
|
284
|
+
|
|
285
|
+
> **Note**:预发布检查(`pre-release-check.sh`)始终运行完整的测试套件。如果需要,凭证系统可用于自定义 CI/CD 工作流程。
|
|
286
|
+
|
|
287
|
+
## Code Check-in Standards (Mandatory) / 代码签入规范(强制)
|
|
288
|
+
|
|
289
|
+
每次提交在 commit 之前必须通过以下质量门禁:
|
|
290
|
+
|
|
291
|
+
### Core Philosophy / 核心理念
|
|
292
|
+
|
|
293
|
+
每次提交应当:
|
|
294
|
+
- ✅ 是一个完整的逻辑工作单元
|
|
295
|
+
- ✅ 使代码库保持在可用状态
|
|
296
|
+
- ✅ 可回滚且不破坏功能
|
|
297
|
+
- ✅ 包含其自身的测试(针对新功能)
|
|
298
|
+
|
|
299
|
+
### Mandatory Checklist / 强制检查清单
|
|
300
|
+
|
|
301
|
+
在每次提交之前,务必验证:
|
|
302
|
+
|
|
303
|
+
1. **构建验证**
|
|
304
|
+
- [ ] 代码成功编译(零错误)
|
|
305
|
+
- [ ] 满足所有依赖项
|
|
306
|
+
|
|
307
|
+
2. **测试验证**
|
|
308
|
+
- [ ] 所有现有测试均通过(100% 通过率)
|
|
309
|
+
- [ ] 新代码具有对应的测试
|
|
310
|
+
- [ ] 测试覆盖率未降低
|
|
311
|
+
|
|
312
|
+
3. **代码质量**
|
|
313
|
+
- [ ] 遵循编码规范
|
|
314
|
+
- [ ] 无硬编码机密(密码、API 密钥)
|
|
315
|
+
- [ ] 无安全漏洞
|
|
316
|
+
|
|
317
|
+
4. **文档**
|
|
318
|
+
- [ ] API 文档已更新(如适用)
|
|
319
|
+
- [ ] 仅在预发布时更新 CHANGELOG,而非每次提交都更新(遵循 [changelog-standards.md](core/changelog-standards.md))
|
|
320
|
+
|
|
321
|
+
5. **工作流合规性**
|
|
322
|
+
- [ ] 分支命名正确(`feature/`、`fix/`、`docs/`、`chore/`)
|
|
323
|
+
- [ ] 提交信息遵循 Conventional Commits 规范
|
|
324
|
+
- [ ] 与目标分支同步
|
|
325
|
+
|
|
326
|
+
### ❌ Never Commit When / 绝不在以下情况提交
|
|
327
|
+
|
|
328
|
+
- 构建存在错误
|
|
329
|
+
- 测试失败
|
|
330
|
+
- 功能未完成且会破坏功能性
|
|
331
|
+
- 包含针对关键逻辑的 WIP/TODO 注释
|
|
332
|
+
- 包含调试代码(console.log、print 语句)
|
|
333
|
+
- 包含被注释掉的代码块
|
|
334
|
+
|
|
335
|
+
### Quick Verification Commands / 快速验证命令
|
|
336
|
+
|
|
337
|
+
```bash
|
|
338
|
+
# In cli/ directory
|
|
339
|
+
npm run lint # Check code style
|
|
340
|
+
npm test # Run all tests
|
|
341
|
+
npm run build # Verify build (if applicable)
|
|
342
|
+
```
|
|
343
|
+
|
|
344
|
+
### Reference / 参考
|
|
345
|
+
|
|
346
|
+
完整签入规范请参阅 [core/checkin-standards.md](core/checkin-standards.md)
|
|
347
|
+
|
|
348
|
+
---
|
|
349
|
+
|
|
165
350
|
## AI 协作指南
|
|
166
351
|
|
|
167
|
-
|
|
352
|
+
在此项目中使用 AI 助手(Claude Code、Cursor 等)时:
|
|
353
|
+
|
|
354
|
+
### Conversation Language / 对话语言
|
|
355
|
+
|
|
356
|
+
- **与 AI 助手的所有对话均应使用繁体中文(繁体中文)进行**
|
|
357
|
+
- AI 助手应以繁体中文回复用户的问题与请求
|
|
168
358
|
|
|
169
359
|
### 应该做的:
|
|
170
360
|
- 参考 `core/` 中现有标准以保持一致性
|
|
171
|
-
-
|
|
361
|
+
- 文档遵循双语格式(英文 + 繁体中文)
|
|
172
362
|
- 修改核心规范后检查翻译同步
|
|
173
|
-
-
|
|
363
|
+
- 提交前执行测试和代码检查
|
|
174
364
|
|
|
175
365
|
### 不应该做的:
|
|
176
|
-
-
|
|
177
|
-
-
|
|
178
|
-
- 跳过 PR
|
|
179
|
-
-
|
|
366
|
+
- 创建新标准时不遵循现有模板结构
|
|
367
|
+
- 修改翻译文件而不更新源文件
|
|
368
|
+
- 跳过 PR 的代码审查检查清单
|
|
369
|
+
- 在核心规范中引入特定语言或特定框架的内容
|
|
370
|
+
- 未先阅读代码便对其做出断言(参见反幻觉规范)
|
|
371
|
+
- 未先运行测试便提交代码
|
|
180
372
|
|
|
181
373
|
### 专案特定脉络:
|
|
182
|
-
-
|
|
374
|
+
- 本项目使用 ES Modules(非 CommonJS)
|
|
183
375
|
- 所有核心规范应保持语言/框架无关
|
|
184
|
-
-
|
|
185
|
-
- CLI
|
|
376
|
+
- 需要双语文档(英文为主,zh-TW 翻译)
|
|
377
|
+
- CLI 工具是主要代码组件;大部分内容是 Markdown
|
|
378
|
+
|
|
379
|
+
### BDD/TDD Output Directories / BDD/TDD 输出目录
|
|
380
|
+
|
|
381
|
+
从 SDD 规格生成 BDD 和 TDD 文件时:
|
|
382
|
+
|
|
383
|
+
| 类型 | 目录 | 说明 |
|
|
384
|
+
|------|-----------|-------------|
|
|
385
|
+
| BDD Features | `tests/features/` | Gherkin .feature 文件 |
|
|
386
|
+
| TDD Unit Tests | `cli/tests/unit/` | Vitest 单元测试 |
|
|
387
|
+
| SDD Specs | `docs/specs/` | 规格文档 |
|
|
388
|
+
|
|
389
|
+
**BDD Feature 文件格式:**
|
|
390
|
+
- 包含 `@SPEC-XXX` 和 `@AC-N` 标签以供追溯
|
|
391
|
+
- 包含 `# [Source: path:AC-N]` 注释以标明来源
|
|
392
|
+
- 每个 AC 一个 Scenario(1:1 映射)
|
|
393
|
+
|
|
394
|
+
**TDD 测试文件格式:**
|
|
395
|
+
- 嵌套 describe:SPEC 层级 → AC 层级
|
|
396
|
+
- AAA 模式注释(Arrange-Act-Assert)
|
|
397
|
+
- 使用 `[TODO]` 标记作为实现的占位符
|
|
398
|
+
|
|
399
|
+
### Anti-Hallucination Standards / 反幻觉规范
|
|
400
|
+
|
|
401
|
+
在此项目上工作时,AI 助手必须遵循 [core/anti-hallucination.md](core/anti-hallucination.md):
|
|
402
|
+
|
|
403
|
+
| 要求 | 说明 |
|
|
404
|
+
|-------------|-------------|
|
|
405
|
+
| **基于证据** | 仅分析已明确阅读的内容 |
|
|
406
|
+
| **来源归属** | 使用包含 file:line 引用的 `[Source: Code]`、`[Source: Docs]` 标签 |
|
|
407
|
+
| **确定性分类** | 使用 `[Confirmed]`、`[Inferred]`、`[Assumption]`、`[Unknown]` 标签 |
|
|
408
|
+
| **提供建议** | 提供选择时始终包含推荐选项及理由 |
|
|
409
|
+
| **绝不捏造** | 未经核实绝不捏造 API、配置或需求 |
|
|
410
|
+
|
|
411
|
+
### Code Review Standards / 代码审查规范
|
|
412
|
+
|
|
413
|
+
审查代码或 PR 时,请遵循 [core/code-review-checklist.md](core/code-review-checklist.md):
|
|
414
|
+
|
|
415
|
+
**审查清单类别:**
|
|
416
|
+
1. 功能性 - 是否正确运行?
|
|
417
|
+
2. 设计与架构 - 是否遵循项目模式?
|
|
418
|
+
3. 代码质量 - 是否整洁、符合 DRY、SOLID 原则?
|
|
419
|
+
4. 可读性 - 是否易于理解?
|
|
420
|
+
5. 测试 - 覆盖率是否充分?
|
|
421
|
+
6. 安全性 - 是否无安全漏洞?
|
|
422
|
+
7. 性能 - 是否高效?
|
|
423
|
+
8. 错误处理 - 是否得到妥善处理?
|
|
424
|
+
9. 文档 - 是否已更新?
|
|
425
|
+
10. 依赖项 - 是否合理必要?
|
|
426
|
+
|
|
427
|
+
**评论前缀:**
|
|
428
|
+
|
|
429
|
+
| 前缀 | 含义 |
|
|
430
|
+
|--------|---------|
|
|
431
|
+
| ❗ BLOCKING | 合并前必须修复 |
|
|
432
|
+
| ⚠️ IMPORTANT | 应该修复 |
|
|
433
|
+
| 💡 SUGGESTION | 优化建议(有则更好) |
|
|
434
|
+
| ❓ QUESTION | 需要进一步澄清 |
|
|
435
|
+
|
|
436
|
+
### Testing Standards / 测试规范
|
|
186
437
|
|
|
187
|
-
|
|
438
|
+
有关测试要求,请遵循 [core/testing-standards.md](core/testing-standards.md):
|
|
439
|
+
|
|
440
|
+
**测试金字塔(默认比例):**
|
|
441
|
+
|
|
442
|
+
| 层级 | 比例 | 目的 |
|
|
443
|
+
|-------|-------|---------|
|
|
444
|
+
| 单元测试 (UT) | 70% | 测试单个函数/方法 |
|
|
445
|
+
| 集成测试 (IT) | 20% | 测试组件交互 |
|
|
446
|
+
| E2E 测试 | 10% | 测试用户工作流程 |
|
|
447
|
+
|
|
448
|
+
**关键要求:**
|
|
449
|
+
- 所有新功能必须具有对应的测试
|
|
450
|
+
- 提交前运行测试
|
|
451
|
+
- 保持或提高测试覆盖率
|
|
452
|
+
- 使用遵循 `should_[expected]_when_[condition]` 模式的描述性测试名称
|
|
453
|
+
|
|
454
|
+
### Standards Compliance Reference / 规范合规参考
|
|
188
455
|
|
|
189
456
|
| 任务 | 必须遵循 | 参考 |
|
|
457
|
+
|------|-------------|-----------|
|
|
458
|
+
| 代码分析 | 反幻觉标准 | [core/anti-hallucination.md](core/anti-hallucination.md) |
|
|
459
|
+
| PR 审查 | 代码审查清单 | [core/code-review-checklist.md](core/code-review-checklist.md) |
|
|
460
|
+
| 新增功能 | 测试标准 | [core/testing-standards.md](core/testing-standards.md) |
|
|
461
|
+
| 任何提交 | 提交规范 | [core/checkin-standards.md](core/checkin-standards.md) |
|
|
462
|
+
| 新功能设计 | 规格驱动开发 | [core/spec-driven-development.md](core/spec-driven-development.md) |
|
|
463
|
+
| 新增/修改 Core↔Skill | /sdd + Sync Check | 参见下方的“Core↔Skill 同步规则” |
|
|
464
|
+
| 追溯性规格追踪 | /sdd-retro | 参见下方的“规格追踪” |
|
|
465
|
+
| 撰写 AI 指令 | AI 指令标准 | [core/ai-instruction-standards.md](core/ai-instruction-standards.md) |
|
|
466
|
+
| 撰写文档 | 文档撰写标准 | [core/documentation-writing-standards.md](core/documentation-writing-standards.md) |
|
|
467
|
+
| 面向 AI 的项目架构 | AI 友好架构 | [core/ai-friendly-architecture.md](core/ai-friendly-architecture.md) |
|
|
468
|
+
| 标准加载策略 | 上下文感知加载 | [core/context-aware-loading.md](core/context-aware-loading.md) |
|
|
469
|
+
| 跨会话状态 | 项目上下文记忆 | [core/project-context-memory.md](core/project-context-memory.md) |
|
|
470
|
+
|
|
471
|
+
---
|
|
472
|
+
|
|
473
|
+
## 采用层整合策略
|
|
474
|
+
|
|
475
|
+
UDS 定位为**纯标准库**(Standards Definition Library)。它定义“该做什么”,并通过 `.standards/` 由任意采用层(Adapters / Pipelines / Agents / IDE)读取与执行。UDS 本身**不绑定**任何特定下游产品、不提供 runtime、不指定授权模式。
|
|
476
|
+
|
|
477
|
+
```
|
|
478
|
+
UDS(标准定义;MIT + CC BY 4.0)──→ 采用层(任意 Adapter / Pipeline / Agent / IDE)
|
|
479
|
+
```
|
|
480
|
+
|
|
481
|
+
### UDS 的角色
|
|
482
|
+
|
|
483
|
+
1. **标准来源**:UDS 定义 70+ 项标准供任意采用层消费
|
|
484
|
+
2. **工具无关**:UDS 支持 12+ 种 AI 工具与一般 CI / IDE 整合
|
|
485
|
+
3. **授权独立**:UDS 采 MIT + CC BY 4.0;采用层的授权选择与 UDS 无关
|
|
486
|
+
|
|
487
|
+
### 标准如何流向采用层
|
|
488
|
+
|
|
489
|
+
| 流向 | 机制 | 说明 |
|
|
490
|
+
|------|------|------|
|
|
491
|
+
| UDS → 采用层 | `.standards/` copy-once | 采用层通过 `uds init` 安装标准,于 Quality Gate / Agent prompt / IDE rule 中读取 |
|
|
492
|
+
| UDS → CI 整合 | `.standards/` 引用 | CI / pre-commit hook 读取对应 `.ai.yaml` 进行验证 |
|
|
493
|
+
| UDS → 采用层 bridges | 例如 TestPolicy 格式 | 采用层在 UDS 之上建立特定 bridge(如 test-governance → TestPolicy)|
|
|
494
|
+
|
|
495
|
+
### 对 UDS 开发的影响
|
|
496
|
+
|
|
497
|
+
- 新增/修改标准时,需考虑**通用采用场景**(不假设特定下游产品的内部结构)
|
|
498
|
+
- 标准格式需保持中性、可携(不嵌入采用层的实现细节)
|
|
499
|
+
- 标准的 scope 标记(universal/partial/uds-specific)影响可携性
|
|
500
|
+
|
|
501
|
+
---
|
|
502
|
+
|
|
503
|
+
<!-- UDS:STANDARDS:START -->
|
|
504
|
+
<!-- WARNING: This block is managed by UDS (universal-dev-standards). DO NOT manually edit. Use 'npx universal-dev-standards install' or 'npx universal-dev-standards update' to modify. -->
|
|
505
|
+
<!-- WARNING: This block is managed by UDS (universal-dev-standards). DO NOT manually edit. Use 'npx universal-dev-standards install' or 'npx universal-dev-standards update' to modify. -->
|
|
506
|
+
## Commit 消息语言
|
|
507
|
+
以**双语**格式(英文 + 繁体中文)编写 commit 消息。
|
|
508
|
+
格式:`<type>(<scope>): <English>. <中文>.`
|
|
509
|
+
正文必须为双语:英文在前 → 空行 → 中文在后。切勿在同一段落中混用语言。
|
|
510
|
+
|
|
511
|
+
## 规范合规说明
|
|
512
|
+
|
|
513
|
+
**MUST follow**(每次都要遵守):
|
|
514
|
+
| 任务 | 标准 | 何时 |
|
|
515
|
+
|------|----------|------|
|
|
516
|
+
| 编写 commit | [commit-message.ai.yaml](../../.standards/commit-message.ai.yaml) | 每次 commit |
|
|
517
|
+
| 项目上下文 | [project-context-memory.ai.yaml](../../.standards/project-context-memory.ai.yaml) | 规划与编码 |
|
|
518
|
+
|
|
519
|
+
**SHOULD follow**(相关任务时参考):
|
|
520
|
+
| 任务 | 标准 | 何时 |
|
|
190
521
|
|------|----------|------|
|
|
191
|
-
|
|
|
192
|
-
|
|
|
193
|
-
|
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
522
|
+
| Git 工作流 | [git-workflow.ai.yaml](../../.standards/git-workflow.ai.yaml) | 分支/合并决策 |
|
|
523
|
+
| 编写测试 | [testing.ai.yaml](../../.standards/testing.ai.yaml) | 创建测试时 |
|
|
524
|
+
| 开发者记忆 | [developer-memory.ai.yaml](../../.standards/developer-memory.ai.yaml) | 始终(协议) |
|
|
525
|
+
|
|
526
|
+
## 已安装标准索引
|
|
527
|
+
|
|
528
|
+
本项目采用 UDS 标准。所有规范位于 `.standards/`:
|
|
529
|
+
|
|
530
|
+
### 核心 (55 个标准)
|
|
531
|
+
- `anti-hallucination.ai.yaml` - anti-hallucination.ai.yaml
|
|
532
|
+
- `ai-friendly-architecture.ai.yaml` - ai-friendly-architecture.ai.yaml
|
|
533
|
+
- `commit-message.ai.yaml` - 提交信息格式
|
|
534
|
+
- `english.ai.yaml` - english.ai.yaml
|
|
535
|
+
- `checkin-standards.ai.yaml` - checkin-standards.ai.yaml
|
|
536
|
+
- `spec-driven-development.ai.yaml` - spec-driven-development.ai.yaml
|
|
537
|
+
- `code-review.ai.yaml` - code-review.ai.yaml
|
|
538
|
+
- `git-workflow.ai.yaml` - Git 工作流程
|
|
539
|
+
- `github-flow.ai.yaml` - github-flow.ai.yaml
|
|
540
|
+
- `squash-merge.ai.yaml` - squash-merge.ai.yaml
|
|
541
|
+
- `versioning.ai.yaml` - versioning.ai.yaml
|
|
542
|
+
- `changelog.ai.yaml` - changelog.ai.yaml
|
|
543
|
+
- `testing.ai.yaml` - 测试标准
|
|
544
|
+
- `unit-testing.ai.yaml` - unit-testing.ai.yaml
|
|
545
|
+
- `integration-testing.ai.yaml` - integration-testing.ai.yaml
|
|
546
|
+
- `documentation-structure.ai.yaml` - documentation-structure.ai.yaml
|
|
547
|
+
- `documentation-writing-standards.ai.yaml` - documentation-writing-standards.ai.yaml
|
|
548
|
+
- `ai-instruction-standards.ai.yaml` - ai-instruction-standards.ai.yaml
|
|
549
|
+
- `project-structure.ai.yaml` - project-structure.ai.yaml
|
|
550
|
+
- `error-codes.ai.yaml` - error-codes.ai.yaml
|
|
551
|
+
- `logging.ai.yaml` - logging.ai.yaml
|
|
552
|
+
- `test-completeness-dimensions.ai.yaml` - test-completeness-dimensions.ai.yaml
|
|
553
|
+
- `test-driven-development.ai.yaml` - test-driven-development.ai.yaml
|
|
554
|
+
- `behavior-driven-development.ai.yaml` - behavior-driven-development.ai.yaml
|
|
555
|
+
- `acceptance-test-driven-development.ai.yaml` - acceptance-test-driven-development.ai.yaml
|
|
556
|
+
- `reverse-engineering-standards.ai.yaml` - reverse-engineering-standards.ai.yaml
|
|
557
|
+
- `forward-derivation-standards.ai.yaml` - forward-derivation-standards.ai.yaml
|
|
558
|
+
- `ai-agreement-standards.ai.yaml` - ai-agreement-standards.ai.yaml
|
|
559
|
+
- `virtual-organization-standards.ai.yaml` - virtual-organization-standards.ai.yaml
|
|
560
|
+
- `refactoring-standards.ai.yaml` - refactoring-standards.ai.yaml
|
|
561
|
+
- `requirement-engineering.ai.yaml` - requirement-engineering.ai.yaml
|
|
562
|
+
- `security-standards.ai.yaml` - security-standards.ai.yaml
|
|
563
|
+
- `performance-standards.ai.yaml` - performance-standards.ai.yaml
|
|
564
|
+
- `accessibility-standards.ai.yaml` - accessibility-standards.ai.yaml
|
|
565
|
+
- `requirement-checklist.md` - requirement-checklist.md
|
|
566
|
+
- `requirement-template.md` - requirement-template.md
|
|
567
|
+
- `requirement-document-template.md` - requirement-document-template.md
|
|
568
|
+
- `deployment-standards.ai.yaml` - deployment-standards.ai.yaml
|
|
569
|
+
- `developer-memory.ai.yaml` - 开发者持久记忆
|
|
570
|
+
- `project-context-memory.ai.yaml` - 项目情境记忆
|
|
571
|
+
- `context-aware-loading.ai.yaml` - context-aware-loading.ai.yaml
|
|
572
|
+
- `test-governance.ai.yaml` - test-governance.ai.yaml
|
|
573
|
+
- `structured-task-definition.ai.yaml` - structured-task-definition.ai.yaml
|
|
574
|
+
- `acceptance-criteria-traceability.ai.yaml` - acceptance-criteria-traceability.ai.yaml
|
|
575
|
+
- `api-design-standards.ai.yaml` - api-design-standards.ai.yaml
|
|
576
|
+
- `database-standards.ai.yaml` - database-standards.ai.yaml
|
|
577
|
+
- `systematic-debugging.ai.yaml` - systematic-debugging.ai.yaml
|
|
578
|
+
- `model-selection.ai.yaml` - model-selection.ai.yaml
|
|
579
|
+
- `git-worktree.ai.yaml` - git-worktree.ai.yaml
|
|
580
|
+
- `verification-evidence.ai.yaml` - verification-evidence.ai.yaml
|
|
581
|
+
- `ai-command-behavior.ai.yaml` - ai-command-behavior.ai.yaml
|
|
582
|
+
- `ai-response-navigation.ai.yaml` - ai-response-navigation.ai.yaml
|
|
583
|
+
- `documentation-lifecycle.ai.yaml` - documentation-lifecycle.ai.yaml
|
|
584
|
+
- `adr-standards.ai.yaml` - adr-standards.ai.yaml
|
|
585
|
+
- `retrospective-standards.ai.yaml` - retrospective-standards.ai.yaml
|
|
586
|
+
- `dual-phase-output.ai.yaml` - 双阶段 LLM 输出标准(<analysis> 丢弃 + <summary> 保留)
|
|
587
|
+
- `circuit-breaker.ai.yaml` - 通用断路器(三态 CLOSED/HALF_OPEN/OPEN,防 API 雪崩)
|
|
588
|
+
- `token-budget.ai.yaml` - Token 阈值四区模型(安全/警告/危险/阻塞)
|
|
589
|
+
- `security-decision.ai.yaml` - 安全决策铁律(deny > ask > allow 优先级仲裁)
|
|
590
|
+
- `capability-declaration.ai.yaml` - Fail-Closed 能力声明(工具/Adapter 默认不安全)
|
|
591
|
+
<!-- UDS:STANDARDS:END -->
|
|
592
|
+
|
|
593
|
+
---
|
|
594
|
+
|
|
595
|
+
## Post-Modification Verification / 修改后验证
|
|
596
|
+
|
|
597
|
+
**重要提示**:完成以下任何修改后,AI 助手必须验证所有相关文件是否已更新(具体内容见下文各节)。完整的维护工作流在 AsiaOstrich dev-platform 规划中心(`cross-project/ops/uds-operation.md`)内部进行跟踪。
|
|
198
598
|
|
|
199
|
-
|
|
599
|
+
| 修改类型 | 关键检查项 |
|
|
600
|
+
|---|---|
|
|
601
|
+
| 添加/修改核心标准 | 更新 registry、翻译、Related Standards 章节 |
|
|
602
|
+
| 添加/修改 skill | 更新 skillFiles 映射、skill 数量测试 |
|
|
603
|
+
| 添加/修改 AI 工具集成 | 更新 ai-agent-paths.js、CLAUDE.md 的 integrations 列表 |
|
|
604
|
+
| 准备发布 | 运行 bump-version.mjs、更新 CHANGELOG、验证同步脚本 |
|
|
605
|
+
| 任何多文件变更 | 运行 check-standards-sync.sh + check-translation-sync.sh |
|
|
606
|
+
| 添加/修改安装命令 | 跨平台命令同步(见下文) |
|
|
607
|
+
|
|
608
|
+
### 快速验证(所有变更)
|
|
609
|
+
|
|
610
|
+
在进行任何修改后,运行:
|
|
611
|
+
```bash
|
|
612
|
+
# Run all checks at once (recommended)
|
|
613
|
+
./scripts/pre-release-check.sh
|
|
614
|
+
|
|
615
|
+
# Or run individual checks:
|
|
616
|
+
./scripts/check-standards-sync.sh
|
|
617
|
+
./scripts/check-translation-sync.sh
|
|
618
|
+
./scripts/check-version-sync.sh
|
|
619
|
+
./scripts/check-ai-agent-sync.sh
|
|
620
|
+
./scripts/check-spec-sync.sh # Core↔Skill sync
|
|
621
|
+
./scripts/check-scope-sync.sh # Scope universality check
|
|
622
|
+
./scripts/check-docs-integrity.sh # Documentation integrity
|
|
623
|
+
./scripts/check-orphan-specs.sh # Orphan spec detection
|
|
624
|
+
npx tsx scripts/check-ai-behavior-sync.ts # AI Agent Behavior coverage
|
|
625
|
+
cd cli && npm test && npm run lint
|
|
626
|
+
```
|
|
627
|
+
|
|
628
|
+
> **AI Agent 同步检查 SOP**:AI Agent 同步 SOP 在 dev-platform 规划中心(`cross-project/ops/uds-ai-agent-sync-sop.md`)内部进行维护。
|
|
629
|
+
|
|
630
|
+
### Core↔Skill Sync Rules (UDS-specific) / Core↔Skill 同步规则
|
|
631
|
+
|
|
632
|
+
> ⚠️ 本节专属于 UDS 项目。UDS 项目维护 Core Standard、Skill 与 Command 之间的双向关系。
|
|
633
|
+
|
|
634
|
+
#### Sync Architecture / 同步架构
|
|
635
|
+
|
|
636
|
+
```
|
|
637
|
+
Core Standard ◄──────────► Skill ◄──────────► Command
|
|
638
|
+
│ │ │
|
|
639
|
+
└───────────────────────┴───────────────────┘
|
|
640
|
+
▼
|
|
641
|
+
Translations
|
|
642
|
+
```
|
|
643
|
+
|
|
644
|
+
#### Sync Matrix / 同步矩阵
|
|
645
|
+
|
|
646
|
+
| 变更来源 | 必须评估同步至 |
|
|
647
|
+
|---|---|
|
|
648
|
+
| Core Standard | → Skill, Command, AI YAML, Translations |
|
|
649
|
+
| Skill | → Core Standard(如适用), Command, Translations |
|
|
650
|
+
| Command | → Skill, Translations |
|
|
651
|
+
|
|
652
|
+
#### Core↔Skill Mapping / Core↔Skill 对应
|
|
653
|
+
|
|
654
|
+
| 类别 | 描述 | 示例 |
|
|
655
|
+
|---|---|---|
|
|
656
|
+
| **Has Core Standard** | Skill 实现了一项 Core Standard | `commit-standards` ↔ `commit-message-guide.md` |
|
|
657
|
+
| **Utility Skill** | 无需 Core Standard(工具/生成器) | `docs-generator`, `code-formatter` |
|
|
658
|
+
| **Static Skill** | 仅供参考,无交互 | 仅链接至标准的 Skill |
|
|
659
|
+
|
|
660
|
+
#### Mandatory /sdd Workflow | 强制 /sdd 工作流程
|
|
661
|
+
|
|
662
|
+
**以下任何变更必须首先使用 `/sdd`:**
|
|
663
|
+
|
|
664
|
+
1. **Adding Features | 新增功能**
|
|
665
|
+
- 新增 Core Standard
|
|
666
|
+
- 新增 Skill
|
|
667
|
+
- 新增 Slash Command
|
|
668
|
+
|
|
669
|
+
2. **Modifying Features | 修改功能**
|
|
670
|
+
- 修改 Core Standard 内容
|
|
671
|
+
- 修改 Skill 行为
|
|
672
|
+
- 修改 Command 功能
|
|
673
|
+
|
|
674
|
+
3. **Removing Features | 移除功能**
|
|
675
|
+
- 移除标准
|
|
676
|
+
- 移除 Skill/Command
|
|
677
|
+
|
|
678
|
+
**例外情况(可跳过 /sdd):**
|
|
679
|
+
- 错别字修复
|
|
680
|
+
- 格式调整
|
|
681
|
+
- 纯翻译更新
|
|
682
|
+
- 紧急热修复(必须事后补充文档记录)
|
|
683
|
+
|
|
684
|
+
#### Sync Check Script / 同步检查脚本
|
|
685
|
+
|
|
686
|
+
**macOS / Linux:**
|
|
687
|
+
```bash
|
|
688
|
+
./scripts/check-spec-sync.sh
|
|
689
|
+
```
|
|
690
|
+
|
|
691
|
+
**Windows PowerShell:**
|
|
692
|
+
```powershell
|
|
693
|
+
.\scripts\check-spec-sync.ps1
|
|
694
|
+
```
|
|
695
|
+
|
|
696
|
+
预期输出:
|
|
697
|
+
```
|
|
698
|
+
✓ commit-standards ↔ core/commit-message-guide.md
|
|
699
|
+
✓ testing-guide ↔ core/testing-standards.md
|
|
700
|
+
⚠ docs-generator (utility, no core standard required)
|
|
701
|
+
✓ All Skills synced with Core Standards
|
|
702
|
+
```
|
|
703
|
+
|
|
704
|
+
### Spec Tracking / Spec 追踪
|
|
705
|
+
|
|
706
|
+
三种机制确保 spec 的可追溯性:
|
|
707
|
+
|
|
708
|
+
1. **`/commit` spec 评估** — 对于 `feat`/`fix` 提交,AI 会建议创建或关联 spec。详情见 [`skills/commands/commit.md`](skills/commands/commit.md)。
|
|
709
|
+
2. **`/sdd-retro`** — 为未跟踪的提交(例如紧急热修复)事后补充创建 spec。详情见 [`skills/commands/sdd-retro.md`](skills/commands/sdd-retro.md)。
|
|
710
|
+
3. **孤立 spec 检测** — `check-orphan-specs.sh` 会标记停滞在非终态的 spec。已作为步骤 15 集成到 `pre-release-check.sh` 中(仅警告)。
|
|
711
|
+
|
|
712
|
+
### Scope Universality System / Scope 通用性标记系统
|
|
713
|
+
|
|
714
|
+
所有 Core Standard 与 Skill 均带有 `scope` 字段标记,以指明其通用性:
|
|
715
|
+
|
|
716
|
+
| Scope | 描述 | 用法 |
|
|
717
|
+
|---|---|---|
|
|
718
|
+
| `universal` | 完全通用,可用于任何项目 | 可直接原样采用 |
|
|
719
|
+
| `partial` | 概念通用,但包含 UDS 特有的细节 | 采用前需审查 |
|
|
720
|
+
| `uds-specific` | UDS 项目特有的工具或工作流 | 仅供内部使用 |
|
|
721
|
+
|
|
722
|
+
#### Scope Distribution / 分布统计
|
|
723
|
+
|
|
724
|
+
**当前分布:**
|
|
725
|
+
- **Core Standards**:14 个 universal (61%),7 个 partial (30%),2 个 uds-specific (9%)
|
|
726
|
+
- **Skills**:12 个 universal (48%),10 个 partial (40%),3 个 uds-specific (12%)
|
|
727
|
+
|
|
728
|
+
#### Where to Find Scope Markers / 标记位置
|
|
729
|
+
|
|
730
|
+
- **Skills**:位于 `SKILL.md` 的 YAML frontmatter 中
|
|
731
|
+
```yaml
|
|
732
|
+
---
|
|
733
|
+
name: skill-name
|
|
734
|
+
scope: universal
|
|
735
|
+
description: ...
|
|
736
|
+
---
|
|
737
|
+
```
|
|
738
|
+
|
|
739
|
+
- **Core Standards**:位于 markdown 元数据中
|
|
740
|
+
```markdown
|
|
741
|
+
**Applicability**: All software projects
|
|
742
|
+
**Scope**: universal
|
|
743
|
+
```
|
|
744
|
+
|
|
745
|
+
#### Scope Check Script / 范围检查脚本
|
|
746
|
+
|
|
747
|
+
**macOS / Linux:**
|
|
748
|
+
```bash
|
|
749
|
+
./scripts/check-scope-sync.sh
|
|
750
|
+
```
|
|
751
|
+
|
|
752
|
+
**Windows PowerShell:**
|
|
753
|
+
```powershell
|
|
754
|
+
.\scripts\check-scope-sync.ps1
|
|
755
|
+
```
|
|
756
|
+
|
|
757
|
+
### Cross-Platform Command Sync (UDS-specific) / 跨平台指令同步
|
|
758
|
+
|
|
759
|
+
> ⚠️ 本节专属于 UDS 项目。并非所有项目都需要维护带有跨平台命令的双语翻译。
|
|
760
|
+
|
|
761
|
+
#### When to Check / 何时检查
|
|
762
|
+
|
|
763
|
+
修改以下这些 UDS 项目文件后,请验证跨平台命令同步:
|
|
764
|
+
- 采用指南(`adoption/`)
|
|
765
|
+
- Skill 安装说明(`skills/*/README.md`)
|
|
766
|
+
- 维护指南(`ai/MAINTENANCE.md`)
|
|
767
|
+
- 检查清单(`adoption/checklists/`)
|
|
768
|
+
|
|
769
|
+
#### Files Requiring Sync / 需要同步的文件
|
|
770
|
+
|
|
771
|
+
有 33 个文件需要维护跨平台命令:
|
|
772
|
+
- 英文源文件:11 个文件
|
|
773
|
+
- zh-TW 翻译:11 个文件
|
|
774
|
+
- zh-CN 翻译:11 个文件
|
|
775
|
+
|
|
776
|
+
#### Standard Command Equivalents / 标准指令对照
|
|
777
|
+
|
|
778
|
+
| Bash | PowerShell | Purpose / 用途 |
|
|
779
|
+
|---|---|---|
|
|
780
|
+
| `cp file dest/` | `Copy-Item file dest\` | Copy file / 复制文件 |
|
|
781
|
+
| `cp -r dir/ dest/` | `Copy-Item -Recurse dir\ dest\` | Recursive copy / 递归复制 |
|
|
782
|
+
| `mkdir -p dir` | `New-Item -ItemType Directory -Force -Path dir` | Create directory / 创建目录 |
|
|
783
|
+
| `~/` | `$env:USERPROFILE\` | User home / 用户目录 |
|
|
784
|
+
| `./script.sh` | `.\script.ps1` | Run script / 执行脚本 |
|
|
785
|
+
|
|
786
|
+
#### Labeling Convention / 标签惯例
|
|
787
|
+
|
|
788
|
+
对平台特定的代码块使用以下标签:
|
|
789
|
+
- `**macOS / Linux:**` 后接 bash 代码块
|
|
790
|
+
- `**Windows PowerShell:**` 后接 powershell 代码块
|
|
791
|
+
|
|
792
|
+
---
|
|
793
|
+
|
|
794
|
+
## 发布流程
|
|
795
|
+
|
|
796
|
+
准备发布或协助进行版本管理时:
|
|
797
|
+
|
|
798
|
+
### 参考文档
|
|
799
|
+
|
|
800
|
+
- **完整发布工作流**:[skills/release-standards/release-workflow.md](skills/release-standards/release-workflow.md)
|
|
801
|
+
- **语义化版本**:[skills/release-standards/semantic-versioning.md](skills/release-standards/semantic-versioning.md)
|
|
802
|
+
- **版本规范**:[core/versioning.md](core/versioning.md)
|
|
803
|
+
- **CHANGELOG 格式**:[skills/release-standards/changelog-format.md](skills/release-standards/changelog-format.md)
|
|
804
|
+
|
|
805
|
+
### AI 助手关键要点
|
|
806
|
+
|
|
807
|
+
1. **绝不要手动运行 `npm publish`**:GitHub Actions 会自动处理此操作
|
|
808
|
+
2. **版本检测是自动的**:`.github/workflows/publish.yml` 会检测版本类型并使用正确的 npm 标签
|
|
809
|
+
3. **始终遵循检查清单**:release-workflow.md 中的预发布检查
|
|
810
|
+
4. **CHANGELOG 优先**:在创建发布之前更新 CHANGELOG.md
|
|
811
|
+
|
|
812
|
+
### 发布类型
|
|
813
|
+
|
|
814
|
+
| 类型 | 版本模式 | npm 标签 | 自动检测 |
|
|
815
|
+
|------|----------------|---------|---------------|
|
|
816
|
+
| Stable | `X.Y.Z` | `@latest` | ✅ 是 |
|
|
817
|
+
| Beta | `X.Y.Z-beta.N` | `@beta` | ✅ 是 |
|
|
818
|
+
| Alpha | `X.Y.Z-alpha.N` | `@alpha` | ✅ 是 |
|
|
819
|
+
| RC | `X.Y.Z-rc.N` | `@rc` | ✅ 是 |
|
|
820
|
+
|
|
821
|
+
### AI 助手工作流
|
|
822
|
+
|
|
823
|
+
当用户要求准备发布时:
|
|
824
|
+
|
|
825
|
+
1. **询问发布类型**:beta、alpha、rc 或 stable
|
|
826
|
+
2. **运行预发布检查**:测试、代码检查(linting)、git 状态
|
|
827
|
+
3. **运行 `bump-version.mjs`** —— 原子化更新所有版本文件(请参阅下方的 UDS 专属小节)
|
|
828
|
+
4. **更新 CHANGELOG.md**(EN + zh-TW + zh-CN):遵循 release-workflow.md 中的格式
|
|
829
|
+
5. **提交、打标签、推送**:`git add -A && git commit && git tag vX.Y.Z && git push origin main vX.Y.Z`
|
|
830
|
+
6. **创建 GitHub Release**:使用 `gh release create` 命令
|
|
831
|
+
|
|
832
|
+
> ⚠️ **绝不要手动更新单个版本文件**。始终使用 `node scripts/bump-version.mjs`(或其 macOS/Linux 包装脚本 `scripts/bump-version.sh`)以避免遗漏文件。
|
|
833
|
+
|
|
834
|
+
### UDS 项目特定发布步骤
|
|
835
|
+
|
|
836
|
+
> ⚠️ **重要**:本节包含除标准发布工作流之外必须遵循的 UDS 特定要求。
|
|
837
|
+
|
|
838
|
+
#### 步骤 0:运行 bump-version.mjs(强制)
|
|
839
|
+
|
|
840
|
+
**始终使用版本更新脚本** —— 它会以原子方式更新所有文件并运行验证:
|
|
841
|
+
|
|
842
|
+
```bash
|
|
843
|
+
# Cross-platform (macOS / Linux / Windows) — the only copy of the bump logic
|
|
844
|
+
node scripts/bump-version.mjs 5.2.0-beta.1 # Pre-release
|
|
845
|
+
node scripts/bump-version.mjs 5.2.0 # Stable
|
|
846
|
+
|
|
847
|
+
# macOS / Linux convenience wrapper (thin exec into the .mjs above):
|
|
848
|
+
./scripts/bump-version.sh 5.2.0-beta.1
|
|
849
|
+
./scripts/bump-version.sh 5.2.0
|
|
850
|
+
|
|
851
|
+
# After bump-version.mjs:
|
|
852
|
+
# → Update CHANGELOG.md (EN + zh-TW + zh-CN) manually
|
|
853
|
+
# → git add -A && git commit -m "chore(release): X.Y.Z"
|
|
854
|
+
# → git tag vX.Y.Z && git push origin main vX.Y.Z
|
|
855
|
+
```
|
|
856
|
+
|
|
857
|
+
该脚本会自动处理这些文件:
|
|
858
|
+
|
|
859
|
+
| 文件 | 字段 | Alpha/Beta/RC | Stable |
|
|
860
|
+
|------|-------|---------------|--------|
|
|
861
|
+
| `cli/package.json` | `"version"` | ✅ 自动 | ✅ 自动 |
|
|
862
|
+
| `cli/package-lock.json` | `"version"` + `packages[""].version` | ✅ 自动 | ✅ 自动 |
|
|
863
|
+
| `cli/standards-registry.json` | `"version"`(3 处) | ✅ 自动 | ✅ 自动 |
|
|
864
|
+
| `uds-manifest.json` | `"version"` + `"last_updated"` | ✅ 自动 | ✅ 自动 |
|
|
865
|
+
| `README.md` | `**Version**:` | ✅ 自动 | ✅ 自动 |
|
|
866
|
+
| `locales/zh-TW/README.md` | `**版本**:` | ✅ 自动 | ✅ 自动 |
|
|
867
|
+
| `locales/zh-CN/README.md` | `**版本**:` | ✅ 自动 | ✅ 自动 |
|
|
868
|
+
| `locales/zh-TW/CHANGELOG.md` | frontmatter | ✅ 自动 | ✅ 自动 |
|
|
869
|
+
| `locales/zh-CN/CHANGELOG.md` | frontmatter | ✅ 自动 | ✅ 自动 |
|
|
870
|
+
| `.claude-plugin/plugin.json` | `"version"` | ❌ 跳过 | ✅ 自动 |
|
|
871
|
+
| `.claude-plugin/marketplace.json` | `"version"` | ❌ 跳过 | ✅ 自动 |
|
|
872
|
+
|
|
873
|
+
> **Marketplace 版本策略**:`.claude-plugin/` 文件仅在稳定版发布时更新。这可以防止 beta/alpha 版本被自动推送到 Claude Plugin Marketplace 用户。Marketplace 用户将仅接收稳定版本。
|
|
874
|
+
|
|
875
|
+
#### 预发布验证脚本
|
|
876
|
+
|
|
877
|
+
```bash
|
|
878
|
+
# macOS / Linux
|
|
879
|
+
./scripts/pre-release-check.sh
|
|
880
|
+
|
|
881
|
+
# Windows PowerShell
|
|
882
|
+
.\scripts\pre-release-check.ps1
|
|
883
|
+
```
|
|
884
|
+
|
|
885
|
+
这将运行 19 项检查,包括:
|
|
886
|
+
1. Git 工作目录状态
|
|
887
|
+
2. 版本同步(`check-version-sync.sh`)
|
|
888
|
+
3. 标准同步(`check-standards-sync.sh`)
|
|
889
|
+
4. 翻译同步(`check-translation-sync.sh`)
|
|
890
|
+
5-11. CLI-docs、docs、AI agent、usage docs、spec、scope、commands 同步检查
|
|
891
|
+
12. 文档完整性(`check-docs-integrity.sh`)
|
|
892
|
+
13. Skill 后续步骤同步(`check-skill-next-steps-sync.sh`)
|
|
893
|
+
14. 代码检查(Linting)
|
|
894
|
+
15. 孤儿规格检测(`check-orphan-specs.sh`)
|
|
895
|
+
16. AI Agent 行为覆盖率(`check-ai-behavior-sync.ts`)
|
|
896
|
+
17. 工作流合规性
|
|
897
|
+
18. 单元测试
|
|
898
|
+
19. E2E 测试(缺陷回归)
|
|
899
|
+
|
|
900
|
+
#### 翻译同步(稳定版发布)
|
|
901
|
+
|
|
902
|
+
对于稳定版发布,确保翻译已同步:
|
|
903
|
+
```bash
|
|
904
|
+
./scripts/check-translation-sync.sh # zh-TW
|
|
905
|
+
./scripts/check-translation-sync.sh zh-CN # zh-CN
|
|
906
|
+
```
|
|
907
|
+
|
|
908
|
+
#### UDS 三阶段发布工作流(Alpha→Beta→Stable)
|
|
909
|
+
|
|
910
|
+
> **注意**:此工作流专用于 UDS 项目。通用发布工作流(参见 `release-workflow.md`)使用适合大多数项目的更简单的 Beta→Stable 模式。
|
|
911
|
+
|
|
912
|
+
**工作流理念**:先定版本,后验证。在测试前指定版本号,以确保验证针对的是确切的发布版本。
|
|
913
|
+
|
|
914
|
+
**阶段概述:**
|
|
915
|
+
|
|
916
|
+
| 阶段 | 版本模式 | npm 标签 | 目的 |
|
|
917
|
+
|-------|-----------------|---------|---------|
|
|
918
|
+
| 阶段 1:Alpha | `X.Y.Z-alpha.N` | `@alpha` | 内部验证、预发布检查 |
|
|
919
|
+
| 阶段 2:Beta | `X.Y.Z-beta.N` | `@beta` | 公开测试、早期采用者反馈 |
|
|
920
|
+
| 阶段 3:Stable | `X.Y.Z` | `@latest` | 生产发布 |
|
|
921
|
+
|
|
922
|
+
**详细步骤:**
|
|
923
|
+
|
|
924
|
+
**阶段 1:Alpha 发布(内部)**
|
|
925
|
+
1. 将版本更新为 alpha:`npm version X.Y.Z-alpha.1 --no-git-tag-version`
|
|
926
|
+
2. 仅更新 CLI 版本文件(2 个文件):
|
|
927
|
+
- `cli/package.json`
|
|
928
|
+
- `cli/standards-registry.json`
|
|
929
|
+
3. **不要更新** `.claude-plugin/` 文件(保留先前的稳定版本)
|
|
930
|
+
4. 运行预发布检查:`./scripts/pre-release-check.sh`
|
|
931
|
+
5. 使用 alpha 说明更新 CHANGELOG
|
|
932
|
+
6. 提交:`chore(release): X.Y.Z-alpha.1`
|
|
933
|
+
7. 创建标签:`vX.Y.Z-alpha.1`
|
|
934
|
+
8. 推送并创建 GitHub Release(标记为 pre-release)
|
|
935
|
+
|
|
936
|
+
**阶段 2:Beta 发布(公开测试)**
|
|
937
|
+
1. Alpha 验证通过后,更新为 beta:`npm version X.Y.Z-beta.1 --no-git-tag-version`
|
|
938
|
+
2. 仅更新 CLI 版本文件(2 个文件):
|
|
939
|
+
- `cli/package.json`
|
|
940
|
+
- `cli/standards-registry.json`
|
|
941
|
+
3. **不要更新** `.claude-plugin/` 文件(保留先前的稳定版本)
|
|
942
|
+
4. 运行完整测试套件
|
|
943
|
+
5. 使用 beta 说明更新 CHANGELOG
|
|
944
|
+
6. 提交:`chore(release): X.Y.Z-beta.1`
|
|
945
|
+
7. 创建标签:`vX.Y.Z-beta.1`
|
|
946
|
+
8. 推送并创建 GitHub Release(标记为 pre-release)
|
|
947
|
+
9. 向早期采用者公布以获取反馈
|
|
948
|
+
|
|
949
|
+
**阶段 3:Stable 发布(生产环境)**
|
|
950
|
+
1. Beta 测试完成后,更新为 stable:`npm version X.Y.Z --no-git-tag-version`
|
|
951
|
+
2. 更新**所有**版本文件(5 个文件):
|
|
952
|
+
- `cli/package.json`
|
|
953
|
+
- `cli/standards-registry.json`
|
|
954
|
+
- `.claude-plugin/plugin.json` ← 在此处更新 Marketplace
|
|
955
|
+
- `.claude-plugin/marketplace.json` ← 在此处更新 Marketplace
|
|
956
|
+
- `README.md`
|
|
957
|
+
3. 定稿 CHANGELOG(移除 beta 警告,添加 stable 说明)
|
|
958
|
+
4. 同步翻译:`./scripts/check-translation-sync.sh`
|
|
959
|
+
5. 运行最终预发布检查
|
|
960
|
+
6. 提交:`chore(release): X.Y.Z`
|
|
961
|
+
7. 创建标签:`vX.Y.Z`
|
|
962
|
+
8. 推送并创建 GitHub Release
|
|
963
|
+
9. 验证 npm 发布:`npm view universal-dev-standards dist-tags`
|
|
964
|
+
|
|
965
|
+
**何时使用此工作流:**
|
|
966
|
+
- 包含破坏性变更的重大发布
|
|
967
|
+
- 需要大量测试的功能
|
|
968
|
+
- 需要早期采用者验证的发布
|
|
969
|
+
|
|
970
|
+
**何时跳过 Alpha(仅 Beta→Stable):**
|
|
971
|
+
- 补丁发布(仅缺陷修复)
|
|
972
|
+
- 包含低风险变更的次要发布
|
|
973
|
+
- 紧急安全修复
|
|
974
|
+
|
|
975
|
+
### 交互示例
|
|
976
|
+
|
|
977
|
+
```
|
|
978
|
+
User: "我想发布 beta 版本"
|
|
979
|
+
|
|
980
|
+
AI:
|
|
981
|
+
我会协助你准备 beta 版本发布。
|
|
982
|
+
|
|
983
|
+
首先,让我执行预发布检查:
|
|
984
|
+
1. ✅ 执行测试
|
|
985
|
+
2. ✅ 执行 linting
|
|
986
|
+
3. ✅ 检查 git 状态
|
|
987
|
+
|
|
988
|
+
请提供以下信息:
|
|
989
|
+
1. 版本号是多少?(例如:3.2.2-beta.1)
|
|
990
|
+
2. 主要包含哪些变更?
|
|
991
|
+
|
|
992
|
+
确认后,我会:
|
|
993
|
+
1. 更新 cli/package.json 版本号
|
|
994
|
+
2. 更新 CHANGELOG.md
|
|
995
|
+
3. 创建 git tag (vX.Y.Z-beta.N)
|
|
996
|
+
4. 提交并推送变更
|
|
997
|
+
5. 提供创建 GitHub Release 的步骤
|
|
998
|
+
|
|
999
|
+
**重要**:创建 GitHub Release 后,GitHub Actions 会自动:
|
|
1000
|
+
- 检测版本类型(beta)
|
|
1001
|
+
- 发布到 npm 并标记为 @beta
|
|
1002
|
+
- 无需手动执行 npm publish
|
|
1003
|
+
```
|
|
1004
|
+
|
|
1005
|
+
---
|
|
1006
|
+
|
|
1007
|
+
## 文件结构参考
|
|
200
1008
|
|
|
201
1009
|
```
|
|
202
1010
|
universal-dev-standards/
|
|
203
|
-
├── core/ #
|
|
204
|
-
├── skills/ # AI
|
|
205
|
-
│ └── claude-code/ # Claude Code
|
|
206
|
-
├── cli/ # Node.js CLI
|
|
207
|
-
│ ├── src/ #
|
|
208
|
-
│ ├── tests/ #
|
|
209
|
-
│ └── package.json #
|
|
210
|
-
├── locales/ #
|
|
211
|
-
│ └── zh-TW/ #
|
|
212
|
-
├── integrations/ # AI
|
|
213
|
-
├── templates/ #
|
|
214
|
-
├── adoption/ #
|
|
215
|
-
└── scripts/ #
|
|
1011
|
+
├── core/ # Core standards (71 files)
|
|
1012
|
+
├── skills/ # AI tool skills
|
|
1013
|
+
│ └── claude-code/ # Claude Code skills (26 skills)
|
|
1014
|
+
├── cli/ # Node.js CLI tool
|
|
1015
|
+
│ ├── src/ # Source code
|
|
1016
|
+
│ ├── tests/ # Test files
|
|
1017
|
+
│ └── package.json # Dependencies
|
|
1018
|
+
├── locales/ # Translations
|
|
1019
|
+
│ └── zh-TW/ # Traditional Chinese
|
|
1020
|
+
├── integrations/ # AI tool configurations
|
|
1021
|
+
├── templates/ # Document templates
|
|
1022
|
+
├── adoption/ # Adoption guides
|
|
1023
|
+
└── scripts/ # Maintenance scripts
|
|
216
1024
|
```
|
|
217
1025
|
|
|
218
1026
|
## 贡献
|
|
@@ -221,5 +1029,83 @@ universal-dev-standards/
|
|
|
221
1029
|
|
|
222
1030
|
## 授权
|
|
223
1031
|
|
|
224
|
-
-
|
|
225
|
-
-
|
|
1032
|
+
- 文档(Markdown):CC BY 4.0
|
|
1033
|
+
- 代码(JavaScript):MIT
|
|
1034
|
+
|
|
1035
|
+
|
|
1036
|
+
## 可用的 UDS 斜杠命令 | UDS 可用命令
|
|
1037
|
+
|
|
1038
|
+
> 为 SPEC-INTSYNC-001 同步合规自动生成的索引。权威描述位于 `skills/commands/*.md` 与 `skills/commands/COMMAND-INDEX.json`。
|
|
1039
|
+
|
|
1040
|
+
> 为 SPEC-INTSYNC-001 同步合规自动生成的索引。权威描述位于 `skills/commands/*.md` 与 `COMMAND-INDEX.json`。
|
|
1041
|
+
|
|
1042
|
+
### core
|
|
1043
|
+
|
|
1044
|
+
- `/commit`
|
|
1045
|
+
- `/code-review`
|
|
1046
|
+
- `/sdd`
|
|
1047
|
+
- `/check`
|
|
1048
|
+
- `/init`
|
|
1049
|
+
- `/update`
|
|
1050
|
+
- `/config`
|
|
1051
|
+
|
|
1052
|
+
### testing
|
|
1053
|
+
|
|
1054
|
+
- `/tdd`
|
|
1055
|
+
- `/bdd`
|
|
1056
|
+
- `/atdd`
|
|
1057
|
+
- `/e2e`
|
|
1058
|
+
- `/coverage`
|
|
1059
|
+
- `/ac-coverage`
|
|
1060
|
+
- `/derive`
|
|
1061
|
+
- `/derive-bdd`
|
|
1062
|
+
- `/derive-tdd`
|
|
1063
|
+
- `/derive-atdd`
|
|
1064
|
+
- `/derive-all`
|
|
1065
|
+
- `/journey-test`
|
|
1066
|
+
|
|
1067
|
+
### quality
|
|
1068
|
+
|
|
1069
|
+
- `/checkin`
|
|
1070
|
+
- `/refactor`
|
|
1071
|
+
- `/scan`
|
|
1072
|
+
- `/security`
|
|
1073
|
+
- `/reverse`
|
|
1074
|
+
- `/reverse-sdd`
|
|
1075
|
+
- `/reverse-bdd`
|
|
1076
|
+
- `/reverse-tdd`
|
|
1077
|
+
|
|
1078
|
+
### docs
|
|
1079
|
+
|
|
1080
|
+
- `/docs`
|
|
1081
|
+
- `/docgen`
|
|
1082
|
+
- `/changelog`
|
|
1083
|
+
- `/requirement`
|
|
1084
|
+
- `/brainstorm`
|
|
1085
|
+
- `/sdd-retro`
|
|
1086
|
+
- `/pr`
|
|
1087
|
+
|
|
1088
|
+
### ops
|
|
1089
|
+
|
|
1090
|
+
- `/observability`
|
|
1091
|
+
- `/slo`
|
|
1092
|
+
- `/runbook`
|
|
1093
|
+
- `/incident`
|
|
1094
|
+
- `/metrics`
|
|
1095
|
+
- `/durable`
|
|
1096
|
+
- `/ci-cd`
|
|
1097
|
+
|
|
1098
|
+
### methodology
|
|
1099
|
+
|
|
1100
|
+
- `/methodology`
|
|
1101
|
+
- `/dev-workflow`
|
|
1102
|
+
- `/discover`
|
|
1103
|
+
- `/release`
|
|
1104
|
+
- `/audit`
|
|
1105
|
+
- `/migrate`
|
|
1106
|
+
- `/skill-builder`
|
|
1107
|
+
|
|
1108
|
+
### reference
|
|
1109
|
+
|
|
1110
|
+
- `/database`
|
|
1111
|
+
- `/api-design`
|