universal-dev-standards 6.13.1 → 6.14.0-beta.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +13 -3
- package/bin/uds.js +75 -3
- package/bundled/ai/options/code-review/pr-review.ai.yaml +20 -1
- package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
- package/bundled/ai/standards/ai-response-navigation.ai.yaml +43 -3
- package/bundled/ai/standards/checkin-standards.ai.yaml +25 -6
- package/bundled/ai/standards/code-review.ai.yaml +15 -2
- package/bundled/ai/standards/commit-message.ai.yaml +18 -4
- package/bundled/ai/standards/developer-memory.ai.yaml +12 -2
- package/bundled/ai/standards/full-coverage-testing.ai.yaml +86 -7
- package/bundled/ai/standards/open-work-tracking.ai.yaml +254 -4
- package/bundled/ai/standards/pipeline-security-gates.ai.yaml +53 -4
- package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
- package/bundled/ai/standards/turn-completion-integrity.ai.yaml +14 -7
- package/bundled/core/ai-response-navigation.md +128 -12
- package/bundled/core/code-review-checklist.md +20 -2
- package/bundled/core/commit-message-guide.md +22 -19
- package/bundled/core/developer-memory.md +12 -2
- package/bundled/core/full-coverage-testing.md +99 -5
- package/bundled/core/open-work-tracking.md +251 -8
- package/bundled/core/pipeline-security-gates.md +63 -0
- package/bundled/core/project-context-memory.md +10 -2
- package/bundled/core/turn-completion-integrity.md +58 -11
- package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
- package/bundled/extensions/languages/csharp-style.md +464 -0
- package/bundled/extensions/languages/php-style.md +700 -0
- package/bundled/extensions/locales/zh-cn.md +717 -0
- package/bundled/extensions/locales/zh-tw.md +717 -0
- package/bundled/hooks/check-turn-completion-agy.mjs +147 -0
- package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
- package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
- package/bundled/locales/COVERAGE.md +5 -4
- package/bundled/locales/zh-CN/CHANGELOG.md +211 -3
- package/bundled/locales/zh-CN/README.md +3 -3
- package/bundled/locales/zh-CN/SECURITY.md +3 -1
- package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
- package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
- package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
- package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
- package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
- package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
- package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
- package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
- package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
- package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
- package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
- package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
- package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
- package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
- package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
- package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
- package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
- package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
- package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
- package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
- package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
- package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
- package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
- package/bundled/locales/zh-CN/core/code-review-checklist.md +54 -23
- package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
- package/bundled/locales/zh-CN/core/database-standards.md +115 -114
- package/bundled/locales/zh-CN/core/developer-memory.md +159 -60
- package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
- package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
- package/bundled/locales/zh-CN/core/execution-history.md +2 -1
- package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
- package/bundled/locales/zh-CN/core/full-coverage-testing.md +103 -9
- package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
- package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
- package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
- package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
- package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
- package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
- package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
- package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
- package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
- package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
- package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
- package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
- package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
- package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
- package/bundled/locales/zh-CN/core/security-decision.md +45 -70
- package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
- package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
- package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
- package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
- package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
- package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
- package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
- package/bundled/locales/zh-CN/core/test-governance.md +94 -43
- package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
- package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
- package/bundled/locales/zh-CN/core/token-budget.md +44 -80
- package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
- package/bundled/locales/zh-CN/core/turn-completion-integrity.md +46 -13
- package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
- package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
- package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
- package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
- package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
- package/bundled/locales/zh-CN/docs/CHEATSHEET.md +11 -2
- package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +76 -40
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +32 -15
- package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
- package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
- package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
- package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
- package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
- package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +46 -0
- package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
- package/bundled/locales/zh-CN/docs/user/README.md +4 -2
- package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
- package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
- package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
- package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
- package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
- package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
- package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
- package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
- package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
- package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
- package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
- package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
- package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
- package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
- package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
- package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
- package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
- package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
- package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
- package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
- package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
- package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
- package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
- package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
- package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
- package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
- package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
- package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
- package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
- package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
- package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
- package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
- package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
- package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
- package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
- package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
- package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
- package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
- package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
- package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
- package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
- package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
- package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/skills/README.md +3 -1
- package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
- package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
- package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
- package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
- package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
- package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
- package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
- package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
- package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
- package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
- package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
- package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
- package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
- package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
- package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
- package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
- package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
- package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
- package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
- package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
- package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
- package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
- package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
- package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
- package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
- package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
- package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
- package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
- package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
- package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
- package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
- package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
- package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
- package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
- package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
- package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
- package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
- package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
- package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
- package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
- package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
- package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
- package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
- package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
- package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
- package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
- package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
- package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
- package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
- package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
- package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
- package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
- package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
- package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
- package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
- package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
- package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
- package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
- package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
- package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
- package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
- package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
- package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
- package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
- package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
- package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
- package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
- package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
- package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
- package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
- package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
- package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
- package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
- package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
- package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
- package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
- package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
- package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
- package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
- package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
- package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
- package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
- package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
- package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
- package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
- package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
- package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
- package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
- package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
- package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
- package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
- package/bundled/locales/zh-TW/CHANGELOG.md +211 -3
- package/bundled/locales/zh-TW/README.md +3 -3
- package/bundled/locales/zh-TW/SECURITY.md +3 -1
- package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
- package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
- package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
- package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
- package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
- package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
- package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
- package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
- package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
- package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
- package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
- package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
- package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
- package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
- package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
- package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
- package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
- package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
- package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
- package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
- package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
- package/bundled/locales/zh-TW/core/code-review-checklist.md +36 -7
- package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
- package/bundled/locales/zh-TW/core/database-standards.md +2 -1
- package/bundled/locales/zh-TW/core/developer-memory.md +111 -12
- package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
- package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
- package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
- package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
- package/bundled/locales/zh-TW/core/execution-history.md +2 -1
- package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
- package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
- package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
- package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
- package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
- package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
- package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
- package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
- package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
- package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
- package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
- package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
- package/bundled/locales/zh-TW/core/open-work-tracking.md +164 -9
- package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
- package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
- package/bundled/locales/zh-TW/core/project-context-memory.md +215 -31
- package/bundled/locales/zh-TW/core/project-structure.md +240 -19
- package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
- package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
- package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
- package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
- package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
- package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
- package/bundled/locales/zh-TW/core/security-decision.md +43 -84
- package/bundled/locales/zh-TW/core/security-standards.md +204 -25
- package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
- package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
- package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
- package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
- package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
- package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
- package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
- package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
- package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
- package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
- package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
- package/bundled/locales/zh-TW/core/test-governance.md +92 -32
- package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
- package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
- package/bundled/locales/zh-TW/core/token-budget.md +41 -112
- package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
- package/bundled/locales/zh-TW/core/turn-completion-integrity.md +46 -13
- package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
- package/bundled/locales/zh-TW/core/versioning.md +6 -2
- package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
- package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
- package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
- package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
- package/bundled/locales/zh-TW/docs/CHEATSHEET.md +11 -2
- package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +69 -33
- package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +32 -15
- package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
- package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
- package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
- package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
- package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
- package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +46 -0
- package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
- package/bundled/locales/zh-TW/docs/user/README.md +2 -0
- package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
- package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
- package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
- package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
- package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
- package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
- package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
- package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
- package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
- package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
- package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
- package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
- package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
- package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
- package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
- package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
- package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
- package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
- package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
- package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
- package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
- package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
- package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
- package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
- package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
- package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
- package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
- package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
- package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
- package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
- package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
- package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
- package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
- package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
- package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
- package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
- package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
- package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
- package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
- package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
- package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/skills/README.md +3 -1
- package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
- package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
- package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
- package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
- package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
- package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
- package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
- package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
- package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
- package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
- package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
- package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
- package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
- package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
- package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
- package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
- package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
- package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
- package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
- package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
- package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
- package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
- package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
- package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
- package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
- package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
- package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
- package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
- package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
- package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
- package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
- package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
- package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
- package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
- package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
- package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
- package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
- package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
- package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
- package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
- package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
- package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
- package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
- package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
- package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
- package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
- package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
- package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
- package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
- package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
- package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
- package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
- package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
- package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
- package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
- package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
- package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
- package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
- package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
- package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
- package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
- package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
- package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
- package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
- package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
- package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
- package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
- package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
- package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
- package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
- package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
- package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
- package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
- package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
- package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
- package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
- package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
- package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
- package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
- package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
- package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
- package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
- package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
- package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
- package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
- package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
- package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
- package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
- package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
- package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
- package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
- package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
- package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
- package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
- package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
- package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
- package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
- package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
- package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
- package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
- package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
- package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
- package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
- package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
- package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
- package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
- package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
- package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
- package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
- package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
- package/bundled/skills/README.md +1 -0
- package/bundled/skills/SKILL_NAMING.md +9 -0
- package/bundled/skills/commit-standards/SKILL.md +2 -2
- package/bundled/skills/commit-standards/guide.md +3 -2
- package/bundled/skills/commit-standards/language-options.md +19 -17
- package/bundled/skills/comprehension-ladder/SKILL.md +283 -0
- package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
- package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
- package/bundled/templates/gates/check-stubs.mjs +644 -0
- package/package.json +5 -3
- package/src/commands/audit.js +20 -2
- package/src/commands/check.js +155 -28
- package/src/commands/deps.js +31 -1
- package/src/commands/hitl.js +3 -0
- package/src/commands/init.js +173 -49
- package/src/commands/list.js +12 -3
- package/src/commands/mcp.js +2 -3
- package/src/commands/open-work.js +123 -0
- package/src/commands/quickstart.js +29 -13
- package/src/commands/release.js +102 -19
- package/src/commands/run-intent.js +10 -0
- package/src/commands/simulate.js +20 -8
- package/src/commands/skills.js +59 -33
- package/src/commands/spec-split.js +30 -17
- package/src/commands/spec.js +55 -21
- package/src/commands/uninstall.js +146 -32
- package/src/commands/update.js +471 -93
- package/src/core/install-records.js +192 -0
- package/src/core/manifest.js +12 -10
- package/src/core/marketplace-sentinel.js +5 -0
- package/src/core/open-work-config.js +122 -0
- package/src/core/project-config.js +92 -38
- package/src/flows/init-flow.js +10 -0
- package/src/hitl/manager.js +4 -2
- package/src/i18n/messages.js +413 -78
- package/src/installers/hooks-installer.js +320 -24
- package/src/installers/integration-installer.js +5 -1
- package/src/installers/skills-installer.js +3 -1
- package/src/installers/standards-installer.js +16 -23
- package/src/mcp/__tests__/server.test.js +0 -1
- package/src/mcp/server.js +16 -4
- package/src/prompts/init.js +148 -13
- package/src/reconciler/backup-locations.js +80 -0
- package/src/reconciler/backup-manager.js +451 -123
- package/src/reconciler/index.js +86 -10
- package/src/reconciler/install-roots.js +90 -0
- package/src/reconciler/plan-executor.js +37 -15
- package/src/uninstallers/hook-uninstaller.js +323 -33
- package/src/uninstallers/integration-uninstaller.js +35 -5
- package/src/uninstallers/skills-uninstaller.js +95 -16
- package/src/uninstallers/standards-uninstaller.js +56 -7
- package/src/utils/agents-installer.js +10 -17
- package/src/utils/available-standards-report.js +144 -0
- package/src/utils/available-standards.js +216 -0
- package/src/utils/command-hash-ownership.js +103 -0
- package/src/utils/commit-message-judge.js +155 -0
- package/src/utils/copier.js +80 -2
- package/src/utils/deps-applicability.js +25 -0
- package/src/utils/detector.js +46 -1
- package/src/utils/friction-detector.js +27 -0
- package/src/utils/gate-scripts.js +141 -0
- package/src/utils/git-hooks.js +139 -7
- package/src/utils/hasher.js +36 -0
- package/src/utils/health-scorer.js +10 -7
- package/src/utils/installed-names-ownership.js +114 -0
- package/src/utils/integration-generator.js +36 -24
- package/src/utils/legacy-hook-migration.js +112 -0
- package/src/utils/locale.js +19 -0
- package/src/utils/open-work-tracking.mjs +1754 -0
- package/src/utils/prompt-closed.js +18 -0
- package/src/utils/sdd-header.js +66 -0
- package/src/utils/skill-frontmatter.js +102 -0
- package/src/utils/skill-hash-ownership.js +64 -0
- package/src/utils/skill-name-collision.js +169 -0
- package/src/utils/skills-install-paths.js +114 -0
- package/src/utils/skills-installer.js +75 -106
- package/src/utils/standard-validator.js +98 -27
- package/src/utils/test-change-check.js +160 -0
- package/src/utils/test-policy.js +214 -0
- package/src/utils/transient-fs.js +113 -0
- package/src/utils/update-summary.js +29 -0
- package/src/vibe/micro-spec.js +15 -0
- package/standards-registry.json +48 -9
|
@@ -1,19 +1,21 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../core/translation-lifecycle-standards.md
|
|
3
|
-
source_version: 1.0.
|
|
4
|
-
translation_version: 1.0.
|
|
5
|
-
last_synced: 2026-
|
|
6
|
-
|
|
3
|
+
source_version: 1.0.1
|
|
4
|
+
translation_version: 1.0.1
|
|
5
|
+
last_synced: 2026-10-11
|
|
6
|
+
source_hash: cac9ee7d0cc3
|
|
7
|
+
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
9
10
|
# 翻譯生命週期標準
|
|
10
11
|
|
|
11
12
|
> **語言**: [English](../../../core/translation-lifecycle-standards.md) | 繁體中文
|
|
12
13
|
|
|
13
|
-
**版本**: 1.0.
|
|
14
|
-
**最後更新**: 2026-
|
|
14
|
+
**版本**: 1.0.1
|
|
15
|
+
**最後更新**: 2026-08-12
|
|
15
16
|
**狀態**: Trial(到期 2026-10-20)
|
|
16
17
|
**適用範圍**: 所有具備多語言文件的專案
|
|
18
|
+
**Scope**: universal
|
|
17
19
|
**來源**: UDS BUG-A06 事後分析(2026-04-20)
|
|
18
20
|
**父標準**: [documentation-lifecycle](documentation-lifecycle.md)
|
|
19
21
|
|
|
@@ -26,7 +28,7 @@ status: stale
|
|
|
26
28
|
`documentation-lifecycle` 標準提到翻譯同步是 release gate 的一環,但未定義如何分類或回應不同程度的漂移。本標準填補這個缺口:翻譯檔案不存在與略微過時有本質差異,major 版本落差與 patch 升版也有本質差異。若不作區分,團隊要麼過度阻塞(任何過時都 fail),要麼阻塞不足(忽略所有過時直到成為用戶可見的問題)。
|
|
27
29
|
|
|
28
30
|
**證據(BUG-A06 事後分析)**:
|
|
29
|
-
1. UDS 在 3
|
|
31
|
+
1. UDS 在 3 個月持續新增標準的期間,因缺乏 MISSING gate 累積了 32 個缺失翻譯,直到 Q2 audit 才發現。
|
|
30
32
|
2. `anti-hallucination.md` zh-CN 停在 1.5.0,來源已升至 1.5.1——新的 Agent 認識論校準框架段落在 zh-CN 版本中完全缺失,使用者看不到。
|
|
31
33
|
|
|
32
34
|
---
|
|
@@ -49,9 +51,9 @@ status: stale
|
|
|
49
51
|
|------|------|-----------|------|
|
|
50
52
|
| `MISSING` | 翻譯檔案不存在 | 1 | 發布前建立 |
|
|
51
53
|
| `MAJOR` | 來源 MAJOR > 翻譯 MAJOR | 1 | 正式版發布前更新 |
|
|
52
|
-
| `MINOR` | 來源 MINOR > 翻譯 MINOR
|
|
53
|
-
| `PATCH` | 來源 PATCH > 翻譯 PATCH
|
|
54
|
-
| `CURRENT` |
|
|
54
|
+
| `MINOR` | 來源 MINOR > 翻譯 MINOR | 0 | 下次發布前更新(advisory)|
|
|
55
|
+
| `PATCH` | 來源 PATCH > 翻譯 PATCH | 0 | 方便時更新(advisory)|
|
|
56
|
+
| `CURRENT` | 來源版本 == 翻譯的 source_version | 0 | 無需行動 |
|
|
55
57
|
|
|
56
58
|
### Semver 差異公式
|
|
57
59
|
|
|
@@ -72,9 +74,9 @@ diff_level = compare(
|
|
|
72
74
|
|------|---------|
|
|
73
75
|
| 新增標準到 `core/` | 在所有支援的語言建立翻譯(MISSING check 阻塞發布)|
|
|
74
76
|
| 標準 PATCH 升版 | 方便時更新翻譯的 `source_version` + `last_synced` |
|
|
75
|
-
| 標準 MINOR
|
|
76
|
-
| 標準 MAJOR
|
|
77
|
-
| 手動更新翻譯 |
|
|
77
|
+
| 標準 MINOR 升版 | 更新翻譯內容 + frontmatter,下次發布前完成 |
|
|
78
|
+
| 標準 MAJOR 升版 | 更新翻譯內容 + frontmatter,當前發布前完成(阻塞)|
|
|
79
|
+
| 手動更新翻譯 | 在 frontmatter 中升版 `translation_version` + `last_synced` |
|
|
78
80
|
|
|
79
81
|
---
|
|
80
82
|
|
|
@@ -107,7 +109,7 @@ status: current | outdated | draft # 人類可讀狀態
|
|
|
107
109
|
|
|
108
110
|
當 `core/*.md` 檔案被暫存時,pre-commit hook 執行 `check-translation-sync.sh` 並顯示 OUTDATED 警告。Hook **永不阻塞** commit(在 commit 時阻塞過於擾人)——純提醒用途。
|
|
109
111
|
|
|
110
|
-
|
|
112
|
+
設定方式:`node scripts/install-hooks.mjs`(clone 後執行一次;`./scripts/install-hooks.sh` 是包裝同一套邏輯的 POSIX wrapper)
|
|
111
113
|
|
|
112
114
|
### Release Gate(`check-translation-sync.sh`)
|
|
113
115
|
|
|
@@ -119,9 +121,9 @@ bash scripts/check-translation-sync.sh
|
|
|
119
121
|
# 僅 MINOR/PATCH 落差 → exit 0(附 advisory 輸出)
|
|
120
122
|
```
|
|
121
123
|
|
|
122
|
-
### Version Bump 整合(`bump-version.
|
|
124
|
+
### Version Bump 整合(`bump-version.mjs`)
|
|
123
125
|
|
|
124
|
-
`bump-version.
|
|
126
|
+
`bump-version.mjs` 在更新版本檔案後自動執行 `check-translation-sync.sh`,在升版時即時顯示翻譯健康狀態快照——讓作者立即知道發布前需要更新什麼。`scripts/bump-version.sh` 是一個 exec `bump-version.mjs` 的輕量 POSIX wrapper——升版邏輯本身只存在於 `.mjs` 檔案中。
|
|
125
127
|
|
|
126
128
|
---
|
|
127
129
|
|
|
@@ -157,3 +159,13 @@ bash scripts/check-translation-sync.sh
|
|
|
157
159
|
| `TRANS-002` | `MAJOR_VERSION_GAP` — 翻譯的 source_version 落後目前來源 MAJOR 版本 |
|
|
158
160
|
| `TRANS-003` | `MISSING_FRONTMATTER` — 翻譯檔案缺少必要的 YAML frontmatter |
|
|
159
161
|
| `TRANS-004` | `STALE_SOURCE_REF` — frontmatter 的 `source` 路徑指向不存在的檔案 |
|
|
162
|
+
|
|
163
|
+
---
|
|
164
|
+
|
|
165
|
+
## 參考資料
|
|
166
|
+
|
|
167
|
+
- [documentation-lifecycle.md](documentation-lifecycle.md) — 父標準;觸發矩陣與檢查金字塔
|
|
168
|
+
- [standard-admission-criteria.md](standard-admission-criteria.md) — 新標準如何被納入(觸發 TRANS-001)
|
|
169
|
+
- `scripts/check-translation-sync.sh` — 本標準自動化規則的實作
|
|
170
|
+
- `.githooks/pre-commit` — Pre-commit 整合
|
|
171
|
+
- `scripts/install-hooks.mjs` — Hook 安裝(`scripts/install-hooks.sh` 是 POSIX wrapper)
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../core/turn-completion-integrity.md
|
|
3
|
-
source_version: 1.
|
|
4
|
-
translation_version: 1.
|
|
5
|
-
last_synced: 2026-09-
|
|
6
|
-
source_hash:
|
|
3
|
+
source_version: 1.5.0
|
|
4
|
+
translation_version: 1.5.0
|
|
5
|
+
last_synced: 2026-09-29
|
|
6
|
+
source_hash: 08579653d9a4
|
|
7
7
|
status: current
|
|
8
8
|
---
|
|
9
9
|
|
|
@@ -11,8 +11,8 @@ status: current
|
|
|
11
11
|
|
|
12
12
|
> **Language**: [English](../../../core/turn-completion-integrity.md) | 繁體中文
|
|
13
13
|
|
|
14
|
-
**版本**: 1.
|
|
15
|
-
**最後更新**: 2026-09-
|
|
14
|
+
**版本**: 1.5.0
|
|
15
|
+
**最後更新**: 2026-09-29
|
|
16
16
|
**適用範圍**: 任何由 agent 結束回合、把控制權交還給人的執行環境
|
|
17
17
|
**Scope**: universal
|
|
18
18
|
**產業標準**: 不宣稱任何來源——由實際觀察到的失敗歸納,見「證據」
|
|
@@ -144,13 +144,14 @@ agent 寫下「我接著做 X」,然後結束回合,而 X 沒有做。
|
|
|
144
144
|
## 支援的執行環境
|
|
145
145
|
|
|
146
146
|
這個檢查只在「轉接層存在,且 hook 真的被接進該執行環境自己的設定」時才生效。
|
|
147
|
-
截至 v1.
|
|
147
|
+
截至 v1.5.0:
|
|
148
148
|
|
|
149
149
|
| 執行環境 | 事件 | 設定檔 | 阻擋契約 |
|
|
150
150
|
|---|---|---|---|
|
|
151
151
|
| Claude Code | Stop | `.claude/settings.json` | stdout 印 `{"decision":"block","reason":...}`,exit 0;沉默即放行 |
|
|
152
152
|
| Codex | Stop | `.codex/hooks.json` | stdout 印 `{"decision":"block","reason":...}`,exit 0——官方文件寫明這個事件純文字或空輸出無效 |
|
|
153
153
|
| Gemini CLI(過時) | AfterAgent | `.gemini/settings.json` | stdout 印 `{"decision":"deny","reason":...}`,exit 0——官方文件標記為優先於 exit code 2 的做法 |
|
|
154
|
+
| Antigravity CLI(`agy`) | Stop | `.agents/hooks.json` | stdout 印 `{"decision":"continue","reason":...}`,exit 0;`{}` 即放行 |
|
|
154
155
|
|
|
155
156
|
在 Codex 上,接上了不等於會執行。Codex 會略過專案層級的 hook,直到專案被信任、**而且**
|
|
156
157
|
這一支 hook 的定義在互動式 Codex 工作階段裡透過 `/hooks` 被信任為止;信任紀錄綁在定義的
|
|
@@ -173,12 +174,42 @@ agent 的最後一則訊息,卻不給使用者的;要拿到使用者那一
|
|
|
173
174
|
|
|
174
175
|
Gemini CLI 已過時。Google 於 2026-06-18 對個人帳號停用 Gemini CLI,
|
|
175
176
|
改由 Antigravity CLI(`agy`)取代;企業帳號兩者都還能用。這個適配層為那些使用者保留,
|
|
176
|
-
但它從未在真實的 Gemini CLI 工作階段中驗證過;使用 Google
|
|
177
|
-
Antigravity CLI
|
|
178
|
-
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
177
|
+
但它從未在真實的 Gemini CLI 工作階段中驗證過;使用 Google 工具的新採用者應使用下面的
|
|
178
|
+
Antigravity CLI 適配層。
|
|
179
|
+
|
|
180
|
+
Antigravity CLI 已支援,依據是真實工作階段觀察到的契約(2026-09-29,agy 1.2.12),
|
|
181
|
+
而不只是它的文件。這份契約在關鍵之處與上表每一個適配層都不同:
|
|
182
|
+
|
|
183
|
+
- **設定**在 `.agents/hooks.json`,以 hook 名稱為鍵——
|
|
184
|
+
`{"<名稱>": {"Stop": [{"type":"command","command":"...","timeout":N}]}}`,
|
|
185
|
+
`timeout` 單位為秒。沒有 `hooks` 外層,handler 也不巢狀在 `hooks[]` 裡。
|
|
186
|
+
- **stdin 既沒有最後一則回覆、也沒有人的訊息**,只有 `transcriptPath` 與中繼資料,所以兩者
|
|
187
|
+
都要從逐字稿讀(JSONL,每筆有 `source`、`type`、`content`)。最後一則回覆是最後一筆
|
|
188
|
+
`source: MODEL`、`type: PLANNER_RESPONSE`。人的訊息是最後一筆
|
|
189
|
+
`source: USER_EXPLICIT`、`type: USER_INPUT`,取 `<USER_REQUEST>…</USER_REQUEST>` 之內的文字——
|
|
190
|
+
後面接著的系統區塊(`<ADDITIONAL_METADATA>` 等)不是人說的話。
|
|
191
|
+
- **`SYSTEM_MESSAGE` 紀錄絕不可當成人的訊息讀。** agy 會把這個 hook 自己的 `continue` 理由
|
|
192
|
+
寫回逐字稿,成為這種紀錄(`source: SYSTEM`、`type: SYSTEM_MESSAGE`,內容為
|
|
193
|
+
「Stop hook blocked termination: …」)。若把「不是模型的任何紀錄」都當成人,就會把 hook
|
|
194
|
+
自己的話當成人說的,R9 豁免隨之失效——也就是 R11 的失敗,換成這份逐字稿的形狀重演。
|
|
195
|
+
- **攔截是 `{"decision":"continue","reason":...}`**,不是 `block` 或 `deny`;`{}` 即放行。
|
|
196
|
+
- **hook 執行時的工作目錄是 `.agents/`,不是專案根目錄**(2026-09-29 實測,agy 1.2.12)。
|
|
197
|
+
因此安裝的指令是 `node ../scripts/hooks/check-turn-completion-agy.mjs`;以專案根目錄為準的
|
|
198
|
+
`node scripts/hooks/...` 會解析成 `<專案>/.agents/scripts/hooks/...`,出現
|
|
199
|
+
「Cannot find module」,而且**agy 對執行失敗的 hook 靜默放行**——沒有任何訊息、stdout 照常,
|
|
200
|
+
回合就這樣結束。路徑刻意用相對路徑(這個檔案本來就是要提交並共用的,絕對路徑只屬於某一台機器),
|
|
201
|
+
也不用任何 shell 語法(`sh -c`、`$(...)`),因為 agy 是否經過 shell 執行 `command` 沒有證據。
|
|
202
|
+
- **與 Claude Code 相反,hook 被呼叫時逐字稿已經寫到最後一則回覆。**
|
|
203
|
+
|
|
204
|
+
已驗證:agy 1.2.12、非互動的 `agy -p`、**單輪且沒有工具呼叫**——hook 被呼叫時最後一則回覆
|
|
205
|
+
已在逐字稿裡,`continue` 確實生效(模型又回了一輪),且沒有遇到信任提示(與 Codex 不同)。
|
|
206
|
+
**未驗證**:多輪對話、含工具呼叫的回合(此時最後一筆 `PLANNER_RESPONSE` 是不是最後回覆、
|
|
207
|
+
hook 執行時是否已寫入)、`fullyIdle: false`、`error` 非空、互動模式、專案層
|
|
208
|
+
`.agents/hooks.json` 是否像 `.agents/skills/` 一樣只對已登記的 Antigravity 專案生效,
|
|
209
|
+
以及工作目錄是否永遠是 `.agents/`(只對專案層檔案量測過;`uds init` 不會寫使用者層的
|
|
210
|
+
`~/.gemini/config/hooks.json`)。在未驗證的情境下,適配層可能判斷的是
|
|
211
|
+
較早的一則回覆而不是最後一則;讀取失敗時仍一律放行(R5)。`uds init --with-hooks` 會在安裝
|
|
212
|
+
那一行旁邊印出已驗證的範圍。
|
|
182
213
|
|
|
183
214
|
Cursor 已評估但不支援:截至撰寫本文時,Cursor 的 stop hook 能不能真的
|
|
184
215
|
擋下一個回合仍未確定,若對著一個沒人驗證過的契約出一份轉接層,
|
|
@@ -240,3 +271,5 @@ Cursor 已評估但不支援:截至撰寫本文時,Cursor 的 stop hook 能
|
|
|
240
271
|
- [ ] 歸屬詞的搜尋排除檢查自己的標題與結構
|
|
241
272
|
- [ ] 每個支援的執行環境的阻擋契約都對照該環境自己的官方文件驗證過,不是照抄另一個環境
|
|
242
273
|
- [ ] 安裝器只為採用者實際選擇的執行環境寫入該環境的 hook 設定
|
|
274
|
+
- [ ] 逐字稿裡會出現系統代寫訊息的執行環境,只從「人的紀錄」讀人的訊息,絕不從「不是模型寫的任何東西」讀
|
|
275
|
+
- [ ] 一份執行環境契約只對「真實工作階段觀察過的範圍」出貨,並註明沒觀察到的範圍
|
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
source: ../../../core/versioning.md
|
|
3
3
|
source_version: 1.5.0
|
|
4
4
|
translation_version: 1.5.0
|
|
5
|
-
last_synced: 2026-
|
|
5
|
+
last_synced: 2026-10-11
|
|
6
|
+
source_hash: 5c995171e2a4
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
@@ -13,6 +14,9 @@ status: current
|
|
|
13
14
|
**版本**: 1.5.0
|
|
14
15
|
**最後更新**: 2026-07-01
|
|
15
16
|
**適用範圍**: 所有有版本發布的軟體專案
|
|
17
|
+
**範圍**: universal
|
|
18
|
+
**業界標準**: Semantic Versioning 2.0.0
|
|
19
|
+
**參考文獻**: [semver.org](https://semver.org/)
|
|
16
20
|
|
|
17
21
|
---
|
|
18
22
|
|
|
@@ -843,7 +847,7 @@ semver.major('2.3.1'); // 2
|
|
|
843
847
|
| Version | Date | Changes |
|
|
844
848
|
|---------|------|---------|
|
|
845
849
|
| 1.5.0 | 2026-07-01 | Added: 自動化工具新增 git-height 衍生版本工具(MinVer / Nerdbank.GitVersioning / GitVersion),適用 polyglot / .NET / JVM 專案(UDS #138 R2);將「Build 身分可被觀測」提升為需求——已部署服務 MUST 透過可查詢 endpoint 暴露 `version + commit sha + build time`——並於 Phase 5 部署後驗證新增 commit-sha + build-time 斷言(UDS #138 R3) |
|
|
846
|
-
| 1.4.0 | 2026-06-24 | Moved out (to single sources): API Versioning Strategies (de-duplicated), Deprecation Timeline + per-tier periods, Backward Compatibility Checklist, Migration Guide template — now owned by api-design-standards / deprecation-standards (XSPEC-298 R8, UDS #126) |
|
|
850
|
+
| 1.4.0 | 2026-06-24 | Moved out (to single sources): API Versioning Strategies (de-duplicated), Deprecation Timeline + per-tier periods, Backward Compatibility Checklist, Migration Guide template — now owned by api-design-standards / deprecation-standards; versioning cross-references them (XSPEC-298 R8, UDS #126) |
|
|
847
851
|
| 1.3.0 | 2026-06-23 | Added: Deployment Version Identity section; build-metadata-as-deployment-discriminator caveat (from UDS #138) |
|
|
848
852
|
| 1.2.0 | 2025-12-30 | Added: API Versioning Strategies, Deprecation Timeline, Backward Compatibility Checklist |
|
|
849
853
|
| 1.1.3 | 2025-12-24 | Added: Related Standards section |
|
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
source: ../../../core/virtual-organization-standards.md
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
|
-
last_synced: 2026-
|
|
5
|
+
last_synced: 2026-10-11
|
|
6
|
+
source_hash: 4694212aa518
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
@@ -15,6 +16,7 @@ status: current
|
|
|
15
16
|
**適用性**: 專案設置和 AI 工具配置
|
|
16
17
|
**範圍**: 通用 (Universal)
|
|
17
18
|
**業界標準**: ISO 12207 §6.2
|
|
19
|
+
**參考資料**: [iso.org](https://www.iso.org/standard/63712.html)
|
|
18
20
|
**ISO 12207 對應**: 組織專案賦能流程 (6.2)
|
|
19
21
|
|
|
20
22
|
---
|
|
@@ -25,17 +27,16 @@ status: current
|
|
|
25
27
|
|
|
26
28
|
---
|
|
27
29
|
|
|
28
|
-
## 1.
|
|
30
|
+
## 1. 虛擬人力管理(人力資源)
|
|
29
31
|
|
|
30
32
|
在 Vibe Coding 中,「人力資源管理」即管理 AI 代理的能力。
|
|
31
33
|
|
|
32
34
|
### 1.1 技能管理
|
|
33
|
-
|
|
34
35
|
技能是虛擬員工的「資格」。
|
|
35
36
|
|
|
36
|
-
- **取得**:技能必須明確安裝(例如透過 `skills/`
|
|
37
|
-
-
|
|
38
|
-
-
|
|
37
|
+
- **取得**:技能必須明確安裝(例如透過 `skills/` 目錄或插件)。
|
|
38
|
+
- **能力**:技能必須針對特定專案情境進行驗證。
|
|
39
|
+
- **角色定義**:代理應被指派「角色」(技能集合),而非作為通用代理。
|
|
39
40
|
|
|
40
41
|
| 角色 | 建議技能集 |
|
|
41
42
|
|------|-----------|
|
|
@@ -44,45 +45,50 @@ status: current
|
|
|
44
45
|
| **重構代理** | `static-analysis`、`code-metrics`、`refactoring-patterns` |
|
|
45
46
|
|
|
46
47
|
### 1.2 入職(情境載入)
|
|
48
|
+
「入職」AI 代理意味著載入正確的情境和配置。
|
|
49
|
+
- **專案引導**:載入 `README.md`、架構文件和標準。
|
|
50
|
+
- **規範對齊**:載入 `core/ai-agreement-standards.md`。
|
|
47
51
|
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
- **專案引導**:載入 `README.md`、架構文件和標準
|
|
51
|
-
- **規範熟悉**:載入適用的開發標準
|
|
52
|
-
- **歷史認知**:載入專案決策和慣例
|
|
52
|
+
---
|
|
53
53
|
|
|
54
|
-
## 2.
|
|
54
|
+
## 2. 基礎設施管理(工具)
|
|
55
55
|
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
| 品保部門 | 測試和 Lint | 自動化品質檢查 |
|
|
56
|
+
### 2.1 工具整合
|
|
57
|
+
AI 代理的「辦公環境」包含:
|
|
58
|
+
- **MCP Servers**:透過 Model Context Protocol 進行標準化整合。
|
|
59
|
+
- **API 存取**:安全管理金鑰與端點。
|
|
60
|
+
- **Sandbox**:用於執行程式碼的隔離環境(防止系統損壞)。
|
|
62
61
|
|
|
63
|
-
|
|
62
|
+
### 2.2 知識庫
|
|
63
|
+
AI 代理的「企業圖書館」:
|
|
64
|
+
- **向量資料庫**:用於大規模文件檢索。
|
|
65
|
+
- **程式碼片段庫**:可重用的程式碼模式與範本。
|
|
64
66
|
|
|
65
|
-
|
|
67
|
+
---
|
|
66
68
|
|
|
67
|
-
|
|
68
|
-
|------|------|
|
|
69
|
-
| 程式碼審查 | AI 和人類都必須審查重要變更 |
|
|
70
|
-
| 測試要求 | 新功能必須有對應測試 |
|
|
71
|
-
| 標準遵循 | 所有產出必須符合已安裝的標準 |
|
|
72
|
-
| 持續改善 | 定期回顧和更新標準 |
|
|
69
|
+
## 3. 品質管理系統(QMS)
|
|
73
70
|
|
|
74
|
-
### 3.
|
|
71
|
+
### 3.1 自動化 Vibe 檢查
|
|
72
|
+
品質控制左移,納入生成過程之中。
|
|
73
|
+
- **生成前檢查**:代理是否理解任務?
|
|
74
|
+
- **生成後檢查**:程式碼能否編譯?測試是否通過?
|
|
75
75
|
|
|
76
|
-
|
|
76
|
+
### 3.2 幻覺監控
|
|
77
|
+
持續監控「缺陷率」(幻覺):
|
|
78
|
+
- **偵測**:使用 `uds check` 與靜態分析。
|
|
79
|
+
- **修正**:更新 Context Contracts 以防止再次發生。
|
|
77
80
|
|
|
78
|
-
|
|
79
|
-
|----------|------|--------|
|
|
80
|
-
| 技能有效性 | 每個版本 | 技術主管 |
|
|
81
|
-
| 標準合規 | 每次提交 | 自動化 |
|
|
82
|
-
| 安全審計 | 每季 | 安全團隊 |
|
|
81
|
+
---
|
|
83
82
|
|
|
84
83
|
## 相關標準
|
|
85
84
|
|
|
86
|
-
- [
|
|
87
|
-
- [
|
|
88
|
-
|
|
85
|
+
- [測試標準](testing-standards.md)
|
|
86
|
+
- [提交規範](checkin-standards.md)
|
|
87
|
+
|
|
88
|
+
---
|
|
89
|
+
|
|
90
|
+
## 版本歷史
|
|
91
|
+
|
|
92
|
+
| 版本 | 日期 | 變更 |
|
|
93
|
+
|------|------|------|
|
|
94
|
+
| 1.0.0 | 2026-01-29 | 初始發布,對應 ISO 12207 賦能流程 |
|
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
---
|
|
2
|
+
source: ../../../docs/AVAILABLE-STANDARDS.md
|
|
3
|
+
source_version: 1.0.0
|
|
4
|
+
translation_version: 1.0.0
|
|
5
|
+
last_synced: 2026-10-07
|
|
6
|
+
source_hash: a189829f9324
|
|
7
|
+
status: current
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
# 可用標準:UDS 有出貨、你的專案沒有裝的標準
|
|
11
|
+
|
|
12
|
+
> **語言**: [English](../../../docs/AVAILABLE-STANDARDS.md) | 繁體中文 | [简体中文](../../zh-CN/docs/AVAILABLE-STANDARDS.md)
|
|
13
|
+
|
|
14
|
+
用舊版 UDS 設定的專案,只保有當時裝的標準。之後 UDS 新增的標準**不會**被 `uds update --apply` 裝上,
|
|
15
|
+
因為更新只維護專案清單(`.standards/manifest.json`)列出的東西。這個功能出現之前,沒有任何指令會告訴你
|
|
16
|
+
它們存在。現在有三個指令會告訴你,另一個讓你挑著裝。
|
|
17
|
+
|
|
18
|
+
## 唯一的規則
|
|
19
|
+
|
|
20
|
+
一個標準同時符合下列三點,就是**可用但未安裝**:
|
|
21
|
+
|
|
22
|
+
1. 它的類別是 `uds init` 會安裝的類別(`reference` 或 `skill`,見下表),
|
|
23
|
+
2. 在你專案的 `format`(預設 `ai`)下有來源檔(只有技能、沒有檔案的項目不算),
|
|
24
|
+
3. `manifest.standards` 裡沒有同名檔案。
|
|
25
|
+
|
|
26
|
+
這條規則只寫在一個函式裡(`getAvailableStandards`,`cli/src/utils/available-standards.js`)。`uds update` 舊的
|
|
27
|
+
互動路徑、`uds update --plan`/`--apply`、`uds check`、`uds audit --friction` 都問它,所以不會各說各話。
|
|
28
|
+
|
|
29
|
+
## 類別
|
|
30
|
+
|
|
31
|
+
| 類別 | 列為「可用」? | 原因 |
|
|
32
|
+
|---|---|---|
|
|
33
|
+
| `reference` | 是 | `uds init` 會把它裝進 `.standards/`。 |
|
|
34
|
+
| `skill` | 是 | `uds init` 會把它裝進 `.standards/`。 |
|
|
35
|
+
| `core` | **否,但會計數、可用 id 安裝** | 2026 年 3 月才加進登記表,晚於安裝程式「只裝 reference 或 skill」的過濾(2025 年 12 月)。`uds init` 從來沒裝過它,所以對專案而言它從來不是「新的」。這是歷史意外,不是設計決定。 |
|
|
36
|
+
| `testing`、`security`、`deployment`、`operations` | **否,但會計數、可用 id 安裝** | 與 `core` 相同:後來才加,init 從沒裝過。 |
|
|
37
|
+
| `extension` | 否,**`--add-standard` 也不安裝** | 由 init 的語言/框架/語系選項(`--lang`、`--framework`、`--locale`)安裝。 |
|
|
38
|
+
| `integration` | 否,`--add-standard` 也不安裝 | 每個 AI 工具各一個整合檔,由 init 的 AI 工具選項安裝。 |
|
|
39
|
+
| `template` | 否,`--add-standard` 也不安裝 | 要複製使用的文件範本,不是標準檔。 |
|
|
40
|
+
|
|
41
|
+
其他類別不會被悄悄丟掉:`uds update --plan` 結尾會有一行說明有幾個、在哪些類別;可安裝的類別都能用 id 指名安裝
|
|
42
|
+
(見下)。它們是否該像 `reference`/`skill` 一樣被**列出**,是還沒決定的事(XSPEC-458 OQ1)。
|
|
43
|
+
|
|
44
|
+
## 與這件事無關的 manifest 欄位
|
|
45
|
+
|
|
46
|
+
| 欄位 | 狀態 | 作用 |
|
|
47
|
+
|---|---|---|
|
|
48
|
+
| `level` | 死欄位 | 6.11.0 寫的 manifest 只在 `integrationConfigs[<檔案>].level` 裡留有殘值。沒有任何程式碼用它決定安裝什麼。登記表的「等級系統」是已棄用的空殼。 |
|
|
49
|
+
| `profile` | 不存在 | CLI 與任何 manifest 都沒有這個欄位。 |
|
|
50
|
+
| `contentMode` | 有作用,但與此無關 | 決定 `CLAUDE.md` 怎麼產生(`minimal` 或 `index`)。它從不決定裝哪些標準。 |
|
|
51
|
+
|
|
52
|
+
## 指令
|
|
53
|
+
|
|
54
|
+
```sh
|
|
55
|
+
uds update --plan # 先印計畫,再印「上游有、專案沒裝(N 個)」,依類別分組
|
|
56
|
+
uds update --apply # 套用計畫;結尾印出有幾個可用、怎麼裝
|
|
57
|
+
uds update --apply --add-standard open-work-tracking # 裝一個,並記入 manifest
|
|
58
|
+
uds update --apply --add-standard a --add-standard b # 裝多個
|
|
59
|
+
uds update --plan --add-standard open-work-tracking # 先預覽
|
|
60
|
+
uds check # 一行:「上游有 N 個標準未安裝」
|
|
61
|
+
uds audit --friction # 一項低嚴重度發現(不進 --report、不影響 --score)
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
- 除了 `--add-standard`,上面全是**純資訊**:計畫的動作、`uds check` 的判定與結束碼、`uds audit --score`
|
|
65
|
+
都與以前完全相同。`uds audit --score` 不讀這項發現。
|
|
66
|
+
- `--add-standard` 要搭配 `--plan` 或 `--apply`。它會記入 `manifest.standards`,所以之後的 `uds update --apply`
|
|
67
|
+
會保留它(manifest 沒列出的檔會被當成多餘的)。再跑一次 `--plan` 沒有變動;`uds update --rollback` 會把它
|
|
68
|
+
拿掉(manifest 一起還原)。
|
|
69
|
+
- 未知的 id 以非 0 結束並列出最相近的 id;已安裝的 id 會說明已安裝並以 0 結束;`extension`、`integration`、
|
|
70
|
+
`template` 的 id 會被拒絕並說明原因。
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# UDS 速查表
|
|
2
2
|
|
|
3
|
-
> Quick reference for all UDS features | Last updated: 2026-
|
|
3
|
+
> Quick reference for all UDS features | Last updated: 2026-10-12
|
|
4
4
|
|
|
5
5
|
**Language**: [English](../../../docs/user/CHEATSHEET.md) | 繁體中文 | [简体中文](../../zh-CN/docs/CHEATSHEET.md)
|
|
6
6
|
|
|
@@ -17,7 +17,7 @@
|
|
|
17
17
|
| `uds configure` | Alias for "uds config" — Modify project settings |
|
|
18
18
|
| `uds check` | Check file integrity and adoption status (quick validation). For deep health diagnosis, use "uds audit" |
|
|
19
19
|
| `uds lint` | Check spec dependency validity and size against installed specs (specs/*.md) |
|
|
20
|
-
| `uds simulate` | Simulate a standard check with input (Predictive Validation) |
|
|
20
|
+
| `uds simulate` | Simulate a standard check with input (Predictive Validation). Exit 0 = passes, 1 = does not comply, 2 = no verdict (cannot simulate; not a pass). Only commit-message defines a simulator today |
|
|
21
21
|
| `uds fix` | Auto-fix standard violations (Self-Healing) |
|
|
22
22
|
| `uds update` | Update standards to latest version |
|
|
23
23
|
| `uds skills` | List installed Claude Code skills |
|
|
@@ -32,6 +32,7 @@
|
|
|
32
32
|
| `uds agent` | Manage UDS agents for AI tools |
|
|
33
33
|
| `uds ai-context` | Manage .ai-context.yaml configuration for AI-friendly architecture |
|
|
34
34
|
| `uds mcp` | MCP server commands for AI tool integration |
|
|
35
|
+
| `uds open-work` | Reference checks for open-work-tracking (OWT-017 to OWT-028). Exit 0 no violation, 1 violation, 2 cannot decide (not a pass) |
|
|
35
36
|
| `uds run` | Run a project command by intent (test/lint/build/security) via uds.project.yaml |
|
|
36
37
|
|
|
37
38
|
## 💬 斜線命令
|
|
@@ -109,6 +110,7 @@
|
|
|
109
110
|
| `ci-cd-assistant` | 引導 CI/CD 管線的設計、設定與最佳化。 |
|
|
110
111
|
| `code-review-assistant` | [UDS] 系統性程式碼審查的參考資料:八大審查類別,以及 BLOCKING/IMPORTANT/SUGGESTION |
|
|
111
112
|
| `commit-standards` | [UDS] 產生符合 Conventional Commits 規範的 commit message,包含雙語格式。 |
|
|
113
|
+
| `comprehension-ladder` | [UDS] 把一段難懂的 AI 輸出換成較好懂的形式:受控文字、Mermaid 圖、單檔 HTML 解說頁。所有形式都來 |
|
|
112
114
|
| `contract-test-assistant` | [UDS] 引導 API 與微服務的合約測試策略。 |
|
|
113
115
|
| `database-assistant` | 引導資料庫設計、遷移與查詢最佳化。 |
|
|
114
116
|
| `deploy-assistant` | 引導在沒有 CI/CD 平台(GitHub Actions/GitLab CI)的情況下完成可靠部署。 |
|
|
@@ -340,6 +342,7 @@
|
|
|
340
342
|
| `check-ai-agent-sync.ps1` | Check Ai Agent Sync |
|
|
341
343
|
| `check-ai-agent-sync.sh` | AI Agent Sync Checker |
|
|
342
344
|
| `check-ai-yaml-parses.mjs` | Every shipped .ai.yaml must parse, and must parse |
|
|
345
|
+
| `check-bats-assertions.mjs` | check-bats-assertions.mjs — find .bats assertions |
|
|
343
346
|
| `check-bump-sync-roundtrip.mjs` | check-bump-sync-roundtrip — 測「跑完 bump 之後 check 必須通 |
|
|
344
347
|
| `check-cli-docs-sync.ps1` | Check Cli Docs Sync |
|
|
345
348
|
| `check-cli-docs-sync.sh` | CLI-to-Documentation Sync Checker |
|
|
@@ -352,8 +355,11 @@
|
|
|
352
355
|
| `check-docs-sync.sh` | Documentation Sync Checker |
|
|
353
356
|
| `check-error-exit.mjs` | 🔴 沒填就是沒設定,而沒設定會 exit 2, |
|
|
354
357
|
| `check-external-references.mjs` | External Reference Checker (SPEC-SELFDIAG-001 REQ- |
|
|
358
|
+
| `check-home-untouched.mjs` | check-home-untouched — did this run write anywhere |
|
|
359
|
+
| `check-open-work-tracking.mjs` | Open-work-tracking reference checks for OWT-017 to |
|
|
355
360
|
| `check-orphan-specs.ps1` | Check Orphan Specs |
|
|
356
361
|
| `check-orphan-specs.sh` | Orphan Spec Detection Script |
|
|
362
|
+
| `check-prompt-footprint.mjs` | Prompt Footprint Ratchet — DEC-117 D2/L2 |
|
|
357
363
|
| `check-scope-sync.ps1` | Check Scope Sync |
|
|
358
364
|
| `check-scope-sync.sh` | Scope Consistency Check Script |
|
|
359
365
|
| `check-skill-next-steps-sync.ps1` | Check Skill Next Steps Sync |
|
|
@@ -367,11 +373,13 @@
|
|
|
367
373
|
| `check-translation-hash-ratchet.sh` | XSPEC-392 R6 棘輪:新的翻譯必須帶 source_hash,既有的欠債冷凍為基線。 |
|
|
368
374
|
| `check-translation-sync.ps1` | Check Translation Sync |
|
|
369
375
|
| `check-translation-sync.sh` | Translation Sync Checker |
|
|
376
|
+
| `check-upgrade-fidelity.sh` | Upgrade Fidelity Checker |
|
|
370
377
|
| `check-usage-docs-sync.ps1` | Check if usage documentation needs to be regenerat |
|
|
371
378
|
| `check-usage-docs-sync.sh` | check-usage-docs-sync.sh |
|
|
372
379
|
| `check-version-sync.ps1` | Check Version Sync |
|
|
373
380
|
| `check-version-sync.sh` | Version Sync Checker |
|
|
374
381
|
| `check-workflow-compliance.sh` | Thin wrapper — scripts/check-workflow-compliance.t |
|
|
382
|
+
| `ci-vitest-summary.mjs` | ci-vitest-summary — say how many tests ran, passed |
|
|
375
383
|
| `commitlint-bilingual-rule.mjs` | commitlint-bilingual-rule.mjs — custom commitlint |
|
|
376
384
|
| `convert-md-to-yaml.mjs` | Markdown to AI-YAML Conversion Script |
|
|
377
385
|
| `fix-manifest-paths.ps1` | Fix Manifest Paths |
|
|
@@ -383,6 +391,7 @@
|
|
|
383
391
|
| `generate-version-manifest.mjs` | Generate Version Manifest (SPEC-SELFDIAG-001 REQ-9 |
|
|
384
392
|
| `install-hooks.mjs` | Install Hooks |
|
|
385
393
|
| `install-hooks.sh` | Thin wrapper — scripts/install-hooks.mjs is the on |
|
|
394
|
+
| `npm-pack-files.mjs` | @param {string} stdout @returns {string[]} package |
|
|
386
395
|
| `pre-commit.mjs` | Build a platform-aware shell command for a .sh scr |
|
|
387
396
|
| `pre-release-check.ps1` | Pre Release Check |
|
|
388
397
|
| `pre-release-check.sh` | Pre-release Check Script |
|