universal-dev-standards 6.14.0-beta.9 → 6.14.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/bin/uds.js +12 -1
- package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
- package/bundled/ai/standards/commit-message.ai.yaml +12 -2
- package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
- package/bundled/core/commit-message-guide.md +22 -19
- package/bundled/core/secret-management-standards.md +13 -1
- package/bundled/extensions/locales/zh-tw.md +19 -19
- package/bundled/hooks/validate-commit-msg.mjs +52 -9
- package/bundled/locales/zh-CN/CHANGELOG.md +2309 -1110
- package/bundled/locales/zh-CN/CLAUDE.md +987 -101
- package/bundled/locales/zh-CN/README.md +3 -3
- package/bundled/locales/zh-CN/SECURITY.md +3 -3
- package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
- package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
- package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
- package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
- package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
- 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/accessibility-standards.md +871 -62
- 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-friendly-architecture.md +311 -72
- package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
- package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
- package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
- package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
- 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/changelog-standards.md +485 -63
- package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
- 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 +37 -23
- package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
- package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
- 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/deprecation-standards.md +155 -40
- package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
- package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
- package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
- package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
- package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
- package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
- package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
- package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
- package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
- 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/feature-flag-standards.md +202 -57
- package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
- package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
- 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/mutation-testing.md +45 -6
- package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
- package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
- package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
- package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
- package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
- package/bundled/locales/zh-CN/core/project-structure.md +550 -170
- 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/retrospective-standards.md +215 -22
- package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
- package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
- package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
- package/bundled/locales/zh-CN/core/security-decision.md +45 -70
- package/bundled/locales/zh-CN/core/security-standards.md +169 -16
- package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
- package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
- package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
- 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/supply-chain-security-standards.md +159 -32
- package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
- package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
- package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
- package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
- 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/versioning.md +737 -73
- 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/CHEATSHEET.md +2 -1
- package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
- package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
- package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
- package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
- 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 +2 -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/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 +2 -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/ai-instruction-standards/SKILL.md +217 -137
- 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/atdd-assistant/guide.md +148 -132
- 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/bdd-assistant/guide.md +122 -121
- package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
- package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
- package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
- 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/guide.md +119 -45
- 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 +4 -4
- package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
- package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
- package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
- package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
- 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/SKILL.md +4 -2
- 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/docs-generator/guide.md +8 -7
- 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-discovery/guide.md +158 -157
- 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/refactoring-assistant/guide.md +172 -171
- 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/guide.md +51 -43
- 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/guide.md +88 -79
- 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/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
- 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-derivation/SKILL.md +2 -2
- 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/guide.md +217 -156
- 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/test-coverage-assistant/guide.md +25 -12
- 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 +2282 -1112
- package/bundled/locales/zh-TW/CLAUDE.md +962 -76
- package/bundled/locales/zh-TW/README.md +3 -3
- package/bundled/locales/zh-TW/SECURITY.md +3 -3
- package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
- package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
- package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
- package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
- package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
- 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/accessibility-standards.md +895 -46
- 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/agent-dispatch.md +102 -33
- package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
- package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
- package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
- package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
- package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
- package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
- 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/branch-completion.md +130 -34
- 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/chaos-engineering-standards.md +138 -36
- 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 +19 -7
- package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
- package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
- package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
- package/bundled/locales/zh-TW/core/database-standards.md +2 -1
- package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
- package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
- package/bundled/locales/zh-TW/core/developer-memory.md +102 -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/environment-standards.md +250 -72
- package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
- package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
- 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/feature-flag-standards.md +202 -57
- package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
- package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
- 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/anti-hallucination-guide.md +234 -487
- package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
- package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
- package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
- package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
- 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/observability-standards.md +284 -40
- package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
- package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
- package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
- package/bundled/locales/zh-TW/core/project-context-memory.md +210 -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/runbook-standards.md +296 -23
- package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
- 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/slo-standards.md +301 -49
- package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
- 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/CHEATSHEET.md +2 -1
- package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
- package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
- package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
- package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
- package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
- 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 +2 -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/methodologies/guides/tdd-guide.md +584 -475
- 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/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 +2 -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/guide.md +137 -17
- package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
- package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
- 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/docs-generator/guide.md +4 -3
- 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/observability-assistant/SKILL.md +85 -18
- 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/SKILL.md +91 -45
- 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/language-examples.md +693 -47
- 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/.claude-plugin/plugin.json +71 -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/package.json +2 -2
- package/src/commands/audit.js +28 -1
- package/src/commands/check.js +72 -3
- package/src/commands/compile.js +37 -4
- package/src/commands/config.js +49 -24
- package/src/commands/init.js +78 -30
- package/src/commands/open-work.js +6 -2
- package/src/commands/release-messages.js +228 -0
- package/src/commands/release.js +127 -68
- package/src/commands/run-intent.js +11 -0
- package/src/commands/spec.js +4 -2
- package/src/commands/update.js +173 -20
- package/src/compilers/claude-code-compiler.js +9 -1
- package/src/config/ai-agent-paths.js +14 -1
- package/src/core/installed-formats.js +15 -0
- package/src/core/open-work-config.js +20 -1
- package/src/core/project-config.js +55 -0
- package/src/i18n/messages.js +106 -2
- package/src/installers/hooks-installer.js +1 -1
- package/src/installers/manifest-installer.js +1 -1
- package/src/installers/skills-installer.js +1 -1
- package/src/installers/standards-installer.js +3 -1
- package/src/mcp/server.js +9 -3
- package/src/prompts/init.js +26 -22
- package/src/reconciler/actual-state-scanner.js +2 -8
- package/src/reconciler/backup-locations.js +5 -0
- package/src/reconciler/backup-manager.js +19 -11
- package/src/reconciler/desired-state-calculator.js +89 -57
- package/src/reconciler/plan-executor.js +101 -8
- package/src/reconciler/recorded-versions.js +49 -0
- package/src/reconciler/relative-path.js +23 -0
- package/src/uninstallers/hook-uninstaller.js +9 -1
- package/src/uninstallers/skills-uninstaller.js +22 -3
- package/src/utils/available-standards-report.js +25 -4
- package/src/utils/available-standards.js +13 -3
- package/src/utils/build-manifest.js +1 -1
- package/src/utils/commit-message-judge.js +60 -13
- package/src/utils/friction-detector.js +23 -11
- package/src/utils/git-hooks.js +106 -4
- package/src/utils/integration-generator.js +95 -67
- package/src/utils/legacy-hook-migration.js +121 -2
- package/src/utils/open-work-tracking.mjs +105 -16
- package/src/utils/sdd-header.js +16 -4
- package/src/utils/skills-installer.js +2 -1
- package/src/utils/spinner.js +14 -4
- package/src/utils/standard-validator.js +3 -2
- package/standards-registry.json +10 -8
- package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
|
@@ -2,94 +2,28 @@
|
|
|
2
2
|
source: ../../../core/anti-hallucination.md
|
|
3
3
|
source_version: 1.5.1
|
|
4
4
|
translation_version: 1.5.1
|
|
5
|
-
last_synced: 2026-
|
|
5
|
+
last_synced: 2026-10-16
|
|
6
|
+
source_hash: 7fa06b7d5665
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
9
10
|
# AI 协作防幻觉标准
|
|
10
11
|
|
|
11
|
-
> **语言**: [English](../../../core/anti-hallucination.md) |
|
|
12
|
+
> **语言**: [English](../../../core/anti-hallucination.md) | [繁體中文](../../zh-TW/core/anti-hallucination.md) | 简体中文
|
|
12
13
|
|
|
13
|
-
**版本**: 1.
|
|
14
|
-
**最后更新**: 2026-
|
|
15
|
-
**适用范围**: 所有使用 AI
|
|
14
|
+
**版本**: 1.5.1
|
|
15
|
+
**最后更新**: 2026-04-13
|
|
16
|
+
**适用范围**: 所有使用 AI 助手的软件项目
|
|
17
|
+
**范围**: universal
|
|
18
|
+
**行业标准**: 无(UDS 原创)
|
|
16
19
|
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
## 目的
|
|
20
|
-
|
|
21
|
-
本标准定义 AI 助理的严格准则,以防止在分析程序码、提出建议或撰写系统文件时产生幻觉(生成错误或未经验证的资讯)。
|
|
20
|
+
> **有关详细示例和案例研究,请参阅[防幻觉指南](../../../core/guides/anti-hallucination-guide.md)**
|
|
22
21
|
|
|
23
22
|
---
|
|
24
23
|
|
|
25
|
-
##
|
|
26
|
-
|
|
27
|
-
### 对话语言
|
|
28
|
-
|
|
29
|
-
AI 助手应适应使用者的偏好语言。当专案指定对话语言时,请遵循以下准则:
|
|
30
|
-
|
|
31
|
-
| 情境 | 准则 | 范例 |
|
|
32
|
-
|------|------|------|
|
|
33
|
-
| 对话互动 | 使用专案指定语言 | 繁体中文、英文等 |
|
|
34
|
-
| 确定性标签 | 使用专案指定语言 | `[已确认]` 或 `[Confirmed]` |
|
|
35
|
-
| 错误讯息解释 | 使用专案指定语言 | 以使用者语言解释编译/执行错误 |
|
|
36
|
-
| 技术术语 | 保留原文 | JWT、BCrypt、API、Token |
|
|
37
|
-
| 程序码注解 | 遵循专案惯例 | 通常为英文 |
|
|
38
|
-
| Commit 讯息 | 遵循专案惯例 | 如 `feat(auth): 新增登入功能` |
|
|
39
|
-
|
|
40
|
-
### 选项建议原则
|
|
41
|
-
|
|
42
|
-
**规则**: 当提供多个选项时,必须同时提出最推荐的选项并说明理由。
|
|
43
|
-
|
|
44
|
-
| 情境 | 要求 | 范例 |
|
|
45
|
-
|------|------|------|
|
|
46
|
-
| 提供 2+ 选项 | 必须明确标示推荐选项并说明理由 | 「推荐选项 A,因为...」 |
|
|
47
|
-
| 选项优劣明显 | 直接推荐最佳选项,说明理由 | 「建议使用 BCrypt,因为安全性较高」 |
|
|
48
|
-
| 选项各有优劣 | 推荐最适合当前情境的选项,说明权衡考量 | 「考量专案需求,推荐选项 B」 |
|
|
49
|
-
| 无法判断优劣 | 说明需要哪些资讯才能给出推荐 | 「需要确认效能需求才能推荐」 |
|
|
50
|
-
|
|
51
|
-
**范例**:
|
|
52
|
-
|
|
53
|
-
❌ **错误**:
|
|
54
|
-
```
|
|
55
|
-
有三个选项:
|
|
56
|
-
1. 使用 Redis 快取
|
|
57
|
-
2. 使用记忆体快取
|
|
58
|
-
3. 使用档案快取
|
|
59
|
-
|
|
60
|
-
请选择一个。
|
|
61
|
-
```
|
|
62
|
-
|
|
63
|
-
✅ **正确**:
|
|
64
|
-
```
|
|
65
|
-
有三个选项:
|
|
66
|
-
1. 使用 Redis 快取
|
|
67
|
-
2. 使用记忆体快取
|
|
68
|
-
3. 使用档案快取
|
|
69
|
-
|
|
70
|
-
**推荐: 选项 1 (Redis)**: 考量专案已有 Redis 基础设施且需要跨实例共享快取,Redis 是最适合的选择。
|
|
71
|
-
```
|
|
72
|
-
|
|
73
|
-
### 下一步建议
|
|
74
|
-
|
|
75
|
-
**规则**: 当完成一项任务或子任务时,AI 助手**必须**建议合理的下一步工作,并明确标示**最推荐**的选项。
|
|
76
|
-
|
|
77
|
-
**指引**:
|
|
78
|
-
- **主动性**: 不要等待使用者问「接下来呢?」。
|
|
79
|
-
- **情境相关**: 建议应遵循专案的工作流程(如:提案 -> 实作 -> 测试)。
|
|
80
|
-
- **明确推荐**: 使用 `[推荐]` 或 `[Recommended]` 标示最佳路径。
|
|
81
|
-
|
|
82
|
-
**范例**:
|
|
83
|
-
|
|
84
|
-
✅ **正确**:
|
|
85
|
-
```
|
|
86
|
-
任务完成: API 端点已实作。
|
|
24
|
+
## 目的
|
|
87
25
|
|
|
88
|
-
|
|
89
|
-
1. **[推荐]** 为新端点新增单元测试 (`src/tests/api/`)
|
|
90
|
-
2. 更新 API 文件 (`docs/api-reference.md`)
|
|
91
|
-
3. 开始前端集成
|
|
92
|
-
```
|
|
26
|
+
本标准为 AI 助手定义了严格的准则,以防止在分析代码、提出建议或记录系统文档时产生幻觉(生成虚假或未经验证的信息)。
|
|
93
27
|
|
|
94
28
|
---
|
|
95
29
|
|
|
@@ -97,702 +31,187 @@ AI 助手应适应使用者的偏好语言。当专案指定对话语言时,
|
|
|
97
31
|
|
|
98
32
|
### 1. 仅基于证据的分析
|
|
99
33
|
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
- ✅ 引用已检查的设定档
|
|
106
|
-
- ❌ 不要推测未见过的 API、函式或设定
|
|
107
|
-
- ❌ 不要在未验证的情况下假设框架行为
|
|
108
|
-
- ❌ 不要捏造需求细节
|
|
109
|
-
|
|
110
|
-
**范例**:
|
|
111
|
-
|
|
112
|
-
✅ **正确**:
|
|
113
|
-
```
|
|
114
|
-
[证据] 在 src/auth/service.ts:45,JWT 验证逻辑使用 'jsonwebtoken' 函式库
|
|
115
|
-
[证据] package.json 档案(第 12-18 行)列出 Express 4.18.2 作为相依项目
|
|
116
|
-
```
|
|
117
|
-
|
|
118
|
-
❌ **错误**:
|
|
119
|
-
```
|
|
120
|
-
此系统使用 Redis 进行快取(程序码未审查)
|
|
121
|
-
UserService 应该有 authenticate() 方法(API 未验证)
|
|
122
|
-
需求指出我们需要 SSO 登入支援(需求未确认)
|
|
123
|
-
```
|
|
124
|
-
|
|
125
|
-
---
|
|
34
|
+
| 应做 | 禁止 |
|
|
35
|
+
|----|--------|
|
|
36
|
+
| ✅ 分析已读取的代码文件 | ❌ 推测未见过的 API、函数或配置 |
|
|
37
|
+
| ✅ 引用已获取的文档 | ❌ 在未经核实的情况下假设框架行为 |
|
|
38
|
+
| ✅ 引用已检查的配置文件 | ❌ 捏造需求细节 |
|
|
126
39
|
|
|
127
40
|
### 2. 明确来源标注
|
|
128
41
|
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
#### 2.1 来源类型
|
|
132
|
-
|
|
133
|
-
| 来源类型 | 标签 | 说明 | 可靠度 |
|
|
134
|
-
|---------|------|------|--------|
|
|
135
|
-
| 专案程序码 | `[来源: 程序码]` | 直接从程序码库读取 | ⭐⭐⭐⭐⭐ 最高 |
|
|
136
|
-
| 专案文件 | `[来源: 文件]` | README、Wiki、程序码注解 | ⭐⭐⭐⭐ 高 |
|
|
137
|
-
| 外部文件 | `[来源: 外部]` | 官方文件(附 URL) | ⭐⭐⭐⭐ 高 |
|
|
138
|
-
| 网路搜寻 | `[来源: 搜寻]` | 搜寻结果(包含日期) | ⭐⭐⭐ 中 |
|
|
139
|
-
| AI 知识 | `[来源: 知识]` | AI 训练资料(需验证) | ⭐⭐ 低 |
|
|
140
|
-
| 使用者提供 | `[来源: 使用者]` | 使用者对话中的资讯 | ⭐⭐⭐ 中 |
|
|
141
|
-
|
|
142
|
-
#### 2.2 标注格式
|
|
143
|
-
|
|
144
|
-
**程序码引用**:
|
|
42
|
+
**代码引用格式**:
|
|
145
43
|
```
|
|
146
|
-
[
|
|
44
|
+
[Source: Code] file_path:line_number - Description
|
|
147
45
|
```
|
|
148
46
|
|
|
149
|
-
|
|
47
|
+
**外部文档格式**:
|
|
150
48
|
```
|
|
151
|
-
[
|
|
49
|
+
[Source: External] URL - Description (Version: x.x.x, Accessed: YYYY-MM-DD)
|
|
152
50
|
```
|
|
153
51
|
|
|
154
|
-
**AI
|
|
52
|
+
**AI 知识格式**:
|
|
155
53
|
```
|
|
156
|
-
[
|
|
54
|
+
[Source: Knowledge] Topic - Description (⚠️ Requires verification)
|
|
157
55
|
```
|
|
158
56
|
|
|
159
|
-
|
|
57
|
+
### 3. 来源类型可靠度
|
|
160
58
|
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
[
|
|
164
|
-
[
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
[
|
|
168
|
-
|
|
169
|
-
[来源: 使用者] 使用者在对话中表示 - 验证必须支援 OAuth2
|
|
170
|
-
```
|
|
171
|
-
|
|
172
|
-
❌ **错误**:
|
|
173
|
-
```
|
|
174
|
-
验证服务使用 BCrypt(无来源类型,无档案引用)
|
|
175
|
-
设定档案中某处有资料库连线(模糊引用)
|
|
176
|
-
我认为 README 提到 .NET 8(不确定语言,无来源)
|
|
177
|
-
React useState 的运作方式是...(无版本,无引用)
|
|
178
|
-
```
|
|
179
|
-
|
|
180
|
-
#### 2.4 版本敏感性
|
|
181
|
-
|
|
182
|
-
**规则**: 引用函式库、框架或 API 时,必须包含版本资讯(如有)。
|
|
183
|
-
|
|
184
|
-
**为何重要**:
|
|
185
|
-
- API 在不同版本间会改变
|
|
186
|
-
- 已弃用的功能可能仍出现在 AI 训练资料中
|
|
187
|
-
- 安全性漏洞是版本特定的
|
|
188
|
-
|
|
189
|
-
**范例**:
|
|
190
|
-
```
|
|
191
|
-
✅ [来源: 外部] Next.js App Router (v14.x) - Server Components 是预设值
|
|
192
|
-
✅ [来源: 程序码] package.json:12 - 使用 "express": "^4.18.2"
|
|
193
|
-
❌ "Next.js 使用 Server Components"(哪个版本?v12 和 v14 行为不同)
|
|
194
|
-
```
|
|
59
|
+
| 来源类型 | 标签 | 可靠度 |
|
|
60
|
+
|-------------|-----|-------------|
|
|
61
|
+
| 项目代码 | `[Source: Code]` | ⭐⭐⭐⭐⭐ 最高 |
|
|
62
|
+
| 项目文档 | `[Source: Docs]` | ⭐⭐⭐⭐ 高 |
|
|
63
|
+
| 外部文档 | `[Source: External]` | ⭐⭐⭐⭐ 高 |
|
|
64
|
+
| 网络搜索 | `[Source: Search]` | ⭐⭐⭐ 中 |
|
|
65
|
+
| 用户提供 | `[Source: User]` | ⭐⭐⭐ 中 |
|
|
66
|
+
| AI 知识 | `[Source: Knowledge]` | ⭐⭐ 低 |
|
|
195
67
|
|
|
196
68
|
---
|
|
197
69
|
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
**规则**: 明确区分已确认事实、推测与未知事项。
|
|
201
|
-
|
|
202
|
-
**分类标签**:
|
|
70
|
+
## 确定性分类标签
|
|
203
71
|
|
|
204
72
|
| 标签 | 使用时机 |
|
|
205
|
-
|
|
206
|
-
| `[
|
|
207
|
-
| `[
|
|
208
|
-
| `[
|
|
209
|
-
| `[
|
|
210
|
-
| `[
|
|
211
|
-
|
|
212
|
-
**范例**:
|
|
213
|
-
|
|
214
|
-
✅ **正确**:
|
|
215
|
-
```
|
|
216
|
-
[已确认] src/database/connection.ts:12 - 使用 PostgreSQL 驱动程序 'pg'
|
|
217
|
-
[推测] 基于 src/repositories/ 中的 repository 模式,可能使用依赖注入
|
|
218
|
-
[假设] 专案可能使用 OAuth2,但需要审查验证设定
|
|
219
|
-
[未知] API 速率限制策略未记录
|
|
220
|
-
[需确认] 新功能是否应支援多租户?
|
|
221
|
-
```
|
|
222
|
-
|
|
223
|
-
❌ **错误**:
|
|
224
|
-
```
|
|
225
|
-
系统使用 Redis(无分类,无证据)
|
|
226
|
-
我们应该实作快取(以事实呈现,非建议)
|
|
227
|
-
使用者需要 SSO 支援(假设以已确认需求呈现)
|
|
228
|
-
```
|
|
229
|
-
|
|
230
|
-
#### 统一标签系统
|
|
231
|
-
|
|
232
|
-
本标准定义两类互补的标签类别,用于相关标准:
|
|
233
|
-
|
|
234
|
-
**类别 1:确定性标签**(用于分析现有内容)
|
|
235
|
-
|
|
236
|
-
用于分析程序码、审查文件或讨论系统时。参见[反向工程标准](reverse-engineering-standards.md)。
|
|
237
|
-
|
|
238
|
-
| 标签 | 用途 | 范例情境 |
|
|
239
|
-
|-----|------|---------|
|
|
240
|
-
| `[已确认]` | 直接来自程序码/文件的证据 | 程序码分析、测试提取 |
|
|
241
|
-
| `[推测]` | 基于模式的逻辑推论 | 行为分析、架构审查 |
|
|
242
|
-
| `[假设]` | 需验证的合理猜测 | 缺口识别、推测 |
|
|
243
|
-
| `[未知]` | 无法从现有资讯判断 | 缺少文件 |
|
|
244
|
-
| `[需确认]` | 需要人类输入 | 模糊的需求 |
|
|
245
|
-
|
|
246
|
-
**类别 2:推导标签**(用于生成新内容)
|
|
247
|
-
|
|
248
|
-
用于从已核准来源生成测试、规格或文件时。参见[正向推演标准](../../../core/forward-derivation-standards.md)。
|
|
249
|
-
|
|
250
|
-
| 标签 | 用途 | 范例情境 |
|
|
251
|
-
|-----|------|---------|
|
|
252
|
-
| `[来源]` | 直接来自规格/需求的内容 | SPEC 标题、AC 文字原文 |
|
|
253
|
-
| `[推导]` | 从来源内容转换而来 | 从条列 AC 转换的 GWT |
|
|
254
|
-
| `[生成]` | AI 生成的结构 | 测试骨架、TODO 注解 |
|
|
255
|
-
| `[待办]` | 需要人类实作 | Step definitions、断言 |
|
|
256
|
-
|
|
257
|
-
**何时使用哪种**:
|
|
258
|
-
|
|
259
|
-
| 工作流程 | 主要标签 | 次要标签 |
|
|
260
|
-
|----------|---------|---------|
|
|
261
|
-
| 程序码分析 | 确定性标签 | - |
|
|
262
|
-
| 反向工程 | 确定性标签 | - |
|
|
263
|
-
| 正向推演 | 推导标签 | 确定性标签(用于缺口)|
|
|
264
|
-
| 规格生成 | 推导标签 | 确定性标签(用于未知)|
|
|
73
|
+
|-----|----------|
|
|
74
|
+
| `[Confirmed]` | 来自代码/文档的直接证据 |
|
|
75
|
+
| `[Inferred]` | 基于现有证据的逻辑推论 |
|
|
76
|
+
| `[Assumption]` | 基于常见模式(需验证) |
|
|
77
|
+
| `[Unknown]` | 信息不可得 |
|
|
78
|
+
| `[Need Confirmation]` | 需要用户澄清 |
|
|
265
79
|
|
|
266
80
|
---
|
|
267
81
|
|
|
268
|
-
|
|
269
|
-
|
|
270
|
-
**AI 助手不得**:
|
|
271
|
-
|
|
272
|
-
1. **捏造 API 或函式签名**
|
|
273
|
-
- ❌ 不要编造方法名称、参数或回传类型
|
|
274
|
-
- ✅ 要读取实际原始码或询问使用者
|
|
275
|
-
|
|
276
|
-
2. **假设需求**
|
|
277
|
-
- ❌ 不要猜测使用者需求或业务规则
|
|
278
|
-
- ✅ 当需求模糊时要提出澄清问题
|
|
279
|
-
|
|
280
|
-
3. **推测未读取的程序码**
|
|
281
|
-
- ❌ 不要描述未审查档案的功能
|
|
282
|
-
- ✅ 要明确表示「需要读取 [档案] 以确认」
|
|
283
|
-
|
|
284
|
-
4. **编造设定**
|
|
285
|
-
- ❌ 不要假设环境变数、设定键或资料库结构
|
|
286
|
-
- ✅ 要审查实际设定档
|
|
287
|
-
|
|
288
|
-
5. **凭空产生错误或 Bug**
|
|
289
|
-
- ❌ 不要在无证据的情况下声称程序码有问题
|
|
290
|
-
- ✅ 要分析实际程序码并引用特定行号
|
|
82
|
+
## 推导标签(用于生成内容)
|
|
291
83
|
|
|
292
|
-
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
|
|
298
|
-
- ✅ 要在实作前列出至少 3 个潜在副作用
|
|
299
|
-
- ✅ 要考虑:状态变更、相依性、连锁效应
|
|
300
|
-
|
|
301
|
-
#### 详细范例
|
|
302
|
-
|
|
303
|
-
##### 1. 捏造 API 或函式名称
|
|
304
|
-
|
|
305
|
-
❌ **错误**:
|
|
306
|
-
```
|
|
307
|
-
助理: 「你可以呼叫 UserService.GetUserById(int id) 来取得使用者」
|
|
308
|
-
```
|
|
309
|
-
**问题**: 方法不存在或签名不同。
|
|
310
|
-
|
|
311
|
-
✅ **正确**:
|
|
312
|
-
```
|
|
313
|
-
助理: 「让我读取 UserService 档案以找到正确的方法签名。」
|
|
314
|
-
|
|
315
|
-
[读取 src/services/UserService.cs 后]
|
|
316
|
-
|
|
317
|
-
[来源: 程序码] UserService.cs:45 - 找到方法: FindUser(Guid userId)
|
|
318
|
-
实际方法使用 Guid 而非 int 作为使用者 ID 参数。
|
|
319
|
-
```
|
|
84
|
+
| 标签 | 用途 | 示例场景 |
|
|
85
|
+
|-----|---------|-----------------|
|
|
86
|
+
| `[Source]` | 直接来自规格/需求的内容 | SPEC 标题、AC 逐字文本 |
|
|
87
|
+
| `[Derived]` | 从源内容转换而来 | 从条列式 AC 转换的 GWT |
|
|
88
|
+
| `[Generated]` | AI 生成的结构 | 测试骨架、TODO 注释 |
|
|
89
|
+
| `[TODO]` | 需要人工实现 | 步骤定义、断言 |
|
|
320
90
|
|
|
321
91
|
---
|
|
322
92
|
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
❌ **错误**:
|
|
326
|
-
```
|
|
327
|
-
助理: 「系统需要支援 OAuth 和 SAML 以提供企业 SSO。」
|
|
328
|
-
```
|
|
329
|
-
**问题**: 使用者只询问认证,未指定协议。
|
|
330
|
-
|
|
331
|
-
✅ **正确**:
|
|
332
|
-
```
|
|
333
|
-
助理: 「[需确认] 您提到需要验证功能。
|
|
334
|
-
能否澄清:
|
|
335
|
-
1. 这是给内部使用者、外部客户,还是两者都有?
|
|
336
|
-
2. 您需要企业 SSO(OAuth/SAML)还是简单的使用者名称/密码?
|
|
337
|
-
3. 有任何需要集成的现有身分提供者吗?
|
|
93
|
+
## 禁止行为
|
|
338
94
|
|
|
339
|
-
|
|
340
|
-
|
|
95
|
+
| # | 禁止行为 | 替代做法 |
|
|
96
|
+
|---|-------------|---------|
|
|
97
|
+
| 1 | **捏造 API 或函数签名** | 读取实际源代码或询问用户 |
|
|
98
|
+
| 2 | **假设需求** | 当需求模糊时提出澄清问题 |
|
|
99
|
+
| 3 | **推测未读取的代码** | 声明“需要读取 [文件] 以确认” |
|
|
100
|
+
| 4 | **编造配置** | 审查实际配置文件 |
|
|
101
|
+
| 5 | **凭空捏造错误或 Bug** | 分析实际代码并引用具体行号 |
|
|
102
|
+
| 6 | **提出选项但不推荐** | 始终包含推荐选项并说明理由 |
|
|
103
|
+
| 7 | **未分析副作用即实现** | 在实现前列出至少 3 个潜在副作用 |
|
|
341
104
|
|
|
342
105
|
---
|
|
343
106
|
|
|
344
|
-
|
|
345
|
-
|
|
346
|
-
❌ **错误**:
|
|
347
|
-
```
|
|
348
|
-
助理: 「PaymentService 处理信用卡处理并与 Stripe 集成。」
|
|
349
|
-
```
|
|
350
|
-
**问题**: 档案未读取,功能仅从名称假设。
|
|
351
|
-
|
|
352
|
-
✅ **正确**:
|
|
353
|
-
```
|
|
354
|
-
助理: 「我在您的专案结构中看到名为 PaymentService.cs 的档案。
|
|
107
|
+
## 推荐要求
|
|
355
108
|
|
|
356
|
-
|
|
109
|
+
**规则**: 当提供多个选项时,始终包含推荐选项并说明理由。
|
|
357
110
|
|
|
358
|
-
|
|
359
|
-
|
|
360
|
-
|
|
361
|
-
|
|
362
|
-
|
|
111
|
+
| 场景 | 要求 |
|
|
112
|
+
|----------|-------------|
|
|
113
|
+
| 提供 2 个以上选项 | 必须标明推荐选项并说明理由 |
|
|
114
|
+
| 优劣明显 | 直接推荐最佳选项并说明理由 |
|
|
115
|
+
| 存在权衡取舍 | 基于当前上下文推荐,并说明权衡考量 |
|
|
116
|
+
| 无法判断 | 说明需要哪些信息才能给出推荐 |
|
|
363
117
|
|
|
364
118
|
---
|
|
365
119
|
|
|
366
|
-
|
|
367
|
-
|
|
368
|
-
❌ **错误**:
|
|
369
|
-
```
|
|
370
|
-
助理: 「设定 DATABASE_URL 环境变数以连线到 PostgreSQL。
|
|
371
|
-
您的连线字串应在 appsettings.json 的 'ConnectionStrings:DefaultConnection' 下。」
|
|
372
|
-
```
|
|
373
|
-
**问题**: 设定结构和变数名称未经验证即假设。
|
|
374
|
-
|
|
375
|
-
✅ **正确**:
|
|
376
|
-
```
|
|
377
|
-
助理: 「让我检查您的实际设定档。」
|
|
378
|
-
|
|
379
|
-
[读取 appsettings.json 后]
|
|
380
|
-
|
|
381
|
-
[来源: 程序码] appsettings.json:8-12 - 找到资料库设定:
|
|
382
|
-
- 连线字串键: "ConnectionStrings:MainDb"(非 "DefaultConnection")
|
|
383
|
-
- 使用 SQL Server,非 PostgreSQL
|
|
384
|
-
- 额外设定 "CommandTimeout": 30
|
|
120
|
+
## 下一步建议
|
|
385
121
|
|
|
386
|
-
|
|
387
|
-
```
|
|
122
|
+
**规则**: 完成一项任务或子任务后,建议合理的后续步骤并指出最推荐的选项。
|
|
388
123
|
|
|
389
|
-
|
|
390
|
-
|
|
391
|
-
|
|
392
|
-
|
|
393
|
-
❌ **错误**:
|
|
394
|
-
```
|
|
395
|
-
助理: 「您的验证程序码有安全性漏洞 -
|
|
396
|
-
您没有正确进行密码杂凑。」
|
|
397
|
-
```
|
|
398
|
-
**问题**: 未读取实际程序码即声称有 Bug。
|
|
399
|
-
|
|
400
|
-
✅ **正确**:
|
|
401
|
-
```
|
|
402
|
-
助理: 「让我审查您的验证实作。」
|
|
403
|
-
|
|
404
|
-
[读取 src/auth/AuthService.cs 后]
|
|
405
|
-
|
|
406
|
-
[已确认] AuthService.cs:67 - 找到密码杂凑实作:
|
|
407
|
-
- 使用 BCrypt,work factor 为 12 ✅
|
|
408
|
-
- Salt 自动生成 ✅
|
|
409
|
-
- 未侦测到时序攻击漏洞 ✅
|
|
410
|
-
|
|
411
|
-
您的密码杂凑实作遵循安全性最佳实务。
|
|
412
|
-
在审查的程序码中未发现问题。
|
|
413
|
-
```
|
|
414
|
-
|
|
415
|
-
---
|
|
416
|
-
|
|
417
|
-
##### 6. 选项未附推荐
|
|
418
|
-
|
|
419
|
-
❌ **错误**:
|
|
420
|
-
```
|
|
421
|
-
助理: 「您可以使用: 1) JWT 2) Session 3) OAuth。您偏好哪个?」
|
|
422
|
-
```
|
|
423
|
-
**问题**: 列出选项但未提供指引或考虑情境。
|
|
424
|
-
|
|
425
|
-
✅ **正确**:
|
|
426
|
-
```
|
|
427
|
-
助理: 「基于您的需求:
|
|
428
|
-
|
|
429
|
-
**选项**:
|
|
430
|
-
1. JWT - 无状态、可扩展、适合 API
|
|
431
|
-
2. Session - 服务器端状态、传统 Web 应用程序
|
|
432
|
-
3. OAuth - 第三方身分提供者
|
|
433
|
-
|
|
434
|
-
**推荐: JWT**
|
|
435
|
-
|
|
436
|
-
[推测] 基于您的微服务架构(见于 docker-compose.yml),
|
|
437
|
-
JWT 是最适合的,因为:
|
|
438
|
-
- 无状态: 跨服务不需要 session 储存
|
|
439
|
-
- 可扩展: 每个服务可独立验证 token
|
|
440
|
-
- 标准: 在您的技术堆叠(.NET、React)中有良好支援
|
|
441
|
-
|
|
442
|
-
如果之后需要社交登入,可以在 JWT 之上加入 OAuth。」
|
|
443
|
-
```
|
|
444
|
-
|
|
445
|
-
---
|
|
446
|
-
|
|
447
|
-
##### 7. 未分析副作用即实作
|
|
448
|
-
|
|
449
|
-
❌ **错误**:
|
|
450
|
-
```
|
|
451
|
-
使用者: 「新增一个删除使用者帐号的功能」
|
|
452
|
-
助理: 「这是实作:
|
|
453
|
-
|
|
454
|
-
public async Task DeleteUser(Guid userId) {
|
|
455
|
-
await _dbContext.Users.Where(u => u.Id == userId).DeleteAsync();
|
|
456
|
-
}
|
|
457
|
-
」
|
|
458
|
-
```
|
|
459
|
-
**问题**: 未考虑连锁效应即直接实作。
|
|
460
|
-
|
|
461
|
-
✅ **正确**:
|
|
462
|
-
```
|
|
463
|
-
使用者: 「新增一个删除使用者帐号的功能」
|
|
464
|
-
助理: 「在实作前,让我先识别潜在副作用:
|
|
465
|
-
|
|
466
|
-
**潜在副作用**:
|
|
467
|
-
1. **资料完整性**: 相关记录(订单、评论、工作阶段)可能变成孤立资料
|
|
468
|
-
2. **外部系统**: 可能需要通知第三方服务(支付提供者、电子邮件服务)
|
|
469
|
-
3. **稽核轨迹**: 删除可能违反合规要求(GDPR 被遗忘权 vs. 稽核日志)
|
|
470
|
-
|
|
471
|
-
[需确认] 应如何处理:
|
|
472
|
-
- 相关使用者资料(级联删除 vs. 匿名化)?
|
|
473
|
-
- 活动中的工作阶段?
|
|
474
|
-
- 用于报表的历史记录?
|
|
475
|
-
|
|
476
|
-
一旦确认后,我会提供实作。」
|
|
477
|
-
```
|
|
124
|
+
**指引**:
|
|
125
|
+
- **主动性**: 不要等待用户询问“接下来做什么?”
|
|
126
|
+
- **符合上下文**: 建议应遵循项目的工作流程
|
|
127
|
+
- **明确推荐**: 使用 `[Recommended]` 标出最佳路径
|
|
478
128
|
|
|
479
129
|
---
|
|
480
130
|
|
|
481
131
|
## 实施检查清单
|
|
482
132
|
|
|
483
|
-
|
|
484
|
-
|
|
485
|
-
- [ ] **来源已验证**
|
|
486
|
-
- 我是否已读取实际的档案/文件?
|
|
487
|
-
|
|
488
|
-
- [ ] **来源类型已标注**
|
|
489
|
-
- 我是否已指定来源类型?(`[来源: 程序码]`、`[来源: 外部]`、`[来源: 知识]` 等)
|
|
490
|
-
|
|
491
|
-
- [ ] **引用已标注**
|
|
492
|
-
- 我是否已包含档案路径与行号(程序码)?
|
|
493
|
-
- 我是否已包含 URL 与存取日期(外部文件)?
|
|
494
|
-
|
|
495
|
-
- [ ] **版本已标注**
|
|
496
|
-
- 我是否已包含适用的函式库/框架版本?
|
|
497
|
-
|
|
498
|
-
- [ ] **确定性已分类**
|
|
499
|
-
- 我是否已标注为 [已确认]、[推测]、[假设]、[未知] 或 [需确认]?
|
|
500
|
-
|
|
501
|
-
- [ ] **AI 知识已标记**
|
|
502
|
-
- 我是否已对 `[来源: 知识]` 标记 ⚠️ 验证警告?
|
|
503
|
-
|
|
504
|
-
- [ ] **无捏造**
|
|
505
|
-
- 我是否避免了捏造 API、设定或需求?
|
|
506
|
-
|
|
507
|
-
- [ ] **使用者澄清**
|
|
508
|
-
- 我是否对模糊点请求澄清?
|
|
509
|
-
|
|
510
|
-
- [ ] **包含推荐**
|
|
511
|
-
- 当提出选项时,我是否包含了推荐选项?
|
|
133
|
+
在对代码、需求或架构做出任何陈述之前:
|
|
512
134
|
|
|
513
|
-
- [ ]
|
|
514
|
-
|
|
515
|
-
|
|
135
|
+
- [ ] **来源已验证**: 我是否已读取实际的文件/文档?
|
|
136
|
+
- [ ] **来源类型已标注**: 我是否已指明来源类型?
|
|
137
|
+
- [ ] **引用已注明**: 我是否包含了文件路径和行号(针对代码)?
|
|
138
|
+
- [ ] **版本已指明**: 在适用情况下,我是否包含了库/框架的版本?
|
|
139
|
+
- [ ] **确定性已分类**: 我是否已标注为 [Confirmed]、[Inferred] 等?
|
|
140
|
+
- [ ] **AI 知识已标记**: 我是否对 `[Source: Knowledge]` 加上了 ⚠️ 警告?
|
|
141
|
+
- [ ] **绝无捏造**: 我是否避免了编造 API、配置或需求?
|
|
142
|
+
- [ ] **用户澄清**: 我是否对模糊不清之处请求了澄清?
|
|
143
|
+
- [ ] **包含推荐**: 在提供选项时,我是否包含了推荐选项?
|
|
144
|
+
- [ ] **已识别副作用**: 我是否在实现前列出了潜在副作用?
|
|
516
145
|
|
|
517
146
|
---
|
|
518
147
|
|
|
519
|
-
##
|
|
148
|
+
## 版本敏感性
|
|
520
149
|
|
|
521
|
-
|
|
150
|
+
**规则**: 引用库、框架或 API 时,只要可用,始终包含版本信息。
|
|
522
151
|
|
|
523
|
-
|
|
524
|
-
|
|
525
|
-
|
|
526
|
-
|
|
527
|
-
您的验证系统使用 JWT 搭配 RS256 签名。
|
|
528
|
-
Token 在 1 小时后过期。
|
|
529
|
-
您应该加入 refresh token 支援。
|
|
530
|
-
```
|
|
531
|
-
**问题**: 未读取程序码即做出声明,假设实作细节。
|
|
532
|
-
|
|
533
|
-
**✅ 良好回应**:
|
|
534
|
-
```
|
|
535
|
-
[需确认] 哪个档案包含验证逻辑?
|
|
536
|
-
可能的位置包括:
|
|
537
|
-
- src/auth/
|
|
538
|
-
- src/services/auth
|
|
539
|
-
- src/middleware/
|
|
540
|
-
|
|
541
|
-
请引导我找到正确的档案,以便我提供准确分析。
|
|
542
|
-
|
|
543
|
-
或者,我可以搜寻程序码库中与验证相关的档案。
|
|
544
|
-
```
|
|
152
|
+
| ✅ 良好 | ❌ 不良 |
|
|
153
|
+
|---------|--------|
|
|
154
|
+
| `[Source: External] Next.js App Router (v14.x) - Server Components are the default` | "Next.js uses Server Components" |
|
|
155
|
+
| `[Source: Code] package.json:12 - Using "express": "^4.18.2"` | "Express handles routing" |
|
|
545
156
|
|
|
546
157
|
---
|
|
547
158
|
|
|
548
|
-
|
|
549
|
-
|
|
550
|
-
**使用者请求**: 「我应该如何架构新的付款模组?」
|
|
551
|
-
|
|
552
|
-
**❌ 不良回应**:
|
|
553
|
-
```
|
|
554
|
-
基于您现有的架构,您应该:
|
|
555
|
-
1. 在 src/services/ 建立 PaymentService
|
|
556
|
-
2. 使用 Stripe API
|
|
557
|
-
3. 将交易储存在 payments 资料表
|
|
558
|
-
```
|
|
559
|
-
**问题**: 未经证据即假设架构、支付提供者和资料库结构。
|
|
560
|
-
|
|
561
|
-
**✅ 良好回应**:
|
|
562
|
-
```
|
|
563
|
-
为了提供准确的建议,我需要了解您目前的架构:
|
|
159
|
+
## 对话语言准则
|
|
564
160
|
|
|
565
|
-
|
|
566
|
-
|
|
567
|
-
|
|
568
|
-
|
|
569
|
-
|
|
570
|
-
|
|
571
|
-
|
|
572
|
-
|
|
573
|
-
- 资料库结构或 ORM 模型
|
|
574
|
-
|
|
575
|
-
一旦我审查了这些,就能建议与您的模式一致的结构。
|
|
576
|
-
```
|
|
577
|
-
|
|
578
|
-
---
|
|
579
|
-
|
|
580
|
-
### 情境 3: Bug 调查
|
|
581
|
-
|
|
582
|
-
**使用者请求**: 「登入失败」
|
|
583
|
-
|
|
584
|
-
**❌ 不良回应**:
|
|
585
|
-
```
|
|
586
|
-
问题可能在您的 validateCredentials() 函式中。
|
|
587
|
-
您可能需要在比对前对密码进行杂凑。
|
|
588
|
-
```
|
|
589
|
-
**问题**: 未看程序码即猜测原因。
|
|
590
|
-
|
|
591
|
-
**✅ 良好回应**:
|
|
592
|
-
```
|
|
593
|
-
要调查登入失败,我需要更多资讯:
|
|
594
|
-
|
|
595
|
-
[需确认]
|
|
596
|
-
1. 您看到什么错误讯息?(主控台日志、错误回应)
|
|
597
|
-
2. 哪个档案包含登入逻辑?
|
|
598
|
-
3. 能否分享相关的程序码片段或日志?
|
|
599
|
-
|
|
600
|
-
建议的除错步骤:
|
|
601
|
-
- 分享登入控制器/服务程序码
|
|
602
|
-
- 提供主控台/服务器的错误日志
|
|
603
|
-
- 描述预期与实际行为
|
|
604
|
-
|
|
605
|
-
一旦我审查了实际程序码和错误,就能找出根本原因。
|
|
606
|
-
```
|
|
607
|
-
|
|
608
|
-
---
|
|
609
|
-
|
|
610
|
-
### 情境 4: 技术选型
|
|
611
|
-
|
|
612
|
-
**使用者请求**: 「我应该使用什么快取解决方案?」
|
|
613
|
-
|
|
614
|
-
**❌ 不良回应**:
|
|
615
|
-
```
|
|
616
|
-
您有几个选项:
|
|
617
|
-
1. Redis
|
|
618
|
-
2. Memcached
|
|
619
|
-
3. 记忆体快取
|
|
620
|
-
|
|
621
|
-
让我知道您想使用哪一个。
|
|
622
|
-
```
|
|
623
|
-
**问题**: 列出选项但未推荐或考虑情境。
|
|
624
|
-
|
|
625
|
-
**✅ 良好回应**:
|
|
626
|
-
```
|
|
627
|
-
基于可用的选项:
|
|
628
|
-
1. Redis - 分散式、持久化、丰富的资料结构
|
|
629
|
-
2. Memcached - 简单、快速、分散式
|
|
630
|
-
3. 记忆体快取 - 仅本机、无需设定
|
|
631
|
-
|
|
632
|
-
**推荐: Redis**
|
|
633
|
-
|
|
634
|
-
[需确认] 在最终决定前,我想了解:
|
|
635
|
-
- 您需要跨多个实例共享快取吗?
|
|
636
|
-
- 需要资料持久化吗?
|
|
637
|
-
- 您现有的基础设施是什么?
|
|
638
|
-
|
|
639
|
-
如果您已有 Redis 基础设施或需要跨实例共享,
|
|
640
|
-
Redis 是最佳选择。如果这是单实例应用程序且有
|
|
641
|
-
简单的快取需求,记忆体快取就足够了。
|
|
642
|
-
```
|
|
643
|
-
|
|
644
|
-
---
|
|
645
|
-
|
|
646
|
-
## AI 助理工作流程
|
|
647
|
-
|
|
648
|
-
```
|
|
649
|
-
┌─────────────────────────────────┐
|
|
650
|
-
│ 收到使用者请求 │
|
|
651
|
-
└─────────────┬───────────────────┘
|
|
652
|
-
│
|
|
653
|
-
▼
|
|
654
|
-
┌─────────────────────────────────┐
|
|
655
|
-
│ 识别所需资讯 │
|
|
656
|
-
│ - 程序码档案? │
|
|
657
|
-
│ - 设定? │
|
|
658
|
-
│ - 需求? │
|
|
659
|
-
└─────────────┬───────────────────┘
|
|
660
|
-
│
|
|
661
|
-
▼
|
|
662
|
-
┌─────────────────────────────────┐
|
|
663
|
-
│ 识别潜在副作用 │
|
|
664
|
-
│ - 状态变更? │
|
|
665
|
-
│ - 受影响的相依性? │
|
|
666
|
-
│ - 外部系统影响? │
|
|
667
|
-
└─────────────┬───────────────────┘
|
|
668
|
-
│
|
|
669
|
-
▼
|
|
670
|
-
┌────┴────┐
|
|
671
|
-
│ 可取得? │
|
|
672
|
-
└────┬────┘
|
|
673
|
-
│
|
|
674
|
-
┌───────┴───────┐
|
|
675
|
-
│ │
|
|
676
|
-
是 否
|
|
677
|
-
│ │
|
|
678
|
-
▼ ▼
|
|
679
|
-
┌──────────┐ ┌─────────────┐
|
|
680
|
-
│ 读取/ │ │ 向使用者 │
|
|
681
|
-
│ 分析 │ │ 询问资讯 │
|
|
682
|
-
└────┬─────┘ └──────┬──────┘
|
|
683
|
-
│ │
|
|
684
|
-
▼ ▼
|
|
685
|
-
┌─────────────────────────────────┐
|
|
686
|
-
│ 为回应加上标签: │
|
|
687
|
-
│ - [已确认] 用于事实 │
|
|
688
|
-
│ - [推测] 用于推论 │
|
|
689
|
-
│ - [需确认] 用于缺口 │
|
|
690
|
-
└─────────────┬───────────────────┘
|
|
691
|
-
│
|
|
692
|
-
▼
|
|
693
|
-
┌─────────────────────────────────┐
|
|
694
|
-
│ 引用来源(档案:行号) │
|
|
695
|
-
└─────────────┬───────────────────┘
|
|
696
|
-
│
|
|
697
|
-
▼
|
|
698
|
-
┌─────────────────────────────────┐
|
|
699
|
-
│ 包含推荐 │
|
|
700
|
-
│ (如提出选项) │
|
|
701
|
-
└─────────────┬───────────────────┘
|
|
702
|
-
│
|
|
703
|
-
▼
|
|
704
|
-
┌─────────────────────────────────┐
|
|
705
|
-
│ 提供回应 │
|
|
706
|
-
└─────────────────────────────────┘
|
|
707
|
-
```
|
|
708
|
-
|
|
709
|
-
---
|
|
710
|
-
|
|
711
|
-
## 语言无关应用
|
|
712
|
-
|
|
713
|
-
本标准适用于任何程序语言、框架或领域:
|
|
714
|
-
|
|
715
|
-
- **Web 开发**: 未经证据不假设 Express/Django/Spring Boot
|
|
716
|
-
- **行动开发**: 未经证据不假设 React Native/Flutter
|
|
717
|
-
- **资料科学**: 未经证据不假设 TensorFlow/PyTorch
|
|
718
|
-
- **DevOps**: 未经证据不假设 Docker/Kubernetes
|
|
719
|
-
|
|
720
|
-
**通用规则**: 先读取,再分析,永远以证据报告。
|
|
161
|
+
| 上下文 | 指引 |
|
|
162
|
+
|---------|-----------|
|
|
163
|
+
| 对话互动 | 使用项目指定语言 |
|
|
164
|
+
| 确定性标签 | 使用项目指定语言 |
|
|
165
|
+
| 错误解释 | 使用项目指定语言 |
|
|
166
|
+
| 技术术语 | 保留原文(JWT、BCrypt、API、Token) |
|
|
167
|
+
| 代码注释 | 遵循项目惯例 |
|
|
168
|
+
| Commit 信息 | 遵循项目惯例 |
|
|
721
169
|
|
|
722
170
|
---
|
|
723
171
|
|
|
724
|
-
##
|
|
725
|
-
|
|
726
|
-
执行程序码审查时,应用这些原则:
|
|
172
|
+
## 相关标准
|
|
727
173
|
|
|
728
|
-
|
|
729
|
-
|
|
730
|
-
|
|
731
|
-
|
|
732
|
-
|
|
733
|
-
3. **避免假设**: 如不确定设计意图,询问作者
|
|
734
|
-
|
|
735
|
-
**审查评论范本**:
|
|
736
|
-
```
|
|
737
|
-
[档案:行号] - [严重性]
|
|
738
|
-
[问题描述与程序码摘录]
|
|
739
|
-
[证据或推理]
|
|
740
|
-
[建议修正或澄清问题]
|
|
741
|
-
```
|
|
174
|
+
- [测试标准](testing-standards.md) - 确保验证 AI 分析结果
|
|
175
|
+
- [代码审查清单](code-review-checklist.md) - 审查 AI 生成的内容
|
|
176
|
+
- [代码签入标准](checkin-standards.md) - AI 协作签入流程
|
|
177
|
+
- [反向工程标准](reverse-engineering-standards.md) - 确定性标签的使用
|
|
178
|
+
- [正向推导标准](forward-derivation-standards.md) - 推导标签的使用
|
|
742
179
|
|
|
743
180
|
---
|
|
744
181
|
|
|
745
182
|
## Agent 认识论校准(v1.4.0,XSPEC-008)
|
|
746
183
|
|
|
747
|
-
Agent 必须使用 Answer
|
|
184
|
+
Agent 必须使用 Answer/Ask/Abstain 框架声明其认识论状态:
|
|
748
185
|
|
|
749
186
|
| 动作 | 使用时机 | 必填字段 |
|
|
750
|
-
|
|
751
|
-
| `answer` | 拥有足够信息 | 无(completeness/confidence
|
|
187
|
+
|--------|-------------|----------------|
|
|
188
|
+
| `answer` | 拥有足够信息 | 无(completeness/confidence 为选填) |
|
|
752
189
|
| `ask` | 缺少关键信息 | `missing_variables` 列表 |
|
|
753
|
-
| `abstain` |
|
|
190
|
+
| `abstain` | 确实超出能力范围 | `abstain_reason` |
|
|
754
191
|
|
|
755
192
|
**Fail-closed Agent**(必须始终回答):`evaluator`、`guardian`
|
|
756
193
|
|
|
757
194
|
**向后兼容**:缺少 `epistemic` 字段时默认为 `action_type: "answer"`。
|
|
758
195
|
|
|
759
|
-
参见:XSPEC-008、DEC-014
|
|
760
|
-
|
|
761
|
-
---
|
|
762
|
-
|
|
763
|
-
## 相关标准
|
|
764
|
-
|
|
765
|
-
- [测试标准](testing-standards.md) - 确保验证 AI 分析结果(或使用 `/testing-guide` 技能)
|
|
766
|
-
- [程序码审查清单](code-review-checklist.md) - 审查 AI 生成内容
|
|
767
|
-
- [程序码签入标准](checkin-standards.md) - AI 协作签入流程
|
|
196
|
+
参见:XSPEC-008、DEC-014 (PassiveQA)
|
|
768
197
|
|
|
769
198
|
---
|
|
770
199
|
|
|
771
200
|
## 版本历史
|
|
772
201
|
|
|
773
202
|
| 版本 | 日期 | 变更 |
|
|
774
|
-
|
|
775
|
-
| 1.5.1 | 2026-04-13 |
|
|
776
|
-
| 1.
|
|
777
|
-
| 1.
|
|
778
|
-
| 1.3.
|
|
779
|
-
| 1.
|
|
780
|
-
| 1.
|
|
781
|
-
| 1.
|
|
203
|
+
|---------|------|---------|
|
|
204
|
+
| 1.5.1 | 2026-04-13 | 新增:Agent 认识论校准(Answer/Ask/Abstain)框架(XSPEC-008) |
|
|
205
|
+
| 1.5.0 | 2026-01-29 | 重构:拆分为规则与指南,将示例移至指南 |
|
|
206
|
+
| 1.4.0 | 2026-01-19 | 新增:副作用分析规则 |
|
|
207
|
+
| 1.3.1 | 2025-12-24 | 新增:相关标准章节 |
|
|
208
|
+
| 1.3.0 | 2025-12-22 | 增强:包含详细示例的禁止行为 |
|
|
209
|
+
| 1.2.0 | 2025-12-15 | 新增:AI 助手互动规范 |
|
|
210
|
+
| 1.1.0 | 2025-12-10 | 增强:带有来源类型的来源标注 |
|
|
211
|
+
| 1.0.0 | 2025-11-12 | 初始标准发布 |
|
|
782
212
|
|
|
783
213
|
---
|
|
784
214
|
|
|
785
|
-
##
|
|
215
|
+
## 许可协议
|
|
786
216
|
|
|
787
217
|
本标准以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权发布。
|
|
788
|
-
您可以自由调整用于您的专案,但需注明出处。
|
|
789
|
-
|
|
790
|
-
---
|
|
791
|
-
|
|
792
|
-
**专案特定化**
|
|
793
|
-
|
|
794
|
-
专案可透过以下方式扩充本标准:
|
|
795
|
-
- 领域特定验证需求(如医疗领域的 HIPAA 合规检查)
|
|
796
|
-
- 工具特定指引(如如何验证 Terraform 设定)
|
|
797
|
-
- 团队特定证据格式(如 JIRA ticket 引用)
|
|
798
|
-
- AI 助手对话的语言偏好
|