universal-dev-standards 5.0.0-rc.8 → 5.0.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 +5 -3
- package/bundled/ai/standards/acceptance-criteria-traceability.ai.yaml +178 -0
- package/bundled/ai/standards/agent-dispatch.ai.yaml +69 -0
- package/bundled/ai/standards/ai-command-behavior.ai.yaml +45 -0
- package/bundled/ai/standards/api-design-standards.ai.yaml +192 -0
- package/bundled/ai/standards/branch-completion.ai.yaml +82 -0
- package/bundled/ai/standards/change-batching-standards.ai.yaml +195 -0
- package/bundled/ai/standards/database-standards.ai.yaml +220 -0
- package/bundled/ai/standards/error-codes.ai.yaml +37 -2
- package/bundled/ai/standards/git-worktree.ai.yaml +77 -0
- package/bundled/ai/standards/logging.ai.yaml +21 -2
- package/bundled/ai/standards/model-selection.ai.yaml +81 -0
- package/bundled/ai/standards/pipeline-integration-standards.ai.yaml +184 -0
- package/bundled/ai/standards/systematic-debugging.ai.yaml +73 -0
- package/bundled/ai/standards/verification-evidence.ai.yaml +84 -0
- package/bundled/ai/standards/workflow-enforcement.ai.yaml +253 -0
- package/bundled/core/acceptance-criteria-traceability.md +293 -0
- package/bundled/core/agent-dispatch.md +149 -0
- package/bundled/core/ai-command-behavior.md +239 -0
- package/bundled/core/api-design-standards.md +938 -0
- package/bundled/core/branch-completion.md +158 -0
- package/bundled/core/change-batching-standards.md +257 -0
- package/bundled/core/checkin-standards.md +43 -6
- package/bundled/core/database-standards.md +828 -0
- package/bundled/core/error-code-standards.md +228 -2
- package/bundled/core/forward-derivation-standards.md +54 -2
- package/bundled/core/git-worktree.md +131 -0
- package/bundled/core/model-selection.md +153 -0
- package/bundled/core/pipeline-integration-standards.md +230 -0
- package/bundled/core/systematic-debugging.md +156 -0
- package/bundled/core/testing-standards.md +49 -39
- package/bundled/core/verification-evidence.md +172 -0
- package/bundled/core/workflow-enforcement.md +132 -0
- package/bundled/locales/zh-CN/CLAUDE.md +2 -2
- package/bundled/locales/zh-CN/README.md +4 -4
- package/bundled/locales/zh-CN/SECURITY.md +92 -0
- package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +301 -0
- package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +47 -0
- package/bundled/locales/zh-CN/core/accessibility-standards.md +124 -0
- package/bundled/locales/zh-CN/core/agent-dispatch.md +113 -0
- package/bundled/locales/zh-CN/core/ai-agreement-standards.md +103 -0
- package/bundled/locales/zh-CN/core/ai-command-behavior.md +247 -0
- package/bundled/locales/zh-CN/core/api-design-standards.md +946 -0
- package/bundled/locales/zh-CN/core/behavior-driven-development.md +48 -0
- package/bundled/locales/zh-CN/core/branch-completion.md +112 -0
- package/bundled/locales/zh-CN/core/change-batching-standards.md +265 -0
- package/bundled/locales/zh-CN/core/checkin-standards.md +43 -5
- package/bundled/locales/zh-CN/core/context-aware-loading.md +106 -0
- package/bundled/locales/zh-CN/core/database-standards.md +836 -0
- package/bundled/locales/zh-CN/core/deployment-standards.md +80 -0
- package/bundled/locales/zh-CN/core/error-code-standards.md +2 -2
- package/bundled/locales/zh-CN/core/forward-derivation-standards.md +493 -0
- package/bundled/locales/zh-CN/core/git-worktree.md +101 -0
- package/bundled/locales/zh-CN/core/model-selection.md +112 -0
- package/bundled/locales/zh-CN/core/performance-standards.md +104 -0
- package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +238 -0
- package/bundled/locales/zh-CN/core/project-context-memory.md +124 -0
- package/bundled/locales/zh-CN/core/requirement-engineering.md +49 -0
- package/bundled/locales/zh-CN/core/security-standards.md +100 -0
- package/bundled/locales/zh-CN/core/systematic-debugging.md +106 -0
- package/bundled/locales/zh-CN/core/test-governance.md +116 -0
- package/bundled/locales/zh-CN/core/testing-standards.md +392 -156
- package/bundled/locales/zh-CN/core/verification-evidence.md +118 -0
- package/bundled/locales/zh-CN/core/virtual-organization-standards.md +104 -0
- package/bundled/locales/zh-CN/core/workflow-enforcement.md +132 -0
- package/bundled/locales/zh-CN/docs/CHEATSHEET.md +27 -1
- package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +9 -1
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +37 -9
- package/bundled/locales/zh-CN/docs/USER-MANUAL.md +652 -0
- package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +1 -1
- package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +29 -4
- package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +143 -72
- package/bundled/locales/zh-CN/skills/ac-coverage-assistant/SKILL.md +126 -0
- package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +100 -0
- package/bundled/locales/zh-CN/skills/brainstorm-assistant/SKILL.md +119 -0
- package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +82 -0
- package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +97 -0
- package/bundled/locales/zh-CN/skills/commands/api-design.md +94 -0
- package/bundled/locales/zh-CN/skills/commands/atdd.md +163 -0
- package/bundled/locales/zh-CN/skills/commands/audit.md +77 -0
- package/bundled/locales/zh-CN/skills/commands/bdd.md +1 -1
- package/bundled/locales/zh-CN/skills/commands/brainstorm.md +87 -0
- package/bundled/locales/zh-CN/skills/commands/changelog.md +63 -0
- package/bundled/locales/zh-CN/skills/commands/check.md +219 -0
- package/bundled/locales/zh-CN/skills/commands/checkin.md +61 -0
- package/bundled/locales/zh-CN/skills/commands/ci-cd.md +77 -0
- package/bundled/locales/zh-CN/skills/commands/commit.md +81 -0
- package/bundled/locales/zh-CN/skills/commands/config.md +207 -0
- package/bundled/locales/zh-CN/skills/commands/coverage.md +74 -0
- package/bundled/locales/zh-CN/skills/commands/database.md +78 -0
- package/bundled/locales/zh-CN/skills/commands/derive-all.md +58 -0
- package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +54 -0
- package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +53 -0
- package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +54 -0
- package/bundled/locales/zh-CN/skills/commands/derive.md +78 -0
- package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +119 -0
- package/bundled/locales/zh-CN/skills/commands/discover.md +86 -0
- package/bundled/locales/zh-CN/skills/commands/docgen.md +67 -0
- package/bundled/locales/zh-CN/skills/commands/docs.md +65 -0
- package/bundled/locales/zh-CN/skills/commands/durable.md +87 -0
- package/bundled/locales/zh-CN/skills/commands/guide.md +52 -0
- package/bundled/locales/zh-CN/skills/commands/incident.md +92 -0
- package/bundled/locales/zh-CN/skills/commands/init.md +272 -0
- package/bundled/locales/zh-CN/skills/commands/methodology.md +1 -1
- package/bundled/locales/zh-CN/skills/commands/metrics.md +73 -0
- package/bundled/locales/zh-CN/skills/commands/migrate.md +92 -0
- package/bundled/locales/zh-CN/skills/commands/pr.md +80 -0
- package/bundled/locales/zh-CN/skills/commands/refactor.md +1 -1
- package/bundled/locales/zh-CN/skills/commands/release.md +62 -0
- package/bundled/locales/zh-CN/skills/commands/requirement.md +54 -0
- package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +47 -0
- package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +51 -0
- package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +51 -0
- package/bundled/locales/zh-CN/skills/commands/reverse.md +63 -0
- package/bundled/locales/zh-CN/skills/commands/review.md +50 -0
- package/bundled/locales/zh-CN/skills/commands/scan.md +76 -0
- package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +40 -0
- package/bundled/locales/zh-CN/skills/commands/sdd.md +379 -0
- package/bundled/locales/zh-CN/skills/commands/security.md +75 -0
- package/bundled/locales/zh-CN/skills/commands/tdd.md +111 -0
- package/bundled/locales/zh-CN/skills/commands/update.md +337 -0
- package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +1 -2
- package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +97 -0
- package/bundled/locales/zh-CN/skills/dev-workflow-guide/SKILL.md +145 -0
- package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +84 -0
- package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +107 -0
- package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +67 -0
- package/bundled/locales/zh-CN/skills/migration-assistant/SKILL.md +77 -0
- package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +90 -0
- package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +79 -0
- package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +72 -0
- package/bundled/locales/zh-CN/skills/spec-driven-dev/SKILL.md +73 -10
- package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +267 -122
- package/bundled/locales/zh-TW/CLAUDE.md +2 -2
- package/bundled/locales/zh-TW/README.md +4 -4
- package/bundled/locales/zh-TW/SECURITY.md +92 -0
- package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +301 -0
- package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +47 -0
- package/bundled/locales/zh-TW/core/accessibility-standards.md +84 -0
- package/bundled/locales/zh-TW/core/agent-dispatch.md +89 -0
- package/bundled/locales/zh-TW/core/ai-agreement-standards.md +87 -0
- package/bundled/locales/zh-TW/core/ai-command-behavior.md +247 -0
- package/bundled/locales/zh-TW/core/api-design-standards.md +946 -0
- package/bundled/locales/zh-TW/core/behavior-driven-development.md +63 -0
- package/bundled/locales/zh-TW/core/branch-completion.md +76 -0
- package/bundled/locales/zh-TW/core/change-batching-standards.md +265 -0
- package/bundled/locales/zh-TW/core/checkin-standards.md +39 -5
- package/bundled/locales/zh-TW/core/context-aware-loading.md +86 -0
- package/bundled/locales/zh-TW/core/database-standards.md +836 -0
- package/bundled/locales/zh-TW/core/deployment-standards.md +66 -0
- package/bundled/locales/zh-TW/core/error-code-standards.md +230 -4
- package/bundled/locales/zh-TW/core/forward-derivation-standards.md +62 -2
- package/bundled/locales/zh-TW/core/git-worktree.md +104 -0
- package/bundled/locales/zh-TW/core/model-selection.md +83 -0
- package/bundled/locales/zh-TW/core/performance-standards.md +84 -0
- package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +238 -0
- package/bundled/locales/zh-TW/core/project-context-memory.md +79 -0
- package/bundled/locales/zh-TW/core/requirement-engineering.md +79 -0
- package/bundled/locales/zh-TW/core/security-standards.md +74 -0
- package/bundled/locales/zh-TW/core/systematic-debugging.md +95 -0
- package/bundled/locales/zh-TW/core/test-governance.md +88 -0
- package/bundled/locales/zh-TW/core/testing-standards.md +309 -86
- package/bundled/locales/zh-TW/core/verification-evidence.md +94 -0
- package/bundled/locales/zh-TW/core/virtual-organization-standards.md +88 -0
- package/bundled/locales/zh-TW/core/workflow-enforcement.md +132 -0
- package/bundled/locales/zh-TW/docs/CHEATSHEET.md +27 -1
- package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +9 -1
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +37 -9
- package/bundled/locales/zh-TW/docs/USER-MANUAL.md +652 -0
- package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +1 -1
- package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +29 -4
- package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +142 -71
- package/bundled/locales/zh-TW/skills/ac-coverage-assistant/SKILL.md +127 -0
- package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +1 -4
- package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +1 -4
- package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +97 -0
- package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +1 -4
- package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +1 -4
- package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +1 -4
- package/bundled/locales/zh-TW/skills/brainstorm-assistant/SKILL.md +1 -4
- package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +1 -4
- package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +1 -4
- package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +79 -0
- package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +1 -4
- package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +95 -0
- package/bundled/locales/zh-TW/skills/commands/api-design.md +92 -0
- package/bundled/locales/zh-TW/skills/commands/atdd.md +167 -0
- package/bundled/locales/zh-TW/skills/commands/audit.md +75 -0
- package/bundled/locales/zh-TW/skills/commands/bdd.md +1 -1
- package/bundled/locales/zh-TW/skills/commands/brainstorm.md +91 -0
- package/bundled/locales/zh-TW/skills/commands/changelog.md +67 -0
- package/bundled/locales/zh-TW/skills/commands/check.md +223 -0
- package/bundled/locales/zh-TW/skills/commands/checkin.md +65 -0
- package/bundled/locales/zh-TW/skills/commands/ci-cd.md +75 -0
- package/bundled/locales/zh-TW/skills/commands/commit.md +85 -0
- package/bundled/locales/zh-TW/skills/commands/config.md +211 -0
- package/bundled/locales/zh-TW/skills/commands/coverage.md +78 -0
- package/bundled/locales/zh-TW/skills/commands/database.md +76 -0
- package/bundled/locales/zh-TW/skills/commands/derive-all.md +62 -0
- package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +58 -0
- package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +54 -0
- package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +55 -0
- package/bundled/locales/zh-TW/skills/commands/derive.md +79 -0
- package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +120 -0
- package/bundled/locales/zh-TW/skills/commands/discover.md +87 -0
- package/bundled/locales/zh-TW/skills/commands/docgen.md +68 -0
- package/bundled/locales/zh-TW/skills/commands/docs.md +66 -0
- package/bundled/locales/zh-TW/skills/commands/durable.md +85 -0
- package/bundled/locales/zh-TW/skills/commands/guide.md +51 -0
- package/bundled/locales/zh-TW/skills/commands/incident.md +90 -0
- package/bundled/locales/zh-TW/skills/commands/init.md +273 -0
- package/bundled/locales/zh-TW/skills/commands/methodology.md +1 -1
- package/bundled/locales/zh-TW/skills/commands/metrics.md +71 -0
- package/bundled/locales/zh-TW/skills/commands/migrate.md +90 -0
- package/bundled/locales/zh-TW/skills/commands/pr.md +78 -0
- package/bundled/locales/zh-TW/skills/commands/refactor.md +1 -1
- package/bundled/locales/zh-TW/skills/commands/release.md +63 -0
- package/bundled/locales/zh-TW/skills/commands/requirement.md +61 -0
- package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +54 -0
- package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +58 -0
- package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +58 -0
- package/bundled/locales/zh-TW/skills/commands/reverse.md +70 -0
- package/bundled/locales/zh-TW/skills/commands/review.md +57 -0
- package/bundled/locales/zh-TW/skills/commands/scan.md +74 -0
- package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +47 -0
- package/bundled/locales/zh-TW/skills/commands/sdd.md +362 -0
- package/bundled/locales/zh-TW/skills/commands/security.md +73 -0
- package/bundled/locales/zh-TW/skills/commands/tdd.md +115 -0
- package/bundled/locales/zh-TW/skills/commands/update.md +326 -0
- package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -6
- package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +94 -0
- package/bundled/locales/zh-TW/skills/dev-workflow-guide/SKILL.md +140 -0
- package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +1 -4
- package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +1 -4
- package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +81 -0
- package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +1 -4
- package/bundled/locales/zh-TW/skills/forward-derivation/SKILL.md +1 -4
- package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +1 -4
- package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +104 -0
- package/bundled/locales/zh-TW/skills/logging-guide/SKILL.md +1 -4
- package/bundled/locales/zh-TW/skills/methodology-system/SKILL.md +1 -4
- package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +64 -0
- package/bundled/locales/zh-TW/skills/migration-assistant/SKILL.md +74 -0
- package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +87 -0
- package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +1 -4
- package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +1 -4
- package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +1 -4
- package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +1 -4
- package/bundled/locales/zh-TW/skills/reverse-engineer/SKILL.md +1 -4
- package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +76 -0
- package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +69 -0
- package/bundled/locales/zh-TW/skills/spec-driven-dev/SKILL.md +74 -14
- package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +243 -98
- package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +1 -4
- package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +1 -4
- package/bundled/locales/zh-TW/skills/testing-guide/SKILL.md +1 -5
- package/bundled/skills/README.md +11 -0
- package/bundled/skills/ac-coverage-assistant/SKILL.md +127 -0
- package/bundled/skills/ai-collaboration-standards/SKILL.md +10 -0
- package/bundled/skills/ai-friendly-architecture/SKILL.md +10 -0
- package/bundled/skills/ai-instruction-standards/SKILL.md +10 -0
- package/bundled/skills/api-design-assistant/SKILL.md +119 -0
- package/bundled/skills/atdd-assistant/SKILL.md +7 -0
- package/bundled/skills/bdd-assistant/SKILL.md +7 -0
- package/bundled/skills/brainstorm-assistant/SKILL.md +7 -0
- package/bundled/skills/checkin-assistant/SKILL.md +7 -0
- package/bundled/skills/ci-cd-assistant/SKILL.md +97 -0
- package/bundled/skills/code-review-assistant/SKILL.md +7 -0
- package/bundled/skills/commands/README.md +70 -0
- package/bundled/skills/commands/ac-coverage.md +135 -0
- package/bundled/skills/commands/api-design.md +86 -0
- package/bundled/skills/commands/atdd.md +69 -0
- package/bundled/skills/commands/audit.md +69 -0
- package/bundled/skills/commands/bdd.md +101 -0
- package/bundled/skills/commands/brainstorm.md +45 -0
- package/bundled/skills/commands/changelog.md +34 -0
- package/bundled/skills/commands/check.md +52 -1
- package/bundled/skills/commands/checkin.md +46 -0
- package/bundled/skills/commands/ci-cd.md +69 -0
- package/bundled/skills/commands/commit.md +79 -0
- package/bundled/skills/commands/config.md +48 -0
- package/bundled/skills/commands/coverage.md +53 -0
- package/bundled/skills/commands/database.md +70 -0
- package/bundled/skills/commands/derive-all.md +40 -0
- package/bundled/skills/commands/derive-atdd.md +33 -0
- package/bundled/skills/commands/derive-bdd.md +39 -0
- package/bundled/skills/commands/derive-tdd.md +40 -0
- package/bundled/skills/commands/derive.md +47 -0
- package/bundled/skills/commands/dev-workflow.md +104 -7
- package/bundled/skills/commands/discover.md +39 -0
- package/bundled/skills/commands/docgen.md +35 -0
- package/bundled/skills/commands/docs.md +40 -0
- package/bundled/skills/commands/durable.md +79 -0
- package/bundled/skills/commands/incident.md +84 -0
- package/bundled/skills/commands/init.md +55 -0
- package/bundled/skills/commands/methodology.md +72 -0
- package/bundled/skills/commands/metrics.md +65 -0
- package/bundled/skills/commands/migrate.md +84 -0
- package/bundled/skills/commands/pr.md +72 -0
- package/bundled/skills/commands/refactor.md +51 -0
- package/bundled/skills/commands/release.md +60 -0
- package/bundled/skills/commands/requirement.md +38 -0
- package/bundled/skills/commands/reverse-bdd.md +34 -0
- package/bundled/skills/commands/reverse-sdd.md +42 -0
- package/bundled/skills/commands/reverse-tdd.md +40 -0
- package/bundled/skills/commands/reverse.md +41 -0
- package/bundled/skills/commands/review.md +39 -0
- package/bundled/skills/commands/scan.md +68 -0
- package/bundled/skills/commands/sdd-retro.md +48 -0
- package/bundled/skills/commands/sdd.md +220 -0
- package/bundled/skills/commands/security.md +67 -0
- package/bundled/skills/commands/tdd.md +101 -0
- package/bundled/skills/commands/update.md +61 -0
- package/bundled/skills/commit-standards/SKILL.md +8 -2
- package/bundled/skills/database-assistant/SKILL.md +118 -0
- package/bundled/skills/dev-workflow-guide/SKILL.md +53 -7
- package/bundled/skills/dev-workflow-guide/workflow-phases.md +24 -0
- package/bundled/skills/durable-execution-assistant/SKILL.md +116 -0
- package/bundled/skills/forward-derivation/SKILL.md +7 -0
- package/bundled/skills/incident-response-assistant/SKILL.md +132 -0
- package/bundled/skills/methodology-system/SKILL.md +24 -2
- package/bundled/skills/metrics-dashboard-assistant/SKILL.md +109 -0
- package/bundled/skills/migration-assistant/SKILL.md +119 -0
- package/bundled/skills/pr-automation-assistant/SKILL.md +114 -0
- package/bundled/skills/project-discovery/SKILL.md +7 -0
- package/bundled/skills/refactoring-assistant/SKILL.md +7 -0
- package/bundled/skills/release-standards/SKILL.md +7 -0
- package/bundled/skills/requirement-assistant/SKILL.md +7 -0
- package/bundled/skills/reverse-engineer/SKILL.md +7 -0
- package/bundled/skills/security-assistant/SKILL.md +105 -0
- package/bundled/skills/security-scan-assistant/SKILL.md +96 -0
- package/bundled/skills/spec-driven-dev/SKILL.md +84 -4
- package/bundled/skills/spec-driven-dev/guide.md +156 -22
- package/bundled/skills/tdd-assistant/SKILL.md +7 -0
- package/bundled/skills/test-coverage-assistant/SKILL.md +11 -0
- package/bundled/skills/testing-guide/SKILL.md +23 -0
- package/package.json +1 -1
- package/src/commands/check.js +154 -8
- package/src/commands/config.js +231 -104
- package/src/commands/init.js +23 -3
- package/src/commands/update.js +250 -25
- package/src/config/ai-agent-paths.js +16 -0
- package/src/config/workflow-definitions.js +184 -0
- package/src/core/constants.js +6 -0
- package/src/flows/init-flow.js +23 -6
- package/src/i18n/messages.js +51 -3
- package/src/installers/integration-installer.js +67 -2
- package/src/installers/manifest-installer.js +1 -0
- package/src/installers/standards-installer.js +3 -2
- package/src/prompts/init.js +50 -3
- package/src/reconciler/manifest-migrator.js +2 -2
- package/src/reconciler/plan-executor.js +11 -0
- package/src/utils/integration-generator.js +327 -14
- package/src/utils/workflow-gate.js +292 -0
- package/standards-registry.json +160 -5
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
---
|
|
2
|
+
source: ../../../core/virtual-organization-standards.md
|
|
3
|
+
source_version: 1.0.0
|
|
4
|
+
translation_version: 1.0.0
|
|
5
|
+
last_synced: 2026-03-24
|
|
6
|
+
status: current
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# 虛擬組織標準
|
|
10
|
+
|
|
11
|
+
> **語言**: [English](../../../core/virtual-organization-standards.md) | 繁體中文
|
|
12
|
+
|
|
13
|
+
**版本**: 1.0.0
|
|
14
|
+
**最後更新**: 2026-01-29
|
|
15
|
+
**適用性**: 專案設置和 AI 工具配置
|
|
16
|
+
**範圍**: 通用 (Universal)
|
|
17
|
+
**業界標準**: ISO 12207 §6.2
|
|
18
|
+
**ISO 12207 對應**: 組織專案賦能流程 (6.2)
|
|
19
|
+
|
|
20
|
+
---
|
|
21
|
+
|
|
22
|
+
## 目的
|
|
23
|
+
|
|
24
|
+
本標準將 AI 生態系統視為「虛擬組織」。定義如何將 AI 能力(Skills)、基礎設施和品質保證作為組織資產來管理,確保「虛擬人力」具備能力且符合規範。
|
|
25
|
+
|
|
26
|
+
---
|
|
27
|
+
|
|
28
|
+
## 1. 虛擬人力管理
|
|
29
|
+
|
|
30
|
+
在 Vibe Coding 中,「人力資源管理」即管理 AI 代理的能力。
|
|
31
|
+
|
|
32
|
+
### 1.1 技能管理
|
|
33
|
+
|
|
34
|
+
技能是虛擬員工的「資格」。
|
|
35
|
+
|
|
36
|
+
- **取得**:技能必須明確安裝(例如透過 `skills/` 目錄或插件)
|
|
37
|
+
- **能力**:技能必須針對特定專案情境進行驗證
|
|
38
|
+
- **角色定義**:代理應被指派「角色」(技能集合),而非作為通用代理
|
|
39
|
+
|
|
40
|
+
| 角色 | 建議技能集 |
|
|
41
|
+
|------|-----------|
|
|
42
|
+
| **架構代理** | `system-design`、`diagram-generation`、`codebase-analysis` |
|
|
43
|
+
| **測試代理** | `test-runner`、`coverage-analyzer`、`mock-generator` |
|
|
44
|
+
| **重構代理** | `static-analysis`、`code-metrics`、`refactoring-patterns` |
|
|
45
|
+
|
|
46
|
+
### 1.2 入職(情境載入)
|
|
47
|
+
|
|
48
|
+
「入職」AI 代理意味著載入正確的情境和配置:
|
|
49
|
+
|
|
50
|
+
- **專案引導**:載入 `README.md`、架構文件和標準
|
|
51
|
+
- **規範熟悉**:載入適用的開發標準
|
|
52
|
+
- **歷史認知**:載入專案決策和慣例
|
|
53
|
+
|
|
54
|
+
## 2. 基礎設施管理
|
|
55
|
+
|
|
56
|
+
| 基礎設施 | 虛擬對應 | 說明 |
|
|
57
|
+
|----------|----------|------|
|
|
58
|
+
| 辦公空間 | 工作目錄 | 專案根目錄和工作區 |
|
|
59
|
+
| 通訊系統 | Prompt/Context | AI 與人類的溝通管道 |
|
|
60
|
+
| 知識庫 | 文件和標準 | `.standards/`、`core/`、`skills/` |
|
|
61
|
+
| 品保部門 | 測試和 Lint | 自動化品質檢查 |
|
|
62
|
+
|
|
63
|
+
## 3. 品質保證
|
|
64
|
+
|
|
65
|
+
### 3.1 品質政策
|
|
66
|
+
|
|
67
|
+
| 政策 | 實作 |
|
|
68
|
+
|------|------|
|
|
69
|
+
| 程式碼審查 | AI 和人類都必須審查重要變更 |
|
|
70
|
+
| 測試要求 | 新功能必須有對應測試 |
|
|
71
|
+
| 標準遵循 | 所有產出必須符合已安裝的標準 |
|
|
72
|
+
| 持續改善 | 定期回顧和更新標準 |
|
|
73
|
+
|
|
74
|
+
### 3.2 稽核
|
|
75
|
+
|
|
76
|
+
定期檢查虛擬組織的健康度:
|
|
77
|
+
|
|
78
|
+
| 稽核項目 | 頻率 | 負責人 |
|
|
79
|
+
|----------|------|--------|
|
|
80
|
+
| 技能有效性 | 每個版本 | 技術主管 |
|
|
81
|
+
| 標準合規 | 每次提交 | 自動化 |
|
|
82
|
+
| 安全審計 | 每季 | 安全團隊 |
|
|
83
|
+
|
|
84
|
+
## 相關標準
|
|
85
|
+
|
|
86
|
+
- [AI 協議標準](ai-agreement-standards.md)
|
|
87
|
+
- [專案情境記憶](project-context-memory.md)
|
|
88
|
+
- [情境感知載入](context-aware-loading.md)
|
|
@@ -0,0 +1,132 @@
|
|
|
1
|
+
# 工作流程強制執行標準
|
|
2
|
+
|
|
3
|
+
**適用範圍**:所有使用結構化開發方法論的軟體專案
|
|
4
|
+
**範圍**:通用
|
|
5
|
+
|
|
6
|
+
## 概述
|
|
7
|
+
|
|
8
|
+
本標準定義了機器可強制執行的工作流程閘門,防止在開發方法論(SDD、TDD、BDD)中跳過階段。除了依賴開發者的自律外,工作流程閘門在階段轉換時提供自動化檢查。
|
|
9
|
+
|
|
10
|
+
## 核心原則
|
|
11
|
+
|
|
12
|
+
> **引導而非阻斷。** 當前置條件失敗時,總是提供可操作的指引:缺少什麼、為什麼重要、以及如何修復。
|
|
13
|
+
|
|
14
|
+
## 執行模式
|
|
15
|
+
|
|
16
|
+
專案可透過 `.uds/config.yaml` 設定執行行為:
|
|
17
|
+
|
|
18
|
+
| 模式 | 行為 | 使用場景 |
|
|
19
|
+
|------|------|---------|
|
|
20
|
+
| `enforce` | 阻斷階段轉換 + 顯示指引 | 承諾流程紀律的團隊 |
|
|
21
|
+
| `suggest` | 顯示警告 + 允許覆蓋 | 漸進式採用的團隊 |
|
|
22
|
+
| `off` | 不執行任何檢查 | 選擇退出 |
|
|
23
|
+
|
|
24
|
+
**預設值**:`enforce`
|
|
25
|
+
|
|
26
|
+
```yaml
|
|
27
|
+
# .uds/config.yaml
|
|
28
|
+
workflow:
|
|
29
|
+
enforcement_mode: enforce # enforce | suggest | off
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
## 階段閘門架構
|
|
33
|
+
|
|
34
|
+
### 運作方式
|
|
35
|
+
|
|
36
|
+
1. 使用者調用工作流程命令(例如 `/sdd implement`)
|
|
37
|
+
2. AI 助手檢查該階段的前置條件
|
|
38
|
+
3. 如果前置條件通過 → 正常進行
|
|
39
|
+
4. 如果前置條件失敗:
|
|
40
|
+
- **enforce 模式**:停止、解釋、引導到正確階段
|
|
41
|
+
- **suggest 模式**:警告、允許覆蓋
|
|
42
|
+
- **off 模式**:完全跳過檢查
|
|
43
|
+
|
|
44
|
+
### 閘門類型
|
|
45
|
+
|
|
46
|
+
| 閘門類型 | 阻斷 | 描述 |
|
|
47
|
+
|---------|------|------|
|
|
48
|
+
| **硬閘門** | 是 | 必須通過才能繼續(例如:規格必須為已核准才能實作) |
|
|
49
|
+
| **軟閘門** | 否 | 建議性警告(例如:建議在 commit 中引用規格) |
|
|
50
|
+
|
|
51
|
+
## SDD 階段閘門
|
|
52
|
+
|
|
53
|
+
```
|
|
54
|
+
discuss → create → review → approve → implement → verify
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
| 階段 | 前置條件 |
|
|
58
|
+
|------|---------|
|
|
59
|
+
| discuss | 無(入口點) |
|
|
60
|
+
| create | 檢查孤兒規格(軟閘門) |
|
|
61
|
+
| review | 規格存在且狀態 = Draft |
|
|
62
|
+
| approve | 規格存在且狀態 = Review,所有評論已處理 |
|
|
63
|
+
| implement | 規格存在且狀態 = Approved |
|
|
64
|
+
| verify | 實作存在,所有 AC 有程式碼 + 測試 |
|
|
65
|
+
|
|
66
|
+
## TDD 階段閘門
|
|
67
|
+
|
|
68
|
+
```
|
|
69
|
+
RED → GREEN → REFACTOR → (重複)
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
| 階段 | 前置條件 |
|
|
73
|
+
|------|---------|
|
|
74
|
+
| RED | 功能/行為已明確定義 |
|
|
75
|
+
| GREEN | 至少一個失敗的測試存在(不是錯誤,而是斷言失敗) |
|
|
76
|
+
| REFACTOR | 所有測試通過 |
|
|
77
|
+
|
|
78
|
+
**關鍵強制規則**:AI 不得在失敗測試存在之前撰寫實作程式碼。這是 TDD 的基本契約。
|
|
79
|
+
|
|
80
|
+
## BDD 階段閘門
|
|
81
|
+
|
|
82
|
+
```
|
|
83
|
+
DISCOVERY → FORMULATION → AUTOMATION → LIVING DOCS
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
| 階段 | 前置條件 |
|
|
87
|
+
|------|---------|
|
|
88
|
+
| DISCOVERY | 行為/功能已識別 |
|
|
89
|
+
| FORMULATION | 探索階段產出的具體範例存在 |
|
|
90
|
+
| AUTOMATION | 包含 Gherkin 場景的 `.feature` 檔案存在 |
|
|
91
|
+
| LIVING DOCS | 步驟定義已實作,所有場景通過 |
|
|
92
|
+
|
|
93
|
+
## 提交閘門
|
|
94
|
+
|
|
95
|
+
| 檢查 | 類型 | 觸發 |
|
|
96
|
+
|------|------|------|
|
|
97
|
+
| 存在已暫存的變更 | 硬閘門 | 所有提交 |
|
|
98
|
+
| 無合併衝突 | 硬閘門 | 所有提交 |
|
|
99
|
+
| 測試通過 | 硬閘門 | feat/fix 提交 |
|
|
100
|
+
| 規格引用 | 軟閘門 | 有活躍規格的 feat/fix 提交 |
|
|
101
|
+
|
|
102
|
+
## 實作注意事項
|
|
103
|
+
|
|
104
|
+
### 對於 AI 助手
|
|
105
|
+
|
|
106
|
+
AI 助手應該:
|
|
107
|
+
1. 在執行任何工作流程階段**之前**檢查閘門
|
|
108
|
+
2. 使用專案設定中的執行模式
|
|
109
|
+
3. 當閘門失敗時提供清晰、可操作的指引
|
|
110
|
+
4. 在開始新工作流程前檢查是否有可恢復的工作流程狀態
|
|
111
|
+
5. 在 `.workflow-state/` 中追蹤階段轉換
|
|
112
|
+
|
|
113
|
+
### 對於 CLI 工具
|
|
114
|
+
|
|
115
|
+
CLI 工具可透過以下方式整合閘門:
|
|
116
|
+
1. `WorkflowGate` 模組 — 驗證階段轉換
|
|
117
|
+
2. Pre-commit hooks — 警告工作流程合規性
|
|
118
|
+
3. `uds check` — 報告工作流程狀態
|
|
119
|
+
|
|
120
|
+
### 對於 Git Hooks
|
|
121
|
+
|
|
122
|
+
Git 層級的執行應為**僅警告**(非阻斷),以避免讓開發者感到挫折。AI 層級處理阻斷性執行,因為它可以解釋和引導。
|
|
123
|
+
|
|
124
|
+
## 與其他標準的關係
|
|
125
|
+
|
|
126
|
+
| 標準 | 關係 |
|
|
127
|
+
|------|------|
|
|
128
|
+
| [工作流狀態協議](workflow-state-protocol.md) | 閘門檢查由此協議管理的狀態檔案 |
|
|
129
|
+
| [規格驅動開發](spec-driven-development.md) | SDD 階段閘門強制 SDD 工作流程 |
|
|
130
|
+
| [測試標準](testing-standards.md) | TDD/BDD 閘門強制測試方法論 |
|
|
131
|
+
| [提交訊息指南](commit-message-guide.md) | 提交閘門強制規格追蹤性 |
|
|
132
|
+
| [簽入標準](checkin-standards.md) | Pre-commit 閘門補充簽入規則 |
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# UDS 速查表
|
|
2
2
|
|
|
3
|
-
> Quick reference for all UDS features | Last updated: 2026-03-
|
|
3
|
+
> Quick reference for all UDS features | Last updated: 2026-03-24
|
|
4
4
|
|
|
5
5
|
**Language**: [English](../../../docs/CHEATSHEET.md) | 繁體中文 | [简体中文](../../zh-CN/docs/CHEATSHEET.md)
|
|
6
6
|
|
|
@@ -24,6 +24,7 @@
|
|
|
24
24
|
|
|
25
25
|
| Command | 說明 |
|
|
26
26
|
|---------|-------------|
|
|
27
|
+
| `/ac-coverage` | "[UDS] Generate AC-to-test traceability matrix and coverage report" |
|
|
27
28
|
| `/atdd` | [UDS] Guide through Acceptance Test-Driven Development workflow |
|
|
28
29
|
| `/bdd` | [UDS] Guide through Behavior-Driven Development workflow |
|
|
29
30
|
| `/brainstorm` | "[UDS] Structured AI-assisted brainstorming before spec creation" |
|
|
@@ -62,31 +63,42 @@
|
|
|
62
63
|
|
|
63
64
|
| Skill | 說明 |
|
|
64
65
|
|-------|-------------|
|
|
66
|
+
| `ac-coverage-assistant` | "[UDS] Analyze AC-to-test traceability and coverage" |
|
|
65
67
|
| `ai-collaboration-standards` | Prevent AI hallucination and ensure evidence-based responses |
|
|
66
68
|
| `ai-friendly-architecture` | Design AI-friendly architecture with explicit patterns, laye |
|
|
67
69
|
| `ai-instruction-standards` | Create and maintain AI instruction files (CLAUDE.md, .cursor |
|
|
70
|
+
| `api-design-assistant` | Guide API design following REST, GraphQL, and gRPC best prac |
|
|
68
71
|
| `atdd-assistant` | "[UDS] Guide through Acceptance Test-Driven Development work |
|
|
69
72
|
| `audit-assistant` | "[UDS] UDS Health & Feedback System \| UDS 健康檢查與回饋系統" |
|
|
70
73
|
| `bdd-assistant` | "[UDS] Guide through Behavior-Driven Development workflow" |
|
|
71
74
|
| `brainstorm-assistant` | "[UDS] Structured AI-assisted brainstorming before spec crea |
|
|
72
75
|
| `changelog-guide` | "[UDS] Generate and maintain CHANGELOG.md entries" |
|
|
73
76
|
| `checkin-assistant` | "[UDS] Pre-commit quality gates verification" |
|
|
77
|
+
| `ci-cd-assistant` | Guide CI/CD pipeline design, configuration, and optimization |
|
|
74
78
|
| `code-review-assistant` | "[UDS] Perform systematic code review with checklist" |
|
|
75
79
|
| `commit-standards` | "[UDS] Generate commit messages following Conventional Commi |
|
|
80
|
+
| `database-assistant` | Guide database design, migration, and query optimization. |
|
|
76
81
|
| `dev-workflow-guide` | "[UDS] Guide for mapping software development phases to UDS |
|
|
77
82
|
| `docs-generator` | "[UDS] Generate usage documentation from project sources" |
|
|
78
83
|
| `documentation-guide` | Guide documentation structure, content requirements, and pro |
|
|
84
|
+
| `durable-execution-assistant` | "[UDS] Guide workflow failure recovery with checkpoints, ret |
|
|
79
85
|
| `error-code-guide` | Design consistent error codes following the PREFIX_CATEGORY_ |
|
|
80
86
|
| `forward-derivation` | "[UDS] Derive BDD scenarios, TDD skeletons, or ATDD tables f |
|
|
81
87
|
| `git-workflow-guide` | Guide Git branching strategies, branch naming, and merge ope |
|
|
88
|
+
| `incident-response-assistant` | Guide incident response, root cause analysis, and post-morte |
|
|
82
89
|
| `logging-guide` | Implement structured logging with proper log levels and sens |
|
|
83
90
|
| `methodology-system` | "[UDS] Manage development methodology workflow" |
|
|
91
|
+
| `metrics-dashboard-assistant` | "[UDS] Track development metrics, code quality indicators, a |
|
|
92
|
+
| `migration-assistant` | "[UDS] Guide code migration, framework upgrades, and technol |
|
|
93
|
+
| `pr-automation-assistant` | Guide pull request creation, review automation, and merge st |
|
|
84
94
|
| `project-discovery` | "[UDS] Assess project health, architecture, and risks before |
|
|
85
95
|
| `project-structure-guide` | Guide for organizing project directories following language- |
|
|
86
96
|
| `refactoring-assistant` | "[UDS] Guide refactoring decisions and strategy selection" |
|
|
87
97
|
| `release-standards` | "[UDS] Guide release process and changelogs" |
|
|
88
98
|
| `requirement-assistant` | "[UDS] Write user stories and requirements following INVEST |
|
|
89
99
|
| `reverse-engineer` | "[UDS] System archeology — reverse engineer code across Logi |
|
|
100
|
+
| `security-assistant` | Guide security review and vulnerability assessment following |
|
|
101
|
+
| `security-scan-assistant` | Guide automated security scanning, dependency auditing, and |
|
|
90
102
|
| `spec-driven-dev` | "[UDS] Create or review specification documents for Spec-Dri |
|
|
91
103
|
| `tdd-assistant` | "[UDS] Guide through Test-Driven Development workflow" |
|
|
92
104
|
| `test-coverage-assistant` | "[UDS] Analyze test coverage and provide recommendations" |
|
|
@@ -116,18 +128,24 @@
|
|
|
116
128
|
|
|
117
129
|
| Standard | 說明 |
|
|
118
130
|
|----------|-------------|
|
|
131
|
+
| `acceptance-criteria-traceability` | Acceptance Criteria Traceability Standards |
|
|
119
132
|
| `acceptance-test-driven-development` | Acceptance Test-Driven Development (ATDD) Standards |
|
|
120
133
|
| `accessibility-standards` | This standard defines comprehensive guidelines for |
|
|
134
|
+
| `agent-dispatch` | Define standards for dispatching AI sub-agents in |
|
|
121
135
|
| `ai-agreement-standards` | This standard formalizes the interaction between H |
|
|
122
136
|
| `ai-friendly-architecture` | This standard defines architecture and documentati |
|
|
123
137
|
| `ai-instruction-standards` | This standard defines best practices for creating |
|
|
124
138
|
| `anti-hallucination` | This standard defines strict guidelines for AI ass |
|
|
139
|
+
| `api-design-standards` | This standard defines comprehensive guidelines for |
|
|
125
140
|
| `behavior-driven-development` | Behavior-Driven Development (BDD) Standards |
|
|
141
|
+
| `branch-completion` | Define a standardized workflow for completing deve |
|
|
142
|
+
| `change-batching-standards` | Change Batching Standards |
|
|
126
143
|
| `changelog-standards` | This standard defines how to write and maintain a |
|
|
127
144
|
| `checkin-standards` | This standard defines quality gates that MUST be p |
|
|
128
145
|
| `code-review-checklist` | This standard provides a comprehensive checklist f |
|
|
129
146
|
| `commit-message-guide` | Standardized commit messages improve code review e |
|
|
130
147
|
| `context-aware-loading` | This standard defines a protocol for AI tools to s |
|
|
148
|
+
| `database-standards` | This standard defines guidelines for database desi |
|
|
131
149
|
| `deployment-standards` | This standard defines guidelines for safely deploy |
|
|
132
150
|
| `developer-memory` | This standard defines a structured system for capt |
|
|
133
151
|
| `documentation-structure` | This standard defines a consistent documentation s |
|
|
@@ -135,8 +153,11 @@
|
|
|
135
153
|
| `error-code-standards` | Error Code Standards |
|
|
136
154
|
| `forward-derivation-standards` | This standard defines the principles and workflows |
|
|
137
155
|
| `git-workflow` | This standard defines Git branching strategies and |
|
|
156
|
+
| `git-worktree` | Define a lifecycle for using Git worktrees to isol |
|
|
138
157
|
| `logging-standards` | Logging Standards |
|
|
158
|
+
| `model-selection` | Define a cost-effective strategy for selecting AI |
|
|
139
159
|
| `performance-standards` | This standard defines comprehensive guidelines for |
|
|
160
|
+
| `pipeline-integration-standards` | Pipeline Integration Standards |
|
|
140
161
|
| `project-context-memory` | This standard defines a structured system for capt |
|
|
141
162
|
| `project-structure` | This standard defines conventions for project dire |
|
|
142
163
|
| `refactoring-standards` | This standard defines comprehensive guidelines for |
|
|
@@ -145,12 +166,15 @@
|
|
|
145
166
|
| `security-standards` | This standard defines comprehensive security guide |
|
|
146
167
|
| `spec-driven-development` | Spec-Driven Development (SDD) Standards |
|
|
147
168
|
| `structured-task-definition` | Structured Task Definition Standards |
|
|
169
|
+
| `systematic-debugging` | Define a structured, four-phase debugging workflow |
|
|
148
170
|
| `test-completeness-dimensions` | This document defines a systematic framework for e |
|
|
149
171
|
| `test-driven-development` | Test-Driven Development (TDD) Standards |
|
|
150
172
|
| `test-governance` | Test Governance Standards |
|
|
151
173
|
| `testing-standards` | This standard defines actionable testing rules and |
|
|
174
|
+
| `verification-evidence` | Establish an "Iron Law" that no task can be claime |
|
|
152
175
|
| `versioning` | This standard defines how to version software rele |
|
|
153
176
|
| `virtual-organization-standards` | This standard treats the AI ecosystem as a "Virtua |
|
|
177
|
+
| `workflow-enforcement` | Workflow Enforcement Standards |
|
|
154
178
|
| `workflow-state-protocol` | Workflow State Protocol |
|
|
155
179
|
|
|
156
180
|
## 📜 腳本
|
|
@@ -164,6 +188,7 @@
|
|
|
164
188
|
| `check-cli-docs-sync.sh` | CLI-to-Documentation Sync Checker |
|
|
165
189
|
| `check-commands-sync.ps1` | Check Commands Sync |
|
|
166
190
|
| `check-commands-sync.sh` | Commands Sync Checker |
|
|
191
|
+
| `check-commit-spec-reference.sh` | Commit-msg Spec Reference Suggestion — WARNING ONL |
|
|
167
192
|
| `check-docs-integrity.ps1` | Check Docs Integrity |
|
|
168
193
|
| `check-docs-integrity.sh` | Documentation Integrity Checker |
|
|
169
194
|
| `check-docs-sync.ps1` | Check Docs Sync |
|
|
@@ -186,6 +211,7 @@
|
|
|
186
211
|
| `check-usage-docs-sync.sh` | check-usage-docs-sync.sh |
|
|
187
212
|
| `check-version-sync.ps1` | Check Version Sync |
|
|
188
213
|
| `check-version-sync.sh` | Version Sync Checker |
|
|
214
|
+
| `check-workflow-compliance.sh` | Workflow Compliance Check — WARNING ONLY (non-bloc |
|
|
189
215
|
| `convert-md-to-yaml.mjs` | Markdown to AI-YAML Conversion Script |
|
|
190
216
|
| `fix-manifest-paths.ps1` | Fix Manifest Paths |
|
|
191
217
|
| `fix-manifest-paths.sh` | Manifest Path Fixer |
|
|
@@ -728,7 +728,7 @@ You are an AI assistant that prioritizes accuracy over confidence...
|
|
|
728
728
|
---
|
|
729
729
|
|
|
730
730
|
## Commit Message Standards
|
|
731
|
-
Reference: .standards/commit-message
|
|
731
|
+
Reference: .standards/commit-message.ai.yaml
|
|
732
732
|
|
|
733
733
|
### Format Structure
|
|
734
734
|
<type>(<scope>): <subject>
|
|
@@ -864,6 +864,8 @@ uds init --experimental
|
|
|
864
864
|
|------|----------|------|
|
|
865
865
|
| 非互動模式 | `-y, --yes` | 跳過互動提示,使用預設值 |
|
|
866
866
|
| 實驗性功能 | `-E, --experimental` | 啟用實驗性功能(開發方法論選擇) |
|
|
867
|
+
| AGENTS.md | `--agents-md` | 生成 AGENTS.md 通用摘要(預設:未選 codex/opencode 時自動生成) |
|
|
868
|
+
| 不生成 AGENTS.md | `--no-agents-md` | 跳過 AGENTS.md 生成 |
|
|
867
869
|
| 模式(已棄用) | `-m, --mode` | 安裝模式(skills, full)- 請改用 `--skills-location` |
|
|
868
870
|
|
|
869
871
|
### 完整 CLI 範例
|
|
@@ -888,6 +890,12 @@ uds init -y \
|
|
|
888
890
|
# 企業級完整設定
|
|
889
891
|
uds init -y --content-mode full
|
|
890
892
|
|
|
893
|
+
# 生成 AGENTS.md 通用摘要(--yes 模式預設生成)
|
|
894
|
+
uds init -y --agents-md
|
|
895
|
+
|
|
896
|
+
# 跳過 AGENTS.md 生成
|
|
897
|
+
uds init -y --no-agents-md
|
|
898
|
+
|
|
891
899
|
# 繁體中文團隊
|
|
892
900
|
uds init -y --commit-lang traditional-chinese --locale zh-tw
|
|
893
901
|
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
# UDS 功能參考手冊
|
|
2
2
|
|
|
3
3
|
> Universal Development Standards - 完整功能文件
|
|
4
|
-
> Auto-generated | Last updated: 2026-03-
|
|
4
|
+
> Auto-generated | Last updated: 2026-03-24
|
|
5
5
|
|
|
6
6
|
**Language**: [English](../../../docs/FEATURE-REFERENCE.md) | 繁體中文 | [简体中文](../../zh-CN/docs/FEATURE-REFERENCE.md)
|
|
7
7
|
|
|
@@ -10,14 +10,14 @@
|
|
|
10
10
|
## 目錄
|
|
11
11
|
|
|
12
12
|
1. [CLI 指令](#cli-commands) (9)
|
|
13
|
-
2. [斜線命令](#slash-commands) (
|
|
14
|
-
3. [技能](#skills) (
|
|
13
|
+
2. [斜線命令](#slash-commands) (45)
|
|
14
|
+
3. [技能](#skills) (40)
|
|
15
15
|
4. [代理](#agents) (5)
|
|
16
16
|
5. [工作流程](#workflows) (5)
|
|
17
|
-
6. [核心規範](#core-standards) (
|
|
18
|
-
7. [腳本](#scripts) (
|
|
17
|
+
6. [核心規範](#core-standards) (48)
|
|
18
|
+
7. [腳本](#scripts) (41)
|
|
19
19
|
|
|
20
|
-
**Total Features:
|
|
20
|
+
**Total Features: 182**
|
|
21
21
|
|
|
22
22
|
---
|
|
23
23
|
|
|
@@ -50,6 +50,8 @@
|
|
|
50
50
|
| `--locale` | Locale extension (zh-tw) |
|
|
51
51
|
| `--skills-location` | Skills location (marketplace, user, project, none) [default: marketplace] |
|
|
52
52
|
| `--content-mode` | Content mode for integration files (minimal, index, full) [default: index] |
|
|
53
|
+
| `--agents-md` | Generate AGENTS.md universal summary |
|
|
54
|
+
| `--no-agents-md` | Skip AGENTS.md generation |
|
|
53
55
|
| `-y, --yes` | Use defaults, skip interactive prompts |
|
|
54
56
|
| `-E, --experimental` | Enable experimental features (methodology) |
|
|
55
57
|
|
|
@@ -148,6 +150,7 @@
|
|
|
148
150
|
|
|
149
151
|
| Command | 說明 |
|
|
150
152
|
|---------|-------------|
|
|
153
|
+
| `/ac-coverage` | "[UDS] Generate AC-to-test traceability matrix and coverage report" |
|
|
151
154
|
| `/atdd` | [UDS] Guide through Acceptance Test-Driven Development workflow |
|
|
152
155
|
| `/bdd` | [UDS] Guide through Behavior-Driven Development workflow |
|
|
153
156
|
| `/brainstorm` | "[UDS] Structured AI-assisted brainstorming before spec creation" |
|
|
@@ -188,31 +191,42 @@
|
|
|
188
191
|
|
|
189
192
|
| Skill | 說明 |
|
|
190
193
|
|-------|-------------|
|
|
194
|
+
| `ac-coverage-assistant` | "[UDS] Analyze AC-to-test traceability and coverage" |
|
|
191
195
|
| `ai-collaboration-standards` | Prevent AI hallucination and ensure evidence-based responses when analyzing code or making suggestions. |
|
|
192
196
|
| `ai-friendly-architecture` | Design AI-friendly architecture with explicit patterns, layered documentation, and semantic boundaries. |
|
|
193
197
|
| `ai-instruction-standards` | Create and maintain AI instruction files (CLAUDE.md, .cursorrules, etc.) with proper structure. |
|
|
198
|
+
| `api-design-assistant` | Guide API design following REST, GraphQL, and gRPC best practices. |
|
|
194
199
|
| `atdd-assistant` | "[UDS] Guide through Acceptance Test-Driven Development workflow" |
|
|
195
200
|
| `audit-assistant` | "[UDS] UDS Health & Feedback System \| UDS 健康檢查與回饋系統" |
|
|
196
201
|
| `bdd-assistant` | "[UDS] Guide through Behavior-Driven Development workflow" |
|
|
197
202
|
| `brainstorm-assistant` | "[UDS] Structured AI-assisted brainstorming before spec creation" |
|
|
198
203
|
| `changelog-guide` | "[UDS] Generate and maintain CHANGELOG.md entries" |
|
|
199
204
|
| `checkin-assistant` | "[UDS] Pre-commit quality gates verification" |
|
|
205
|
+
| `ci-cd-assistant` | Guide CI/CD pipeline design, configuration, and optimization. |
|
|
200
206
|
| `code-review-assistant` | "[UDS] Perform systematic code review with checklist" |
|
|
201
207
|
| `commit-standards` | "[UDS] Generate commit messages following Conventional Commits standard" |
|
|
208
|
+
| `database-assistant` | Guide database design, migration, and query optimization. |
|
|
202
209
|
| `dev-workflow-guide` | "[UDS] Guide for mapping software development phases to UDS commands and features" |
|
|
203
210
|
| `docs-generator` | "[UDS] Generate usage documentation from project sources" |
|
|
204
211
|
| `documentation-guide` | Guide documentation structure, content requirements, and project documentation best practices. |
|
|
212
|
+
| `durable-execution-assistant` | "[UDS] Guide workflow failure recovery with checkpoints, retries, and rollback" |
|
|
205
213
|
| `error-code-guide` | Design consistent error codes following the PREFIX_CATEGORY_NUMBER format. |
|
|
206
214
|
| `forward-derivation` | "[UDS] Derive BDD scenarios, TDD skeletons, or ATDD tables from specifications" |
|
|
207
215
|
| `git-workflow-guide` | Guide Git branching strategies, branch naming, and merge operations. |
|
|
216
|
+
| `incident-response-assistant` | Guide incident response, root cause analysis, and post-mortem documentation. |
|
|
208
217
|
| `logging-guide` | Implement structured logging with proper log levels and sensitive data handling. |
|
|
209
218
|
| `methodology-system` | "[UDS] Manage development methodology workflow" |
|
|
219
|
+
| `metrics-dashboard-assistant` | "[UDS] Track development metrics, code quality indicators, and project health" |
|
|
220
|
+
| `migration-assistant` | "[UDS] Guide code migration, framework upgrades, and technology modernization" |
|
|
221
|
+
| `pr-automation-assistant` | Guide pull request creation, review automation, and merge strategies. |
|
|
210
222
|
| `project-discovery` | "[UDS] Assess project health, architecture, and risks before adding features" |
|
|
211
223
|
| `project-structure-guide` | Guide for organizing project directories following language-specific best practices. |
|
|
212
224
|
| `refactoring-assistant` | "[UDS] Guide refactoring decisions and strategy selection" |
|
|
213
225
|
| `release-standards` | "[UDS] Guide release process and changelogs" |
|
|
214
226
|
| `requirement-assistant` | "[UDS] Write user stories and requirements following INVEST criteria" |
|
|
215
227
|
| `reverse-engineer` | "[UDS] System archeology — reverse engineer code across Logic, Data, and Runtime dimensions" |
|
|
228
|
+
| `security-assistant` | Guide security review and vulnerability assessment following OWASP standards. |
|
|
229
|
+
| `security-scan-assistant` | Guide automated security scanning, dependency auditing, and secret detection. |
|
|
216
230
|
| `spec-driven-dev` | "[UDS] Create or review specification documents for Spec-Driven Development" |
|
|
217
231
|
| `tdd-assistant` | "[UDS] Guide through Test-Driven Development workflow" |
|
|
218
232
|
| `test-coverage-assistant` | "[UDS] Analyze test coverage and provide recommendations" |
|
|
@@ -248,27 +262,36 @@
|
|
|
248
262
|
|
|
249
263
|
| Standard | 版本 | 說明 |
|
|
250
264
|
|----------|---------|-------------|
|
|
265
|
+
| `acceptance-criteria-traceability` | - | |
|
|
251
266
|
| `acceptance-test-driven-development` | 1.1.0 | |
|
|
252
267
|
| `accessibility-standards` | 1.0.0 | This standard defines comprehensive guidelines for creating accessible software |
|
|
268
|
+
| `agent-dispatch` | 1.0.0 | Define standards for dispatching AI sub-agents in parallel, coordinating their w |
|
|
253
269
|
| `ai-agreement-standards` | 1.0.0 | This standard formalizes the interaction between Human (Acquirer) and AI (Suppli |
|
|
254
270
|
| `ai-friendly-architecture` | 1.0.0 | This standard defines architecture and documentation practices that maximize the |
|
|
255
271
|
| `ai-instruction-standards` | 1.0.0 | This standard defines best practices for creating and maintaining AI instruction |
|
|
256
272
|
| `anti-hallucination` | 1.5.0 | This standard defines strict guidelines for AI assistants to prevent hallucinati |
|
|
273
|
+
| `api-design-standards` | 1.0.0 | This standard defines comprehensive guidelines for designing, building, and main |
|
|
257
274
|
| `behavior-driven-development` | 1.1.0 | |
|
|
275
|
+
| `branch-completion` | 1.0.0 | Define a standardized workflow for completing development branches, including pr |
|
|
276
|
+
| `change-batching-standards` | - | |
|
|
258
277
|
| `changelog-standards` | 1.0.2 | This standard defines how to write and maintain a CHANGELOG.md file to communica |
|
|
259
|
-
| `checkin-standards` | 1.
|
|
278
|
+
| `checkin-standards` | 1.5.0 | This standard defines quality gates that MUST be passed before committing code t |
|
|
260
279
|
| `code-review-checklist` | 1.3.0 | This standard provides a comprehensive checklist for reviewing code changes, ens |
|
|
261
280
|
| `commit-message-guide` | 1.3.0 | Standardized commit messages improve code review efficiency, facilitate automate |
|
|
262
281
|
| `context-aware-loading` | 1.0.0 | This standard defines a protocol for AI tools to selectively load development st |
|
|
282
|
+
| `database-standards` | 1.0.0 | This standard defines guidelines for database design, querying, migration, and o |
|
|
263
283
|
| `deployment-standards` | 1.0.0 | This standard defines guidelines for safely deploying software to production, co |
|
|
264
284
|
| `developer-memory` | 1.0.0 | This standard defines a structured system for capturing, retrieving, and surfaci |
|
|
265
285
|
| `documentation-structure` | 1.5.0 | This standard defines a consistent documentation structure for software projects |
|
|
266
286
|
| `documentation-writing-standards` | 1.2.0 | This standard defines documentation requirements based on project types and prov |
|
|
267
|
-
| `error-code-standards` | 1.
|
|
268
|
-
| `forward-derivation-standards` | 1.
|
|
287
|
+
| `error-code-standards` | 1.2.0 | |
|
|
288
|
+
| `forward-derivation-standards` | 1.2.0 | This standard defines the principles and workflows for Forward Derivation—automa |
|
|
269
289
|
| `git-workflow` | 1.4.0 | This standard defines Git branching strategies and workflows to ensure consisten |
|
|
290
|
+
| `git-worktree` | 1.0.0 | Define a lifecycle for using Git worktrees to isolate development work, ensuring |
|
|
270
291
|
| `logging-standards` | 1.2.0 | |
|
|
292
|
+
| `model-selection` | 1.0.0 | Define a cost-effective strategy for selecting AI model tiers based on task comp |
|
|
271
293
|
| `performance-standards` | 1.1.0 | This standard defines comprehensive guidelines for software performance engineer |
|
|
294
|
+
| `pipeline-integration-standards` | - | |
|
|
272
295
|
| `project-context-memory` | 1.1.0 | This standard defines a structured system for capturing, retrieving, and enforci |
|
|
273
296
|
| `project-structure` | 1.2.0 | This standard defines conventions for project directory structure beyond documen |
|
|
274
297
|
| `refactoring-standards` | 2.1.0 | This standard defines comprehensive guidelines for code refactoring, covering ev |
|
|
@@ -277,12 +300,15 @@
|
|
|
277
300
|
| `security-standards` | 1.1.0 | This standard defines comprehensive security guidelines for software development |
|
|
278
301
|
| `spec-driven-development` | 2.1.0 | |
|
|
279
302
|
| `structured-task-definition` | 1.0.0 | |
|
|
303
|
+
| `systematic-debugging` | 1.0.0 | Define a structured, four-phase debugging workflow that prevents the common anti |
|
|
280
304
|
| `test-completeness-dimensions` | 1.1.0 | This document defines a systematic framework for evaluating test completeness. I |
|
|
281
305
|
| `test-driven-development` | 1.2.0 | |
|
|
282
306
|
| `test-governance` | - | |
|
|
283
307
|
| `testing-standards` | 3.0.0 | This standard defines actionable testing rules and conventions for AI agents and |
|
|
308
|
+
| `verification-evidence` | 1.0.0 | Establish an "Iron Law" that no task can be claimed as complete without verifica |
|
|
284
309
|
| `versioning` | 1.2.0 | This standard defines how to version software releases using Semantic Versioning |
|
|
285
310
|
| `virtual-organization-standards` | 1.0.0 | This standard treats the AI ecosystem as a "Virtual Organization." It defines ho |
|
|
311
|
+
| `workflow-enforcement` | - | |
|
|
286
312
|
| `workflow-state-protocol` | 1.0.0 | |
|
|
287
313
|
|
|
288
314
|
---
|
|
@@ -298,6 +324,7 @@
|
|
|
298
324
|
| `check-cli-docs-sync.sh` | CLI-to-Documentation Sync Checker |
|
|
299
325
|
| `check-commands-sync.ps1` | Check Commands Sync |
|
|
300
326
|
| `check-commands-sync.sh` | Commands Sync Checker |
|
|
327
|
+
| `check-commit-spec-reference.sh` | Commit-msg Spec Reference Suggestion — WARNING ONLY (non-blocking) |
|
|
301
328
|
| `check-docs-integrity.ps1` | Check Docs Integrity |
|
|
302
329
|
| `check-docs-integrity.sh` | Documentation Integrity Checker |
|
|
303
330
|
| `check-docs-sync.ps1` | Check Docs Sync |
|
|
@@ -320,6 +347,7 @@
|
|
|
320
347
|
| `check-usage-docs-sync.sh` | check-usage-docs-sync.sh |
|
|
321
348
|
| `check-version-sync.ps1` | Check Version Sync |
|
|
322
349
|
| `check-version-sync.sh` | Version Sync Checker |
|
|
350
|
+
| `check-workflow-compliance.sh` | Workflow Compliance Check — WARNING ONLY (non-blocking) |
|
|
323
351
|
| `convert-md-to-yaml.mjs` | Markdown to AI-YAML Conversion Script |
|
|
324
352
|
| `fix-manifest-paths.ps1` | Fix Manifest Paths |
|
|
325
353
|
| `fix-manifest-paths.sh` | Manifest Path Fixer |
|