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,7 +2,8 @@
2
2
  source: ../../../core/retry-standards.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: 7179aacfc3cb
6
7
  status: current
7
8
  ---
8
9
 
@@ -10,131 +11,66 @@ status: current
10
11
 
11
12
  > **語言**: [English](../../../core/retry-standards.md) | 繁體中文
12
13
 
13
- **版本**: 1.0.0
14
- **最後更新**: 2026-04-17
15
- **狀態**: Trial(到期 2026-10-17)
16
- **適用範圍**: universal
17
- **來源**: XSPEC-067(DEC-043 Wave 1 可靠性套件)
14
+ > **來源**: XSPEC-067 | **驅動來源**: DEC-043 Wave 1 Reliability Pack | **狀態**: Trial(2026-04-17 ~ 2026-10-17)
18
15
 
19
- ---
20
-
21
- ## 目的
22
-
23
- 重試策略標準:指數退避加抖動、重試上限、依 failure-source 分類的重試規則。
24
-
25
- 延伸既有 circuit-breaker 與 failure-source-taxonomy,補齊 retry 層的標準化規則。避免各元件各自實作重試造成行為不一致(無上限重試、無 jitter 導致 thundering herd)。
16
+ ## 概述
26
17
 
27
- ---
28
-
29
- ## 核心規範
18
+ 重試策略標準 — 延伸既有 `circuit-breaker` 與 `failure-source-taxonomy`,補齊 retry 層的標準化規則。避免各元件各自實作重試造成行為不一致(無上限重試、無 jitter 導致 thundering herd)。與 `failure-source-taxonomy` 深度整合:依失敗類型決定是否重試、重試幾次、退避多久。
30
19
 
31
- - 所有重試邏輯必須使用 exponential + jitter,禁止固定間隔或無 jitter 的純指數
32
- - 重試必須有明確上限(`max_attempts`),禁止無限重試
33
- - 重試決策必須先參考 failure-source-taxonomy 分類,fail-fast 類別不得重試
34
- - 重試必須與 circuit-breaker 整合:OPEN 狀態下不得重試,直接 fail-fast
35
- - 每次重試都應透過遙測事件上報(`retry_attempted` / `retry_exhausted`)
20
+ ## 核心原則
36
21
 
37
- ---
22
+ - **指數退避加 full jitter**:所有重試邏輯必須使用 exponential + jitter,禁止固定間隔或無 jitter 的純指數
23
+ - **明確重試上限**:必須有 `max_attempts`(預設 5),禁止無限重試
24
+ - **依 failureSource 分類**:先查 `failure-source-taxonomy`,fail-fast 類別不得重試
25
+ - **與 circuit-breaker 整合**:OPEN 狀態下 fail-fast,不消耗 `max_attempts`;`retry_exhausted` 計入 failure count
26
+ - **重試可觀察**:每次重試上報 `retry_attempted` / `retry_exhausted` 遙測事件
38
27
 
39
28
  ## 退避公式
40
29
 
41
- **Exponential with full jitter**:
42
-
43
30
  ```
44
31
  wait_ms = min(cap_ms, base_ms * 2^attempt) * (0.5 + random() * 0.5)
45
32
  ```
46
33
 
47
34
  | 參數 | 預設值 | 說明 |
48
35
  |------|--------|------|
49
- | `base_ms` | `100` | 基底等待時間 |
50
- | `cap_ms` | `30000` | 等待時間上限 |
51
- | `max_attempts` | `5` | 最大重試次數 |
52
- | `jitter_ratio` | `0.5` | ±50% 抖動 |
53
-
54
- **理由**:
55
- - Exponential 隨重試次數指數退避,避免短時間大量請求
56
- - Jitter ±50% 避免 thundering herd(所有 client 同時重試)
57
- - cap_ms=30s 避免超長等待,與典型 request timeout 對齊
58
-
59
- ---
36
+ | `base_ms` | 100 | 基礎退避時間 |
37
+ | `cap_ms` | 30000 | 單次最長等待上限 |
38
+ | `max_attempts` | 5 | 最多重試次數(不含第 0 次原始呼叫)|
39
+ | `jitter_ratio` | 0.5 | Jitter 比例(±50%)|
60
40
 
61
41
  ## 依 failure-source 的重試規則
