universal-dev-standards 6.13.1 → 6.14.0-beta.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +13 -3
- package/bin/uds.js +75 -3
- package/bundled/ai/options/code-review/pr-review.ai.yaml +20 -1
- package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
- package/bundled/ai/standards/ai-response-navigation.ai.yaml +43 -3
- package/bundled/ai/standards/checkin-standards.ai.yaml +25 -6
- package/bundled/ai/standards/code-review.ai.yaml +15 -2
- package/bundled/ai/standards/commit-message.ai.yaml +18 -4
- package/bundled/ai/standards/developer-memory.ai.yaml +12 -2
- package/bundled/ai/standards/full-coverage-testing.ai.yaml +86 -7
- package/bundled/ai/standards/open-work-tracking.ai.yaml +254 -4
- package/bundled/ai/standards/pipeline-security-gates.ai.yaml +53 -4
- package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
- package/bundled/ai/standards/turn-completion-integrity.ai.yaml +14 -7
- package/bundled/core/ai-response-navigation.md +128 -12
- package/bundled/core/code-review-checklist.md +20 -2
- package/bundled/core/commit-message-guide.md +22 -19
- package/bundled/core/developer-memory.md +12 -2
- package/bundled/core/full-coverage-testing.md +99 -5
- package/bundled/core/open-work-tracking.md +251 -8
- package/bundled/core/pipeline-security-gates.md +63 -0
- package/bundled/core/project-context-memory.md +10 -2
- package/bundled/core/turn-completion-integrity.md +58 -11
- package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
- package/bundled/extensions/languages/csharp-style.md +464 -0
- package/bundled/extensions/languages/php-style.md +700 -0
- package/bundled/extensions/locales/zh-cn.md +717 -0
- package/bundled/extensions/locales/zh-tw.md +717 -0
- package/bundled/hooks/check-turn-completion-agy.mjs +147 -0
- package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
- package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
- package/bundled/locales/COVERAGE.md +5 -4
- package/bundled/locales/zh-CN/CHANGELOG.md +211 -3
- package/bundled/locales/zh-CN/README.md +3 -3
- package/bundled/locales/zh-CN/SECURITY.md +3 -1
- package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
- package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
- package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
- package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
- package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
- package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
- package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
- package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
- package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
- package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
- package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
- package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
- package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
- package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
- package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
- package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
- package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
- package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
- package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
- package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
- package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
- package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
- package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
- package/bundled/locales/zh-CN/core/code-review-checklist.md +54 -23
- package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
- package/bundled/locales/zh-CN/core/database-standards.md +115 -114
- package/bundled/locales/zh-CN/core/developer-memory.md +159 -60
- package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
- package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
- package/bundled/locales/zh-CN/core/execution-history.md +2 -1
- package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
- package/bundled/locales/zh-CN/core/full-coverage-testing.md +103 -9
- package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
- package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
- package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
- package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
- package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
- package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
- package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
- package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
- package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
- package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
- package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
- package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
- package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
- package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
- package/bundled/locales/zh-CN/core/security-decision.md +45 -70
- package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
- package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
- package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
- package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
- package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
- package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
- package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
- package/bundled/locales/zh-CN/core/test-governance.md +94 -43
- package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
- package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
- package/bundled/locales/zh-CN/core/token-budget.md +44 -80
- package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
- package/bundled/locales/zh-CN/core/turn-completion-integrity.md +46 -13
- package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
- package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
- package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
- package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
- package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
- package/bundled/locales/zh-CN/docs/CHEATSHEET.md +11 -2
- package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +76 -40
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +32 -15
- package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
- package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
- package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
- package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
- package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
- package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +46 -0
- package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
- package/bundled/locales/zh-CN/docs/user/README.md +4 -2
- package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
- package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
- package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
- package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
- package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
- package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
- package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
- package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
- package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
- package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
- package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
- package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
- package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
- package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
- package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
- package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
- package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
- package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
- package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
- package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
- package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
- package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
- package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
- package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
- package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
- package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
- package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
- package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
- package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
- package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
- package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
- package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
- package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
- package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
- package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
- package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
- package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
- package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
- package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
- package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
- package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
- package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
- package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/skills/README.md +3 -1
- package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
- package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
- package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
- package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
- package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
- package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
- package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
- package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
- package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
- package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
- package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
- package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
- package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
- package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
- package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
- package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
- package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
- package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
- package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
- package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
- package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
- package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
- package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
- package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
- package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
- package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
- package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
- package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
- package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
- package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
- package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
- package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
- package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
- package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
- package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
- package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
- package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
- package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
- package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
- package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
- package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
- package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
- package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
- package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
- package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
- package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
- package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
- package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
- package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
- package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
- package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
- package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
- package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
- package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
- package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
- package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
- package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
- package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
- package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
- package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
- package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
- package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
- package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
- package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
- package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
- package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
- package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
- package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
- package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
- package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
- package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
- package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
- package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
- package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
- package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
- package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
- package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
- package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
- package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
- package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
- package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
- package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
- package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
- package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
- package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
- package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
- package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
- package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
- package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
- package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
- package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
- package/bundled/locales/zh-TW/CHANGELOG.md +211 -3
- package/bundled/locales/zh-TW/README.md +3 -3
- package/bundled/locales/zh-TW/SECURITY.md +3 -1
- package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
- package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
- package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
- package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
- package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
- package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
- package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
- package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
- package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
- package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
- package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
- package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
- package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
- package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
- package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
- package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
- package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
- package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
- package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
- package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
- package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
- package/bundled/locales/zh-TW/core/code-review-checklist.md +36 -7
- package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
- package/bundled/locales/zh-TW/core/database-standards.md +2 -1
- package/bundled/locales/zh-TW/core/developer-memory.md +111 -12
- package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
- package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
- package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
- package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
- package/bundled/locales/zh-TW/core/execution-history.md +2 -1
- package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
- package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
- package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
- package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
- package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
- package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
- package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
- package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
- package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
- package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
- package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
- package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
- package/bundled/locales/zh-TW/core/open-work-tracking.md +164 -9
- package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
- package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
- package/bundled/locales/zh-TW/core/project-context-memory.md +215 -31
- package/bundled/locales/zh-TW/core/project-structure.md +240 -19
- package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
- package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
- package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
- package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
- package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
- package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
- package/bundled/locales/zh-TW/core/security-decision.md +43 -84
- package/bundled/locales/zh-TW/core/security-standards.md +204 -25
- package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
- package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
- package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
- package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
- package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
- package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
- package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
- package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
- package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
- package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
- package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
- package/bundled/locales/zh-TW/core/test-governance.md +92 -32
- package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
- package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
- package/bundled/locales/zh-TW/core/token-budget.md +41 -112
- package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
- package/bundled/locales/zh-TW/core/turn-completion-integrity.md +46 -13
- package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
- package/bundled/locales/zh-TW/core/versioning.md +6 -2
- package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
- package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
- package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
- package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
- package/bundled/locales/zh-TW/docs/CHEATSHEET.md +11 -2
- package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +69 -33
- package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +32 -15
- package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
- package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
- package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
- package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
- package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
- package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +46 -0
- package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
- package/bundled/locales/zh-TW/docs/user/README.md +2 -0
- package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
- package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
- package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
- package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
- package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
- package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
- package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
- package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
- package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
- package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
- package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
- package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
- package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
- package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
- package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
- package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
- package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
- package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
- package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
- package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
- package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
- package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
- package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
- package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
- package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
- package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
- package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
- package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
- package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
- package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
- package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
- package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
- package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
- package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
- package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
- package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
- package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
- package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
- package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
- package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
- package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/skills/README.md +3 -1
- package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
- package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
- package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
- package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
- package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
- package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
- package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
- package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
- package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
- package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
- package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
- package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
- package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
- package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
- package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
- package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
- package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
- package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
- package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
- package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
- package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
- package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
- package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
- package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
- package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
- package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
- package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
- package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
- package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
- package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
- package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
- package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
- package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
- package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
- package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
- package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
- package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
- package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
- package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
- package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
- package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
- package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
- package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
- package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
- package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
- package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
- package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
- package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
- package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
- package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
- package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
- package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
- package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
- package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
- package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
- package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
- package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
- package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
- package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
- package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
- package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
- package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
- package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
- package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
- package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
- package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
- package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
- package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
- package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
- package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
- package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
- package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
- package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
- package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
- package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
- package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
- package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
- package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
- package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
- package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
- package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
- package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
- package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
- package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
- package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
- package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
- package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
- package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
- package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
- package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
- package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
- package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
- package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
- package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
- package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
- package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
- package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
- package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
- package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
- package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
- package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
- package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
- package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
- package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
- package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
- package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
- package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
- package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
- package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
- package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
- package/bundled/skills/README.md +1 -0
- package/bundled/skills/SKILL_NAMING.md +9 -0
- package/bundled/skills/commit-standards/SKILL.md +2 -2
- package/bundled/skills/commit-standards/guide.md +3 -2
- package/bundled/skills/commit-standards/language-options.md +19 -17
- package/bundled/skills/comprehension-ladder/SKILL.md +283 -0
- package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
- package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
- package/bundled/templates/gates/check-stubs.mjs +644 -0
- package/package.json +5 -3
- package/src/commands/audit.js +20 -2
- package/src/commands/check.js +155 -28
- package/src/commands/deps.js +31 -1
- package/src/commands/hitl.js +3 -0
- package/src/commands/init.js +173 -49
- package/src/commands/list.js +12 -3
- package/src/commands/mcp.js +2 -3
- package/src/commands/open-work.js +123 -0
- package/src/commands/quickstart.js +29 -13
- package/src/commands/release.js +102 -19
- package/src/commands/run-intent.js +10 -0
- package/src/commands/simulate.js +20 -8
- package/src/commands/skills.js +59 -33
- package/src/commands/spec-split.js +30 -17
- package/src/commands/spec.js +55 -21
- package/src/commands/uninstall.js +146 -32
- package/src/commands/update.js +471 -93
- package/src/core/install-records.js +192 -0
- package/src/core/manifest.js +12 -10
- package/src/core/marketplace-sentinel.js +5 -0
- package/src/core/open-work-config.js +122 -0
- package/src/core/project-config.js +92 -38
- package/src/flows/init-flow.js +10 -0
- package/src/hitl/manager.js +4 -2
- package/src/i18n/messages.js +413 -78
- package/src/installers/hooks-installer.js +320 -24
- package/src/installers/integration-installer.js +5 -1
- package/src/installers/skills-installer.js +3 -1
- package/src/installers/standards-installer.js +16 -23
- package/src/mcp/__tests__/server.test.js +0 -1
- package/src/mcp/server.js +16 -4
- package/src/prompts/init.js +148 -13
- package/src/reconciler/backup-locations.js +80 -0
- package/src/reconciler/backup-manager.js +451 -123
- package/src/reconciler/index.js +86 -10
- package/src/reconciler/install-roots.js +90 -0
- package/src/reconciler/plan-executor.js +37 -15
- package/src/uninstallers/hook-uninstaller.js +323 -33
- package/src/uninstallers/integration-uninstaller.js +35 -5
- package/src/uninstallers/skills-uninstaller.js +95 -16
- package/src/uninstallers/standards-uninstaller.js +56 -7
- package/src/utils/agents-installer.js +10 -17
- package/src/utils/available-standards-report.js +144 -0
- package/src/utils/available-standards.js +216 -0
- package/src/utils/command-hash-ownership.js +103 -0
- package/src/utils/commit-message-judge.js +155 -0
- package/src/utils/copier.js +80 -2
- package/src/utils/deps-applicability.js +25 -0
- package/src/utils/detector.js +46 -1
- package/src/utils/friction-detector.js +27 -0
- package/src/utils/gate-scripts.js +141 -0
- package/src/utils/git-hooks.js +139 -7
- package/src/utils/hasher.js +36 -0
- package/src/utils/health-scorer.js +10 -7
- package/src/utils/installed-names-ownership.js +114 -0
- package/src/utils/integration-generator.js +36 -24
- package/src/utils/legacy-hook-migration.js +112 -0
- package/src/utils/locale.js +19 -0
- package/src/utils/open-work-tracking.mjs +1754 -0
- package/src/utils/prompt-closed.js +18 -0
- package/src/utils/sdd-header.js +66 -0
- package/src/utils/skill-frontmatter.js +102 -0
- package/src/utils/skill-hash-ownership.js +64 -0
- package/src/utils/skill-name-collision.js +169 -0
- package/src/utils/skills-install-paths.js +114 -0
- package/src/utils/skills-installer.js +75 -106
- package/src/utils/standard-validator.js +98 -27
- package/src/utils/test-change-check.js +160 -0
- package/src/utils/test-policy.js +214 -0
- package/src/utils/transient-fs.js +113 -0
- package/src/utils/update-summary.js +29 -0
- package/src/vibe/micro-spec.js +15 -0
- package/standards-registry.json +48 -9
|
@@ -2,36 +2,39 @@
|
|
|
2
2
|
source: ../../../core/ai-instruction-standards.md
|
|
3
3
|
source_version: 1.1.1
|
|
4
4
|
translation_version: 1.1.1
|
|
5
|
-
last_synced: 2026-
|
|
5
|
+
last_synced: 2026-10-11
|
|
6
|
+
source_hash: 64bcd0b65483
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
9
10
|
# AI 指令文件规范
|
|
10
11
|
|
|
11
|
-
> **语言**: [English](../../../core/ai-instruction-standards.md) | [
|
|
12
|
+
> **语言**: [English](../../../core/ai-instruction-standards.md) | [繁體中文](../../zh-TW/core/ai-instruction-standards.md) | 简体中文
|
|
12
13
|
|
|
13
|
-
**版本**: 1.1.
|
|
14
|
-
**最后更新**: 2026-
|
|
14
|
+
**版本**: 1.1.1
|
|
15
|
+
**最后更新**: 2026-08-19
|
|
15
16
|
**适用范围**: 所有使用 AI 编码助手的项目
|
|
17
|
+
**范围**: partial
|
|
18
|
+
**行业标准**: 无(新兴 AI 工具实践)
|
|
16
19
|
|
|
17
20
|
---
|
|
18
21
|
|
|
19
22
|
## 目的
|
|
20
23
|
|
|
21
|
-
本规范定义创建和维护 AI 指令文件(又称「系统提示词文件」)的最佳实践。这些文件引导 AI 助手理解项目特定的惯例、标准和工作流程。
|
|
24
|
+
本规范定义创建和维护 AI 指令文件(又称「系统提示词文件」)的最佳实践。这些文件引导 AI 助手理解项目特定的惯例、标准和工作流程。v1.1.0 将范围扩展到 skill 层级的指令文件(SKILL.md),并新增 i18n 策略。
|
|
22
25
|
|
|
23
26
|
---
|
|
24
27
|
|
|
25
28
|
## 支持的 AI 工具
|
|
26
29
|
|
|
27
|
-
| AI 工具 | 指令文件 | 格式 |
|
|
28
|
-
|
|
29
|
-
| Claude Code | `CLAUDE.md` | Markdown |
|
|
30
|
-
| Cursor | `.cursorrules` | Markdown |
|
|
31
|
-
| Windsurf | `.windsurfrules` | Markdown |
|
|
32
|
-
| Cline | `.clinerules` | Markdown |
|
|
33
|
-
| GitHub Copilot | `.github/copilot-instructions.md` | Markdown |
|
|
34
|
-
| OpenCode | `.opencode/instructions.md` | Markdown |
|
|
30
|
+
| AI 工具 | 指令文件 | 格式 | Skill 层级指令 |
|
|
31
|
+
|---------|---------|------|---------------|
|
|
32
|
+
| Claude Code | `CLAUDE.md` | Markdown | `.claude/skills/{name}/SKILL.md` |
|
|
33
|
+
| Cursor | `.cursorrules` | Markdown | n/a |
|
|
34
|
+
| Windsurf | `.windsurfrules` | Markdown | n/a |
|
|
35
|
+
| Cline | `.clinerules` | Markdown | n/a |
|
|
36
|
+
| GitHub Copilot | `.github/copilot-instructions.md` | Markdown | n/a |
|
|
37
|
+
| OpenCode | `.opencode/instructions.md` | Markdown | n/a |
|
|
35
38
|
|
|
36
39
|
---
|
|
37
40
|
|
|
@@ -173,85 +176,104 @@ AI 指令档常需提供多语言版本——既为了国际采用者,也为
|
|
|
173
176
|
| 层 | 内容 | Canonical (en) | Locale ({lang}) | 为何分这层 |
|
|
174
177
|
|----|------|---------------|----------------|-----------|
|
|
175
178
|
| **L1 — Metadata** | YAML frontmatter `description`、`argument-hint`、`allowed-tools` | **必须英文** | **必须对应 locale 语言** | AI 触发讯号;英文 token 效率最高 + 训练语料密度高 |
|
|
176
|
-
| **L2 — 指令(Instructions)** | 对 AI
|
|
177
|
-
| **L3 — 输出范本(Output Templates)** | 范例输出、回应格式、情境范本 | 英文(canonical 锁定英文)| **强制对应 locale**(mandatory)| **唯一直接影响 AI
|
|
178
|
-
| **L4 — 人类文件** |
|
|
179
|
+
| **L2 — 指令(Instructions)** | 对 AI 的命令式规则(步骤、行为、allowed-tools 的理由) | **必须英文** | 对应 locale 语言(可选;可保留英文)| AI 读英文指令最精准;只有维护者需要以自己的语言阅读指令时,locale 版才有用 |
|
|
180
|
+
| **L3 — 输出范本(Output Templates)** | 范例输出、回应格式、情境范本 | 英文(canonical 锁定英文)| **强制对应 locale**(mandatory)| **唯一直接影响 AI 输出语言的层**——AI 会沿用它看到的范本语言 |
|
|
181
|
+
| **L4 — 人类文件** | 维护者注解、操作说明、贡献者说明 | 英文 | 对应 locale 语言(强烈建议)| 给人类维护者读,AI 不读 |
|
|
179
182
|
|
|
180
|
-
**关键 insight**:L1(description)是 AI 用来决定「**是否调用**」此 skill 的触发讯号——它**不**影响 AI 之后说什么。L3(output template)才是控制 AI
|
|
183
|
+
**关键 insight**:L1(description)是 AI 用来决定「**是否调用**」此 skill 的触发讯号——它**不**影响 AI 之后说什么。L3(output template)才是控制 AI 输出语言的唯一开关,因为 AI 会模仿它看到的范本语言。**i18n 强制检查应该聚焦在 L3——加强 L1 的强制是常见错误,解决的是错的问题。**
|
|
181
184
|
|
|
182
185
|
### Canonical / Locale 档案结构
|
|
183
186
|
|
|
184
187
|
UDS 标准与 skill 的 locale 变体结构:
|
|
185
188
|
|
|
186
189
|
```text
|
|
187
|
-
core/{name}.md
|
|
188
|
-
core/{name}.ai.yaml
|
|
189
|
-
locales/{lang}/core/{name}.md
|
|
190
|
-
locales/{lang}/ai/standards/{name}.ai.yaml
|
|
191
|
-
skills/{name}/SKILL.md
|
|
192
|
-
locales/{lang}/skills/{name}/SKILL.md
|
|
190
|
+
core/{name}.md ← canonical (English) — single source of truth
|
|
191
|
+
core/{name}.ai.yaml ← canonical structured (English)
|
|
192
|
+
locales/{lang}/core/{name}.md ← locale variant (matches lang)
|
|
193
|
+
locales/{lang}/ai/standards/{name}.ai.yaml ← locale .ai.yaml (matches lang)
|
|
194
|
+
skills/{name}/SKILL.md ← canonical skill (English)
|
|
195
|
+
locales/{lang}/skills/{name}/SKILL.md ← locale skill variant
|
|
193
196
|
```
|
|
194
197
|
|
|
195
198
|
**命名惯例**:使用 BCP 47 语言标签——`zh-TW`、`zh-CN`、`ja`、`ko`、`en-US` 等。
|
|
196
199
|
|
|
197
200
|
### Locale 变体 Frontmatter 必填栏位
|
|
198
201
|
|
|
202
|
+
每个 locale 变体都必须带有可追溯的 frontmatter,才能侦测漂移:
|
|
203
|
+
|
|
199
204
|
```yaml
|
|
200
205
|
---
|
|
201
|
-
name: {
|
|
202
|
-
source: {
|
|
203
|
-
source_version: {
|
|
204
|
-
translation_version: {
|
|
206
|
+
name: {same name as canonical}
|
|
207
|
+
source: {relative path back to canonical}
|
|
208
|
+
source_version: {version of canonical at time of translation}
|
|
209
|
+
translation_version: {version of this translation}
|
|
205
210
|
---
|
|
206
211
|
```
|
|
207
212
|
|
|
208
|
-
`source_version` 落后超过 2 个 minor 版本会触发 drift
|
|
213
|
+
canonical 更新(bump `source_version`)时,locale 维护者应重新同步并 bump `translation_version`。`source_version` 落后超过 2 个 minor 版本会触发 drift 警告(见「Chimera 防范」)。
|
|
209
214
|
|
|
210
215
|
### 责任边界
|
|
211
216
|
|
|
212
217
|
| 角色 | 拥有 | 必须做 |
|
|
213
218
|
|------|------|--------|
|
|
214
|
-
| **Canonical 拥有者** | `core/{name}.md`
|
|
215
|
-
| **Locale 维护者** | `locales/{lang}/...` | `translation_version` 对齐 `source_version`;翻译 L1(必)、L2(选)、L3(必)、L4(建议)|
|
|
216
|
-
|
|
|
219
|
+
| **Canonical 拥有者** | `core/{name}.md`、`core/{name}.ai.yaml`、`skills/{name}/SKILL.md` | 维持 L1/L2/L3/L4 为英文;每次 breaking change 都 bump `source_version` |
|
|
220
|
+
| **Locale 维护者** | `locales/{lang}/...` 档案 | `translation_version` 对齐 `source_version`;翻译 L1(必)、L2(选)、L3(必)、L4(建议)|
|
|
221
|
+
| **采用者(下游项目)** | 自己的 `.claude/skills/`、`CLAUDE.md` 等 | 用 `uds init --locale {lang}`(首次)或 `uds update --locale {lang}`(重新同步)安装;**绝不**手动修改 canonical 档案(一律编辑 locale 变体或使用 overlay)|
|
|
217
222
|
|
|
218
223
|
### Chimera 防范
|
|
219
224
|
|
|
225
|
+
**Chimera** 指违反分层规则、混用语言的档案。常见的 chimera 模式:
|
|
226
|
+
|
|
220
227
|
| 模式 | 严重度 | 侦测方式 |
|
|
221
228
|
|------|--------|----------|
|
|
222
|
-
| Canonical 的 `description`
|
|
223
|
-
| Locale 变体的 `description`
|
|
224
|
-
| Locale 变体缺 `source:` frontmatter | ❌ Error | Lint |
|
|
225
|
-
| Canonical L3
|
|
226
|
-
|
|
|
227
|
-
| `translation_version`
|
|
229
|
+
| Canonical 的 `description` 栏位含 CJK | ❌ Error | Lint: `canonical:description-must-be-ascii` |
|
|
230
|
+
| Locale 变体的 `description` 栏位是纯 ASCII | ❌ Error | Lint: `locale:description-must-match-language` |
|
|
231
|
+
| Locale 变体缺 `source:` frontmatter | ❌ Error | Lint: `locale:must-have-source-frontmatter` |
|
|
232
|
+
| Canonical L3 输出范本含非英文范例回应 | ⚠️ Warn | Lint: `canonical:l3-language-consistency` |
|
|
233
|
+
| `.claude/skills/` 中的采用者档案与 canonical 及任何 locale 变体都不同 | ⚠️ Warn | Sync check: `adopter:must-match-installed-locale` |
|
|
234
|
+
| `translation_version` 落后 `source_version` 超过 2 个 minor 版本 | ⚠️ Warn | Drift check |
|
|
235
|
+
|
|
236
|
+
Pre-commit / CI lint 应强制执行 error 级规则;warn 级规则显示在仪表板上,但不阻断。
|
|
228
237
|
|
|
229
238
|
### 采用者安装
|
|
230
239
|
|
|
240
|
+
采用者通过 UDS CLI 安装指令档:
|
|
241
|
+
|
|
231
242
|
```bash
|
|
232
|
-
uds init --locale zh-
|
|
233
|
-
uds update --locale zh-
|
|
243
|
+
uds init --locale zh-tw # first-time install of skills + standards in Traditional Chinese
|
|
244
|
+
uds update --locale zh-tw # re-sync an existing adoption
|
|
234
245
|
```
|
|
235
246
|
|
|
236
|
-
**Locale
|
|
247
|
+
**Locale 解析优先顺序**:
|
|
248
|
+
1. `--locale` CLI flag(最高优先)
|
|
249
|
+
2. `.uds/install.yaml` 的 `locale:` 栏位
|
|
250
|
+
3. 环境变量 `UDS_LOCALE`
|
|
251
|
+
4. Fallback:`en`
|
|
252
|
+
|
|
253
|
+
**Locale 不存在时的 fallback**:某个 skill 没有所请求的 locale 变体时,CLI 会:
|
|
254
|
+
- 安装 canonical(英文)档案
|
|
255
|
+
- 发出 WARN,列出改用 fallback 的 skills
|
|
256
|
+
- **不**阻断安装
|
|
237
257
|
|
|
238
|
-
|
|
258
|
+
这让 locale 覆盖不完整时,采用者仍能正常安装。采用者可查阅 `locales/COVERAGE.md`,取得哪些已翻译、哪些未翻译的权威清单。
|
|
239
259
|
|
|
240
260
|
### 迁移:已有 chimera 的采用者
|
|
241
261
|
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
262
|
+
若采用者已在自己的项目中手动修改过 canonical 档案(例如翻译了 `.claude/skills/` 里的 description):
|
|
263
|
+
|
|
264
|
+
1. **辨识 chimera**:比对采用者档案与 UDS canonical 及 canonical 的 locale 变体。
|
|
265
|
+
2. **安装正确变体**:执行 `uds update --locale {lang}`,以 locale 变体取代 chimera 档案。
|
|
266
|
+
3. **保留项目级客制**:若 chimera 含有正当的项目级客制(不只是翻译),将其抽出为 overlay,或记录在采用者的客制化纪录中(例如 `UDS-CUSTOMIZATION.md`)。
|
|
267
|
+
4. **丢弃纯翻译**:只是翻译的 chimera 变更应丢弃——正确的 locale 变体会取代它们。
|
|
246
268
|
|
|
247
269
|
### 快速参考
|
|
248
270
|
|
|
249
271
|
| 动作 | 何时 | 工具 / 档案 |
|
|
250
272
|
|------|------|------------|
|
|
251
|
-
| 新增语言支援 | 想支援新 locale | `locales/{lang}
|
|
252
|
-
| 更新 canonical | 改进英文 source | Bump `source_version
|
|
253
|
-
| 翻译 / 同步 locale | 新增或更新 locale 内容 | Bump `translation_version` |
|
|
254
|
-
| 检查覆盖率 | 定期 review | `locales/COVERAGE.md` |
|
|
273
|
+
| 新增语言支援 | 想支援新 locale | 建立 `locales/{lang}/...`,镜射 canonical 结构 |
|
|
274
|
+
| 更新 canonical | 改进英文 source | Bump `source_version`;通知 locale 维护者 |
|
|
275
|
+
| 翻译 / 同步 locale | 新增或更新 locale 内容 | Bump `translation_version`;引用当前的 `source_version` |
|
|
276
|
+
| 检查覆盖率 | 定期 review | 查看自动产生的 `locales/COVERAGE.md` |
|
|
255
277
|
| 带 locale 安装 | 采用者初设 | `uds init --locale {lang}` |
|
|
256
278
|
| 带 locale 重新同步 | 既有采用 | `uds update --locale {lang}` |
|
|
257
279
|
| 跑 i18n lint | Commit 前 / CI | `uds check --i18n` |
|
|
@@ -1,8 +1,9 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../core/ai-response-navigation.md
|
|
3
|
-
source_version: 1.
|
|
4
|
-
translation_version: 1.
|
|
5
|
-
last_synced: 2026-
|
|
3
|
+
source_version: 1.4.0
|
|
4
|
+
translation_version: 1.4.0
|
|
5
|
+
last_synced: 2026-10-11
|
|
6
|
+
source_hash: 1439c64bce23
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
@@ -10,8 +11,8 @@ status: current
|
|
|
10
11
|
|
|
11
12
|
> **语言**: [English](../../../core/ai-response-navigation.md) | [繁體中文](../../zh-TW/core/ai-response-navigation.md) | 简体中文
|
|
12
13
|
|
|
13
|
-
**版本**: 1.
|
|
14
|
-
**最后更新**: 2026-
|
|
14
|
+
**版本**: 1.4.0
|
|
15
|
+
**最后更新**: 2026-10-05
|
|
15
16
|
**适用范围**: 所有使用 AI 辅助开发的项目
|
|
16
17
|
**范围**: universal
|
|
17
18
|
**行业标准**: 无(新兴 AI 工具实践)
|
|
@@ -27,10 +28,13 @@ status: current
|
|
|
27
28
|
|
|
28
29
|
**解决方案**:在每个实质性 AI 响应结尾附加标准化的「导航区块」,包含情境模板、推荐标记和弹性选项数量。
|
|
29
30
|
|
|
30
|
-
**范围注记(v1.2.0,v1.3.0 扩充)**:规则 1–6 管的是答案**之后**要附什么。
|
|
31
|
-
规则 7–
|
|
32
|
-
白话是主语(R10)、每个选项都要带自己的利弊而非只有推荐项有(R11
|
|
33
|
-
|
|
31
|
+
**范围注记(v1.2.0,v1.3.0、v1.4.0 扩充)**:规则 1–6 管的是答案**之后**要附什么。
|
|
32
|
+
规则 7–12 管的是答案本身:先讲发现(R7)、每轮重述进度(R8)、不要开场白(R9)、
|
|
33
|
+
白话是主语(R10)、每个选项都要带自己的利弊而非只有推荐项有(R11)、受控语言(R12)。
|
|
34
|
+
规则 7–11 **属可选**。**规则 12 是唯一的例外,而且只有一部分**:其中「简化后的文字要保留写作者的不确定语气」
|
|
35
|
+
这一条**属必须**,其余部分属可选。新增的理由是——
|
|
36
|
+
一个响应可以满足规则 1–6 的每一条,同时把结论埋起来、用只有作者持有的词汇讲它、列出读者还得自己比较的选项,
|
|
37
|
+
或是靠「比证据更肯定」来变得好读;
|
|
34
38
|
**而找不到答案的读者,不会因为结尾有一个正确的导航区块被告知下一步而得到帮助。**
|
|
35
39
|
|
|
36
40
|
---
|
|
@@ -109,11 +113,13 @@ status: current
|
|
|
109
113
|
|
|
110
114
|
---
|
|
111
115
|
|
|
112
|
-
## 导航之前的那个答案(规则 7–
|
|
116
|
+
## 导航之前的那个答案(规则 7–12)
|
|
113
117
|
|
|
114
118
|
> **规则 7–9 借鉴自**:[`ayghri/i-have-adhd`](https://github.com/ayghri/i-have-adhd)(MIT),十条中取三条。
|
|
115
119
|
> **规则 10–11 于 1.3.0 新增**,来源不同——用户在同一次工作会话中两度指出,
|
|
116
120
|
> 一个正确且完整的回答读不懂。当时规则 7–9 已经出货且正在被遵守。
|
|
121
|
+
> **规则 12 于 1.4.0 新增**,来源又不同:一则公开的建议——请 LLM 写到「大约达到 ASD-STE100 的 80%」
|
|
122
|
+
> (ASD-STE100 是技术文档用的受控英文标准)。只取它的原则;它的英文词典与时态规则不取(见规则 12)。
|
|
117
123
|
> 其余七条删去:两条已被上方规则 1–2 涵盖,五条与本标准冲突
|
|
118
124
|
> (它的「不要 recap/不要结语」与规则 1 的导航区块直接矛盾;它的「列表上限 5 项」
|
|
119
125
|
> 会截断证据表格与遍历分母)或与 [estimation-standards](estimation-standards.md) 重复。
|
|
@@ -122,8 +128,9 @@ status: current
|
|
|
122
128
|
一个响应可以把结论埋在一整面证据底下,只要结尾附上正确的导航区块,
|
|
123
129
|
它仍然满足本标准的每一条。**找不到答案的读者,不会因为被告知下一步而得到帮助。**
|
|
124
130
|
|
|
125
|
-
|
|
126
|
-
|
|
131
|
+
**规则 7–11 是可选的**,语义同规则 6:采用项目不必启用,既有 skill 也不需回头补。
|
|
132
|
+
项目**可以**在自己的配置中把任一条提升为必须。**规则 12 有一条必须(12.1)**,其余(12.2)可选;
|
|
133
|
+
为什么这样分,规则内部有论证。**任何一条都不可选的是它们必须有精确的触发条件**——
|
|
127
134
|
一条松到永远不会启动的规则,与没有这条规则无从分辨。
|
|
128
135
|
|
|
129
136
|
### 规则 7:先讲发现,不要先讲过程(可选)
|
|
@@ -181,6 +188,9 @@ status: current
|
|
|
181
188
|
**为什么它与 R7 是两条**:R7 规范的是**先讲发现再给证据**的顺序。R10 规范的是**语域**——
|
|
182
189
|
一个响应可以先讲发现,却仍然用只有作者持有的词汇讲那个发现。两者都让读者无法行动,但它们是不同的失效。
|
|
183
190
|
|
|
191
|
+
**白话不可以拿肯定语气来换。** 把说明改成读者的话就是一次改写,而改写正是「可能」悄悄变成「是」的地方。
|
|
192
|
+
当 R10 用在写作者原本就有保留的论断上,由[规则 12](#规则-12受控语言部分必须) 的 12.1(必须)管:不确定语气要留着。
|
|
193
|
+
|
|
184
194
|
### 规则 11:每个选项都要带自己的利弊(可选)
|
|
185
195
|
|
|
186
196
|
**触发条件**:要求读者在两个以上做法之间选择的响应。
|
|
@@ -204,6 +214,93 @@ status: current
|
|
|
204
214
|
|
|
205
215
|
**与规则 4 相辅**:选项数维持在 1–5。利弊让每个选项读起来更花力气,所以这条规则让规则 4 的上限**更**要紧,不是更不要紧。
|
|
206
216
|
|
|
217
|
+
### 规则 12:受控语言(部分必须)
|
|
218
|
+
|
|
219
|
+
**触发条件**:为「不是原作者」的读者撰写、改写、缩短、简化或翻译文字——典型是一位非专业的读者,要靠这段文字做判断或审批。
|
|
220
|
+
|
|
221
|
+
受控语言(用变化换可预测性的写作规则)让文字更好读。它有一个已知的失败方式:最好读的句子是肯定的句子,
|
|
222
|
+
所以「简化」会朝肯定的方向漂移。本规则取受控写作的原则,并对这个漂移设一道硬性的止损。
|
|
223
|
+
|
|
224
|
+
#### 12.1 简化后的文字要保留不确定语气(必须)
|
|
225
|
+
|
|
226
|
+
不确定语气是一个告诉读者「这个论断可以信到什么程度」的词:*可能、推断、大概、尚未确认*——
|
|
227
|
+
*might、could、probably、appears to、not yet confirmed*。它是信息,不是赘词。
|
|
228
|
+
|
|
229
|
+
缩短、简化、改写或翻译时:
|
|
230
|
+
|
|
231
|
+
- **不可把不确定的论断改成确定的。** 原文说「可能」,结果就说「可能」(或结果语言里对等的说法)。
|
|
232
|
+
- **不可为了省字而删掉不确定语气。** 目标是更短的句子;更肯定的句子不被允许。
|
|
233
|
+
- **不可加入原文没说的事实**——编出来的原因、编出来的「已确认」,是同一种失败的另一个样子。
|
|
234
|
+
- 只有在论断之后**已经被验证**时,不确定语气才可以拿掉;而且要由验证(查了什么、结果是什么)取代它的位置。
|
|
235
|
+
只删掉不确定语气,不算验证。
|
|
236
|
+
|
|
237
|
+
**为什么只有这一条是必须的**:只有它的失败会让读者**相信不真实的事**,而不只是让文字更难读。
|
|
238
|
+
它也不需要校准——检查就是拿改写前后两份文字比对,人或模型在任何语言都做得到;
|
|
239
|
+
而下面每一个阈值都取决于语言与读者。
|
|
240
|
+
|
|
241
|
+
#### 12.2 白话写作原则(可选)
|
|
242
|
+
|
|
243
|
+
读者是非专业人士时使用。它们与语言无关:每一条都用该语言自己的单位来表达,不附任何词表。
|
|
244
|
+
|
|
245
|
+
| 原则 | 要求什么 |
|
|
246
|
+
|------|----------|
|
|
247
|
+
| **句子短,以该语言自己的单位计** | 一句一个意思。**起始范围**,不是上限:英文大约 15–25 个词,中文大约 25–40 个字。远超过范围是「该拆句」的信号,不是要计数的缺陷。按语言与读者校准 |
|
|
248
|
+
| **同一个东西只用一个名称** | 每个东西选定一个名称,全文都用它。不要为了文采换说法:读者看到第二个名称,会以为是第二个东西 |
|
|
249
|
+
| **主语明确、主动语态** | 说清楚谁做了什么。施事者不明或不重要时,才用被动 |
|
|
250
|
+
| **一步一动作** | 流程是编号列表,每项一个动作,不是一段文字 |
|
|
251
|
+
| **少用分号** | 分号把读者必须同时记住的两个意思接在一起。拆成两句或一份列表 |
|
|
252
|
+
| **数字带单位** | 「30 秒」「3 个文件」「NT$1,200」——不要只写「30」 |
|
|
253
|
+
|
|
254
|
+
**为什么是可选**:上面的范围只是起始点,**没有**对照读者实际理解度校准过,也没有检查器在执行。
|
|
255
|
+
一条**必须**的规则若附带没人能验证的阈值,会产生机械式的遵守——句子被拆到不再像句子——
|
|
256
|
+
而专家读者可能反而更适合比较密的文字。这些原则是写作者凭判断使用的指引;12.1 才是不会弯的那一部分。
|
|
257
|
+
|
|
258
|
+
#### 本规则不取 ASD-STE100 的什么
|
|
259
|
+
|
|
260
|
+
ASD-STE100 的**核可词典**(每个核可的英文单词只有一个意思,并有一份封闭的允许词表)与它的**时态限制**,
|
|
261
|
+
都依赖英文这个语言。它们**不适用于中文**或其他非英文文字,本标准**不附任何形式的词表**。
|
|
262
|
+
只取 12.2 的原则,并改写成每一条都能在任何语言使用。
|
|
263
|
+
|
|
264
|
+
同理,不要用「以空白或 ASCII 字符分词」的计数器去衡量非英文文字:它把一整段中文看成一个「词」,
|
|
265
|
+
不论多长都通过。一把在某个语言上永远是绿灯的量尺,在那个语言上什么也没量到。
|
|
266
|
+
|
|
267
|
+
#### 示例:同一段文字、三种改写,以及一个不被允许的改写
|
|
268
|
+
|
|
269
|
+
示例刻意用中文:本规则与语言无关,而中文正是只靠英文做法行不通的地方。三个有效版本都保留不确定语气
|
|
270
|
+
「可能」、「推断」、「尚未」,且没有加入原文没有的事实。
|
|
271
|
+
|
|
272
|
+
**原文**
|
|
273
|
+
|
|
274
|
+
```text
|
|
275
|
+
经过检查,登录页面在高流量时段响应变慢,这个问题可能是数据库连接池被耗尽所造成的,我们推断是因为上周的改版新增了一个会长时间占用连接的查询;目前尚未在测试环境复现,所以修复后的效果还需要被确认,建议在确认之前先不要对外宣布已经解决。
|
|
276
|
+
```
|
|
277
|
+
|
|
278
|
+
**约 80%**——句子较短,读起来仍像一段文字
|
|
279
|
+
|
|
280
|
+
```text
|
|
281
|
+
登录页面在高流量时段响应变慢。原因可能是数据库连接池被耗尽。我们推断,上周改版新增了一个查询,它会长时间占用连接。这一点尚未在测试环境复现,修复后有没有效,也还没确认。确认之前,建议先不要对外宣布已经解决。
|
|
282
|
+
```
|
|
283
|
+
|
|
284
|
+
**严格**——一行一个意思、加标签、保留不确定语气
|
|
285
|
+
|
|
286
|
+
```text
|
|
287
|
+
登录页面在高流量时段响应变慢。
|
|
288
|
+
1. 原因:可能是数据库连接池被耗尽。
|
|
289
|
+
2. 推断:上周改版新增了一个查询,这个查询可能长时间占用连接。
|
|
290
|
+
3. 状态:尚未在测试环境复现。
|
|
291
|
+
4. 修复效果:尚未确认。
|
|
292
|
+
5. 建议:确认之前,不要对外宣布已解决。
|
|
293
|
+
```
|
|
294
|
+
|
|
295
|
+
**不是有效的改写**——最短,而且是错的
|
|
296
|
+
|
|
297
|
+
```text
|
|
298
|
+
登录页面变慢,原因是数据库连接池被耗尽,已确认由上周改版造成。
|
|
299
|
+
```
|
|
300
|
+
|
|
301
|
+
最后这一版最短、也最好读,却两度违反 12.1:「可能」变成直接陈述的原因,「尚未复现」变成「已确认」,
|
|
302
|
+
而原文从没说过这件事。读者若凭它批准一个修复,就是被给了一件不真实的事。
|
|
303
|
+
|
|
207
304
|
---
|
|
208
305
|
|
|
209
306
|
## 情境模板
|
|
@@ -398,6 +495,7 @@ AI 需要用户做出选择或提供信息时使用。
|
|
|
398
495
|
| R9 | *(可选)* 不要开场白。结语仍为必须——见 R1 |
|
|
399
496
|
| R10 | *(可选)* 白话是主语;标识符放在论断之后当佐证 |
|
|
400
497
|
| R11 | *(可选)* 每个选项都要说明换到什么、代价是什么——不只推荐那一个 |
|
|
498
|
+
| R12 | **12.1 *(必须)***:简化、缩短或翻译时,保留不确定语气——不可把「可能」改成「是」。12.2 *(可选)*:句子短(以该语言自己的单位计)、同物同名、主动语态、一步一动作、少用分号、数字带单位。不附英文词典——它无法移到其他语言 |
|
|
401
499
|
|
|
402
500
|
| 豁免 | 不豁免 |
|
|
403
501
|
|------|--------|
|
|
@@ -421,6 +519,7 @@ AI 需要用户做出选择或提供信息时使用。
|
|
|
421
519
|
|
|
422
520
|
| 版本 | 日期 | 变更 |
|
|
423
521
|
|------|------|------|
|
|
522
|
+
| 1.4.0 | 2026-10-05 | 新增 R12 受控语言(语言中立)。一条必须(12.1:简化后的文字要保留写作者的不确定语气——「可能」不会变成「是」、也不新增原文没有的事实);其余(12.2:以该语言自己的单位计句长、同物同名、主动语态、一步一动作、少用分号、数字带单位)属可选,理由已写进标准。取 ASD-STE100 的原则、不取它的英文词典与时态规则,并在标准里明说。附一组中文改写对照(三种严格度),外加一个更短却错误的改写。R10 现在指向 R12,因为把论断改成白话就是一次改写,而改写正是不确定语气流失的地方 |
|
|
424
523
|
| 1.3.0 | 2026-08-17 | 新增可选规则 R10–R11。R10 管语域:白话是句子的主语、标识符当佐证——与 R7 不同,R7 管的是「先发现后证据」的顺序,而一个响应可以先讲发现却仍用只有作者持有的词汇讲它。R11 把规则 2 从推荐选项扩及全部:只论证推荐项的清单等于把比较丢回给读者,而没标代价的选项读起来像没有代价 |
|
|
425
524
|
| 1.2.0 | 2026-08-17 | 新增可选规则 R7–R9,管答案本身(先讲发现、重述进度、不要开场白)。借鉴自 `ayghri/i-have-adhd`(MIT),十条取三;其余七条因已被 R1–R2 涵盖、与 R1 冲突、或与 estimation-standards 重复而删去。规则 1–6 全部可以被一个把结论埋起来的响应满足——R7–R9 补上这个缺口 |
|
|
426
525
|
| 1.1.0 | 2026-06-10 | 新增规则 R6 可选模型级别标注(`〔模型:Fast|Standard|Capable〕`);与厂商无关;不强制既有技能回改 |
|
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
source: ../../../core/anti-sycophancy-prompting.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: 860d9e77855b
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
@@ -20,9 +21,9 @@ status: current
|
|
|
20
21
|
|
|
21
22
|
## 目的
|
|
22
23
|
|
|
23
|
-
本标准定义一套技法与规则,用于设计能让 LLM
|
|
24
|
+
本标准定义一套技法与规则,用于设计能让 LLM 给出真实、批判性回应的提示词,而非迎合用户的隐含偏好。
|
|
24
25
|
|
|
25
|
-
LLM 的迎合性源自 RLHF
|
|
26
|
+
LLM 的迎合性源自 RLHF 训练目标:人类评分者倾向于给予令人愉快的回应高分,导致模型将「让用户满意」置于「准确性」之上。
|
|
26
27
|
|
|
27
28
|
---
|
|
28
29
|
|
|
@@ -40,31 +41,31 @@ LLM 的迎合性源自 RLHF 训练目标:人类评分者倾向于给予令人
|
|
|
40
41
|
|
|
41
42
|
**Prompt 模板**:
|
|
42
43
|
```
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
44
|
+
Do not evaluate whether this is good or bad.
|
|
45
|
+
List the 3 most fatal objections to: [idea]
|
|
46
|
+
Each objection must be technically grounded and non-trivial to dismiss.
|
|
46
47
|
```
|
|
47
48
|
|
|
48
49
|
---
|
|
49
50
|
|
|
50
51
|
### 2. 先问立场防锚定协议(REQ-2)
|
|
51
52
|
|
|
52
|
-
|
|
53
|
+
在用户揭示立场前先取得 LLM 的独立判断,防止锚定效应。
|
|
53
54
|
|
|
54
55
|
| 步骤 | 动作 |
|
|
55
56
|
|------|------|
|
|
56
57
|
| 1 | 在未揭示偏好的情况下询问中立比较 |
|
|
57
58
|
| 2 | 取得独立判断 |
|
|
58
|
-
| 3 |
|
|
59
|
+
| 3 | 揭示用户立场 |
|
|
59
60
|
| 4 | 若模型改变立场,要求提出明确的技术理由 |
|
|
60
61
|
|
|
61
62
|
**工作流程**:
|
|
62
63
|
```
|
|
63
|
-
|
|
64
|
-
→
|
|
64
|
+
Round 1: "Compare [A] vs [B] for [context]. Which is better?"
|
|
65
|
+
→ Wait for independent judgment
|
|
65
66
|
|
|
66
|
-
|
|
67
|
-
→
|
|
67
|
+
Round 2: "I prefer [A]. Does this change your assessment? Why?"
|
|
68
|
+
→ Model must justify any position change with technical facts
|
|
68
69
|
```
|
|
69
70
|
|
|
70
71
|
---
|
|
@@ -75,11 +76,11 @@ LLM 的迎合性源自 RLHF 训练目标:人类评分者倾向于给予令人
|
|
|
75
76
|
|
|
76
77
|
**必要格式**:
|
|
77
78
|
```
|
|
78
|
-
|
|
|
79
|
-
|
|
80
|
-
| [
|
|
79
|
+
| Arguments FOR the decision | Arguments AGAINST the decision |
|
|
80
|
+
|---------------------------|-------------------------------|
|
|
81
|
+
| [Equal weight content] | [Equal weight content] |
|
|
81
82
|
|
|
82
|
-
|
|
83
|
+
Net Recommendation: [Must take a clear stance, may recommend against]
|
|
83
84
|
```
|
|
84
85
|
|
|
85
86
|
**规则**:
|
|
@@ -95,9 +96,9 @@ LLM 的迎合性源自 RLHF 训练目标:人类评分者倾向于给予令人
|
|
|
95
96
|
|
|
96
97
|
**格式**:
|
|
97
98
|
```
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
99
|
+
Recommendation: [specific action]
|
|
100
|
+
Confidence: [1-5] — [reason for uncertainty]
|
|
101
|
+
Unknown: [what information would change this assessment]
|
|
101
102
|
```
|
|
102
103
|
|
|
103
104
|
**信心度定义**:
|
|
@@ -124,7 +125,7 @@ LLM 的迎合性源自 RLHF 训练目标:人类评分者倾向于给予令人
|
|
|
124
125
|
| 信号类型 | 检测规则 |
|
|
125
126
|
|----------|----------|
|
|
126
127
|
| 正向开场 | 回应前 50 个 token 包含迎合性词语(如「很好」「有趣」「当然」「当然可以」) |
|
|
127
|
-
| 立场翻转 |
|
|
128
|
+
| 立场翻转 | 用户揭示偏好后,模型在没有新技术证据的情况下改变立场 |
|
|
128
129
|
| 风险淡化 | 句式:「虽然有些小问题,但整体上...」而未说明具体问题 |
|
|
129
130
|
| 缺乏量化 | 重要建议缺少信心评分或具体度量指标 |
|
|
130
131
|
|
|
@@ -145,9 +146,9 @@ LLM 的迎合性源自 RLHF 训练目标:人类评分者倾向于给予令人
|
|
|
145
146
|
|
|
146
147
|
## 与 Agent Prompt 的整合
|
|
147
148
|
|
|
148
|
-
|
|
149
|
+
应用至 AI Agent 时:
|
|
149
150
|
|
|
150
|
-
| Agent 类型 |
|
|
151
|
+
| Agent 类型 | 应用规则 |
|
|
151
152
|
|------------|----------|
|
|
152
153
|
| 代码审查 Agent | REQ-1(Socratic)+ REQ-3(双栏)+ REQ-5(检测) |
|
|
153
154
|
| 架构建议 Agent | REQ-2(先问立场)+ REQ-4(信心度)+ REQ-5(检测) |
|
|
@@ -159,18 +160,18 @@ LLM 的迎合性源自 RLHF 训练目标:人类评分者倾向于给予令人
|
|
|
159
160
|
## 完整防迎合 Prompt 模板
|
|
160
161
|
|
|
161
162
|
```
|
|
162
|
-
|
|
163
|
-
|
|
163
|
+
You are a domain expert with no emotional investment in my satisfaction.
|
|
164
|
+
Your role is to identify flaws in my thinking, not to make me feel good.
|
|
164
165
|
|
|
165
|
-
|
|
166
|
-
-
|
|
167
|
-
-
|
|
168
|
-
-
|
|
166
|
+
Rules:
|
|
167
|
+
- Do NOT open with positive phrases (good, interesting, nice, certainly)
|
|
168
|
+
- Every recommendation must include a confidence level (1-5) and what you are uncertain about
|
|
169
|
+
- If my direction is wrong, say so directly
|
|
169
170
|
|
|
170
|
-
|
|
171
|
+
My question: [question]
|
|
171
172
|
|
|
172
|
-
|
|
173
|
-
|
|
173
|
+
First, list the incorrect assumptions I may be holding about this problem.
|
|
174
|
+
Then give your honest recommendation.
|
|
174
175
|
```
|
|
175
176
|
|
|
176
177
|
---
|
|
@@ -179,10 +180,10 @@ LLM 的迎合性源自 RLHF 训练目标:人类评分者倾向于给予令人
|
|
|
179
180
|
|
|
180
181
|
- [ ] 提示词未邀请认同(「这样好吗?」)
|
|
181
182
|
- [ ] 明确禁止正向开场词语
|
|
182
|
-
- [ ]
|
|
183
|
+
- [ ] 在揭示用户偏好前先取得模型的独立立场(若适用)
|
|
183
184
|
- [ ] 评估任务强制使用双栏格式
|
|
184
185
|
- [ ] 重要建议需要信心等级
|
|
185
|
-
- [ ]
|
|
186
|
+
- [ ] 对输出应用迎合性检测,再呈现给用户
|
|
186
187
|
|
|
187
188
|
---
|
|
188
189
|
|