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
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
source: ../../../core/immutability-first.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: 3678885d6b73
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
@@ -10,99 +11,70 @@ status: current
|
|
|
10
11
|
|
|
11
12
|
> **語言**: [English](../../../core/immutability-first.md) | 繁體中文
|
|
12
13
|
|
|
13
|
-
|
|
14
|
-
**最後更新**: 2026-04-16
|
|
15
|
-
**適用範圍**: TypeScript 介面、資料流設計、並行系統
|
|
16
|
-
**Scope**: universal
|
|
17
|
-
**來源**: XSPEC-044
|
|
14
|
+
> **來源**: XSPEC-044 | **適用於**: TypeScript、並行系統
|
|
18
15
|
|
|
19
|
-
|
|
16
|
+
## 概述
|
|
20
17
|
|
|
21
|
-
|
|
18
|
+
不可變性優先(Immutability-First)是一項系統層級的設計原則,用以防止並行 Agent 環境中的競態條件。所有資料流介面(DTO / Value Object)都必須以 `readonly` 宣告欄位,陣列欄位必須使用 `ReadonlyArray<T>`,物件修改必須透過展開語法建立新物件,而非就地修改。
|
|
22
19
|
|
|
23
|
-
|
|
20
|
+
若缺乏此紀律,並行 Agent 編排(例如 `Promise.all` 批次執行)便有意外共享狀態的風險:某個 Agent 的修改會悄悄影響其他 Agent 所看到的同一個物件。
|
|
24
21
|
|
|
25
|
-
|
|
22
|
+
## 規則
|
|
26
23
|
|
|
27
|
-
|
|
24
|
+
| 規則 | 嚴重度 | 說明 |
|
|
25
|
+
|------|--------|------|
|
|
26
|
+
| **IMM-001** | required | DTO/Value Object 欄位必須為 `readonly` |
|
|
27
|
+
| **IMM-002** | required | 陣列欄位必須使用 `ReadonlyArray<T>`,而非 `T[]` |
|
|
28
|
+
| **IMM-003** | required | 修改時使用展開語法建立新物件 |
|
|
29
|
+
| **IMM-004** | required | 跨越並行邊界的物件必須為深層不可變 |
|
|
30
|
+
| **IMM-005** | recommended | 巢狀物件欄位以 `Readonly<T>` 包裝 |
|
|
28
31
|
|
|
29
|
-
##
|
|
32
|
+
## 範例
|
|
30
33
|
|
|
31
|
-
-
|
|
32
|
-
- 介面中的陣列型欄位使用 `ReadonlyArray<T>` 而非可變的 `T[]`
|
|
33
|
-
- 修改物件時使用物件展開語法建立新物件,不直接賦值給 `readonly` 欄位
|
|
34
|
-
- 跨並行邊界(`Promise.all` / Worker Thread)傳遞的物件必須為深層不可變
|
|
35
|
-
- 介面中的嵌套物件欄位使用 `Readonly<T>` 包裝(防止淺層保護不足)
|
|
36
|
-
|
|
37
|
-
---
|
|
34
|
+
### IMM-001:DTO 欄位 readonly
|
|
38
35
|
|
|
39
|
-
## 規則詳細說明
|
|
40
|
-
|
|
41
|
-
### IMM-001:DTO 欄位 readonly(必要)
|
|
42
|
-
|
|
43
|
-
資料流介面(Data Transfer Objects、Value Objects)的所有欄位必須宣告 `readonly`,防止並行 Agent 環境下的意外狀態共享與競態條件。
|
|
44
|
-
|
|
45
|
-
**錯誤範例**:
|
|
46
36
|
```typescript
|
|
37
|
+
// ❌ Bad
|
|
47
38
|
interface TaskResult {
|
|
48
|
-
status: TaskStatus
|
|
39
|
+
status: TaskStatus
|
|
49
40
|
cost_usd?: number
|
|
50
41
|
}
|
|
51
|
-
```
|
|
52
42
|
|
|
53
|
-
|
|
54
|
-
```typescript
|
|
43
|
+
// ✅ Good
|
|
55
44
|
interface TaskResult {
|
|
56
|
-
readonly status: TaskStatus
|
|
45
|
+
readonly status: TaskStatus
|
|
57
46
|
readonly cost_usd?: number
|
|
58
47
|
}
|
|
59
48
|
```
|
|
60
49
|
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
### IMM-002:陣列欄位 ReadonlyArray(必要)
|
|
50
|
+
### IMM-002:陣列欄位使用 ReadonlyArray
|
|
64
51
|
|
|
65
|
-
介面中的陣列型欄位使用 `ReadonlyArray<T>` 而非可變的 `T[]`,防止 `push`/`splice`/`sort` 等就地修改操作破壞共享陣列。
|
|
66
|
-
|
|
67
|
-
**錯誤範例**:
|
|
68
52
|
```typescript
|
|
53
|
+
// ❌ Bad
|
|
69
54
|
interface MemoryContext {
|
|
70
|
-
recentHistory: IterationRecord[] //
|
|
55
|
+
recentHistory: IterationRecord[] // push/splice can corrupt shared state
|
|
71
56
|
}
|
|
72
|
-
```
|
|
73
57
|
|
|
74
|
-
|
|
75
|
-
```typescript
|
|
58
|
+
// ✅ Good
|
|
76
59
|
interface MemoryContext {
|
|
77
60
|
readonly recentHistory: ReadonlyArray<IterationRecord>
|
|
78
61
|
}
|
|
79
62
|
```
|
|
80
63
|
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
### IMM-003:展開語法替代就地修改(必要)
|
|
84
|
-
|
|
85
|
-
修改物件時使用物件展開語法建立新物件,不直接賦值給 `readonly` 欄位,保留原始物件不變,同時建立可追蹤的修改歷程。
|
|
64
|
+
### IMM-003:以展開語法進行修改
|
|
86
65
|
|
|
87
|
-
**錯誤範例**:
|
|
88
66
|
```typescript
|
|
89
|
-
|
|
90
|
-
|
|
67
|
+
// ❌ Bad
|
|
68
|
+
options.sessionId = forkId // other holders see the change
|
|
91
69
|
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
const taskOptions = { ...options, sessionId: forkId } // ← 新物件
|
|
70
|
+
// ✅ Good
|
|
71
|
+
const taskOptions = { ...options, sessionId: forkId }
|
|
95
72
|
```
|
|
96
73
|
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
### IMM-004:並行邊界深層不可變(必要)
|
|
100
|
-
|
|
101
|
-
跨並行邊界(`Promise.all` / Worker Thread)傳遞的物件必須為深層不可變,並行執行中無法預測存取順序,可變共享物件必然產生競態條件。
|
|
74
|
+
### IMM-004:並行邊界的深層不可變
|
|
102
75
|
|
|
103
|
-
**正確範例**:
|
|
104
76
|
```typescript
|
|
105
|
-
//
|
|
77
|
+
// ✅ Good — each parallel task holds its own options snapshot
|
|
106
78
|
const batchResults = await Promise.all(
|
|
107
79
|
batch.map(task => {
|
|
108
80
|
const taskOptions = { ...baseOptions, sessionId: forkId }
|
|
@@ -111,49 +83,37 @@ const batchResults = await Promise.all(
|
|
|
111
83
|
)
|
|
112
84
|
```
|
|
113
85
|
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
### IMM-005:嵌套物件 Readonly 包裝(建議)
|
|
86
|
+
### IMM-005:巢狀物件使用 Readonly<T>
|
|
117
87
|
|
|
118
|
-
介面中的嵌套物件欄位使用 `Readonly<T>` 包裝,頂層 `readonly` 不防止嵌套物件欄位被修改(淺層保護不足)。
|
|
119
|
-
|
|
120
|
-
**錯誤範例**:
|
|
121
88
|
```typescript
|
|
89
|
+
// ❌ Bad — metadata.score can still be mutated
|
|
122
90
|
interface PipelineMemoryEntry {
|
|
123
|
-
readonly metadata: { score?: number }
|
|
91
|
+
readonly metadata: { score?: number }
|
|
124
92
|
}
|
|
125
|
-
```
|
|
126
93
|
|
|
127
|
-
|
|
128
|
-
```typescript
|
|
94
|
+
// ✅ Good
|
|
129
95
|
interface PipelineMemoryEntry {
|
|
130
96
|
readonly metadata: Readonly<{ score?: number; severity?: string }>
|
|
131
97
|
}
|
|
132
98
|
```
|
|
133
99
|
|
|
134
|
-
---
|
|
135
|
-
|
|
136
100
|
## 適用時機
|
|
137
101
|
|
|
138
102
|
- 設計新的 DTO / Value Object / Config 介面時
|
|
139
103
|
- 跨並行邊界傳遞物件時
|
|
140
|
-
- Agent
|
|
141
|
-
- Code Review
|
|
142
|
-
|
|
143
|
-
---
|
|
104
|
+
- 設計 Agent 間的共享狀態時
|
|
105
|
+
- Code Review:檢查介面是否遺漏 `readonly`
|
|
144
106
|
|
|
145
107
|
## 豁免情況
|
|
146
108
|
|
|
147
|
-
- Builder Pattern
|
|
148
|
-
- 測試 fixture
|
|
149
|
-
- 效能關鍵的熱路徑(需有明確的 benchmark
|
|
109
|
+
- Builder Pattern 的可變 builder(在 `build()` 後回傳不可變結果)
|
|
110
|
+
- 測試 fixture 的可變建立步驟(建立後視為不可變)
|
|
111
|
+
- 效能關鍵的熱路徑(需有明確的 benchmark 依據)
|
|
150
112
|
|
|
151
|
-
|
|
113
|
+
## 參考資料
|
|
152
114
|
|
|
153
|
-
|
|
115
|
+
- AI 最佳化版:[ai/standards/immutability-first.ai.yaml](../../../ai/standards/immutability-first.ai.yaml)
|
|
116
|
+
- XSPEC-044:跨專案規格
|
|
154
117
|
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
| `IMM-E001` | `READONLY_VIOLATION` — 嘗試修改 readonly 欄位(TypeScript 編譯期捕獲) |
|
|
158
|
-
| `IMM-E002` | `SHARED_MUTATION` — 跨並行邊界的就地修改導致競態條件 |
|
|
159
|
-
| `IMM-E003` | `SHALLOW_READONLY` — 嵌套物件遺漏 `Readonly<T>` 包裝,淺層保護不足 |
|
|
118
|
+
|
|
119
|
+
**Scope**: universal
|
|
@@ -2,13 +2,22 @@
|
|
|
2
2
|
source: ../../../core/knowledge-transfer-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: 7d994f996240
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
9
10
|
# 知識傳承標準
|
|
10
11
|
|
|
11
|
-
>
|
|
12
|
+
> **語言**: [English](../../../core/knowledge-transfer-standards.md) | 繁體中文
|
|
13
|
+
|
|
14
|
+
**版本**: 1.0.0
|
|
15
|
+
**最後更新**: 2026-03-31
|
|
16
|
+
**適用性**: 所有軟體專案
|
|
17
|
+
**範圍**: universal(通用)
|
|
18
|
+
**參考資料**: [Atlassian Knowledge Transfer](https://www.atlassian.com/work-management/knowledge-sharing), [Google re:Work](https://rework.withgoogle.com/)
|
|
19
|
+
|
|
20
|
+
---
|
|
12
21
|
|
|
13
22
|
## 概述
|
|
14
23
|
|
|
@@ -18,84 +27,138 @@ status: current
|
|
|
18
27
|
|
|
19
28
|
## Onboarding 路線圖
|
|
20
29
|
|
|
21
|
-
|
|
30
|
+
結構化的 30 天 Onboarding 流程,幫助新成員快速發揮生產力。
|
|
31
|
+
|
|
32
|
+
### 4 週路線圖
|
|
22
33
|
|
|
23
34
|
| 週次 | 主題 | 目標 | 交付物 |
|
|
24
|
-
|
|
25
|
-
| **第 1 週** | 環境與文化 |
|
|
35
|
+
|------|-------|------|-------------|
|
|
36
|
+
| **第 1 週** | 環境與文化 | 完成開發環境設定;理解團隊規範與慣例 | 成功建置並執行專案 |
|
|
26
37
|
| **第 2 週** | 架構與程式碼 | 理解系統架構與關鍵路徑 | 完成 Code Tour |
|
|
27
38
|
| **第 3 週** | 流程與工具 | 理解 CI/CD、部署與監控流程 | 完成第一個 PR |
|
|
28
39
|
| **第 4 週** | 獨立貢獻 | 獨立完成一個小型任務 | 通過 Buddy 評估 |
|
|
29
40
|
|
|
30
41
|
### Onboarding 檢查清單
|
|
31
42
|
|
|
43
|
+
每位新成員應在到職第一天及第一週內完成以下檢查清單:
|
|
44
|
+
|
|
32
45
|
| 類別 | 項目 |
|
|
33
|
-
|
|
34
|
-
| **帳號存取** | Git 儲存庫、CI/CD
|
|
35
|
-
| **環境設定** | 開發環境、IDE
|
|
36
|
-
| **文件** | README、架構文件、API 文件、CLAUDE.md
|
|
37
|
-
| **會議** | 與 Buddy 1:1
|
|
38
|
-
| **首要任務** | Good First Issue
|
|
46
|
+
|----------|-------|
|
|
47
|
+
| **帳號存取** | Git 儲存庫、CI/CD 平台、監控工具、雲端控制台、通訊工具(Slack/Teams) |
|
|
48
|
+
| **環境設定** | 開發環境、IDE 設定、VPN 存取、資料庫存取、本地建置驗證 |
|
|
49
|
+
| **文件** | README、架構文件、API 文件、CLAUDE.md 或等效的 AI 脈絡檔案 |
|
|
50
|
+
| **會議** | 與 Buddy 1:1、團隊介紹、架構概覽說明會 |
|
|
51
|
+
| **首要任務** | 指派 Good First Issue、完成 Code Tour、提交第一個小型 PR |
|
|
39
52
|
|
|
40
53
|
---
|
|
41
54
|
|
|
42
55
|
## Handoff 流程
|
|
43
56
|
|
|
57
|
+
當團隊成員即將離職或轉換角色時,使用此結構化 Handoff 流程以防止知識流失。
|
|
58
|
+
|
|
59
|
+
### Handoff 檢查清單
|
|
60
|
+
|
|
44
61
|
| 項目 | 說明 | 時程 |
|
|
45
|
-
|
|
46
|
-
| **負責清單** |
|
|
47
|
-
| **隱性知識記錄** |
|
|
48
|
-
| **WIP 交接** |
|
|
49
|
-
| **Buddy 配對** |
|
|
50
|
-
|
|
|
51
|
-
| **Runbook 更新** | 審查並更新所有相關 Runbook | 離職前 1 週 |
|
|
62
|
+
|------|-------------|----------|
|
|
63
|
+
| **負責清單** | 列出此人負責的所有模組、服務與流程 | 離職前 4 週 |
|
|
64
|
+
| **隱性知識記錄** | 使用下方的知識記錄格式,記錄所有「只有我知道」的操作、技巧與陷阱 | 離職前 3 週 |
|
|
65
|
+
| **WIP 交接** | 移交所有進行中的任務、開啟中的 PR 與事件追蹤項目 | 離職前 2 週 |
|
|
66
|
+
| **Buddy 配對** | 指定繼任者,並針對複雜領域進行 Pair Programming | 離職前 2 週 |
|
|
67
|
+
| **帳號與權限移交** | 移交 owner 權限、輪換 API 金鑰、更新存取控制 | 離職前 1 週 |
|
|
68
|
+
| **Runbook 更新** | 審查並更新所有相關 Runbook,確保內容為最新且完整 | 離職前 1 週 |
|
|
52
69
|
|
|
53
70
|
### 知識記錄格式
|
|
54
71
|
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
|
58
|
-
|
|
59
|
-
|
|
|
60
|
-
|
|
|
61
|
-
|
|
|
72
|
+
記錄隱性知識時,每筆記錄**應該**包含以下 5 個欄位:
|
|
73
|
+
|
|
74
|
+
| 欄位 | 說明 | 範例 |
|
|
75
|
+
|-------|-------------|---------|
|
|
76
|
+
| **主題** | 要捕捉的是什麼知識 | 「支付閘道重試邏輯」 |
|
|
77
|
+
| **情境** | 在什麼情況下需要此知識 | 「支付因逾時錯誤而失敗時」 |
|
|
78
|
+
| **步驟** | 應遵循的具體程序 | 「1. 檢查閘道狀態頁 2. 檢視重試佇列 3. ...」 |
|
|
79
|
+
| **陷阱** | 常見錯誤與注意事項 | 「絕不重試 4xx 錯誤;僅在 5xx 或逾時時重試」 |
|
|
80
|
+
| **資源** | 程式碼、文件、Runbook 連結 | 「參見 `src/payment/retry.js`,Runbook:payment-recovery」 |
|
|
62
81
|
|
|
63
82
|
---
|
|
64
83
|
|
|
65
84
|
## Bus Factor 評估
|
|
66
85
|
|
|
86
|
+
Bus Factor 衡量需要有多少團隊成員「被公車撞到」(意外離開),關鍵知識才會流失。Bus Factor 為 1 代表只要一個人離開,就可能使某個系統領域癱瘓。
|
|
87
|
+
|
|
88
|
+
### 評估指標
|
|
89
|
+
|
|
90
|
+
針對每個關鍵領域或系統區域,評估以下 3 項指標:
|
|
91
|
+
|
|
67
92
|
| 指標 | 定義 | 風險等級 |
|
|
68
|
-
|
|
69
|
-
| **知識人數** |
|
|
70
|
-
| **文件覆蓋率** |
|
|
71
|
-
| **最近知識分享** |
|
|
93
|
+
|--------|-----------|------------|
|
|
94
|
+
| **知識人數** | 能獨立處理該領域的人數 | 1 人 = **高**風險、2 人 = **中**、3+ 人 = **低** |
|
|
95
|
+
| **文件覆蓋率** | 該領域有書面文件覆蓋的百分比 | < 30% = **高**風險、30-70% = **中**、> 70% = **低** |
|
|
96
|
+
| **最近知識分享** | 最近一次有人學習該領域距今多久 | > 6 個月 = **高**風險、3-6 個月 = **中**、< 3 個月 = **低** |
|
|
72
97
|
|
|
73
98
|
### 知識擴散策略
|
|
74
99
|
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
|
78
|
-
|
|
79
|
-
|
|
|
80
|
-
| **
|
|
81
|
-
|
|
|
100
|
+
當發現 Bus Factor = 1 的領域時,使用以下一種或多種策略擴散知識:
|
|
101
|
+
|
|
102
|
+
| 策略 | 說明 | 最適用於 |
|
|
103
|
+
|----------|-------------|----------|
|
|
104
|
+
| **Pair Programming** | 專家與學習者一起處理實際任務 | 複雜邏輯、特殊技巧 |
|
|
105
|
+
| **Tech Talk** | 專家以結構化場次向團隊分享 | 架構決策、設計理由 |
|
|
106
|
+
| **文件化** | 將隱性知識轉換為書面文件或 Runbook | 操作程序、部署步驟 |
|
|
107
|
+
| **Code Review 輪調** | 輪換審查者,讓不同人審查不同領域 | 程式碼理解、發現知識孤島 |
|
|
108
|
+
| **On-call 輪調** | 在不同服務之間輪換值班 | 維運知識、事件回應 |
|
|
82
109
|
|
|
83
110
|
---
|
|
84
111
|
|
|
85
112
|
## Code Tour
|
|
86
113
|
|
|
114
|
+
Code Tour 提供貫穿程式碼庫的結構化導覽路線,幫助新人不必閱讀每個檔案就能理解系統。
|
|
115
|
+
|
|
87
116
|
### 導覽路線
|
|
88
117
|
|
|
118
|
+
每個程式碼庫**應該**至少定義以下導覽路線:
|
|
119
|
+
|
|
89
120
|
| 路線 | 涵蓋內容 | 目標對象 |
|
|
90
|
-
|
|
121
|
+
|-------|--------|-----------------|
|
|
91
122
|
| **Quick Start** | 進入點、主要設定、啟動流程 | 所有新人 |
|
|
92
123
|
| **Request Flow** | 請求從進入到回應的完整路徑 | 後端開發者 |
|
|
93
|
-
| **Data Flow** |
|
|
94
|
-
| **Deploy Flow** | 從 PR
|
|
124
|
+
| **Data Flow** | 資料從建立、儲存到擷取的路徑 | 資料相關開發者 |
|
|
125
|
+
| **Deploy Flow** | 從 PR 到正式環境的完整路徑 | 需要部署的人 |
|
|
95
126
|
| **Key Decisions** | 重要架構決策及其 ADR | 需要理解「為什麼」的人 |
|
|
96
127
|
|
|
128
|
+
### Code Tour 維護
|
|
129
|
+
|
|
130
|
+
程式碼變更時,評估 Code Tour 是否需要更新:
|
|
131
|
+
|
|
132
|
+
| 變更類型 | 動作 | 理由 |
|
|
133
|
+
|-------------|--------|-----------|
|
|
134
|
+
| 進入點或路由變更 | **必須**更新導覽 | 導覽中的參照會失效或產生誤導 |
|
|
135
|
+
| 內部重構(介面不變) | **不需更新** | 導覽描述的是流程,而非實作細節 |
|
|
136
|
+
| 新增重大功能 | **應該**新增導覽路線 | 新功能可能值得擁有專屬的導覽路徑 |
|
|
137
|
+
|
|
138
|
+
---
|
|
139
|
+
|
|
140
|
+
## 參考資料
|
|
141
|
+
|
|
142
|
+
- [Atlassian Knowledge Transfer Guide](https://www.atlassian.com/work-management/knowledge-sharing) — 知識分享最佳實踐
|
|
143
|
+
- [Google re:Work — Onboarding](https://rework.withgoogle.com/guides/hiring-shape-the-candidate-experience/steps/make-onboarding-a-great-experience/) — 以證據為基礎的 Onboarding 實踐
|
|
144
|
+
- [Bus Factor on Wikipedia](https://en.wikipedia.org/wiki/Bus_factor) — 概念定義與緩解方式
|
|
145
|
+
|
|
146
|
+
---
|
|
147
|
+
|
|
148
|
+
**相關標準:**
|
|
149
|
+
- [文件生命週期](documentation-lifecycle.md) — 文件維護與審查週期
|
|
150
|
+
- [Runbook 標準](runbook-standards.md) — 維運 Runbook 格式與要求
|
|
151
|
+
|
|
152
|
+
---
|
|
153
|
+
|
|
154
|
+
## 版本歷史
|
|
155
|
+
|
|
156
|
+
| 版本 | 日期 | 變更 |
|
|
157
|
+
|---------|------|---------|
|
|
158
|
+
| 1.0.0 | 2026-03-31 | 初始版本:Onboarding 路線圖、Handoff 流程、Bus Factor 評估、Code Tour |
|
|
159
|
+
|
|
97
160
|
---
|
|
98
161
|
|
|
99
162
|
## 授權
|
|
100
163
|
|
|
101
|
-
本標準以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/)
|
|
164
|
+
本標準以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../core/open-work-tracking.md
|
|
3
|
-
source_version: 1.
|
|
4
|
-
translation_version: 1.
|
|
5
|
-
last_synced: 2026-
|
|
6
|
-
source_hash:
|
|
3
|
+
source_version: 1.4.0
|
|
4
|
+
translation_version: 1.4.0
|
|
5
|
+
last_synced: 2026-10-07
|
|
6
|
+
source_hash: 5b59fe93ed56
|
|
7
7
|
status: current
|
|
8
8
|
---
|
|
9
9
|
|
|
@@ -11,8 +11,8 @@ status: current
|
|
|
11
11
|
|
|
12
12
|
> **Language**: [English](../../../core/open-work-tracking.md) | 繁體中文
|
|
13
13
|
|
|
14
|
-
**版本**: 1.
|
|
15
|
-
**最後更新**: 2026-
|
|
14
|
+
**版本**: 1.4.0
|
|
15
|
+
**最後更新**: 2026-10-07
|
|
16
16
|
**適用**: 任何跨越一個以上工作階段承載工作、有可能在階段之間遺失項目的專案
|
|
17
17
|
**範圍**: universal
|
|
18
18
|
|
|
@@ -35,7 +35,7 @@ status: current
|
|
|
35
35
|
| 已規劃的項目還沒動工,時間過去 | 沒有時鐘的項目會無聲腐爛——沒有東西會再指向它 | 一個門檻,或一次被迫的定期檢視,讓它重新浮現 |
|
|
36
36
|
|
|
37
37
|
下面每一條要求都對應這張表的一列、對應本標準設計當天觀察到的四個失效之一,
|
|
38
|
-
或(OWT-017–OWT-019)對應 1.1.0
|
|
38
|
+
或(OWT-017–OWT-019)對應 1.1.0 補上的兩個缺口、或(OWT-020–OWT-026)對應 1.1.0 沒有命名的兩個狀態、或(OWT-027–OWT-029)對應等著另一個專案的工作
|
|
39
39
|
(見〈[證據與校準](#證據與校準)〉)。**沒有任何一個機制被規定**——
|
|
40
40
|
理由與 [deferred-item-exit](deferred-item-exit.md) 對自己出口的約束相同(DEC-049:
|
|
41
41
|
UDS 定義必須成立的關係,維持它的機制由採用層選擇)。
|
|
@@ -71,7 +71,7 @@ UDS 定義**活動**,採用層負責**編排**(DEC-049)。一份寫成工
|
|
|
71
71
|
(3)對任何有可靠來源可推導的欄位改用生成、(4)回報還剩什麼時同時揭露看不到什麼、
|
|
72
72
|
(5)在控制權從 agent 交回人的那一刻被檢視——而且那個檢視不能讓回合失敗、
|
|
73
73
|
(6)把「這份工作為了什麼」與「做到哪了」分開存放,並替前者的每一次修改留下交代、
|
|
74
|
-
(7
|
|
74
|
+
(7)讓每一個「下一步」都點名一個讀的人找得到的東西(對已問、等回覆的項目,則寫明何時問的、在等什麼、什麼事件解除它)、(8)分得出「還沒問」與「已問、等回覆」,並讓看不見的事實有一個帶戳記的存放處——`unknown` 是正式的值、每筆觀察的年齡一律顯示、(9)讓一個等待可以用邏輯名稱點名另一個專案裡的東西、說明這台機器看不看得到它,並把那份紀錄放在每個相關專案的 session 都讀得到的地方。**
|
|
75
75
|
|
|
76
76
|
---
|
|
77
77
|
|
|
@@ -97,7 +97,17 @@ UDS 定義**活動**,採用層負責**編排**(DEC-049)。一份寫成工
|
|
|
97
97
|
| **OWT-016** | 本標準各要求所引用的任何窗口或閾值,載明來歷,或標為未校準 | warning |
|
|
98
98
|
| **OWT-017** | 承載一件工作之目標、驗收條件或限制的載體,不同時承載它的進度或下一步,反之亦然。以走訪各載體的結構欄位(小節、欄位、型別化標記)判定,絕不看檔名。更新進度因此不需要碰目標 | warning |
|
|
99
99
|
| **OWT-018** | 對一件工作的目標、驗收條件或限制的每一次修改,都留下載明改了什麼、誰核可、為什麼的修訂紀錄。沒有核可者的修改,在控制權交回人時被列出(OWT-007),不得靜默 | error |
|
|
100
|
-
| **OWT-019** |
|
|
100
|
+
| **OWT-019** | 「下一步」欄位至少點名一個具體對象:檔案路徑、測試名稱、指令或需求編號之一。只有動詞(「繼續」「處理剩下的」)不算。它判斷有沒有點名對象,絕不判斷句子措辭好壞。處於 `asked-awaiting` 並滿足 OWT-022 的項目不在這裡判定:它的下一步可以就是它等的那個回覆,由 OWT-022 判定(何時問的、在等什麼、什麼事件解除它) | warning |
|
|
101
|
+
| **OWT-020** | 標為等待中的項目說明自己處於兩個狀態中的哪一個:`not-yet-asked`(還沒問:請求已草擬或已決定要問,尚未送出)或 `asked-awaiting`(已問、等回覆:已送出、還沒有回音)。不屬於這兩者的等待項目,在開放工作摘要裡被個別點名——不被合併進總數,也不被算成已完成 | warning |
|
|
102
|
+
| **OWT-021** | `not-yet-asked` 的項目點名那份草稿或那個動作(送出它就是解除條件):檔案路徑、指令、測試名稱或需求編號(沿用 OWT-019 的辨認方式) | warning |
|
|
103
|
+
| **OWT-022** | `asked-awaiting` 的項目帶有 `asked-at`(含年份的日曆日、不晚於今天),並滿足 OWT-002:在等什麼、什麼事件算解除 | warning |
|
|
104
|
+
| **OWT-023** | 手寫列只容許用在承載庫無法從版本控制、規格標記或 CI 結果推導的事實——例如訊息是否已寄出、對方是否已回覆、是否已核准。每一列帶有 `observed-by`(誰或什麼看到的)、`observed-at`(含年份的日曆日、不晚於今天)與 `yes`、`no` 或 `unknown` 的值;缺其中任一項的列即違反。檢查只判定欄位存在且格式正確——絕不判定那個觀察是否為真 | warning |
|
|
105
|
+
| **OWT-024** | `unknown` 是一個值,不是空白:值為 `unknown` 的列在任何摘要裡單獨計數、單獨顯示,永遠不被算成完成。標為完成、值卻是 `unknown` 的列即違反 | warning |
|
|
106
|
+
| **OWT-025** | 觀察的彙總顯示每筆觀察的年齡(距 `observed-at` 的天數)。超過宣告門檻的觀察被回報為「觀察已舊」、另計、不被算成已確認。戳只說誰、何時看到——絕不說它現在仍然如此 | warning |
|
|
107
|
+
| **OWT-026** | OWT-023 的例外不及於版本控制、規格標記或 CI 結果已能決定的欄位;OWT-003 仍成立。檢查只能拿一份這類主題的詞表去判定,所以其涵蓋率是未知的(OWT-011) | warning |
|
|
108
|
+
| **OWT-027** | 等待項目的解除條件(OWT-002)可以點名另一個專案裡的物件,寫成 `<專案>:<物件>`。專案是**邏輯名稱**(`uds`、`vibeops`),絕不是目錄;物件是檔案路徑、測試名稱、指令或需求編號(OWT-019 辨認的那幾種)或版本控制標籤;載體裡**沒有任何機器專屬的絕對路徑**。名稱在某台機器上對應哪個目錄,宣告在載體之外。一個在等這種物件的項目,沒有任何「可以被問」的請求,所以 OWT-020 的兩個狀態不適用於它 | warning |
|
|
109
|
+
| **OWT-028** | 對每一個這樣的解除條件,檢查說四種話之一,單獨計數、絕不合併成一個總數:**已解除**(該物件現在在對方專案裡存在)、**尚未解除**(專案看得到、物件不在)、**從這裡看不到**(這台機器看不到那個專案:不是已解除,也不是零)、或**需要人判斷**(專案看得到,但這類物件——例如測試名稱、指令、需求編號——沒有任何檢查讀得到的東西)。查找只讀這台機器上的檔案與版本控制,不開任何網路連線 | warning |
|
|
110
|
+
| **OWT-029** | 等著另一個專案的工作,其紀錄是受版本控制、每個相關專案的 session 都讀得到的 repo 裡的一個檔案;不得只放在個人的 AI 工具記憶裡——那種記憶綁一個使用者、一台機器,另一個 session 與 CI 都讀不到。用哪個 repo 是採用專案的選擇。參考檢查不判定載體放在哪裡 | warning |
|
|
101
111
|
|
|
102
112
|
---
|
|
103
113
|
|
|
@@ -164,6 +174,16 @@ UDS 定義**活動**,採用層負責**編排**(DEC-049)。一份寫成工
|
|
|
164
174
|
| 為什麼行為相反 | 它在看的事件本身夠稀少,擋在它上面不會把耐性用完 | TCI 自己的規則已經寫出這裡不能做成閘門的理由:**「一個在每個回合都為真的閘門會被關掉,關掉之後它什麼都不保護」**(TCI R4)。開放工作非空幾乎永遠為真,所以這個確認點被設計成永不保留控制權 |
|
|
165
175
|
| 兩者掛同一事件時的順序 | — | 先回報(OWT-009),所以即使那個回合隨後被 TCI 擋下,它的輸出仍然可見 |
|
|
166
176
|
|
|
177
|
+
### 摘要可以由程式印出,完整版按需取得
|
|
178
|
+
|
|
179
|
+
OWT-007 說的是:控制權從 agent 交回人的那一刻要有一份摘要。它**沒有**規定誰產生、多長,而滿足它的兩種明顯做法價格差很多。**由程式在回合結束時印出一份簡短摘要**:那是掛在回合結束事件上的既有機制所執行的一個指令的輸出,所以不消耗模型的 token,而**完整版在讀的人要看時才產生**。**或者由模型在每則回覆裡手工附上一張完整的表**:它滿足 OWT-007,是可行的選擇,但那是昂貴的做法,不是本標準要求的做法。OWT-008 與 OWT-009 對第一種做法照樣成立:程式只回報、永不阻斷,它的輸出排在任何阻斷式檢查的判決之前。
|
|
180
|
+
|
|
181
|
+
簡短摘要對每個開放項目怎麼分類,這裡建議一組詞彙(建議,不是要求):等人決策;等外部(對方回覆);等 CI;固定日期到期;無人看管。它們與 OWT-002、OWT-020–OWT-022 已讓承載庫記錄的東西(在等什麼、有沒有問過)相呼應;本標準不替摘要本身規定任何詞彙。
|
|
182
|
+
|
|
183
|
+
有一個採用專案是這樣做的:回合結束時由程式印出簡短摘要,完整清單在使用者呼叫時才產生。那個專案的檔案是私有的,所以這裡不放連結。它是一個外部範例,**不屬於 UDS 套件,也不保證與它相容**,只用來說明這個做法可行。
|
|
184
|
+
|
|
185
|
+
**誠實註記:** UDS 沒有出貨任何產生 OWT-007 摘要的程式,本標準也沒有任何東西檢查這種程式存在(見〈[什麼在執行本標準](#什麼在執行本標準)〉)。本小節描述的是滿足一條既有要求的較便宜做法,不新增要求編號,也不新增檢查。
|
|
186
|
+
|
|
167
187
|
---
|
|
168
188
|
|
|
169
189
|
## 錨點:走訪結構,不走訪措辭
|
|
@@ -216,21 +236,55 @@ agent 正當地會提出修改,禁止只會教它學會靜默地改——但
|
|
|
216
236
|
簡短但點了一個測試名稱的句子照樣過。這讓它留在 OWT-010 與 OWT-014 的範圍之內。
|
|
217
237
|
|
|
218
238
|
檢查回報三種結果,而不是一個綠燈:**點名且已找到**(對象被找到——例如路徑存在)、**點名但未找到**
|
|
219
|
-
|
|
239
|
+
(有點名對象但找不到——當下一步就是要建立它時是正當的)、**未點名**(違反)。自 1.4.0 起,有一種列另有第四種結果,見下面。
|
|
220
240
|
辨認「這串字是路徑、指令、測試名稱還是編號」本身是樣式比對,所以依 OWT-011 其涵蓋率明示為未知:
|
|
221
|
-
|
|
241
|
+
認不出的格式會被回報為未點名,而乾淨的通過絕不表示「每個下一步都夠具體」。標示「下一步」欄位的詞(`Next action`、`下一步`、`下一個動作` 等)是**一份清單**,以三種方式讀(標題、表頭、行內標籤),且屬未校準(OWT-016):欄位標題寫 `待辦` 或 `TODO` 的載體,要等採用專案宣告那個詞才會被讀到,因為範圍太寬的詞也會標在不是下一步的欄位上;而完全找不到欄位時,檢查以 2 結束,並印出每個載體看到了什麼、認得哪些詞。
|
|
242
|
+
|
|
243
|
+
**回覆的第四種結果(1.4.0)。** 下一步就是*那個回覆本身*(「等廠商回信」「等對方排時間」),沒有點名任何檔案、指令、測試或編號,過去被回報為未點名。那判定的是錯的東西:對一個已經問出去的項目,起點不是「動詞加對象」,而是 **OWT-022** 要求的三件事——何時問的(`asked-at`)、在等什麼、什麼事件解除它。所以處於 `asked-awaiting` 並滿足 OWT-022 的項目,由 OWT-022 判定、不由 OWT-019 判定,檢查把它回報為第四種結果:**等待回覆**。它不是違反;它**不算「已點名」**,也**不算完成**;它被單獨列出並顯示**年齡**,超過宣告門檻的標為**已舊**(沿用 OWT-025 用的門檻,未校準)。這個免除不是藏身處:只有項目是 `asked-awaiting` **而且** OWT-022 找不出缺漏時才適用。沒有 `asked-at`(或在未來)、沒有寫在等什麼、或沒有解除事件的列,照舊由 OWT-019 判定;`not-yet-asked` 的項目也一樣(它的下一步是送出那份草稿,OWT-021 要求它點名草稿);其他狀態的項目,以及寫成小節標題而不是帶狀態欄之列的下一步,也一樣。沒有狀態欄的載體,讀法與過去完全相同。兩個檢查以同一個函式讀這個項目,所以不可能對它給出相反的結論:`uds open-work waiting` 接受的列,在 `next-action` 底下絕不是 OWT-019 違反;`waiting` 以 OWT-022 報違反的列,絕不被免除。**這無法判定的事:**請求是否真的送出、是否仍未回覆。檢查只判定欄位存在且格式正確,與 OWT-023 對一筆觀察所做的相同(OWT-014)。
|
|
244
|
+
|
|
245
|
+
---
|
|
246
|
+
|
|
247
|
+
## 一個沒人問過的等待項目,不是在等待
|
|
248
|
+
|
|
249
|
+
**OWT-002** 要求等待中的項目說明在等什麼、什麼事件算解除。有兩件差別很大的事都滿足這句話。一則**草擬了、從沒送出**的訊息,等的是「有人把它送出去」;一則**已經送出**的訊息,等的是「對方回覆」。承載庫分不出這兩者,看不到聊天的助理也分不出——而差別正是重點:第一種在有人動手之前,永遠不會有任何東西到來。**OWT-020** 為這兩個狀態命名(`not-yet-asked`、`asked-awaiting`),並要求每個等待項目必處於其一;兩者皆非的項目被個別點名——與 OWT-012 點名未分類項目的方式相同——而且絕不算成已完成。
|
|
250
|
+
|
|
251
|
+
每個狀態再帶上讓它可被檢查的東西。`not-yet-asked` 的項目點名那份草稿或那個動作(**OWT-021**)——沿用 OWT-019 的辨認方式,所以詞彙只有一份——因為只有「問法務」、背後沒有檔案或指令,是一種心情,不是草稿。`asked-awaiting` 的項目帶有 `asked-at`(**OWT-022**),那是讓時鐘開始走的東西:從那一刻起項目有了年齡,有年齡的項目才能被門檻再次浮現。兩者都讀承載庫的結構狀態欄(OWT-010),絕不讀它周圍的措辭。嚴重度是 `warning`、狀態詞彙未校準(OWT-016):目的是讓這兩個狀態能被命名,不是在標準發布當天讓所有既有載體一次變紅。
|
|
252
|
+
|
|
253
|
+
---
|
|
254
|
+
|
|
255
|
+
## 沒有人能推導的事實,需要戳記、誠實的「未知」與看得見的年齡
|
|
256
|
+
|
|
257
|
+
開放工作裡有些事實,助理沒有任何來源可以讀:訊息是否已寄出、對方是否已回覆、某事是否已核准。**OWT-003** 只允許從可推導的來源生成,而下方的表格拒絕手寫狀態檔是有道理的——它會過期,而比過期內容新的戳是隱形的。這類事實沒有可推導的來源可供生成,把手寫列一律拒絕,就讓它們無處可住,最後流落到沒有任何東西會計數的自由文字裡。
|
|
258
|
+
|
|
259
|
+
因此 1.2.0 容許一個**窄例外**(**OWT-023**–**OWT-026**),附三個條件。那一列寫明**誰在何時看到**(`observed-by`、`observed-at`)。它的值是 `yes`、`no` 或 **`unknown`**,而 `unknown` 是正式的值,單獨計數、單獨顯示、永遠不算完成(**OWT-024**)——與 OWT-006 同一種讀法:看不到的不是零。而且報告顯示**每筆觀察的年齡**(**OWT-025**);超過宣告門檻的被回報為「觀察已舊」、另計、不算已確認。這個例外不及於版本控制、規格標記或 CI 結果已能決定的東西(**OWT-026**),因為 OWT-003 沒有被放寬。
|
|
260
|
+
|
|
261
|
+
這不是在宣稱整件事都誠實。戳只說有人在某時看到;**它不說現在仍然如此**,報告就是圍繞這一點建的:年齡印在值的旁邊,所以戳原本會藏起來的過期,是讀者第一眼看到的東西。而檢查能判定的只有可判定的部分:`observed-by` 有沒有填、`observed-at` 是不是一個真實的日子、值在不在值域內。**它判定不了 `observed-by` 填的是不是真的去看過的人,也判定不了那個值是否為真**——那是關於世界的宣稱,不是 artefact 之間的關係(OWT-014),本標準不假裝做得到。「觀察已舊」的門檻沒有任何量測支持(OWT-016)。
|
|
262
|
+
|
|
263
|
+
**這些嚴重度的理由(1.2.0)。** OWT-020 到 OWT-026 全是 `warning`:狀態詞、欄位名與「觀察已舊」的門檻是第一版詞彙,沒有任何量測支持(OWT-016),而違反的代價是讀的人的時間,不是工作本身。更嚴的等級,會讓所有早於這兩個狀態存在的載體在標準發布當天變紅;`warning` 讓採用者先看到清單。**但指令對任何違反都回結束碼 1,`warning` 也一樣**——`uds open-work next-action` 對 OWT-019 本來就是如此——所以把其中一支接進閘門的採用者,自己決定警告要不要擋。
|
|
264
|
+
|
|
265
|
+
---
|
|
266
|
+
|
|
267
|
+
## 對另一個專案的等待,只點名它,不定位它
|
|
268
|
+
|
|
269
|
+
彼此相依的專案會產生一種 OWT-002 從未為它而寫的等待:一個專案的項目,在等另一個專案的產出。1.3.0 讓解除條件可以點名它——`uds:v6.14.0` 或 `vibeops:docs/runbook.md`——並說明什麼東西能防止這種紀錄腐壞(**OWT-027**)。專案是**邏輯名稱**,絕不是目錄。目錄屬於一台機器、一個使用者(它會洩漏使用者名稱,換一台機器就是錯的),而同一份載體的兩個讀者,必須用同一個名稱指同一個專案。所以載體裡放的是名稱,「名稱對應到某台機器上的哪個目錄」則宣告在載體**之外**(參考檢查接受可重複的 `--root NAME=DIR`,或採用專案的設定)。解除條件裡出現機器專屬的絕對路徑即違反。一個在等另一個專案之物件的項目,沒有任何「可以被問」的請求,所以 OWT-020 的兩個狀態不適用於它;它仍被點名,並在自己那一行被計數。
|
|
270
|
+
|
|
271
|
+
檢查對這種等待的回報是四種(**OWT-028**),理由與 OWT-006 相同:**看不到的,不是零。** 已解除;尚未解除;**從這裡看不到**——對方專案不在這台機器上、或讀不到它的版本控制——它單獨計數,既不是已解除也不是零;以及**需要人判斷**——專案看得到,但裡面的測試名稱、指令或需求編號沒有任何檢查讀得到的東西。路徑與版本控制標籤是機器可觀察的:它在對方專案裡存在,或不存在。查找只讀這台機器上的檔案與版本控制、不開任何連線,而「已解除」只說該物件在那邊存在,絕不說它是對的那個物件(OWT-014)。
|
|
272
|
+
|
|
273
|
+
**OWT-029** 說這種紀錄放在哪裡:放在每個相關專案的 session 都讀得到、受版本控制的 repo 裡,而不是只放在某個人的 AI 工具記憶裡。那種記憶綁一個使用者、一台機器,另一個 session 與 CI 都看不到,也沒有給檢查任何具名的載體去判定關係(OWT-014)。用哪個 repo,是採用專案的選擇。本版涵蓋的是一個人在一台機器上的各個 session;工作如何在人與人之間共享、共享的紀錄要不要先審核才可信,這裡不決定。
|
|
274
|
+
|
|
275
|
+
**為什麼是 `warning`、什麼未校準(1.3.0)。** OWT-027 到 OWT-029 是 `warning`,理由與上面 OWT-020 到 OWT-026 相同。構成邏輯名稱的樣式、機器專屬路徑前綴的清單(家目錄與磁碟區目錄、磁碟機代號、`~/`),以及檢查能查找的兩種物件(路徑與標籤),都是第一版判斷(OWT-016);涵蓋率未知(OWT-011),因為用清單裡沒有的形式寫的路徑,不會被認成絕對路徑。
|
|
222
276
|
|
|
223
277
|
---
|
|
224
278
|
|
|
225
279
|
## 本標準刻意不採納的東西
|
|
226
280
|
|
|
227
|
-
|
|
281
|
+
1.1.0 的兩項新增(OWT-017–OWT-019:目標與進度分開並留下修訂紀錄、以及點名對象的下一步),起因是使用者轉貼的一份提示詞——**作者與出處不明,也沒有任何實作**。
|
|
228
282
|
只借了它的設計形狀,本文不引用它的任何宣稱。它提出的其餘部分經過檢視、**沒有**採納,
|
|
229
283
|
理由是機制層的,不是口味:
|
|
230
284
|
|
|
231
285
|
| 不採納 | 理由(機制層) |
|
|
232
286
|
|---|---|
|
|
233
|
-
|
|
|
287
|
+
| 以手寫狀態檔作為任何「已有可靠來源可決定」之狀態的真相 | 手寫狀態會過期,而「戳比過期內容新」是隱形的(OWT-004、OWT-005 存在的起因)。只說「兩者不一致時以版本控制為準」,卻沒有任何機制讓該檔與版本控制對帳,就是採納一個已知會過期的來源。OWT-003 已經要求可推導的欄位改用生成。**自 1.2.0 起有一個窄例外(OWT-023–OWT-026)**:對「沒有任何東西能推導」的事實——訊息是否已寄出、對方是否已回覆——容許一列手寫。它只有在附上誰何時看到的戳記、值可以誠實地是 `unknown`、且每份報告都顯示年齡時才被容許,並且絕不及於版本控制、規格標記或 CI 結果已能決定的欄位。上面的反對理由是被回答了,不是被擱置:那個理由是過期看不見,而這裡年齡就印在每個值旁邊 |
|
|
234
288
|
| 固定的開工儀式(讀檔→查版本控制→驗證) | 交接點已被管住:回合結束有 OWT-007,另有 [turn-completion-integrity](turn-completion-integrity.md)。開工儀式要靠各代理工具自己的指示來設定;寫進這裡只會得到一條沒有任何 artefact 上的檢查判定得了的要求,而那正是 OWT-014 排除的東西 |
|
|
235
289
|
|
|
236
290
|
---
|
|
@@ -274,8 +328,14 @@ DEX-003 扮演的角色相同。上面每一條都指名了 artefact 與它們
|
|
|
274
328
|
| 分類狀態只靠散文措辭判讀 | 正確到某個項目用清單沒預料到的方式寫出來為止 |
|
|
275
329
|
| 項目從承載庫裡無聲消失 | 與一個弄丟它的 bug 無從分辨 |
|
|
276
330
|
| 目標或驗收條件被改了,卻沒有任何「誰同意」的紀錄 | 「每一條驗收都滿足」依然為真,只是針對另一組條件;被改過的目標讀起來像一直這麼寫 |
|
|
277
|
-
|
|
|
331
|
+
| 把手寫的狀態檔當成版本控制或 CI 早已知道之事的真相 | 會過期,而比過期內容新的戳看不見 |
|
|
278
332
|
| 下一步寫「繼續實作」或「處理剩下的」 | 沒有點名任何可以開始的東西;與被遺忘的項目無從分辨 |
|
|
333
|
+
| 等待項目沒有任何「有沒有人問過」的紀錄 | 沒人送出的草稿與沒人回的請求看起來一模一樣;等待永遠不會讓前者解除 |
|
|
334
|
+
| 手寫的「已寄出/已回覆/已核准」,沒有名字也沒有日期 | 與猜測無從分辨,過期時也沒有任何東西顯示 |
|
|
335
|
+
| 一個沒有人能做的觀察,被算成「否」或已完成 | 看不到的事實被讀成不存在或已完成;`unknown` 是一個值,不是零 |
|
|
336
|
+
| 對另一個專案的等待,用某一台機器的目錄記下來 | 換一台機器就是錯的、洩漏使用者名稱,同一份載體的兩個讀者也不再指同一個專案 |
|
|
337
|
+
| 這台機器看不到的專案,被算成已解除或零 | 沒看過的被讀成做完了;「從這裡看不到」是它自己的一個計數 |
|
|
338
|
+
| 等著另一個專案的工作,只放在某個人的 AI 工具記憶裡 | 另一個 session 與 CI 讀不到,檢查也沒有任何具名的載體可以判定 |
|
|
279
339
|
|
|
280
340
|
---
|
|
281
341
|
|
|
@@ -284,9 +344,15 @@ DEX-003 扮演的角色相同。上面每一條都指名了 artefact 與它們
|
|
|
284
344
|
**UDS 不對本標準設任何閘門,而這件事是被記錄的,不是被暗示的。** UDS 陳述一個承載開放工作的地方
|
|
285
345
|
必須滿足的關係;有沒有東西去判定它,依上面的[寫法約束](#本標準的寫法以及為什麼這樣寫),
|
|
286
346
|
是採用專案的決定——與 [deferred-item-exit](deferred-item-exit.md) 對自己出口劃的界線相同。
|
|
287
|
-
自 1.1.0 起,UDS 為 OWT-017–OWT-019
|
|
347
|
+
自 1.1.0 起,UDS 為 OWT-017–OWT-019 附上一支**參考判定程序**——npm 安裝包裡的 `uds open-work next-action | revision | separation`(`uds open-work self-test` 只跑檢查器自己的自測臂;在 UDS repo 的副本裡,`node scripts/check-open-work-tracking.mjs` 跑的是同一份程式)——
|
|
288
348
|
作為 OWT-015 意義上的證據——它已被觀察到對違反的樣本回報失敗——供採用者直接執行或自行重做。
|
|
289
|
-
它沒有接進任何 UDS 發版閘門,因為 UDS
|
|
349
|
+
它沒有接進任何 UDS 發版閘門,因為 UDS 本身沒有承載開放工作的地方可供它檢查。對 OWT-019,它以同一份詞彙讀三種形狀的「下一步」欄位:小節標題、行內標籤、以及表頭在該詞彙內的表格欄(該欄每一列各算一個欄位)。欄數與表頭不一致的表格列會被列為「判定不了」(不會被當成空白;若別處沒有違反,結束碼是 2,不是通過);空白、`—`、`-` 或已完成的儲存格只計數、不評估——它不算違反,因為 OWT-019 判斷的是「寫了的下一步有沒有點名對象」,沒寫是另一種失效,它不判定。
|
|
350
|
+
|
|
351
|
+
自 1.2.0 起,同一份程式還附上 `uds open-work waiting`(OWT-020–OWT-022)與 `uds open-work observations`(OWT-023–OWT-026),結束碼相同(0 無違反、1 違反、2 判定不了)。今天的日期是被注入的(`--now`),絕不在規則裡讀時鐘,所以結果不會隨日子漂移;`--stale-after` 宣告門檻。兩者都以結構欄位名讀表格與清單項目,中英文皆可。沒有 `observed-by` 也沒有 `observed-at` 欄的表格不被讀成觀察載體;用詞彙裡沒有的字寫成的等待項目,被讀成「不是等待」——所以乾淨的通過只涵蓋被辨認出來的部分,而每次執行都這麼說(OWT-011)。`uds open-work self-test` 對 OWT-020–OWT-026 每一條各跑一個違反的樣本與一個符合的樣本,突變測試顯示拿掉任何一個偵測都會讓某個測試或自測變紅(OWT-015)。與 1.1.0 的檢查相同,它都沒有接進任何 UDS 發版閘門。
|
|
352
|
+
|
|
353
|
+
自 1.3.0 起,`uds open-work waiting` 也會解析點名另一個專案的解除條件(OWT-027–OWT-028):`--root NAME=DIR`(可重複,並與它一直接受的單一 `--root DIR` 並存),或 `uds.project.yaml` 的 `open_work.projects`,說明每個專案在哪裡;看不到的專案被單獨計數。`uds open-work next-action` 與 `separation` 接受 `--next-action-word WORD`(可重複),或 `open_work.next_action_words`,放採用專案的載體所用的詞;`uds open-work next-action` 與 `waiting` 接受 `--command-word 程式名`(可重複;`glab` 與 `dotnet` 內建,`go`、`make`、`sh` 刻意不內建),或 `open_work.command_words`,放它讀成指令的程式。`next-action` 另外會說路徑是在哪個目錄下查找的、那個目錄從哪來,並把 `named-unresolved` 分成 `path-missing`(查過、不在)與 `not-resolvable`(指令、測試名稱、需求編號,從不查找)。檢查本體不讀任何設定檔,是 `uds` 指令把設定傳進去,所以 `node scripts/check-open-work-tracking.mjs` 只接受旗標。
|
|
354
|
+
|
|
355
|
+
自 1.4.0 起,`uds open-work next-action` 以 `waiting` 所用的同一個函式、同一個日期讀每一列的狀態,把處於 `asked-awaiting` 且滿足 OWT-022 的列回報為 `waiting-on-reply`:單獨計數(只有在數量不是 0 時才在計數行尾附上 `waiting-on-reply=N`,所以沒有這種列的載體印出的與過去一模一樣)、在自己的一節裡列出並顯示年齡、不算違反。它接受 `--now`(日期,絕不在規則裡讀時鐘)與 `--stale-after`(預設 7 天,未校準)。**對含有這種列的載體,`next-action` 的結束碼會改變:過去因「未點名」而回 1 的列,現在不再讓它回 1。**沒有狀態欄的載體,或列不在這種狀態的載體,印出的與 1.3.0 完全相同。`uds open-work self-test` 對這個結果附上一個符合的樣本與多個違反的樣本(沒有 `asked-at`、`asked-at` 在未來、沒寫在等什麼、沒有解除事件、`not-yet-asked`、其他狀態、沒有狀態欄的載體、小節標題),以及一個同時讀 `waiting` 與 `next-action`、要求兩者一致的自測臂。
|
|
290
356
|
|
|
291
357
|
本標準做的事,是讓那個決定顯形:OWT-014 保證這裡每一條**能**被判定,OWT-015 固定
|
|
292
358
|
「一次判定要算數需要什麼」,OWT-005/OWT-011 固定「一次不完整的判定容許印出什麼」。
|
|
@@ -315,6 +381,12 @@ DEX-003 扮演的角色相同。上面每一條都指名了 artefact 與它們
|
|
|
315
381
|
或修訂紀錄的標題詞彙;它認得的指令名清單;副檔名清單;需求編號的樣式。
|
|
316
382
|
沒有任何一項對照過真實使用量測,採用專案應傳入自己的。
|
|
317
383
|
|
|
384
|
+
**1.2.0 的新增(OWT-020–OWT-026)**來自一個採用專案在 2026-10-07 對 6.14.0-beta.5 的測試回報(XSPEC-459):一則草擬了從沒送出的訊息,與一則已送出、沒人回的訊息分不出來;助理無法觀察的事實,沒有一個被認可的地方可以寫。那支參考判定程序只有幾小時大、只有一位作者,跑過的是人造樣本,不是真實的待辦。依 OWT-016,它用到的一切類似閾值的東西都是**未校準、初始判斷**:中英文的狀態詞與欄位名、被當成「可推導」的主題清單、「觀察已舊」預設的 7 天、以及日期的讀法(必須有年份;時間不看)。沒有任何一項對照過真實使用量測,採用專案應以自己的詞彙與門檻取代預設。
|
|
385
|
+
|
|
386
|
+
**1.3.0 的新增(OWT-027–OWT-029)**來自同一個採用專案在 2026-10-07 的工作(XSPEC-460 與 XSPEC-461):一個專案的項目在等另一個專案的產出,而當時唯一的紀錄方式是臨時約定;另有一位使用者的載體一個狀態一張表,`next-action` 回了 2,卻沒有說為什麼。依 OWT-016,新的查找所用到的一切類似閾值的東西都是**未校準、初始判斷**:構成邏輯名稱的樣式、機器專屬的路徑前綴、它能查找的兩種物件(路徑與標籤),以及「下一步」詞——內建清單,與它拒絕收進 `待辦`、`後續`、`Next`、`TODO`、`Action` 的決定。沒有任何一項對照過真實使用量測。
|
|
387
|
+
|
|
388
|
+
**1.4.0 的新增(沒有新的要求編號)**來自同一個採用專案對 6.14.0-beta.5 的測試(2026-10-07,XSPEC-464):它的 17 個下一步欄位中有 14 個是「等對方回信」「等排時間」或「等撤銷」;`waiting` 接受這些列、`next-action` 卻拒絕同一批列;而該專案拒絕只為了讓檢查通過而改寫自己的載體。依 OWT-016,新結果用到的一切類似閾值的東西都是**未校準、初始判斷**:「已舊」的 7 天是 OWT-025 本來就帶的預設,未經量測就沿用,而狀態詞就是 OWT-020 讀的那些。這個結果只和載體的紀錄一樣好:只寫了解除條件、沒寫問的日期的載體,在補上日期之前仍由 OWT-019 判定。
|
|
389
|
+
|
|
318
390
|
---
|
|
319
391
|
|
|
320
392
|
## 與其他標準的關係
|
|
@@ -332,3 +404,7 @@ DEX-003 扮演的角色相同。上面每一條都指名了 artefact 與它們
|
|
|
332
404
|
而不是揭露一次就放著。
|
|
333
405
|
- OWT-018 掛在與 OWT-007 相同的交回點:沒有核可者的意圖修改,是在那裡多列出來的一項,
|
|
334
406
|
而且與列在那裡的一切相同,永不阻斷。
|
|
407
|
+
- OWT-020–OWT-022 細化 OWT-002(等待項目說明在等什麼與解除條件),說明那是哪一種等待;OWT-023–OWT-026 與 OWT-003、OWT-006 並列——前者說什麼可以生成、什麼不可以,後者說看不到的絕不被算成零。
|
|
408
|
+
- OWT-027–OWT-029 把 OWT-002 延伸過專案的邊界(解除條件可以是另一個專案的物件),並連同 OWT-006:這台機器看不到的專案被單獨計數,絕不算成已解除、也絕不算成零。
|
|
409
|
+
|
|
410
|
+
- OWT-019 與 OWT-022 在一點上交會(1.4.0):處於 `asked-awaiting` 並滿足 OWT-022 的項目由 OWT-022 判定,它的下一步可以就是它等的那個回覆;其他每一個下一步照舊由 OWT-019 判定。
|