universal-dev-standards 6.14.0-beta.9 → 6.14.1-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (721) hide show
  1. package/bin/uds.js +12 -1
  2. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  3. package/bundled/ai/standards/commit-message.ai.yaml +12 -2
  4. package/bundled/ai/standards/mock-boundary.ai.yaml +138 -2
  5. package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
  6. package/bundled/ai/standards/turn-completion-integrity.ai.yaml +6 -2
  7. package/bundled/core/commit-message-guide.md +22 -19
  8. package/bundled/core/mock-boundary.md +70 -2
  9. package/bundled/core/secret-management-standards.md +13 -1
  10. package/bundled/core/turn-completion-integrity.md +8 -2
  11. package/bundled/extensions/locales/zh-tw.md +19 -19
  12. package/bundled/hooks/check-dangerous-cmd.mjs +161 -26
  13. package/bundled/hooks/check-logging-standard.mjs +35 -6
  14. package/bundled/hooks/validate-commit-msg.mjs +317 -28
  15. package/bundled/locales/zh-CN/CHANGELOG.md +2323 -1099
  16. package/bundled/locales/zh-CN/CLAUDE.md +987 -101
  17. package/bundled/locales/zh-CN/README.md +3 -3
  18. package/bundled/locales/zh-CN/SECURITY.md +4 -3
  19. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  20. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
  21. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  22. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
  23. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
  24. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
  25. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
  26. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  27. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  28. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  29. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  30. package/bundled/locales/zh-CN/core/accessibility-standards.md +871 -62
  31. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  32. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  33. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  34. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  35. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  36. package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +311 -72
  37. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  38. package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
  39. package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
  40. package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
  41. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  42. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  43. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  44. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  45. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  46. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  47. package/bundled/locales/zh-CN/core/changelog-standards.md +485 -63
  48. package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
  49. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  50. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  51. package/bundled/locales/zh-CN/core/code-review-checklist.md +37 -23
  52. package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
  53. package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
  54. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  55. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  56. package/bundled/locales/zh-CN/core/deprecation-standards.md +155 -40
  57. package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
  58. package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
  59. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  60. package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
  61. package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
  62. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  63. package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
  64. package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
  65. package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
  66. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  67. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  68. package/bundled/locales/zh-CN/core/feature-flag-standards.md +202 -57
  69. package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
  70. package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
  71. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  72. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  73. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  74. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  75. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  76. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  77. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  78. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  79. package/bundled/locales/zh-CN/core/mock-boundary.md +74 -6
  80. package/bundled/locales/zh-CN/core/mutation-testing.md +45 -6
  81. package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
  82. package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
  83. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  84. package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
  85. package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
  86. package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
  87. package/bundled/locales/zh-CN/core/project-structure.md +550 -170
  88. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  89. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  90. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  91. package/bundled/locales/zh-CN/core/retrospective-standards.md +215 -22
  92. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  93. package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
  94. package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
  95. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  96. package/bundled/locales/zh-CN/core/security-standards.md +169 -16
  97. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  98. package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
  99. package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
  100. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  101. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  102. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  103. package/bundled/locales/zh-CN/core/supply-chain-security-standards.md +159 -32
  104. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  105. package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
  106. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  107. package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
  108. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  109. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  110. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  111. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  112. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  113. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  114. package/bundled/locales/zh-CN/core/turn-completion-integrity.md +8 -6
  115. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  116. package/bundled/locales/zh-CN/core/versioning.md +737 -73
  117. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  118. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  119. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  120. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +2 -1
  121. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  122. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
  123. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
  124. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  125. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
  126. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  127. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
  128. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  129. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  130. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +2 -0
  131. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  132. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  133. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  134. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  135. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  136. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  137. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  138. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  139. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  140. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  141. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  142. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  143. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  144. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  145. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  146. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  147. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  148. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  149. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  150. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  151. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  152. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  153. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  154. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  155. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  156. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  157. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  158. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  159. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  160. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  161. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  162. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  163. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  164. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  165. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  166. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  167. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  168. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  169. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  170. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  171. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  172. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  173. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  174. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  175. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  176. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  177. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  178. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  179. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  180. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  181. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  182. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  183. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  184. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  185. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  186. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  187. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  188. package/bundled/locales/zh-CN/skills/README.md +2 -1
  189. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  190. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  191. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  192. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  193. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  194. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  195. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  196. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  197. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  198. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  199. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  200. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  201. package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +217 -137
  202. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  203. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  204. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  205. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  206. package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +148 -132
  207. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  208. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  209. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  210. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  211. package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +122 -121
  212. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  213. package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
  214. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  215. package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
  216. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  217. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  218. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  219. package/bundled/locales/zh-CN/skills/code-review-assistant/guide.md +119 -45
  220. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  221. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  222. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  223. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  224. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  225. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  226. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  227. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  228. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  229. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  230. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  231. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  232. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  233. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  234. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  235. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  236. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  237. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  238. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  239. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  240. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  241. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  242. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  243. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  244. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  245. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  246. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  247. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  248. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  249. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  250. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  251. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  252. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  253. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  254. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  255. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  256. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  257. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  258. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  259. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  260. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  261. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  262. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  263. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  264. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  265. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  266. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  267. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  268. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  269. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +4 -4
  270. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  271. package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
  272. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  273. package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
  274. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  275. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  276. package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +4 -2
  277. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  278. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  279. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  280. package/bundled/locales/zh-CN/skills/docs-generator/guide.md +8 -7
  281. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  282. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  283. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  284. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  285. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  286. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  287. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  288. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  289. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  290. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  291. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  292. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  293. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  294. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  295. package/bundled/locales/zh-CN/skills/project-discovery/guide.md +158 -157
  296. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  297. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  298. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  299. package/bundled/locales/zh-CN/skills/refactoring-assistant/guide.md +172 -171
  300. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  301. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  302. package/bundled/locales/zh-CN/skills/release-standards/guide.md +51 -43
  303. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  304. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  305. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  306. package/bundled/locales/zh-CN/skills/requirement-assistant/guide.md +88 -79
  307. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  308. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  309. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  310. package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +2 -2
  311. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  312. package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
  313. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  314. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  315. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  316. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  317. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  318. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  319. package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +2 -2
  320. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  321. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  322. package/bundled/locales/zh-CN/skills/tdd-assistant/guide.md +217 -156
  323. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  324. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  325. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  326. package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +25 -12
  327. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  328. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  329. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  330. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  331. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  332. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  333. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  334. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  335. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  336. package/bundled/locales/zh-TW/CHANGELOG.md +2323 -1128
  337. package/bundled/locales/zh-TW/CLAUDE.md +962 -76
  338. package/bundled/locales/zh-TW/README.md +3 -3
  339. package/bundled/locales/zh-TW/SECURITY.md +4 -3
  340. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  341. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
  342. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  343. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
  344. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
  345. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
  346. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
  347. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  348. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  349. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  350. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  351. package/bundled/locales/zh-TW/core/accessibility-standards.md +895 -46
  352. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  353. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  354. package/bundled/locales/zh-TW/core/agent-dispatch.md +102 -33
  355. package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
  356. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  357. package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
  358. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  359. package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
  360. package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
  361. package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
  362. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  363. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  364. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  365. package/bundled/locales/zh-TW/core/branch-completion.md +130 -34
  366. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  367. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  368. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  369. package/bundled/locales/zh-TW/core/chaos-engineering-standards.md +138 -36
  370. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  371. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  372. package/bundled/locales/zh-TW/core/code-review-checklist.md +19 -7
  373. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  374. package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
  375. package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
  376. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  377. package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
  378. package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
  379. package/bundled/locales/zh-TW/core/developer-memory.md +102 -12
  380. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  381. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  382. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  383. package/bundled/locales/zh-TW/core/environment-standards.md +250 -72
  384. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  385. package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
  386. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  387. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  388. package/bundled/locales/zh-TW/core/feature-flag-standards.md +202 -57
  389. package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
  390. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  391. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  392. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  393. package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +234 -487
  394. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  395. package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
  396. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  397. package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
  398. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  399. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  400. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  401. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  402. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  403. package/bundled/locales/zh-TW/core/mock-boundary.md +74 -6
  404. package/bundled/locales/zh-TW/core/observability-standards.md +284 -40
  405. package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
  406. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  407. package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
  408. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  409. package/bundled/locales/zh-TW/core/project-context-memory.md +210 -31
  410. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  411. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  412. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  413. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  414. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  415. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  416. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  417. package/bundled/locales/zh-TW/core/runbook-standards.md +296 -23
  418. package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
  419. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  420. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  421. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  422. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  423. package/bundled/locales/zh-TW/core/slo-standards.md +301 -49
  424. package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
  425. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  426. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  427. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  428. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  429. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  430. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  431. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  432. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  433. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  434. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  435. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  436. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  437. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  438. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  439. package/bundled/locales/zh-TW/core/turn-completion-integrity.md +8 -6
  440. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  441. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  442. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  443. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  444. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  445. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +2 -1
  446. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  447. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
  448. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  449. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
  450. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  451. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
  452. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  453. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
  454. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  455. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  456. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +2 -0
  457. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  458. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  459. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  460. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  461. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  462. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  463. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  464. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  465. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  466. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  467. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  468. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  469. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  470. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  471. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  472. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  473. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  474. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  475. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  476. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  477. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  478. package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +584 -475
  479. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  480. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  481. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  482. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  483. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  484. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  485. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  486. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  487. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  488. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  489. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  490. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  491. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  492. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  493. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  494. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  495. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  496. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  497. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  498. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  499. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  500. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  501. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  502. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  503. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  504. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  505. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  506. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  507. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  508. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  509. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  510. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  511. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  512. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  513. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  514. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  515. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  516. package/bundled/locales/zh-TW/skills/README.md +2 -1
  517. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  518. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  519. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  520. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  521. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  522. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  523. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  524. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  525. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  526. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  527. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  528. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  529. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  530. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  531. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  532. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  533. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  534. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  535. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  536. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  537. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  538. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  539. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  540. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  541. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  542. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  543. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  544. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  545. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  546. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  547. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  548. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  549. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  550. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  551. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  552. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  553. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  554. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  555. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  556. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  557. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  558. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  559. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  560. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  561. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  562. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  563. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  564. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  565. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  566. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  567. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  568. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  569. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  570. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  571. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  572. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  573. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  574. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  575. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  576. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  577. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  578. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  579. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  580. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  581. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  582. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  583. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  584. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  585. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  586. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  587. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  588. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  589. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  590. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  591. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  592. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  593. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  594. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  595. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  596. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  597. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  598. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  599. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  600. package/bundled/locales/zh-TW/skills/commit-standards/guide.md +137 -17
  601. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  602. package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
  603. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  604. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  605. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  606. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  607. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  608. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  609. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  610. package/bundled/locales/zh-TW/skills/docs-generator/guide.md +4 -3
  611. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  612. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  613. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  614. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  615. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  616. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  617. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  618. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  619. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  620. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  621. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  622. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  623. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  624. package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +85 -18
  625. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  626. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  627. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  628. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  629. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  630. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  631. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  632. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  633. package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +91 -45
  634. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  635. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  636. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  637. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  638. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  639. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  640. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  641. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  642. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  643. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  644. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  645. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  646. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  647. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  648. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  649. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  650. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  651. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  652. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  653. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  654. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  655. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  656. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  657. package/bundled/locales/zh-TW/skills/tdd-assistant/language-examples.md +693 -47
  658. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  659. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  660. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  661. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  662. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  663. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  664. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  665. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  666. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  667. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  668. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  669. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  670. package/bundled/skills/.claude-plugin/plugin.json +71 -0
  671. package/bundled/skills/commit-standards/SKILL.md +2 -2
  672. package/bundled/skills/commit-standards/guide.md +3 -2
  673. package/bundled/skills/commit-standards/language-options.md +19 -17
  674. package/package.json +2 -2
  675. package/src/commands/audit.js +28 -1
  676. package/src/commands/check.js +72 -3
  677. package/src/commands/compile.js +37 -4
  678. package/src/commands/config.js +49 -24
  679. package/src/commands/init.js +78 -30
  680. package/src/commands/open-work.js +6 -2
  681. package/src/commands/release-messages.js +228 -0
  682. package/src/commands/release.js +127 -68
  683. package/src/commands/run-intent.js +11 -0
  684. package/src/commands/spec.js +4 -2
  685. package/src/commands/update.js +227 -47
  686. package/src/compilers/claude-code-compiler.js +9 -1
  687. package/src/config/ai-agent-paths.js +14 -1
  688. package/src/core/installed-formats.js +15 -0
  689. package/src/core/open-work-config.js +20 -1
  690. package/src/core/project-config.js +55 -0
  691. package/src/i18n/messages.js +106 -2
  692. package/src/installers/hooks-installer.js +1 -1
  693. package/src/installers/manifest-installer.js +1 -1
  694. package/src/installers/skills-installer.js +1 -1
  695. package/src/installers/standards-installer.js +3 -1
  696. package/src/mcp/server.js +9 -3
  697. package/src/prompts/init.js +26 -22
  698. package/src/reconciler/actual-state-scanner.js +2 -8
  699. package/src/reconciler/backup-locations.js +5 -0
  700. package/src/reconciler/backup-manager.js +19 -11
  701. package/src/reconciler/desired-state-calculator.js +89 -57
  702. package/src/reconciler/plan-executor.js +101 -8
  703. package/src/reconciler/recorded-versions.js +49 -0
  704. package/src/reconciler/relative-path.js +23 -0
  705. package/src/uninstallers/hook-uninstaller.js +9 -1
  706. package/src/uninstallers/skills-uninstaller.js +22 -3
  707. package/src/utils/available-standards-report.js +25 -4
  708. package/src/utils/available-standards.js +13 -3
  709. package/src/utils/build-manifest.js +1 -1
  710. package/src/utils/commit-message-judge.js +60 -13
  711. package/src/utils/friction-detector.js +23 -11
  712. package/src/utils/git-hooks.js +106 -4
  713. package/src/utils/integration-generator.js +95 -67
  714. package/src/utils/legacy-hook-migration.js +121 -2
  715. package/src/utils/open-work-tracking.mjs +105 -16
  716. package/src/utils/sdd-header.js +16 -4
  717. package/src/utils/skills-installer.js +2 -1
  718. package/src/utils/spinner.js +14 -4
  719. package/src/utils/standard-validator.js +3 -2
  720. package/standards-registry.json +10 -8
  721. package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
