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
|
@@ -1,23 +1,24 @@
|
|
|
1
1
|
---
|
|
2
2
|
source: ../../../core/performance-standards.md
|
|
3
|
-
source_version: 1.
|
|
4
|
-
translation_version: 1.
|
|
5
|
-
last_synced: 2026-
|
|
3
|
+
source_version: 1.2.0
|
|
4
|
+
translation_version: 1.2.0
|
|
5
|
+
last_synced: 2026-10-16
|
|
6
|
+
source_hash: b678e96a3ff1
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
9
|
-
> **语言**: [English](../../../core/performance-standards.md) | 简体中文
|
|
10
|
-
|
|
11
10
|
# 性能标准
|
|
12
11
|
|
|
13
|
-
|
|
14
|
-
|
|
12
|
+
> **语言**: [English](../../../core/performance-standards.md) | [繁體中文](../../zh-TW/core/performance-standards.md) | 简体中文
|
|
13
|
+
|
|
14
|
+
**版本**: 1.2.0
|
|
15
|
+
**最后更新**: 2026-06-17
|
|
15
16
|
**适用范围**: 所有软件项目
|
|
16
17
|
**范围**: universal
|
|
17
18
|
**行业标准**: ISO/IEC 25010 Performance Efficiency
|
|
18
19
|
**参考**: [sre.google](https://sre.google/books/)
|
|
19
20
|
|
|
20
|
-
> **详细说明和优化技术请参阅 [性能指南](
|
|
21
|
+
> **详细说明和优化技术请参阅 [性能指南](guides/performance-guide.md)**
|
|
21
22
|
|
|
22
23
|
---
|
|
23
24
|
|
|
@@ -36,20 +37,20 @@ status: current
|
|
|
36
37
|
### NFR 格式
|
|
37
38
|
|
|
38
39
|
```markdown
|
|
39
|
-
### NFR-PERF-XXX: [
|
|
40
|
+
### NFR-PERF-XXX: [Title]
|
|
40
41
|
|
|
41
|
-
|
|
42
|
-
|
|
42
|
+
**Category**: Performance Efficiency > [Time Behavior/Resource Utilization/Capacity]
|
|
43
|
+
**Priority**: P1/P2/P3
|
|
43
44
|
|
|
44
|
-
|
|
45
|
-
|
|
|
46
|
-
|
|
45
|
+
**Requirement**:
|
|
46
|
+
| Percentile | Target | Maximum |
|
|
47
|
+
|------------|--------|---------|
|
|
47
48
|
| p50 | Xms | Yms |
|
|
48
49
|
| p95 | Xms | Yms |
|
|
49
50
|
| p99 | Xms | Yms |
|
|
50
51
|
|
|
51
|
-
|
|
52
|
-
|
|
52
|
+
**Conditions**: [Load, data volume, etc.]
|
|
53
|
+
**Measurement**: [Tool, sampling, reporting]
|
|
53
54
|
```
|
|
54
55
|
|
|
55
56
|
---
|
|
@@ -57,7 +58,7 @@ status: current
|
|
|
57
58
|
## 常见性能目标
|
|
58
59
|
|
|
59
60
|
| 系统类型 | 响应时间(p95) | 吞吐量 | 可用性 |
|
|
60
|
-
|
|
61
|
+
|-------------|---------------------|------------|--------------|
|
|
61
62
|
| **电商** | < 200ms | 1000+ rps | 99.9% |
|
|
62
63
|
| **内部工具** | < 500ms | 100+ rps | 99.5% |
|
|
63
64
|
| **批处理** | 不适用 | 10K+ 记录/分钟 | 99% |
|
|
@@ -66,28 +67,152 @@ status: current
|
|
|
66
67
|
|
|
67
68
|
---
|
|
68
69
|
|
|
69
|
-
##
|
|
70
|
+
## Core Web Vitals 目标
|
|
71
|
+
|
|
72
|
+
| 指标 | 目标 | 描述 |
|
|
73
|
+
|--------|--------|-------------|
|
|
74
|
+
| **LCP** (Largest Contentful Paint) | < 2.5s | 感知加载速度 |
|
|
75
|
+
| **INP** (Interaction to Next Paint) | < 200ms | 响应性 |
|
|
76
|
+
| **CLS** (Cumulative Layout Shift) | < 0.1 | 视觉稳定性 |
|
|
77
|
+
|
|
78
|
+
---
|
|
79
|
+
|
|
80
|
+
## 性能预算
|
|
81
|
+
|
|
82
|
+
```yaml
|
|
83
|
+
# Example Performance Budget
|
|
84
|
+
resources:
|
|
85
|
+
total_size: 500KB
|
|
86
|
+
javascript: 200KB
|
|
87
|
+
css: 50KB
|
|
88
|
+
images: 200KB
|
|
89
|
+
fonts: 50KB
|
|
90
|
+
|
|
91
|
+
metrics:
|
|
92
|
+
time_to_interactive: 3s
|
|
93
|
+
first_contentful_paint: 1.5s
|
|
94
|
+
speed_index: 3s
|
|
95
|
+
|
|
96
|
+
lighthouse_scores:
|
|
97
|
+
performance: 90
|
|
98
|
+
accessibility: 100
|
|
99
|
+
best_practices: 100
|
|
100
|
+
seo: 100
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
---
|
|
104
|
+
|
|
105
|
+
## 性能指标
|
|
106
|
+
|
|
107
|
+
### 百分位指南
|
|
108
|
+
|
|
109
|
+
| 百分位 | 含义 | 适用场景 |
|
|
110
|
+
|------------|---------|---------|
|
|
111
|
+
| **p50** | 中位数 | 典型用户体验 |
|
|
112
|
+
| **p90** | 90% 更快 | 大多数用户体验 |
|
|
113
|
+
| **p95** | 95% 更快 | SLA 阈值(常见) |
|
|
114
|
+
| **p99** | 99% 更快 | 大多数用户的最差情况 |
|
|
115
|
+
| **p99.9** | 99.9% 更快 | 高容量系统 |
|
|
116
|
+
|
|
117
|
+
### 四个黄金信号(SRE)
|
|
118
|
+
|
|
119
|
+
| 信号 | 测量内容 | 目标 |
|
|
120
|
+
|--------|-----------------|--------|
|
|
121
|
+
| **Latency** | 响应时间(p50, p95, p99) | < SLA |
|
|
122
|
+
| **Traffic** | 每秒请求数 | 取决于容量 |
|
|
123
|
+
| **Errors** | 错误率 % | < 0.1% |
|
|
124
|
+
| **Saturation** | 资源利用率 | 持续 < 70% |
|
|
125
|
+
|
|
126
|
+
---
|
|
127
|
+
|
|
128
|
+
## 告警阈值
|
|
129
|
+
|
|
130
|
+
| 指标 | 警告 | 严重 | 操作 |
|
|
131
|
+
|--------|---------|----------|--------|
|
|
132
|
+
| **p95 响应时间** | > 200ms | > 500ms | 调查、扩容 |
|
|
133
|
+
| **错误率** | > 0.1% | > 1% | 呼叫 on-call |
|
|
134
|
+
| **CPU 使用率** | > 70% | > 90% | 扩容、优化 |
|
|
135
|
+
| **内存使用率** | > 80% | > 95% | 扩容、排查泄漏 |
|
|
136
|
+
| **磁盘使用率** | > 80% | > 95% | 清理、扩容 |
|
|
137
|
+
|
|
138
|
+
---
|
|
139
|
+
|
|
140
|
+
## 容量规划阈值
|
|
141
|
+
|
|
142
|
+
| 资源 | 规划阈值 | 严重 |
|
|
143
|
+
|----------|---------|----------|
|
|
144
|
+
| **计算 (CPU)** | 持续 70% | 90% |
|
|
145
|
+
| **内存** | 80% | 95% |
|
|
146
|
+
| **存储** | 70% | 90% |
|
|
147
|
+
| **网络** | 60% | 80% |
|
|
148
|
+
| **数据库连接** | 80% | 95% |
|
|
149
|
+
|
|
150
|
+
---
|
|
151
|
+
|
|
152
|
+
## 连接池配置
|
|
153
|
+
|
|
154
|
+
| 参数 | 建议值 | 说明 |
|
|
155
|
+
|-----------|-------------|-------|
|
|
156
|
+
| **最小连接数** | 5-10 | 保持预热连接 |
|
|
157
|
+
| **最大连接数** | 20-100 | 取决于数据库和应用服务器 |
|
|
158
|
+
| **空闲超时** | 10-30 分钟 | 释放未使用的连接 |
|
|
159
|
+
| **连接超时** | 5-10 秒 | 遇到问题时快速失败 |
|
|
160
|
+
|
|
161
|
+
---
|
|
162
|
+
|
|
163
|
+
## 限流配置
|
|
70
164
|
|
|
71
|
-
|
|
|
72
|
-
|
|
73
|
-
|
|
|
74
|
-
|
|
|
75
|
-
|
|
|
76
|
-
|
|
|
165
|
+
| 端点类型 | 限制 | 突发 |
|
|
166
|
+
|---------------|-------|-------|
|
|
167
|
+
| **公开 API** | 100/分钟 | 10 |
|
|
168
|
+
| **已认证** | 1000/分钟 | 50 |
|
|
169
|
+
| **高级层级** | 10000/分钟 | 200 |
|
|
170
|
+
| **内部** | 无限制 | 不适用 |
|
|
77
171
|
|
|
78
172
|
---
|
|
79
173
|
|
|
80
|
-
##
|
|
174
|
+
## 性能测试频率
|
|
81
175
|
|
|
82
|
-
|
|
176
|
+
| 测试类型 | 开发环境 | 预发布环境 | 生产环境 |
|
|
177
|
+
|-----------|-------------|---------|------------|
|
|
178
|
+
| **单元性能** | 每次提交 | - | - |
|
|
179
|
+
| **负载测试** | 每周 | 每次发布 | 每月 |
|
|
180
|
+
| **压力测试** | 每月 | 每次发布 | 每季度 |
|
|
181
|
+
| **浸泡测试** | 每月 | 重大发布 | 每季度 |
|
|
182
|
+
| **峰值测试** | - | 重大发布 | 活动前 |
|
|
83
183
|
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
184
|
+
---
|
|
185
|
+
|
|
186
|
+
## 性能检查清单
|
|
187
|
+
|
|
188
|
+
### 开发阶段
|
|
189
|
+
|
|
190
|
+
- [ ] 定义并记录性能需求
|
|
191
|
+
- [ ] 建立性能预算
|
|
192
|
+
- [ ] 优化数据库查询(索引、EXPLAIN)
|
|
193
|
+
- [ ] 实施缓存策略
|
|
194
|
+
- [ ] 列表端点支持分页
|
|
195
|
+
- [ ] 长时间运行的操作采用异步处理
|
|
196
|
+
- [ ] 配置连接池
|
|
197
|
+
|
|
198
|
+
### 发布前
|
|
199
|
+
|
|
200
|
+
- [ ] 使用类生产数据完成负载测试
|
|
201
|
+
- [ ] 完成压力测试(找出断裂点)
|
|
202
|
+
- [ ] 在 CI/CD 中进行性能回归测试
|
|
203
|
+
- [ ] 达到 Core Web Vitals 目标(若为前端)
|
|
204
|
+
- [ ] 完成数据库查询分析
|
|
205
|
+
- [ ] 缓存命中率在可接受范围内
|
|
206
|
+
- [ ] 错误率低于阈值
|
|
207
|
+
|
|
208
|
+
### 生产环境
|
|
209
|
+
|
|
210
|
+
- [ ] 配置 APM 监控
|
|
211
|
+
- [ ] 创建性能仪表板
|
|
212
|
+
- [ ] 定义告警阈值
|
|
213
|
+
- [ ] 记录容量规划
|
|
214
|
+
- [ ] 编写性能问题 Runbook
|
|
215
|
+
- [ ] 安排定期性能审查
|
|
91
216
|
|
|
92
217
|
---
|
|
93
218
|
|
|
@@ -99,18 +224,19 @@ status: current
|
|
|
99
224
|
|----------|------|----------|
|
|
100
225
|
| **Load Test** | 验证系统在预期负载下的行为 | 发布前验证、容量规划 |
|
|
101
226
|
| **Stress Test** | 找出系统极限与崩溃行为 | 架构变更、扩展验证 |
|
|
102
|
-
| **Soak Test** |
|
|
103
|
-
| **Spike Test** |
|
|
227
|
+
| **Soak Test** | 检测长时间运行下的内存泄漏或资源耗尽 | 重大发布、资源密集型服务 |
|
|
228
|
+
| **Spike Test** | 验证突发流量下的系统响应与恢复 | 营销活动前、促销事件 |
|
|
104
229
|
|
|
105
230
|
### Baseline 管理
|
|
106
231
|
|
|
107
|
-
|
|
232
|
+
#### 首次建立 Baseline
|
|
233
|
+
|
|
108
234
|
1. 在稳定版本上执行至少 3 次完整 Load Test
|
|
109
235
|
2. 取 p50、p95、p99 的中位数作为 baseline
|
|
110
236
|
3. 记录测试环境配置(硬件、数据量、并发数)
|
|
111
237
|
4. 将 baseline 与测试脚本一同存入版本控制
|
|
112
238
|
|
|
113
|
-
|
|
239
|
+
#### 漂移检测阈值
|
|
114
240
|
|
|
115
241
|
| 指标 | 可接受漂移 | 需调查 | 阻断 |
|
|
116
242
|
|------|-----------|--------|------|
|
|
@@ -120,33 +246,267 @@ status: current
|
|
|
120
246
|
| Throughput | < 5% 下降 | 5-15% 下降 | > 15% 下降 |
|
|
121
247
|
| Error Rate | 无增加 | < 0.1% 增加 | > 0.1% 增加 |
|
|
122
248
|
|
|
249
|
+
#### Baseline 更新策略
|
|
250
|
+
|
|
251
|
+
- 架构重构后:必须(MUST)重新建立 baseline
|
|
252
|
+
- 硬件升级后:应该(SHOULD)更新 baseline
|
|
253
|
+
- 性能优化成功后:应该(SHOULD)将新值设为 baseline
|
|
254
|
+
- 所有 baseline 更新均必须(MUST)记录变更原因与日期
|
|
255
|
+
|
|
123
256
|
### CI 触发条件
|
|
124
257
|
|
|
258
|
+
并非每次 commit 都需要进行性能测试。使用以下触发条件矩阵:
|
|
259
|
+
|
|
125
260
|
| 触发条件 | Load Test | Stress Test | Soak Test | Spike Test |
|
|
126
261
|
|----------|-----------|-------------|-----------|------------|
|
|
127
262
|
| 每次 commit | 否 | 否 | 否 | 否 |
|
|
128
263
|
| PR 合并至 main | 是(精简) | 否 | 否 | 否 |
|
|
129
264
|
| Release tag | 是(完整) | 是 | 否 | 否 |
|
|
130
|
-
|
|
|
265
|
+
| 定时(每周) | 是 | 否 | 是 | 否 |
|
|
266
|
+
| 手动触发 | 是 | 是 | 是 | 是 |
|
|
267
|
+
| 性能相关文件变更 | 是(精简) | 否 | 否 | 否 |
|
|
131
268
|
|
|
132
269
|
### Performance Budget
|
|
133
270
|
|
|
271
|
+
类似于 SRE Error Budget 的概念,Performance Budget 定义了可容忍的性能劣化余量。
|
|
272
|
+
|
|
134
273
|
| 概念 | 定义 | 示例 |
|
|
135
274
|
|------|------|------|
|
|
136
275
|
| **性能目标** | 目标性能水平 | p99 < 200ms |
|
|
137
276
|
| **性能预算** | 允许的劣化余量 | p99 可劣化至 220ms(10%) |
|
|
138
|
-
| **预算消耗** | 累积劣化百分比 |
|
|
277
|
+
| **预算消耗** | 累积劣化百分比 | 本季度已消耗 6% |
|
|
139
278
|
| **预算耗尽** | 触发冻结非必要变更 | 剩余 < 2% 时冻结 |
|
|
140
279
|
|
|
280
|
+
#### 劣化容忍度
|
|
281
|
+
|
|
282
|
+
- p99 延迟劣化不得超过 10%
|
|
283
|
+
- 吞吐量下降不得超过 5%
|
|
284
|
+
- 错误率增加不得超过 0.05%
|
|
285
|
+
- 预算按季度周期重置
|
|
286
|
+
|
|
287
|
+
### 测试报告格式
|
|
288
|
+
|
|
289
|
+
#### 报告模板
|
|
290
|
+
|
|
291
|
+
```markdown
|
|
292
|
+
## Performance Test Report
|
|
293
|
+
|
|
294
|
+
### Test Metadata
|
|
295
|
+
- **Date**: YYYY-MM-DD
|
|
296
|
+
- **Duration**: X minutes
|
|
297
|
+
- **Test Type**: Load / Stress / Soak / Spike
|
|
298
|
+
- **Environment**: staging / production-mirror
|
|
299
|
+
|
|
300
|
+
### Results Summary
|
|
301
|
+
| Metric | Baseline | Current | Change | Status |
|
|
302
|
+
|--------|----------|---------|--------|--------|
|
|
303
|
+
| p50 Latency | Xms | Yms | +Z% | PASS/FAIL |
|
|
304
|
+
| p95 Latency | Xms | Yms | +Z% | PASS/FAIL |
|
|
305
|
+
| p99 Latency | Xms | Yms | +Z% | PASS/FAIL |
|
|
306
|
+
| Throughput | X rps | Y rps | -Z% | PASS/FAIL |
|
|
307
|
+
| Error Rate | X% | Y% | +Z% | PASS/FAIL |
|
|
308
|
+
|
|
309
|
+
### Pass/Fail Determination
|
|
310
|
+
- **Overall**: PASS / FAIL
|
|
311
|
+
- **Failed Criteria**: [list of exceeded thresholds]
|
|
312
|
+
|
|
313
|
+
### Trend Analysis
|
|
314
|
+
- Chart of last 10 runs with baseline markers
|
|
315
|
+
- Anomaly points highlighted
|
|
316
|
+
|
|
317
|
+
### Recommendations
|
|
318
|
+
- Action items based on results
|
|
319
|
+
```
|
|
320
|
+
|
|
321
|
+
#### 通过/失败判定规则
|
|
322
|
+
|
|
323
|
+
- 所有阻断级阈值均在限制范围内 → **PASS**
|
|
324
|
+
- 超过任何阻断级阈值 → **FAIL**
|
|
325
|
+
- 超过调查级阈值 → 记录为警告,不予阻断
|
|
326
|
+
|
|
327
|
+
#### 趋势图要求
|
|
328
|
+
|
|
329
|
+
- 包含至少最近 10 次运行以进行趋势对比
|
|
330
|
+
- 在图表上显示 baseline 标记
|
|
331
|
+
- 高亮显示超过阈值的异常数据点
|
|
332
|
+
|
|
333
|
+
---
|
|
334
|
+
|
|
335
|
+
## 迁移非功能对等 (XSPEC-286)
|
|
336
|
+
|
|
337
|
+
> [XSPEC-284](https://github.com/AsiaOstrich/universal-dev-standards) 9 轴迁移完整性矩阵的一部分(**轴 ⑥ —— 非功能**)。涵盖遗留系统重构 / 重写期间“功能正确、数据正确,但**其运行方式不同**”这一遗漏类别。本节在上述通用 baseline/漂移机制之上增加了**迁移特定**的前后对比语义;它**并不**替代通用的性能框架。
|
|
338
|
+
|
|
339
|
+
### 为什么这是一个真正的缺口
|
|
340
|
+
|
|
341
|
+
上述通用的 Baseline 管理回答的是“*当前版本*相对于*自身*先前的 baseline 是否发生回退”。它**并不**回答“**新**系统是否与其替代的**遗留**系统相匹配”。在重写(例如 PHP 单请求 → .NET 共享状态线程)中,遗留系统的延迟/吞吐量/隔离特性通常是**隐式且未记录在文档中的**,因此单请求功能对等和行为快照对等都可以通过,而系统却可能悄无声息地运行得更慢、耗尽更小的连接池,或丢失锁语义。
|
|
342
|
+
|
|
343
|
+
### 差分 Oracle,而非绝对阈值
|
|
344
|
+
|
|
345
|
+
迁移对等使用**遗留系统作为 baseline** 和**声明的容忍度**,而不是上表中的绝对目标。遗留系统测量得到的实际行为就是 oracle;“未超出声明的容忍度发生回退”即为通过标准。这使得偏离能够自我报告,而无需依赖某人记住去枚举每一条热点路径。
|
|
346
|
+
|
|
347
|
+
### 步骤 1 —— 机械化非功能 baseline 捕获 (R3)
|
|
348
|
+
|
|
349
|
+
遗留系统的非功能特性大部分是隐式的。应从遗留工件中**机械化地**(而非凭记忆)推导 baseline:
|
|
350
|
+
|
|
351
|
+
| 来源 | 推导出的 baseline 项目 |
|
|
352
|
+
|------|----------------------|
|
|
353
|
+
| 关键路由 / 控制器 | 每条关键路径的 p50 / p95 / p99 延迟 |
|
|
354
|
+
| 热点查询 / 慢查询日志 | 单查询延迟、扫描行数 |
|
|
355
|
+
| 后台作业 / cron | 作业持续时间、吞吐量(记录/分钟) |
|
|
356
|
+
| 连接池配置 | 最小/最大连接数、空闲/连接超时 |
|
|
357
|
+
| 超时 / 限流配置 | 每个端点的超时时间、请求数/分钟、突发量 |
|
|
358
|
+
| 事务配置 | 隔离级别(READ COMMITTED / REPEATABLE READ / SERIALIZABLE) |
|
|
359
|
+
|
|
360
|
+
捕获的集合**既是**回退关卡的对比 baseline,**又是**资源/限制对等(步骤 4)的待验证检查清单。
|
|
361
|
+
|
|
362
|
+
### 步骤 2 —— 性能回退差分关卡 (R1)
|
|
363
|
+
|
|
364
|
+
对于每个 baseline 路径,测量新系统中的对应路径,并在声明的容忍度范围内与**遗留 baseline** 进行对比。
|
|
365
|
+
|
|
366
|
+
| 指标 | 默认迁移容忍度 | 何时阻断 |
|
|
367
|
+
|------|----------------|----------|
|
|
368
|
+
| p50 延迟 | ≤ +10% vs 遗留系统 | > +10% |
|
|
369
|
+
| p95 延迟 | ≤ +15% vs 遗留系统 | > +15% |
|
|
370
|
+
| p99 延迟 | ≤ +20% vs 遗留系统 | > +20% |
|
|
371
|
+
| 吞吐量 | ≤ -10% vs 遗留系统 | 下降 > -10% |
|
|
372
|
+
|
|
373
|
+
容忍度是**按路径可配置的**(批处理作业与交互式端点有所不同)。首先在 **shadow**(仅测量,不阻断)模式下运行以收集样本并校准每条路径的容忍度,然后晋级为阻断模式。
|
|
374
|
+
|
|
375
|
+
**关卡时机**:UAT 之前(在签核前捕获回退)**以及**割接之后(捕获仅在真实生产负载下才会显现的回退)。
|
|
376
|
+
|
|
377
|
+
```markdown
|
|
378
|
+
## Migration Performance Parity Report — <path>
|
|
379
|
+
|
|
380
|
+
| Metric | Legacy baseline | New system | Δ | Tolerance | Status |
|
|
381
|
+
|--------|-----------------|------------|---|-----------|--------|
|
|
382
|
+
| p50 | [X]ms | [Y]ms | +[Z]% | +10% | PASS/FAIL |
|
|
383
|
+
| p95 | [X]ms | [Y]ms | +[Z]% | +15% | PASS/FAIL |
|
|
384
|
+
| p99 | [X]ms | [Y]ms | +[Z]% | +20% | PASS/FAIL |
|
|
385
|
+
| Throughput | [X] rps | [Y] rps | -[Z]% | -10% | PASS/FAIL |
|
|
386
|
+
|
|
387
|
+
**Mode**: shadow (measure-only) / blocking
|
|
388
|
+
**Overall**: PASS / FAIL
|
|
389
|
+
```
|
|
390
|
+
|
|
391
|
+
### 步骤 3 —— 并发隔离验证 (R2)
|
|
392
|
+
|
|
393
|
+
相同的资源(同一条记录 / 同一个账户余额 / 同一个序号)可能被多个并发操作访问。遗留系统的锁 / 事务隔离 / 顺序保证属于**隐式行为**,并且经常在重写中被改变——而**功能测试和行为快照对等都无法捕获这一点**(单请求对等 ≠ 并发对等,这与“单请求 ≠ 静态数据”属于同一类盲点)。
|
|
394
|
+
|
|
395
|
+
**方法**:通过并发压力触发竞态条件,然后断言**领域不变量**,而不是逐个检查输出。
|
|
396
|
+
|
|
397
|
+
| 不变量类别 | 示例断言 |
|
|
398
|
+
|------------|----------|
|
|
399
|
+
| 守恒性 | N 次并发转账后 `SUM(balance)` 保持不变 |
|
|
400
|
+
| 唯一性 | 并发分配下无重复序号 |
|
|
401
|
+
| 无丢失更新 | 最后写入者胜出(last-writer-wins)不会悄无声息地覆盖已提交的写入 |
|
|
402
|
+
| 顺序性 | 在并发情况下事件按保证的顺序应用 |
|
|
403
|
+
|
|
404
|
+
检测到**隔离级别降级**(例如遗留系统的 SERIALIZABLE → 新系统的 READ COMMITTED,或移除了行锁)将触发阻断。不变量本身由领域定义;当并发用例与状态流转或时间不变量重叠时,**状态机 / 时间维度的关注点由 XSPEC-287**(轴 ⑧)负责,而并发竞态由本节(轴 ⑥)负责——参见 XSPEC-287 §boundary。
|
|
405
|
+
|
|
406
|
+
**关卡时机**:UAT 之前。
|
|
407
|
+
|
|
408
|
+
### 步骤 4 —— 资源 / 限制对等 (R4)
|
|
409
|
+
|
|
410
|
+
验证遗留系统的资源限制没有因重写而**无意中**发生改变(超时从 30 秒悄悄降至 5 秒会导致长耗制作业失败;更小的连接池会使流量串行化)。添加到非功能对账检查清单中:
|
|
411
|
+
|
|
412
|
+
- [ ] 请求 / 操作**超时**与遗留系统相匹配(或变更已声明)
|
|
413
|
+
- [ ] **限流**(请求数/分钟、突发量)与遗留系统相匹配
|
|
414
|
+
- [ ] **连接池**最小/最大值及空闲/连接超时与遗留系统相匹配
|
|
415
|
+
- [ ] **批处理大小**与遗留系统相匹配
|
|
416
|
+
- [ ] **事务隔离级别**与遗留系统相匹配(与步骤 3 交叉检查)
|
|
417
|
+
|
|
418
|
+
每一项要么完全匹配,要么具有**已声明且合理解释的**差异(delta)。未声明的差异属于已知的回退风险,将阻断割接。
|
|
419
|
+
|
|
420
|
+
### 完整性声明(矩阵对齐)
|
|
421
|
+
|
|
422
|
+
当本节声明了全部三项要素时,迁移完整性矩阵的轴 ⑥ 即告满足:**推导(derive)**(步骤 1 机械化 baseline)、**判定依据(oracle)**(步骤 2 回退差分 + 步骤 3 不变量断言)以及**关卡时机(gate timing)**(UAT 之前 + 割接之后)。复用通用的 baseline/漂移机制以及 `observability-assistant` 测量机制——本节仅增加迁移的前后对比与并发隔离语义,并不重复构建通用的性能框架。
|
|
423
|
+
|
|
424
|
+
---
|
|
425
|
+
|
|
426
|
+
## 每次发布容量签核
|
|
427
|
+
|
|
428
|
+
本节定义了在生产发布前必须满足的**容量门禁**(`release-readiness-gate.md` 中的维度 10,Tier-3)。
|
|
429
|
+
|
|
430
|
+
### 容量预测
|
|
431
|
+
|
|
432
|
+
在每个发布候选版本之前,基于以下各项制定容量预测:
|
|
433
|
+
|
|
434
|
+
1. **基线(Baseline)**:峰值 TPS 和资源利用率(CPU、内存、数据库连接、存储增长率)的 90 天滑动平均值
|
|
435
|
+
2. **发布影响预估**:新功能带来的预期流量增量(例如,新通知流程带来 +15% TPS)
|
|
436
|
+
3. **季节性调整**:未来 30 天内任何已知的流量峰值(营销活动、季节性高峰)
|
|
437
|
+
|
|
438
|
+
### 余量阈值
|
|
439
|
+
|
|
440
|
+
| 指标 | 目标(PASS) | 警告区间 | 失败阈值 |
|
|
441
|
+
|------|--------------|----------|----------|
|
|
442
|
+
| 预计峰值下的 CPU 余量 | ≥ 30% | 20–30% | < 20% |
|
|
443
|
+
| 内存余量 | ≥ 25% | 15–25% | < 15% |
|
|
444
|
+
| 数据库连接池余量 | ≥ 40% | 25–40% | < 25% |
|
|
445
|
+
| 相比基线的 p99 延迟 | ≤ +5% | +5% 至 +10% | > +10% 回退 |
|
|
446
|
+
| 峰值负载下的错误率 | < 0.1% | 0.1–0.5% | > 0.5% |
|
|
447
|
+
|
|
448
|
+
### 负载测试要求
|
|
449
|
+
|
|
450
|
+
在最终完成容量签核之前,运行上述性能测试部分中定义的负载测试场景(至少包含浸泡测试 + 峰值测试):
|
|
451
|
+
|
|
452
|
+
```bash
|
|
453
|
+
# Example: k6 capacity verification run
|
|
454
|
+
k6 run --vus 500 --duration 20m scripts/perf/soak-test.js
|
|
455
|
+
# Pass criterion: headroom metrics above, p99 within budget
|
|
456
|
+
```
|
|
457
|
+
|
|
458
|
+
### 签核凭证
|
|
459
|
+
|
|
460
|
+
容量门禁需要**两名具名签核人**——工程主管(Engineering Lead)和 SRE 主管(SRE Lead):
|
|
461
|
+
|
|
462
|
+
```markdown
|
|
463
|
+
## Capacity Sign-off — <version>
|
|
464
|
+
|
|
465
|
+
**Projection date**: YYYY-MM-DD
|
|
466
|
+
**Baseline period**: last 90 days
|
|
467
|
+
|
|
468
|
+
| Metric | Baseline peak | Projected peak | Headroom | Status |
|
|
469
|
+
|--------|-------------|---------------|----------|--------|
|
|
470
|
+
| CPU | [X]% | [Y]% | [Z]% | PASS/WARN/FAIL |
|
|
471
|
+
| Memory | [X]% | [Y]% | [Z]% | PASS/WARN/FAIL |
|
|
472
|
+
| DB pool | [X]% | [Y]% | [Z]% | PASS/WARN/FAIL |
|
|
473
|
+
| p99 latency | [X]ms | [Y]ms | [±Z]% | PASS/WARN/FAIL |
|
|
474
|
+
|
|
475
|
+
**Load test artifact**: [link to load test report]
|
|
476
|
+
|
|
477
|
+
**Eng Lead sign-off**: _______________ Date: __________
|
|
478
|
+
**SRE Lead sign-off**: _______________ Date: __________
|
|
479
|
+
```
|
|
480
|
+
|
|
481
|
+
### 当 Tier-3 适用为 N/A 时
|
|
482
|
+
|
|
483
|
+
在以下情况下,容量签核为 `N/A`(需记录书面理由):
|
|
484
|
+
- 项目 DAU < 100 且未预期会有显著流量增长
|
|
485
|
+
- 用户数固定的内部工具
|
|
486
|
+
- 静态内容 / 文档网站
|
|
487
|
+
|
|
141
488
|
---
|
|
142
489
|
|
|
143
490
|
## 相关标准
|
|
144
491
|
|
|
145
|
-
- [
|
|
146
|
-
- [安全标准](security-standards.md)
|
|
147
|
-
- [测试标准](testing-standards.md)
|
|
492
|
+
- [测试标准](testing-standards.md) - 性能测试集成
|
|
148
493
|
- [需求工程](requirement-engineering.md) - NFR 文档
|
|
149
494
|
- [日志标准](logging-standards.md) - 性能日志
|
|
495
|
+
- [代码审查清单](code-review-checklist.md) - 性能审查
|
|
496
|
+
- [部署标准](deployment-standards.md) - 部署前性能验证
|
|
497
|
+
- [发布就绪门禁](release-readiness-gate.md) - 维度 1(负载)与维度 10(容量)
|
|
498
|
+
- [行为快照](behavior-snapshot.md) - 功能对等预言机(补充迁移非功能对等性)
|
|
499
|
+
- [全覆盖测试](full-coverage-testing.md) - 并发维度交叉引用
|
|
500
|
+
|
|
501
|
+
---
|
|
502
|
+
|
|
503
|
+
## 版本历史
|
|
504
|
+
|
|
505
|
+
| 版本 | 日期 | 变更 |
|
|
506
|
+
|------|------|------|
|
|
507
|
+
| 1.2.0 | 2026-06-17 | 新增迁移非功能对等性(XSPEC-286,维度 ⑥):前/后差异回归门禁、并发隔离验证、资源/配额对等性、机械化基线捕获 |
|
|
508
|
+
| 1.1.0 | 2026-01-29 | 重构:拆分为规则 + 指南,将解释说明移至指南 |
|
|
509
|
+
| 1.0.0 | 2026-01-29 | 初始发布 |
|
|
150
510
|
|
|
151
511
|
---
|
|
152
512
|
|