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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (712) 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 +2312 -1102
  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 +2291 -1110
  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 +77 -7
  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-split.js +2 -1
  675. package/src/commands/spec.js +11 -2
  676. package/src/commands/update.js +184 -30
  677. package/src/compilers/claude-code-compiler.js +9 -1
  678. package/src/config/ai-agent-paths.js +14 -1
  679. package/src/core/installed-formats.js +15 -0
  680. package/src/core/open-work-config.js +20 -1
  681. package/src/core/project-config.js +55 -0
  682. package/src/i18n/messages.js +160 -2
  683. package/src/installers/hooks-installer.js +1 -1
  684. package/src/installers/manifest-installer.js +1 -1
  685. package/src/installers/skills-installer.js +1 -1
  686. package/src/installers/standards-installer.js +3 -1
  687. package/src/mcp/server.js +9 -3
  688. package/src/prompts/init.js +26 -22
  689. package/src/reconciler/actual-state-scanner.js +2 -8
  690. package/src/reconciler/backup-locations.js +5 -0
  691. package/src/reconciler/backup-manager.js +19 -11
  692. package/src/reconciler/desired-state-calculator.js +89 -57
  693. package/src/reconciler/plan-executor.js +101 -8
  694. package/src/reconciler/recorded-versions.js +49 -0
  695. package/src/reconciler/relative-path.js +23 -0
  696. package/src/uninstallers/hook-uninstaller.js +9 -1
  697. package/src/uninstallers/skills-uninstaller.js +22 -3
  698. package/src/utils/available-standards-report.js +25 -4
  699. package/src/utils/available-standards.js +13 -3
  700. package/src/utils/build-manifest.js +1 -1
  701. package/src/utils/commit-message-judge.js +60 -13
  702. package/src/utils/friction-detector.js +23 -11
  703. package/src/utils/git-hooks.js +106 -4
  704. package/src/utils/integration-generator.js +95 -67
  705. package/src/utils/legacy-hook-migration.js +121 -2
  706. package/src/utils/open-work-tracking.mjs +105 -16
  707. package/src/utils/sdd-header.js +16 -4
  708. package/src/utils/skills-installer.js +2 -1
  709. package/src/utils/spinner.js +14 -4
  710. package/src/utils/standard-validator.js +3 -2
  711. package/standards-registry.json +10 -8
  712. package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
@@ -2,78 +2,276 @@
2
2
  source: ../../../core/alerting-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: ca900b3c312b
6
7
  status: current
7
8
  ---
8
9
 
9
10
  # 告警標準
10
11
 