62
42
 
63
- | 失敗來源 | 可重試 | max_attempts | base_ms | 備註 |
64
- |---------|--------|-------------|---------|------|
65
- | `transient_network` | ✅ | 5 | 100 | 短暫網路抖動,指數退避通常可恢復 |
66
- | `rate_limit` | ✅ | 3 | 1000 | 底數加大預留額度恢復時間;優先採用 Retry-After header |
67
- | `upstream_unavailable` | ✅ | 3 | 500 | 重試前先查 circuit-breaker |
68
- | `tool_failure` | ✅ | 2 | 200 | 工具層失敗通常非 transient,僅給 2 次機會 |
69
- | `prompt_delivery` | ✅ | 2 | 100 | 超過 2 次改走 model_switch |
70
- | `authentication` | ❌ | — | — | fail-fast;憑證錯誤重試不會變對 |
71
- | `validation` | ❌ | — | — | fail-fast;input 錯誤重試結果不變 |
72
- | `policy_violation` | ❌ | — | — | fail-fast;安全決策禁止繞過 |
73
- | `quota_exhausted` | ❌ | — | — | fail-fast;等 budget reset 或升級 tier |
74
-
75
- ---
76
-
77
- ## 與 circuit-breaker 整合
78
-
79
- | 規則 | 說明 |
80
- |------|------|
81
- | Rule 1 | 每次重試前檢查對應 breaker 的 state;若為 OPEN 立即回傳 `CircuitOpenError`,不消耗 `max_attempts` |
82
- | Rule 2 | 重試全部耗盡(`retry_exhausted`)計入 breaker 的 failure count |
83
- | Rule 3 | HALF_OPEN 狀態下僅允許 1 次探針重試,不套用 `max_attempts` |
43
+ | 失敗來源 | 可重試? | Max Attempts | Base ms | 備註 |
44
+ |----------|----------|--------------|---------|------|
45
+ | `transient_network` | 是 | 5 | 100 | 短暫網路抖動 |
46
+ | `rate_limit` | 是 | 3 | 1000 | 依 `Retry-After` 優先 |
47
+ | `upstream_unavailable` | 是 | 3 | 500 | 連續失敗觸發 breaker OPEN |
48
+ | `tool_failure` | 是 | 2 | 200 | 工具層失敗多半非 transient |
49
+ | `prompt_delivery` | 是 | 2 | 100 | 超過改走 model_switch |
50
+ | `authentication` | **否** | — | — | Fail-fast,重試不會變對 |
51
+ | `validation` | **否** | — | — | Fail-fast,input 錯不改 |
52
+ | `policy_violation` | **否** | — | — | Fail-fast,禁止繞過 |
53
+ | `quota_exhausted` | **否** | — | — | Fail-fast,等 reset |
84
54
 
85
- ---
86
-
87
- ## 遙測事件
88
-
89
- **`retry_attempted`**(每次重試前上傳,第 0 次原始呼叫不算)
90
-
91
- | 欄位 | 類型 |
92
- |------|------|
93
- | `operation` | `string` |
94
- | `attempt` | `number` |
95
- | `max_attempts` | `number` |
96
- | `failure_source` | `FailureSource \| null` |
97
- | `wait_ms` | `number` |
98
-
99
- **`retry_exhausted`**(達到 max_attempts 仍失敗時上傳)
100
-
101
- | 欄位 | 類型 |
102
- |------|------|
103
- | `operation` | `string` |
104
- | `attempts` | `number` |
105
- | `final_failure_source` | `FailureSource` |
106
-
107
- ---
55
+ ## 使用範例
108
56
 
