universal-dev-standards 5.16.0 → 6.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 +13 -135
- package/bundled/ai/standards/acceptance-criteria-traceability.ai.yaml +13 -4
- package/bundled/ai/standards/accessibility-standards.ai.yaml +1 -1
- package/bundled/ai/standards/ai-response-navigation.ai.yaml +15 -2
- package/bundled/ai/standards/api-design-standards.ai.yaml +27 -4
- package/bundled/ai/standards/behavior-snapshot.ai.yaml +86 -9
- package/bundled/ai/standards/checkin-standards.ai.yaml +2 -2
- package/bundled/ai/standards/code-review.ai.yaml +2 -2
- package/bundled/ai/standards/context-aware-loading.ai.yaml +3 -3
- package/bundled/ai/standards/data-migration-testing.ai.yaml +79 -3
- package/bundled/ai/standards/deprecation-standards.ai.yaml +10 -2
- package/bundled/ai/standards/developer-memory.ai.yaml +4 -3
- package/bundled/ai/standards/flow-based-testing.ai.yaml +2 -2
- package/bundled/ai/standards/forward-derivation-standards.ai.yaml +26 -2
- package/bundled/ai/standards/full-coverage-testing.ai.yaml +34 -2
- package/bundled/ai/standards/git-worktree.ai.yaml +3 -3
- package/bundled/ai/standards/logging.ai.yaml +97 -3
- package/bundled/ai/standards/mock-boundary.ai.yaml +48 -2
- package/bundled/ai/standards/model-provenance.ai.yaml +297 -0
- package/bundled/ai/standards/model-selection.ai.yaml +11 -2
- package/bundled/ai/standards/observability-standards.ai.yaml +10 -0
- package/bundled/ai/standards/performance-standards.ai.yaml +46 -1
- package/bundled/ai/standards/pii-classification.ai.yaml +15 -1
- package/bundled/ai/standards/pipeline-security-gates.ai.yaml +10 -0
- package/bundled/ai/standards/privacy-standards.ai.yaml +2 -2
- package/bundled/ai/standards/project-context-memory.ai.yaml +2 -2
- package/bundled/ai/standards/refactoring-standards.ai.yaml +68 -3
- package/bundled/ai/standards/resource-cost-boundary.ai.yaml +279 -0
- package/bundled/ai/standards/reverse-engineering-standards.ai.yaml +55 -2
- package/bundled/ai/standards/security-testing.ai.yaml +13 -2
- package/bundled/ai/standards/skill-standard-alignment-check.ai.yaml +37 -2
- package/bundled/ai/standards/user-journey-testing.ai.yaml +107 -0
- package/bundled/ai/standards/verification-oracle.ai.yaml +278 -0
- package/bundled/ai/standards/versioning.ai.yaml +32 -38
- package/bundled/core/acceptance-criteria-traceability.md +15 -5
- package/bundled/core/accessibility-standards.md +8 -4
- package/bundled/core/ai-friendly-architecture.md +1 -1
- package/bundled/core/ai-response-navigation.md +31 -3
- package/bundled/core/anti-sycophancy-prompting.md +1 -1
- package/bundled/core/api-design-standards.md +92 -7
- package/bundled/core/audit-trail.md +119 -0
- package/bundled/core/behavior-snapshot.md +94 -7
- package/bundled/core/browser-compatibility-standards.md +15 -2
- package/bundled/core/checkin-standards.md +9 -2
- package/bundled/core/code-review-checklist.md +10 -2
- package/bundled/core/container-image-standards.md +97 -0
- package/bundled/core/context-aware-loading.md +2 -2
- package/bundled/core/cost-budget-test.md +1 -1
- package/bundled/core/cross-flow-regression.md +3 -2
- package/bundled/core/data-contract.md +104 -0
- package/bundled/core/data-migration-testing.md +90 -0
- package/bundled/core/data-pipeline.md +113 -0
- package/bundled/core/deprecation-standards.md +16 -2
- package/bundled/core/developer-memory.md +13 -8
- package/bundled/core/documentation-writing-standards.md +1 -1
- package/bundled/core/error-code-standards.md +4 -3
- package/bundled/core/flaky-test-management.md +1 -1
- package/bundled/core/flow-based-testing.md +3 -3
- package/bundled/core/forward-derivation-standards.md +33 -5
- package/bundled/core/full-coverage-testing.md +72 -0
- package/bundled/core/git-worktree.md +4 -4
- package/bundled/core/guides/performance-guide.md +1 -1
- package/bundled/core/guides/security-guide.md +1 -1
- package/bundled/core/health-check-standards.md +2 -2
- package/bundled/core/iac-design-principles.md +97 -0
- package/bundled/core/incident-response.md +119 -0
- package/bundled/core/license-compliance.md +2 -0
- package/bundled/core/logging-standards.md +78 -2
- package/bundled/core/mock-boundary.md +54 -2
- package/bundled/core/model-provenance.md +181 -0
- package/bundled/core/model-selection.md +27 -2
- package/bundled/core/packaging-standards.md +1 -0
- package/bundled/core/performance-standards.md +96 -2
- package/bundled/core/pii-classification.md +148 -0
- package/bundled/core/pipeline-security-gates.md +22 -2
- package/bundled/core/postmortem-standards.md +2 -0
- package/bundled/core/prd-standards.md +91 -0
- package/bundled/core/privacy-standards.md +14 -3
- package/bundled/core/product-metrics-standards.md +100 -0
- package/bundled/core/project-context-memory.md +8 -2
- package/bundled/core/prompt-regression.md +1 -1
- package/bundled/core/refactoring-standards.md +44 -3
- package/bundled/core/replay-test.md +1 -1
- package/bundled/core/resource-cost-boundary.md +180 -0
- package/bundled/core/reverse-engineering-standards.md +66 -2
- package/bundled/core/runbook.md +113 -0
- package/bundled/core/schema-evolution.md +105 -0
- package/bundled/core/secret-management-standards.md +110 -0
- package/bundled/core/security-testing.md +26 -2
- package/bundled/core/self-review-protocol.md +2 -2
- package/bundled/core/skill-standard-alignment-check.md +53 -0
- package/bundled/core/slo-sli.md +109 -0
- package/bundled/core/smoke-test.md +1 -1
- package/bundled/core/spec-driven-development.md +21 -3
- package/bundled/core/tech-debt-standards.md +1 -1
- package/bundled/core/test-data-standards.md +2 -2
- package/bundled/core/user-journey-testing.md +102 -0
- package/bundled/core/user-story-mapping.md +96 -0
- package/bundled/core/verification-oracle.md +167 -0
- package/bundled/core/versioning.md +133 -109
- package/bundled/locales/COVERAGE.md +84 -73
- package/bundled/locales/zh-CN/CHANGELOG.md +81 -6
- package/bundled/locales/zh-CN/CLAUDE.md +1 -1
- package/bundled/locales/zh-CN/README.md +22 -9
- package/bundled/locales/zh-CN/SECURITY.md +1 -1
- package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -2
- package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +4 -6
- package/bundled/locales/zh-CN/core/accessibility-standards.md +1 -1
- package/bundled/locales/zh-CN/core/adversarial-test.md +226 -0
- package/bundled/locales/zh-CN/core/agent-behavior-discipline.md +187 -0
- package/bundled/locales/zh-CN/core/ai-response-navigation.md +32 -6
- package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +1 -1
- package/bundled/locales/zh-CN/core/api-design-standards.md +1 -1
- package/bundled/locales/zh-CN/core/behavior-snapshot.md +335 -0
- package/bundled/locales/zh-CN/core/browser-compatibility-standards.md +229 -0
- package/bundled/locales/zh-CN/core/cd-deployment-strategies.md +135 -0
- package/bundled/locales/zh-CN/core/chaos-injection-tests.md +130 -0
- package/bundled/locales/zh-CN/core/checkin-standards.md +1 -1
- package/bundled/locales/zh-CN/core/code-review-checklist.md +1 -1
- package/bundled/locales/zh-CN/core/container-security.md +535 -0
- package/bundled/locales/zh-CN/core/context-aware-loading.md +1 -1
- package/bundled/locales/zh-CN/core/contract-testing-standards.md +191 -0
- package/bundled/locales/zh-CN/core/cost-budget-test.md +86 -0
- package/bundled/locales/zh-CN/core/cross-flow-regression.md +199 -0
- package/bundled/locales/zh-CN/core/data-migration-testing.md +217 -0
- package/bundled/locales/zh-CN/core/deployment-standards.md +328 -9
- package/bundled/locales/zh-CN/core/deprecation-standards.md +1 -1
- package/bundled/locales/zh-CN/core/developer-memory.md +2 -2
- package/bundled/locales/zh-CN/core/disaster-recovery-drill.md +87 -0
- package/bundled/locales/zh-CN/core/documentation-structure.md +1 -1
- package/bundled/locales/zh-CN/core/documentation-writing-standards.md +1 -1
- package/bundled/locales/zh-CN/core/error-code-standards.md +2 -2
- package/bundled/locales/zh-CN/core/feature-manifest-standard.md +222 -0
- package/bundled/locales/zh-CN/core/flaky-test-management.md +87 -0
- package/bundled/locales/zh-CN/core/flow-based-testing.md +284 -0
- package/bundled/locales/zh-CN/core/forward-derivation-standards.md +3 -4
- package/bundled/locales/zh-CN/core/full-coverage-testing.md +197 -0
- package/bundled/locales/zh-CN/core/git-worktree.md +1 -1
- package/bundled/locales/zh-CN/core/governance-layer.md +160 -0
- package/bundled/locales/zh-CN/core/guides/performance-guide.md +515 -0
- package/bundled/locales/zh-CN/core/guides/security-guide.md +494 -0
- package/bundled/locales/zh-CN/core/knowledge-graph-memory.md +128 -0
- package/bundled/locales/zh-CN/core/license-compliance.md +129 -0
- package/bundled/locales/zh-CN/core/llm-output-validation.md +192 -0
- package/bundled/locales/zh-CN/core/logging-standards.md +130 -8
- package/bundled/locales/zh-CN/core/mock-boundary.md +109 -0
- package/bundled/locales/zh-CN/core/model-selection.md +28 -5
- package/bundled/locales/zh-CN/core/mutation-testing.md +106 -0
- package/bundled/locales/zh-CN/core/no-cicd-deployment.md +219 -0
- package/bundled/locales/zh-CN/core/packaging-standards.md +76 -5
- package/bundled/locales/zh-CN/core/pipeline-security-gates.md +126 -0
- package/bundled/locales/zh-CN/core/policy-as-code-testing.md +203 -0
- package/bundled/locales/zh-CN/core/privacy-standards.md +1 -1
- package/bundled/locales/zh-CN/core/project-context-memory.md +1 -1
- package/bundled/locales/zh-CN/core/prompt-regression.md +88 -0
- package/bundled/locales/zh-CN/core/property-based-testing.md +87 -0
- package/bundled/locales/zh-CN/core/release-quality-manifest.md +207 -0
- package/bundled/locales/zh-CN/core/release-readiness-gate.md +193 -0
- package/bundled/locales/zh-CN/core/replay-test.md +102 -0
- package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +46 -1
- package/bundled/locales/zh-CN/core/rollback-standards.md +120 -0
- package/bundled/locales/zh-CN/core/sast-advanced.md +309 -0
- package/bundled/locales/zh-CN/core/secure-op.md +328 -0
- package/bundled/locales/zh-CN/core/security-testing.md +96 -0
- package/bundled/locales/zh-CN/core/self-review-protocol.md +167 -0
- package/bundled/locales/zh-CN/core/server-ops-security.md +507 -0
- package/bundled/locales/zh-CN/core/smoke-test.md +79 -0
- package/bundled/locales/zh-CN/core/spec-driven-development.md +55 -5
- package/bundled/locales/zh-CN/core/supply-chain-attestation.md +131 -0
- package/bundled/locales/zh-CN/core/versioning.md +1 -1
- package/bundled/locales/zh-CN/docs/CHEATSHEET.md +31 -6
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +61 -34
- package/bundled/locales/zh-CN/docs/MIGRATION-v6.md +88 -0
- package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +2 -2
- package/bundled/locales/zh-CN/docs/USER-MANUAL.md +14 -14
- package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +105 -0
- package/bundled/locales/zh-CN/docs/user/FAQ.md +132 -0
- package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +144 -0
- package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +178 -0
- package/bundled/locales/zh-CN/docs/user/README.md +70 -0
- package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +190 -0
- package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +1 -1
- package/bundled/locales/zh-CN/integrations/github-copilot/README.md +1 -1
- package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +3 -3
- package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +3 -3
- package/bundled/locales/zh-CN/methodologies/guides/sdd-guide.md +836 -0
- package/bundled/locales/zh-CN/options/changelog/auto-generated.md +166 -0
- package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +140 -0
- package/bundled/locales/zh-CN/options/code-review/automated-review.md +214 -0
- package/bundled/locales/zh-CN/options/code-review/pair-programming.md +166 -0
- package/bundled/locales/zh-CN/options/code-review/pr-review.md +167 -0
- package/bundled/locales/zh-CN/options/documentation/api-docs.md +191 -0
- package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +150 -0
- package/bundled/locales/zh-CN/options/documentation/wiki-style.md +131 -0
- package/bundled/locales/zh-CN/options/project-structure/kotlin.md +144 -0
- package/bundled/locales/zh-CN/options/project-structure/php.md +168 -0
- package/bundled/locales/zh-CN/options/project-structure/ruby.md +156 -0
- package/bundled/locales/zh-CN/options/project-structure/rust.md +136 -0
- package/bundled/locales/zh-CN/options/project-structure/swift.md +165 -0
- package/bundled/locales/zh-CN/options/testing/contract-testing.md +237 -0
- package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +200 -0
- package/bundled/locales/zh-CN/options/testing/istqb-framework.md +144 -0
- package/bundled/locales/zh-CN/options/testing/performance-testing.md +251 -0
- package/bundled/locales/zh-CN/options/testing/security-testing.md +192 -0
- package/bundled/locales/zh-CN/skills/README.md +89 -126
- package/bundled/locales/zh-CN/skills/ac-coverage/SKILL.md +5 -7
- package/bundled/locales/zh-CN/skills/adr-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/agents/code-architect.md +263 -0
- package/bundled/locales/zh-CN/skills/agents/doc-writer.md +410 -0
- package/bundled/locales/zh-CN/skills/agents/reviewer.md +357 -0
- package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +410 -0
- package/bundled/locales/zh-CN/skills/agents/test-specialist.md +368 -0
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +1 -1
- package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +3 -4
- package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +1 -2
- package/bundled/locales/zh-CN/skills/brainstorm-assistant/SKILL.md +109 -13
- package/bundled/locales/zh-CN/skills/brainstorm-assistant/guide.md +30 -8
- package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +50 -0
- package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +5 -5
- package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +1 -1
- package/bundled/locales/zh-CN/skills/commands/atdd.md +3 -3
- package/bundled/locales/zh-CN/skills/commands/bdd.md +2 -2
- package/bundled/locales/zh-CN/skills/commands/brainstorm.md +26 -17
- package/bundled/locales/zh-CN/skills/commands/{review.md → code-review.md} +4 -4
- package/bundled/locales/zh-CN/skills/commands/derive-all.md +1 -1
- package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +1 -1
- package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +2 -3
- package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +1 -1
- package/bundled/locales/zh-CN/skills/commands/derive.md +1 -1
- package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +2 -2
- package/bundled/locales/zh-CN/skills/commands/methodology.md +4 -4
- package/bundled/locales/zh-CN/skills/commands/pr.md +1 -1
- package/bundled/locales/zh-CN/skills/commands/tdd.md +1 -1
- package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +456 -0
- package/bundled/locales/zh-CN/skills/dev-methodology/guide.md +6 -6
- package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +296 -0
- package/bundled/locales/zh-CN/skills/dev-workflow-guide/SKILL.md +5 -5
- package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/journey-test-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/logging-guide/SKILL.md +146 -142
- package/bundled/locales/zh-CN/skills/migration-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/observability-assistant/guide.md +1 -1
- package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/project-discovery/guide.md +2 -2
- package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/runbook-assistant/guide.md +1 -1
- package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/skill-builder/SKILL.md +3 -3
- package/bundled/locales/zh-CN/skills/slo-assistant/guide.md +1 -1
- package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/spec-derivation/guide.md +8 -9
- package/bundled/locales/zh-CN/skills/spec-driven-dev/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/sweep/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-CN/skills/testing-guide/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +2298 -0
- package/bundled/locales/zh-CN/skills/workflows/README.md +451 -0
- package/bundled/locales/zh-TW/CHANGELOG.md +81 -6
- package/bundled/locales/zh-TW/CLAUDE.md +1 -1
- package/bundled/locales/zh-TW/MAINTENANCE.md +25 -2
- package/bundled/locales/zh-TW/README.md +22 -9
- package/bundled/locales/zh-TW/SECURITY.md +1 -1
- package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -2
- package/bundled/locales/zh-TW/ai/standards/versioning.ai.yaml +8 -48
- package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +4 -6
- package/bundled/locales/zh-TW/core/accessibility-standards.md +1 -1
- package/bundled/locales/zh-TW/core/adversarial-test.md +226 -0
- package/bundled/locales/zh-TW/core/agent-behavior-discipline.md +187 -0
- package/bundled/locales/zh-TW/core/ai-response-navigation.md +32 -6
- package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +1 -1
- package/bundled/locales/zh-TW/core/api-design-standards.md +91 -9
- package/bundled/locales/zh-TW/core/audit-trail.md +110 -0
- package/bundled/locales/zh-TW/core/behavior-snapshot.md +335 -0
- package/bundled/locales/zh-TW/core/browser-compatibility-standards.md +1 -0
- package/bundled/locales/zh-TW/core/cd-deployment-strategies.md +135 -0
- package/bundled/locales/zh-TW/core/chaos-injection-tests.md +130 -0
- package/bundled/locales/zh-TW/core/checkin-standards.md +1 -1
- package/bundled/locales/zh-TW/core/code-review-checklist.md +1 -1
- package/bundled/locales/zh-TW/core/container-image-standards.md +93 -0
- package/bundled/locales/zh-TW/core/container-security.md +535 -0
- package/bundled/locales/zh-TW/core/cost-budget-test.md +86 -0
- package/bundled/locales/zh-TW/core/cross-flow-regression.md +1 -0
- package/bundled/locales/zh-TW/core/data-contract.md +101 -0
- package/bundled/locales/zh-TW/core/data-migration-testing.md +217 -0
- package/bundled/locales/zh-TW/core/data-pipeline.md +105 -0
- package/bundled/locales/zh-TW/core/deployment-standards.md +363 -25
- package/bundled/locales/zh-TW/core/deprecation-standards.md +17 -4
- package/bundled/locales/zh-TW/core/developer-memory.md +2 -2
- package/bundled/locales/zh-TW/core/disaster-recovery-drill.md +87 -0
- package/bundled/locales/zh-TW/core/documentation-writing-standards.md +1 -1
- package/bundled/locales/zh-TW/core/error-code-standards.md +2 -2
- package/bundled/locales/zh-TW/core/feature-manifest-standard.md +222 -0
- package/bundled/locales/zh-TW/core/flaky-test-management.md +87 -0
- package/bundled/locales/zh-TW/core/flow-based-testing.md +284 -0
- package/bundled/locales/zh-TW/core/forward-derivation-standards.md +3 -4
- package/bundled/locales/zh-TW/core/full-coverage-testing.md +250 -0
- package/bundled/locales/zh-TW/core/git-worktree.md +1 -1
- package/bundled/locales/zh-TW/core/guides/performance-guide.md +515 -0
- package/bundled/locales/zh-TW/core/guides/security-guide.md +494 -0
- package/bundled/locales/zh-TW/core/iac-design-principles.md +90 -0
- package/bundled/locales/zh-TW/core/incident-response.md +111 -0
- package/bundled/locales/zh-TW/core/license-compliance.md +129 -0
- package/bundled/locales/zh-TW/core/llm-output-validation.md +192 -0
- package/bundled/locales/zh-TW/core/logging-standards.md +208 -4
- package/bundled/locales/zh-TW/core/mock-boundary.md +161 -0
- package/bundled/locales/zh-TW/core/model-provenance.md +173 -0
- package/bundled/locales/zh-TW/core/model-selection.md +28 -5
- package/bundled/locales/zh-TW/core/mutation-testing.md +106 -0
- package/bundled/locales/zh-TW/core/no-cicd-deployment.md +219 -0
- package/bundled/locales/zh-TW/core/packaging-standards.md +76 -5
- package/bundled/locales/zh-TW/core/performance-standards.md +84 -5
- package/bundled/locales/zh-TW/core/pii-classification.md +102 -0
- package/bundled/locales/zh-TW/core/pipeline-security-gates.md +126 -0
- package/bundled/locales/zh-TW/core/policy-as-code-testing.md +203 -0
- package/bundled/locales/zh-TW/core/prd-standards.md +88 -0
- package/bundled/locales/zh-TW/core/privacy-standards.md +1 -1
- package/bundled/locales/zh-TW/core/product-metrics-standards.md +96 -0
- package/bundled/locales/zh-TW/core/project-context-memory.md +1 -1
- package/bundled/locales/zh-TW/core/prompt-regression.md +88 -0
- package/bundled/locales/zh-TW/core/property-based-testing.md +87 -0
- package/bundled/locales/zh-TW/core/refactoring-standards.md +43 -6
- package/bundled/locales/zh-TW/core/release-quality-manifest.md +207 -0
- package/bundled/locales/zh-TW/core/replay-test.md +102 -0
- package/bundled/locales/zh-TW/core/resource-cost-boundary.md +175 -0
- package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +64 -5
- package/bundled/locales/zh-TW/core/rollback-standards.md +120 -0
- package/bundled/locales/zh-TW/core/runbook.md +110 -0
- package/bundled/locales/zh-TW/core/sast-advanced.md +309 -0
- package/bundled/locales/zh-TW/core/schema-evolution.md +98 -0
- package/bundled/locales/zh-TW/core/secret-management-standards.md +101 -0
- package/bundled/locales/zh-TW/core/secure-op.md +328 -0
- package/bundled/locales/zh-TW/core/security-testing.md +96 -0
- package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -2
- package/bundled/locales/zh-TW/core/server-ops-security.md +507 -0
- package/bundled/locales/zh-TW/core/slo-sli.md +108 -0
- package/bundled/locales/zh-TW/core/smoke-test.md +79 -0
- package/bundled/locales/zh-TW/core/spec-driven-development.md +39 -13
- package/bundled/locales/zh-TW/core/supply-chain-attestation.md +131 -0
- package/bundled/locales/zh-TW/core/user-journey-testing.md +111 -0
- package/bundled/locales/zh-TW/core/user-story-mapping.md +94 -0
- package/bundled/locales/zh-TW/core/verification-oracle.md +159 -0
- package/bundled/locales/zh-TW/core/versioning.md +112 -112
- package/bundled/locales/zh-TW/docs/CHEATSHEET.md +31 -6
- package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +6 -6
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +61 -34
- package/bundled/locales/zh-TW/docs/MIGRATION-v6.md +88 -0
- package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -2
- package/bundled/locales/zh-TW/docs/USER-MANUAL.md +14 -14
- package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +105 -0
- package/bundled/locales/zh-TW/docs/user/FAQ.md +132 -0
- package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +144 -0
- package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +178 -0
- package/bundled/locales/zh-TW/docs/user/README.md +70 -0
- package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +190 -0
- package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +1 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/README.md +1 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +3 -3
- package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +3 -3
- package/bundled/locales/zh-TW/methodologies/guides/sdd-guide.md +523 -26
- package/bundled/locales/zh-TW/options/changelog/auto-generated.md +166 -0
- package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +140 -0
- package/bundled/locales/zh-TW/options/code-review/automated-review.md +214 -0
- package/bundled/locales/zh-TW/options/code-review/pair-programming.md +166 -0
- package/bundled/locales/zh-TW/options/code-review/pr-review.md +167 -0
- package/bundled/locales/zh-TW/options/documentation/api-docs.md +191 -0
- package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +150 -0
- package/bundled/locales/zh-TW/options/documentation/wiki-style.md +131 -0
- package/bundled/locales/zh-TW/options/project-structure/kotlin.md +144 -0
- package/bundled/locales/zh-TW/options/project-structure/php.md +168 -0
- package/bundled/locales/zh-TW/options/project-structure/ruby.md +156 -0
- package/bundled/locales/zh-TW/options/project-structure/rust.md +136 -0
- package/bundled/locales/zh-TW/options/project-structure/swift.md +165 -0
- package/bundled/locales/zh-TW/options/testing/contract-testing.md +237 -0
- package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +200 -0
- package/bundled/locales/zh-TW/options/testing/istqb-framework.md +144 -0
- package/bundled/locales/zh-TW/options/testing/performance-testing.md +251 -0
- package/bundled/locales/zh-TW/options/testing/security-testing.md +192 -0
- package/bundled/locales/zh-TW/skills/README.md +91 -128
- package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +4 -6
- package/bundled/locales/zh-TW/skills/adr-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/agents/code-architect.md +263 -0
- package/bundled/locales/zh-TW/skills/agents/doc-writer.md +410 -0
- package/bundled/locales/zh-TW/skills/agents/reviewer.md +357 -0
- package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +410 -0
- package/bundled/locales/zh-TW/skills/agents/test-specialist.md +368 -0
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +2 -0
- package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +1 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +3 -4
- package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +2 -0
- package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +1 -2
- package/bundled/locales/zh-TW/skills/brainstorm-assistant/SKILL.md +110 -14
- package/bundled/locales/zh-TW/skills/brainstorm-assistant/guide.md +31 -7
- package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +3 -1
- package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +50 -0
- package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +7 -5
- package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +1 -1
- package/bundled/locales/zh-TW/skills/commands/atdd.md +3 -3
- package/bundled/locales/zh-TW/skills/commands/bdd.md +2 -2
- package/bundled/locales/zh-TW/skills/commands/brainstorm.md +26 -17
- package/bundled/locales/zh-TW/skills/commands/{review.md → code-review.md} +5 -5
- package/bundled/locales/zh-TW/skills/commands/derive-all.md +1 -1
- package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +1 -1
- package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +2 -3
- package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +1 -1
- package/bundled/locales/zh-TW/skills/commands/derive.md +1 -1
- package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +2 -2
- package/bundled/locales/zh-TW/skills/commands/methodology.md +4 -4
- package/bundled/locales/zh-TW/skills/commands/pr.md +1 -1
- package/bundled/locales/zh-TW/skills/commands/tdd.md +1 -1
- package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +456 -0
- package/bundled/locales/zh-TW/skills/dev-methodology/guide.md +5 -5
- package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +296 -0
- package/bundled/locales/zh-TW/skills/dev-workflow-guide/SKILL.md +5 -5
- package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/logging-guide/SKILL.md +29 -27
- package/bundled/locales/zh-TW/skills/migration-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +3 -1
- package/bundled/locales/zh-TW/skills/project-discovery/guide.md +2 -2
- package/bundled/locales/zh-TW/skills/reverse-engineer/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/spec-derivation/guide.md +7 -8
- package/bundled/locales/zh-TW/skills/spec-driven-dev/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/sweep/SKILL.md +1 -1
- package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +3 -1
- package/bundled/locales/zh-TW/skills/testing-guide/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +2298 -0
- package/bundled/locales/zh-TW/skills/workflows/README.md +451 -0
- package/bundled/skills/README.md +1 -1
- package/bundled/skills/ac-coverage/SKILL.md +17 -7
- package/bundled/skills/adr-assistant/SKILL.md +1 -1
- package/bundled/skills/agents/code-architect.md +1 -1
- package/bundled/skills/agents/doc-writer.md +1 -1
- package/bundled/skills/agents/reviewer.md +2 -2
- package/bundled/skills/agents/spec-analyst.md +1 -1
- package/bundled/skills/agents/test-specialist.md +1 -1
- package/bundled/skills/ai-collaboration-standards/SKILL.md +2 -2
- package/bundled/skills/ai-friendly-architecture/SKILL.md +2 -2
- package/bundled/skills/ai-instruction-standards/SKILL.md +1 -1
- package/bundled/skills/atdd-assistant/SKILL.md +7 -0
- package/bundled/skills/atdd-assistant/acceptance-criteria-guide.md +1 -1
- package/bundled/skills/atdd-assistant/atdd-workflow.md +6 -8
- package/bundled/skills/audit-assistant/SKILL.md +2 -2
- package/bundled/skills/bdd-assistant/SKILL.md +7 -0
- package/bundled/skills/bdd-assistant/guide.md +1 -2
- package/bundled/skills/brainstorm-assistant/SKILL.md +133 -11
- package/bundled/skills/brainstorm-assistant/guide.md +33 -5
- package/bundled/skills/checkin-assistant/SKILL.md +8 -1
- package/bundled/skills/ci-cd-assistant/SKILL.md +57 -0
- package/bundled/skills/code-review-assistant/SKILL.md +15 -8
- package/bundled/skills/commands/COMMAND-FAMILY-OVERVIEW.md +2 -2
- package/bundled/skills/commands/COMMAND-INDEX.json +3 -3
- package/bundled/skills/commands/README.md +2 -2
- package/bundled/skills/commands/ac-coverage.md +1 -1
- package/bundled/skills/commands/atdd.md +2 -2
- package/bundled/skills/commands/bdd.md +2 -2
- package/bundled/skills/commands/brainstorm.md +25 -14
- package/bundled/skills/commands/{review.md → code-review.md} +6 -6
- package/bundled/skills/commands/derive-all.md +1 -1
- package/bundled/skills/commands/derive-atdd.md +1 -1
- package/bundled/skills/commands/derive-bdd.md +2 -3
- package/bundled/skills/commands/derive-tdd.md +1 -1
- package/bundled/skills/commands/derive.md +1 -1
- package/bundled/skills/commands/dev-workflow.md +1 -1
- package/bundled/skills/commands/journey-test.md +45 -0
- package/bundled/skills/commands/methodology.md +4 -4
- package/bundled/skills/commands/pr.md +1 -1
- package/bundled/skills/commands/skill-builder.md +42 -0
- package/bundled/skills/commands/tdd.md +1 -1
- package/bundled/skills/dev-methodology/create-methodology.md +1 -1
- package/bundled/skills/dev-methodology/guide.md +1 -1
- package/bundled/skills/dev-methodology/runtime.md +1 -1
- package/bundled/skills/dev-workflow-guide/SKILL.md +3 -3
- package/bundled/skills/dev-workflow-guide/workflow-phases.md +3 -3
- package/bundled/skills/docs-generator/SKILL.md +3 -3
- package/bundled/skills/incident-response-assistant/SKILL.md +2 -2
- package/bundled/skills/logging-guide/SKILL.md +38 -2
- package/bundled/skills/migration-assistant/SKILL.md +226 -0
- package/bundled/skills/observability-assistant/SKILL.md +74 -0
- package/bundled/skills/pr-automation-assistant/SKILL.md +5 -1
- package/bundled/skills/project-discovery/guide.md +2 -2
- package/bundled/skills/push/SKILL.md +1 -1
- package/bundled/skills/release-standards/SKILL.md +19 -5
- package/bundled/skills/security-assistant/SKILL.md +1 -1
- package/bundled/skills/skill-builder/SKILL.md +1 -1
- package/bundled/skills/spec-derivation/guide.md +3 -4
- package/bundled/skills/spec-driven-dev/SKILL.md +27 -0
- package/bundled/skills/sweep/SKILL.md +1 -1
- package/bundled/skills/tdd-assistant/SKILL.md +8 -1
- package/bundled/skills/testing-guide/SKILL.md +1 -1
- package/bundled/skills/testing-guide/testing-theory.md +1 -1
- package/bundled/skills/workflows/README.md +2 -2
- package/package.json +3 -3
- package/src/commands/audit.js +30 -9
- package/src/commands/config.js +33 -2
- package/src/commands/hitl.js +14 -1
- package/src/commands/init.js +110 -58
- package/src/commands/quickstart.js +1 -2
- package/src/commands/release.js +51 -6
- package/src/commands/run-intent.js +9 -0
- package/src/commands/spec-split.js +27 -2
- package/src/commands/update.js +22 -6
- package/src/config/ai-agent-paths.js +3 -1
- package/src/i18n/messages.js +3 -102
- package/src/missions/MissionManager.js +44 -12
- package/src/utils/build-manifest.js +35 -3
- package/src/utils/friction-detector.js +71 -22
- package/src/utils/health-checker.js +29 -2
- package/src/utils/transaction.js +111 -0
- package/src/utils/version-promote.js +16 -0
- package/standards-registry.json +58 -146
- package/bundled/ai/standards/agent-communication-protocol.ai.yaml +0 -42
- package/bundled/ai/standards/agent-dispatch.ai.yaml +0 -42
- package/bundled/ai/standards/branch-completion.ai.yaml +0 -44
- package/bundled/ai/standards/change-batching-standards.ai.yaml +0 -44
- package/bundled/ai/standards/execution-history.ai.yaml +0 -42
- package/bundled/ai/standards/pipeline-integration-standards.ai.yaml +0 -42
- package/bundled/ai/standards/workflow-enforcement.ai.yaml +0 -44
- package/bundled/ai/standards/workflow-state-protocol.ai.yaml +0 -43
- package/src/commands/flow.js +0 -260
- package/src/commands/start.js +0 -372
- package/src/commands/sweep.js +0 -151
- package/src/commands/workflow.js +0 -681
|
@@ -0,0 +1,451 @@
|
|
|
1
|
+
---
|
|
2
|
+
source: skills/workflows/README.md
|
|
3
|
+
source_version: 1.0.0
|
|
4
|
+
translation_version: 1.0.0
|
|
5
|
+
status: current
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# UDS Workflows
|
|
9
|
+
|
|
10
|
+
> **语言**: [English](../../../../skills/workflows/README.md) | 简体中文
|
|
11
|
+
|
|
12
|
+
**Version**: 1.1.0
|
|
13
|
+
**Last Updated**: 2026-01-21
|
|
14
|
+
**Status**: Experimental
|
|
15
|
+
|
|
16
|
+
---
|
|
17
|
+
|
|
18
|
+
## 概览
|
|
19
|
+
|
|
20
|
+
UDS Workflows 通过 orchestrate 多个 agent 来完成复杂的开发任务。每个 workflow 定义一连串步骤,其中每个步骤可由 agent 执行,或需要人工介入。
|
|
21
|
+
|
|
22
|
+
## Workflow YAML 格式
|
|
23
|
+
|
|
24
|
+
### Schema
|
|
25
|
+
|
|
26
|
+
```yaml
|
|
27
|
+
name: workflow-name # Unique identifier (kebab-case)
|
|
28
|
+
version: 1.0.0 # Semantic version
|
|
29
|
+
description: | # Multi-line description
|
|
30
|
+
Brief description of the workflow.
|
|
31
|
+
|
|
32
|
+
# Workflow metadata
|
|
33
|
+
metadata:
|
|
34
|
+
author: universal-dev-standards
|
|
35
|
+
category: development # development | review | testing | documentation
|
|
36
|
+
difficulty: intermediate # beginner | intermediate | advanced
|
|
37
|
+
estimated_steps: 6 # Approximate number of steps
|
|
38
|
+
|
|
39
|
+
# Prerequisites
|
|
40
|
+
prerequisites:
|
|
41
|
+
- Project initialized with UDS
|
|
42
|
+
- Git repository configured
|
|
43
|
+
- AI tool with Task support (recommended)
|
|
44
|
+
|
|
45
|
+
# Steps definition
|
|
46
|
+
steps:
|
|
47
|
+
- id: step-1
|
|
48
|
+
name: Step Name
|
|
49
|
+
description: What this step does
|
|
50
|
+
type: agent # agent | manual | conditional
|
|
51
|
+
agent: agent-name # Required if type=agent
|
|
52
|
+
inputs: # Optional: what this step needs
|
|
53
|
+
- user_requirements
|
|
54
|
+
outputs: # Optional: what this step produces
|
|
55
|
+
- analysis_report
|
|
56
|
+
|
|
57
|
+
- id: step-2
|
|
58
|
+
name: Manual Step
|
|
59
|
+
type: manual
|
|
60
|
+
description: Human intervention required
|
|
61
|
+
instructions: |
|
|
62
|
+
Detailed instructions for the manual step.
|
|
63
|
+
checklist:
|
|
64
|
+
- [ ] Item 1
|
|
65
|
+
- [ ] Item 2
|
|
66
|
+
|
|
67
|
+
- id: step-3
|
|
68
|
+
name: Conditional Step
|
|
69
|
+
type: conditional
|
|
70
|
+
condition: analysis_report.has_issues
|
|
71
|
+
then:
|
|
72
|
+
agent: reviewer
|
|
73
|
+
task: Review and fix issues
|
|
74
|
+
else:
|
|
75
|
+
skip: true
|
|
76
|
+
|
|
77
|
+
# Output artifacts
|
|
78
|
+
outputs:
|
|
79
|
+
- name: final_report
|
|
80
|
+
description: Generated documentation
|
|
81
|
+
format: markdown
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
### RLM Context 配置 (v1.1.0)
|
|
85
|
+
|
|
86
|
+
Workflow 可纳入受 RLM 启发的 context 处理机制,以应对大型代码库:
|
|
87
|
+
|
|
88
|
+
```yaml
|
|
89
|
+
# === RLM CONTEXT CONFIGURATION ===
|
|
90
|
+
context-strategy:
|
|
91
|
+
enable-rlm: true # Enable RLM-aware processing
|
|
92
|
+
max-context-per-step: 100000 # Maximum tokens per step
|
|
93
|
+
context-inheritance: selective # full | selective | summary
|
|
94
|
+
|
|
95
|
+
steps:
|
|
96
|
+
- id: parallel-analysis
|
|
97
|
+
type: parallel-agents # NEW: Execute agent on multiple inputs
|
|
98
|
+
agent: code-architect
|
|
99
|
+
foreach: ${modules} # Dynamic iteration variable
|
|
100
|
+
context-mode: focused # minimal | focused | full
|
|
101
|
+
merge-strategy: aggregate # aggregate | sequential | summary
|
|
102
|
+
outputs: [analysis_results]
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
#### Context 继承模式
|
|
106
|
+
|
|
107
|
+
| 模式 | 说明 | 使用场景 |
|
|
108
|
+
|------|-------------|----------|
|
|
109
|
+
| `full` | 将所有先前的 output 传递给下一个步骤 | 顺序分析 |
|
|
110
|
+
| `selective` | 仅传递指定的 output | 内存效率高的 pipeline |
|
|
111
|
+
| `summary` | 传递 output 的摘要版本 | 大规模处理 |
|
|
112
|
+
|
|
113
|
+
#### 步骤的 Context 模式
|
|
114
|
+
|
|
115
|
+
| 模式 | 说明 | Token 用量 |
|
|
116
|
+
|------|-------------|-------------|
|
|
117
|
+
| `minimal` | 仅必要的 context | 低 |
|
|
118
|
+
| `focused` | 与当前项目相关的 context | 中 |
|
|
119
|
+
| `full` | 完整可用的 context | 高 |
|
|
120
|
+
|
|
121
|
+
#### 并行结果的 Merge 策略
|
|
122
|
+
|
|
123
|
+
| 策略 | 说明 | Output 格式 |
|
|
124
|
+
|----------|-------------|---------------|
|
|
125
|
+
| `aggregate` | 将所有结果合并为数组 | 结果数组 |
|
|
126
|
+
| `sequential` | 维持处理顺序 | 有序列表 |
|
|
127
|
+
| `summary` | AI 生成的所有结果摘要 | 单一摘要 |
|
|
128
|
+
|
|
129
|
+
### 步骤类型
|
|
130
|
+
|
|
131
|
+
| 类型 | 说明 | 执行方式 |
|
|
132
|
+
|------|-------------|-----------|
|
|
133
|
+
| `agent` | 由 UDS agent 执行 | 自动 |
|
|
134
|
+
| `manual` | 需要人工介入 | 交互式 |
|
|
135
|
+
| `conditional` | 依条件分支 | 视条件而定 |
|
|
136
|
+
| `parallel-agents` | 对多个输入并行执行 agent | 并行 (v1.1.0) |
|
|
137
|
+
|
|
138
|
+
#### Parallel-Agents 步骤配置 (v1.1.0)
|
|
139
|
+
|
|
140
|
+
```yaml
|
|
141
|
+
- id: parallel-module-analysis
|
|
142
|
+
name: Analyze Modules in Parallel
|
|
143
|
+
type: parallel-agents
|
|
144
|
+
agent: code-architect
|
|
145
|
+
foreach: ${modules} # Variable containing items to iterate
|
|
146
|
+
context-mode: focused # minimal | focused | full
|
|
147
|
+
merge-strategy: aggregate # How to combine results
|
|
148
|
+
max-concurrent: 3 # Optional: limit concurrent executions
|
|
149
|
+
timeout: 300 # Optional: timeout per item (seconds)
|
|
150
|
+
inputs: # Optional: additional inputs
|
|
151
|
+
- project_context
|
|
152
|
+
outputs:
|
|
153
|
+
- module_analysis_results
|
|
154
|
+
```
|
|
155
|
+
|
|
156
|
+
## 内置 Workflows
|
|
157
|
+
|
|
158
|
+
| Workflow | 步骤数 | 说明 |
|
|
159
|
+
|----------|-------|-------------|
|
|
160
|
+
| [integrated-flow](../../../../skills/workflows/integrated-flow.workflow.yaml) | 8 | 完整的 ATDD → SDD → BDD → TDD 循环 |
|
|
161
|
+
| [feature-dev](../../../../skills/workflows/feature-dev.workflow.yaml) | 6 | 功能开发 workflow |
|
|
162
|
+
| [code-review](../../../../skills/workflows/code-review.workflow.yaml) | 4 | 全面性 code review workflow |
|
|
163
|
+
| [large-codebase-analysis](../../../../skills/workflows/large-codebase-analysis.workflow.yaml) | 4 | 针对 50+ 文件项目的 RLM 强化 workflow |
|
|
164
|
+
|
|
165
|
+
## 用法
|
|
166
|
+
|
|
167
|
+
### CLI 安装
|
|
168
|
+
|
|
169
|
+
```bash
|
|
170
|
+
# List available workflows
|
|
171
|
+
uds workflow list
|
|
172
|
+
|
|
173
|
+
# Install specific workflow
|
|
174
|
+
uds workflow install integrated-flow
|
|
175
|
+
|
|
176
|
+
# Install all workflows
|
|
177
|
+
uds workflow install --all
|
|
178
|
+
```
|
|
179
|
+
|
|
180
|
+
### 执行
|
|
181
|
+
|
|
182
|
+
Workflow 采逐步执行。对于支持 Task tool 的工具(Claude Code、OpenCode):
|
|
183
|
+
|
|
184
|
+
```
|
|
185
|
+
User: Start the integrated-flow workflow for user authentication
|
|
186
|
+
|
|
187
|
+
AI: Starting Integrated Development Flow...
|
|
188
|
+
|
|
189
|
+
Step 1/8: Specification Workshop (spec-analyst)
|
|
190
|
+
[Agent executes analysis...]
|
|
191
|
+
|
|
192
|
+
Step 2/8: Spec Proposal (spec-analyst)
|
|
193
|
+
[Agent drafts proposal...]
|
|
194
|
+
|
|
195
|
+
Step 3/8: Spec Review (manual)
|
|
196
|
+
Please review the specification:
|
|
197
|
+
- [ ] Requirements are clear
|
|
198
|
+
- [ ] Acceptance criteria defined
|
|
199
|
+
- [ ] Risks identified
|
|
200
|
+
|
|
201
|
+
[User confirms...]
|
|
202
|
+
|
|
203
|
+
Step 4/8: Discovery (test-specialist)
|
|
204
|
+
[Agent identifies test scenarios...]
|
|
205
|
+
|
|
206
|
+
...continues...
|
|
207
|
+
```
|
|
208
|
+
|
|
209
|
+
### 不支持 Task 的工具
|
|
210
|
+
|
|
211
|
+
Workflow 会转换为引导式检查清单:
|
|
212
|
+
|
|
213
|
+
```markdown
|
|
214
|
+
## Integrated Development Flow
|
|
215
|
+
|
|
216
|
+
### Step 1: Specification Workshop
|
|
217
|
+
**Agent**: spec-analyst
|
|
218
|
+
**Task**: Analyze requirements and identify acceptance criteria
|
|
219
|
+
|
|
220
|
+
[Copy this to your AI assistant]
|
|
221
|
+
|
|
222
|
+
### Step 2: Spec Proposal
|
|
223
|
+
...
|
|
224
|
+
```
|
|
225
|
+
|
|
226
|
+
## 创建自定义 Workflow
|
|
227
|
+
|
|
228
|
+
### 1. 创建 Workflow 文件
|
|
229
|
+
|
|
230
|
+
```bash
|
|
231
|
+
mkdir -p .claude/workflows
|
|
232
|
+
touch .claude/workflows/my-workflow.workflow.yaml
|
|
233
|
+
```
|
|
234
|
+
|
|
235
|
+
### 2. 定义 Workflow
|
|
236
|
+
|
|
237
|
+
```yaml
|
|
238
|
+
name: my-custom-workflow
|
|
239
|
+
version: 1.0.0
|
|
240
|
+
description: Custom workflow for my project
|
|
241
|
+
|
|
242
|
+
steps:
|
|
243
|
+
- id: analyze
|
|
244
|
+
name: Analyze Requirements
|
|
245
|
+
type: agent
|
|
246
|
+
agent: spec-analyst
|
|
247
|
+
outputs: [requirements_doc]
|
|
248
|
+
|
|
249
|
+
- id: implement
|
|
250
|
+
name: Implementation
|
|
251
|
+
type: manual
|
|
252
|
+
description: Implement based on analysis
|
|
253
|
+
|
|
254
|
+
- id: review
|
|
255
|
+
name: Code Review
|
|
256
|
+
type: agent
|
|
257
|
+
agent: reviewer
|
|
258
|
+
inputs: [code_changes]
|
|
259
|
+
```
|
|
260
|
+
|
|
261
|
+
## Workflow vs Agent vs Skill
|
|
262
|
+
|
|
263
|
+
| 维度 | Workflow | Agent | Skill |
|
|
264
|
+
|--------|----------|-------|-------|
|
|
265
|
+
| **目的** | orchestrate 多步骤流程 | 执行自主任务 | 提供知识/context |
|
|
266
|
+
| **组成** | 包含多个 agent | 使用 skill 作为 context | 独立运作 |
|
|
267
|
+
| **状态** | 追踪跨步骤的进度 | 单一任务状态 | 无状态 |
|
|
268
|
+
| **用户参与** | 可包含人工步骤 | 最少 | 无 |
|
|
269
|
+
|
|
270
|
+
## 以 Wave 为基础的并行执行 (v1.2.0)
|
|
271
|
+
|
|
272
|
+
Workflow 中的步骤可分组为 **wave** 以进行并行执行。同一 wave 中的步骤彼此独立,可由不同的 sub-agent 并行执行。Wave 之间顺序执行——wave N 中的所有步骤都必须完成,wave N+1 才会开始。
|
|
273
|
+
|
|
274
|
+
### Wave 配置
|
|
275
|
+
|
|
276
|
+
```yaml
|
|
277
|
+
steps:
|
|
278
|
+
# Wave 1: Independent analysis steps (run in parallel)
|
|
279
|
+
- id: analyze-requirements
|
|
280
|
+
name: Analyze Requirements
|
|
281
|
+
type: agent
|
|
282
|
+
agent: spec-analyst
|
|
283
|
+
wave: 1
|
|
284
|
+
outputs: [requirements_analysis]
|
|
285
|
+
|
|
286
|
+
- id: analyze-architecture
|
|
287
|
+
name: Analyze Architecture
|
|
288
|
+
type: agent
|
|
289
|
+
agent: code-architect
|
|
290
|
+
wave: 1
|
|
291
|
+
outputs: [architecture_analysis]
|
|
292
|
+
|
|
293
|
+
# Wave 2: Depends on wave 1 outputs (barrier point)
|
|
294
|
+
- id: design
|
|
295
|
+
name: Design Solution
|
|
296
|
+
type: agent
|
|
297
|
+
agent: code-architect
|
|
298
|
+
wave: 2
|
|
299
|
+
inputs: [requirements_analysis, architecture_analysis]
|
|
300
|
+
outputs: [design_doc]
|
|
301
|
+
|
|
302
|
+
# Manual steps are automatic barrier points
|
|
303
|
+
- id: review
|
|
304
|
+
name: Review Design
|
|
305
|
+
type: manual
|
|
306
|
+
wave: 3
|
|
307
|
+
```
|
|
308
|
+
|
|
309
|
+
### Wave 规则
|
|
310
|
+
|
|
311
|
+
| 规则 | 说明 |
|
|
312
|
+
|------|-------------|
|
|
313
|
+
| **独立性** | 同一 wave 中的步骤不得彼此相依 |
|
|
314
|
+
| **Barrier** | wave N 中的所有步骤必须完成,wave N+1 才会开始 |
|
|
315
|
+
| **Manual barrier** | `manual` 类型步骤为自动 barrier 点 |
|
|
316
|
+
| **选填字段** | `wave` 字段为选填;若未指定,步骤将顺序执行 |
|
|
317
|
+
| **向后兼容** | 没有 wave 字段的 workflow 仍如以往运作 |
|
|
318
|
+
|
|
319
|
+
---
|
|
320
|
+
|
|
321
|
+
## 步骤验证 Pipeline (v1.2.0)
|
|
322
|
+
|
|
323
|
+
每个 workflow 步骤可包含两层验证,灵感来自 CrewAI 的验证 pipeline 与 DSPy 的 metric 函数。
|
|
324
|
+
|
|
325
|
+
### 两层验证
|
|
326
|
+
|
|
327
|
+
```yaml
|
|
328
|
+
steps:
|
|
329
|
+
- id: generate-spec
|
|
330
|
+
name: Generate Specification
|
|
331
|
+
type: agent
|
|
332
|
+
agent: spec-analyst
|
|
333
|
+
outputs: [spec_document]
|
|
334
|
+
validation:
|
|
335
|
+
# Layer 1: Deterministic (always runs first)
|
|
336
|
+
deterministic:
|
|
337
|
+
- check: file_exists
|
|
338
|
+
path: "docs/specs/{{spec_id}}.md"
|
|
339
|
+
- check: contains_sections
|
|
340
|
+
sections: [Summary, Motivation, "Acceptance Criteria"]
|
|
341
|
+
- check: ac_format
|
|
342
|
+
pattern: "Given .+, When .+, Then .+"
|
|
343
|
+
|
|
344
|
+
# Layer 2: Semantic (only runs if Layer 1 passes)
|
|
345
|
+
semantic:
|
|
346
|
+
- check: consistency
|
|
347
|
+
description: AC covers all requirements mentioned in Motivation
|
|
348
|
+
- check: completeness
|
|
349
|
+
description: No TODO or placeholder sections remain
|
|
350
|
+
```
|
|
351
|
+
|
|
352
|
+
### 验证规则
|
|
353
|
+
|
|
354
|
+
| Layer | 类型 | 执行时机 | 失败时 |
|
|
355
|
+
|-------|------|-------------|------------|
|
|
356
|
+
| **Layer 1** | Deterministic | 永远最先执行 | 立即停止,显示修正选项 |
|
|
357
|
+
| **Layer 2** | Semantic | Layer 1 通过后 | 警告,建议改善 |
|
|
358
|
+
|
|
359
|
+
**Fail-fast 原则**:若 deterministic 验证失败,semantic 检查将完全跳过。这可避免在根本上已损坏的 output 上浪费时间进行质量评估。
|
|
360
|
+
|
|
361
|
+
---
|
|
362
|
+
|
|
363
|
+
## Agent Communication Protocol (v1.2.0)
|
|
364
|
+
|
|
365
|
+
定义 agent 在 workflow 内如何交换数据。
|
|
366
|
+
|
|
367
|
+
### 三个通信层
|
|
368
|
+
|
|
369
|
+
| Layer | 机制 | 说明 |
|
|
370
|
+
|-------|-----------|-------------|
|
|
371
|
+
| **Artifact passing** | 以文件为基础 | 步骤产生文件作为 output;下游步骤通过文件路径读取 |
|
|
372
|
+
| **Reducer patterns** | append / replace / merge | 多个 output 如何合并 |
|
|
373
|
+
| **Context isolation** | 每步骤干净启动 | 每个 agent 步骤以干净 context 启动,仅接收指定的 input |
|
|
374
|
+
|
|
375
|
+
### Reducer 模式
|
|
376
|
+
|
|
377
|
+
```yaml
|
|
378
|
+
steps:
|
|
379
|
+
- id: collect-reviews
|
|
380
|
+
type: parallel-agents
|
|
381
|
+
agent: reviewer
|
|
382
|
+
foreach: ${modules}
|
|
383
|
+
outputs: [review_results]
|
|
384
|
+
reducer: append # Collect all results into array
|
|
385
|
+
|
|
386
|
+
- id: merge-configs
|
|
387
|
+
type: agent
|
|
388
|
+
agent: code-architect
|
|
389
|
+
inputs: [review_results]
|
|
390
|
+
reducer: merge # Deep merge results into single object
|
|
391
|
+
```
|
|
392
|
+
|
|
393
|
+
| 模式 | 说明 | 使用场景 |
|
|
394
|
+
|---------|-------------|----------|
|
|
395
|
+
| `append` | 将所有结果收集为有序列表 | 并行 review、多模块分析 |
|
|
396
|
+
| `replace` | 后到的 output 覆写先前的 | Config 覆写、最新者胜 |
|
|
397
|
+
| `merge` | 将结果深度合并为单一对象 | 结合部分分析 |
|
|
398
|
+
|
|
399
|
+
### Context Isolation
|
|
400
|
+
|
|
401
|
+
每个 agent 步骤以**干净 context** 启动,仅包含:
|
|
402
|
+
1. 该步骤声明的 `inputs`(来自前一步骤的 output)
|
|
403
|
+
2. 该 agent 的 skill(来自 AGENT.md 的 `skills` 字段)
|
|
404
|
+
3. Workflow 共享的 `prerequisites`
|
|
405
|
+
|
|
406
|
+
这可防止 context 污染,并确保 agent 行为可重现。
|
|
407
|
+
|
|
408
|
+
---
|
|
409
|
+
|
|
410
|
+
## 最佳实践
|
|
411
|
+
|
|
412
|
+
### 该做的
|
|
413
|
+
|
|
414
|
+
- 将复杂任务拆解为离散步骤
|
|
415
|
+
- 为关键决策纳入人工检查点
|
|
416
|
+
- 为每个步骤定义清楚的 input/output
|
|
417
|
+
- 使用 conditional 步骤进行错误处理
|
|
418
|
+
- 清楚记录 prerequisites
|
|
419
|
+
|
|
420
|
+
### 不该做的
|
|
421
|
+
|
|
422
|
+
- 不要创建过长的 workflow(>10 步骤)
|
|
423
|
+
- 不要跳过 review/verification 步骤
|
|
424
|
+
- 不要假设所有工具都支持自动执行
|
|
425
|
+
- 不要把步骤切得太细
|
|
426
|
+
|
|
427
|
+
---
|
|
428
|
+
|
|
429
|
+
## 相关资源
|
|
430
|
+
|
|
431
|
+
- [Agents 文档](../agents/README.md)
|
|
432
|
+
- [Skills 文档](../README.md)
|
|
433
|
+
- [方法论系统](../dev-methodology/SKILL.md)
|
|
434
|
+
|
|
435
|
+
---
|
|
436
|
+
|
|
437
|
+
## 版本历史
|
|
438
|
+
|
|
439
|
+
| Version | Date | Changes |
|
|
440
|
+
|---------|------|---------|
|
|
441
|
+
| 1.2.0 | 2026-03-17 | Added wave-based parallel execution, step validation pipeline, agent communication protocol |
|
|
442
|
+
| 1.1.0 | 2026-01-21 | Added RLM context configuration, parallel-agents step type, large-codebase-analysis workflow |
|
|
443
|
+
| 1.0.0 | 2026-01-20 | Initial release |
|
|
444
|
+
|
|
445
|
+
---
|
|
446
|
+
|
|
447
|
+
## License
|
|
448
|
+
|
|
449
|
+
本文档以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 释出。
|
|
450
|
+
|
|
451
|
+
**来源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../CHANGELOG.md
|
|
3
|
-
source_version:
|
|
4
|
-
translation_version:
|
|
5
|
-
last_synced: 2026-06
|
|
3
|
+
source_version: 6.0.0
|
|
4
|
+
translation_version: 6.0.0
|
|
5
|
+
last_synced: 2026-07-06
|
|
6
6
|
status: current
|
|
7
7
|
---
|
|
8
8
|
|
|
@@ -17,6 +17,81 @@ status: current
|
|
|
17
17
|
|
|
18
18
|
## [Unreleased]
|
|
19
19
|
|
|
20
|
+
## [6.0.0] - 2026-07-06
|
|
21
|
+
|
|
22
|
+
> ⚠️ **重大版本(Major release)。** 包含一項 breaking 更名,並移除 8 個已棄用的機器可讀標準與 4 個已棄用的 CLI 命令(皆自 5.4.0 起帶有「將於 6.0.0 移除」告示)。**請參閱 [v6 遷移指南](docs/MIGRATION-v6.md)**([English](../../docs/MIGRATION-v6.md) | [简体中文](../zh-CN/docs/MIGRATION-v6.md))。
|
|
23
|
+
|
|
24
|
+
### 變更 — BREAKING
|
|
25
|
+
|
|
26
|
+
- **`review` 命令/skill 更名為 `code-review`**(T1)。`/review` 的呼叫端必須遷移至 `/code-review`;flow-id `review-flow` → `code-review-flow`。見遷移指南 §1。
|
|
27
|
+
|
|
28
|
+
### 移除 — BREAKING(自 5.4.0 起排定)
|
|
29
|
+
|
|
30
|
+
- **移除 8 個已棄用的 `.ai.yaml` 標準 stub**(runtime 已依 XSPEC-086/095 / DEC-049 於 5.4.0 移至 adoption layer):`agent-communication-protocol`、`agent-dispatch`、`branch-completion`、`change-batching-standards`、`execution-history`、`pipeline-integration-standards`、`workflow-enforcement`、`workflow-state-protocol`。人類可讀的 `core/*.md` 文件保留作為參考(現列於 registry-check 的 REFERENCE_ONLY 清單);registry 條目已移除。見遷移指南 §2。
|
|
31
|
+
- **移除 4 個已棄用的 CLI 命令**:`uds start` / `uds mission:*`、`uds workflow:*`、`uds flow:*`、`uds sweep`(orchestration 屬 adoption layer 職責;`/sweep` skill 取代 `uds sweep`)。並清理引用已移除命令的死 i18n 鍵與過時的 in-CLI 提示(`config` next-steps、`quickstart` recipes)。見遷移指南 §3。
|
|
32
|
+
|
|
33
|
+
### 新增 — 新標準(coverage-roadmap waves + 旗艦標準)
|
|
34
|
+
|
|
35
|
+
- **領域與生命週期標準補齊**:product — `prd-standards`、`product-metrics`、`user-story-mapping`(XSPEC-069);infra — `container-image`、`secret-management`、`iac-design`(XSPEC-065);SRE — `incident-response`、`slo-sli`、`runbook`(XSPEC-063);data engineering — `data-pipeline`、`schema-evolution`、`data-contract`(XSPEC-068);compliance — `audit-trail`、`pii-classification`(XSPEC-066)。
|
|
36
|
+
- **旗艦標準**:`verification-oracle`(XSPEC-256)、`model-provenance`(XSPEC-255)、`resource-cost-boundary`(XSPEC-277)。
|
|
37
|
+
- **`user-journey-testing`** 以一級標準(first-class standard)身分發布(ai/standards + core + zh-TW + registry)。
|
|
38
|
+
- **`logging-standards` 強制事件目錄(mandatory events catalog)**(XSPEC-234)。
|
|
39
|
+
|
|
40
|
+
### 新增 — UDS Stage 2 硬化(T5–T16)
|
|
41
|
+
|
|
42
|
+
- **Canonical AC 註記**(T5):涵蓋 `acceptance-criteria-traceability` 與 worked examples。
|
|
43
|
+
- **附出處的量化門檻**(T8):`browser-compatibility` 95%/90% gate、`checkin` code-smell、`accessibility` session-timeout、`code-review` PR 大小/回應時間 + 大量變更例外、`project-context-memory` 7 天陳舊度、`developer-memory` 退役、`privacy` DPIA「large scale」。
|
|
44
|
+
- **Failure Handling 章節**(T7):`git-worktree` 暫時性失敗重試、`reverse-engineering` 升級(escalation)、`forward-derivation` 復原。
|
|
45
|
+
- **跨職能交接**(T16):`security-testing` finding-remediation 生命週期、`pii-classification` 發現與交接契約。
|
|
46
|
+
- **Glossary 術語正規化**:作為 canonical 真實來源(T6)。
|
|
47
|
+
- **CLI 硬化**(T11/T12):Mission `FAILED` 終止狀態 + resume 防護、具 rollback 的 transactional `init`、`hitl`/`run`/`release`/config 的輸入驗證。
|
|
48
|
+
|
|
49
|
+
### 新增 — 遷移與重構完整性家族
|
|
50
|
+
|
|
51
|
+
- `migration-assistant` 切換後(post-cutover)資料對帳(XSPEC-284 P0)、狀態機與時序對等(XSPEC-287);`full-coverage-testing` 遷移錯誤路徑完整性(XSPEC-288);`performance-standards` 遷移非功能對等(XSPEC-286)。
|
|
52
|
+
|
|
53
|
+
### 新增 — 工具與工作流程
|
|
54
|
+
|
|
55
|
+
- **`/brainstorm` v4 的 BQS v1 品質契約**(XSPEC-296)。
|
|
56
|
+
- **`ci-cd-assistant` skill 新增 CI Job Orchestration Patterns** — trigger 分離、共用資源序列化、change-detection gating、advisory vs gating、`npm ci` `EUSAGE` 疑難排解(UDS #126 / XSPEC-300)。
|
|
57
|
+
- **`pipeline-security-gates` 新增部署前 attestation 驗證閘門**。
|
|
58
|
+
- **release 流程新增發版前 issue/PR triage 閘門**(XSPEC-265)。
|
|
59
|
+
- `release verify` 現在使用已記錄的 manifest checksum。
|
|
60
|
+
- `/journey-test` 與 `/skill-builder` 註冊為正式命令。
|
|
61
|
+
- 可選的 model-tier 註記(R6,XSPEC-270 Work Package A)。
|
|
62
|
+
- `sync-standard` 四層同步工具;Phase 2 內容覆蓋稽核 metadata。
|
|
63
|
+
|
|
64
|
+
### 新增 — 事故驅動的防漂移與可測試性
|
|
65
|
+
|
|
66
|
+
- **`refactoring-standards` Semantic Duplication 與 Copy-Drift**(#142):命名 Copy-Drift 反模式(同一領域事實在多處重複實作,或儲存的衍生彙總值與其來源之間沒有強制綁定——文字型重複度量測不到),以及 Single-Source-of-Truth / Derive-Don't-Duplicate 對策(每個事實一個單元、以推導取代儲存、儲存的彙總值在單一收斂點重算、以 golden + architecture 測試鎖住),另加遷移用的 Intentional-Divergence Registry。
|
|
67
|
+
- **`mock-boundary` 可注入的背景執行**(#143):將 in-process fire-and-forget 工作(`Task.Run`、未 await 的 promise、`setTimeout`、goroutine、executor)視為如同時鐘般的可注入接縫——production 保留真實 fire-and-forget,測試 dispatcher 則 inline 執行並追蹤 task 以達成確定性完成;新增 Poll/Sleep-for-Background-Result 反模式與 no-poll/sleep 規則。
|
|
68
|
+
|
|
69
|
+
### 變更
|
|
70
|
+
|
|
71
|
+
- **API versioning 與 deprecation 整併為單一真實來源** — producer 端的 API-versioning 內容併入 `api-design-standards`;不一致的 deprecation 時程已調和(XSPEC-298 R8)。
|
|
72
|
+
- **`versioning` 新增 Deployment Version Identity 章節**,含 build-metadata 判別符(discriminator)注意事項(XSPEC-298 R1)。
|
|
73
|
+
- **`versioning` 建置身分與多語言 versioning**(XSPEC-298 R2/R3):.NET/JVM/多語言專案的 git-height 推導 versioning(MinVer / Nerdbank.GitVersioning / GitVersion);建置身分升級為需求——已部署服務 MUST 經由 `/version`|`/health` 揭露 `version + commit sha + build time`,且 Phase-5 驗證 MUST 斷言 sha 與已部署 artifact 相符(#138)。
|
|
74
|
+
|
|
75
|
+
### 棄用
|
|
76
|
+
|
|
77
|
+
- **6 個 workflow skill** 標記為 `reference` 並附可見的棄用告示;已棄用的 runtime 命令加上結構化 `@superseded-by` 指標(XSPEC-291 §4)。
|
|
78
|
+
|
|
79
|
+
### 修正
|
|
80
|
+
|
|
81
|
+
- **`uds audit` 假陽性**:`options/` 檔案被誤報 missing(health check 現在會遞迴進子目錄)、CP950 主控台亂碼、非 TTY 崩潰(#115);unused-standard 偵測改以 canonical id 而非檔名比對(#125)。
|
|
82
|
+
- **Bundle ⇄ source 對等已恢復** — 25 個標準已同步進 `.standards/` self-adoption tree。
|
|
83
|
+
- 多項 docs/i18n 完整性修正:過時的標準/skill/命令數量、壞掉的 locale 交叉連結、command/skill 索引重新產生、anchor-slugger 與 table-parity 路徑。
|
|
84
|
+
|
|
85
|
+
## [5.17.0] - 2026-06-08
|
|
86
|
+
|
|
87
|
+
### 新增 — 可執行 SDD 一致性與 AC 格式擴充(XSPEC-262/263/264)
|
|
88
|
+
|
|
89
|
+
- **`/sdd analyze` 跨 artifact 一致性(XSPEC-262,`scripts/sdd-analyze.ts`)**:acceptance-criteria-traceability + forward-derivation single-spine 的可執行面。7 類信號——孤兒測試/未覆蓋/not_implemented/跨 spec AC 衝突/孤兒 .feature/AC 無 scenario/手冊↔E2E drift(`T-NNN`,實現 XSPEC-260 R5)。`npm run sdd:analyze`;12 bats 測試。
|
|
90
|
+
- **EARS 記法作為可選 AC 格式(XSPEC-263)**:spec-driven-development v2.3.0 加 5 種 EARS 模板;schema 加可選 `ears` 欄位(given/when/then 由 required 放寬、向後相容)。GWT 維持預設首選。
|
|
91
|
+
- **結構化 Bugfix 規格模板(XSPEC-264)**:sdd-guide 決策樹細分 trivial vs regression-prone,新增輕量 `<BUG-ID>.bugfix.md` 模板(current/expected/**unchanged** + root-cause + regression-test 當 AC)。
|
|
92
|
+
|
|
93
|
+
> 註:Bugfix 模板的 sdd-guide locale(zh-TW/zh-CN)同步交 XSPEC-248 迴路(既有 locale drift)。
|
|
94
|
+
|
|
20
95
|
## [5.16.0] - 2026-06-08
|
|
21
96
|
|
|
22
97
|
### 新增 — 測試推導鏈延伸至使用者指南(XSPEC-260)
|
|
@@ -484,9 +559,9 @@ status: current
|
|
|
484
559
|
- `docs/CLI-INIT-OPTIONS.md`
|
|
485
560
|
- `skills/commands/bdd.md`
|
|
486
561
|
- `skills/commands/methodology.md`
|
|
487
|
-
- `skills/methodology
|
|
488
|
-
- `skills/methodology
|
|
489
|
-
- `skills/methodology
|
|
562
|
+
- `skills/dev-methodology/SKILL.md`
|
|
563
|
+
- `skills/dev-methodology/create-methodology.md`
|
|
564
|
+
- `skills/dev-methodology/runtime.md`
|
|
490
565
|
- **文件**:更新穩定版本參考從 3.3.0 至 3.4.2
|
|
491
566
|
|
|
492
567
|
## [3.5.0-beta.10] - 2026-01-12
|
|
@@ -14,7 +14,7 @@ status: current
|
|
|
14
14
|
|
|
15
15
|
Universal Development Standards 是一個語言無關、框架無關的文件化標準框架。它提供:
|
|
16
16
|
|
|
17
|
-
- **核心規範** (`core/`):
|
|
17
|
+
- **核心規範** (`core/`):145 個基礎開發標準
|
|
18
18
|
- **AI 技能** (`skills/`):用於 AI 輔助開發的 Claude Code 技能
|
|
19
19
|
- **CLI 工具** (`cli/`):用於採用標準的 Node.js CLI
|
|
20
20
|
- **整合** (`integrations/`):各種 AI 工具的配置
|
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
source: ../../MAINTENANCE.md
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
|
-
last_synced: 2026-
|
|
5
|
+
last_synced: 2026-06-10
|
|
6
|
+
source_hash: ec4410b9245b
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
@@ -20,4 +21,26 @@ status: current
|
|
|
20
21
|
|
|
21
22
|
日常維護請遵循 `CLAUDE.md` 中的驗證步驟(§Post-Modification Verification)。
|
|
22
23
|
|
|
23
|
-
-
|
|
24
|
+
- 歸檔版本 v1.1.0 — 原始獨立指南(歷史檔案已移除)
|
|
25
|
+
|
|
26
|
+
## Bundle-Source 一致性(XSPEC-072 / DEC-045)
|
|
27
|
+
|
|
28
|
+
每次發行前,請確認 bundle 一致性檢查通過:
|
|
29
|
+
|
|
30
|
+
```bash
|
|
31
|
+
cd cli
|
|
32
|
+
npm run prepack # 從 ai/ 重新產生 cli/bundled/
|
|
33
|
+
npm run check:bundle-parity # 必須以 exit 0 結束(source == bundled,扣除排除項)
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
若一致性檢查失敗:
|
|
37
|
+
1. **`.standards/` 中的新檔案不在 `ai/`** → 複製至 `ai/standards/`(若供採用者使用),或加入 `cli/scripts/bundle-exclude.json`(若僅供 UDS 內部使用)
|
|
38
|
+
2. **`ai/` 中的新檔案不在 `.standards/`** → 複製至 `.standards/`
|
|
39
|
+
3. **新選項檔案** → 確保同時存在於 `ai/options/<cat>/` 與 `.standards/options/<cat>/`
|
|
40
|
+
|
|
41
|
+
`scripts/bump-version.sh` 目前**不會**自動執行一致性檢查 — 請在標記版本前手動執行。GHA 工作流程 `bundle-parity.yml` 會在 PR 和推送至 `main` 時發生任何不符時強制失敗。
|
|
42
|
+
|
|
43
|
+
## 翻譯版本
|
|
44
|
+
|
|
45
|
+
- [繁體中文](./MAINTENANCE.md)
|
|
46
|
+
- [简体中文](../zh-CN/MAINTENANCE.md)
|
|
@@ -1,8 +1,9 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../README.md
|
|
3
|
-
source_version: 5.
|
|
4
|
-
translation_version: 5.
|
|
5
|
-
last_synced: 2026-
|
|
3
|
+
source_version: 5.17.0
|
|
4
|
+
translation_version: 5.17.0
|
|
5
|
+
last_synced: 2026-06-10
|
|
6
|
+
source_hash: 651c07df0abe
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
@@ -14,7 +15,7 @@ status: current
|
|
|
14
15
|
|
|
15
16
|
> **語言**: [English](../../README.md) | 繁體中文 | [简体中文](../zh-CN/README.md)
|
|
16
17
|
|
|
17
|
-
**版本**:
|
|
18
|
+
**版本**: 6.0.0 | **發布日期**: 2026-07-06 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
|
|
18
19
|
|
|
19
20
|
語言無關、框架無關的軟體專案文件標準。透過 AI 原生工作流,確保不同技術堆疊之間的一致性、品質和可維護性。
|
|
20
21
|
|
|
@@ -56,6 +57,18 @@ npx universal-dev-standards init
|
|
|
56
57
|
>
|
|
57
58
|
> 另請參閱:[每日開發工作流程指南](adoption/DAILY-WORKFLOW-GUIDE.md)
|
|
58
59
|
|
|
60
|
+
### 📚 文件
|
|
61
|
+
|
|
62
|
+
| 我想要... | 文件 |
|
|
63
|
+
|---|---|
|
|
64
|
+
| **UDS 新手?** 5 分鐘快速入門 | [docs/user/GETTING-STARTED.md](../../docs/user/GETTING-STARTED.md) |
|
|
65
|
+
| 依 Tier 和分類瀏覽所有 54 個 Skills | [docs/user/SKILLS-INDEX.md](../../docs/user/SKILLS-INDEX.md) |
|
|
66
|
+
| 查看所有斜線命令 | [docs/user/COMMANDS-INDEX.md](../../docs/user/COMMANDS-INDEX.md) |
|
|
67
|
+
| 快速參考卡 | [docs/user/CHEATSHEET.md](../../docs/user/CHEATSHEET.md) |
|
|
68
|
+
| 常見問題 | [docs/user/FAQ.md](../../docs/user/FAQ.md) |
|
|
69
|
+
| 疑難排解 | [docs/user/TROUBLESHOOTING.md](../../docs/user/TROUBLESHOOTING.md) |
|
|
70
|
+
| 了解 UDS 術語 | [docs/user/GLOSSARY.md](../../docs/user/GLOSSARY.md) |
|
|
71
|
+
|
|
59
72
|
---
|
|
60
73
|
|
|
61
74
|
## ✨ 功能特色
|
|
@@ -63,9 +76,9 @@ npx universal-dev-standards init
|
|
|
63
76
|
<!-- UDS_STATS_TABLE_START -->
|
|
64
77
|
| 類別 | 數量 | 說明 |
|
|
65
78
|
|----------|-------|-------------|
|
|
66
|
-
| **核心標準** |
|
|
67
|
-
| **AI Skills** |
|
|
68
|
-
| **斜線命令** |
|
|
79
|
+
| **核心標準** | 146 | 通用開發準則 |
|
|
80
|
+
| **AI Skills** | 55 | 互動式技能 |
|
|
81
|
+
| **斜線命令** | 51 | 快速操作 |
|
|
69
82
|
| **CLI 指令** | 6 | list, init, configure, check, update, skills |
|
|
70
83
|
<!-- UDS_STATS_TABLE_END -->
|
|
71
84
|
|
|
@@ -141,10 +154,10 @@ uds uninstall # 從專案移除標準
|
|
|
141
154
|
|
|
142
155
|
使用 `uds config` 管理您的偏好設定:
|
|
143
156
|
|
|
144
|
-
| 參數 |
|
|
157
|
+
| 參數 | 指令 | 說明 |
|
|
145
158
|
| :--- | :--- | :--- |
|
|
146
159
|
| **提交語言** | `uds config --lang zh-TW` | 設定 AI 提交訊息的偏好語言 |
|
|
147
|
-
|
|
|
160
|
+
| **標準** | `uds init` | 安裝所有可用標準 |
|
|
148
161
|
| **工具模式** | `uds config --mode skills` | 在 Skills、Standards 或兩者之間切換 |
|
|
149
162
|
|
|
150
163
|
---
|