universal-dev-standards 6.14.0-beta.9 → 6.14.1-beta.1
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/mock-boundary.ai.yaml +138 -2
- package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
- package/bundled/ai/standards/turn-completion-integrity.ai.yaml +6 -2
- package/bundled/core/commit-message-guide.md +22 -19
- package/bundled/core/mock-boundary.md +70 -2
- package/bundled/core/secret-management-standards.md +13 -1
- package/bundled/core/turn-completion-integrity.md +8 -2
- package/bundled/extensions/locales/zh-tw.md +19 -19
- package/bundled/hooks/check-dangerous-cmd.mjs +161 -26
- package/bundled/hooks/check-logging-standard.mjs +35 -6
- package/bundled/hooks/validate-commit-msg.mjs +317 -28
- package/bundled/locales/zh-CN/CHANGELOG.md +2323 -1099
- 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 +4 -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/mock-boundary.md +74 -6
- 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/turn-completion-integrity.md +8 -6
- 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 +2323 -1128
- 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 +4 -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/mock-boundary.md +74 -6
- 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/turn-completion-integrity.md +8 -6
- 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 +227 -47
- 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
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../core/mock-boundary.md
|
|
3
|
-
source_version: 1.
|
|
4
|
-
translation_version: 1.
|
|
5
|
-
last_synced: 2026-
|
|
6
|
-
source_hash:
|
|
3
|
+
source_version: 1.3.0
|
|
4
|
+
translation_version: 1.3.0
|
|
5
|
+
last_synced: 2026-10-28
|
|
6
|
+
source_hash: b95f3da59a8e
|
|
7
7
|
status: current
|
|
8
8
|
---
|
|
9
9
|
|
|
@@ -11,8 +11,8 @@ status: current
|
|
|
11
11
|
|
|
12
12
|
> **语言**: [English](../../../core/mock-boundary.md) | [繁體中文](../../zh-TW/core/mock-boundary.md) | 简体中文
|
|
13
13
|
|
|
14
|
-
**版本**: 1.
|
|
15
|
-
**最后更新**: 2026-
|
|
14
|
+
**版本**: 1.3.0
|
|
15
|
+
**最后更新**: 2026-10-28
|
|
16
16
|
**适用性**: 所有具备单元测试与集成测试的软件项目
|
|
17
17
|
**范围**: universal
|
|
18
18
|
**行业标准**: ISTQB Foundation(Test Doubles), xUnit Patterns(Gerard Meszaros)
|
|
@@ -110,6 +110,67 @@ class DeterministicDispatcher implements BackgroundDispatcher {
|
|
|
110
110
|
|
|
111
111
|
---
|
|
112
112
|
|
|
113
|
+
## 拦截型 Hook:测宿主的入口,不是测匹配函数
|
|
114
|
+
|
|
115
|
+
**hook** 是 AI 宿主(Claude Code、Codex、Gemini CLI、Antigravity CLI 等)在生命周期事件上运行的脚本。有些 hook 能**拦下**宿主原本要做的事:拒绝一次工具调用、拒绝一条提示、不让一个回合结束。对这类 hook,空心测试根本不需要任何 mock——测试只是从来没碰到宿主会调用的入口。
|
|
116
|
+
|
|
117
|
+
hook 有两层。**判断层**决定这条命令危不危险;**接线层**读宿主送来的 stdin 数据,并用宿主会读的信号回答(退出码,或标准输出的 JSON)。导入判断函数的单元测试只练到第一层,而宿主读的是第二层。退出码错、字段名称读错、输出格式宿主不认,这些都不会让那个测试变红。
|
|
118
|
+
|
|
119
|
+
### 反例:UDS 自己的危险命令 hook,拦下 0/26
|
|
120
|
+
|
|
121
|
+
`scripts/hooks/check-dangerous-cmd.mjs` 是 PreToolUse hook。检测到危险命令时它 `exit 1`。Claude Code 只有 `exit 2` 才拦下工具调用;其他非 0 退出码都是不阻断的 hook 错误,命令照样执行。它的测试导入匹配函数(`isDangerousCommand()`)直接调用,所以绿了好几个月。
|
|
122
|
+
|
|
123
|
+
重放 11,617 次真实 shell 调用(2026-10-27),规则 `rm -rf /` 命中 26 次,宿主拦下 **0** 次。26 次中有 25 次是无害的临时清理,例如 `rm -rf /tmp/x`;没有任何一次是真的要清空根目录。同一个规则还漏掉 `rm -fr /` 与 `rm -r -f /`。修正与入口测试在 PR #281 发布。
|
|
124
|
+
|
|
125
|
+
### 规则
|
|
126
|
+
|
|
127
|
+
**H1(MUST)**:能拦下工具调用、提示或回合的 hook,至少要有一个测试同时做到下列三件事:
|
|
128
|
+
|
|
129
|
+
1. **另起进程运行 hook**,用宿主配置文件里运行它的同一条命令。启动脚本算数;导入不算。
|
|
130
|
+
2. **在 stdin 送入宿主自己的数据**,字段名称用该宿主的(见下表:Claude Code 送 `tool_name`/`tool_input`,Antigravity 送 `toolCall`)。照作者想象的宿主格式做出来的数据什么也证明不了。
|
|
131
|
+
3. **断言宿主据以判断的信号**:确切的退出码,或宿主在标准输出解析的 JSON。“非 0”“有错误退出”“stderr 含某个词”都不算:exit 1 是非 0,却在 Claude Code 上什么也没拦。
|
|
132
|
+
|
|
133
|
+
导入并调用内部函数的测试可以存在,对判断层也有用,但**不计入** H1。
|
|
134
|
+
|
|
135
|
+
**H2(SHOULD)**:拦下的用例旁边,用同样方式跑一个放行的用例,并断言宿主的放行信号(例如 exit 0 且标准输出为空)。一个什么都拦的 hook 可以通过只测拦下的测试。
|
|
136
|
+
|
|
137
|
+
**H3(SHOULD)**:切断检查——把 hook 的拦下信号改掉(例如 `exit 2` 改成 `exit 1`),确认入口测试变红。保持绿色,说明那个测试没在守接线。
|
|
138
|
+
|
|
139
|
+
H1 也适用于“唯一作用是让宿主读到它的信号”的 hook,例如用 exit 2 把 stderr 送到模型面前的 PostToolUse hook。工具已经跑完、无法撤销,但错的退出码一样会让这个 hook 无声无息。
|
|
140
|
+
|
|
141
|
+
### 各宿主把什么当成“已拦下”
|
|
142
|
+
|
|
143
|
+
2026-10-28 取自各宿主自己的官方文档。宿主会改这些约定;采信某一格之前请重查出处。格子写“未查到”,是读过该页而页面没写,不等于“没有”。
|
|
144
|
+
|
|
145
|
+
| 宿主 | 事件 | 拦下 | 不拦下 | 出处 |
|
|
146
|
+
|---|---|---|---|---|
|
|
147
|
+
| Claude Code | PreToolUse | exit **2**(stderr 是理由);或 exit 0 并在 stdout 输出 `{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"..."}}` | 其他任何退出码,**包含 1**,都是不阻断的 hook 错误,动作照常进行;无效的 JSON 同理。文档写明的例外:配置了 `onFailure: "block"` 的 hook,失败时会拦下 | code.claude.com/docs/en/hooks:Exit code output、Exit code 2、Other exit codes、Decision control |
|
|
148
|
+
| Claude Code | UserPromptSubmit | exit **2**(提示不会送到模型);或 exit 0 并在 stdout 输出 `{"decision":"block","reason":"..."}` | 其他任何退出码(同样有 `onFailure: "block"` 的例外) | 同页,Exit code 2 behavior per event |
|
|
149
|
+
| Claude Code | PostToolUse | 不能拦:工具已经执行。exit 2 只会把 stderr 显示给模型 | 就拦下而言,任何退出码都不行 | 同页,Exit code 2 behavior per event |
|
|
150
|
+
| Codex | PreToolUse | exit **2** 并把理由写到 stderr;或 stdout 输出 `{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"..."}}`;旧式 `{"decision":"block","reason":"..."}` 也接受 | stdout 的纯文本会被忽略;`permissionDecision:"ask"`、`continue:false`、`stopReason`、`suppressOutput` 尚不支持,该次 hook 运行被标为失败而工具调用继续;其他非 0 退出码:未查到 | developers.openai.com/codex/hooks,PreToolUse |
|
|
151
|
+
| Codex | UserPromptSubmit | exit **2** 并把理由写到 stderr;或 stdout 输出 `{"decision":"block","reason":"..."}` | stdout 纯文本会被当成额外上下文;其他非 0 退出码:未查到 | 同页,UserPromptSubmit |
|
|
152
|
+
| Codex | PermissionRequest | stdout 输出 `{"hookSpecificOutput":{"decision":{"behavior":"deny","message":"..."}}}`;任一 `deny` 即胜出 | 此事件的 exit 2:未查到;stdout 纯文本会被忽略 | 同页,PermissionRequest |
|
|
153
|
+
| Gemini CLI(旧版) | BeforeTool | exit **2**(stderr 是送给 agent 的理由);或 exit 0 并在 stdout 输出 `{"decision":"deny","reason":"..."}`(`"block"` 是别名)。文档把 JSON 形式列为优先路径 | 其他任何退出码只是警告,CLI 继续 | geminicli.com/docs/hooks/reference,Global hook mechanics 与 BeforeTool |
|
|
154
|
+
| Gemini CLI(旧版) | BeforeAgent、BeforeModel | exit **2** 中止该回合(BeforeAgent 还会把提示从上下文抹除;BeforeModel 跳过 LLM 调用);或 `decision:"deny"` | 同上 | 同页 |
|
|
155
|
+
| Antigravity CLI(`agy`) | PreToolUse | exit 0 并在 stdout 输出 `{"decision":"deny","reason":"..."}`(“Hard blocks execution immediately”)。`decision` 字段必填,其他值为 `allow`、`auto_approve`、`ask`、`force_ask`、`deny_unless_prior_grant`。stdin 带的是 `toolCall.name` 与 `toolCall.args`,不是 Claude Code 的字段名 | 退出码语义:未查到(官方页面没写)。不要假设 Claude Code 的 exit 2 适用。第三方文章声称任何非 0 都视为拒绝;那不是官方说法,此处不采用 | antigravity.google/docs/hooks,Input and output contract,PreToolUse |
|
|
156
|
+
| Cursor 与其他宿主 | 任何 | 未查到(本版未调查) | 未查到 | 无 |
|
|
157
|
+
|
|
158
|
+
Stop 类事件(Claude Code 与 Codex 的 Stop、Gemini CLI 的 AfterAgent、Antigravity 的 Stop)**不在这里重复**。它们的拦下约定写在 [turn-completion-integrity](turn-completion-integrity.md) 的“支持的执行环境”表,那是唯一写下它们的地方。该表也记录了一个 Antigravity hook 失败后被静默放行的案例,与本节要防的接线失败是同一类。
|
|
159
|
+
|
|
160
|
+
### 重放验证的是接线,不是规则
|
|
161
|
+
|
|
162
|
+
把录下的真实调用重放给 hook(例如用 rules-to-guards)是检查接线的有力方法。但它有一个每次汇报结果时都必须讲明的限制:若同一份规则清单同时决定“该拦”与“不该拦”,重放只证明 hook 照它的规则运行,**不证明规则本身是对的**。
|
|
163
|
+
|
|
164
|
+
0/26 之所以量得出来,是因为宿主的约定(exit 2 才拦)是 hook 之外的事实。至于“哪些命令值得拦”,手上只有 hook 自己的匹配式:26 次命中都与它一致,真正的危险 0 次,而它没覆盖的 `rm -fr /` 永远不会在重放里显示为漏掉,因为答案来源与 hook 共用同一个盲点。
|
|
165
|
+
|
|
166
|
+
所以重放的结果只能报“接线正确”或“接线错误”,不要由它得出“规则正确”。要对规则下结论,请去读实际命中的命令,或另备一份不看 hook 匹配式写成的独立答案(见 [verification-oracle](../../../core/verification-oracle.md))。
|
|
167
|
+
|
|
168
|
+
### UDS 的执行方式
|
|
169
|
+
|
|
170
|
+
UDS 在 CI 对自己发布的 hook 检查这条规则:`node scripts/check-hook-entry-tests.mjs`(npm 命令 `check:hook-entry-tests`),发布的、能拦下的 hook 若没有“启动它、送 stdin、断言宿主信号”的测试就判失败。它是静态文本分析:只证明“形状对的测试存在”,不证明 hook 退化时那个测试会变红——那是 H3 的工作。
|
|
171
|
+
|
|
172
|
+
---
|
|
173
|
+
|
|
113
174
|
## 空心测试检测
|
|
114
175
|
|
|
115
176
|
提交测试文件之前,请检查:
|
|
@@ -118,6 +179,7 @@ class DeterministicDispatcher implements BackgroundDispatcher {
|
|
|
118
179
|
2. **所有断言都是 `.toHaveBeenCalled()` 系列** → 加入输出值断言
|
|
119
180
|
3. **Mock 路径与被测对象目录相同** → 自我引用 mock;移除之
|
|
120
181
|
4. **Mock 设置行数多于断言行数** → 很可能是空心测试
|
|
182
|
+
5. **拦截型 hook 的测试只导入并调用它的函数** → 补一个启动 hook 并断言宿主信号的入口测试(见“拦截型 Hook”)
|
|
121
183
|
|
|
122
184
|
---
|
|
123
185
|
|
|
@@ -128,6 +190,7 @@ class DeterministicDispatcher implements BackgroundDispatcher {
|
|
|
128
190
|
- **Orphan Mock**:跨模块 mock 却没有对应的集成测试
|
|
129
191
|
- **Security Bypass Mock**:auth/权限逻辑被换成直接放行的 stub
|
|
130
192
|
- **Database Mock Cascade**:DB 返回硬编码的数据,隐藏真实查询错误
|
|
193
|
+
- **Matcher-Only Hook Test**:拦截型 hook 的测试只导入并调用其判断函数,从未按宿主的方式运行 hook。hook 什么也没拦,测试却是绿的(UDS 自己的 0/26)
|
|
131
194
|
- **Poll/Sleep for Background Result**:用 sleep 或 poll 等待 fire-and-forget 后台工作完成。race 依然存在——timeout 只是多数时候把它掩盖住,同时拖慢整个测试套件;在共享 runner 上还会把 flakiness 泄漏到其他 MR 的 CI 中。应改为注入 deterministic runner 并 await 被追踪的 task。
|
|
132
195
|
|
|
133
196
|
---
|
|
@@ -142,6 +205,8 @@ class DeterministicDispatcher implements BackgroundDispatcher {
|
|
|
142
205
|
| 禁止 mock 安全机制 | 测试涉及 auth/权限 | 使用真实测试用户 + 真实 token |
|
|
143
206
|
| 空心评审 | Mock 数量 ≥ import 数量 | 加入输出值断言 |
|
|
144
207
|
| 后台工作禁止 poll/sleep | 测试断言某个 fire-and-forget 副作用 | 注入 deterministic runner;await 被追踪的 task |
|
|
208
|
+
| 拦截型 hook 要有宿主入口测试 | hook 能拦下工具调用、提示或回合 | 启动它、在 stdin 送宿主的数据、断言宿主据以判断的退出码或 stdout JSON |
|
|
209
|
+
| 重放只证明接线 | 汇报把真实调用重放给 hook 的结果 | 报“接线正确”;除非规则另以独立答案核对过,否则不报“规则正确” |
|
|
145
210
|
|
|
146
211
|
---
|
|
147
212
|
|
|
@@ -150,6 +215,8 @@ class DeterministicDispatcher implements BackgroundDispatcher {
|
|
|
150
215
|
- **testing**:Mock 边界规则适用于测试金字塔的所有测试级别
|
|
151
216
|
- **test-completeness-dimensions**:维度 8(AI 测试质量)引用了这些规则
|
|
152
217
|
- **flow-based-testing**:Flow 测试必须遵循 mock 边界规则
|
|
218
|
+
- **turn-completion-integrity**:Stop 类事件的拦下约定写在那里;工具与提示事件的写在本标准,两边都不重复对方
|
|
219
|
+
- **verification-oracle**:用来判断 hook 规则对不对的答案来源,不得由 hook 自己的匹配式推出
|
|
153
220
|
|
|
154
221
|
---
|
|
155
222
|
|
|
@@ -159,3 +226,4 @@ class DeterministicDispatcher implements BackgroundDispatcher {
|
|
|
159
226
|
|------|------|------|
|
|
160
227
|
| 1.0.0 | 2026-05-04 | 初始标准:空心测试问题、可/不可 Mock 表格、检测、反模式、规则摘要 |
|
|
161
228
|
| 1.1.0 | 2026-07-01 | 新增可注入的后台执行作为 seam(平行于 clock injection):可 Mock 表格新增行、`可注入的后台执行` 章节、`Poll/Sleep for Background Result` 反模式,以及后台工作禁止 poll/sleep 规则(issue #143) |
|
|
229
|
+
| 1.3.0 | 2026-10-28 | 新增《拦截型 Hook:测宿主的入口,不是测匹配函数》:H1 MUST(启动 hook、送宿主的 stdin 数据、断言宿主据以判断的信号)、H2/H3 SHOULD、各宿主拦下信号对照表,以及“重放验证接线、不验证规则”的注记,并以 UDS 自己的 0/26 为反例。版本号与 `mock-boundary.ai.yaml` 对齐——该文件先前把“后台执行”那次新增记为 1.2.0,本文件记为 1.1.0 |
|
|
@@ -1,18 +1,18 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../core/mutation-testing.md
|
|
3
|
-
source_version: 1.
|
|
3
|
+
source_version: 1.1.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
|
-
last_synced: 2026-
|
|
6
|
-
source_hash:
|
|
7
|
-
status:
|
|
5
|
+
last_synced: 2026-10-15
|
|
6
|
+
source_hash: 8eeaea8d9cc3
|
|
7
|
+
status: current
|
|
8
8
|
---
|
|
9
9
|
|
|
10
10
|
# 变异测试标准
|
|
11
11
|
|
|
12
12
|
> **语言**: [English](../../../core/mutation-testing.md) | [繁體中文](../../zh-TW/core/mutation-testing.md) | 简体中文
|
|
13
13
|
|
|
14
|
-
**版本**: 1.
|
|
15
|
-
**最后更新**: 2026-
|
|
14
|
+
**版本**: 1.1.0
|
|
15
|
+
**最后更新**: 2026-08-14
|
|
16
16
|
**适用性**: 所有具备单元/集成测试的软件项目
|
|
17
17
|
**范围**: universal
|
|
18
18
|
**行业标准**: ISTQB Foundation Syllabus(测试有效性指标)
|
|
@@ -39,6 +39,42 @@ Mutation Score = Killed Mutants / (Killed + Survived) × 100%
|
|
|
39
39
|
|
|
40
40
|
---
|
|
41
41
|
|
|
42
|
+
## 归因:kill 记给第一个失败的测试
|
|
43
|
+
|
|
44
|
+
`Killed` 表示本次运行中*有某个*测试对该变异体断言失败——大多数工具不会记录是*哪个*测试杀死了它,更不会记录是*哪个测试层级*。因此 7/7 的 kill score 验证的是**对该变异体运行过的整套测试**,而不是任何单个测试,也不是任何单个测试层级(unit vs. integration vs. property)。
|
|
45
|
+
|
|
46
|
+
**后果**:“property suite 验证了 X”并不是一次聚合的 mutation run 所能支持的主张。要支持它,必须*只启用* property suite 重新运行变异测试:
|
|
47
|
+
|
|
48
|
+
```bash
|
|
49
|
+
npx stryker run --mutate 'src/module/**' -- --project=property
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
如果隔离运行杀死的变异体少于聚合运行,这个差距正是 unit/integration 测试原本悄悄覆盖掉的部分。
|
|
53
|
+
|
|
54
|
+
**规则**:高风险模块(与 80% 阈值适用的同一集合——auth/license/payment/security)在宣称“已被 property 验证”之前,必须先单独针对 property suite 重新运行变异体。
|
|
55
|
+
|
|
56
|
+
---
|
|
57
|
+
|
|
58
|
+
## 单边不变式抓不到 fail-closed 缺陷
|
|
59
|
+
|
|
60
|
+
像“输出永不超出上限”这种性质是单边的:它无法检测到使代码 **fail closed**(拒绝一切,包括合法输入)的变异体——因为 fail-closed 的变异体永远不会产生超过上限的输出。Mutation score 看起来未受影响,而整整一类缺陷(拒绝服务、错误拒绝合法请求)对测试套件完全隐形。
|
|
61
|
+
|
|
62
|
+
**修复方法**:将每个单边不变式与其相反边界配对。“永不超出上限”需要一个搭档性质——例如“接受上限及以下的一切输入”——以便过度宽容和过度严格的变异体都有一条被检测到的路径。
|
|
63
|
+
|
|
64
|
+
---
|
|
65
|
+
|
|
66
|
+
## Equivalent mutant 不是要追杀的存活者
|
|
67
|
+
|
|
68
|
+
存活的变异体并不自动等同于测试缺口。有些变异体与原始代码**语义等价**——没有任何输入能区分两者的行为——无论测试怎么写都无法杀死它们。用一个仅仅为了推高分数而存在的断言(例如对一个无关紧要的值加上 `expect(x).toBeDefined()`)硬杀,只会制造一个空心测试,而没有真正填补任何缺口。
|
|
69
|
+
|
|
70
|
+
**每个被审查过的存活者都必须分类**:
|
|
71
|
+
- **真实缺口** → 编写一个能触发该可区分行为的测试。
|
|
72
|
+
- **`equivalent, because <reason>`** → 连同为了得出此结论而检查过的输入一并记录。
|
|
73
|
+
|
|
74
|
+
未分类的存活者不等于已分类为 equivalent 的存活者。只有已分类为 equivalent 的变异体,才可以从分母中排除。
|
|
75
|
+
|
|
76
|
+
---
|
|
77
|
+
|
|
42
78
|
## 工具
|
|
43
79
|
|
|
44
80
|
| 语言 | 工具 | 命令 |
|
|
@@ -96,6 +132,9 @@ npm install --save-dev @stryker-mutator/core @stryker-mutator/vitest-runner
|
|
|
96
132
|
- 在每个 PR 的 CI 中都加入变异测试(太慢)
|
|
97
133
|
- 未经 mutation score 验证就接受 AI 生成的测试
|
|
98
134
|
- 靠加 `toBeDefined()` 断言来杀死变异
|
|
135
|
+
- 仅凭一次聚合(非隔离)的 mutation run 就宣称“property suite 验证了 X”
|
|
136
|
+
- 对具有 fail-closed 失效模式的性质,只使用单边不变式
|
|
137
|
+
- 对语义等价的变异体强行杀死,而不是分类为 `equivalent, because <reason>`
|
|
99
138
|
|
|
100
139
|
---
|
|
101
140
|
|
|
@@ -2,24 +2,45 @@
|
|
|
2
2
|
source: ../../../core/observability-standards.md
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
|
-
last_synced: 2026-
|
|
5
|
+
last_synced: 2026-10-16
|
|
6
|
+
source_hash: d6bf74a0b5be
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
9
10
|
# 可观测性标准
|
|
10
11
|
|
|
11
|
-
>
|
|
12
|
+
> **语言**: [English](../../../core/observability-standards.md) | [繁體中文](../../zh-TW/core/observability-standards.md) | 简体中文
|
|
13
|
+
|
|
14
|
+
**版本**: 1.0.0
|
|
15
|
+
**最后更新**: 2026-03-31
|
|
16
|
+
**适用范围**: 所有软件项目
|
|
17
|
+
**范围**: 通用
|
|
18
|
+
**行业标准**: OpenTelemetry, W3C Trace Context, Google SRE (Golden Signals)
|
|
19
|
+
**参考资料**: [opentelemetry.io](https://opentelemetry.io/), [sre.google](https://sre.google/)
|
|
20
|
+
|
|
21
|
+
---
|
|
12
22
|
|
|
13
23
|
## 概述
|
|
14
24
|
|
|
15
|
-
|
|
25
|
+
本文件定义了跨三大支柱构建可观测系统的可观测性标准:**Logs(日志)**、**Metrics(指标)** 和 **Traces(追踪)**。它通过添加全面的 Metrics 和 Traces 指引、统一关联框架以及操作检查清单,对现有的 [日志标准](logging-standards.md) 进行了补充。
|
|
16
26
|
|
|
17
|
-
|
|
27
|
+
有关包含结构化日志、日志级别、敏感数据处理以及 OpenTelemetry 集成的完整 Logs 指引,请参阅 [日志标准](logging-standards.md)。
|
|
18
28
|
|
|
19
29
|
---
|
|
20
30
|
|
|
21
31
|
## 三大支柱框架
|
|
22
32
|
|
|
33
|
+
现代可观测性依赖于三个互补的支柱,每个支柱都为洞察系统行为提供了不同的视角:
|
|
34
|
+
|
|
35
|
+
```
|
|
36
|
+
┌──────────┐ trace_id ┌──────────┐ trace_id ┌──────────┐
|
|
37
|
+
│ LOGS │◄───────────────►│ TRACES │◄───────────────►│ METRICS │
|
|
38
|
+
│ (Events) │ │ (Spans) │ │(Counters)│
|
|
39
|
+
└──────────┘ └──────────┘ └──────────┘
|
|
40
|
+
│ │ │
|
|
41
|
+
└────────── service.name ────┴──────── service.name ──────┘
|
|
42
|
+
```
|
|
43
|
+
|
|
23
44
|
| 支柱 | 捕获内容 | 使用场景 | 粒度 |
|
|
24
45
|
|------|---------|---------|------|
|
|
25
46
|
| **Logs** | 具备上下文的离散事件 | 调试、审计追踪、错误详情 | 高(每事件) |
|
|
@@ -28,15 +49,23 @@ status: current
|
|
|
28
49
|
|
|
29
50
|
### 跨支柱关联
|
|
30
51
|
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
52
|
+
可观测性的威力来自于跨支柱的关联:
|
|
53
|
+
|
|
54
|
+
1. **Metric 异常 → Trace**:在指标上使用 Exemplars 链接到表现出异常行为的特定 Trace
|
|
55
|
+
2. **Trace → Logs**:使用嵌入在日志中的 `trace_id` 和 `span_id` 查找特定请求的所有日志条目
|
|
56
|
+
3. **Logs → Metric**:将日志模式聚合为指标(例如:从错误日志计算错误率)
|
|
34
57
|
|
|
35
|
-
|
|
58
|
+
**关键关联字段:**
|
|
59
|
+
- `trace_id` — 链接 Logs ↔ Traces ↔ Metrics(通过 Exemplars)
|
|
60
|
+
- `service.name` — 按服务标识过滤所有三大支柱
|
|
36
61
|
|
|
37
62
|
---
|
|
38
63
|
|
|
39
|
-
##
|
|
64
|
+
## Metrics
|
|
65
|
+
|
|
66
|
+
### Metric 类型
|
|
67
|
+
|
|
68
|
+
根据需要量测的内容选择适当的 Metric 类型:
|
|
40
69
|
|
|
41
70
|
| 类型 | 用途 | 行为 | 使用场景 |
|
|
42
71
|
|------|------|------|---------|
|
|
@@ -45,30 +74,220 @@ status: current
|
|
|
45
74
|
| **Histogram** | 跨 Bucket 的值分布 | 记录值到预定义 Bucket | 请求持续时间、响应大小 |
|
|
46
75
|
| **Summary** | 客户端计算的百分位数 | 在客户端计算分位数 | 旧系统、不需服务端聚合时 |
|
|
47
76
|
|
|
77
|
+
**决策指引:**
|
|
78
|
+
```
|
|
79
|
+
Does the value only go up?
|
|
80
|
+
├─ Yes → Counter (e.g., http.server.request.total)
|
|
81
|
+
└─ No
|
|
82
|
+
├─ Do you need distribution/percentiles?
|
|
83
|
+
│ ├─ Yes → Histogram (e.g., http.server.request.duration.seconds)
|
|
84
|
+
│ └─ No → Gauge (e.g., system.memory.usage.bytes)
|
|
85
|
+
└─ Legacy requirement for client-side percentiles?
|
|
86
|
+
└─ Yes → Summary
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
### 命名规范
|
|
90
|
+
|
|
91
|
+
遵循以下模式:`<domain>.<entity>.<action>.<unit>`
|
|
92
|
+
|
|
93
|
+
| 组件 | 描述 | 示例 |
|
|
94
|
+
|------|------|------|
|
|
95
|
+
| `domain` | 系统领域 | `http`, `db`, `queue`, `system` |
|
|
96
|
+
| `entity` | 资源类型 | `server`, `client`, `connection` |
|
|
97
|
+
| `action` | 量测内容 | `request`, `query`, `usage` |
|
|
98
|
+
| `unit` | 量测单位 | `seconds`, `bytes`, `total` |
|
|
99
|
+
|
|
100
|
+
**示例:**
|
|
101
|
+
- `http.server.request.duration.seconds` — HTTP 服务端请求持续时间
|
|
102
|
+
- `http.server.request.total` — HTTP 请求总数(Counter)
|
|
103
|
+
- `db.client.query.duration.seconds` — 数据库查询持续时间
|
|
104
|
+
- `system.memory.usage.bytes` — 内存使用量(Gauge)
|
|
105
|
+
- `queue.consumer.lag.messages` — 以消息数计的消费者滞后
|
|
106
|
+
|
|
107
|
+
**规则:**
|
|
108
|
+
- 多词组件使用 `snake_case`
|
|
109
|
+
- Gauge 和 Histogram 务必包含单位后缀
|
|
110
|
+
- Counter 使用 `.total` 后缀
|
|
111
|
+
- 避免使用缩写(使用 `request` 而非 `req`)
|
|
112
|
+
|
|
113
|
+
### Label 最佳实践
|
|
114
|
+
|
|
115
|
+
Label(也称为 tag 或 attribute)为指标添加维度。
|
|
116
|
+
|
|
117
|
+
**Do:**
|
|
118
|
+
- 使用具有有界、低基数值的 Label
|
|
119
|
+
- 常见 Label:`method`、`status_code`、`service`、`environment`
|
|
120
|
+
- 保持相关指标之间的 Label 集合一致
|
|
121
|
+
|
|
122
|
+
**Don't — 预防高基数:**
|
|
123
|
+
|
|
124
|
+
> ⚠️ **警告**:基数超过 **1000 个唯一值**的 Label 会导致过多的内存占用和存储成本。高基数数据(用户 ID、请求 ID、IP 地址)应记录在 **Logs 或 Traces** 中,而不是作为指标 Label。
|
|
125
|
+
|
|
126
|
+
| 不良(高基数) | 良好(低基数) |
|
|
127
|
+
|----------------|----------------|
|
|
128
|
+
| `user_id="usr_12345"` | 使用带有 `user_id` 字段的 Logs |
|
|
129
|
+
| `request_id="req_abc"` | 使用带有 `span_id` 的 Traces |
|
|
130
|
+
| `url="/api/users/12345"` | `route="/api/users/{id}"` |
|
|
131
|
+
| `ip="192.168.1.100"` | `region="us-east-1"` |
|
|
132
|
+
|
|
133
|
+
---
|
|
134
|
+
|
|
135
|
+
## Traces
|
|
136
|
+
|
|
137
|
+
### Span 设计原则
|
|
138
|
+
|
|
139
|
+
Span 代表 Trace 内的单个工作单元。
|
|
140
|
+
|
|
141
|
+
**命名:**
|
|
142
|
+
- 使用描述性名称:`db.query.users.findById`、`http.server.POST./api/orders`
|
|
143
|
+
- 包含操作类型和目标
|
|
144
|
+
- 避免使用像 `doWork` 或 `process` 这样的宽泛名称
|
|
145
|
+
|
|
146
|
+
**必需的 Span 属性:**
|
|
147
|
+
| 属性 | 描述 | 示例 |
|
|
148
|
+
|------|------|------|
|
|
149
|
+
| `service.name` | 服务标识 | `payment-service` |
|
|
150
|
+
| `span.kind` | Client/Server/Internal | `SERVER` |
|
|
151
|
+
| 操作专属属性 | 取决于操作类型 | `http.method=POST` |
|
|
152
|
+
|
|
153
|
+
**粒度指引:**
|
|
154
|
+
- **过粗**:整个请求处理只有一个 Span → 无法看清瓶颈
|
|
155
|
+
- **过细**:每个函数调用一个 Span → 过多的开销与噪声
|
|
156
|
+
- **恰到好处**:每个关键 I/O 操作或业务步骤一个 Span
|
|
157
|
+
|
|
158
|
+
**经验法则:** 在以下情况创建 Span:
|
|
159
|
+
1. 跨越网络边界(HTTP 调用、数据库查询、消息发送)
|
|
160
|
+
2. 发生具有业务重要性的步骤(订单创建、支付处理)
|
|
161
|
+
3. 发生潜在的缓慢操作(文件 I/O、计算 > 10ms)
|
|
162
|
+
|
|
163
|
+
### 采样策略
|
|
164
|
+
|
|
165
|
+
生产环境的 Trace 可能会产生庞大的数据量。使用采样可以在控制成本的同时保留可观测性。
|
|
166
|
+
|
|
167
|
+
| 策略 | 运作方式 | 优点 | 缺点 | 使用场景 |
|
|
168
|
+
|------|---------|------|------|---------|
|
|
169
|
+
| **Head-based** | 在 Trace 开始时做决定(例如:10% 采样率) | 简单、低开销、成本可预测 | 可能会遗漏重要 Trace(错误、慢请求) | 高流量服务、成本敏感型场景 |
|
|
170
|
+
| **Tail-based** | 在 Trace 完成后做决定(保留错误/慢请求) | 保留异常、捕获重要 Trace | 需要缓冲、资源占用较高 | 错误检测、性能分析 |
|
|
171
|
+
| **Adaptive** | 基于流量动态调整采样率 | 能够应对流量突增、成本均衡 | 实现和调优较为复杂 | 流量模式多变的服务 |
|
|
172
|
+
|
|
173
|
+
**建议:**
|
|
174
|
+
- 大多数服务从 Head-based 采样(1-10%)开始
|
|
175
|
+
- 针对必须捕获错误的关键路径添加 Tail-based 采样
|
|
176
|
+
- 针对流量 > 10K RPS 的服务考虑采用 Adaptive 采样
|
|
177
|
+
|
|
178
|
+
### 性能开销控制
|
|
179
|
+
|
|
180
|
+
追踪会增加开销。请将其控制在可管理的范围内:
|
|
181
|
+
|
|
182
|
+
| 指标 | 目标 | 超标时的应对措施 |
|
|
183
|
+
|------|------|-----------------|
|
|
184
|
+
| CPU 开销 | < 2% | 降低采样率 |
|
|
185
|
+
| 内存开销 | < 50MB | 减少 Span 属性数量 |
|
|
186
|
+
| 网络开销 | < 流量的 1% | 批量导出、压缩 |
|
|
187
|
+
| 延迟影响 | 每个 Span < 1ms | 使用异步导出 |
|
|
188
|
+
|
|
189
|
+
### 跨服务传播
|
|
190
|
+
|
|
191
|
+
对于分布式系统,使用 W3C Trace Context 标准传播 Trace 上下文:
|
|
192
|
+
|
|
193
|
+
**W3C Trace Context 请求头:**
|
|
194
|
+
```
|
|
195
|
+
traceparent: 00-<trace_id>-<span_id>-<flags>
|
|
196
|
+
tracestate: <vendor>=<value>
|
|
197
|
+
```
|
|
198
|
+
|
|
199
|
+
**跨边界传播:**
|
|
200
|
+
- **HTTP**:`traceparent` 和 `tracestate` 请求头
|
|
201
|
+
- **gRPC**:Metadata 键
|
|
202
|
+
- **消息队列**:消息头/属性
|
|
203
|
+
- **异步作业**:存储在作业元数据中
|
|
204
|
+
|
|
48
205
|
---
|
|
49
206
|
|
|
50
|
-
##
|
|
207
|
+
## 黄金信号检查清单
|
|
208
|
+
|
|
209
|
+
基于 Google SRE 的四大黄金信号(Four Golden Signals),每个服务在进入生产环境之前都应当(SHOULD)监控以下各项:
|
|
210
|
+
|
|
211
|
+
### 延迟(Latency)
|
|
51
212
|
|
|
52
|
-
|
|
213
|
+
| 方面 | 量测 | 建议指标 |
|
|
214
|
+
|--------|------------|-------------------|
|
|
215
|
+
| 请求持续时间 | 使用 Histogram 统计 P50、P95、P99 百分位数 | `http.server.request.duration.seconds` |
|
|
216
|
+
| 成功与失败 | 分别记录成功/错误响应的延迟 | 添加 `status` 标签 |
|
|
217
|
+
| 告警阈值 | P99 > X ms 持续 5 分钟 | 基于 SLO 目标 |
|
|
53
218
|
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
|
57
|
-
|
|
58
|
-
|
|
|
59
|
-
|
|
|
219
|
+
### 流量(Traffic)
|
|
220
|
+
|
|
221
|
+
| 方面 | 量测 | 建议指标 |
|
|
222
|
+
|--------|------------|-------------------|
|
|
223
|
+
| 请求量 | 每秒请求数(RPS) | `http.server.request.total`(Counter,rate) |
|
|
224
|
+
| 按端点划分 | 按 route/method 细分 | 添加 `route`、`method` 标签 |
|
|
225
|
+
| 告警阈值 | 突降 > 50% 或突增 > 200% | 与上周同期相比 |
|
|
226
|
+
|
|
227
|
+
### 错误(Errors)
|
|
228
|
+
|
|
229
|
+
| 方面 | 量测 | 建议指标 |
|
|
230
|
+
|--------|------------|-------------------|
|
|
231
|
+
| 错误率 | 错误数 / 总请求数(百分比) | `http.server.request.total{status=~"5.."}` / `http.server.request.total` |
|
|
232
|
+
| 按类型划分 | 按错误码/错误类别细分 | 添加 `status_code`、`error_type` 标签 |
|
|
233
|
+
| 告警阈值 | 错误率 > X% 持续 5 分钟 | 基于 SLO 目标 |
|
|
234
|
+
|
|
235
|
+
### 饱和度(Saturation)
|
|
236
|
+
|
|
237
|
+
| 方面 | 量测 | 建议指标 |
|
|
238
|
+
|--------|------------|-------------------|
|
|
239
|
+
| CPU 利用率 | 可用 CPU 百分比 | `system.cpu.utilization`(Gauge) |
|
|
240
|
+
| 内存利用率 | 可用内存百分比 | `system.memory.utilization`(Gauge) |
|
|
241
|
+
| 连接池 | 活跃连接数 / 最大连接数 | `db.client.connection.pool.usage`(Gauge) |
|
|
242
|
+
| 磁盘 I/O | 读/写吞吐量与队列深度 | `system.disk.io`(Counter) |
|
|
243
|
+
| 告警阈值 | 资源使用率 > 80% 持续 10 分钟 | 预饱和告警 |
|
|
60
244
|
|
|
61
245
|
---
|
|
62
246
|
|
|
63
247
|
## 可观测性成熟度模型
|
|
64
248
|
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
|
68
|
-
|
|
69
|
-
| **
|
|
70
|
-
| **
|
|
71
|
-
| **
|
|
249
|
+
使用此模型评估团队当前的可观测性水平并规划改进方案:
|
|
250
|
+
|
|
251
|
+
| 级别 | 名称 | 特征 | 升级行动 |
|
|
252
|
+
|-------|------|----------------|-----------------|
|
|
253
|
+
| **L0** | 无可观测性 | 无结构化日志;仅 stdout/stderr;通过 SSH 和 `tail -f` 调试 | 实施结构化日志;集中日志收集 |
|
|
254
|
+
| **L1** | 基础日志 | JSON 格式的结构化日志;集中收集;具备基础搜索能力 | 添加关键业务指标;创建首个仪表板 |
|
|
255
|
+
| **L2** | 指标驱动 | Logs + Metrics 就位;关键服务配备仪表板;基于阈值的基本告警 | 启用分布式追踪;实施基于 SLO 的告警 |
|
|
256
|
+
| **L3** | 完整可观测性 | 三大支柱均已运行;关联查询正常工作;基于 SLO 告警;监控黄金信号 | 添加异常检测;针对已知问题实施自动修复 |
|
|
257
|
+
| **L4** | 智能可观测性 | AIOps 异常检测;预测性告警;自动修复;持续优化 | 维护与优化;在全组织内分享经验 |
|
|
258
|
+
|
|
259
|
+
**自评估问题:**
|
|
260
|
+
1. 能否跨所有服务查找特定请求的日志?(L1+)
|
|
261
|
+
2. 能否查看显示当前错误率和延迟的仪表板?(L2+)
|
|
262
|
+
3. 能否追踪从入口到数据库并返回的请求?(L3+)
|
|
263
|
+
4. 系统是否能在用户报告前自动检测到异常?(L4)
|
|
264
|
+
|
|
265
|
+
---
|
|
266
|
+
|
|
267
|
+
## 插桩检查清单
|
|
268
|
+
|
|
269
|
+
在将服务部署到生产环境之前,请核验以下事项:
|
|
270
|
+
|
|
271
|
+
- [ ] **启用结构化日志** — JSON 格式并具备 `trace_id` 关联(参阅 [日志标准](logging-standards.md))
|
|
272
|
+
- [ ] **HTTP/gRPC 入口指标** — 所有端点的请求计数、持续时间直方图与错误率
|
|
273
|
+
- [ ] **关键业务操作自定义指标** — 追踪关键业务事件(如下单、支付处理)
|
|
274
|
+
- [ ] **启用分布式追踪** — 配置 Span 传播、设置采样率、支持 W3C Trace Context 请求头
|
|
275
|
+
- [ ] **健康检查端点** — 实现存活探针(Liveness probe,进程是否运行?)与就绪探针(Readiness probe,能否承接流量?)
|
|
276
|
+
- [ ] **覆盖黄金信号的仪表板** — 至少对延迟(Latency)、流量(Traffic)、错误(Errors)和饱和度(Saturation)实现可视化
|
|
277
|
+
- [ ] **定义告警规则** — 至少配置了 SLO 燃尽率告警(参阅 [告警标准](alerting-standards.md))
|
|
278
|
+
- [ ] **配置日志保留** — 按日志级别设置保留策略
|
|
279
|
+
- [ ] **排除敏感数据** — 日志/追踪中不含密码、Token 或 PII
|
|
280
|
+
|
|
281
|
+
---
|
|
282
|
+
|
|
283
|
+
## OpenTelemetry 集成
|
|
284
|
+
|
|
285
|
+
OpenTelemetry(OTel)是推荐的插桩框架。有关 OTel 语义规范和集成模式的详细说明,请参阅 [日志标准 — OpenTelemetry 集成](logging-standards.md#opentelemetry-integration) 章节。
|
|
286
|
+
|
|
287
|
+
关键要点:
|
|
288
|
+
- 在支持的情况下,优先使用 OTel SDK 进行自动插桩
|
|
289
|
+
- 遵循 OTel 属性命名的语义规范(semantic conventions)
|
|
290
|
+
- 导出至 OTel Collector 以构建厂商中立的数据管道
|
|
72
291
|
|
|
73
292
|
---
|
|
74
293
|
|
|
@@ -76,31 +295,56 @@ status: current
|
|
|
76
295
|
|
|
77
296
|
### Metric 类型选择
|
|
78
297
|
```
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
298
|
+
Only goes up? → Counter
|
|
299
|
+
Goes up and down? → Gauge
|
|
300
|
+
Need distribution? → Histogram
|
|
301
|
+
Client percentiles? → Summary
|
|
83
302
|
```
|
|
84
303
|
|
|
85
304
|
### 采样策略选择
|
|
86
305
|
```
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
306
|
+
High traffic, cost-sensitive? → Head-based (1-10%)
|
|
307
|
+
Must capture all errors? → Tail-based
|
|
308
|
+
Traffic varies widely? → Adaptive
|
|
90
309
|
```
|
|
91
310
|
|
|
92
311
|
### 成熟度级别快速检查
|
|
93
312
|
```
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
Logs + Metrics +
|
|
97
|
-
|
|
98
|
-
AIOps +
|
|
313
|
+
No structured logs? → L0
|
|
314
|
+
Structured logs, centralized? → L1
|
|
315
|
+
Logs + Metrics + Dashboards? → L2
|
|
316
|
+
All three pillars + SLO alerts? → L3
|
|
317
|
+
AIOps + Auto-remediation? → L4
|
|
99
318
|
```
|
|
100
319
|
|
|
101
320
|
---
|
|
102
321
|
|
|
322
|
+
## 参考资料
|
|
323
|
+
|
|
324
|
+
- [OpenTelemetry Specification](https://opentelemetry.io/docs/specs/otel/) — 可观测性插桩的行业标准
|
|
325
|
+
- [OpenTelemetry Semantic Conventions](https://opentelemetry.io/docs/specs/semconv/) — 标准化属性命名
|
|
326
|
+
- [W3C Trace Context](https://www.w3.org/TR/trace-context/) — 分布式追踪上下文传播
|
|
327
|
+
- [Google SRE — Monitoring Distributed Systems](https://sre.google/sre-book/monitoring-distributed-systems/) — 黄金信号的起源
|
|
328
|
+
- [Google SRE — Alerting on SLOs](https://sre.google/workbook/alerting-on-slos/) — 多窗口燃尽率告警
|
|
329
|
+
|
|
330
|
+
---
|
|
331
|
+
|
|
103
332
|
**相关标准:**
|
|
104
|
-
- [日志标准](logging-standards.md) —
|
|
333
|
+
- [日志标准](logging-standards.md) — 完整的 Logs 支柱指引
|
|
105
334
|
- [SLO 标准](slo-standards.md) — SLI/SLO/Error Budget 定义
|
|
106
335
|
- [告警标准](alerting-standards.md) — 告警设计与管理
|
|
336
|
+
- [性能标准](performance-standards.md) — 性能目标与基准
|
|
337
|
+
|
|
338
|
+
---
|
|
339
|
+
|
|
340
|
+
## 版本历史
|
|
341
|
+
|
|
342
|
+
| 版本 | 日期 | 变更 |
|
|
343
|
+
|---------|------|---------|
|
|
344
|
+
| 1.0.0 | 2026-03-31 | 初始版本:Metrics、Traces、黄金信号、成熟度模型、插桩检查清单 |
|
|
345
|
+
|
|
346
|
+
---
|
|
347
|
+
|
|
348
|
+
## 许可证
|
|
349
|
+
|
|
350
|
+
本标准基于 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 发布。
|