109
- ## 情境範例
110
-
111
- **情境 1:指數退避計算**
112
- - 條件:呼叫下游 API 失敗,failure_source=transient_network,已重試 2 次
113
- - 第 3 次重試等待時間:`min(30000, 100 * 2^3) * [0.5..1.0] = 400~800ms`
114
-
115
- **情境 2:authentication fail-fast**
116
- - 條件:API 回傳 401,failure_source=authentication
117
- - 結果:立即 fail-fast,不進入退避,不計入 circuit-breaker failure count
118
-
119
- **情境 3:circuit OPEN 跳過重試**
120
- - 條件:對應 breaker 為 OPEN,cooldown 剩 15s
121
- - 結果:立即回傳 CircuitOpenError,不消耗 max_attempts
122
-
123
- ---
57
+ - **情境 1 — 指數退避**:`failure_source=transient_network`,已重試 2 次。第 3 次 wait 範圍 = `min(30000, 100 * 2^3) * [0.5..1.0] = 400~800ms`
58
+ - **情境 2 — 401 Fail-fast**:API 回 401 Unauthorized,`failure_source=authentication`。立即 fail-fast,不進退避、不計入 breaker failure count
59
+ - **情境 3 — Circuit Open 跳過**:breaker 為 OPEN,發起重試時立即回 `CircuitOpenError`,不消耗 `max_attempts`
124
60
 
125
61
  ## 錯誤碼
126
62
 
127
- | 代碼 | 說明 |
128
- |------|------|
129
- | `RETRY-001` | `RETRY_EXHAUSTED` — 達到 max_attempts 仍失敗 |
130
- | `RETRY-002` | `RETRY_SKIPPED_NON_RETRYABLE` — failure_source 屬 fail-fast 類別 |
131
- | `RETRY-003` | `RETRY_SKIPPED_CIRCUIT_OPEN` — breaker OPEN 狀態下跳過重試 |
63
+ - `RETRY-001` — `RETRY_EXHAUSTED`(達到 max_attempts 仍失敗)
64
+ - `RETRY-002` — `RETRY_SKIPPED_NON_RETRYABLE`(failureSource 屬 fail-fast 類別)
65
+ - `RETRY-003` — `RETRY_SKIPPED_CIRCUIT_OPEN`(breaker OPEN 狀態下跳過)
132
66
 
133
- ---
67
+ ## 參考資料
68
+
69
+ - AI 最佳化版本:[ai/standards/retry-standards.ai.yaml](../../../ai/standards/retry-standards.ai.yaml)
70
+ - XSPEC-067:DEC-043 Wave 1 Reliability Pack 跨專案規格
71
+ - DEC-043:UDS 覆蓋完整性路線圖(驅動來源)
72
+ - 相關:`circuit-breaker`、`failure-source-taxonomy`、`timeout-standards`、`recovery-recipe-registry`
73
+ - 業界參考:Netflix Hystrix retry、Google SRE Book Ch.22、AWS Architecture Blog — exponential backoff and jitter
134
74
 
135
- ## 相關標準
136
75
 
137
- - [circuit-breaker.md](circuit-breaker.md) — OPEN 狀態下禁止重試
138
- - [failure-source-taxonomy.md](failure-source-taxonomy.md) — 依 failureSource 決定 retry/fail-fast
139
- - [timeout-standards.md](timeout-standards.md) — 單次重試 timeout 不得超過剩餘 deadline
140
- - [recovery-recipe-registry.md](recovery-recipe-registry.md) — retry 耗盡後交棒給 recovery recipe
76
+ **Scope**: universal
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/reverse-engineering-standards.md
3
3
  source_version: 1.3.0
4
4
  translation_version: 1.3.0
5
- last_synced: 2026-08-20
5
+ last_synced: 2026-10-11
6
+ source_hash: 5d4bb821ae35
6
7
  status: current
7
8
  ---
8
9
 
@@ -11,6 +12,8 @@ status: current
11
12
  **版本**: 1.3.0
12
13
  **最後更新**: 2026-08-20
13
14
  **適用範圍**: 所有需要將程式碼轉換為規格文件的專案
15
+ **範疇**: uds-specific
16
+ **產業標準**: IEEE 830-1998、SWEBOK v4.0 第 9 章
14
17
 
15
18
  > **語言**: [English](../../../core/reverse-engineering-standards.md) | [繁體中文](reverse-engineering-standards.md)
16
19
 
@@ -516,6 +519,7 @@ Feature: 購物車
516
519
  - [測試驅動開發](test-driven-development.md) - 紅-綠-重構循環
517
520
  - [驗收測試驅動開發](../../../core/acceptance-test-driven-development.md) - 驗收條件
518
521
  - [程式碼審查清單](code-review-checklist.md) - 審查指南
