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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (711) 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/secret-management-standards.ai.yaml +12 -1
  5. package/bundled/core/commit-message-guide.md +22 -19
  6. package/bundled/core/secret-management-standards.md +13 -1
  7. package/bundled/extensions/locales/zh-tw.md +19 -19
  8. package/bundled/hooks/validate-commit-msg.mjs +52 -9
  9. package/bundled/locales/zh-CN/CHANGELOG.md +2309 -1110
  10. package/bundled/locales/zh-CN/CLAUDE.md +987 -101
  11. package/bundled/locales/zh-CN/README.md +3 -3
  12. package/bundled/locales/zh-CN/SECURITY.md +3 -3
  13. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  14. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
  15. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  16. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
  17. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
  18. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
  19. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
  20. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  21. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  22. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  23. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  24. package/bundled/locales/zh-CN/core/accessibility-standards.md +871 -62
  25. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  26. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  27. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  28. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  29. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  30. package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +311 -72
  31. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  32. package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
  33. package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
  34. package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
  35. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  36. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  37. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  38. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  39. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  40. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  41. package/bundled/locales/zh-CN/core/changelog-standards.md +485 -63
  42. package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
  43. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  44. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  45. package/bundled/locales/zh-CN/core/code-review-checklist.md +37 -23
  46. package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
  47. package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
  48. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  49. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  50. package/bundled/locales/zh-CN/core/deprecation-standards.md +155 -40
  51. package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
  52. package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
  53. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  54. package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
  55. package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
  56. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  57. package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
  58. package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
  59. package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
  60. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  61. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  62. package/bundled/locales/zh-CN/core/feature-flag-standards.md +202 -57
  63. package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
  64. package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
  65. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  66. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  67. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  68. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  69. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  70. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  71. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  72. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  73. package/bundled/locales/zh-CN/core/mutation-testing.md +45 -6
  74. package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
  75. package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
  76. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  77. package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
  78. package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
  79. package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
  80. package/bundled/locales/zh-CN/core/project-structure.md +550 -170
  81. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  82. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  83. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  84. package/bundled/locales/zh-CN/core/retrospective-standards.md +215 -22
  85. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  86. package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
  87. package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
  88. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  89. package/bundled/locales/zh-CN/core/security-standards.md +169 -16
  90. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  91. package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
  92. package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
  93. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  94. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  95. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  96. package/bundled/locales/zh-CN/core/supply-chain-security-standards.md +159 -32
  97. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  98. package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
  99. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  100. package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
  101. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  102. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  103. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  104. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  105. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  106. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  107. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  108. package/bundled/locales/zh-CN/core/versioning.md +737 -73
  109. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  110. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  111. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  112. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +2 -1
  113. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  114. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
  115. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
  116. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  117. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
  118. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  119. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
  120. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  121. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  122. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +2 -0
  123. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  124. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  125. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  126. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  127. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  128. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  129. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  130. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  131. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  132. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  133. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  134. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  135. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  136. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  137. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  138. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  139. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  140. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  141. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  142. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  143. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  144. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  145. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  146. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  147. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  148. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  149. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  150. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  151. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  152. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  153. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  154. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  155. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  156. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  157. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  158. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  159. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  160. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  161. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  162. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  163. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  164. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  165. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  166. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  167. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  168. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  169. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  170. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  171. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  172. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  173. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  174. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  175. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  176. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  177. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  178. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  179. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  180. package/bundled/locales/zh-CN/skills/README.md +2 -1
  181. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  182. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  183. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  184. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  185. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  186. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  187. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  188. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  189. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  190. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  191. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  192. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  193. package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +217 -137
  194. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  195. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  196. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  197. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  198. package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +148 -132
  199. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  200. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  201. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  202. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  203. package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +122 -121
  204. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  205. package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
  206. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  207. package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
  208. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  209. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  210. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  211. package/bundled/locales/zh-CN/skills/code-review-assistant/guide.md +119 -45
  212. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  213. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  214. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  215. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  216. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  217. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  218. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  219. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  220. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  221. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  222. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  223. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  224. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  225. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  226. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  227. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  228. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  229. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  230. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  231. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  232. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  233. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  234. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  235. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  236. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  237. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  238. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  239. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  240. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  241. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  242. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  243. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  244. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  245. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  246. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  247. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  248. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  249. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  250. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  251. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  252. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  253. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  254. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  255. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  256. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  257. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  258. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  259. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  260. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  261. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +4 -4
  262. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  263. package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
  264. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  265. package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
  266. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  267. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  268. package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +4 -2
  269. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  270. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  271. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  272. package/bundled/locales/zh-CN/skills/docs-generator/guide.md +8 -7
  273. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  274. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  275. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  276. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  277. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  278. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  279. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  280. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  281. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  282. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  283. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  284. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  285. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  286. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  287. package/bundled/locales/zh-CN/skills/project-discovery/guide.md +158 -157
  288. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  289. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  290. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  291. package/bundled/locales/zh-CN/skills/refactoring-assistant/guide.md +172 -171
  292. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  293. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  294. package/bundled/locales/zh-CN/skills/release-standards/guide.md +51 -43
  295. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  296. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  297. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  298. package/bundled/locales/zh-CN/skills/requirement-assistant/guide.md +88 -79
  299. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  300. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  301. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  302. package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +2 -2
  303. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  304. package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
  305. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  306. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  307. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  308. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  309. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  310. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  311. package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +2 -2
  312. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  313. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  314. package/bundled/locales/zh-CN/skills/tdd-assistant/guide.md +217 -156
  315. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  316. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  317. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  318. package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +25 -12
  319. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  320. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  321. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  322. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  323. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  324. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  325. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  326. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  327. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  328. package/bundled/locales/zh-TW/CHANGELOG.md +2282 -1112
  329. package/bundled/locales/zh-TW/CLAUDE.md +962 -76
  330. package/bundled/locales/zh-TW/README.md +3 -3
  331. package/bundled/locales/zh-TW/SECURITY.md +3 -3
  332. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  333. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
  334. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  335. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
  336. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
  337. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
  338. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
  339. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  340. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  341. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  342. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  343. package/bundled/locales/zh-TW/core/accessibility-standards.md +895 -46
  344. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  345. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  346. package/bundled/locales/zh-TW/core/agent-dispatch.md +102 -33
  347. package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
  348. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  349. package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
  350. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  351. package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
  352. package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
  353. package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
  354. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  355. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  356. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  357. package/bundled/locales/zh-TW/core/branch-completion.md +130 -34
  358. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  359. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  360. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  361. package/bundled/locales/zh-TW/core/chaos-engineering-standards.md +138 -36
  362. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  363. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  364. package/bundled/locales/zh-TW/core/code-review-checklist.md +19 -7
  365. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  366. package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
  367. package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
  368. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  369. package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
  370. package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
  371. package/bundled/locales/zh-TW/core/developer-memory.md +102 -12
  372. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  373. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  374. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  375. package/bundled/locales/zh-TW/core/environment-standards.md +250 -72
  376. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  377. package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
  378. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  379. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  380. package/bundled/locales/zh-TW/core/feature-flag-standards.md +202 -57
  381. package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
  382. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  383. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  384. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  385. package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +234 -487
  386. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  387. package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
  388. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  389. package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
  390. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  391. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  392. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  393. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  394. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  395. package/bundled/locales/zh-TW/core/observability-standards.md +284 -40
  396. package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
  397. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  398. package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
  399. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  400. package/bundled/locales/zh-TW/core/project-context-memory.md +210 -31
  401. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  402. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  403. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  404. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  405. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  406. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  407. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  408. package/bundled/locales/zh-TW/core/runbook-standards.md +296 -23
  409. package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
  410. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  411. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  412. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  413. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  414. package/bundled/locales/zh-TW/core/slo-standards.md +301 -49
  415. package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
  416. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  417. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  418. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  419. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  420. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  421. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  422. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  423. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  424. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  425. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  426. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  427. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  428. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  429. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  430. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  431. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  432. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  433. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  434. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  435. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +2 -1
  436. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  437. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
  438. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  439. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
  440. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  441. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
  442. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  443. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
  444. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  445. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  446. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +2 -0
  447. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  448. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  449. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  450. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  451. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  452. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  453. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  454. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  455. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  456. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  457. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  458. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  459. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  460. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  461. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  462. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  463. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  464. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  465. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  466. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  467. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  468. package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +584 -475
  469. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  470. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  471. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  472. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  473. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  474. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  475. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  476. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  477. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  478. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  479. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  480. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  481. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  482. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  483. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  484. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  485. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  486. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  487. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  488. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  489. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  490. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  491. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  492. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  493. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  494. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  495. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  496. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  497. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  498. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  499. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  500. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  501. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  502. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  503. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  504. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  505. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  506. package/bundled/locales/zh-TW/skills/README.md +2 -1
  507. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  508. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  509. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  510. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  511. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  512. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  513. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  514. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  515. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  516. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  517. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  518. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  519. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  520. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  521. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  522. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  523. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  524. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  525. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  526. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  527. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  528. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  529. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  530. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  531. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  532. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  533. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  534. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  535. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  536. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  537. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  538. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  539. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  540. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  541. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  542. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  543. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  544. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  545. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  546. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  547. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  548. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  549. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  550. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  551. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  552. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  553. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  554. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  555. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  556. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  557. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  558. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  559. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  560. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  561. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  562. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  563. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  564. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  565. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  566. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  567. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  568. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  569. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  570. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  571. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  572. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  573. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  574. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  575. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  576. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  577. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  578. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  579. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  580. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  581. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  582. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  583. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  584. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  585. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  586. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  587. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  588. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  589. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  590. package/bundled/locales/zh-TW/skills/commit-standards/guide.md +137 -17
  591. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  592. package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
  593. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  594. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  595. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  596. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  597. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  598. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  599. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  600. package/bundled/locales/zh-TW/skills/docs-generator/guide.md +4 -3
  601. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  602. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  603. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  604. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  605. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  606. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  607. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  608. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  609. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  610. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  611. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  612. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  613. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  614. package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +85 -18
  615. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  616. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  617. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  618. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  619. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  620. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  621. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  622. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  623. package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +91 -45
  624. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  625. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  626. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  627. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  628. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  629. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  630. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  631. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  632. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  633. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  634. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  635. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  636. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  637. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  638. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  639. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  640. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  641. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  642. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  643. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  644. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  645. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  646. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  647. package/bundled/locales/zh-TW/skills/tdd-assistant/language-examples.md +693 -47
  648. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  649. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  650. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  651. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  652. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  653. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  654. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  655. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  656. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  657. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  658. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  659. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  660. package/bundled/skills/.claude-plugin/plugin.json +71 -0
  661. package/bundled/skills/commit-standards/SKILL.md +2 -2
  662. package/bundled/skills/commit-standards/guide.md +3 -2
  663. package/bundled/skills/commit-standards/language-options.md +19 -17
  664. package/package.json +2 -2
  665. package/src/commands/audit.js +28 -1
  666. package/src/commands/check.js +72 -3
  667. package/src/commands/compile.js +37 -4
  668. package/src/commands/config.js +49 -24
  669. package/src/commands/init.js +78 -30
  670. package/src/commands/open-work.js +6 -2
  671. package/src/commands/release-messages.js +228 -0
  672. package/src/commands/release.js +127 -68
  673. package/src/commands/run-intent.js +11 -0
  674. package/src/commands/spec.js +4 -2
  675. package/src/commands/update.js +173 -20
  676. package/src/compilers/claude-code-compiler.js +9 -1
  677. package/src/config/ai-agent-paths.js +14 -1
  678. package/src/core/installed-formats.js +15 -0
  679. package/src/core/open-work-config.js +20 -1
  680. package/src/core/project-config.js +55 -0
  681. package/src/i18n/messages.js +106 -2
  682. package/src/installers/hooks-installer.js +1 -1
  683. package/src/installers/manifest-installer.js +1 -1
  684. package/src/installers/skills-installer.js +1 -1
  685. package/src/installers/standards-installer.js +3 -1
  686. package/src/mcp/server.js +9 -3
  687. package/src/prompts/init.js +26 -22
  688. package/src/reconciler/actual-state-scanner.js +2 -8
  689. package/src/reconciler/backup-locations.js +5 -0
  690. package/src/reconciler/backup-manager.js +19 -11
  691. package/src/reconciler/desired-state-calculator.js +89 -57
  692. package/src/reconciler/plan-executor.js +101 -8
  693. package/src/reconciler/recorded-versions.js +49 -0
  694. package/src/reconciler/relative-path.js +23 -0
  695. package/src/uninstallers/hook-uninstaller.js +9 -1
  696. package/src/uninstallers/skills-uninstaller.js +22 -3
  697. package/src/utils/available-standards-report.js +25 -4
  698. package/src/utils/available-standards.js +13 -3
  699. package/src/utils/build-manifest.js +1 -1
  700. package/src/utils/commit-message-judge.js +60 -13
  701. package/src/utils/friction-detector.js +23 -11
  702. package/src/utils/git-hooks.js +106 -4
  703. package/src/utils/integration-generator.js +95 -67
  704. package/src/utils/legacy-hook-migration.js +121 -2
  705. package/src/utils/open-work-tracking.mjs +105 -16
  706. package/src/utils/sdd-header.js +16 -4
  707. package/src/utils/skills-installer.js +2 -1
  708. package/src/utils/spinner.js +14 -4
  709. package/src/utils/standard-validator.js +3 -2
  710. package/standards-registry.json +10 -8
  711. package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
