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,11 +2,12 @@
|
|
|
2
2
|
source: ../../../../skills/commands/reverse-tdd.md
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
|
-
last_synced: 2026-
|
|
5
|
+
last_synced: 2026-10-12
|
|
6
|
+
source_hash: 63db65495ddc
|
|
6
7
|
---
|
|
7
8
|
|
|
8
9
|
---
|
|
9
|
-
description: [UDS]
|
|
10
|
+
description: [UDS] 分析 BDD-TDD 覆蓋差距
|
|
10
11
|
allowed-tools: Read, Grep, Glob, Write
|
|
11
12
|
argument-hint: "[feature file or test directory | Feature 檔案或測試目錄]"
|
|
12
13
|
---
|
|
@@ -52,6 +53,46 @@ argument-hint: "[feature file or test directory | Feature 檔案或測試目錄]
|
|
|
52
53
|
| `/reverse-tdd features/` | 分析所有 feature 檔案 |
|
|
53
54
|
| `/reverse-tdd features/auth.feature` | 分析特定 feature |
|
|
54
55
|
|
|
56
|
+
## AI 代理行為
|
|
57
|
+
|
|
58
|
+
> 遵循 [AI 命令行為標準](../../core/ai-command-behavior.md)
|
|
59
|
+
|
|
60
|
+
### 進入路由
|
|
61
|
+
|
|
62
|
+
| 輸入 | AI 動作 |
|
|
63
|
+
|------|---------|
|
|
64
|
+
| `/reverse-tdd` | 詢問要分析的 feature 檔案或測試目錄 |
|
|
65
|
+
| `/reverse-tdd <path>` | 直接分析指定路徑 |
|
|
66
|
+
|
|
67
|
+
### 互動腳本
|
|
68
|
+
|
|
69
|
+
1. 解析 `.feature` 檔案中的所有場景
|
|
70
|
+
2. 掃描測試目錄尋找對應的單元測試
|
|
71
|
+
3. 建立 BDD 場景 → TDD 測試的對應關係
|
|
72
|
+
4. 識別覆蓋差距(有場景無對應測試)
|
|
73
|
+
5. 產生差距報告
|
|
74
|
+
|
|
75
|
+
**決策:差距嚴重度**
|
|
76
|
+
- IF 覆蓋率 ≥ 80% → 標記為 ✅ Good,列出剩餘差距
|
|
77
|
+
- IF 覆蓋率 50-79% → 標記為 ⚠️ Needs Improvement,建議優先補測試的場景
|
|
78
|
+
- IF 覆蓋率 < 50% → 標記為 ❌ Critical,建議系統性補強
|
|
79
|
+
|
|
80
|
+
🛑 **STOP**: 展示差距報告後等待使用者決定下一步
|
|
81
|
+
|
|
82
|
+
### 停止點
|
|
83
|
+
|
|
84
|
+
| 停止點 | 等待內容 |
|
|
85
|
+
|--------|---------|
|
|
86
|
+
| 差距報告展示後 | 使用者決定是否要 AI 協助補測試 |
|
|
87
|
+
|
|
88
|
+
### 錯誤處理
|
|
89
|
+
|
|
90
|
+
| 錯誤條件 | AI 動作 |
|
|
91
|
+
|----------|---------|
|
|
92
|
+
| 無 `.feature` 檔案 | 引導到 `/derive-bdd` 或 `/reverse-bdd` 先產生 |
|
|
93
|
+
| 測試目錄為空 | 報告 0% 覆蓋率,建議從 `/derive-tdd` 產生骨架 |
|
|
94
|
+
| 場景與測試命名不一致無法自動對應 | 列出無法對應的項目,詢問使用者手動確認 |
|
|
95
|
+
|
|
55
96
|
## 參考
|
|
56
97
|
|
|
57
98
|
- 上層指令:[/reverse](../reverse-engineer/SKILL.md)
|
|
@@ -2,12 +2,13 @@
|
|
|
2
2
|
source: ../../../../skills/commands/reverse.md
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
|
-
last_synced: 2026-
|
|
5
|
+
last_synced: 2026-10-12
|
|
6
|
+
source_hash: 32adc0c367f3
|
|
6
7
|
---
|
|
7
8
|
|
|
8
9
|
---
|
|
9
10
|
name: reverse
|
|
10
|
-
description: [UDS]
|
|
11
|
+
description: [UDS] 將程式碼反向工程為規格、BDD 或 TDD 覆蓋分析。
|
|
11
12
|
argument-hint: "[spec|bdd|tdd] <input> [--output <file>]"
|
|
12
13
|
---
|
|
13
14
|
|
|
@@ -64,6 +65,47 @@ argument-hint: "[spec|bdd|tdd] <input> [--output <file>]"
|
|
|
64
65
|
* **確定性標記**:在輸出中使用 `[Confirmed]`、`[Inferred]`、`[Unknown]` 標記。
|
|
65
66
|
* **來源標註**:為所有反向推導的邏輯標註 `file:line`。
|
|
66
67
|
|
|
68
|
+
## AI Agent Behavior | AI 代理行為
|
|
69
|
+
|
|
70
|
+
> 遵循 [AI Command Behavior Standards](../../core/ai-command-behavior.md)
|
|
71
|
+
|
|
72
|
+
### Entry Router | 進入路由
|
|
73
|
+
|
|
74
|
+
| 輸入 | AI 動作 |
|
|
75
|
+
|------|---------|
|
|
76
|
+
| `/reverse` | 詢問使用者要執行哪個子命令(spec/bdd/tdd)和目標 |
|
|
77
|
+
| `/reverse <subcommand> <input>` | 直接對指定目標執行指定子命令 |
|
|
78
|
+
| `/reverse <subcommand>` | 執行子命令,詢問目標檔案/目錄 |
|
|
79
|
+
|
|
80
|
+
### Interaction Script | 互動腳本
|
|
81
|
+
|
|
82
|
+
1. 確認子命令和輸入目標
|
|
83
|
+
2. 分派到對應的 `/reverse-sdd`、`/reverse-bdd`、`/reverse-tdd`
|
|
84
|
+
3. 收集子命令結果
|
|
85
|
+
4. 展示結果摘要
|
|
86
|
+
|
|
87
|
+
**決策:子命令選擇**
|
|
88
|
+
- IF `spec` → 分派到 `/reverse-sdd`
|
|
89
|
+
- IF `bdd` → 分派到 `/reverse-bdd`
|
|
90
|
+
- IF `tdd` → 分派到 `/reverse-tdd`
|
|
91
|
+
- IF 未指定 → 問使用者選擇
|
|
92
|
+
|
|
93
|
+
🛑 **STOP**: 結果展示後等待使用者確認
|
|
94
|
+
|
|
95
|
+
### Stop Points | 停止點
|
|
96
|
+
|
|
97
|
+
| 停止點 | 等待內容 |
|
|
98
|
+
|--------|---------|
|
|
99
|
+
| 反向工程結果展示後 | 確認結果正確並寫入 |
|
|
100
|
+
|
|
101
|
+
### Error Handling | 錯誤處理
|
|
102
|
+
|
|
103
|
+
| 錯誤條件 | AI 動作 |
|
|
104
|
+
|----------|---------|
|
|
105
|
+
| 目標檔案/目錄不存在 | 告知並詢問正確路徑 |
|
|
106
|
+
| 子命令無效 | 列出可用子命令(spec/bdd/tdd) |
|
|
107
|
+
| 目標為空目錄或空檔案 | 告知無內容可分析 |
|
|
108
|
+
|
|
67
109
|
## 參考
|
|
68
110
|
|
|
69
111
|
* [反向工程技能](../reverse-engineer/SKILL.md)
|
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
source: ../../../../skills/commands/runbook.md
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
|
-
last_synced: 2026-
|
|
5
|
+
last_synced: 2026-10-12
|
|
6
|
+
source_hash: 204f37312d01
|
|
6
7
|
status: current
|
|
7
8
|
description: "[UDS] 引導 Runbook 建立、維護、演練和覆蓋率報告"
|
|
8
9
|
---
|
|
@@ -10,9 +11,53 @@ description: "[UDS] 引導 Runbook 建立、維護、演練和覆蓋率報告"
|
|
|
10
11
|
---
|
|
11
12
|
description: "[UDS] 引導 Runbook 建立、維護、演練和覆蓋率報告"
|
|
12
13
|
allowed-tools: Read, Write, Grep, Glob
|
|
13
|
-
argument-hint: "[create | drill | coverage] [告警名稱]"
|
|
14
|
+
argument-hint: "[create | drill | coverage] [alert name | 告警名稱]"
|
|
14
15
|
---
|
|
15
16
|
|
|
16
17
|
# Runbook 助手
|
|
17
18
|
|
|
18
19
|
詳見 [SKILL.md](../runbook-assistant/SKILL.md)。
|
|
20
|
+
|
|
21
|
+
## AI Agent Behavior | AI 代理行為
|
|
22
|
+
|
|
23
|
+
> 遵循 [AI Command Behavior Standards](../../core/ai-command-behavior.md)
|
|
24
|
+
|
|
25
|
+
### Entry Router | 進入路由
|
|
26
|
+
|
|
27
|
+
| 輸入 | AI 動作 |
|
|
28
|
+
|------|---------|
|
|
29
|
+
| `/runbook` | 詢問目標告警或服務,進入 runbook 導覽選單 |
|
|
30
|
+
| `/runbook create` | 啟動 runbook 建立流程 |
|
|
31
|
+
| `/runbook create <alert>` | 針對指定告警直接建立 runbook |
|
|
32
|
+
| `/runbook drill` | 啟動 runbook 演練模擬流程 |
|
|
33
|
+
| `/runbook coverage` | 產生 runbook 覆蓋率報告 |
|
|
34
|
+
|
|
35
|
+
### Interaction Script | 互動腳本
|
|
36
|
+
|
|
37
|
+
1. 確認操作模式(建立 / 演練 / 覆蓋率)
|
|
38
|
+
2. 依模式執行對應流程,收集必要資訊
|
|
39
|
+
3. 輸出 runbook 草稿或報告
|
|
40
|
+
|
|
41
|
+
**決策:建立模式**
|
|
42
|
+
- IF 告警名稱已提供 → 直接填入模板並產生草稿
|
|
43
|
+
- IF 告警名稱未提供 → 詢問告警名稱、嚴重程度、負責團隊
|
|
44
|
+
|
|
45
|
+
**決策:演練模式**
|
|
46
|
+
- 逐步模擬告警觸發情境,確認執行步驟可行性
|
|
47
|
+
- IF 步驟有疑義 → 停止並請使用者確認或修正
|
|
48
|
+
|
|
49
|
+
🛑 **STOP**: runbook 草稿產生後等待使用者審查與修正
|
|
50
|
+
|
|
51
|
+
### Stop Points | 停止點
|
|
52
|
+
|
|
53
|
+
| 停止點 | 等待內容 |
|
|
54
|
+
|--------|---------|
|
|
55
|
+
| 草稿產生後 | 使用者審查並確認內容正確 |
|
|
56
|
+
| 演練每個關鍵步驟後 | 使用者確認步驟可執行 |
|
|
57
|
+
|
|
58
|
+
### Error Handling | 錯誤處理
|
|
59
|
+
|
|
60
|
+
| 錯誤條件 | AI 動作 |
|
|
61
|
+
|----------|---------|
|
|
62
|
+
| 告警名稱不明確 | 請使用者提供告警名稱或描述觸發條件 |
|
|
63
|
+
| 無現有 runbook 可演練 | 提示先執行 `create` 建立 runbook |
|
|
@@ -2,12 +2,13 @@
|
|
|
2
2
|
source: ../../../../skills/commands/scan.md
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
|
-
last_synced: 2026-
|
|
5
|
+
last_synced: 2026-10-12
|
|
6
|
+
source_hash: 31b6b2d2d6c9
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
9
10
|
---
|
|
10
|
-
description: "[UDS]
|
|
11
|
+
description: "[UDS] 引導自動化安全掃描、相依套件審計和機密偵測"
|
|
11
12
|
allowed-tools: Read, Grep, Glob, Bash(npm:audit, npx:*)
|
|
12
13
|
argument-hint: "[scan type or target | 掃描類型或目標]"
|
|
13
14
|
---
|
|
@@ -2,11 +2,12 @@
|
|
|
2
2
|
source: ../../../../skills/commands/sdd-retro.md
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
|
-
last_synced: 2026-
|
|
5
|
+
last_synced: 2026-10-12
|
|
6
|
+
source_hash: 34792a9bf741
|
|
6
7
|
---
|
|
7
8
|
|
|
8
9
|
---
|
|
9
|
-
description: [UDS]
|
|
10
|
+
description: [UDS] 為未追蹤的 feat/fix commits 建立追溯規格
|
|
10
11
|
allowed-tools: Read, Write, Grep, Glob, Bash(git log:*), Bash(git show:*), Bash(git diff:*), Bash(mkdir:*)
|
|
11
12
|
argument-hint: "[--since=<date> | --last=<N> | 自動掃描]"
|
|
12
13
|
---
|
|
@@ -40,8 +41,56 @@ argument-hint: "[--since=<date> | --last=<N> | 自動掃描]"
|
|
|
40
41
|
/sdd-retro --last=10
|
|
41
42
|
```
|
|
42
43
|
|
|
44
|
+
## AI Agent Behavior | AI 代理行為
|
|
45
|
+
|
|
46
|
+
> 遵循 [AI Command Behavior Standards](../../core/ai-command-behavior.md)
|
|
47
|
+
|
|
48
|
+
### Entry Router | 進入路由
|
|
49
|
+
|
|
50
|
+
| 輸入 | AI 動作 |
|
|
51
|
+
|------|---------|
|
|
52
|
+
| `/sdd-retro` | 掃描所有 feat/fix commits(無 `Refs:` footer),顯示摘要 |
|
|
53
|
+
| `/sdd-retro --since=<date>` | 僅掃描指定日期後的 commits |
|
|
54
|
+
| `/sdd-retro --last=<N>` | 僅掃描最近 N 筆 commits |
|
|
55
|
+
|
|
56
|
+
### Interaction Script | 互動腳本
|
|
57
|
+
|
|
58
|
+
1. 執行 `git log` 掃描符合條件的 commits
|
|
59
|
+
2. 過濾已有 `Refs: SPEC-` 的 commits
|
|
60
|
+
3. 依 scope 分群相關 commits
|
|
61
|
+
|
|
62
|
+
**決策:掃描結果**
|
|
63
|
+
- IF 無未追蹤的 commits → 告知使用者「所有 feat/fix commits 都已追蹤」,結束
|
|
64
|
+
- IF 有未追蹤的 commits → 顯示分群清單,問使用者要為哪些群組建立 retro spec
|
|
65
|
+
- ELSE → 顯示清單供選擇
|
|
66
|
+
|
|
67
|
+
🛑 **STOP**: 掃描結果展示後等待使用者選擇要追蹤的群組
|
|
68
|
+
|
|
69
|
+
4. 為使用者選定的群組生成 retro spec(使用 SDD 格式,status: Archived)
|
|
70
|
+
5. 展示生成的 spec 內容
|
|
71
|
+
|
|
72
|
+
🛑 **STOP**: 展示 spec 內容後等待使用者確認寫入檔案
|
|
73
|
+
|
|
74
|
+
6. 寫入 `docs/specs/` 並建議更新原 commits 的 footer(如有需要)
|
|
75
|
+
|
|
76
|
+
### Stop Points | 停止點
|
|
77
|
+
|
|
78
|
+
| 停止點 | 等待內容 |
|
|
79
|
+
|--------|---------|
|
|
80
|
+
| 掃描結果展示後 | 使用者選擇要追蹤哪些群組 |
|
|
81
|
+
| Spec 內容生成後 | 確認寫入檔案 |
|
|
82
|
+
|
|
83
|
+
### Error Handling | 錯誤處理
|
|
84
|
+
|
|
85
|
+
| 錯誤條件 | AI 動作 |
|
|
86
|
+
|----------|---------|
|
|
87
|
+
| 不在 git 儲存庫中 | 告知使用者需要在 git 儲存庫中執行 |
|
|
88
|
+
| git log 無結果 | 告知無符合條件的 commits |
|
|
89
|
+
| `docs/specs/` 目錄不存在 | 自動建立目錄 |
|
|
90
|
+
| commit message 格式不符合 Conventional Commits | 標記為 `[Unknown]` scope,仍嘗試分析 |
|
|
91
|
+
|
|
43
92
|
## 參考
|
|
44
93
|
|
|
45
94
|
- SDD 工作流程:[sdd 指令](sdd.md)
|
|
46
95
|
- Commit 規範:[commit 指令](commit.md)
|
|
47
|
-
- 規格:[SPEC-011](
|
|
96
|
+
- 規格:[SPEC-011](../../../../docs/specs/cli/shared/SPEC-011-retroactive-spec-tracking.md)
|
|
@@ -2,11 +2,12 @@
|
|
|
2
2
|
source: ../../../../skills/commands/sdd.md
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
|
-
last_synced: 2026-
|
|
5
|
+
last_synced: 2026-10-12
|
|
6
|
+
source_hash: 3e985d7d90bd
|
|
6
7
|
---
|
|
7
8
|
|
|
8
9
|
---
|
|
9
|
-
description: [UDS]
|
|
10
|
+
description: [UDS] 建立或審查規格驅動開發的規格文件
|
|
10
11
|
allowed-tools: Read, Write, Grep, Glob, Bash(git:*), Bash(npm test:*)
|
|
11
12
|
argument-hint: "[create|review|approve|implement|verify] [spec name or file | 規格名稱或檔案]"
|
|
12
13
|
---
|
|
@@ -61,6 +62,186 @@ grep -E "^- \[(x|X)\]" docs/specs/SPEC-XXX.md
|
|
|
61
62
|
|
|
62
63
|
---
|
|
63
64
|
|
|
65
|
+
## AI 代理行為
|
|
66
|
+
|
|
67
|
+
> 遵循 [AI Command Behavior Standards](../../core/ai-command-behavior.md)
|
|
68
|
+
|
|
69
|
+
### 進入路由
|
|
70
|
+
|
|
71
|
+
| 輸入 | AI 動作 | AI 行為 |
|
|
72
|
+
|------|---------|---------|
|
|
73
|
+
| `/sdd` | 1. 檢查 `docs/specs/` 是否有進行中的 spec 2. **有進行中的 spec** → 顯示狀態摘要,問使用者要繼續哪個還是新建 3. **無進行中的 spec** → 問使用者想做什麼功能,進入 discuss | 檢查進行中的規格;顯示狀態或開始 discuss |
|
|
74
|
+
| `/sdd <feature-name>` | 進入 **discuss** 階段(以 feature-name 為主題) | 針對該功能進入 discuss 階段 |
|
|
75
|
+
| `/sdd <phase>` | 進入指定 phase,執行 Pre-Flight Check。無指定 spec 時,列出該 phase 可操作的 spec 清單 | 進入指定階段,列出符合條件的規格 |
|
|
76
|
+
| `/sdd <phase> <spec-file>` | 進入指定 phase,對指定 spec 執行 Pre-Flight Check 後開始 | 針對指定規格進入該階段 |
|
|
77
|
+
| `/sdd --evaluate` | 僅執行 Scope Evaluation(Phase 0),輸出範圍評估結果 | 僅執行範圍評估 |
|
|
78
|
+
| `/sdd --sync-check` | 僅執行同步檢查,輸出同步狀態 | 僅執行同步檢查 |
|
|
79
|
+
|
|
80
|
+
### 互動腳本
|
|
81
|
+
|
|
82
|
+
#### 階段 0.5:Discuss
|
|
83
|
+
|
|
84
|
+
1. 讀取相關程式碼和文件,建立對現狀的理解
|
|
85
|
+
2. 列出識別到的灰色地帶(ambiguities),以編號問題呈現
|
|
86
|
+
3. 逐一與使用者討論,收斂答案
|
|
87
|
+
4. 鎖定範圍(In Scope / Out of Scope / Deferred)
|
|
88
|
+
|
|
89
|
+
**決策:灰色地帶解決程度**
|
|
90
|
+
- IF 所有問題都有明確答案 → 輸出 scope summary,建議進入 create
|
|
91
|
+
- IF 仍有未解問題 → 列出剩餘問題,問使用者是否接受風險繼續
|
|
92
|
+
- IF 使用者說「先這樣」 → 記錄未解問題為 `[OPEN]`,允許進入 create
|
|
93
|
+
|
|
94
|
+
**產出格式:**
|
|
95
|
+
```markdown
|
|
96
|
+
### Discuss Summary
|
|
97
|
+
**Feature**: [name]
|
|
98
|
+
**In Scope**: [list]
|
|
99
|
+
**Out of Scope**: [list]
|
|
100
|
+
**Deferred**: [list]
|
|
101
|
+
**Open Questions**: [list or "None"]
|
|
102
|
+
**read_first**: [file list]
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
🛑 **STOP**: 顯示 Discuss Summary 後等待使用者確認進入 create
|
|
106
|
+
|
|
107
|
+
#### 階段 1:Create
|
|
108
|
+
|
|
109
|
+
1. 基於 discuss 結論和 read_first 檔案,撰寫完整 spec
|
|
110
|
+
2. 使用 Spec Document Structure 模板
|
|
111
|
+
3. 所有 AC 使用 Given/When/Then 格式
|
|
112
|
+
4. 為 spec 指定 ID(查看 `docs/specs/` 目錄決定下一個編號)
|
|
113
|
+
5. 撰寫 Test Plan
|
|
114
|
+
6. 填寫 Assumptions & Open Questions(必填),使用 `[Assumption]`/`[Need Confirmation]` 標籤
|
|
115
|
+
7. IF spec 有 >3 ACs → 建議建立 `.ac.yaml` sidecar(參考 `specs/schemas/acceptance-criteria.schema.yaml`)
|
|
116
|
+
8. IF spec 定義 API/data flow → 建議填寫 I/O Contract 章節
|
|
117
|
+
9. IF spec 涉及 AI Agent 行為 → 填寫 AI Agent Behavior 章節
|
|
118
|
+
|
|
119
|
+
**決策:Spec 放置位置**
|
|
120
|
+
- IF 是 CLI 相關 → `docs/specs/cli/`
|
|
121
|
+
- IF 是 Core Standard 相關 → `docs/specs/standards/`
|
|
122
|
+
- IF 是 Skill 相關 → `docs/specs/skills/`
|
|
123
|
+
- IF 是架構相關 → `docs/specs/architecture/`
|
|
124
|
+
- IF 是跨元件 → `docs/specs/system/`
|
|
125
|
+
- ELSE → `docs/specs/`
|
|
126
|
+
|
|
127
|
+
🛑 **STOP**: 撰寫完 spec 後展示內容,等待使用者確認再寫入檔案
|
|
128
|
+
|
|
129
|
+
#### 階段 2:Review
|
|
130
|
+
|
|
131
|
+
1. 讀取指定 spec 檔案
|
|
132
|
+
2. 逐項檢查以下維度:
|
|
133
|
+
|
|
134
|
+
| 檢查維度 | 檢查內容 |
|
|
135
|
+
|----------|---------|
|
|
136
|
+
| Requirements 完整性 | 所有 REQ 都有 Scenario |
|
|
137
|
+
| AC 可測試性 | 每個 AC 都是 Given/When/Then 格式 |
|
|
138
|
+
| AC 覆蓋率 | 每個 REQ 至少有一個 AC 對應 |
|
|
139
|
+
| Technical Design 可行性 | 設計不依賴不存在的 API/工具 |
|
|
140
|
+
| Test Plan 對應 | Test Plan 涵蓋所有 AC |
|
|
141
|
+
| 範圍一致性 | 沒有超出 discuss 鎖定的範圍 |
|
|
142
|
+
| 無歧義 | 沒有模糊用語(「等等」「適當地」) |
|
|
143
|
+
| 假設標記完整性 | 所有假設都有 `[Assumption]` 標籤和驗證方式 |
|
|
144
|
+
| 待釐清追蹤 | 所有 `[Need Confirmation]` 項目有負責人和期限 |
|
|
145
|
+
|
|
146
|
+
3. 輸出 Review 結果表格
|
|
147
|
+
4. 更新 spec status 為 `Review`
|
|
148
|
+
|
|
149
|
+
**決策:Review 結果**
|
|
150
|
+
- IF 全部通過 → 建議進入 approve
|
|
151
|
+
- IF 有 blocking issue → 列出問題,建議修改後重新 review
|
|
152
|
+
- IF 只有 suggestion → 列出建議,使用者可選擇修改或直接 approve
|
|
153
|
+
|
|
154
|
+
🛑 **STOP**: 顯示 review 結果後等待使用者決定
|
|
155
|
+
|
|
156
|
+
#### 階段 3:Approve
|
|
157
|
+
|
|
158
|
+
1. 讀取 spec,確認 status = `Review`
|
|
159
|
+
2. 逐項展示 Approval Checklist(5 項),標記通過/未通過
|
|
160
|
+
3. 等待使用者確認核准
|
|
161
|
+
|
|
162
|
+
**決策:Approval 結果**
|
|
163
|
+
- IF 使用者確認核准 → 更新 spec metadata(status, approved-date, approved-by)
|
|
164
|
+
- IF 使用者拒絕 → 記錄原因,建議回到 review 或 create
|
|
165
|
+
|
|
166
|
+
🛑 **STOP**: 展示 checklist 結果後等待使用者明確說「核准」或「approved」
|
|
167
|
+
|
|
168
|
+
#### 階段 4:Implement
|
|
169
|
+
|
|
170
|
+
1. 讀取 approved spec,列出所有 AC
|
|
171
|
+
2. 產出實作計畫:每個 AC 要改哪些檔案、預估複雜度
|
|
172
|
+
3. 等待使用者確認計畫
|
|
173
|
+
|
|
174
|
+
🛑 **STOP**: 顯示實作計畫後等待使用者確認
|
|
175
|
+
|
|
176
|
+
4. 逐 AC 實作:
|
|
177
|
+
a. 撰寫程式碼
|
|
178
|
+
b. 撰寫對應測試
|
|
179
|
+
c. 執行測試確認通過
|
|
180
|
+
d. 更新 spec 中的 AC checkbox
|
|
181
|
+
|
|
182
|
+
**決策:Commit 節奏**
|
|
183
|
+
- IF AC 之間相互獨立 → 每完成一個 AC 就提示可以 commit
|
|
184
|
+
- IF AC 之間緊耦合 → 合併完成後一起提示 commit
|
|
185
|
+
- 不自動執行 git commit — 僅提示使用者
|
|
186
|
+
|
|
187
|
+
**決策:測試失敗**
|
|
188
|
+
- IF 測試失敗 → 修復後重新測試,最多重試 3 次
|
|
189
|
+
- IF 3 次仍失敗 → 🛑 STOP,報告問題,等待使用者指導
|
|
190
|
+
|
|
191
|
+
🛑 **STOP**: 每個獨立 AC 完成後暫停,展示進度,等待使用者確認繼續
|
|
192
|
+
|
|
193
|
+
#### 階段 5:Verify
|
|
194
|
+
|
|
195
|
+
1. 讀取 spec,列出所有 AC
|
|
196
|
+
2. 對每個 AC 收集證據:
|
|
197
|
+
- 程式碼位置(file:line)
|
|
198
|
+
- 測試位置(file:line)
|
|
199
|
+
- 測試結果(執行測試)
|
|
200
|
+
3. 檢查是否有偏差(Added / Modified / Omitted)
|
|
201
|
+
4. 產生 Verification Report
|
|
202
|
+
|
|
203
|
+
**決策:驗證結果**
|
|
204
|
+
- IF 全部 PASS → 更新 spec status 為 `Implemented`,建議歸檔
|
|
205
|
+
- IF 有 FAIL → 列出失敗項目,建議回到 implement 修復
|
|
206
|
+
- IF 迭代次數 ≥ 3 → 🛑 STOP,強制升級(review spec / rethink / escalate)
|
|
207
|
+
|
|
208
|
+
🛑 **STOP**: 顯示 Verification Report 後等待使用者決定下一步
|
|
209
|
+
|
|
210
|
+
#### 階段 6:Archive
|
|
211
|
+
|
|
212
|
+
1. 確認 spec status = `Implemented` 且 verify 通過
|
|
213
|
+
2. 連結相關 commit/PR
|
|
214
|
+
3. 更新 spec status 為 `Archived`
|
|
215
|
+
|
|
216
|
+
🛑 **STOP**: 確認歸檔前等待使用者確認
|
|
217
|
+
|
|
218
|
+
### 停止點總覽
|
|
219
|
+
|
|
220
|
+
| 階段 | 停止點 | 等待內容 |
|
|
221
|
+
|------|--------|---------|
|
|
222
|
+
| discuss | Discuss Summary 輸出後 | 確認進入 create |
|
|
223
|
+
| create | Spec 撰寫完成後 | 確認寫入檔案 |
|
|
224
|
+
| review | Review 結果輸出後 | 決定修改或進入 approve |
|
|
225
|
+
| approve | Checklist 展示後 | 明確核准 |
|
|
226
|
+
| implement | 實作計畫展示後 | 確認開始實作 |
|
|
227
|
+
| implement | 每個獨立 AC 完成後 | 確認繼續下一個 |
|
|
228
|
+
| verify | Verification Report 輸出後 | 決定歸檔或修復 |
|
|
229
|
+
| archive | 歸檔前 | 確認歸檔 |
|
|
230
|
+
|
|
231
|
+
### 錯誤處理
|
|
232
|
+
|
|
233
|
+
| 錯誤條件 | AI 動作 | AI 行為 |
|
|
234
|
+
|----------|---------|---------|
|
|
235
|
+
| Pre-Flight Check 失敗 | 說明哪個條件未滿足,引導到正確的 phase | 說明失敗原因,引導至正確階段 |
|
|
236
|
+
| Spec 檔案不存在 | 列出可用的 spec 檔案,或建議 `/sdd create` | 列出可用規格或建議建立 |
|
|
237
|
+
| Spec status 不符合目標 phase | 顯示當前 status,說明需要先完成哪個 phase | 顯示當前狀態,說明需先完成的階段 |
|
|
238
|
+
| `docs/specs/` 目錄不存在 | 自動建立目錄,繼續流程 | 自動建立目錄 |
|
|
239
|
+
| 使用者提供的 feature name 與現有 spec 重複 | 顯示現有 spec,問使用者是要繼續還是新建 | 顯示現有規格,詢問繼續或新建 |
|
|
240
|
+
| 實作中測試反覆失敗(>3 次) | 停止自動修復,報告問題,等待使用者指導 | 停止自動修復,回報問題,等待指導 |
|
|
241
|
+
| 非預期狀態(無法判斷正確行為) | 停止並詢問使用者,不猜測 | 停止並詢問,絕不猜測 |
|
|
242
|
+
|
|
243
|
+
---
|
|
244
|
+
|
|
64
245
|
## SDD 工作流程
|
|
65
246
|
|
|
66
247
|
```
|
|
@@ -229,13 +410,13 @@ sync-to:
|
|
|
229
410
|
|
|
230
411
|
## 規格狀態
|
|
231
412
|
|
|
232
|
-
| 狀態 | 說明 |
|
|
233
|
-
|
|
234
|
-
| Draft | 草稿中 |
|
|
235
|
-
| Review | 審查中 |
|
|
236
|
-
| Approved | 已核准 |
|
|
237
|
-
| Implemented | 已實作 |
|
|
238
|
-
| Archived | 已歸檔 |
|
|
413
|
+
| 狀態 | Description | 說明 |
|
|
414
|
+
|------|-------------|------|
|
|
415
|
+
| Draft | Work in progress | 草稿中 |
|
|
416
|
+
| Review | Under review | 審查中 |
|
|
417
|
+
| Approved | Ready for implementation | 已核准 |
|
|
418
|
+
| Implemented | Code complete | 已實作 |
|
|
419
|
+
| Archived | Completed or deprecated | 已歸檔 |
|
|
239
420
|
|
|
240
421
|
## 驗收標準格式
|
|
241
422
|
|
|
@@ -298,11 +479,11 @@ Brief description of the feature.
|
|
|
298
479
|
|
|
299
480
|
## Input/Output Contract (Optional) / 輸入輸出合約(可選)
|
|
300
481
|
|
|
301
|
-
### Input Contract
|
|
482
|
+
### Input Contract
|
|
302
483
|
| Field | Type | Required | Source | Description |
|
|
303
484
|
|-------|------|----------|--------|-------------|
|
|
304
485
|
|
|
305
|
-
### Output Contract
|
|
486
|
+
### Output Contract
|
|
306
487
|
| Field | Type | Guarantee | Consumer | Description |
|
|
307
488
|
|-------|------|-----------|----------|-------------|
|
|
308
489
|
|
|
@@ -340,23 +521,23 @@ Brief description of the feature.
|
|
|
340
521
|
|
|
341
522
|
## 使用方式
|
|
342
523
|
|
|
343
|
-
| 指令 | 用途 |
|
|
344
|
-
|
|
345
|
-
| `/sdd` | 互動式規格建立精靈 |
|
|
346
|
-
| `/sdd discuss` | 啟動功能討論階段 |
|
|
347
|
-
| `/sdd discuss auth-flow` | 討論特定功能 |
|
|
348
|
-
| `/sdd auth-flow` | 為特定功能建立規格 |
|
|
349
|
-
| `/sdd create auth-flow` | 明確指定建立階段 |
|
|
350
|
-
| `/sdd review` | 審查現有規格 |
|
|
351
|
-
| `/sdd review specs/SPEC-001.md` | 審查指定規格 |
|
|
352
|
-
| `/sdd approve` | 列出待核准規格 |
|
|
353
|
-
| `/sdd approve specs/SPEC-001.md` | 核准指定規格 |
|
|
354
|
-
| `/sdd implement` | 列出已核准規格 |
|
|
355
|
-
| `/sdd implement specs/SPEC-001.md` | 追蹤指定規格的實作 |
|
|
356
|
-
| `/sdd verify` | 列出已實作規格 |
|
|
357
|
-
| `/sdd verify specs/SPEC-001.md` | 驗證指定規格的實作 |
|
|
358
|
-
| `/sdd --evaluate` | 僅執行範圍評估 |
|
|
359
|
-
| `/sdd --sync-check` | 檢查同步狀態 |
|
|
524
|
+
| 指令 | Purpose | 用途 |
|
|
525
|
+
|------|---------|------|
|
|
526
|
+
| `/sdd` | Interactive spec creation wizard | 互動式規格建立精靈 |
|
|
527
|
+
| `/sdd discuss` | Start discuss phase for a feature | 啟動功能討論階段 |
|
|
528
|
+
| `/sdd discuss auth-flow` | Discuss specific feature | 討論特定功能 |
|
|
529
|
+
| `/sdd auth-flow` | Create spec for specific feature | 為特定功能建立規格 |
|
|
530
|
+
| `/sdd create auth-flow` | Explicit create phase | 明確指定建立階段 |
|
|
531
|
+
| `/sdd review` | Review existing specs | 審查現有規格 |
|
|
532
|
+
| `/sdd review specs/SPEC-001.md` | Review specific spec | 審查指定規格 |
|
|
533
|
+
| `/sdd approve` | List specs pending approval | 列出待核准規格 |
|
|
534
|
+
| `/sdd approve specs/SPEC-001.md` | Approve specific spec | 核准指定規格 |
|
|
535
|
+
| `/sdd implement` | List approved specs | 列出已核准規格 |
|
|
536
|
+
| `/sdd implement specs/SPEC-001.md` | Track implementation for spec | 追蹤指定規格的實作 |
|
|
537
|
+
| `/sdd verify` | List implemented specs | 列出已實作規格 |
|
|
538
|
+
| `/sdd verify specs/SPEC-001.md` | Verify implementation for spec | 驗證指定規格的實作 |
|
|
539
|
+
| `/sdd --evaluate` | Run scope evaluation only | 僅執行範圍評估 |
|
|
540
|
+
| `/sdd --sync-check` | Check sync status | 檢查同步狀態 |
|
|
360
541
|
|
|
361
542
|
## 典型 SDD 工作流程
|
|
362
543
|
|
|
@@ -2,12 +2,13 @@
|
|
|
2
2
|
source: ../../../../skills/commands/security.md
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
|
-
last_synced: 2026-
|
|
5
|
+
last_synced: 2026-10-12
|
|
6
|
+
source_hash: 6362f4f8221b
|
|
6
7
|
status: current
|
|
7
8
|
---
|
|
8
9
|
|
|
9
10
|
---
|
|
10
|
-
description: "[UDS]
|
|
11
|
+
description: "[UDS] 引導安全審查和漏洞評估,遵循 OWASP 標準"
|
|
11
12
|
allowed-tools: Read, Grep, Glob
|
|
12
13
|
argument-hint: "[module or file to audit | 要審計的模組或檔案]"
|
|
13
14
|
---
|
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
source: ../../../../skills/commands/slo.md
|
|
3
3
|
source_version: 1.0.0
|
|
4
4
|
translation_version: 1.0.0
|
|
5
|
-
last_synced: 2026-
|
|
5
|
+
last_synced: 2026-10-12
|
|
6
|
+
source_hash: 80f530e0fbf1
|
|
6
7
|
status: current
|
|
7
8
|
description: "[UDS] 引導 SLI 選取、SLO 設定和 Error Budget 管理"
|
|
8
9
|
---
|
|
@@ -10,9 +11,54 @@ description: "[UDS] 引導 SLI 選取、SLO 設定和 Error Budget 管理"
|
|
|
10
11
|
---
|
|
11
12
|
description: "[UDS] 引導 SLI 選取、SLO 設定和 Error Budget 管理"
|
|
12
13
|
allowed-tools: Read, Write, Grep, Glob
|
|
13
|
-
argument-hint: "[create | review | budget] [服務名稱]"
|
|
14
|
+
argument-hint: "[create | review | budget] [service name | 服務名稱]"
|
|
14
15
|
---
|
|
15
16
|
|
|
16
17
|
# SLO 助手
|
|
17
18
|
|
|
18
19
|
詳見 [SKILL.md](../slo-assistant/SKILL.md)。
|
|
20
|
+
|
|
21
|
+
## AI Agent Behavior | AI 代理行為
|
|
22
|
+
|
|
23
|
+
> 遵循 [AI Command Behavior Standards](../../core/ai-command-behavior.md)
|
|
24
|
+
|
|
25
|
+
### Entry Router | 進入路由
|
|
26
|
+
|
|
27
|
+
| 輸入 | AI 動作 |
|
|
28
|
+
|------|---------|
|
|
29
|
+
| `/slo` | 詢問目標服務,進入 SLO 設計導覽 |
|
|
30
|
+
| `/slo create` | 啟動新 SLO 建立流程 |
|
|
31
|
+
| `/slo create <service>` | 針對指定服務直接啟動 SLO 建立 |
|
|
32
|
+
| `/slo review` | 審查現有 SLO 設定合理性 |
|
|
33
|
+
| `/slo budget` | 查看 Error Budget 消耗狀況與建議 |
|
|
34
|
+
|
|
35
|
+
### Interaction Script | 互動腳本
|
|
36
|
+
|
|
37
|
+
1. 確認操作模式(建立 / 審查 / Error Budget)
|
|
38
|
+
2. 依模式引導使用者完成 SLI 選擇、目標設定或現況分析
|
|
39
|
+
3. 輸出 SLO 定義草稿或 Error Budget 報告
|
|
40
|
+
|
|
41
|
+
**決策:建立模式**
|
|
42
|
+
- 引導選擇 SLI 類型(Availability / Latency / Quality)
|
|
43
|
+
- 詢問目標值(如 99.9%)與測量區間(rolling 28d)
|
|
44
|
+
- IF 目標值過高(>99.99%)→ 警告工程成本,建議先設較保守目標
|
|
45
|
+
|
|
46
|
+
**決策:Error Budget 模式**
|
|
47
|
+
- IF budget 剩餘 < 10% → 建議暫停非必要發布
|
|
48
|
+
- IF budget 已燒盡 → 提示凍結發布,優先處理可靠性
|
|
49
|
+
|
|
50
|
+
🛑 **STOP**: SLO 草稿完成後等待使用者確認目標值與告警閾值
|
|
51
|
+
|
|
52
|
+
### Stop Points | 停止點
|
|
53
|
+
|
|
54
|
+
| 停止點 | 等待內容 |
|
|
55
|
+
|--------|---------|
|
|
56
|
+
| SLI 選擇完成後 | 使用者確認選定的可靠性指標 |
|
|
57
|
+
| SLO 草稿產生後 | 使用者審查目標值與告警設定 |
|
|
58
|
+
|
|
59
|
+
### Error Handling | 錯誤處理
|
|
60
|
+
|
|
61
|
+
| 錯誤條件 | AI 動作 |
|
|
62
|
+
|----------|---------|
|
|
63
|
+
| 服務無監控資料 | 建議先導入基礎 metrics,再設定 SLO |
|
|
64
|
+
| 目標值格式錯誤 | 提示正確格式(如 `99.9%` 或 `0.999`) |
|