522
+ - [測試完整性維度](test-completeness-dimensions.md) - 維度 4(權限驗證)點名了跨租戶測試;授權範圍擷取則是決定你需要哪些此類測試的探索步驟
519
523
 
520
524
  ---
521
525
 
@@ -2,53 +2,204 @@
2
2
  source: ../../../core/runbook-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: 1edd254d08d6
6
7
  status: current
7
8
  ---
8
9
 
9
10
  # Runbook 標準
10
11
 
11
- > 版本: 1.0.0 | 最後更新: 2026-04-01
12
+ > **語言**: [English](../../../core/runbook-standards.md) | 繁體中文
13
+
14
+ **版本**:1.0.0
15
+ **最後更新**:2026-03-31
16
+ **適用範圍**:所有具備正式環境服務的軟體專案
17
+ **範圍**:通用
18
+ **業界標準**:PagerDuty Runbook Best Practices、Google SRE
19
+ **參考資料**:[PagerDuty](https://www.pagerduty.com/)、[sre.google](https://sre.google/)
20
+
21
+ ---
12
22
 
13
23
  ## 概述
14
24
 
15
- 本文件定義 Runbook(操作程序)的撰寫、組織、維護和驗證標準。Runbook 是一組有文件記錄的步驟,供操作人員遵循以診斷和解決特定問題或執行例行操作。
25
+ 本文件定義 Runbook(維運操作程序)的撰寫、組織、維護與驗證標準。Runbook 是一套有文件記錄的步驟,供操作人員遵循以診斷並解決特定問題,或執行例行維運操作。
16
26
 
17
27
  ---
18
28
 
19
29
  ## Runbook 類型
20
30
 
21
- | 類型 | 用途 | 範例 | 觸發方式 |
31
+ | 類型 | 用途 | 範例 | 觸發條件 |
22
32
  |------|------|------|---------|
23
33
  | **告警回應** | 診斷並修復特定告警 | `api-latency-high.md` | 告警觸發 |
24
- | **標準操作** | 例行操作程序 | `database-backup-restore.md` | 排程或依需求 |
34
+ | **標準操作** | 例行維運程序 | `database-backup-restore.md` | 排程或依需求 |
25
35
  | **緊急程序** | 重大事件快速回應 | `full-service-outage.md` | SEV-1 事件 |
26
- | **變更程序** | 計畫性變更執行步驟 | `database-migration.md` | 變更窗口 |
36
+ | **變更程序** | 計畫性變更執行步驟 | `database-migration.md` | 變更時段 |
27
37
  | **故障排除指南** | 一般問題調查方法 | `memory-leak.md` | 臨時調查 |
28
38
 
29
39
  ---
30
40
 
31
41
  ## 標準範本
32
42
 
33
- 每個 Runbook 必須包含以下 7 個章節:
43
+ ### 必要章節
44
+
45
+ 每個 Runbook 都必須包含以下 7 個章節:
46
+
47
+ ```markdown
48
+ # Runbook: [Problem Name]
49
+
50
+ ## Overview
51
+ - **Alert Name**: [alert name or N/A]
52
+ - **Severity**: P1/P2/P3/P4
53
+ - **Related Services**: [service names]
54
+ - **Last Updated**: YYYY-MM-DD
55
+ - **Owner**: @owner
56
+ - **Last Drilled**: YYYY-MM-DD
57
+
58
+ ## Symptoms
59
+ [What does the user see? How does the system behave?]
60
+ - [Observable symptom 1]
61
+ - [Observable symptom 2]
62
+
63
+ ## Impact Assessment
64
+ - **Affected users**: [scope]
65
+ - **Business impact**: [revenue, reputation, compliance]
66
+ - **Upstream/downstream effects**: [cascading impact]
67
+
68
+ ## Diagnostic Steps
69
+ 1. **Check [component]**
70
+ ```bash
71
+ # Specific command to run
72
+ kubectl get pods -n production | grep payment
73
+ ```
74
+ Expected output: [what to look for]
75
+
76
+ 2. **Verify [metric]**
77
+ Dashboard: [link]
78
+ Normal range: [X-Y]
79
+
80
+ 3. **Determine root cause**
81
+ - If [condition A] → go to Fix Steps: Scenario A
82
+ - If [condition B] → go to Fix Steps: Scenario B
34
83
 
35
- 1. **Overview** — 告警名稱、嚴重度、相關服務、擁有者、最後演練日期
36
- 2. **Symptoms** — 使用者看到什麼?系統如何表現?
37
- 3. **Impact Assessment** — 受影響使用者、業務影響、上下游效應
38
- 4. **Diagnostic Steps** — 帶有具體指令的編號步驟
39
- 5. **Fix Steps** — 按根因分場景的修復步驟,每步驟後驗證
40
- 6. **Escalation** — 具體聯繫人與條件
41
- 7. **Post-Actions** — 事後檢查清單
84
+ ## Fix Steps
85
+ ### Scenario A: [Root Cause A]
86
+ 1. [Step with specific command]
87
+ ```bash
88
+ kubectl rollout restart deployment/payment-service -n production
89
+ ```
90
+ 2. **Verify fix**: [how to confirm it worked]
91
+ ```bash
92
+ curl -s https://api.example.com/health | jq .status
93
+ ```
94
+ Expected: `"healthy"`
95
+ 3. **Estimated time**: 2-5 minutes
96
+
97
+ ### Scenario B: [Root Cause B]
98
+ 1. [Alternative fix steps]
99
+
100
+ ## Escalation
101
+ - If above steps don't resolve within [time]:
102
+ - Contact: [team/person] via [channel]
103
+ - Escalation phone: [number]
104
+ - Backup contact: [person]
105
+
106
+ ## Post-Actions
107
+ - [ ] Update this runbook if new information found
108
+ - [ ] Create postmortem if P1/P2 (see [Postmortem Standards](postmortem-standards.md))
109
+ - [ ] Notify stakeholders via [channel]
110
+ - [ ] Record incident metrics (MTTD, MTTR)
111
+ ```
112
+
113
+ ### 選填章節
114
+
115
+ | 章節 | 何時納入 |
116
+ |------|---------|
117
+ | **Prerequisites** | 需要特殊存取權限或工具時 |
118
+ | **Rollback Steps** | 修復步驟具有副作用時 |
119
+ | **Related Runbooks** | 問題經常同時發生時 |
120
+ | **Changelog** | 適用於頻繁更新的 Runbook |
42
121
 
43
122
  ---
44
123
 
45
- ## 命名慣例
124
+ ## 撰寫品質指引
125
+
126
+ ### 六大原則
127
+
128
+ 撰寫在壓力下依然有效的 Runbook —— 當值班工程師在凌晨 3 點感到疲憊、面臨壓力時:
46
129
 
47
- 使用 kebab-case 檔名,描述**問題**而非解決方案:
130
+ | 原則 | 說明 | 良好範例 | 不良範例 |
131
+ |------|------|---------|---------|
132
+ | **可重現** | 步驟具體明確,可直接複製貼上並執行 | `kubectl rollout restart deployment/payment-service -n production` | 「重啟付款服務」 |
133
+ | **明確無歧義** | 每個步驟都只有唯一一種解讀方式 | 「重啟 `production` 命名空間中的 `payment-service` Pod」 | 「重啟服務」 |
134
+ | **決策點** | 分支條件明確且具備清楚的判定標準 | 「若 CPU > 90%,執行方案 A;否則執行方案 B」 | 「若伺服器看起來負載過重……」 |
135
+ | **回滾** | 修復步驟若失敗備有後備計畫 | 「若復原失敗,執行緊急程序:full-service-outage.md」 | (未提及回滾) |
136
+ | **驗證** | 每個修復步驟都有確認成功的方法 | 「執行 `curl health-check` 並驗證 HTTP 200 回應」 | 「確認其運作正常」 |
137
+ | **時限性** | 註明預期完成時間 | 「此步驟通常耗時 2-5 分鐘」 | (無預估時間) |
48
138
 
49
- - `api-latency-high.md` — 描述問題
50
- - `disk-space-low.md` — 描述問題
51
- - ~~`restart-api-server.md`~~ — 描述的是解決方案,不恰當
139
+ ### 常見反模式
140
+
141
+ | 反模式 | 問題 | 改善方式 |
142
+ |--------|------|---------|
143
+ | 「聯繫團隊」 | 哪個團隊?哪個頻道? | 指名具體的人員與頻道 |
144
+ | 「檢查日誌」 | 哪些日誌?何處?要搜尋什麼? | 提供精確的日誌查詢語句 |
145
+ | 「必要時擴展」 | 何時才算必要?擴展到多少? | 定義明確的門檻值與目標 |
146
+ | 過時指令 | 指令引用了已移除的服務 | 建立定期審查週期 |
147
+
148
+ ---
149
+
150
+ ## 組織與存放
151
+
152
+ ### 目錄結構
153
+
154
+ ```
155
+ docs/runbooks/
156
+ ├── README.md # Index and search guide
157
+ ├── alerts/ # Alert Response runbooks
158
+ │ ├── api-latency-high.md
159
+ │ ├── disk-space-low.md
160
+ │ └── database-connection-pool.md
161
+ ├── operations/ # Standard Operation runbooks
162
+ │ ├── database-backup-restore.md
163
+ │ └── secret-rotation.md
164
+ ├── emergency/ # Emergency Procedure runbooks
165
+ │ ├── full-service-outage.md
166
+ │ └── data-breach-response.md
167
+ ├── changes/ # Change Procedure runbooks
168
+ │ ├── database-migration.md
169
+ │ └── major-version-upgrade.md
170
+ └── troubleshooting/ # Troubleshooting Guide runbooks
171
+ ├── memory-leak.md
172
+ └── performance-degradation.md
173
+ ```
174
+
175
+ ### 命名慣例
176
+
177
+ 使用描述**問題**而非解決方案的 kebab-case 檔名:
178
+
179
+ - ✅ `api-latency-high.md` — 描述問題
180
+ - ✅ `disk-space-low.md` — 描述問題
181
+ - ✅ `database-connection-pool.md` — 描述問題領域
182
+ - ❌ `restart-api-server.md` — 描述的是解決方案,而非問題
183
+ - ❌ `runbook-001.md` — 無意義的流水號
184
+ - ❌ `RUNBOOK_API.md` — 錯誤的大小寫慣例
185
+
186
+ ### 索引
187
+
188
+ 在 runbooks 目錄中維護一份 `README.md` 索引:
189
+
190
+ ```markdown
191
+ # Runbooks Index
192
+
193
+ ## Alert Response
194
+ | Runbook | Severity | Services | Last Updated |
195
+ |---------|----------|----------|-------------|
196
+ | [API Latency High](alerts/api-latency-high.md) | P2 | api-gateway | 2026-03-15 |
197
+
198
+ ## Emergency Procedures
199
+ | Runbook | Services | Last Updated |
200
+ |---------|----------|-------------|
201
+ | [Full Service Outage](emergency/full-service-outage.md) | all | 2026-03-01 |
202
+ ```
52
203
 
53
204
  ---
54
205
 
@@ -56,13 +207,112 @@ status: current
56
207
 
57
208
  ### 審查週期
58
209
 
210
+ 每種 Runbook 類型都有強制性的審查週期:
211
+
59
212
  | 類型 | 審查週期 | 審查者 |
60
- |------|---------|--------|
213
+ |------|-------------|----------|
61
214
  | 告警回應 | 每季(每 3 個月) | 值班團隊 |
62
215
  | 緊急程序 | 每月 | 工程主管 |
63
- | 標準操作 | 每半年 | 維運團隊 |
216
+ | 標準操作 | 每半年(每 6 個月) | 維運團隊 |
64
217
  | 變更程序 | 每次使用後 | 變更執行者 |
65
- | 故障排除指南 | 每半年 | 領域專家 |
218
+ | 故障排除指南 | 每半年(每 6 個月) | 領域專家 |
219
+
220
+ ### 過期偵測
221
+
222
+ 當符合以下條件時,Runbook 會被視為**過期**(stale):
223
+ - `Last Updated` 日期超過其類型的審查週期
224
+ - Runbook 未在其演練週期內完成演練
225
+
226
+ 過期的 Runbook 應(SHOULD)在索引中標記為 ⚠️ 並優先進行審查。
227
+
228
+ ### 架構變更觸發條件
229
+
230
+ 當發生以下任何變更時,必須(MUST)審查相關的 Runbook:
231
+
232
+ | 變更類型 | 受影響的 Runbook |
233
+ |-------------|------------------|
234
+ | 服務拆分/合併 | 所有引用該服務的 Runbook |
235
+ | 資料庫遷移 | 資料庫相關的 Runbook |
236
+ | 基礎設施變更(雲端區域、提供商) | 所有緊急 + 操作 Runbook |
237
+ | 監控/告警工具變更 | 所有告警回應 Runbook |
238
+ | 團隊重組 | 所有 Runbook 的 Escalation 章節 |
239
+
240
+ ---
241
+
242
+ ## 演練程序
243
+
244
+ ### 排程
245
+
246
+ | 優先級 | 條件 | 演練頻率 |
247
+ |----------|-----------|-----------------|
248
+ | 最高 | P1 告警 Runbook | 每月 |
249
+ | 高 | P2 告警 Runbook | 每季 |
250
+ | 中 | 緊急程序 | 每季 |
251
+ | 低 | 其他 Runbook | 每半年 |
252
+
253
+ ### 記錄
254
+
255
+ 每次演練後,記錄結果:
256
+
257
+ ```markdown
258
+ ## Drill Record: [Runbook Name]
259
+
260
+ - **Date**: YYYY-MM-DD
261
+ - **Participants**: @name1, @name2
262
+ - **Runbook**: [link]
263
+ - **Result**: ✅ Pass / ⚠️ Partial Pass / ❌ Fail
264
+ - **Estimated Repair Time**: X minutes (per runbook)
265
+ - **Actual Repair Time**: Y minutes (during drill)
266
+ - **Issues Found**:
267
+ - [Issue 1: description]
268
+ - [Issue 2: description]
269
+ - **Runbook Updates Required**:
270
+ - [ ] [Update description]
271
+ ```
272
+
273
+ ### 失敗處理
274
+
275
+ 當演練顯示 Runbook 步驟無法執行時:
276
+
277
+ 1. **立即**將 Runbook 標記為需要更新
278
+ 2. 建立指派擁有者與截止日期的行動項目
279
+ 3. 套用更新後重新演練
280
+ 4. 在重新演練通過之前,不要將該 Runbook 視為有效
281
+
282
+ ---
283
+
284
+ ## 整合點
285
+
286
+ ### 告警與 Runbook 連結
287
+
288
+ 每個告警規則應(SHOULD)包含 `runbook_url` 註解:
289
+
290
+ ```yaml
291
+ annotations:
292
+ runbook_url: "https://wiki.example.com/runbooks/alerts/api-latency-high"
293
+ ```
294
+
295
+ 當告警觸發時,通知會自動包含 Runbook 連結。
296
+
297
+ ### 事後檢討至 Runbook 流程
298
+
299
+ 在事後檢討(參見 [Postmortem 標準](postmortem-standards.md))之後:
300
+ - 若事件揭露既有 Runbook 中的缺口 → 更新 Runbook
301
+ - 若事件屬於新的故障模式 → 建立新的 Runbook
302
+ - 將事後檢討連結至 Runbook 的變更日誌
303
+
304
+ ### 覆蓋率報告
305
+
306
+ 定期產生 Runbook 覆蓋率報告:
307
+
308
+ | 告警層級 | 告警總數 | 具備 Runbook | 覆蓋率 | 目標 |
309
+ |-------------|-------------|-------------|---------|--------|
310
+ | P1/P2 | N | N | 100% | 100% |
311
+ | P3/P4 | N | N | X% | > 80% |
312
+
313
+ **沒有 Runbook 的告警**(需要採取行動):
314
+ - `[P2] database-replication-lag` — 需要 Runbook
315
+ - `[P3] disk-io-high` — 需要 Runbook
66
316
 
67
317
  ---
68
318
 
@@ -84,7 +334,30 @@ status: current
84
334
 
85
335
  ---
86
336
 
337
+ ## 參考資料
338
+
339
+ - [PagerDuty Runbook Authoring Guide](https://www.pagerduty.com/) — Runbook 撰寫的業界最佳實踐
340
+ - [Google SRE — Managing Incidents](https://sre.google/sre-book/managing-incidents/) — 事件管理背景
341
+ - [Incident.io — Runbook Best Practices](https://incident.io/) — 現代 Runbook 模式
342
+
343
+ ---
344
+
87
345
  **相關標準:**
88
346
  - [告警標準](alerting-standards.md) — 告警設計與 Runbook 連結要求
89
- - [Postmortem 標準](postmortem-standards.md) — 事後檢討與行動項目
347
+ - [Postmortem 標準](postmortem-standards.md) — 事件後審查與行動項目
348
+ - [日誌標準](logging-standards.md) — 用於診斷的結構化日誌
90
349
  - [可觀測性標準](observability-standards.md) — 監控與儀表板
350
+
351
+ ---
352
+
353
+ ## 版本歷史
354
+
355
+ | 版本 | 日期 | 變更 |
356
+ |---------|------|---------|
357
+ | 1.0.0 | 2026-03-31 | 初始發布:範本、類型、有效性、演練、整合 |
358
+
359
+ ---
360
+
361
+ ## 授權條款
362
+
363
+ 本標準依據 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 發布。
@@ -1,9 +1,9 @@
1
1
  ---
2
2
  source: ../../../core/secret-management-standards.md
3
- source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-07-30
6
- source_hash: d8efae1ed265
3
+ source_version: 1.1.0
4
+ translation_version: 1.1.0
5
+ last_synced: 2026-10-12
6
+ source_hash: 0d663eb39b8a
7
7
  status: current
8
8
  ---
9
9
 
@@ -65,6 +65,12 @@ staged 檔案,偵測到 pattern 即封鎖 commit;(2) **CI 管線掃描**—
65
65
  (`AKIA[0-9A-Z]{16}`)、PEM 私鑰標頭(`-----BEGIN .* PRIVATE KEY`)、通用 API token
66
66
  pattern(`api[_-]?key\s*[:=]\s*\S{16,}`),以及含密碼的連線字串。
67
67
 
68
+ 掃描器如何執行由 [`pipeline-security-gates`](./pipeline-security-gates.md) 規範,其中三條規則適用於本需求要求的每個
69
+ 掃描器:**PSG-1**——掃描輸出(終端機、CI 紀錄、報告檔)MUST NOT 包含被匹配到的機密值本身,只能指出檔案、行號與規則名稱;
70
+ **PSG-2**——無法執行的掃描器(未安裝、崩潰、規則無法取得)視同閘門失敗,MUST 阻斷 commit 或 pipeline,不得放行;
71
+ **PSG-3**——團隊自己撰寫的每條偵測規則 SHOULD 有一個必須被抓到(紅)與一個不得被誤報(綠)的樣本,並在測試中執行。
72
+ 上述四種最低 pattern 即是團隊自寫規則時 PSG-3 所適用的規則。
73
+
68
74
  ### REQ-004 — 機密注入
69
75
 
70
76
  機密 MUST 僅透過環境變數或掛載檔案注入應用程式程序。透過命令列參數傳遞機密為
@@ -85,6 +91,7 @@ volume,並使用限制性檔案權限(0400 或 0600)。
85
91
 
86
92
  - **`iac-design-principles`**——機密後端(Vault/KMS 狀態)本身即是版本化、受存取
87
93
  控制的基礎設施。
94
+ - **`pipeline-security-gates`**——PSG-1~PSG-3 規範 REQ-003 掃描器的執行方式(輸出不含機密值、掃描器跑不起來即阻斷、自寫規則要有紅綠樣本);兩份標準互相指向。
88
95
  - **`audit-trail`**——輪替、存取與注入事件為可稽核操作(REQ-002 要求記錄輪替事件)。
89
96
  - **`pii-classification`**——守護 TIER-1 PII 的憑證承襲最嚴格的處理控制。
90
97
  - **`security-standards`**——本標準是更廣安全基線的憑證衛生面向。
@@ -98,4 +105,5 @@ volume,並使用限制性檔案權限(0400 或 0600)。
98
105
 
99
106
  | 版本 | 日期 | 變更 |
100
107
  |------|------|------|
108
+ | v1.1.0 | 2026-10-12 | REQ-003 指向 `pipeline-security-gates` 的 PSG-1~PSG-3(掃描器的執行方式);整合章節列出交叉引用(XSPEC-475 OQ3) |
101
109
  | v1.0.0 | 2026-06-17 | 初版——REQ-001~004:機密來源選項、輪替政策、硬編碼機密防護、機密注入(XSPEC-065) |