@@ -2,52 +2,167 @@
2
2
  source: ../../../core/slo-standards.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-04-10
5
+ last_synced: 2026-10-16
6
+ source_hash: 30ebf8c58138
6
7
  status: current
7
8
  ---
8
9
 
9
10
  # SLO 標準(Service Level Objectives)
10
11
 
11
- > 版本: 1.0.0 | 最後更新: 2026-04-01
12
+ > **語言**: [English](../../../core/slo-standards.md) | 繁體中文
13
+
14
+ **版本**: 1.0.0
15
+ **最後更新**: 2026-03-31
16
+ **適用範圍**: 所有具有正式環境服務的軟體專案
17
+ **範疇**: 通用
18
+ **業界標準**: Google SRE, ISO/IEC 20000
19
+ **參考資料**: [sre.google](https://sre.google/), [OpenSLO](https://openslo.com/)
20
+
21
+ ---
12
22
 
13
23
  ## 概述
14
24
 
15
- 本文件定義 Service Level Indicators(SLI)、Service Level Objectives(SLO)及 Error Budgets 的標準。這些概念構成可靠性管理的基礎,讓團隊在功能開發速度與服務品質之間取得平衡。
25
+ 本文件定義服務水準指標(Service Level Indicator, SLI)、服務水準目標(Service Level Objective, SLO)與錯誤預算(Error Budget)的標準。這些概念構成可靠性管理的基礎,讓團隊能夠在功能開發速度與服務品質之間取得平衡。
16
26
 
17
27
  ---
18
28
 
19
- ## 關鍵概念
29
+ ## 核心概念
30
+
31
+ ### SLI / SLO / SLA / Error Budget 定義
32
+
33
+ | 概念 | 定義 | 目標受眾 | 違反後果 |
34
+ |---------|-----------|----------|----------------------|
35
+ | **SLI**(服務水準指標) | 服務行為的量化測量 | 工程團隊 | 無直接後果(資料點) |
36
+ | **SLO**(服務水準目標) | 在特定時間區間內 SLI 的內部目標 | 工程團隊 | 觸發 Error Budget 政策 |
37
+ | **SLA**(服務等級協定) | 保證服務品質的外部合約 | 客戶 | 合約罰則(退款、折抵額度) |
38
+ | **Error Budget**(錯誤預算) | 允許的不可靠程度(1 - SLO 目標) | 工程團隊 | 耗盡時觸發保護措施 |
39
+
40
+ ### SLI vs SLO vs SLA 比較
20
41
 
21
- | 概念 | 定義 | 對象 | 違反後果 |
22
- |------|------|------|---------|
23
- | **SLI** | 服務行為的量化量測 | 工程團隊 | 無直接後果(資料點) |
24
- | **SLO** | 在時間窗口內 SLI 的內部目標 | 工程團隊 | 觸發 Error Budget 政策 |
25
- | **SLA** | 保證服務品質的外部合約 | 客戶 | 合約罰則(退款、信用額度) |
26
- | **Error Budget** | 允許的不可靠量(1 - SLO 目標) | 工程團隊 | 耗盡時觸發保護措施 |
42
+ ```
43
+ ┌─────────────────────────────────────┐
44
+ │ Service Quality │
45
+ │ │
46
+ SLI ─── measures ──► SLO ─── stricter than ──► SLA │
47
+ (what) (internal target) (contract) │
48
+ │ │
49
+ │ Error Budget = 1 - SLO target │
50
+ └─────────────────────────────────────┘
51
+ ```
27
52
 
28
- **SLO 應比 SLA 更嚴格**,以提供緩衝。例如:
53
+ **SLO 應比 SLA 更嚴格**以提供緩衝空間。範例:
29
54
  - SLA:99.9% 可用性(對客戶的合約義務)
30
- - SLO:99.95% 可用性(內部目標,在 SLA 違反前有 50% 緩衝)
55
+ - SLO:99.95% 可用性(內部目標,在違反 SLA 前提供 50% 緩衝空間)
31
56
 
32
57
  ---
33
58
 
34
- ## SLI 選擇指南
59
+ ## SLI 選取指南
35
60
 
36
61
  ### API 服務
37
62
 
38
- | SLI | 量測 | 資料來源 |
39
- |-----|------|---------|
40
- | **Availability** | 成功請求(非 5xx)/ 總請求 | Load Balancer 或應用指標 |
41
- | **Latency** | 持續時間低於閾值的請求 / 總請求 | 應用 Histogram 指標 |
42
- | **Quality** | 未降級回應 / 總回應 | 應用層品質檢查 |
63
+ 對於 REST/gRPC API 服務,可從以下選取 SLI:
64
+
65
+ | SLI | 測量方式 | 資料來源 |
66
+ |-----|-------------|-------------|
67
+ | **Availability**(可用性) | 成功請求(非 5xx)/ 總請求 | 負載平衡器或應用程式指標 |
68
+ | **Latency**(延遲) | 處理時間低於門檻值的請求 / 總請求 | 應用程式長條圖指標(Histogram) |
69
+ | **Quality**(品質) | 未降級的回應 / 總回應 | 應用程式層級的品質檢查 |
70
+
71
+ **範例:** 可用性 SLI = 在滾動 28 天內的 `count(http_status != 5xx) / count(all_requests)`。
72
+
73
+ ### 批次作業(Batch Jobs)
74
+
75
+ 適用於排程批次處理、資料管線與 ETL 作業:
43
76
 
44
- ### Batch Jobs
77
+ | SLI | 測量方式 | 資料來源 |
78
+ |-----|-------------|-------------|
79
+ | **Freshness**(新鮮度) | 距上次成功完成的時間低於門檻值 | 作業排程器指標 |
80
+ | **Correctness**(正確性) | 正確處理的紀錄 / 總紀錄 | 應用程式驗證指標 |
81
+ | **Coverage**(涵蓋率) | 成功完成的批次 / 總排程批次 | 作業排程器指標 |
45
82
 
46
- | SLI | 量測 | 資料來源 |
47
- |-----|------|---------|
48
- | **Freshness** | 上次成功完成至今的時間 | Job Scheduler 指標 |
49
- | **Correctness** | 正確處理的記錄 / 總記錄 | 應用驗證指標 |
50
- | **Coverage** | 成功完成的批次 / 總排程批次 | Job Scheduler 指標 |
83
+ ### 前端應用程式
84
+
85
+ 適用於 Web 與行動前端應用程式:
86
+
87
+ | SLI | 測量方式 | 資料來源 |
88
+ |-----|-------------|-------------|
89
+ | **Load Performance**(載入效能) | LCP < 2.5s、FID < 100ms、CLS < 0.1 的頁面 / 總頁面 | 真實使用者監控(RUM) |
90
+ | **Availability**(可用性) | 成功載入的頁面 / 總頁面載入次數 | RUM 或綜合監控(Synthetic Monitoring) |
91
+ | **Interaction Delay**(互動延遲) | 回應時間 < 門檻值的使用者操作 / 總操作次數 | RUM |
92
+
93
+ ### 資料管線
94
+
95
+ 適用於串流與即時資料處理:
96
+
97
+ | SLI | 測量方式 | 資料來源 |
98
+ |-----|-------------|-------------|
99
+ | **Throughput**(吞吐量) | 每秒處理紀錄數達到目標 | 管線指標 |
100
+ | **Freshness**(新鮮度) | 端對端延遲低於門檻值 | 管線指標 |
101
+ | **Correctness**(正確性) | 有效輸出紀錄 / 總輸出紀錄 | 驗證指標 |
102
+
103
+ ---
104
+
105
+ ## SLO 設定方法論
106
+
107
+ ### 步驟流程
108
+
109
+ 為服務設定 SLO 時,請遵循以下 5 個步驟:
110
+
111
+ #### 步驟 1:選取 SLI
112
+
113
+ 從上方指南選取最具意義的 SLI。每個服務建議先從 1-3 個 SLI 開始。
114
+
115
+ #### 步驟 2:決定測量時間區間
116
+
117
+ | 區間類型 | 時間長度 | 適用時機 |
118
+ |-------------|----------|----------|
119
+ | **滾動區間(Rolling)** | 28 天(建議) | 大多數服務;可平滑化每週週期模式 |
120
+ | **日曆區間(Calendar)** | 日曆月份 | 與業務報告週期對齊 |
121
+
122
+ #### 步驟 3:設定目標值
123
+
124
+ 使用歷史資料設定初始目標。常見的起點是**歷史效能的 P5**(即 95% 的時間都能達到的水準)。
125
+
126
+ **目標值選取指南:**
127
+
128
+ | 目標值 | 每月允許停機時間 | 適用對象 |
129
+ |--------|--------------------------|-------------|
130
+ | 99% | 7.3 小時 | 內部工具、非關鍵服務 |
131
+ | 99.5% | 3.65 小時 | 一般 B2B 服務 |
132
+ | 99.9% | 43.8 分鐘 | 面向消費者的核心服務 |
133
+ | 99.95% | 21.9 分鐘 | 金融、醫療、高可靠性系統 |
134
+ | 99.99% | 4.38 分鐘 | 基礎架構、支付平台 |
135
+
136
+ > **提示:** 不要設定超出自身維護能力的過高 SLO。過度激進的 SLO 會頻繁耗盡您的 Error Budget,並中斷功能開發流程。
137
+
138
+ #### 步驟 4:定義合規性公式
139
+
140
+ 記錄計算 SLO 合規性的具體公式:
141
+
142
+ ```
143
+ SLO Compliance = (Good Events / Total Events) × 100%
144
+
145
+ Where:
146
+ - Good Events = requests with status < 500 AND duration < 500ms
147
+ - Total Events = all requests received
148
+ - Window = rolling 28 days
149
+ - Target = 99.9%
150
+ ```
151
+
152
+ #### 步驟 5:記錄 SLO 規格文件
153
+
154
+ 使用 [SLO 文件範本](#slo-document-template) 記錄 SLO。
155
+
156
+ ### 迭代調整
157
+
158
+ SLO 並非一勞永逸。應每季使用以下訊號進行檢視:
159
+
160
+ | 訊號 | 採取行動 |
161
+ |--------|--------|
162
+ | Error Budget 持續未充分使用(剩餘 > 80%) | 考慮收緊 SLO |
163
+ | Error Budget 頻繁耗盡 | 考慮放寬 SLO 或投資提升可靠性 |
164
+ | 達到 SLO 但使用者滿意度下降 | SLI 可能未反映實際使用者體驗;重新檢視 SLI 選取 |
165
+ | 工程團隊因可靠性維護工作過度疲憊 | SLO 可能設定過於激進 |
51
166
 
52
167
  ---
53
168
 
@@ -55,32 +170,144 @@ status: current
55
170
 
56
171
  ### 計算方式
57
172
 
173
+ Error Budget 代表允許的失敗總量:
174
+
58
175
  ```
59
- Error Budget = 1 - SLO 目標
176
+ Error Budget = 1 - SLO Target
60
177
 
61
- 範例:
62
- SLO = 99.9% 可用性,28 天窗口
178
+ Example:
179
+ SLO = 99.9% availability over 28 days
63
180
  Error Budget = 0.1%
64
- = 28 天 × 24 小時 × 60 分鐘 × 0.001
65
- = 40.32 分鐘的允許停機時間
181
+ = 28 days × 24 hours × 60 minutes × 0.001
182
+ = 40.32 minutes of allowed downtime
183
+ ```
184
+
185
+ ### 消耗率(Burn Rate)告警
186
+
187
+ 監控 Error Budget 被消耗的速度:
188
+
189
+ | 消耗速度 | 門檻值 | 觸發行動 | 代表意義 |
190
+ |-------------------|-----------|------------------|---------|
191
+ | **快速消耗(Fast burn)** | 1 小時內消耗 2% 預算 | 呼叫(P1) | 照此速率,約 2 天預算就會耗盡 |
192
+ | **中速消耗(Medium burn)** | 6 小時內消耗 5% 預算 | 告警(P2) | 照此速率,約 5 天預算就會耗盡 |
193
+ | **慢速消耗(Slow burn)** | 3 天內消耗 10% 預算 | 工單(P3) | 可能在月底前耗盡預算 |
194
+
195
+ ### 預算耗盡後的因應措施
196
+
197
+ 當 Error Budget 耗盡時,團隊應從下列政策選項中選取因應方式:
198
+
199
+ | 政策 | 說明 | 適用時機 |
200
+ |--------|-------------|-------------|
201
+ | **凍結發布** | 暫停非可靠性相關的功能發布,直到預算恢復 | 預設政策;確保團隊專注於可靠性 |
202
+ | **可靠性衝刺** | 將下一個 Sprint 完全投入於可靠性改善 | 系統性問題需要集中資源處理時 |
203
+ | **加強審查** | 所有變更都需要額外的生產環境就緒審查(Production-Readiness Review) | 變更是造成預算快速消耗的根本原因時 |
204
+ | **降低 SLO 目標** | 經利害關係人同意後調降 SLO | 依當前架構而言目標不切實際時 |
205
+
206
+ > **重要:** 團隊應**在**預算耗盡之前就協議好 Error Budget 政策,而不是在危機發生時才決定。
207
+
208
+ ---
209
+
210
+ ## SLO 範本
211
+
212
+ ### API 服務範本
213
+
214
+ | SLI | 量測 | 預設 SLO |
215
+ |-----|-------------|-------------|
216
+ | Availability | 非 5xx 回應 / 總回應 | 99.9% |
217
+ | Latency | P99 持續時間 < 閾值 / 總請求 | 99% |
218
+ | Error Rate | 非 5xx + 非逾時 / 總回應 | 99.9% |
219
+
220
+ ### Batch Job 範本
221
+
222
+ | SLI | 量測 | 預設 SLO |
223
+ |-----|-------------|-------------|
224
+ | Freshness | 最大延遲 < 閾值 | 99.5% |
225
+ | Correctness | 正確處理 / 總計 | 99.99% |
226
+ | Completion Rate | 成功完成 / 已排程 | 99.9% |
227
+
228
+ ### 前端應用程式範本
229
+
230
+ | SLI | 量測 | 預設 SLO |
231
+ |-----|-------------|-------------|
232
+ | Load Performance | LCP < 2.5s 頁面比例 | 90% |
233
+ | Interaction Delay | FID < 100ms 互動比例 | 95% |
234
+ | Visual Stability | CLS < 0.1 頁面比例 | 95% |
235
+
236
+ ---
237
+
238
+ ## SLO 文件範本
239
+
240
+ 為服務建立 SLO 規格時,請包含以下章節:
241
+
242
+ ```markdown
243
+ # SLO Specification: [Service Name]
244
+
245
+ ## Service Information
246
+ - **Service**: [name]
247
+ - **Owner**: [team/person]
248
+ - **Description**: [what the service does]
249
+ - **Dependencies**: [upstream/downstream services]
250
+
251
+ ## SLI Definition
252
+ | SLI | Metric | Good Event | Total Event | Data Source |
253
+ |-----|--------|------------|-------------|-------------|
254
+ | [name] | [metric name] | [definition] | [definition] | [source] |
255
+
256
+ ## SLO Target
257
+ | SLI | Target | Window | Compliance Formula |
258
+ |-----|--------|--------|--------------------|
259
+ | [name] | [%] | [rolling 28d / calendar month] | [formula] |
260
+
261
+ ## Error Budget Policy
262
+ | Budget State | Action |
263
+ |-------------|--------|
264
+ | > 50% remaining | Normal development |
265
+ | < 50% remaining | Increased scrutiny on changes |
266
+ | Exhausted | [chosen policy: freeze/sprint/review/lower] |
267
+
268
+ ## Stakeholders
269
+ | Role | Person/Team | Notification |
270
+ |------|-------------|-------------|
271
+ | SLO Owner | [name] | All budget alerts |
272
+ | Engineering Lead | [name] | Budget < 50% |
273
+ | Product Manager | [name] | Budget exhausted |
274
+
275
+ ## Review Cycle
276
+ - **Frequency**: Quarterly
277
+ - **Next Review**: [date]
278
+ - **Review Checklist**:
279
+ - [ ] Budget consumption trend
280
+ - [ ] User satisfaction alignment
281
+ - [ ] Incident frequency and impact
282
+ - [ ] Team workload balance
66
283
  ```
67
284
 
68
- ### Burn Rate 告警
285
+ ---
286
+
287
+ ## 與開發工作流程整合
69
288
 
70
- | 消耗速度 | 閾值 | 觸發動作 | 意義 |
71
- |---------|------|---------|------|
72
- | **快速消耗** | 1 小時消耗 2% 預算 | Page(P1) | 按此速率,約 2 天耗盡 |
73
- | **中速消耗** | 6 小時消耗 5% 預算 | Alert(P2) | 按此速率,約 5 天耗盡 |
74
- | **慢速消耗** | 3 天消耗 10% 預算 | Ticket(P3) | 可能在月底前耗盡 |
289
+ ### 規格驅動開發(/sdd)中的 SLO
75
290
 
76
- ### 預算耗盡後的行動
291
+ 使用 `/sdd` 定義新服務時,應(SHOULD)在規格中包含 SLO 章節:
77
292
 
78
- | 政策 | 說明 | 適用情境 |
79
- |------|------|---------|
80
- | **凍結發布** | 暫停非可靠性功能發布 | 預設政策 |
81
- | **可靠性衝刺** | 下個 Sprint 專注於可靠性改善 | 系統性問題需要集中處理 |
82
- | **加強審查** | 所有變更需額外生產就緒審查 | 變更是預算消耗的根因 |
83
- | **降低 SLO 目標** | 經利害關係人同意後降低 SLO | 目標對當前架構不切實際 |
293
+ ```markdown
294
+ ## SLO Targets (Recommended)
295
+ | SLI | Target | Rationale |
296
+ |-----|--------|-----------|
297
+ | Availability | 99.9% | Customer-facing API |
298
+ | Latency P99 | < 500ms | User experience requirement |
299
+ ```
300
+
301
+ ### 事故應變中的 SLO 影響
302
+
303
+ 使用 `/incident` 時,請在評估中納入 SLO 影響:
304
+
305
+ ```markdown
306
+ ### SLO Impact
307
+ - **Affected SLI**: Availability
308
+ - **Error Budget consumed**: 15 minutes (37% of monthly budget)
309
+ - **Remaining budget**: 25.32 minutes
310
+ ```
84
311
 
85
312
  ---
86
313
 
@@ -88,17 +315,17 @@ Error Budget = 1 - SLO 目標
88
315
 
89
316
  ### SLI 選擇
90
317
  ```
91
- API 服務? → Availability + Latency + Quality
92
- Batch Job? → Freshness + Correctness + Coverage
93
- 前端應用? → LCP/FID/CLS + Availability
318
+ API Service? → Availability + Latency + Quality
319
+ Batch Job? → Freshness + Correctness + Coverage
320
+ Frontend App? → LCP/FID/CLS + Availability
94
321
  ```
95
322
 
96
323
  ### SLO 目標選擇
97
324
  ```
98
- 內部工具? → 99%
99
- B2B 服務? → 99.5%
100
- 消費者面向? → 99.9%
101
- 金融/關鍵? → 99.95%+
325
+ Internal tool? → 99%
326
+ B2B service? → 99.5%
327
+ Consumer-facing? → 99.9%
328
+ Financial/critical? → 99.95%+
102
329
  ```
103
330
 
104
331
  ### Error Budget 快速計算
@@ -109,7 +336,32 @@ Budget = (1 - target) × window_minutes
109
336
 
110
337
  ---
111
338
 
339
+ ## 參考資料
340
+
341
+ - [Google SRE Book — Service Level Objectives](https://sre.google/sre-book/service-level-objectives/) — 基礎 SLO 概念
342
+ - [Google SRE Workbook — Implementing SLOs](https://sre.google/workbook/implementing-slos/) — 實務 SLO 實作
343
+ - [Google SRE Workbook — Alerting on SLOs](https://sre.google/workbook/alerting-on-slos/) — 多窗口 Burn Rate 告警
344
+ - [OpenSLO Specification](https://openslo.com/) — SLO 定義的開放標準
345
+ - [The Art of SLOs](https://sre.google/resources/practices-and-processes/art-of-slos/) — Google 的 SLO 工作坊
346
+
347
+ ---
348
+
112
349
  **相關標準:**
113
350
  - [可觀測性標準](observability-standards.md) — 三大支柱框架與指標指引
114
351
  - [告警標準](alerting-standards.md) — SLO-based 告警策略
352
+ - [效能標準](performance-standards.md) — 效能目標
115
353
  - [日誌標準](logging-standards.md) — 結構化日誌用於 SLI 資料收集
354
+
355
+ ---
356
+
357
+ ## 版本歷史
358
+
359
+ | 版本 | 日期 | 變更 |
360
+ |---------|------|---------|
361
+ | 1.0.0 | 2026-03-31 | 初始發布:SLI 選擇、SLO 方法論、Error Budget、範本 |
362
+
363
+ ---
364
+
365
+ ## 授權條款
366
+
367
+ 本標準以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權釋出。
@@ -1,18 +1,18 @@
1
1
  ---
2
2
  source: ../../../core/spec-driven-development.md
3
- source_version: 2.3.0
3
+ source_version: 2.5.0
4
4
  translation_version: 2.3.0
5
- last_synced: 2026-06-10
6
- source_hash: 08dd8c2bee20
7
- status: stale
5
+ last_synced: 2026-10-15
6
+ source_hash: 66eefffe8309
7
+ status: current
8
8
  ---
9
9
 
10
10
  # 規格驅動開發 (SDD) 標準
11
11
 
12
12
  > **語言**: [English](../../../core/spec-driven-development.md) | 繁體中文
13
13
 
14
- **版本**: 2.3.0
15
- **最後更新**: 2026-06-08
14
+ **版本**: 2.5.0
15
+ **最後更新**: 2026-08-24
16
16
  **適用性**: 所有採用規格驅動開發的專案
17
17
  **範圍**: 通用 (Universal)
18
18
 
@@ -61,6 +61,35 @@ UDS 支援兩種 AC 記法。**GWT 為預設與首選**(Forward Derivation/B
61
61
 
62
62
  每個 AC 提供 **GWT 或 EARS** 之一(`.ac.yaml` 的 `given/when/then` 或 `ears`)。BDD 可推導行為優先 GWT;GWT 表達牽強時改用 EARS。不強制兩者並存、不移除 GWT。
63
63
 
64
+ ## 沒有驗證項的 AC 不是 AC
65
+
66
+ 每一條驗收標準都必須有一個**指向它的驗證項**——測試、檢查、閘門,或一則明確記錄的手動步驟。沒有任何驗證項引用的 AC 是**一張沒有人兌現的支票**,而且它不會大聲失敗:它只是安靜地停止成立,而規格繼續宣稱它為真。
67
+
68
+ **規則**:沒有驗證項的 AC 必須**降級為設計意圖**,不得繼續掛在 AC 欄。降級是誠實的,未經驗證的 AC 不是。
69
+
70
+ ### 實測案例
71
+
72
+ 一份 2026-05-14 的規格寫著 `AC-7:舊版系統報告完整保留(無回歸)`。它的 Test Plan 有七項,**沒有一項指向 AC-7**。該報告的 timer 是 disabled、部署函式從未被呼叫——**從那條 AC 被寫下的同一天起**。三個月後在驗證另一件無關的安裝時偶然發現。
73
+
74
+ **它不是後來斷線的。它從來沒有被接上過。**
75
+
76
+ ### 為什麼「有人會檢查」不是驗證項
77
+
78
+ 「有人會檢查」不是驗證項。它必須**可執行或有紀錄**,不能是隱含的。「審查者會注意到」不算——因為審查者讀的是規格,而規格說那條 AC 成立。**AC 是一個關於世界的宣稱,只有碰得到世界的東西才能證偽它。**
79
+
80
+ ### 關聯
81
+
82
+ - [verification-evidence](verification-evidence.md) — VE-011 要求證據必須來自**最後一次編輯後**的新鮮執行(fresh run);本標準則是其上游問題:一開始到底有沒有任何執行指向該宣稱。
83
+ - [class-level-fix](class-level-fix.md) — 同一套紀律套用於*範圍*:走訪集合而非列舉它。
84
+
85
+ ## v2.5.0 新增內容
86
+
87
+ - **指向 [deferred-item-exit](deferred-item-exit.md) 的指標**(XSPEC-391 R5)。規格記下的未納入條目、open questions 與仍待確認的 assumptions 皆為延後項目,且它們必須滿足的不變量已在該處陳述。**是指標,不是摘要**——同一條規則的六份副本會往六個方向腐壞。
88
+
89
+ ## v2.4.0 新增內容
90
+
91
+ - **沒有驗證項的 AC 不是 AC**(XSPEC-380 R5)。每一條驗收標準都必須有一個指向它的驗證項;沒有驗證項的 AC 必須降級為設計意圖,不得繼續掛在 AC 欄。實測案例:一份規格的 `AC-7` 沒有對應的 Test Plan 項目,而它所保護的項目**從那條 AC 被寫下的同一天起**就停止運行——三個月後偶然被發現。AC 是一個關於世界的宣稱,只有碰得到世界的東西才能證偽它。
92
+
64
93
  ## v2.3.0 新增內容
65
94
 
66
95
  - **EARS 記法** 作為可選 AC 格式(XSPEC-263):5 種 EARS 模板 + `.ac.yaml` `ears` 欄位。GWT 維持預設與首選;`given/when/then` 由 required 放寬(向後相容)。
@@ -79,4 +108,4 @@ UDS 支援兩種 AC 記法。**GWT 為預設與首選**(Forward Derivation/B
79
108
  - [正向推演標準](forward-derivation-standards.md)
80
109
  - [反向工程標準](reverse-engineering-standards.md)
81
110
  - [測試驅動開發](test-driven-development.md)
82
- - [行為驅動開發](behavior-driven-development.md)
111
+ - [行為驅動開發](behavior-driven-development.md)
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/standard-admission-criteria.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-04-20
5
+ last_synced: 2026-10-11
6
+ source_hash: a3a8cddc8766
6
7
  status: current
7
8
  ---
8
9
 
@@ -10,21 +11,13 @@ status: current
10
11
 
11
12
  > **語言**: [English](../../../core/standard-admission-criteria.md) | 繁體中文
12
13
 
13
- **版本**: 1.0.0
14
- **最後更新**: 2026-04-17
15
- **狀態**: Trial(到期 2026-10-17)
16
- **適用範圍**: universal
17
- **來源**: XSPEC-070(DEC-043 Wave 1 治理 Meta 套件)
14
+ > **來源**: XSPEC-070 | **驅動**: DEC-043 Wave 1 治理 Meta 套件 | **狀態**: Trial(2026-04-17 ~ 2026-10-17)
18
15
 
19
- ---
20
-
21
- ## 目的
16
+ ## 概述
22
17
 
23
18
  新標準納入 UDS 的四項條件。在 DEC-043 提出 60+ 候選新標準的背景下,需要一個明文的納入檢查清單,避免標準庫膨脹(重疊、未使用)與降低品質。本標準是 UDS 的治理層 meta 標準 — 用來「決定標準的標準」。每個候選新標準必須通過四項條件才能從 Proposed 進入 Trial。
24
19
 
25
- ---
26
-
27
- ## 核心規範
20
+ ## 核心原則
28
21
 
29
22
  - **四項硬性條件**:所有候選新標準必須同時通過 Evidence / Scope / Non-overlapping / AI-executable
30
23
  - **拒絕理由必須具體**:不得以「不合適」之類籠統用詞結案,必須指出未通過的 criterion
@@ -32,8 +25,6 @@ status: current
32
25
  - **Self-applicability**:本標準也必須符合四項條件
33
26
  - **Backward compat**:既有 66 個 Active 標準不溯及既往
34
27
 
35
- ---
36
-
37
28
  ## 四項條件
38
29
 
39
30
  ### 1. Evidence(具體場景)
@@ -66,7 +57,7 @@ status: current
66
57
 
67
58
  ### 4. AI-executable(AI 可消費)
68
59
 
69
- 至少一個採用層元件(Quality Gate / Agent prompt / Skill / IDE rule)能消費:
60
+ 至少一個 Quality Gate(採用層)/ Agent prompt(採用層)/ Skill 能消費:
70
61
 
71
62
  - 定義清楚的 guidelines(每條可驗證)
72
63
  - 至少 2 個 Given-When-Then scenarios
@@ -75,8 +66,6 @@ status: current
75
66
 
76
67
  **拒絕範例**:只有抽象原則,無任何 AI 可執行的規則
77
68
 
78
- ---
79
-
80
69
  ## 拒絕協議
81
70
 
82
71
  1. 拒絕理由必須指出未通過的 criterion(evidence / scope / non-overlapping / ai-executable)
@@ -84,21 +73,26 @@ status: current
84
73
  3. 候選者可依理由修正後重新申請(不永久封鎖)
85
74
  4. 若拒絕理由涉及重疊,應建議改為擴充既有標準
86
75
 
87
- ---
88
-
89
- ## 情境範例
76
+ ## 使用範例
90
77
 
91
78
  - **情境 1 — 通過**:`retry-standards` 申請。Evidence(XSPEC-067 Scenario 1-1/1-2)、Scope(universal)、Non-overlapping(與 circuit-breaker 互補)、AI-executable(9 guidelines + 3 scenarios)全通過 → 進入 Trial
92
79
  - **情境 2 — 因重疊拒絕**:`advanced-retry-with-jitter` 申請。與 `retry-standards` 重疊 > 30% → 拒絕,建議改為 Phase 2 擴充
93
80
  - **情境 3 — 因證據不足拒絕**:`universal-best-practices` 申請。僅「未來可能用到」類描述 → 拒絕,要求至少 2 個已發生案例
94
81
 
95
- ---
96
-
97
82
  ## 錯誤碼
98
83
 
99
- | 代碼 | 說明 |
100
- |------|------|
101
- | `ADMISSION-001` | `MISSING_EVIDENCE` — 未提供至少 2 個具體使用場景 |
102
- | `ADMISSION-002` | `SCOPE_UNDEFINED` — 未定義 meta.scope 或適用活動類型 |
103
- | `ADMISSION-003` | `OVERLAP_EXCEEDED` — 與既有標準重疊 > 30% |
104
- | `ADMISSION-004` | `NOT_AI_EXECUTABLE` — 無任何 AI 可消費的規則或 scenarios |
84
+ - `ADMISSION-001` — `MISSING_EVIDENCE`
85
+ - `ADMISSION-002` — `SCOPE_UNDEFINED`
86
+ - `ADMISSION-003` — `OVERLAP_EXCEEDED`(> 30%)
87
+ - `ADMISSION-004` — `NOT_AI_EXECUTABLE`
88
+
89
+ ## 參考資料
90
+
91
+ - AI 最佳化版本: [ai/standards/standard-admission-criteria.ai.yaml](../../../ai/standards/standard-admission-criteria.ai.yaml)
92
+ - XSPEC-070: DEC-043 Wave 1 治理 Meta 套件跨專案規格
93
+ - DEC-043: UDS 覆蓋完整性路線圖(本標準是 Wave 1 前置條件)
94
+ - 相關: `standard-lifecycle-management`, `skill-standard-alignment-check`, `adr-standards`
95
+ - 業界: IETF RFC admission criteria, Python PEP process, W3C Recommendation Track
96
+
97
+
98
+ **範圍**: universal