universal-dev-standards 6.14.0-beta.8 → 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 +2312 -1102
- 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 +2291 -1110
- 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 +77 -7
- 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-split.js +2 -1
- package/src/commands/spec.js +11 -2
- package/src/commands/update.js +184 -30
- 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 +160 -2
- package/src/installers/hooks-installer.js +1 -1
- package/src/installers/manifest-installer.js +1 -1
- package/src/installers/skills-installer.js +1 -1
- package/src/installers/standards-installer.js +3 -1
- package/src/mcp/server.js +9 -3
- package/src/prompts/init.js +26 -22
- package/src/reconciler/actual-state-scanner.js +2 -8
- package/src/reconciler/backup-locations.js +5 -0
- package/src/reconciler/backup-manager.js +19 -11
- package/src/reconciler/desired-state-calculator.js +89 -57
- package/src/reconciler/plan-executor.js +101 -8
- package/src/reconciler/recorded-versions.js +49 -0
- package/src/reconciler/relative-path.js +23 -0
- package/src/uninstallers/hook-uninstaller.js +9 -1
- package/src/uninstallers/skills-uninstaller.js +22 -3
- package/src/utils/available-standards-report.js +25 -4
- package/src/utils/available-standards.js +13 -3
- package/src/utils/build-manifest.js +1 -1
- package/src/utils/commit-message-judge.js +60 -13
- package/src/utils/friction-detector.js +23 -11
- package/src/utils/git-hooks.js +106 -4
- package/src/utils/integration-generator.js +95 -67
- package/src/utils/legacy-hook-migration.js +121 -2
- package/src/utils/open-work-tracking.mjs +105 -16
- package/src/utils/sdd-header.js +16 -4
- package/src/utils/skills-installer.js +2 -1
- package/src/utils/spinner.js +14 -4
- package/src/utils/standard-validator.js +3 -2
- package/standards-registry.json +10 -8
- package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
source: ../../../core/performance-standards.md
|
|
3
3
|
source_version: 1.2.0
|
|
4
4
|
translation_version: 1.2.0
|
|
5
|
-
last_synced: 2026-
|
|
5
|
+
last_synced: 2026-10-16
|
|
6
|
+
source_hash: b678e96a3ff1
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
@@ -17,7 +18,7 @@ status: current
|
|
|
17
18
|
**業界標準**: ISO/IEC 25010 效能效率
|
|
18
19
|
**參考**: [sre.google](https://sre.google/books/)
|
|
19
20
|
|
|
20
|
-
> **詳細說明與最佳化技術,請參閱 [效能指南](
|
|
21
|
+
> **詳細說明與最佳化技術,請參閱 [效能指南](guides/performance-guide.md)**
|
|
21
22
|
|
|
22
23
|
---
|
|
23
24
|
|
|
@@ -25,7 +26,7 @@ status: current
|
|
|
25
26
|
|
|
26
27
|
本標準定義軟體效能工程的完整指南,涵蓋效能需求、測試方法論和監控實踐。
|
|
27
28
|
|
|
28
|
-
|
|
29
|
+
**參考標準**:
|
|
29
30
|
- [ISO/IEC 25010:2011](https://www.iso.org/standard/35733.html) - 效能效率
|
|
30
31
|
- [Google SRE Book](https://sre.google/books/) - 網站可靠性工程
|
|
31
32
|
|
|
@@ -36,179 +37,479 @@ 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 |
|
|
51
|
+
|
|
52
|
+
**Conditions**: [Load, data volume, etc.]
|
|
53
|
+
**Measurement**: [Tool, sampling, reporting]
|
|
50
54
|
```
|
|
51
55
|
|
|
52
|
-
|
|
56
|
+
---
|
|
53
57
|
|
|
54
|
-
|
|
55
|
-
|------|------|----------|
|
|
56
|
-
| 頁面載入時間 | < 3 秒 | Lighthouse |
|
|
57
|
-
| API 回應時間 (p95) | < 500ms | APM 工具 |
|
|
58
|
-
| 記憶體使用 | < 512MB | 執行時監控 |
|
|
59
|
-
| CPU 使用率 | < 70% 平均 | 系統監控 |
|
|
60
|
-
| 套件大小 | < 200KB (gzip) | 建置分析 |
|
|
58
|
+
## 常見效能目標
|
|
61
59
|
|
|
62
|
-
|
|
60
|
+
| 系統類型 | 回應時間 (p95) | 吞吐量 | 可用性 |
|
|
61
|
+
|----------|----------------|--------|--------|
|
|
62
|
+
| **電子商務** | < 200ms | 1000+ rps | 99.9% |
|
|
63
|
+
| **內部工具** | < 500ms | 100+ rps | 99.5% |
|
|
64
|
+
| **批次處理** | N/A | 10K+ 筆記錄/分鐘 | 99% |
|
|
65
|
+
| **即時系統** | < 50ms (p99) | 10K+ rps | 99.99% |
|
|
66
|
+
| **API 閘道** | < 100ms | 5K+ rps | 99.95% |
|
|
63
67
|
|
|
64
|
-
|
|
68
|
+
---
|
|
69
|
+
|
|
70
|
+
## Core Web Vitals 目標
|
|
71
|
+
|
|
72
|
+
| 指標 | 目標 | 說明 |
|
|
65
73
|
|------|------|------|
|
|
66
|
-
|
|
|
67
|
-
|
|
|
68
|
-
|
|
|
69
|
-
|
|
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% 較快 | 高流量系統 |
|
|
70
116
|
|
|
71
|
-
|
|
117
|
+
### 四個黃金訊號 (SRE)
|
|
118
|
+
|
|
119
|
+
| 訊號 | 測量項目 | 目標 |
|
|
120
|
+
|------|----------|------|
|
|
121
|
+
| **延遲 (Latency)** | 回應時間 (p50, p95, p99) | < SLA |
|
|
122
|
+
| **流量 (Traffic)** | 每秒請求數 | 取決於容量 |
|
|
123
|
+
| **錯誤 (Errors)** | 錯誤率 % | < 0.1% |
|
|
124
|
+
| **飽和度 (Saturation)** | 資源利用率 | 持續 < 70% |
|
|
125
|
+
|
|
126
|
+
---
|
|
72
127
|
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
|
76
|
-
|
|
77
|
-
|
|
|
78
|
-
|
|
|
128
|
+
## 告警閾值
|
|
129
|
+
|
|
130
|
+
| 指標 | 警告 | 嚴重 | 處置動作 |
|
|
131
|
+
|------|------|------|----------|
|
|
132
|
+
| **p95 回應時間** | > 200ms | > 500ms | 調查、擴展 |
|
|
133
|
+
| **錯誤率** | > 0.1% | > 1% | Call 值班人員 (Page 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 | 維持熱連線 (warm connections) |
|
|
157
|
+
| **最大連線數** | 20-100 | 取決於資料庫與應用程式伺服器 |
|
|
158
|
+
| **閒置逾時** | 10-30 分鐘 | 釋放未使用的連線 |
|
|
159
|
+
| **連線逾時** | 5-10 秒 | 發生問題時快速失敗 (Fail fast) |
|
|
160
|
+
|
|
161
|
+
---
|
|
162
|
+
|
|
163
|
+
## 速率限制 (Rate Limiting) 配置
|
|
164
|
+
|
|
165
|
+
| 端點類型 | 限制 | 突發 (Burst) |
|
|
166
|
+
|----------|------|--------------|
|
|
167
|
+
| **公開 API** | 100/分鐘 | 10 |
|
|
168
|
+
| **已驗證** | 1000/分鐘 | 50 |
|
|
169
|
+
| **進階層級 (Premium tier)** | 10000/分鐘 | 200 |
|
|
170
|
+
| **內部** | 無限制 | N/A |
|
|
171
|
+
|
|
172
|
+
---
|
|
173
|
+
|
|
174
|
+
## 效能測試頻率
|
|
175
|
+
|
|
176
|
+
| 測試類型 | 開發階段 | 預備環境 (Staging) | 正式環境 (Production) |
|
|
177
|
+
|----------|----------|-------------------|----------------------|
|
|
178
|
+
| **單元效能** | 每次提交 | - | - |
|
|
179
|
+
| **負載測試** | 每週 | 每次發布 | 每月 |
|
|
180
|
+
| **壓力測試** | 每月 | 每次發布 | 每季 |
|
|
181
|
+
| **浸泡測試** | 每月 | 重大發布 | 每季 |
|
|
182
|
+
| **尖峰測試** | - | 重大發布 | 大型活動前 |
|
|
183
|
+
|
|
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
|
+
- [ ] 已安排定期的效能審查
|
|
216
|
+
|
|
217
|
+
---
|
|
79
218
|
|
|
80
219
|
## 效能測試執行
|
|
81
220
|
|
|
82
221
|
### 測試類型定義
|
|
83
222
|
|
|
84
223
|
| 測試類型 | 目的 | 適用場景 |
|
|
85
|
-
|
|
224
|
+
|-----------|---------|---------------------|
|
|
86
225
|
| **Load Test** | 驗證系統在預期負載下的行為 | 發布前驗證、容量規劃 |
|
|
87
|
-
| **Stress Test** |
|
|
88
|
-
| **Soak Test** |
|
|
89
|
-
| **Spike Test** |
|
|
226
|
+
| **Stress Test** | 找出系統極限與崩潰點行為 | 架構變更、擴展驗證 |
|
|
227
|
+
| **Soak Test** | 偵測長時間執行下的記憶體洩漏或資源耗盡 | 重大發布、資源密集服務 |
|
|
228
|
+
| **Spike Test** | 驗證突發流量下的系統回應與復原 | 行銷活動前、促銷事件 |
|
|
90
229
|
|
|
91
230
|
### Baseline 管理
|
|
92
231
|
|
|
93
|
-
|
|
232
|
+
#### 首次建立 Baseline
|
|
233
|
+
|
|
94
234
|
1. 在穩定版本上執行至少 3 次完整 Load Test
|
|
95
235
|
2. 取 p50、p95、p99 的中位數作為 baseline
|
|
96
236
|
3. 記錄測試環境配置(硬體、資料量、並發數)
|
|
97
|
-
4. 將 baseline
|
|
237
|
+
4. 將 baseline 與測試指令稿一同存入版本控制
|
|
98
238
|
|
|
99
|
-
|
|
239
|
+
#### 漂移偵測閾值
|
|
100
240
|
|
|
101
241
|
| 指標 | 可接受漂移 | 需調查 | 阻擋 |
|
|
102
|
-
|
|
242
|
+
|--------|-----------------|-------------|----------|
|
|
103
243
|
| p50 Latency | < 5% | 5-15% | > 15% |
|
|
104
244
|
| p95 Latency | < 10% | 10-20% | > 20% |
|
|
105
245
|
| p99 Latency | < 10% | 10-25% | > 25% |
|
|
106
246
|
| Throughput | < 5% 下降 | 5-15% 下降 | > 15% 下降 |
|
|
107
247
|
| Error Rate | 無增加 | < 0.1% 增加 | > 0.1% 增加 |
|
|
108
248
|
|
|
249
|
+
#### Baseline 更新策略
|
|
250
|
+
|
|
251
|
+
- 架構重構後:必須(MUST)重新建立 baseline
|
|
252
|
+
- 硬體升級後:應該(SHOULD)更新 baseline
|
|
253
|
+
- 效能最佳化成功後:應該(SHOULD)將新數值設為 baseline
|
|
254
|
+
- 所有 baseline 更新都必須(MUST)記錄變更原因與日期
|
|
255
|
+
|
|
109
256
|
### CI 觸發條件
|
|
110
257
|
|
|
258
|
+
並非每次 commit 都需要執行效能測試。請使用以下觸發條件矩陣:
|
|
259
|
+
|
|
111
260
|
| 觸發條件 | Load Test | Stress Test | Soak Test | Spike Test |
|
|
112
|
-
|
|
261
|
+
|-------------------|-----------|-------------|-----------|------------|
|
|
113
262
|
| 每次 commit | 否 | 否 | 否 | 否 |
|
|
114
263
|
| PR 合併至 main | 是(精簡) | 否 | 否 | 否 |
|
|
115
264
|
| Release tag | 是(完整) | 是 | 否 | 否 |
|
|
116
265
|
| 排程(每週) | 是 | 否 | 是 | 否 |
|
|
266
|
+
| 手動觸發 | 是 | 是 | 是 | 是 |
|
|
267
|
+
| 效能相關檔案變更 | 是(精簡) | 否 | 否 | 否 |
|
|
117
268
|
|
|
118
269
|
### Performance Budget
|
|
119
270
|
|
|
271
|
+
類似於 SRE Error Budget 的概念,Performance Budget 定義了可容忍的劣化餘裕。
|
|
272
|
+
|
|
120
273
|
| 概念 | 定義 | 範例 |
|
|
121
|
-
|
|
274
|
+
|---------|------------|---------|
|
|
122
275
|
| **效能目標** | 目標效能水準 | p99 < 200ms |
|
|
123
276
|
| **效能預算** | 允許的劣化餘裕 | p99 可劣化至 220ms(10%) |
|
|
124
277
|
| **預算消耗** | 累積劣化百分比 | 本季已消耗 6% |
|
|
125
278
|
| **預算耗盡** | 觸發凍結非必要變更 | 剩餘 < 2% 時凍結 |
|
|
126
279
|
|
|
280
|
+
#### 劣化容差
|
|
281
|
+
|
|
282
|
+
- p99 延遲不得(SHALL NOT)劣化超過 10%
|
|
283
|
+
- 吞吐量不得(SHALL NOT)下降超過 5%
|
|
284
|
+
- 錯誤率不得(SHALL NOT)增加超過 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
|
+
- 所有阻擋級別(blocking-level)閾值皆在限制內 → **PASS**
|
|
324
|
+
- 超過任何阻擋級別閾值 → **FAIL**
|
|
325
|
+
- 超過調查級別(investigation-level)閾值 → 記錄為警告,不阻擋
|
|
326
|
+
|
|
327
|
+
#### 趨勢圖需求
|
|
328
|
+
|
|
329
|
+
- 納入至少最近 10 次執行紀錄以進行趨勢比較
|
|
330
|
+
- 在圖表上顯示 baseline 標記
|
|
331
|
+
- 突顯超出閾值的異常資料點
|
|
332
|
+
|
|
127
333
|
---
|
|
128
334
|
|
|
129
335
|
## 遷移非功能性對等(XSPEC-286)
|
|
130
336
|
|
|
131
|
-
> 屬於 [XSPEC-284](https://github.com/AsiaOstrich/universal-dev-standards) 9
|
|
337
|
+
> 屬於 [XSPEC-284](https://github.com/AsiaOstrich/universal-dev-standards) 9 軸遷移完整性矩陣的**軸 ⑥ — 非功能**。涵蓋舊系統重構/重寫時「功能正確、資料正確,但**跑起來不一樣**」這一類遺漏。本節在上述通用基線/漂移機制之上新增**遷移專屬**的 before/after 語意;本節**不取代**通用效能框架。
|
|
338
|
+
|
|
339
|
+
### 為何這是真正的缺口
|
|
132
340
|
|
|
133
|
-
|
|
341
|
+
上述通用 Baseline 管理回答的是「*這個版本*相較*它自己*先前的 baseline 是否回歸」。它**無法**回答「**新**系統是否與它所取代的 **legacy** 系統對等」。在重寫時(例如 PHP 單請求 → .NET 共享狀態執行緒),legacy 的延遲/吞吐/隔離特性往往是**隱性且未經記錄的**,導致每請求功能對等(per-request functional parity)與行為快照對等(behavior-snapshot parity)皆通過,但系統卻悄悄跑得更慢、耗盡更小的連線池,或是遺失了某個鎖語意。
|
|
134
342
|
|
|
135
|
-
|
|
343
|
+
### 差分 oracle,而非絕對門檻
|
|
136
344
|
|
|
137
|
-
|
|
345
|
+
遷移對等使用 **legacy 作為 baseline** 並採用**宣告的容差**,而非上表中的絕對目標。legacy 系統量測到的行為即為 oracle;「回歸未超過宣告的容差」即為通過準則。這能讓分歧自我回報,而非依賴某人記得列舉每條熱路徑。
|
|
138
346
|
|
|
139
|
-
|
|
347
|
+
### 步驟 1 — 機械化擷取非功能 baseline(R3)
|
|
140
348
|
|
|
141
|
-
|
|
349
|
+
legacy 的非功能特性大多為隱性的。應從 legacy 產物**機械化地**(而非靠記憶)推導 baseline:
|
|
142
350
|
|
|
143
|
-
|
|
351
|
+
| 來源 | 推導出的 baseline 項目 |
|
|
352
|
+
|--------|----------------------|
|
|
353
|
+
| 關鍵路由/控制器 | 各關鍵路徑的 p50 / p95 / p99 延遲 |
|
|
354
|
+
| 熱點查詢/慢查詢日誌 | 每查詢延遲、掃描列數 |
|
|
355
|
+
| 背景作業/cron | 作業時長、吞吐量(筆數/分鐘) |
|
|
356
|
+
| 連線池設定 | 最小/最大連線數、閒置/連線逾時 |
|
|
357
|
+
| 逾時/速率限制(rate-limit)設定 | 每端點逾時、請求數/分鐘、突發量 |
|
|
358
|
+
| 交易設定 | 隔離等級(READ COMMITTED / REPEATABLE READ / SERIALIZABLE) |
|
|
144
359
|
|
|
145
|
-
|
|
146
|
-
|------|---------------|
|
|
147
|
-
| 關鍵路由 / controller | 各關鍵路徑 p50 / p95 / p99 延遲 |
|
|
148
|
-
| 熱點查詢 / 慢查詢 log | 每查詢延遲、掃描列數 |
|
|
149
|
-
| 背景作業 / cron | 作業時長、吞吐(records/min) |
|
|
150
|
-
| 連線池設定 | min/max 連線數、idle/connection timeout |
|
|
151
|
-
| 逾時 / rate-limit 設定 | 每端點逾時、requests/min、burst |
|
|
152
|
-
| 交易設定 | 隔離級別(READ COMMITTED / REPEATABLE READ / SERIALIZABLE) |
|
|
360
|
+
所擷取的集合**同時**是回歸關卡(regression gate)的比對 baseline,**也是**資源/限制對等(步驟 4)的待驗證檢查清單。
|
|
153
361
|
|
|
154
|
-
|
|
362
|
+
### 步驟 2 — 效能回歸差分關卡(R1)
|
|
155
363
|
|
|
156
|
-
|
|
364
|
+
針對每條 baseline 路徑,量測新系統中對應的路徑,並在宣告的容差範圍內與 **legacy baseline** 進行比較。
|
|
157
365
|
|
|
158
|
-
|
|
366
|
+
| 指標 | 預設遷移容差 | 阻擋條件 |
|
|
367
|
+
|--------|----------------------------|-----------|
|
|
368
|
+
| p50 延遲 | ≤ +10% 相較於 legacy | > +10% |
|
|
369
|
+
| p95 延遲 | ≤ +15% 相較於 legacy | > +15% |
|
|
370
|
+
| p99 延遲 | ≤ +20% 相較於 legacy | > +20% |
|
|
371
|
+
| 吞吐量 | ≤ -10% 相較於 legacy | > -10% 下降 |
|
|
159
372
|
|
|
160
|
-
|
|
161
|
-
|------|-------------|-----------|
|
|
162
|
-
| p50 延遲 | ≤ +10%(vs legacy) | > +10% |
|
|
163
|
-
| p95 延遲 | ≤ +15%(vs legacy) | > +15% |
|
|
164
|
-
| p99 延遲 | ≤ +20%(vs legacy) | > +20% |
|
|
165
|
-
| 吞吐 | ≤ -10%(vs legacy) | > -10% 下降 |
|
|
373
|
+
容差為**可按路徑設定**(批次作業與互動式端點有所不同)。以 **shadow** 模式起步(僅量測,不阻擋)以收集樣本並校準各路徑容差,隨後再晉級為 blocking。
|
|
166
374
|
|
|
167
|
-
|
|
375
|
+
**關卡時機**:pre-UAT(在簽核前抓出回歸)**以及** post-cutover(抓出僅在真實生產負載下才會顯現的回歸)。
|
|
376
|
+
|
|
377
|
+
```markdown
|
|
378
|
+
## Migration Performance Parity Report — <path>
|
|
168
379
|
|
|
169
|
-
|
|
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
|
+
```
|
|
170
390
|
|
|
171
391
|
### 步驟 3 — 並發隔離驗證(R2)
|
|
172
392
|
|
|
173
|
-
|
|
393
|
+
同一資源(同一筆記錄/同一個帳戶餘額/同一個序號)可能會被多個並發操作存取。legacy 的鎖定/交易隔離/順序保證皆為**隱性行為**,且經常在重寫中被改變——而**功能測試與行為快照對等兩者皆無法捕捉到這點**(每請求對等 ≠ 並發對等,此為與「每請求 ≠ 靜態資料」相同類型的盲點)。
|
|
174
394
|
|
|
175
|
-
|
|
395
|
+
**方法**:透過並發壓力觸發競態,接著斷言**領域不變量**,而非逐一檢查輸出。
|
|
176
396
|
|
|
177
397
|
| 不變量類別 | 範例斷言 |
|
|
178
|
-
|
|
179
|
-
| 守恆 | N 次並發轉帳後 `SUM(balance)`
|
|
180
|
-
| 唯一性 |
|
|
181
|
-
| 無遺失更新 |
|
|
182
|
-
| 順序 |
|
|
398
|
+
|-----------------|-------------------|
|
|
399
|
+
| 守恆 | 在 N 次並發轉帳後 `SUM(balance)` 保持不變 |
|
|
400
|
+
| 唯一性 | 在並發配置下不會產生重複序號 |
|
|
401
|
+
| 無遺失更新 | 最後寫入者勝出(last-writer-wins)不會靜默覆寫已提交的寫入 |
|
|
402
|
+
| 順序 | 在並發情況下事件依照保證的順序套用 |
|
|
183
403
|
|
|
184
|
-
|
|
404
|
+
偵測到**隔離等級調降**(例如 legacy SERIALIZABLE → 新系統 READ COMMITTED,或移除了資料列鎖)將予以阻擋。不變量本身由領域定義;當並發案例與狀態轉移或時間不變量重疊時,**狀態機/時間考量由 XSPEC-287**(軸 ⑧)負責,而並發競態則由本節(軸 ⑥)負責——請參閱 XSPEC-287 §邊界。
|
|
185
405
|
|
|
186
|
-
|
|
406
|
+
**關卡時機**:pre-UAT。
|
|
187
407
|
|
|
188
|
-
### 步驟 4 —
|
|
408
|
+
### 步驟 4 — 資源/限制對等(R4)
|
|
189
409
|
|
|
190
|
-
驗證 legacy
|
|
410
|
+
驗證 legacy 資源限制未被重寫**無意間**變更(逾時時間悄悄從 30 秒降至 5 秒會導致長時間作業失敗;較小的連線池會將流量序列化)。將以下項目加入非功能核對清單:
|
|
191
411
|
|
|
192
|
-
- [ ]
|
|
193
|
-
- [ ]
|
|
194
|
-
- [ ]
|
|
412
|
+
- [ ] 請求/操作**逾時**與 legacy 一致(或變更已明確宣告)
|
|
413
|
+
- [ ] **速率限制**(請求數/分鐘、突發量)與 legacy 一致
|
|
414
|
+
- [ ] **連線池**最小/最大連線數及閒置/連線逾時與 legacy 一致
|
|
195
415
|
- [ ] **批次大小**與 legacy 一致
|
|
196
|
-
- [ ]
|
|
416
|
+
- [ ] **交易隔離等級**與 legacy 一致(與步驟 3 交叉比對)
|
|
197
417
|
|
|
198
|
-
|
|
418
|
+
每個項目若非完全一致,就必須有**已宣告且具正當理由的**差異。未宣告的差異屬於已知回歸風險,將阻擋切換(cutover)。
|
|
199
419
|
|
|
200
420
|
### 完整性宣告(矩陣對齊)
|
|
201
421
|
|
|
202
|
-
|
|
422
|
+
當本節同時宣告以下三項時,即滿足遷移完整性矩陣的軸 ⑥:**推導**(步驟 1 機械化 baseline)、**oracle**(步驟 2 回歸差分 + 步驟 3 不變量斷言)以及**關卡時機**(pre-UAT + post-cutover)。複用通用 baseline/漂移機制與 `observability-assistant` 量測機制——本節僅新增遷移 before/after 與並發隔離語意,並不重新建構通用的效能框架。
|
|
423
|
+
|
|
424
|
+
---
|
|
425
|
+
|
|
426
|
+
## 每次發布容量簽核
|
|
427
|
+
|
|
428
|
+
本節定義在正式發布前必須滿足的**容量關卡**(`release-readiness-gate.md` 中的維度 10,Tier-3)。
|
|
429
|
+
|
|
430
|
+
### 容量預測
|
|
431
|
+
|
|
432
|
+
在每個發布候選版本(release candidate)之前,根據以下項目產出容量預測:
|
|
433
|
+
|
|
434
|
+
1. **基線(Baseline)**:尖峰 TPS 與資源利用率(CPU、記憶體、DB 連線數、儲存空間成長率)的 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
|
+
| DB 連線池餘裕 | ≥ 40% | 25–40% | < 25% |
|
|
445
|
+
| p99 延遲 vs 基線 | ≤ +5% | +5% 至 +10% | > +10% 回歸 |
|
|
446
|
+
| 尖峰負載下的錯誤率 | < 0.1% | 0.1–0.5% | > 0.5% |
|
|
447
|
+
|
|
448
|
+
### 負載測試要求
|
|
449
|
+
|
|
450
|
+
在完成容量簽核前,執行上方「效能測試」章節所定義的負載測試場景(至少包含 Soak + Spike 測試):
|
|
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
|
+
- 靜態內容/文件網站
|
|
203
487
|
|
|
204
488
|
---
|
|
205
489
|
|
|
206
490
|
## 相關標準
|
|
207
491
|
|
|
208
|
-
- [
|
|
209
|
-
- [安全標準](security-standards.md)
|
|
210
|
-
- [測試標準](testing-standards.md)
|
|
492
|
+
- [測試標準](testing-standards.md) - 效能測試整合
|
|
211
493
|
- [需求工程](requirement-engineering.md) - NFR 文件
|
|
212
494
|
- [日誌標準](logging-standards.md) - 效能日誌
|
|
495
|
+
- [程式碼審查清單](code-review-checklist.md) - 效能審查
|
|
496
|
+
- [部署標準](deployment-standards.md) - 部署前效能驗證
|
|
497
|
+
- [發布就緒關卡](release-readiness-gate.md) - 維度 1(負載)與維度 10(容量)
|
|
213
498
|
- [行為快照](behavior-snapshot.md) - 功能對等 oracle(與遷移非功能對等互補)
|
|
214
499
|
- [完整覆蓋測試](full-coverage-testing.md) - 並發維度交叉引用
|
|
500
|
+
|
|
501
|
+
---
|
|
502
|
+
|
|
503
|
+
## 版本歷史
|
|
504
|
+
|
|
505
|
+
| 版本 | 日期 | 變更 |
|
|
506
|
+
|---------|------|---------|
|
|
507
|
+
| 1.2.0 | 2026-06-17 | 新增遷移非功能性對等(XSPEC-286,軸⑥):before/after 差分回歸關卡、並發隔離驗證、資源/限制對等、機械化基線擷取 |
|
|
508
|
+
| 1.1.0 | 2026-01-29 | 重構:拆分為規則 + 指南,將說明移至指南 |
|
|
509
|
+
| 1.0.0 | 2026-01-29 | 初次發布 |
|
|
510
|
+
|
|
511
|
+
---
|
|
512
|
+
|
|
513
|
+
## 授權條款
|
|
514
|
+
|
|
515
|
+
本標準採用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 釋出。
|