@@ -2,32 +2,57 @@
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) | [繁體中文](../../zh-TW/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
+ 本文件定义服务等级指标(SLI)、服务等级目标(SLO)以及错误预算(Error Budget)的标准。这些概念构成了可靠性管理的基础,使团队能够在功能交付速度与服务质量之间取得平衡。
16
26
 
17
27
  ---
18
28
 
19
29
  ## 关键概念
20
30
 
21
- | 概念 | 定义 | 对象 | 违反后果 |
22
- |------|------|------|---------|
23
- | **SLI** | 服务行为的量化量测 | 工程团队 | 无直接后果(数据点) |
24
- | **SLO** | 在时间窗口内 SLI 的内部目标 | 工程团队 | 触发 Error Budget 策略 |
25
- | **SLA** | 保证服务质量的外部合同 | 客户 | 合同罚则(退款、信用额度) |
26
- | **Error Budget** | 允许的不可靠量(1 - SLO 目标) | 工程团队 | 耗尽时触发保护措施 |
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 对比
41
+
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
 
@@ -35,19 +60,109 @@ status: current
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:
43
64
 
44
- ### Batch Jobs
65
+ | SLI | 度量方式 | 数据来源 |
66
+ |-----|-------------|-------------|
67
+ | **Availability** | 成功请求数(非 5xx)/ 总请求数 | 负载均衡器或应用指标 |
68
+ | **Latency** | 耗时低于阈值的请求数 / 总请求数 | 应用直方图(Histogram)指标 |
69
+ | **Quality** | 未降级响应数 / 总响应数 | 应用级质量检查 |
45
70
 
46
- | SLI | 量测 | 数据来源 |
47
- |-----|------|---------|
48
- | **Freshness** | 上次成功完成至今的时间 | Job Scheduler 指标 |
49
- | **Correctness** | 正确处理的记录 / 总记录 | 应用验证指标 |
50
- | **Coverage** | 成功完成的批次 / 总调度批次 | Job Scheduler 指标 |
71
+ **示例:** 可用性 SLI = `count(http_status != 5xx) / count(all_requests)`,基于滚动 28 天窗口。
72
+
73
+ ### 批处理作业(Batch Jobs)
74
+
75
+ 对于计划的批处理、数据管道和 ETL 作业:
76
+
77
+ | SLI | 度量方式 | 数据来源 |
78
+ |-----|-------------|-------------|
79
+ | **Freshness** | 距上次成功完成的时间在阈值以内 | 作业调度器指标 |
80
+ | **Correctness** | 正确处理的记录数 / 总记录数 | 应用验证指标 |
81
+ | **Coverage** | 成功完成的批次数 / 总计划批次数 | 作业调度器指标 |
82
+
83
+ ### 前端应用
84
+
85
+ 对于 Web 和移动端前端应用:
86
+
87
+ | SLI | 度量方式 | 数据来源 |
88
+ |-----|-------------|-------------|
89
+ | **Load Performance** | 满足 LCP < 2.5s、FID < 100ms、CLS < 0.1 的页面数 / 总页面数 | 真实用户监控(RUM) |
90
+ | **Availability** | 成功加载的页面数 / 总页面加载数 | RUM 或合成监控 |
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 不要超出团队所能承受的维持能力。过高追求的目标会导致 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,50 +170,162 @@ 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
66
183
  ```
67
184
 
68
185
  ### Burn Rate 告警
69
186
 
187
+ 监控 Error Budget 的消耗速率:
188
+
70
189
  | 消耗速度 | 阈值 | 触发动作 | 含义 |
71
- |---------|------|---------|------|
72
- | **快速消耗** | 1 小时消耗 2% 预算 | Page(P1) | 按此速率,约 2 天耗尽 |
73
- | **中速消耗** | 6 小时消耗 5% 预算 | Alert(P2) | 按此速率,约 5 天耗尽 |
74
- | **慢速消耗** | 3 天消耗 10% 预算 | Ticket(P3) | 可能在月底前耗尽 |
190
+ |-------------------|-----------|------------------|---------|
191
+ | **快速消耗** | 1 小时消耗 2% 预算 | Page (P1) | 按此速率,预算约在 2 天内耗尽 |
192
+ | **中速消耗** | 6 小时消耗 5% 预算 | Alert (P2) | 按此速率,预算约在 5 天内耗尽 |
193
+ | **慢速消耗** | 3 天消耗 10% 预算 | Ticket (P3) | 可能在月末前耗尽预算 |
75
194
 
76
195
  ### 预算耗尽后的行动
77
196
 
197
+ 当 Error Budget 耗尽时,团队应从以下策略选项中进行选择:
198
+
78
199
  | 策略 | 说明 | 适用场景 |
79
- |------|------|---------|
80
- | **冻结发布** | 暂停非可靠性功能发布 | 默认策略 |
81
- | **可靠性冲刺** | 下个 Sprint 专注于可靠性改善 | 系统性问题需要集中处理 |
82
- | **加强审查** | 所有变更需额外生产就绪审查 | 变更是预算消耗的根因 |
83
- | **降低 SLO 目标** | 经利益相关方同意后降低 SLO | 目标对当前架构不切实际 |
200
+ |--------|-------------|-------------|
201
+ | **冻结发布** | 暂停非可靠性相关特性发布,直到预算恢复 | 默认策略;确保聚焦于可靠性 |
202
+ | **可靠性冲刺** | 将下一个 Sprint 完全用于可靠性改进 | 当系统性问题需要集中投入解决时 |
203
+ | **加强审查** | 所有变更均需额外的生产就绪度审查 | 当变更是导致预算消耗的根因时 |
204
+ | **降低 SLO 目标** | 经利益相关方同意后降低 SLO | 当目标基于当前架构不切实际时 |
205
+
206
+ > **重要提示:** 团队应当在预算耗尽**之前**就其 Error Budget 策略达成一致,而不是在危机发生期间。
84
207
 
85
208
  ---
86
209
 
87
- ## Quick Reference Card
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
283
+ ```
284
+
285
+ ---
286
+
287
+ ## 与开发工作流集成
288
+
289
+ ### 规格驱动开发(/sdd)中的 SLO
290
+
291
+ 使用 `/sdd` 定义新服务时,SHOULD 在 spec 中包含 SLO 章节:
292
+
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
+ ```
311
+
312
+ ---
313
+
314
+ ## 快速参考卡
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/) — 多窗口燃烧率告警
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,16 +1,16 @@
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-16
6
+ source_hash: 66eefffe8309
7
+ status: current
8
8
  ---
9
9
 
10
10
  # 规格驱动开发 (SDD) 标准
11
11
 
12
- **版本**: 2.3.0
13
- **最后更新**: 2026-06-08
12
+ **版本**: 2.5.0
13
+ **最后更新**: 2026-08-24
14
14
  **适用范围**: 所有采用规格驱动开发的项目
15
15
  **范围**: universal
16
16
 
@@ -135,6 +135,8 @@ SDD **不是** "ATDD → BDD → TDD" 序列的一部分。相反,它通过正
135
135
  | **AC YAML Sidecar** | 推荐使用 .ac.yaml 实现机器可读的 AC(当 AC 数量 > 3 时) |
136
136
  | **AI Agent 行为** | 可选章节,定义规格内的 agent 角色、规则、质量检查和约束 |
137
137
 
138
+ > 规格记下的**延后项目**(未纳入/不在本版的条目、open questions、仍待确认的 assumptions)适用 [deferred-item-exit](deferred-item-exit.md)。
139
+
138
140
  ## AC 格式
139
141
 
140
142
  UDS 支持两种 AC 记法。**GWT 为预设与首选**(Forward Derivation/BDD 场景生成依赖它)。**EARS**(Easy Approach to Requirements Syntax,IBM Rational)为可选补充,对事件/状态/恒常/异常需求表达更精准(XSPEC-263)。
@@ -149,6 +151,35 @@ UDS 支持两种 AC 记法。**GWT 为预设与首选**(Forward Derivation/B
149
151
 
150
152
  每个 AC 提供 **GWT 或 EARS** 之一(`.ac.yaml` 的 `given/when/then` 或 `ears`)。BDD 可推导行为优先 GWT;GWT 表达牵强时改用 EARS。不强制两者并存、不移除 GWT。
151
153
 
154
+ ## 没有验证项的 AC 不是 AC
155
+
156
+ 每一条验收标准都必须有一个**指向它的验证项**——测试、检查、闸门,或一则明确记录的手动步骤。没有任何验证项引用的 AC 是**一张没有人兑现的支票**,而且它不会大声失败:它只是安静地停止成立,而规格继续宣称它为真。
157
+
158
+ **规则**:没有验证项的 AC 必须**降级为设计意图**,不得继续挂在 AC 栏。降级是诚实的,未经验证的 AC 不是。
159
+
160
+ ### 实测案例
161
+
162
+ 一份 2026-05-14 的规格写着 `AC-7:旧版系统报告完整保留(无回归)`。它的 Test Plan 有七项,**没有一项指向 AC-7**。该报告的 timer 是 disabled、部署函数从未被调用——**从那条 AC 被写下的同一天起**。三个月后在验证另一件无关的安装时偶然发现。
163
+
164
+ **它不是后来断线的。它从来没有被接上过。**
165
+
166
+ ### 为什么「有人会检查」不是验证项
167
+
168
+ 「有人会检查」不是验证项。它必须**可执行或有记录**,不能是隐含的。「审查者会注意到」不算——因为审查者读的是规格,而规格说那条 AC 成立。**AC 是一个关于世界的宣称,只有碰得到世界的东西才能证伪它。**
169
+
170
+ ### 关联
171
+
172
+ - [verification-evidence](verification-evidence.md) — VE-011 要求证据必须来自**最后一次编辑后**的新鲜运行(fresh run);本标准则是其上游问题:一开始到底有没有任何运行指向该宣称。
173
+ - [class-level-fix](class-level-fix.md) — 同一套纪律套用于*范围*:遍历集合而非列举它。
174
+
175
+ ## v2.5.0 新增内容
176
+
177
+ - **指向 [deferred-item-exit](deferred-item-exit.md) 的指针**(XSPEC-391 R5)。规格记下的未纳入条目、open questions 与仍待确认的 assumptions 皆为延后项目,且它们必须满足的不变量已在该处陈述。**是指针,不是摘要**——同一条规则的六份副本会往六个方向腐烂。
178
+
179
+ ## v2.4.0 新增内容
180
+
181
+ - **没有验证项的 AC 不是 AC**(XSPEC-380 R5)。每一条验收标准都必须有一个指向它的验证项;没有验证项的 AC 必须降级为设计意图,不得继续挂在 AC 栏。实测案例:一份规格的 `AC-7` 没有对应的 Test Plan 项目,而它所保护的项目**从那条 AC 被写下的同一天起**就停止运行——三个月后偶然被发现。AC 是一个关于世界的宣称,只有碰得到世界的东西才能证伪它。
182
+
152
183
  ## v2.3.0 新增内容
153
184
 
154
185
  - **EARS 记法**作为可选 AC 格式(XSPEC-263):5 种 EARS 模板 + `.ac.yaml` 的 `ears` 字段。GWT 仍为默认和首选格式;`given/when/then` 从 `required` 放宽(向后兼容)。
@@ -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 Governance Meta Pack | **状态**: Trial(2026-04-17 ~ 2026-10-17)
18
15
 
19
- ---
20
-
21
- ## 目的
16
+ ## 概述
22
17
 
23
- 新标准纳入 UDS 的四项条件。在 DEC-043 提出 60+ 候选新标准的背景下,需要一个明文的纳入检查清单,避免标准库膨胀(重叠、未使用)与降低品质。本标准是 UDS 的治理层 meta 标准 — 用来「决定标准的标准」。每个候选新标准必须通过四项条件才能从 Proposed 进入 Trial。
24
-
25
- ---
18
+ 新标准纳入 UDS 的四项条件。在 DEC-043 提出 60+ 候选新标准的背景下,需要一个明文的纳入检查清单,避免标准库膨胀(重叠、未使用)与降低质量。本标准是 UDS 的治理层 meta 标准 — 用来「决定标准的标准」。每个候选新标准必须通过四项条件才能从 Proposed 进入 Trial。
26
19
 
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 (adoption layer) / 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
- ---
76
+ ## 使用示例
88
77
 
89
- ## 情境示例
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
79
+ - **场景 2 —— 因重叠拒绝**:`advanced-retry-with-jitter` 申请。与 `retry-standards` 重叠 > 30% → 拒绝,建议改为 Phase 2 扩充
80
+ - **场景 3 —— 因证据不足拒绝**:`universal-best-practices` 申请。仅「未来可能用到」类描述 → 拒绝,要求至少 2 个已发生案例
90
81
 
91
- - **情境 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
- - **情境 2 — 因重叠拒绝**:`advanced-retry-with-jitter` 申请。与 `retry-standards` 重叠 > 30% → 拒绝,建议改为 Phase 2 扩充
93
- - **情境 3 — 因证据不足拒绝**:`universal-best-practices` 申请。仅「未来可能用到」类描述 → 拒绝,要求至少 2 个已发生案例
82
+ ## 错误码
94
83
 
95
- ---
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 Governance Meta Pack 跨项目规格
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
96
 
97
- ## 错误码
98
97
 
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 |
98
+ **范围**: universal