11
- > 版本: 1.0.0 | 最後更新: 2026-04-01
12
+ > **語言**: [English](../../../core/alerting-standards.md) | 繁體中文
13
+
14
+ **版本**:1.0.0
15
+ **最後更新**:2026-03-31
16
+ **適用範圍**:所有具備生產環境服務的軟體專案
17
+ **範疇**:通用
18
+ **業界標準**:Google SRE, PagerDuty Best Practices
19
+ **參考資料**:[sre.google](https://sre.google/), [PagerDuty](https://www.pagerduty.com/)
20
+
21
+ ---
12
22
 
13
23
  ## 概述
14
24
 
15
- 本文件定義生產環境告警的設計、分類、路由和維護標準。有效的告警是可觀測性資料與人工行動之間的橋樑 — 每個告警都應該是可操作的、具有適當的緊急程度,並連結到解決路徑。
25
+ 本文件定義生產環境告警的設計、分類、路由與維護標準。有效的告警是可觀測性資料與人工行動之間的橋樑——每個告警都應該具備可操作性、適當的緊急程度,並連結至解決路徑。
16
26
 
17
27
  ---
18
28
 
19
29
  ## 告警嚴重度分類(P1-P4)
20
30
 
21
- | 等級 | 名稱 | 標準 | 回應時間 | 通知管道 |
22
- |------|------|------|---------|---------|
23
- | **P1** | 關鍵 | 完全服務中斷;資料遺失風險;安全漏洞 | < 5 分鐘 | 電話 + SMS + Chat |
24
- | **P2** | 高 | 主要功能降級;部分中斷;大量使用者影響 | < 15 分鐘 | SMS + Chat |
25
- | **P3** | 警告 | 效能降級;資源接近上限;次要功能受影響 | < 4 小時 | Chat + Ticket |
26
- | **P4** | 資訊 | 異常趨勢;預防性通知;非緊急維護 | 下個工作日 | Email + Ticket |
31
+ ### 嚴重度定義
32
+
33
+ | 等級 | 名稱 | 判定標準 | 回應時間 | 通知管道 |
34
+ |-------|------|----------|---------------|----------------------|
35
+ | **P1** | 關鍵 (Critical) | 完全服務中斷;資料遺失風險;安全性漏洞 | < 5 分鐘 | 電話 + SMS + Chat |
36
+ | **P2** | 高 (High) | 主要功能降級;部分中斷;大量使用者受影響 | < 15 分鐘 | SMS + Chat |
37
+ | **P3** | 警告 (Warning) | 效能降級;資源接近上限;次要功能受影響 | < 4 小時 | Chat + Ticket |
38
+ | **P4** | 資訊 (Info) | 異常趨勢;預防性通知;非緊急維護 | 下個工作日 | Email + Ticket |
39
+
40
+ ### 嚴重度決策樹
41
+
42
+ 使用此決策樹來判斷適當的嚴重度:
43
+
44
+ ```
45
+ Is the user completely unable to use the service?
46
+ ├─ Yes → P1 (Critical)
47
+ └─ No
48
+ ├─ Is a major feature affected with no workaround?
49
+ │ ├─ Yes → P2 (High)
50
+ │ └─ No
51
+ │ ├─ Is performance degraded but service still usable?
52
+ │ │ ├─ Yes → P3 (Warning)
53
+ │ │ └─ No → P4 (Info)
54
+ └─ Is there data loss or security risk?
55
+ └─ Yes → P1 (Critical)
56
+ ```
27
57
 
28
58
  ---
29
59
 
30
60
  ## 升級路徑
31
61
 
62
+ ### 升級矩陣範本
63
+
64
+ 為每個嚴重度等級定義升級層級:
65
+
32
66
  | 時間 | P1(關鍵) | P2(高) | P3(警告) |
33
- |------|-----------|---------|-----------|
34
- | 0 分鐘 | 值班工程師 | 值班工程師 | — |
35
- | 5 分鐘(未確認) | 值班主管 | — | — |
36
- | 15 分鐘(未確認) | 工程經理 | 值班主管 | 值班工程師 |
67
+ |------|---------------|-----------|---------------|
68
+ | 0 分鐘 | 值班工程師 (On-call Engineer) | 值班工程師 | — |
69
+ | 5 分鐘(未確認) | 值班主管 (On-call Lead) | — | — |
70
+ | 15 分鐘(未確認) | 工程經理 (Engineering Manager) | 值班主管 | 值班工程師 |
37
71
  | 30 分鐘(未解決) | VP Engineering | 工程經理 | — |
38
- | 60 分鐘(未解決) | CTO/高管 | VP Engineering | 值班主管 |
72
+ | 60 分鐘(未解決) | CTO/高階主管 | VP Engineering | 值班主管 |
73
+
74
+ ### 自動升級規則
75
+
76
+ - P1 告警若未在 **5 分鐘** 內確認,將自動升級
77
+ - P2 告警若未在 **15 分鐘** 內確認,將自動升級
78
+ - P3 告警若未在 **4 小時** 內確認,將自動升級
79
+ - 自動升級通知包含原始告警上下文以及已過時間
39
80
 
40
81
  ---
41
82
 
42
83
  ## 可操作告警設計
43
84
 
44
- 每個告警通知必須包含 6 個要素:
85
+ ### 必要告警要素
86
+
87
+ 每個告警通知必須包含以下 6 個要素:
88
+
89
+ | 要素 | 說明 | 範例 |
90
+ |---------|-------------|---------|
91
+ | **標題** | 包含嚴重度的簡明問題描述 | `[P2] API Latency Exceeds SLO Threshold` |
92
+ | **影響** | 受影響的服務與範圍 | `payment-service, affecting 30% of users` |
93
+ | **目前狀態** | 關鍵指標目前數值與閾值比較 | `P99 latency: 2.3s (SLO: < 500ms)` |
94
+ | **Runbook 連結** | 對應解決步驟的連結 | `[Runbook: API Latency High](link)` |
95
+ | **Dashboard 連結** | 相關監控儀表板的連結 | `[Dashboard](link)` |
96
+ | **開始時間** | 問題何時開始 | `2026-03-31 10:15 UTC` |
97
+
98
+ ### 告警訊息範本
99
+
100
+ ```
101
+ [P{severity}] {alert_name}
102
+
103
+ Impact: {service_name}, affecting {scope}
104
+ Status: {metric_name}: {current_value} (threshold: {threshold})
105
+ Started: {start_time} ({duration} ago)
106
+
107
+ Runbook: {runbook_url}
108
+ Dashboard: {dashboard_url}
109
+ ```
45
110
 
46
- 1. **What** — 發生了什麼(清晰描述性標題)
47
- 2. **When** — 問題何時開始
48
- 3. **Where** — 受影響的服務/元件
49
- 4. **Impact** — 使用者影響與嚴重度
50
- 5. **Dashboard** — 相關儀表板連結
51
- 6. **Runbook** — 處理程序連結(P1/P2 必須)
111
+ ### Runbook 連結要求
112
+
113
+ | 告警等級 | Runbook 要求 |
114
+ |-------------|-------------------|
115
+ | P1 | 必須(MUST)具備 Runbook 連結 |
116
+ | P2 | 必須(MUST)具備 Runbook 連結 |
117
+ | P3 | 應當(SHOULD)具備 Runbook 連結 |
118
+ | P4 | 應當(SHOULD)具備 Runbook 連結 |
119
+
120
+ 請參閱 [Runbook 標準](runbook-standards.md) 以了解 Runbook 格式與維護。
52
121
 
53
122
  ---
54
123
 
55
124
  ## 降噪策略
56
125
 
126
+ ### 去重(Deduplication)
127
+
128
+ 在時間範圍內合併具有相同指紋(service + alert_name + labels)的告警:
129
+
130
+ - 同一告警在 5 分鐘內多次觸發 → 合併為單一通知
131
+ - 在合併通知中包含觸發次數:`"Triggered 12 times in last 5 minutes"`
132
+ - 當告警解決時重設去重時間範圍
133
+
134
+ ### 分組(Grouping)
135
+
136
+ 將來自連鎖故障的相關告警分組為單一通知:
137
+
138
+ ```yaml
139
+ # Example: Alertmanager grouping config
140
+ group_by: ['service', 'alert_name']
141
+ group_wait: 30s # Wait before sending first notification
142
+ group_interval: 5m # Wait between group updates
143
+ ```
144
+
145
+ - 根本原因告警在分組摘要中享有優先權
146
+ - 子告警在通知中列為「相關告警(related alerts)」
147
+
148
+ ### 靜音/維護時段(Suppression / Maintenance Windows)
149
+
150
+ 在已知維護期間將告警靜音:
151
+
152
+ - 定義包含開始/結束時間以及受影響服務的維護時段
153
+ - 受影響服務的所有 P3/P4 告警皆被靜音
154
+ - P1/P2 告警**絕不**靜音(安全防護覆寫機制)
155
+ - 維護時段會記錄以供稽核
156
+
157
+ ### 抑制/閾值遲滯(Dampening / Threshold Hysteresis)
158
+
159
+ 當指標在閾值附近擺盪時,防止告警頻繁擺盪(flapping):
160
+
57
161
  | 策略 | 運作方式 | 使用情境 |
58
- |------|---------|---------|
59
- | **Deduplication** | 合併相同告警 | 同一告警重複觸發 |
60
- | **Grouping** | 按根因分組 | 多個服務告警(級聯故障) |
61
- | **Suppression** | 計畫維護期間靜音 | 預定維護 |
62
- | **Dampening** | 條件持續 N 分鐘才觸發 | 指標在閾值附近波動 |
162
+ |----------|-------------|----------|
163
+ | **For-duration** | 條件持續為真達 N 分鐘時才觸發告警 | 預設策略;防止短暫突波 |
164
+ | **Hysteresis** | 觸發(90%)與解除(80%)採用不同閾值 | 自然波動的 CPU/記憶體指標 |
165
+ | **Percentage-based** | 當 X% 的執行個體超過閾值時發出告警 | 多實例服務 |
166
+
167
+ 範例:
168
+ ```yaml
169
+ # Alert fires only after 5 minutes of sustained breach
170
+ - alert: HighErrorRate
171
+ expr: error_rate > 0.05
172
+ for: 5m # Dampening: must sustain for 5 minutes
173
+ ```
63
174
 
64
175
  ---
65
176
 
66
177
  ## Alerts as Code
67
178
 
179
+ ### 版本控制要求
180
+
68
181
  所有告警規則必須:
69
- 1. **儲存於 Git** — 告警定義視為程式碼
70
- 2. **程式碼審查** — 變更需同儕審查
71
- 3. **自動測試** — CI 在合併前驗證告警規則
72
- 4. **透過 CI/CD 部署** — 告警變更走部署流程
182
+
183
+ 1. **儲存於 Git** — 告警定義即為程式碼,以同等嚴謹度對待
184
+ 2. **經過程式碼審查** — 變更在部署前必須經過同儕審查
185
+ 3. **自動化測試** — CI 在合併前驗證告警規則
186
+ 4. **透過 CI/CD 部署** — 告警變更須經由部署管線發布
187
+
188
+ ### 告警規則測試
189
+
190
+ 提交修改告警規則的 PR 時,自動化測試應當(SHOULD)驗證:
191
+
192
+ | 檢查項目 | 說明 |
193
+ |-------|-------------|
194
+ | **語法正確性** | 規則解析無誤 |
195
+ | **閾值合理性** | 數值處於合理範圍內(例如:錯誤率 0-100%) |
196
+ | **Runbook 連結有效性** | 所引用的 Runbook URL 存在且可存取 |
197
+ | **無衝突** | 新規則不與既有規則重複 |
198
+ | **標籤一致性** | 使用標準標籤名稱 |
199
+
200
+ ### CI/CD 整合
201
+
202
+ ```
203
+ PR with alert changes → Lint → Unit Test → Review → Merge → Deploy to alerting system
204
+ ```
73
205
 
74
206
  ---
75
207
 
76
- ## Quick Reference Card
208
+ ## 以 SLO 為基礎的告警(最佳實踐)
209
+
210
+ ### 多時間範圍多消耗率(Multi-Window Multi-Burn-Rate)
211
+
212
+ 已定義 SLO 服務所建議採用的告警策略:
213
+
214
+ **範例:30 天時間範圍內 99.9% 可用性 SLO**
215
+
216
+ | 時間範圍 | 消耗率(Burn Rate) | 告警等級 | 意義 |
217
+ |--------|-----------|-------------|---------|
218
+ | 1 小時 | 14.4x | P1(呼叫/Page) | 照此速率,預算將在約 2 天內耗盡 |
219
+ | 6 小時 | 6x | P2(告警/Alert) | 照此速率,預算將在約 5 天內耗盡 |
220
+ | 3 天 | 1x | P3(工單/Ticket) | 預計在月底前耗盡預算 |
221
+
222
+ **公式:**
223
+ ```
224
+ Burn Rate = (Error Rate in Window) / (1 - SLO Target)
225
+
226
+ 範例:
227
+ SLO = 99.9%, Window = 1 hour, Errors in window = 1.44%
228
+ Burn Rate = 0.0144 / 0.001 = 14.4x
229
+ ```
230
+
231
+ ### 傳統告警與以 SLO 為基礎的告警比較
232
+
233
+ | 維度 | 傳統閾值告警 | 以 SLO 為基礎的告警 |
234
+ |-----------|-------------------------------|-------------------|
235
+ | **設定依據** | 基於經驗的閾值 | 使用者體驗目標 |
236
+ | **誤報(False Positives)** | 較高(靜態閾值無法自我調整) | 較低(消耗率考量了自然波動) |
237
+ | **漏報(Missed Alerts)** | 較高(緩慢降級不易被察覺) | 較低(消耗率能捕捉緩慢消耗) |
238
+ | **維護成本** | 高(需要頻繁調校閾值) | 低(僅在 SLO 變更時才需更新) |
239
+ | **前置需求** | 無 | 必須已定義 SLO |
240
+
241
+ ---
242
+
243
+ ## 告警品質指標
244
+
245
+ ### 關鍵指標
246
+
247
+ 追蹤以下指標以持續改善告警品質:
248
+
249
+ | 指標 | 定義 | 目標 |
250
+ |--------|-----------|--------|
251
+ | **訊噪比(SNR)** | 可操作告警數 / 總告警數 | > 80% |
252
+ | **MTTA**(平均確認時間,Mean Time to Acknowledge) | 從告警觸發到人員確認的平均時間 | P1: < 5 分鐘, P2: < 15 分鐘 |
253
+ | **每人告警頻率** | 每人每天平均收到的告警數 | < 每人每天 5 次 |
254
+ | **重複率** | 30 天內重複觸發的相同告警 / 總告警數 | < 20% |
255
+ | **Runbook 覆蓋率** | 附有 Runbook 連結的告警數 / 總告警數 | P1/P2: 100%, P3/P4: > 80% |
256
+
257
+ ### 每季稽核流程
258
+
259
+ 每季檢視所有作用中的告警規則:
260
+
261
+ | 維度 | 問題 | 若為「否」採取的行動 |
262
+ |-----------|----------|----------------|
263
+ | **過去 90 天內是否曾觸發?** | 此告警是否曾觸發過至少一次? | 考慮移除或調整閾值 |
264
+ | **是否需要人員介入?** | 觸發時是否需要專人採取行動? | 考慮將回應流程自動化 |
265
+ | **是否有 Runbook?** | 是否有記載的解決路徑? | 建立 Runbook 或移除該告警 |
266
+
267
+ **其他稽核問題:**
268
+ - 嚴重度等級是否仍然恰當?
269
+ - 通知管道是否仍然正確?
270
+ - 服務架構是否有變更因而影響到此告警?
271
+
272
+ ---
273
+
274
+ ## 快速參考卡(Quick Reference Card)
77
275
 
78
276
  ### 告警設計檢查清單
79
277
  ```
@@ -87,15 +285,39 @@ status: current
87
285
 
88
286
  ### 降噪選擇
89
287
  ```
90
- 同一告警重複觸發? → Deduplication
91
- 多個服務同時告警? → Grouping(級聯故障)
92
- 計畫維護中? → Suppression
93
- 指標在閾值附近波動? → Dampening
288
+ 同一告警重複觸發? → Deduplication
289
+ 多個服務同時告警? → Grouping(級聯故障)
290
+ 計畫維護中? → Suppression
291
+ 指標在閾值附近波動? → Dampening
94
292
  ```
95
293
 
96
294
  ---
97
295
 
296
+ ## 參考資料
297
+
298
+ - [Google SRE Workbook — Alerting on SLOs](https://sre.google/workbook/alerting-on-slos/) — 多時間範圍消耗率策略
299
+ - [PagerDuty — Alert Design Principles](https://www.pagerduty.com/) — 可操作告警設計
300
+ - [Prometheus — Alerting Best Practices](https://prometheus.io/docs/practices/alerting/) — 告警規則設計模式
301
+ - [Rob Ewaschuk — My Philosophy on Alerting](https://docs.google.com/document/d/199PqyG3UsyXlwieHaqbGiWVa8eMWi8zzAn0YfcApr8Q/) — 告警的核心哲學
302
+
303
+ ---
304
+
98
305
  **相關標準:**
99
306
  - [SLO 標準](slo-standards.md) — SLI/SLO/Error Budget 定義
100
307
  - [可觀測性標準](observability-standards.md) — 指標與監控
101
308
  - [Runbook 標準](runbook-standards.md) — Runbook 格式與維護
309
+ - [日誌標準](logging-standards.md) — 基於日誌的告警模式
310
+
311
+ ---
312
+
313
+ ## 版本歷史
314
+
315
+ | 版本 | 日期 | 變更內容 |
316
+ |---------|------|---------|
317
+ | 1.0.0 | 2026-03-31 | 初始版本:嚴重度分類、升級路徑、可操作告警、降噪、以 SLO 為基礎的告警、品質指標 |
318
+
319
+ ---
320
+
321
+ ## 授權條款
322
+
323
+ 本標準依 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權釋出。
@@ -2,75 +2,198 @@
2
2
  source: ../../../core/anti-hallucination.md
3
3
  source_version: 1.5.1
4
4
  translation_version: 1.5.1
5
- last_synced: 2026-04-22
5
+ last_synced: 2026-10-16
6
+ source_hash: 7fa06b7d5665
6
7
  status: current
7
8
  ---
8
9
 
9
- # 防幻覺規範 (Anti-Hallucination Standards)
10
+ # AI 協作防幻覺標準
10
11
 
11
12
  > **語言**: [English](../../../core/anti-hallucination.md) | 繁體中文
12
13
 
13
- **版本**: 1.5.0
14
- **最後更新**: 2026-02-10
15
- **適用性**: 所有 AI 輔助開發工作
16
- **範圍**: 通用 (Universal)
14
+ **版本**: 1.5.1
15
+ **最後更新**: 2026-04-13
16
+ **適用性**: 所有使用 AI 助理的軟體專案
17
+ **範圍**: 通用 (universal)
18
+ **業界標準**: 無(UDS 原創)
19
+
20
+ > **如需詳細範例與案例研究,請參閱 [防幻覺指南](guides/anti-hallucination-guide.md)**
17
21
 
18
22
  ---
19
23
 
20
24
  ## 目的
21
25
 
22
- 本標準定義 AI 代理在協作過程中必須遵守的防幻覺協議。關於詳細的對話範例、幻覺類型分析與案例研究,請參閱 **[防幻覺指南](guides/anti-hallucination-guide.md)**。
26
+ 本標準為 AI 助理定義了嚴格的準則,以防止在分析程式碼、提出建議或撰寫系統文件時產生幻覺(生成虛假或未經證實的資訊)。
27
+
28
+ ---
29
+
30
+ ## 核心準則
31
+
32
+ ### 1. 僅限以證據為基礎的分析
33
+
34
+ | 應做事項 (DO) | 禁做事項 (DO NOT) |
35
+ |---------------|-------------------|
36
+ | ✅ 分析已讀取的程式碼檔案 | ❌ 猜測未見過的 API、函式或設定 |
37
+ | ✅ 引用已擷取的說明文件 | ❌ 在未驗證的情況下假設框架行為 |
38
+ | ✅ 引用已檢查過的設定檔 | ❌ 捏造需求細節 |
39
+
40
+ ### 2. 明確標註來源
41
+
42
+ **程式碼引用格式**:
43
+ ```
44
+ [Source: Code] file_path:line_number - Description
45
+ ```
46
+
47
+ **外部文件引用格式**:
48
+ ```
49
+ [Source: External] URL - Description (Version: x.x.x, Accessed: YYYY-MM-DD)
50
+ ```
51
+
52
+ **AI 知識引用格式**:
53
+ ```
54
+ [Source: Knowledge] Topic - Description (⚠️ Requires verification)
55
+ ```
56
+
57
+ ### 3. 來源類型可靠度
58
+
59
+ | 來源類型 | 標籤 | 可靠度 |
60
+ |----------|------|--------|
61
+ | 專案程式碼 | `[Source: Code]` | ⭐⭐⭐⭐⭐ 最高 |
62
+ | 專案文件 | `[Source: Docs]` | ⭐⭐⭐⭐ 高 |
63
+ | 外部文件 | `[Source: External]` | ⭐⭐⭐⭐ 高 |
64
+ | 網路搜尋 | `[Source: Search]` | ⭐⭐⭐ 中 |
65
+ | 使用者提供 | `[Source: User]` | ⭐⭐⭐ 中 |
66
+ | AI 知識 | `[Source: Knowledge]` | ⭐⭐ 低 |
67
+
68
+ ---
69
+
70
+ ## 確定性分類標籤
71
+
72
+ | 標籤 | 使用時機 |
73
+ |------|----------|
74
+ | `[Confirmed]` | 來自程式碼/文件的直接證據 |
75
+ | `[Inferred]` | 來自現有證據的邏輯推論 |
76
+ | `[Assumption]` | 基於常見模式(需要驗證) |
77
+ | `[Unknown]` | 資訊不可得 |
78
+ | `[Need Confirmation]` | 需要使用者釐清確認 |
79
+
80
+ ---
81
+
82
+ ## 衍生標籤(用於生成內容)
83
+
84
+ | 標籤 | 目的 | 範例語境 |
85
+ |------|------|----------|
86
+ | `[Source]` | 來自規格/需求的直接內容 | SPEC 標題、逐字引用的 AC 文字 |
87
+ | `[Derived]` | 從來源內容轉換而來 | 從項目符號 AC 轉換的 GWT |
88
+ | `[Generated]` | AI 生成的結構 | 測試骨架、TODO 註解 |
89
+ | `[TODO]` | 需要人工實作 | 步驟定義、斷言 |
23
90
 
24
91
  ---
25
92
 
26
- ## 核心鐵律 (The Iron Rules)
93
+ ## 禁止行為
27
94
 
28
- 1. **證據基礎 (Evidence-Based Analysis)**
29
- - 嚴禁在未讀取檔案前猜測程式碼內容。
30
- - 不要假設 API、類別名稱或函式庫版本。
31
- - 如果未看過程式碼,必須明確說明:「我需要讀取 [檔案] 來確認」。
95
+ | # | 禁止事項 | 替代做法 |
96
+ |---|----------|----------|
97
+ | 1 | **捏造 API 或函式簽章** | 讀取實際原始碼或詢問使用者 |
98
+ | 2 | **假設需求** | 當需求不明確時提出釐清問題 |
99
+ | 3 | **猜測未讀取的程式碼** | 聲明「需要讀取 [檔案] 以確認」 |
100
+ | 4 | **虛構設定** | 檢視實際的設定檔 |
101
+ | 5 | **憑空捏造錯誤或 Bug** | 分析實際程式碼並引用具體行號 |
102
+ | 6 | **僅提供選項而未給出建議** | 務必包含附帶理由的推薦選項 |
103
+ | 7 | **未進行副作用分析即實作** | 在實作前列出至少 3 個潛在副作用 |
32
104
 
33
- 2. **來源標註 (Source Attribution)**
34
- - 每個關於程式碼的事實陳述都必須標註來源。
35
- - 格式:`[來源: 程式碼] 路徑/檔案:行號`
36
- - 外部文件:`[來源: 外部] http://網址 (存取日期: 日期)`
105
+ ---
106
+
107
+ ## 建議要求
108
+
109
+ **規則**:當提供多個選項時,務必包含附帶理由的推薦選項。
110
+
111
+ | 情境 | 要求 |
112
+ |------|------|
113
+ | 提供 2 個以上選項 | 必須指出推薦選項並附上理由 |
114
+ | 存在明顯的最佳解 | 直接推薦最佳選項並附上理由 |
115
+ | 存在取捨權衡 | 根據目前語境推薦,並說明權衡考量 |
116
+ | 無法判斷 | 說明需要哪些資訊才能提出建議 |
117
+
118
+ ---
119
+
120
+ ## 下一步建議
121
+
122
+ **規則**:完成一項任務或子任務後,提出合乎邏輯的下一步建議,並指出最推薦的一項。
123
+
124
+ **準則**:
125
+ - **積極主動**:不要等使用者詢問「現在該做什麼?」
126
+ - **貼合語境**:建議應遵循專案的工作流程
127
+ - **明確最佳路徑**:使用 `[Recommended]` 標記最佳路徑
128
+
129
+ ---
130
+
131
+ ## 實作檢查清單
37
132
 
38
- 3. **確定性分類 (Certainty Classification)**
39
- - 使用標籤表示信心程度:
40
- - `[已確認]` (Confirmed) - 已從來源驗證
41
- - `[推論]` (Inferred) - 邏輯推論
42
- - `[假設]` (Assumption) - 合理假設(需驗證)
43
- - `[未知]` (Unknown) - 無法確定
133
+ 在對程式碼、需求或架構做出任何陳述之前:
44
134
 
45
- 4. **推薦選項 (Recommendations)**
46
- - 當提供多個選項時,必須明確說明「推薦」的選擇及其理由。
135
+ - [ ] **已驗證來源**:我是否已讀取實際的檔案/文件?
136
+ - [ ] **已標註來源類型**:我是否指定了來源類型?
137
+ - [ ] **已引用參考資料**:我是否包含了檔案路徑與行號(針對程式碼)?
138
+ - [ ] **已指定版本**:在適用的情況下,我是否包含了函式庫/框架版本?
139
+ - [ ] **已分類確定性**:我是否已標記為 [Confirmed]、[Inferred] 等?
140
+ - [ ] **已標示 AI 知識**:我是否使用 ⚠️ 警告標記了 `[Source: Knowledge]`?
141
+ - [ ] **無捏造內容**:我是否避免了虛構 API、設定或需求?
142
+ - [ ] **已請求使用者釐清**:針對不明確之處,我是否已請求釐清?
143
+ - [ ] **已包含推薦建議**:提供多個選項時,我是否包含了推薦選項?
144
+ - [ ] **已識別副作用**:在實作前,我是否已列出潛在的副作用?
47
145
 
48
146
  ---
49
147
 
50
- ## 驗證流程
148
+ ## 版本敏感度
51
149
 
52
- 在回答使用者問題或修改程式碼前,執行以下檢查:
150
+ **規則**:當引用函式庫、框架或 API 時,只要資訊可用,務必包含版本資訊。
53
151
 
54
- 1. **我讀過相關檔案了嗎?** (使用 `read_file` 或 `search`)
55
- 2. **我引用的變數/函式真的存在嗎?** (再次確認)
56
- 3. **我是否使用了過時的知識?** (檢查專案中的版本設定,如 `package.json`)
57
- 4. **我的推論有證據支持嗎?** (如果沒有,標註為 `[假設]`)
152
+ | ✅ 良好 | ❌ 不良 |
153
+ |---------|---------|
154
+ | `[Source: External] Next.js App Router (v14.x) - Server Components are the default` | "Next.js uses Server Components" |
155
+ | `[Source: Code] package.json:12 - Using "express": "^4.18.2"` | "Express handles routing" |
58
156
 
59
157
  ---
60
158
 
61
- ## 禁止事項
159
+ ## 對話語言準則
62
160
 
63
- - ❌ 編造不存在的 API 或參數。
64
- - ❌ 假裝執行了沒有執行的指令。
65
- - ❌ 在沒有根據的情況下聲稱「已修復」。
66
- - ❌ 引用不存在的檔案路徑。
161
+ | 語境 | 準則 |
162
+ |------|------|
163
+ | 對話 | 使用專案指定的語言 |
164
+ | 確定性標籤 | 使用專案指定的語言 |
165
+ | 錯誤說明 | 使用專案指定的語言 |
166
+ | 技術術語 | 保留原文(JWT、BCrypt、API、Token) |
167
+ | 程式碼註解 | 遵循專案慣例 |
168
+ | Commit 訊息 | 遵循專案慣例 |
67
169
 
68
170
  ---
69
171
 
70
172
  ## 相關標準
71
173
 
72
- - [防幻覺指南](guides/anti-hallucination-guide.md) - 詳細範例與案例
73
- - [AI 指令檔案規範](ai-instruction-standards.md)
174
+ - [測試標準](testing-standards.md) - 確保 AI 分析結果經過驗證
175
+ - [程式碼審查檢查清單](code-review-checklist.md) - 審查 AI 生成的內容
176
+ - [程式碼簽入標準](checkin-standards.md) - AI 協作簽入流程
177
+ - [反向工程標準](reverse-engineering-standards.md) - 確定性標籤的使用
178
+ - [正向推演標準](forward-derivation-standards.md) - 衍生標籤的使用
179
+
180
+ ---
181
+
182
+ ## 代理認識校準 (Agent Epistemic Calibration) (v1.4.0, XSPEC-008)
183
+
184
+ 代理必須使用 Answer/Ask/Abstain 框架聲明其認識狀態:
185
+
186
+ | 行動 | 使用時機 | 必要欄位 |
187
+ |------|----------|----------|
188
+ | `answer` | 擁有充足資訊 | 無(完整度/信心程度為選填) |
189
+ | `ask` | 缺少關鍵資訊 | `missing_variables` 清單 |
190
+ | `abstain` | 確實超出能力範圍 | `abstain_reason` |
191
+
192
+ **故障閉鎖型代理 (Fail-closed agents)**(必須一律回答):`evaluator`、`guardian`
193
+
194
+ **向後相容性**:缺少 `epistemic` 欄位時,預設為 `action_type: "answer"`。
195
+
196
+ 參見:XSPEC-008, DEC-014 (PassiveQA)
74
197
 
75
198
  ---
76
199
 
@@ -78,11 +201,17 @@ status: current
78
201
 
79
202
  | 版本 | 日期 | 變更 |
80
203
  |------|------|------|
81
- | 1.3.1 | 2026-01-29 | **重大重構**:拆分為規則(本文件)和指南(anti-hallucination-guide.md)。 |
82
- | 1.3.0 | 2026-01-24 | 新增統一標籤系統 |
204
+ | 1.5.1 | 2026-04-13 | 新增:代理認識校準 (Answer/Ask/Abstain) 框架 (XSPEC-008) |
205
+ | 1.5.0 | 2026-01-29 | 重構:拆分為規則 + 指南,將範例移至指南 |
206
+ | 1.4.0 | 2026-01-19 | 新增:副作用分析規則 |
207
+ | 1.3.1 | 2025-12-24 | 新增:相關標準章節 |
208
+ | 1.3.0 | 2025-12-22 | 強化:具備詳細範例的禁止行為 |
209
+ | 1.2.0 | 2025-12-15 | 新增 AI 助理互動標準 |
210
+ | 1.1.0 | 2025-12-10 | 強化來源標註與來源類型 |
211
+ | 1.0.0 | 2025-11-12 | 發布初始標準 |
83
212
 
84
213
  ---
85
214
 
86
215
  ## 授權
87
216
 
88
- 本標準以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。
217
+ 本標準以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權條款釋出。
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/anti-sycophancy-prompting.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: 860d9e77855b
6
7
  status: current
7
8
  ---
8
9
 
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/api-design-standards.md
3
3
  source_version: 1.1.0
4
4
  translation_version: 1.1.0
5
- last_synced: 2026-06-24
5
+ last_synced: 2026-10-11
6
+ source_hash: c844144a19cb
6
7
  status: current
7
8
  ---
8
9
 
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/behavior-driven-development.md
3
3
  source_version: 1.1.0
4
4
  translation_version: 1.1.0
5
- last_synced: 2026-03-24
5
+ last_synced: 2026-10-11
6
+ source_hash: d6b5a50a5e9b
6
7
  status: current
7
8
  ---
8
9
 
@@ -40,24 +41,9 @@ BDD 構成雙循環 TDD(GOOS 模式)的**外層循環**,BDD 場景驅動
40
41
  | **參與者** | 開發人員 + BA + QA(Three Amigos) |
41
42
  | **工具** | Cucumber、Behave、SpecFlow |
42
43
 
43
- ## Gherkin 語法範例
44
-
45
- ```gherkin
46
- Feature: 使用者登入
47
- 作為一個已註冊的使用者
48
- 我希望能夠登入系統
49
- 以便存取我的個人資料
50
-
51
- Scenario: 使用有效憑證登入
52
- Given 使用者已在登入頁面
53
- When 使用者輸入有效的帳號和密碼
54
- Then 系統應重導至儀表板
55
- And 顯示歡迎訊息
56
- ```
57
-
58
44
  ## 相關標準
59
45
 
60
- - [測試驅動開發](../../../core/test-driven-development.md)
46
+ - [測試驅動開發](test-driven-development.md)
61
47
  - [驗收測試驅動開發](acceptance-test-driven-development.md)
62
48
  - [規格驅動開發](spec-driven-development.md)
63
49
  - [測試標準](testing-standards.md)