universal-dev-standards 6.14.0-beta.1 → 6.14.0-beta.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +13 -3
- package/bin/uds.js +75 -3
- package/bundled/ai/options/code-review/pr-review.ai.yaml +20 -1
- package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
- package/bundled/ai/standards/ai-response-navigation.ai.yaml +43 -3
- package/bundled/ai/standards/checkin-standards.ai.yaml +25 -6
- package/bundled/ai/standards/code-review.ai.yaml +15 -2
- package/bundled/ai/standards/commit-message.ai.yaml +18 -4
- package/bundled/ai/standards/developer-memory.ai.yaml +12 -2
- package/bundled/ai/standards/full-coverage-testing.ai.yaml +86 -7
- package/bundled/ai/standards/open-work-tracking.ai.yaml +196 -11
- package/bundled/ai/standards/pipeline-security-gates.ai.yaml +53 -4
- package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
- package/bundled/core/ai-response-navigation.md +128 -12
- package/bundled/core/code-review-checklist.md +20 -2
- package/bundled/core/commit-message-guide.md +22 -19
- package/bundled/core/developer-memory.md +12 -2
- package/bundled/core/full-coverage-testing.md +99 -5
- package/bundled/core/open-work-tracking.md +157 -17
- package/bundled/core/pipeline-security-gates.md +63 -0
- package/bundled/core/project-context-memory.md +10 -2
- package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
- package/bundled/extensions/languages/csharp-style.md +464 -0
- package/bundled/extensions/languages/php-style.md +700 -0
- package/bundled/extensions/locales/zh-cn.md +717 -0
- package/bundled/extensions/locales/zh-tw.md +717 -0
- package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
- package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
- package/bundled/locales/COVERAGE.md +5 -4
- package/bundled/locales/zh-CN/CHANGELOG.md +199 -3
- package/bundled/locales/zh-CN/README.md +3 -3
- package/bundled/locales/zh-CN/SECURITY.md +3 -2
- package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
- package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
- package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
- package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
- package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
- package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
- package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
- package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
- package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
- package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
- package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
- package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
- package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
- package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
- package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
- package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
- package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
- package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
- package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
- package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
- package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
- package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
- package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
- package/bundled/locales/zh-CN/core/code-review-checklist.md +54 -23
- package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
- package/bundled/locales/zh-CN/core/database-standards.md +115 -114
- package/bundled/locales/zh-CN/core/developer-memory.md +159 -60
- package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
- package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
- package/bundled/locales/zh-CN/core/execution-history.md +2 -1
- package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
- package/bundled/locales/zh-CN/core/full-coverage-testing.md +103 -9
- package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
- package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
- package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
- package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
- package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
- package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
- package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
- package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
- package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
- package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
- package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
- package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
- package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
- package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
- package/bundled/locales/zh-CN/core/security-decision.md +45 -70
- package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
- package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
- package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
- package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
- package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
- package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
- package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
- package/bundled/locales/zh-CN/core/test-governance.md +94 -43
- package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
- package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
- package/bundled/locales/zh-CN/core/token-budget.md +44 -80
- package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
- package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
- package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
- package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
- package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
- package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
- package/bundled/locales/zh-CN/docs/CHEATSHEET.md +9 -3
- package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +68 -33
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +29 -15
- package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
- package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
- package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
- package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
- package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
- package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +46 -0
- package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
- package/bundled/locales/zh-CN/docs/user/README.md +4 -2
- package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
- package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
- package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
- package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
- package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
- package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
- package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
- package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
- package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
- package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
- package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
- package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
- package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
- package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
- package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
- package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
- package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
- package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
- package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
- package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
- package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
- package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
- package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
- package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
- package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
- package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
- package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
- package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
- package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
- package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
- package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
- package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
- package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
- package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
- package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
- package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
- package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
- package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
- package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
- package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
- package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
- package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
- package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/skills/README.md +3 -1
- package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
- package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
- package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
- package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
- package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
- package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
- package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
- package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
- package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
- package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
- package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
- package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
- package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
- package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
- package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
- package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
- package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
- package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
- package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
- package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
- package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
- package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
- package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
- package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
- package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
- package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
- package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
- package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
- package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
- package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
- package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
- package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
- package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
- package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
- package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
- package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
- package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
- package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
- package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
- package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
- package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
- package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
- package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
- package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
- package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
- package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
- package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
- package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
- package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
- package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
- package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
- package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
- package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
- package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
- package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
- package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
- package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
- package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
- package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
- package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
- package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
- package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
- package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
- package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
- package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
- package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
- package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
- package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
- package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
- package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
- package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
- package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
- package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
- package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
- package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
- package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
- package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
- package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
- package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
- package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
- package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
- package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
- package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
- package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
- package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
- package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
- package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
- package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
- package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
- package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
- package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
- package/bundled/locales/zh-TW/CHANGELOG.md +199 -3
- package/bundled/locales/zh-TW/README.md +3 -3
- package/bundled/locales/zh-TW/SECURITY.md +3 -2
- package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
- package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
- package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
- package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
- package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
- package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
- package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
- package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
- package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
- package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
- package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
- package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
- package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
- package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
- package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
- package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
- package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
- package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
- package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
- package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
- package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
- package/bundled/locales/zh-TW/core/code-review-checklist.md +36 -7
- package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
- package/bundled/locales/zh-TW/core/database-standards.md +2 -1
- package/bundled/locales/zh-TW/core/developer-memory.md +111 -12
- package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
- package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
- package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
- package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
- package/bundled/locales/zh-TW/core/execution-history.md +2 -1
- package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
- package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
- package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
- package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
- package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
- package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
- package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
- package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
- package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
- package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
- package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
- package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
- package/bundled/locales/zh-TW/core/open-work-tracking.md +92 -16
- package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
- package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
- package/bundled/locales/zh-TW/core/project-context-memory.md +215 -31
- package/bundled/locales/zh-TW/core/project-structure.md +240 -19
- package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
- package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
- package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
- package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
- package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
- package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
- package/bundled/locales/zh-TW/core/security-decision.md +43 -84
- package/bundled/locales/zh-TW/core/security-standards.md +204 -25
- package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
- package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
- package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
- package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
- package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
- package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
- package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
- package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
- package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
- package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
- package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
- package/bundled/locales/zh-TW/core/test-governance.md +92 -32
- package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
- package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
- package/bundled/locales/zh-TW/core/token-budget.md +41 -112
- package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
- package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
- package/bundled/locales/zh-TW/core/versioning.md +6 -2
- package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
- package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
- package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
- package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
- package/bundled/locales/zh-TW/docs/CHEATSHEET.md +9 -3
- package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +61 -26
- package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +29 -15
- package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
- package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
- package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
- package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
- package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
- package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +46 -0
- package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
- package/bundled/locales/zh-TW/docs/user/README.md +2 -0
- package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
- package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
- package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
- package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
- package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
- package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
- package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
- package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
- package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
- package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
- package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
- package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
- package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
- package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
- package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
- package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
- package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
- package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
- package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
- package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
- package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
- package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
- package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
- package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
- package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
- package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
- package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
- package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
- package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
- package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
- package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
- package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
- package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
- package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
- package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
- package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
- package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
- package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
- package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
- package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
- package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/skills/README.md +3 -1
- package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
- package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
- package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
- package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
- package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
- package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
- package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
- package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
- package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
- package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
- package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
- package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
- package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
- package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
- package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
- package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
- package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
- package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
- package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
- package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
- package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
- package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
- package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
- package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
- package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
- package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
- package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
- package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
- package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
- package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
- package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
- package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
- package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
- package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
- package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
- package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
- package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
- package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
- package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
- package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
- package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
- package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
- package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
- package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
- package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
- package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
- package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
- package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
- package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
- package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
- package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
- package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
- package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
- package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
- package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
- package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
- package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
- package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
- package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
- package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
- package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
- package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
- package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
- package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
- package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
- package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
- package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
- package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
- package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
- package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
- package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
- package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
- package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
- package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
- package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
- package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
- package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
- package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
- package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
- package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
- package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
- package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
- package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
- package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
- package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
- package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
- package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
- package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
- package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
- package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
- package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
- package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
- package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
- package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
- package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
- package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
- package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
- package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
- package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
- package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
- package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
- package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
- package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
- package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
- package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
- package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
- package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
- package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
- package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
- package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
- package/bundled/skills/README.md +1 -0
- package/bundled/skills/SKILL_NAMING.md +9 -0
- package/bundled/skills/commit-standards/SKILL.md +2 -2
- package/bundled/skills/commit-standards/guide.md +3 -2
- package/bundled/skills/commit-standards/language-options.md +19 -17
- package/bundled/skills/comprehension-ladder/SKILL.md +283 -0
- package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
- package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
- package/bundled/templates/gates/check-stubs.mjs +644 -0
- package/package.json +5 -3
- package/src/commands/audit.js +20 -2
- package/src/commands/check.js +155 -28
- package/src/commands/deps.js +31 -1
- package/src/commands/hitl.js +3 -0
- package/src/commands/init.js +159 -48
- package/src/commands/list.js +12 -3
- package/src/commands/mcp.js +2 -3
- package/src/commands/open-work.js +123 -0
- package/src/commands/quickstart.js +29 -13
- package/src/commands/release.js +102 -19
- package/src/commands/run-intent.js +10 -0
- package/src/commands/simulate.js +20 -8
- package/src/commands/skills.js +59 -33
- package/src/commands/spec-split.js +30 -17
- package/src/commands/spec.js +55 -21
- package/src/commands/uninstall.js +146 -32
- package/src/commands/update.js +471 -93
- package/src/core/install-records.js +192 -0
- package/src/core/manifest.js +12 -10
- package/src/core/marketplace-sentinel.js +5 -0
- package/src/core/open-work-config.js +122 -0
- package/src/core/project-config.js +92 -38
- package/src/flows/init-flow.js +10 -0
- package/src/hitl/manager.js +4 -2
- package/src/i18n/messages.js +413 -78
- package/src/installers/hooks-installer.js +236 -27
- package/src/installers/integration-installer.js +5 -1
- package/src/installers/skills-installer.js +3 -1
- package/src/installers/standards-installer.js +16 -23
- package/src/mcp/__tests__/server.test.js +0 -1
- package/src/mcp/server.js +16 -4
- package/src/prompts/init.js +148 -13
- package/src/reconciler/backup-locations.js +80 -0
- package/src/reconciler/backup-manager.js +451 -123
- package/src/reconciler/index.js +86 -10
- package/src/reconciler/install-roots.js +90 -0
- package/src/reconciler/plan-executor.js +37 -15
- package/src/uninstallers/hook-uninstaller.js +220 -33
- package/src/uninstallers/integration-uninstaller.js +35 -5
- package/src/uninstallers/skills-uninstaller.js +95 -16
- package/src/uninstallers/standards-uninstaller.js +56 -7
- package/src/utils/agents-installer.js +10 -17
- package/src/utils/available-standards-report.js +144 -0
- package/src/utils/available-standards.js +216 -0
- package/src/utils/command-hash-ownership.js +103 -0
- package/src/utils/commit-message-judge.js +155 -0
- package/src/utils/copier.js +80 -2
- package/src/utils/deps-applicability.js +25 -0
- package/src/utils/detector.js +46 -1
- package/src/utils/friction-detector.js +27 -0
- package/src/utils/gate-scripts.js +141 -0
- package/src/utils/git-hooks.js +139 -7
- package/src/utils/hasher.js +36 -0
- package/src/utils/health-scorer.js +10 -7
- package/src/utils/installed-names-ownership.js +114 -0
- package/src/utils/integration-generator.js +36 -24
- package/src/utils/legacy-hook-migration.js +112 -0
- package/src/utils/locale.js +19 -0
- package/src/utils/open-work-tracking.mjs +1754 -0
- package/src/utils/prompt-closed.js +18 -0
- package/src/utils/sdd-header.js +66 -0
- package/src/utils/skill-frontmatter.js +102 -0
- package/src/utils/skill-hash-ownership.js +64 -0
- package/src/utils/skill-name-collision.js +169 -0
- package/src/utils/skills-install-paths.js +114 -0
- package/src/utils/skills-installer.js +75 -106
- package/src/utils/standard-validator.js +98 -27
- package/src/utils/test-change-check.js +160 -0
- package/src/utils/test-policy.js +214 -0
- package/src/utils/transient-fs.js +113 -0
- package/src/utils/update-summary.js +29 -0
- package/src/vibe/micro-spec.js +15 -0
- package/standards-registry.json +48 -9
|
@@ -8,11 +8,11 @@ standard:
|
|
|
8
8
|
description: Behavior-completeness full coverage paradigm replacing pyramid thresholds. Enforces anti-fake-test rules, STUB marker protocol, ratchet CI, and @ac traceability.
|
|
9
9
|
|
|
10
10
|
meta:
|
|
11
|
-
version: "1.
|
|
12
|
-
updated: "2026-
|
|
11
|
+
version: "1.3.0"
|
|
12
|
+
updated: "2026-10-09"
|
|
13
13
|
source: core/full-coverage-testing.md
|
|
14
14
|
replaces: "testing pyramid thresholds (UT≥80%/IT≥70%/E2E happy-path-only)"
|
|
15
|
-
xspec: "XSPEC-178"
|
|
15
|
+
xspec: "XSPEC-178, XSPEC-444, XSPEC-470"
|
|
16
16
|
description: AI-era full coverage paradigm — cost of writing tests equals cost of writing code, so there is no reason to set lower thresholds for any test layer.
|
|
17
17
|
|
|
18
18
|
rationale: |
|
|
@@ -73,22 +73,60 @@ standard:
|
|
|
73
73
|
- id: no-tautology-assertions
|
|
74
74
|
trigger: writing any test assertion
|
|
75
75
|
instruction: |
|
|
76
|
-
FORBIDDEN: Tautology assertions that
|
|
77
|
-
These add false coverage without verifying anything.
|
|
76
|
+
FORBIDDEN: Tautology assertions — assertions that cannot disagree with the implementation.
|
|
77
|
+
These add false coverage without verifying anything. Two kinds:
|
|
78
|
+
1. Always true: expect(true).toBe(true), assert 200 == 200.
|
|
79
|
+
2. Not independent (XSPEC-470): the expected value is produced by the code under test,
|
|
80
|
+
or by the same logic written a second time in the test. In `verification-oracle`
|
|
81
|
+
terms the assertion's oracle IS the implementation. Do not define "independent
|
|
82
|
+
truth" here: use that standard's (a registered ground-truth case, a known literal,
|
|
83
|
+
a hand-computed example, or the specification).
|
|
84
|
+
NOT tautologies, do not report: a before/after comparison of state taken at different
|
|
85
|
+
moments; a comparison against a second, independently written implementation; two calls
|
|
86
|
+
compared in a test that is named for determinism/idempotence/caching/identity.
|
|
78
87
|
AI SKELETON RULE (XSPEC-220): When generating unimplemented test skeletons,
|
|
79
88
|
use it.todo("AC-XXX: Given ... When ... Then ..."). Any it() callback whose
|
|
80
89
|
body contains only tautology assertions is an [ANTI-FAKE-001] violation,
|
|
81
90
|
regardless of whether the skeleton was generated by a human or an AI agent.
|
|
82
91
|
priority: required
|
|
92
|
+
references:
|
|
93
|
+
- verification-oracle # defines "oracle"; this rule does not redefine it
|
|
83
94
|
forbidden_patterns:
|
|
84
95
|
- "expect(true).toBe(true)"
|
|
85
96
|
- "expect(false).toBe(false)"
|
|
86
97
|
- "expect(result).toBeDefined() // without specific value"
|
|
87
98
|
- "expect(result).not.toBeNull() // without specific value"
|
|
88
99
|
- "it('...', () => { expect(true).toBe(true) }) // AI-generated skeleton"
|
|
100
|
+
- "expect(total(items)).toBe(total(items)) // same call, same arguments on both sides"
|
|
101
|
+
- "expect(total(items)).toBe(items.reduce(...)) // expected value recomputed from the same input"
|
|
89
102
|
required_instead: |
|
|
90
103
|
Real assertion: expect(result).toBe(<specific expected value>)
|
|
104
|
+
An expected value decided before the code ran: a literal, a hand-computed example, the spec.
|
|
91
105
|
Unimplemented skeleton: it.todo("AC-XXX: Given ... When ... Then ...")
|
|
106
|
+
machine_checked_subset:
|
|
107
|
+
script: scripts/check-anti-fake-tests.mjs
|
|
108
|
+
languages: [javascript, typescript]
|
|
109
|
+
shapes:
|
|
110
|
+
same-call: "both sides are the same call with the same arguments (no other call or new inside it) in one statement; test not named for comparing two calls"
|
|
111
|
+
recomputed: "expected value runs the call's own input through reduce/map/flatMap/filter, with a callback that uses only its own parameters (plus pure built-ins such as Math/Number/String), holds no literal and is not a mere copy ((x) => x, (x) => ({ ...x })); the call under test is one call, with no other call or new inside it and nothing after it such as .length. Only the text of the assertion is read: a name set on an earlier line is never looked through"
|
|
112
|
+
reported_when: "none of the test's assertions is a real one (same rule as expect(true).toBe(true))"
|
|
113
|
+
undecidable: "stays silent; left to the reviewer (when in doubt, miss it rather than accuse it)"
|
|
114
|
+
accepted_costs:
|
|
115
|
+
- "Differential tests are named: expect(fastTotal(items)).toBe(items.reduce(...)) with a reference implementation as oracle looks like the textbook example. Settle it with one assertion against a hand-computed literal in the same test, or list the file under `ignore` in .standards/test-policy.json (whole file, no reason field). A test name does not exempt it and the `exempt` list does not apply to this scanner."
|
|
116
|
+
- "Easy to get around: wrapping the VALUE UNDER TEST in Number(...), adding .valueOf() or [0] to it, or passing items.slice() each stop the scanner from seeing it (doing the same to the EXPECTED value changes nothing: it is still named). It is a prompt for the reviewer, not a gate against deliberate avoidance (an AI agent writing the test included); a clean scan is not evidence that expected values are independent."
|
|
117
|
+
left_alone_on_purpose:
|
|
118
|
+
- "expect(priceOf(ids)).toEqual(ids.map(id => KNOWN_PRICES[id])) // lookup in a fixed table is an independent source"
|
|
119
|
+
- "expect(activeOf(users)).toEqual(users.filter(u => u.id === 2)) // a literal in the callback is knowledge the test author supplied"
|
|
120
|
+
- "expect(render(now())).toBe(render(now())) // a call inside the call: two now() are two values"
|
|
121
|
+
- "expect(parse(serialize(rows))).toEqual(rows.map(r => r)) // a call inside the call under test: a round trip"
|
|
122
|
+
- "expect(clone(input)).toEqual(input.map(x => x)) // a callback that only returns its parameter, shallow-copies it (u => ({ ...u })) or puts a destructured parameter back in the same shape (([k, v]) => [k, v]), is a copy; filter(x => x) selects by truthiness (logic) but is left alone with them"
|
|
123
|
+
- "const before = items.map(i => i.price); freezeCart(items); expect(pricesOf(items)).toEqual(before) // a name set on an earlier line is a value from an earlier moment; never looked through"
|
|
124
|
+
- "expect(sortUsers(users).length).toBe(users.filter(u => u.name).length) // the value under test is a property of the result"
|
|
125
|
+
- "expect(countInstalled(manifest)).toBe(manifest.standards.filter(...).length) // input reached through a field: reviewer's call, not matched"
|
|
126
|
+
reviewer_questions:
|
|
127
|
+
- "Where did this expected value come from? Could it be produced by running the code under test?"
|
|
128
|
+
- "Would this test still pass if the implementation were wrong in the way the test's own arithmetic is wrong?"
|
|
129
|
+
- "Is the oracle a hand-written loop, a wrapper around the implementation, or a snapshot of the implementation's own first output?"
|
|
92
130
|
|
|
93
131
|
- id: no-mock-business-logic
|
|
94
132
|
trigger: deciding what to mock
|
|
@@ -180,6 +218,32 @@ standard:
|
|
|
180
218
|
trigger: '"// WARNING: STUB" marker found in src/'
|
|
181
219
|
message: "[STUB-WARN] STUB markers found. Must remove before merging to main."
|
|
182
220
|
|
|
221
|
+
# XSPEC-444 R2 + R5: what UDS itself ships so these rules are not only prose.
|
|
222
|
+
# Everything here WARNS by default; `mode: block` in the policy file tightens it.
|
|
223
|
+
shipped_gates:
|
|
224
|
+
default_mode: warn
|
|
225
|
+
policy_file: ".standards/test-policy.json" # optional; every list adds to the defaults
|
|
226
|
+
scripts: # written to scripts/ by `uds init`; never overwritten
|
|
227
|
+
- file: scripts/check-anti-fake-tests.mjs
|
|
228
|
+
finds: [no-assertion, tautology, all-skipped] # tautology: always-true, plus (JS/TS, XSPEC-470) same-call and recomputed expected values
|
|
229
|
+
exit: "0 clean | 1 findings | 2 could not judge (never a pass)"
|
|
230
|
+
- file: scripts/check-stubs.mjs
|
|
231
|
+
finds: [stub-marker, not-implemented, empty-function]
|
|
232
|
+
exit: "0 clean | 1 findings | 2 could not judge (never a pass)"
|
|
233
|
+
pre_commit_checks: # run by `uds check` on what is staged
|
|
234
|
+
- id: code-without-test
|
|
235
|
+
finds: "code files changed and no test file changed in the same commit"
|
|
236
|
+
exempt: ["pure rename (git R100)", "policy exempt entry WITH a reason"]
|
|
237
|
+
- id: unclassified-file
|
|
238
|
+
finds: "a changed file of a type UDS does not recognise — listed, never assumed fine, never blocks"
|
|
239
|
+
language_coverage:
|
|
240
|
+
test_files: [javascript, typescript, python, java, kotlin, scala, csharp, go, rust, ruby, elixir, php, swift, dart, lua, cpp]
|
|
241
|
+
empty_function: [javascript, typescript, python, go, rust, ruby, php]
|
|
242
|
+
other_languages: "listed as NOT scanned — never counted as clean"
|
|
243
|
+
not_implemented_yet:
|
|
244
|
+
- "ratchet on the number of unpaired changes (spec does not define the baseline location or unit)"
|
|
245
|
+
- "per-commit exemption reason (a pre-commit hook cannot read the commit message)"
|
|
246
|
+
|
|
183
247
|
migration_from_pyramid:
|
|
184
248
|
deprecated:
|
|
185
249
|
- "UT ≥ 80% coverage threshold"
|
|
@@ -225,7 +289,22 @@ standard:
|
|
|
225
289
|
|
|
226
290
|
physical_spec:
|
|
227
291
|
type: custom_script
|
|
292
|
+
# XSPEC-444 R5: this used to check that two scripts EXIST — scripts UDS did not ship.
|
|
293
|
+
# Now it RUNS them (`uds check --standard full-coverage-testing`); a missing script,
|
|
294
|
+
# or a scanner that exits non-zero, fails the check. The scanners' findings go to stderr
|
|
295
|
+
# (`stdio: ['ignore', 2, 2]`) because a failing validator's stdout is not shown. Inline Node
|
|
296
|
+
# keeps it portable.
|
|
228
297
|
validator:
|
|
229
298
|
command: >
|
|
230
|
-
|
|
231
|
-
|
|
299
|
+
node -e "
|
|
300
|
+
const fs=require('fs'),cp=require('child_process');
|
|
301
|
+
let bad=0;
|
|
302
|
+
for(const f of ['check-anti-fake-tests.mjs','check-stubs.mjs']){
|
|
303
|
+
const p='scripts/'+f;
|
|
304
|
+
if(!fs.existsSync(p)){console.error('MISSING: '+p+' (uds update offers to write it)');bad=1;continue}
|
|
305
|
+
const r=cp.spawnSync(process.execPath,[p],{stdio:['ignore',2,2]});
|
|
306
|
+
if(r.status!==0){console.error('FAILED: '+p+' exited with '+r.status);bad=1}
|
|
307
|
+
}
|
|
308
|
+
process.exit(bad)
|
|
309
|
+
"
|
|
310
|
+
rule: "full_coverage_gate_scripts_clean"
|
|
@@ -4,11 +4,11 @@
|
|
|
4
4
|
standard:
|
|
5
5
|
id: open-work-tracking
|
|
6
6
|
name: Open Work Tracking Standard
|
|
7
|
-
description:
|
|
7
|
+
description: 開放工作追蹤標準——承載開放工作的地方必須低摩擦收件、記錄解除條件、生成可推導欄位、印出分母、在回合結束時被檢視而不阻斷、把目標與進度分開並替目標的修改留痕、讓每個下一步點名具體對象、分得出「還沒問」與「已問、等回覆」、讓看不見的事實有一個帶戳記、可誠實寫成「未知」、年齡看得見的存放處,並讓等待可以用邏輯名稱點名另一個專案裡的東西、說清楚這台機器看不看得到它
|
|
8
8
|
|
|
9
9
|
meta:
|
|
10
|
-
version: "1.
|
|
11
|
-
updated: "2026-
|
|
10
|
+
version: "1.4.0"
|
|
11
|
+
updated: "2026-10-07"
|
|
12
12
|
source: core/open-work-tracking.md
|
|
13
13
|
description: >
|
|
14
14
|
三種不同的「工作不見了」的方式(沒地方記新想法、等待中沒有解除條件、
|
|
@@ -17,13 +17,26 @@ standard:
|
|
|
17
17
|
本標準管「離開之後抵達的那個承載庫,自己會不會腐壞」。
|
|
18
18
|
1.1.0 補兩個缺口:目標(意圖)與進度存放在不同載體、目標的修改要留痕(OWT-017/018);
|
|
19
19
|
下一步要點名具體對象(OWT-019)。
|
|
20
|
+
1.2.0 補兩個狀態:等待分成「還沒問」與「已問、等回覆」(OWT-020/021/022);
|
|
21
|
+
助理看不到的外部事實容許一個窄例外——手寫列附觀察者、觀察時間,值可誠實寫成未知,
|
|
22
|
+
年齡一律顯示(OWT-023/024/025/026)。
|
|
23
|
+
1.3.0 補兩件事:等待可以用邏輯名稱點名另一個專案裡的東西,並分成已解除/尚未解除/從這裡看不到/需要人判斷四種回報,
|
|
24
|
+
紀錄放在每個相關專案的 session 都讀得到、受版本控制的地方(OWT-027/028/029);
|
|
25
|
+
「下一步」詞彙補上三個明確同義詞、採用者可宣告自己的詞(不新增要求編號,OWT-019 與 OWT-016 的具體作法)。
|
|
26
|
+
1.4.0 不新增要求編號:處於 asked-awaiting 並滿足 OWT-022 的項目,其下一步可以就是等待的那個回覆,由 OWT-022 判定、不由 OWT-019 判定
|
|
27
|
+
(第四種結果 waiting-on-reply,單獨計數、顯示年齡、不算已點名也不算完成;next-action 與 waiting 以同一個函式讀同一列,不會給相反結論);
|
|
28
|
+
並補一段說明:OWT-007 的摘要可由程式在回合結束時印出、完整版按需取得(不新增要求、不新增檢查)。
|
|
20
29
|
|
|
21
30
|
iron_law: >
|
|
22
31
|
一個承載開放工作的地方,必須:不要求分類就能收下新項目、為每一個等待中項目記下解除條件、
|
|
23
32
|
對可推導的欄位改用生成、回報還剩什麼時同時揭露看不到什麼、
|
|
24
33
|
在控制權從 agent 交回人的那一刻被檢視——而且那個檢視不能讓回合失敗;
|
|
25
34
|
把「這份工作為了什麼」與「做到哪了」分開存放並替前者的每次修改留下交代;
|
|
26
|
-
|
|
35
|
+
讓每一個「下一步」都點名一個讀的人找得到的東西;
|
|
36
|
+
分得出「還沒問」與「已問、等回覆」,並讓看不見的事實有一個帶戳記的存放處——
|
|
37
|
+
未知是正式的值、永遠不算完成,每筆觀察的年齡一律顯示;
|
|
38
|
+
讓一個等待可以用邏輯名稱點名另一個專案裡的東西、說明這台機器看不看得到它——看不到的單獨計數、
|
|
39
|
+
既不算已解除也不算零——並把那份紀錄放在每個相關專案的 session 都讀得到、受版本控制的地方。
|
|
27
40
|
|
|
28
41
|
# ── 寫法約束:先讀這一段,它拘束下面每一條 ────────────────────────────────
|
|
29
42
|
# 與 deferred-item-exit 受的是同一條約束(DEC-049),套用在下游一層:
|
|
@@ -38,6 +51,9 @@ standard:
|
|
|
38
51
|
- "一個回報數字與它看不到的部分之間的關係"
|
|
39
52
|
- "控制權交回人的那一點存在一個確認點,且它永不阻斷"
|
|
40
53
|
- "一次目標的修改與說明它的修訂紀錄之間必須存在的關係"
|
|
54
|
+
- "一個等待項目的狀態與「有沒有人問過」的紀錄之間必須存在的關係"
|
|
55
|
+
- "一筆手寫事實與它的戳記、值域、年齡之間必須存在的關係"
|
|
56
|
+
- "一個等待的解除條件與它所點名的另一個專案裡的物件之間必須存在的關係(邏輯名稱,不是目錄)"
|
|
41
57
|
inadmissible_how:
|
|
42
58
|
- "收件點是哪個 app、檔案或工單系統"
|
|
43
59
|
- "輪詢解除條件的排程器或機器人"
|
|
@@ -45,6 +61,8 @@ standard:
|
|
|
45
61
|
- "儀表板版面或報告範本"
|
|
46
62
|
- "用什麼 hook 系統、shell 或 cron 實作確認點"
|
|
47
63
|
- "哪一種版本控制系統、核可工具或檔案配置承載目標或其修訂紀錄"
|
|
64
|
+
- "訊息用哪個管道、哪個工具送出,或哪個系統記錄對方的回覆"
|
|
65
|
+
- "跨專案的紀錄存在哪一個 repo、哪一個工具的 session 之間怎麼傳訊(只規定它受版本控制、各方 session 讀得到)"
|
|
48
66
|
consequence: >
|
|
49
67
|
本標準不附帶任何閘門。它只說一個承載開放工作的地方必須具備什麼性質;
|
|
50
68
|
有沒有東西在檢查是採用專案的決定,而 OWT-014/OWT-015 是用來讓那個決定
|
|
@@ -67,7 +85,17 @@ standard:
|
|
|
67
85
|
- "目標/驗收條件/限制(意圖)與進度/下一步存在不同的載體;判準是結構(小節、欄位、型別化標記),不是檔名——更新進度不得需要碰目標"
|
|
68
86
|
- "目標或驗收條件每次被修改都留下「改了什麼、誰核可、為什麼」;沒有核可者的修改要在控制權交回人時列出來,不得靜默,但列出只是回報、永不阻斷"
|
|
69
87
|
- "「下一步」欄位至少點名一個具體對象——檔案路徑、測試名稱、指令或需求編號之一;只有動詞不算。這是結構判準,不判斷措辭好壞"
|
|
88
|
+
- "處於 asked-awaiting 並滿足 OWT-022(asked-at、在等什麼、解除事件齊全)的項目,其下一步可以就是等待的那個回覆:由 OWT-022 判定、不由 OWT-019 判定,回報為 waiting-on-reply——不算違反、不算已點名、不算完成,單獨列出並顯示年齡;缺任一項、not-yet-asked、其他狀態、寫成小節標題的下一步,照舊由 OWT-019 判定"
|
|
70
89
|
- "點名對象的辨認本身是樣式比對,涵蓋率明示為未知;回報三態(點名且已找到/點名但未找到/未點名),只有未點名是違反"
|
|
90
|
+
- "標為等待的項目要說明自己是「還沒問」(請求已草擬或已決定、尚未送出)還是「已問、等回覆」(已送出、沒有回音);兩者皆非的等待項目要被個別點名,不得併入總數、不得算成已完成"
|
|
91
|
+
- "「還沒問」的項目點名那份草稿或那個動作(沿用 OWT-019 的辨認);「已問、等回覆」的項目帶 asked-at,並滿足 OWT-002"
|
|
92
|
+
- "手寫列只容許用在承載庫無法從版控、規格標記或 CI 結果推導的事實;每一列帶 observed-by、observed-at,值為 yes/no/unknown。檢查只判定欄位存在且格式正確,絕不判定觀察為真"
|
|
93
|
+
- "unknown 是正式的值:單獨計數、單獨顯示,永遠不算完成;標為完成而值是 unknown 即違反"
|
|
94
|
+
- "每筆觀察顯示年齡;超過宣告門檻者回報為「觀察已舊」、另計、不算已確認。戳只說誰何時看到,不說現在仍然如此"
|
|
95
|
+
- "手寫例外不及於版控、規格標記或 CI 結果已能決定的欄位(OWT-003 仍成立);這靠一份主題詞表判定,涵蓋率未知"
|
|
96
|
+
- "等待的解除條件可以點名另一個專案裡的物件,寫成 <專案>:<物件>;專案是邏輯名稱,載體裡不得有機器專屬的絕對路徑;名稱對應哪個目錄宣告在載體之外"
|
|
97
|
+
- "對每個跨專案解除條件回報四種之一,單獨計數:已解除、尚未解除、從這裡看不到(不是已解除也不是零)、需要人判斷;查找只讀本機檔案與版本控制,不連網"
|
|
98
|
+
- "等著另一個專案的工作,其紀錄放在受版本控制、每個相關專案的 session 都讀得到的 repo;不得只放在個人的 AI 工具記憶;檢查不判定存放位置"
|
|
71
99
|
|
|
72
100
|
# ── R5 vs turn-completion-integrity:掛同一事件,行為刻意相反 ──────────────
|
|
73
101
|
vs_turn_completion_integrity:
|
|
@@ -86,6 +114,16 @@ standard:
|
|
|
86
114
|
開放工作非空幾乎永遠為真,所以本標準的確認點被設計成永不保留控制權。
|
|
87
115
|
ordering_when_co_located: "本標準先回報(OWT-009),即使該回合隨後被 TCI 擋下,回報仍然可見"
|
|
88
116
|
|
|
117
|
+
# ── 摘要由誰產生(OWT-007 的說明,1.4.0;不新增要求、不新增檢查)─────────────
|
|
118
|
+
summary_production:
|
|
119
|
+
owt_007_does_not_say: "誰產生摘要、摘要多長"
|
|
120
|
+
cheap_way: "由程式在回合結束時印出簡短摘要(掛在回合結束事件上的既有機制執行一個指令,不消耗模型 token),完整版在讀的人要看時才產生"
|
|
121
|
+
expensive_way: "由模型在每則回覆裡手工附一張完整的表:可行、滿足 OWT-007,但昂貴,不是本標準要求的做法"
|
|
122
|
+
still_applies: "OWT-008 與 OWT-009:程式只回報、永不阻斷,輸出排在任何阻斷式檢查的判決之前"
|
|
123
|
+
suggested_vocabulary: ["等人決策", "等外部(對方回覆)", "等 CI", "固定日期到期", "無人看管"] # 建議,非要求
|
|
124
|
+
external_example: "有一個採用專案這樣做;其檔案是私有的,所以不放連結;不屬於 UDS 套件,不保證相容"
|
|
125
|
+
honest_note: "UDS 沒有出貨任何產生 OWT-007 摘要的程式,本標準也沒有東西檢查它存在;本段不新增要求編號、不新增檢查"
|
|
126
|
+
|
|
89
127
|
# ── 錨點:走訪結構,不走訪措辭(與 DEX-007/DEX-008 同形狀)───────────────
|
|
90
128
|
anchors:
|
|
91
129
|
principle: "判定等待中/未分類/已丟棄,讀承載庫自己描述該狀態的結構欄位——狀態欄、型別化標記、小節標題——而非散文措辭"
|
|
@@ -134,10 +172,22 @@ standard:
|
|
|
134
172
|
why: "與一個弄丟它的 bug 無從分辨"
|
|
135
173
|
- pattern: "目標或驗收條件被改了,卻沒有「誰同意」的紀錄"
|
|
136
174
|
why: "「每一條驗收都滿足」依然為真,只是針對另一組條件;被改過的目標讀起來像一直這麼寫"
|
|
137
|
-
- pattern: "
|
|
175
|
+
- pattern: "把手寫的狀態檔當成版本控制或 CI 早已知道之事的真相"
|
|
138
176
|
why: "會過期,而比過期內容新的戳看不見"
|
|
139
177
|
- pattern: "下一步寫「繼續實作」或「處理剩下的」"
|
|
140
178
|
why: "沒有點名任何可以開始的東西;與被遺忘的項目無從分辨"
|
|
179
|
+
- pattern: "等待項目沒有任何「有沒有人問過」的紀錄"
|
|
180
|
+
why: "沒人送出的草稿與沒人回的請求看起來一模一樣;等待永遠不會讓前者解除"
|
|
181
|
+
- pattern: "手寫的「已寄出/已回覆/已核准」,沒有名字也沒有日期"
|
|
182
|
+
why: "與猜測無從分辨,過期時也沒有任何東西顯示"
|
|
183
|
+
- pattern: "一個沒有人能做的觀察,被算成「否」或已完成"
|
|
184
|
+
why: "看不到的事實被讀成不存在或已完成;unknown 是一個值,不是零"
|
|
185
|
+
- pattern: "對另一個專案的等待,用某一台機器的目錄記下來"
|
|
186
|
+
why: "換一台機器就是錯的、洩漏使用者名稱,同一份載體的兩個讀者也不再指同一個專案"
|
|
187
|
+
- pattern: "這台機器看不到的專案,被算成已解除或零"
|
|
188
|
+
why: "沒看過的被讀成做完了;「從這裡看不到」是它自己的一個計數"
|
|
189
|
+
- pattern: "等著另一個專案的工作,只放在某個人的 AI 工具記憶裡"
|
|
190
|
+
why: "另一個 session 與 CI 讀不到,檢查也沒有任何具名的載體可以判定"
|
|
141
191
|
|
|
142
192
|
rules:
|
|
143
193
|
- id: OWT-001
|
|
@@ -197,9 +247,49 @@ standard:
|
|
|
197
247
|
severity: error
|
|
198
248
|
severity_rationale: "失效是靜默的,而它只有一個時刻能被抓到——修改發生的那一刻;事後只剩被改過的文字可讀"
|
|
199
249
|
- id: OWT-019
|
|
200
|
-
rule: "
|
|
250
|
+
rule: "「下一步」欄位至少點名一個具體對象:檔案路徑、測試名稱、指令或需求編號之一;只有動詞不算。判定的是有沒有點名對象,不是措辭好壞。處於 asked-awaiting 並滿足 OWT-022 的項目不在這裡判定:它的下一步可以就是它等的那個回覆,由 OWT-022 判定(何時問的、在等什麼、什麼事件解除它)"
|
|
201
251
|
severity: warning
|
|
202
252
|
severity_rationale: "「有點名對象」的結構檢查必然粗糙(被點名的對象仍可能無關),違反的代價是下一個工作階段的時間,不是工作本身"
|
|
253
|
+
- id: OWT-020
|
|
254
|
+
rule: "標為等待中的項目說明自己處於兩個狀態中的哪一個:not-yet-asked(請求已草擬或已決定要問,尚未送出)或 asked-awaiting(已送出、還沒有回音);兩者皆非的等待項目,在開放工作摘要裡被個別點名,不被併入總數、不被算成已完成"
|
|
255
|
+
severity: warning
|
|
256
|
+
severity_rationale: "狀態詞與欄位名是第一版詞彙,沒有量測支持(OWT-016);違反的代價是讀的人的時間。更嚴會讓所有早於這兩個狀態的載體在發布當天變紅"
|
|
257
|
+
- id: OWT-021
|
|
258
|
+
rule: "not-yet-asked 的項目點名那份草稿或那個動作(送出它就是解除條件):檔案路徑、指令、測試名稱或需求編號之一(沿用 OWT-019 的辨認)"
|
|
259
|
+
severity: warning
|
|
260
|
+
severity_rationale: "與 OWT-019 同理:「有點名對象」的檢查必然粗糙,違反的代價是下一個工作階段的時間"
|
|
261
|
+
- id: OWT-022
|
|
262
|
+
rule: "asked-awaiting 的項目帶 asked-at(含年份的日曆日、不晚於今天),並滿足 OWT-002:在等什麼、什麼事件算解除"
|
|
263
|
+
severity: warning
|
|
264
|
+
severity_rationale: "asked-at 讓時鐘開始走;缺它的代價是項目沒有年齡、無法被門檻再次浮現,但不是工作本身遺失"
|
|
265
|
+
- id: OWT-023
|
|
266
|
+
rule: "手寫列只容許用在承載庫無法從版控、規格標記或 CI 結果推導的事實;每一列帶 observed-by(誰或什麼看到)、observed-at(含年份的日曆日、不晚於今天)與 yes/no/unknown 的值,缺任一項即違反。檢查只判定欄位存在且格式正確,絕不判定觀察為真"
|
|
267
|
+
severity: warning
|
|
268
|
+
severity_rationale: "這是對 OWT-003 的窄例外,詞彙未校準;它判定的是欄位存在,不是觀察誠實,所以違反的傷害是間接的"
|
|
269
|
+
- id: OWT-024
|
|
270
|
+
rule: "unknown 是值,不是空白:值為 unknown 的列在任何摘要裡單獨計數、單獨顯示,永遠不被算成完成;標為完成而值是 unknown 的列即違反"
|
|
271
|
+
severity: warning
|
|
272
|
+
severity_rationale: "OWT-006 的延伸(看不到的不是零);詞彙未校準,故 warning"
|
|
273
|
+
- id: OWT-025
|
|
274
|
+
rule: "觀察的彙總顯示每筆觀察的年齡;超過宣告門檻的觀察回報為「觀察已舊」、另計、不被算成已確認。戳只說誰何時看到,不說現在仍然如此"
|
|
275
|
+
severity: warning
|
|
276
|
+
severity_rationale: "門檻的預設(7 天)是初始判斷,沒有量測支持(OWT-016)"
|
|
277
|
+
- id: OWT-026
|
|
278
|
+
rule: "OWT-023 的例外不及於版控、規格標記或 CI 結果已能決定的欄位;OWT-003 仍成立。檢查只能拿一份這類主題的詞表判定,其涵蓋率未知(OWT-011)"
|
|
279
|
+
severity: warning
|
|
280
|
+
severity_rationale: "判定靠措辭詞表,必然漏;乾淨的通過不代表沒有可推導的手寫列"
|
|
281
|
+
- id: OWT-027
|
|
282
|
+
rule: "等待項目的解除條件(OWT-002)可以點名另一個專案裡的物件,寫成 <專案>:<物件>。專案是邏輯名稱(uds、vibeops),不是目錄;物件是檔案路徑、測試名稱、指令或需求編號(OWT-019 的辨認)或版本控制標籤;載體裡沒有任何機器專屬的絕對路徑。名稱在某台機器上對應哪個目錄,宣告在載體之外。在等這種物件的項目沒有可被問的請求,所以 OWT-020 的兩個狀態不適用於它"
|
|
283
|
+
severity: warning
|
|
284
|
+
severity_rationale: "名稱樣式、機器專屬路徑前綴清單是第一版判斷(OWT-016),涵蓋率未知(OWT-011);違反的代價是紀錄在另一台機器上失效,不是工作本身遺失"
|
|
285
|
+
- id: OWT-028
|
|
286
|
+
rule: "對每一個這樣的解除條件,檢查回報四種之一並單獨計數、絕不合併:已解除(該物件現在在對方專案裡存在)、尚未解除(專案看得到、物件不在)、從這裡看不到(這台機器看不到那個專案:不是已解除,也不是零)、需要人判斷(專案看得到,但這類物件——測試名稱、指令、需求編號——沒有任何檢查讀得到的東西)。查找只讀本機檔案與版本控制,不開任何網路連線"
|
|
287
|
+
severity: warning
|
|
288
|
+
severity_rationale: "OWT-006 的延伸(看不到的不是零);能查找的物件種類只有路徑與標籤,是初始判斷(OWT-016)"
|
|
289
|
+
- id: OWT-029
|
|
290
|
+
rule: "等著另一個專案的工作,其紀錄是受版本控制、每個相關專案的 session 都讀得到的 repo 裡的一個檔案;不得只放在個人的 AI 工具記憶裡(它綁一個使用者、一台機器,另一個 session 與 CI 讀不到)。用哪個 repo 是採用專案的選擇。參考檢查不判定載體放在哪裡"
|
|
291
|
+
severity: warning
|
|
292
|
+
severity_rationale: "存放位置是採用專案的決定;違反的代價是另一個 session 看不到那份等待,但不是工作本身遺失"
|
|
203
293
|
|
|
204
294
|
# ── 意圖 vs 進度(OWT-017/018/019)──────────────────────────────────────
|
|
205
295
|
intent_vs_progress:
|
|
@@ -217,14 +307,93 @@ standard:
|
|
|
217
307
|
- named_and_resolved
|
|
218
308
|
- named_unresolved
|
|
219
309
|
- unnamed # 唯一的違反
|
|
310
|
+
- waiting_on_reply # 1.4.0:asked-awaiting 且 OWT-022 齊全;不是違反、不算已點名、不算完成
|
|
311
|
+
waiting_on_reply:
|
|
312
|
+
applies_when: "項目是 asked-awaiting,而且 OWT-020 與 OWT-022 對它沒有任何違反(asked-at 為含年份、不晚於今天的日期;寫了在等什麼;寫了解除事件)"
|
|
313
|
+
judged_by: "OWT-022,不是 OWT-019;next-action 以 waiting 所用的同一個函式(同一個日期)讀該列的狀態,不另寫一份"
|
|
314
|
+
reported_as: "單獨計數(計數行尾附 waiting-on-reply=N,N 為 0 時不印)、自己的一節(列名、年齡、在等什麼、解除條件)、不算已點名、不算完成"
|
|
315
|
+
stale: "年齡超過宣告門檻者標為已舊;沿用 OWT-025 的預設 7 天(--stale-after 宣告),未校準;只標示,不影響結束碼"
|
|
316
|
+
not_waived:
|
|
317
|
+
- "沒有 asked-at、asked-at 不是日期、asked-at 在未來"
|
|
318
|
+
- "沒寫在等什麼、沒寫解除事件"
|
|
319
|
+
- "not-yet-asked(它的下一步是送出草稿,OWT-021 要求點名草稿)"
|
|
320
|
+
- "其他狀態(含 waiting 卻沒說問過沒有)"
|
|
321
|
+
- "寫成小節標題的下一步(沒有狀態欄的一列可言)"
|
|
322
|
+
- "沒有狀態欄的載體(讀法與 1.3.0 完全相同)"
|
|
323
|
+
invariant: "對任一列:waiting 判為 asked-awaiting 且沒有 OWT-020/OWT-022 違反 ⇔ next-action 判為 waiting-on-reply;waiting 對它報 OWT-022 時,next-action 不得免除它"
|
|
324
|
+
exit_code_change: "含這種列的載體,next-action 對該列不再回 1(過去因未點名回 1)"
|
|
325
|
+
not_decidable_by_a_check: "請求是否真的送出、是否仍未回覆——只判定欄位存在且格式正確(OWT-014,同 OWT-023)"
|
|
220
326
|
coverage: "辨認路徑/指令/測試名稱/編號本身是樣式比對,涵蓋率未知(OWT-011);認不出的格式回報為未點名"
|
|
327
|
+
fields_read: "參考程序以同一份詞彙讀三種形狀:小節標題、行內標籤、表頭在詞彙內的表格欄(該欄每一列各算一個欄位)"
|
|
328
|
+
ragged_table_row: "欄數與表頭不一致的列列為判定不了、不當成空白;別處沒有違反時結束碼為 2(不是通過)"
|
|
329
|
+
empty_field: "空白、—、-、已完成的儲存格只計數不評估,不算違反(OWT-019 判斷寫了的下一步,沒寫是另一種失效)"
|
|
330
|
+
|
|
331
|
+
# ── 兩個等待前狀態與助理看不到的事實(OWT-020~026,1.2.0)────────────────
|
|
332
|
+
waiting_and_observed:
|
|
333
|
+
states:
|
|
334
|
+
not_yet_asked:
|
|
335
|
+
meaning: "請求已草擬或已決定要問,尚未送出"
|
|
336
|
+
must_name: "那份草稿或那個動作(檔案路徑、指令、測試名稱或需求編號;沿用 OWT-019 的辨認)"
|
|
337
|
+
released_by: "送出"
|
|
338
|
+
asked_awaiting:
|
|
339
|
+
meaning: "已送出,還沒有回音"
|
|
340
|
+
must_carry: [asked_at, waiting_for, release_event] # 後兩者即 OWT-002
|
|
341
|
+
neither: "標為等待卻不屬於這兩者:被個別點名(比照 OWT-012),不併入總數,不算已完成"
|
|
342
|
+
observed_fact:
|
|
343
|
+
admitted_only_for: "承載庫無法從版控、規格標記或 CI 結果推導的事實(例:是否已寄出、對方是否已回覆、是否已核准)"
|
|
344
|
+
row_fields: [observed_by, observed_at, value]
|
|
345
|
+
value_domain: [yes, no, unknown]
|
|
346
|
+
unknown: "正式的值:單獨計數、單獨顯示、永遠不算完成;標為完成而值是 unknown 即違反"
|
|
347
|
+
age: "每筆觀察顯示年齡;超過宣告門檻者為「觀察已舊」,另計,不算已確認"
|
|
348
|
+
stamp_claims: "誰、何時看到;不宣稱現在仍然如此"
|
|
349
|
+
not_reaching: "版控、規格標記或 CI 結果已能決定的欄位(OWT-003 仍成立)"
|
|
350
|
+
decidable_by_a_check: "欄位是否存在、日期是否為含年份的真實日子且不晚於今天、值是否在值域內、年齡、狀態詞"
|
|
351
|
+
not_decidable_by_a_check: "observed-by 填的是不是真的去看過的人、值是否為真、以及它現在是否仍然如此——這是關於世界的宣稱,不是 artefact 之間的關係(OWT-014)"
|
|
352
|
+
coverage: "狀態詞與欄位名(中英文)、可推導主題詞表皆為措辭比對,涵蓋率未知(OWT-011);沒有 observed-by 也沒有 observed-at 欄的表格不被讀成觀察載體"
|
|
353
|
+
time: "今天的日期由 --now 注入,絕不在規則裡讀時鐘;門檻由 --stale-after 宣告,預設 7 天為未校準的初始判斷(OWT-016)"
|
|
354
|
+
exit_codes: "任何違反(含 warning 等級)結束碼為 1;判定不了為 2(不是通過)"
|
|
355
|
+
|
|
356
|
+
# ── 對另一個專案的等待(OWT-027~029,1.3.0)──────────────────────────────
|
|
357
|
+
cross_project_waiting:
|
|
358
|
+
reference_form: "<專案>:<物件>,專案是邏輯名稱(小寫字母、數字、- 與 _,以字母開頭,2 到 32 字元),物件是檔案路徑、測試名稱、指令、需求編號或版本控制標籤"
|
|
359
|
+
carrier_must_not_hold: "機器專屬的絕對路徑(家目錄與磁碟區目錄、磁碟機代號、~/、UNC 路徑、file: URL)與離開該專案的路徑(..)"
|
|
360
|
+
name_to_directory: "宣告在載體之外:參考檢查的 --root NAME=DIR(可重複,與單一 --root DIR 並存),或採用專案設定的 open_work.projects"
|
|
361
|
+
answers: [released, not_yet_released, not_visible_from_here, needs_a_person]
|
|
362
|
+
not_visible_from_here: "這台機器看不到該專案(沒有宣告目錄、目錄不存在、讀不到版本控制):單獨計數,不是已解除,也不是零"
|
|
363
|
+
machine_observable: "檔案路徑(存在與否)與版本控制標籤(存在與否);其餘種類回報為需要人判斷"
|
|
364
|
+
waiting_state: "在等另一個專案之物件的項目免於 OWT-020 的兩個狀態,單獨計數為 waiting-cross-project,仍被點名"
|
|
365
|
+
record_location: "受版本控制、每個相關專案的 session 都讀得到的 repo;不得只放個人 AI 工具記憶;檢查不判定(OWT-029)"
|
|
366
|
+
scope: "一個人在一台機器上的各個 session;跨人共享與共享紀錄的審核不在本版決定"
|
|
367
|
+
decidable_by_a_check: "邏輯名稱樣式、有無機器專屬路徑、路徑或標籤在本機是否存在"
|
|
368
|
+
not_decidable_by_a_check: "被點名的物件是不是對的那一個、測試或指令是否通過、紀錄存在哪個 repo、誰讀得到(OWT-014)"
|
|
369
|
+
network: "不連網:只讀本機檔案與 git"
|
|
370
|
+
|
|
371
|
+
# ── 「下一步」詞彙(461,併入 1.3.0,不新增要求編號)────────────────────────
|
|
372
|
+
next_action_words:
|
|
373
|
+
one_list: "一份清單,三種讀法(標題、表頭、行內標籤),沒有第二份;採用者宣告的詞併入同一份"
|
|
374
|
+
built_in: ["next action/next step", "下一步", "下一動", "回來要做什麼", "下一個動作", "下一個步驟", "接下來要做什麼"]
|
|
375
|
+
deliberately_absent: ["待辦", "後續", "Next", "TODO", "Action", "接下來"]
|
|
376
|
+
why_absent: "這些詞也標在不是下一步的欄位上;讀成下一步會讓違反藏在一個從來不是下一步的欄位後面"
|
|
377
|
+
declared_by_adopter: "--next-action-word WORD(可重複),或採用專案設定的 open_work.next_action_words;兩者合併"
|
|
378
|
+
declared_word_is: "純文字、不分大小寫、子字串比對,不是正規表達式;空字串或只有空白被拒絕並說明,不被靜默忽略"
|
|
379
|
+
exit_2_explains: "完全找不到欄位時結束碼仍是 2;訊息列出每個載體看到的表頭與標題(約 20 個)、認得的詞(宣告的另列)、怎麼加,並分辨「有表格但表頭都不符」與「沒有表格也沒有標題可讀」"
|
|
380
|
+
uncalibrated: "內建清單與它拒絕收的詞都是初始判斷(OWT-016)"
|
|
381
|
+
command_words:
|
|
382
|
+
built_in_additions: ["glab", "dotnet"]
|
|
383
|
+
deliberately_absent: ["go", "make", "sh"]
|
|
384
|
+
declared_by_adopter: "--command-word PROGRAM(可重複),或採用專案設定的 open_work.command_words;next-action 與 waiting 都讀"
|
|
385
|
+
rule: "一個程式名,純文字、區分大小寫、不是正規表達式;空白或含空格的詞被拒絕並說明"
|
|
386
|
+
resolution_is_said:
|
|
387
|
+
what: "next-action 說路徑是在哪個目錄下查找的、那個目錄從哪來(--root 或目前目錄),載體在 git repo 之外又沒給 --root 時明說"
|
|
388
|
+
only_paths: "只有路徑會被查找;指令、測試名稱、需求編號只判定有沒有被指名,永遠不會是已解析"
|
|
389
|
+
split: "named-unresolved 分成 path-missing(查過、不在)與 not-resolvable(從不查找);兩者相加等於 named-unresolved,既有輸出行不變,只新增行"
|
|
221
390
|
|
|
222
391
|
# ── 刻意不採納(來源:使用者轉貼的提示詞,作者不明,僅借設計形狀)──────────
|
|
223
392
|
not_adopted:
|
|
224
393
|
source: "使用者轉貼的提示詞,作者與出處不明、無實作;僅借設計形狀,不引用其任何宣稱"
|
|
225
394
|
items:
|
|
226
|
-
- what: "
|
|
227
|
-
why: "手寫狀態會過期,而戳比過期內容新是隱形的(OWT-004/005 的起因);只說以版本控制為準卻沒有對帳機制,就是採納一個已知會過期的來源。OWT-003
|
|
395
|
+
- what: "以手寫狀態檔作為任何「已有可靠來源可決定」之狀態的真相"
|
|
396
|
+
why: "手寫狀態會過期,而戳比過期內容新是隱形的(OWT-004/005 的起因);只說以版本控制為準卻沒有對帳機制,就是採納一個已知會過期的來源。OWT-003 已要求可推導的欄位改用生成。自 1.2.0 起有一個窄例外(OWT-023~026):對沒有任何東西能推導的事實(訊息是否已寄出、對方是否已回覆),容許一列手寫——但必須附誰何時看到的戳記、值可以誠實是 unknown、且每份報告都顯示年齡,並且絕不及於版控、規格標記或 CI 結果已能決定的欄位。上面的反對理由是被回答了,不是被擱置:那個理由是過期看不見,而這裡年齡就印在每個值旁邊"
|
|
228
397
|
- what: "固定的開工儀式(讀檔→查版本控制→驗證)"
|
|
229
398
|
why: "交接點已由 OWT-007 與 turn-completion-integrity 管住;開工儀式要靠各代理工具自己的指示設定,寫進標準只會得到一條沒有任何 artefact 檢查判定得了的要求(違反 OWT-014)"
|
|
230
399
|
|
|
@@ -232,8 +401,11 @@ standard:
|
|
|
232
401
|
enforcement:
|
|
233
402
|
automated_gate: false
|
|
234
403
|
reference_check:
|
|
235
|
-
|
|
236
|
-
|
|
404
|
+
command: "uds open-work <next-action|revision|separation|waiting|observations|self-test>" # 隨 npm 安裝包出貨,採用者不需要 clone
|
|
405
|
+
path: cli/src/utils/open-work-tracking.mjs # 規則本體只有這一份
|
|
406
|
+
repo_entry: scripts/check-open-work-tracking.mjs # 只在 UDS repo 副本裡的薄殼,不含規則
|
|
407
|
+
next_action_options_1_4_0: "--now YYYY-MM-DD 與 --stale-after DAYS(與 waiting/observations 同義);next-action 以 waiting 的同一個函式讀每一列的狀態"
|
|
408
|
+
covers: [OWT-017, OWT-018, OWT-019, OWT-020, OWT-021, OWT-022, OWT-023, OWT-024, OWT-025, OWT-026, OWT-027, OWT-028] # OWT-029 靠採用專案自己決定,檢查不判定
|
|
237
409
|
status: "參考判定程序,作為 OWT-015 意義上的證據(已對違反樣本紅過);不是閘門,未接進任何 UDS 發版閘門,因為 UDS 沒有承載開放工作的地方可供檢查"
|
|
238
410
|
why_not: >
|
|
239
411
|
依上面的寫法約束,UDS 陳述關係,有沒有東西判定它是採用專案的決定。
|
|
@@ -254,6 +426,15 @@ standard:
|
|
|
254
426
|
added_in_1_1_0:
|
|
255
427
|
origin: "DEC-122(2026-09-29):一個採用專案裡,目標與進度沒分開、且一條驗收條件被改而無人核可紀錄;設計形狀借自使用者轉貼、作者不明的提示詞"
|
|
256
428
|
uncalibrated_per_owt_016: "參考判定程序用的標題詞彙、指令名清單、副檔名清單、需求編號樣式——全是初始判斷,沒有對照真實使用量測;採用專案應傳入自己的"
|
|
429
|
+
added_in_1_2_0:
|
|
430
|
+
origin: "XSPEC-459(2026-10-07):一個採用專案對 6.14.0-beta.5 的測試回報——草擬了從沒送出的訊息與已送出、沒人回的訊息分不出來;助理無法觀察的事實沒有被認可的存放處"
|
|
431
|
+
uncalibrated_per_owt_016: "中英文的狀態詞與欄位名、被當成可推導的主題詞表、「觀察已舊」預設的 7 天、日期的讀法(必須有年份、時間不看)——全是初始判斷,沒有對照真實使用量測;參考判定程序只有幾小時大、跑過的是人造樣本"
|
|
432
|
+
added_in_1_3_0:
|
|
433
|
+
origin: "XSPEC-460/XSPEC-461(2026-10-07):一個專案的項目在等另一個專案的產出,當時只有臨時約定;另有使用者的載體一個狀態一張表,next-action 回 2 卻沒說為什麼"
|
|
434
|
+
uncalibrated_per_owt_016: "邏輯名稱樣式、機器專屬路徑前綴、能查找的物件種類(路徑與標籤)、「下一步」內建詞與它拒絕收的詞——全是初始判斷,沒有對照真實使用量測;參考判定程序只有幾小時大、跑過的是人造樣本"
|
|
435
|
+
added_in_1_4_0:
|
|
436
|
+
origin: "XSPEC-464(2026-10-07):同一個採用專案對 6.14.0-beta.5 的測試——17 個下一步欄位中 14 個是「等對方回信/排時間/撤銷」,waiting 接受而 next-action 拒絕同一批列;該專案拒絕只為通過檢查而改寫載體"
|
|
437
|
+
uncalibrated_per_owt_016: "「已舊」沿用 OWT-025 的 7 天預設(未經量測)、判定 asked-awaiting 的狀態詞(同 OWT-020)——全是初始判斷;只寫了解除條件、沒寫問的日期的載體,補上日期之前仍由 OWT-019 判定"
|
|
257
438
|
recalibration: "由採用專案自行決定與自行訂定時程;本標準不承諾覆核日期,如同它不承諾閘門"
|
|
258
439
|
|
|
259
440
|
related:
|
|
@@ -278,4 +459,8 @@ physical_spec:
|
|
|
278
459
|
- "超過門檻仍未分類項目的個別點名,與已丟棄項目的一句理由"
|
|
279
460
|
- "目標/驗收條件與進度/下一步分屬不同載體(以結構判定)"
|
|
280
461
|
- "目標或驗收條件的每次修改對應一筆「改了什麼、誰核可、為什麼」紀錄;無核可者的修改在交回點被列出"
|
|
281
|
-
- "
|
|
462
|
+
- "每個「下一步」點名至少一個檔案路徑、測試名稱、指令或需求編號;已問、等回覆且 OWT-022 齊全的項目除外,它的下一步可以就是那個回覆(單獨列出、顯示年齡)"
|
|
463
|
+
- "每個等待項目標明「還沒問」或「已問、等回覆」;還沒問的點名草稿,已問的帶 asked-at、等什麼與解除事件"
|
|
464
|
+
- "助理看不到的事實的手寫列:observed-by、observed-at、yes/no/unknown 的值;unknown 與「觀察已舊」另計、永不算完成;每筆顯示年齡"
|
|
465
|
+
- "等著另一個專案的項目用 <專案>:<物件> 點名,載體沒有機器專屬路徑;每個這樣的條件回報已解除/尚未解除/從這裡看不到/需要人判斷之一,看不到的單獨計數"
|
|
466
|
+
- "等著另一個專案的工作,紀錄放在受版本控制、各方 session 都讀得到的 repo,不只放個人 AI 工具記憶"
|
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
standard:
|
|
9
9
|
id: pipeline-security-gates
|
|
10
10
|
name: Pipeline Security Gates
|
|
11
|
-
description: Security checkpoints embedded in CI pipeline — SAST, DAST, SCA, secrets scan with block/warn/log behavior
|
|
11
|
+
description: Security checkpoints embedded in CI pipeline — SAST, DAST, SCA, secrets scan (including the scanner's own output and failure behaviour) with block/warn/log behavior
|
|
12
12
|
guidelines:
|
|
13
13
|
- "Secrets scan at pre-commit — block ALL commits containing secrets"
|
|
14
14
|
- "SAST after build — block Critical/High findings"
|
|
@@ -17,10 +17,13 @@ standard:
|
|
|
17
17
|
- "DAST after staging deploy — warn on findings, require approval for Critical"
|
|
18
18
|
- "Never skip security gates with --force or emergency bypass without audit trail"
|
|
19
19
|
- "Treat security gate failures as pipeline failures, not warnings"
|
|
20
|
+
- "Secrets-scan output (terminal, CI log, report file) MUST NOT contain the matched secret value — name the file, line and rule only (PSG-1)"
|
|
21
|
+
- "A secrets scanner that cannot run (missing binary, unreadable or invalid config, timeout, unexpected exit) is a gate failure and MUST block — never swallow it with `|| true` or `2>/dev/null` (PSG-2)"
|
|
22
|
+
- "SHOULD: every detection rule the team writes itself has one red sample (must match) and one green sample (must not match), run in tests (PSG-3)"
|
|
20
23
|
|
|
21
24
|
meta:
|
|
22
|
-
version: "1.
|
|
23
|
-
updated: "2026-
|
|
25
|
+
version: "1.1.0"
|
|
26
|
+
updated: "2026-10-07"
|
|
24
27
|
source: core/pipeline-security-gates.md
|
|
25
28
|
complements: security-standards.ai.yaml
|
|
26
29
|
|
|
@@ -31,6 +34,48 @@ gate_positions:
|
|
|
31
34
|
scope: "staged files"
|
|
32
35
|
block_on: ["any secret pattern match"]
|
|
33
36
|
never_skip: true
|
|
37
|
+
# Added in 1.1.0 (XSPEC-463): the scanner's own behaviour. UDS ships no scanner —
|
|
38
|
+
# these are properties the adopter verifies on their own gate, by the procedures below.
|
|
39
|
+
output_redaction: # PSG-1
|
|
40
|
+
level: must
|
|
41
|
+
rule: "scan output must not contain the matched secret value; name file, line and rule only"
|
|
42
|
+
surfaces: ["terminal", "ci log", "report file"]
|
|
43
|
+
reason: "scan logs get pasted into chat and tickets; printing the value leaks an already-blocked secret a second time"
|
|
44
|
+
tool_notes:
|
|
45
|
+
gitleaks: "official README (read 2026-10-07): sample output of `gitleaks git -v` without --redact prints a `Secret:` line with the matched value; --redact is described as 'redact secrets from logs and stdout'; the README does not say whether it also covers --report-path files — adopter must confirm"
|
|
46
|
+
detect-secrets: "default output behaviour not verified by this standard — adopter must confirm"
|
|
47
|
+
trufflehog: "default output behaviour not verified by this standard — adopter must confirm"
|
|
48
|
+
verification:
|
|
49
|
+
- "stage a file containing a FAKE secret in a format the adopter's own gate matches (FAKE-SECRET-DO-NOT-USE-0000 is notation only; never a valid credential for any real service) and run the gate"
|
|
50
|
+
- "first confirm the gate really blocked — if it did not, the sample was not matched and step 3 proves nothing"
|
|
51
|
+
- "search ALL output (terminal, ci log, report file) for the fake string; any hit is non-compliant"
|
|
52
|
+
scanner_failure: # PSG-2
|
|
53
|
+
level: must
|
|
54
|
+
treat_as: gate_failure
|
|
55
|
+
action: block
|
|
56
|
+
covers: ["executable missing", "config unreadable or invalid", "timeout", "unexpected exit"]
|
|
57
|
+
forbidden_swallow: ["|| true", "2>/dev/null"]
|
|
58
|
+
distinguish_cause_by: output # not by exit code
|
|
59
|
+
tool_notes:
|
|
60
|
+
gitleaks: "official README, Exit Codes (read 2026-10-07): `1 - leaks or error encountered` — a finding and an error share exit code 1, so tell them apart by output; --exit-code can rewrite the exit code for findings, never set it to 0"
|
|
61
|
+
detect-secrets: "exit-code behaviour not verified by this standard — adopter must confirm"
|
|
62
|
+
trufflehog: "exit-code behaviour not verified by this standard — adopter must confirm"
|
|
63
|
+
precedent: "UDS native .git/hooks/pre-commit once chained every check with `2>/dev/null || true` and printed 'passed' (fixed in 6.14.0-beta.4, see CHANGELOG)"
|
|
64
|
+
verification:
|
|
65
|
+
- "rename or remove the scanner executable, or make its config invalid"
|
|
66
|
+
- "run the gate on a commit that contains no secret (any block can then only be the scanner failing to run)"
|
|
67
|
+
- "pass = blocked, non-zero exit, output says the scanner could not run; a commit let through, or output that reads like a pass, is non-compliant"
|
|
68
|
+
custom_rule_samples: # PSG-3
|
|
69
|
+
level: should
|
|
70
|
+
applies_to: "detection rules the team wrote itself, including the REQ-003 minimum four (AWS access key, PEM private key header, generic API token, connection string with password); not to teams using only built-in rules"
|
|
71
|
+
per_rule: ["one red sample that must match", "one green sample that must not match"]
|
|
72
|
+
samples_run_in_tests: true
|
|
73
|
+
principle: "OWT-015 — a check never observed red is not evidence"
|
|
74
|
+
gap_blocks: false # SHOULD: a missing sample is a reported gap, not a block
|
|
75
|
+
verification:
|
|
76
|
+
- "list every self-written rule"
|
|
77
|
+
- "find each rule's red and green sample (fake values)"
|
|
78
|
+
- "confirm the samples really run in tests; a missing one is a gap"
|
|
34
79
|
post_build:
|
|
35
80
|
type: sast
|
|
36
81
|
tools: ["semgrep", "codeql", "sonarqube"]
|
|
@@ -81,5 +126,9 @@ integration_points:
|
|
|
81
126
|
physical_spec:
|
|
82
127
|
type: custom_script
|
|
83
128
|
validator:
|
|
84
|
-
|
|
129
|
+
# Fail-closed (XSPEC-444 R1 class sweep): the old form piped grep into `head -1`
|
|
130
|
+
# and fell back to `|| echo 'no-ci-pipeline'` — `head` always exits 0, so the
|
|
131
|
+
# check passed even when no pipeline mentioned any security gate. -q makes grep's
|
|
132
|
+
# own exit status the verdict: 0 only when a gate keyword is found.
|
|
133
|
+
command: "grep -rqE 'secrets|sast|sca|dast' .github/workflows/ .gitlab-ci.yml Jenkinsfile 2>/dev/null"
|
|
85
134
|
rule: "security_gates_in_pipeline"
|
|
@@ -10,13 +10,23 @@ standard:
|
|
|
10
10
|
- "Inject context proactively during planning and coding phases based on file scope"
|
|
11
11
|
- "Store entries as Markdown files with YAML Frontmatter in .project-context/"
|
|
12
12
|
- "Use identified paths and specific names (unlike Developer Memory)"
|
|
13
|
+
- "Keep personal, cross-project, identifiable facts and cross-project work coordination out of the repository's project context (see boundary)"
|
|
13
14
|
|
|
14
15
|
meta:
|
|
15
|
-
version: "1.2.
|
|
16
|
-
updated: "2026-
|
|
16
|
+
version: "1.2.1"
|
|
17
|
+
updated: "2026-10-07"
|
|
17
18
|
source: core/project-context-memory.md
|
|
18
19
|
description: System for capturing, retrieving, and enforcing project-specific context, architectural decisions, and domain knowledge
|
|
19
20
|
|
|
21
|
+
boundary:
|
|
22
|
+
not_held_here:
|
|
23
|
+
- what: "個人、跨專案、可識別的資訊(誰負責什麼、怎麼連到某個環境)"
|
|
24
|
+
belongs_in: "使用者自己的 AI 工具記憶"
|
|
25
|
+
why: "專案情境在 repo 裡,會被每個 clone 它的人看到;這類資訊不是專案情境"
|
|
26
|
+
- what: "跨專案的工作協調(誰在等誰)"
|
|
27
|
+
belongs_in: "open-work-tracking(OWT-027~OWT-029)"
|
|
28
|
+
why: "那是開放工作,不是情境"
|
|
29
|
+
|
|
20
30
|
schema:
|
|
21
31
|
format: "Markdown with YAML Frontmatter"
|
|
22
32
|
required:
|