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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (721) hide show
  1. package/bin/uds.js +12 -1
  2. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  3. package/bundled/ai/standards/commit-message.ai.yaml +12 -2
  4. package/bundled/ai/standards/mock-boundary.ai.yaml +138 -2
  5. package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
  6. package/bundled/ai/standards/turn-completion-integrity.ai.yaml +6 -2
  7. package/bundled/core/commit-message-guide.md +22 -19
  8. package/bundled/core/mock-boundary.md +70 -2
  9. package/bundled/core/secret-management-standards.md +13 -1
  10. package/bundled/core/turn-completion-integrity.md +8 -2
  11. package/bundled/extensions/locales/zh-tw.md +19 -19
  12. package/bundled/hooks/check-dangerous-cmd.mjs +161 -26
  13. package/bundled/hooks/check-logging-standard.mjs +35 -6
  14. package/bundled/hooks/validate-commit-msg.mjs +317 -28
  15. package/bundled/locales/zh-CN/CHANGELOG.md +2323 -1099
  16. package/bundled/locales/zh-CN/CLAUDE.md +987 -101
  17. package/bundled/locales/zh-CN/README.md +3 -3
  18. package/bundled/locales/zh-CN/SECURITY.md +4 -3
  19. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  20. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
  21. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  22. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
  23. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
  24. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
  25. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
  26. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  27. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  28. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  29. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  30. package/bundled/locales/zh-CN/core/accessibility-standards.md +871 -62
  31. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  32. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  33. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  34. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  35. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  36. package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +311 -72
  37. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  38. package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
  39. package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
  40. package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
  41. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  42. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  43. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  44. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  45. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  46. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  47. package/bundled/locales/zh-CN/core/changelog-standards.md +485 -63
  48. package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
  49. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  50. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  51. package/bundled/locales/zh-CN/core/code-review-checklist.md +37 -23
  52. package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
  53. package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
  54. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  55. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  56. package/bundled/locales/zh-CN/core/deprecation-standards.md +155 -40
  57. package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
  58. package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
  59. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  60. package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
  61. package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
  62. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  63. package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
  64. package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
  65. package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
  66. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  67. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  68. package/bundled/locales/zh-CN/core/feature-flag-standards.md +202 -57
  69. package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
  70. package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
  71. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  72. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  73. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  74. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  75. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  76. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  77. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  78. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  79. package/bundled/locales/zh-CN/core/mock-boundary.md +74 -6
  80. package/bundled/locales/zh-CN/core/mutation-testing.md +45 -6
  81. package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
  82. package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
  83. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  84. package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
  85. package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
  86. package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
  87. package/bundled/locales/zh-CN/core/project-structure.md +550 -170
  88. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  89. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  90. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  91. package/bundled/locales/zh-CN/core/retrospective-standards.md +215 -22
  92. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  93. package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
  94. package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
  95. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  96. package/bundled/locales/zh-CN/core/security-standards.md +169 -16
  97. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  98. package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
  99. package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
  100. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  101. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  102. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  103. package/bundled/locales/zh-CN/core/supply-chain-security-standards.md +159 -32
  104. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  105. package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
  106. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  107. package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
  108. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  109. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  110. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  111. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  112. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  113. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  114. package/bundled/locales/zh-CN/core/turn-completion-integrity.md +8 -6
  115. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  116. package/bundled/locales/zh-CN/core/versioning.md +737 -73
  117. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  118. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  119. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  120. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +2 -1
  121. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  122. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
  123. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
  124. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  125. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
  126. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  127. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
  128. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  129. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  130. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +2 -0
  131. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  132. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  133. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  134. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  135. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  136. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  137. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  138. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  139. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  140. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  141. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  142. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  143. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  144. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  145. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  146. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  147. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  148. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  149. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  150. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  151. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  152. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  153. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  154. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  155. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  156. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  157. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  158. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  159. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  160. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  161. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  162. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  163. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  164. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  165. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  166. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  167. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  168. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  169. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  170. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  171. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  172. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  173. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  174. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  175. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  176. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  177. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  178. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  179. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  180. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  181. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  182. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  183. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  184. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  185. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  186. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  187. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  188. package/bundled/locales/zh-CN/skills/README.md +2 -1
  189. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  190. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  191. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  192. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  193. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  194. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  195. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  196. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  197. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  198. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  199. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  200. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  201. package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +217 -137
  202. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  203. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  204. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  205. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  206. package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +148 -132
  207. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  208. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  209. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  210. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  211. package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +122 -121
  212. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  213. package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
  214. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  215. package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
  216. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  217. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  218. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  219. package/bundled/locales/zh-CN/skills/code-review-assistant/guide.md +119 -45
  220. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  221. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  222. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  223. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  224. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  225. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  226. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  227. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  228. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  229. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  230. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  231. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  232. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  233. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  234. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  235. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  236. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  237. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  238. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  239. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  240. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  241. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  242. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  243. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  244. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  245. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  246. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  247. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  248. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  249. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  250. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  251. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  252. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  253. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  254. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  255. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  256. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  257. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  258. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  259. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  260. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  261. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  262. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  263. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  264. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  265. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  266. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  267. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  268. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  269. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +4 -4
  270. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  271. package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
  272. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  273. package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
  274. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  275. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  276. package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +4 -2
  277. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  278. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  279. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  280. package/bundled/locales/zh-CN/skills/docs-generator/guide.md +8 -7
  281. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  282. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  283. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  284. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  285. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  286. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  287. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  288. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  289. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  290. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  291. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  292. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  293. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  294. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  295. package/bundled/locales/zh-CN/skills/project-discovery/guide.md +158 -157
  296. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  297. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  298. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  299. package/bundled/locales/zh-CN/skills/refactoring-assistant/guide.md +172 -171
  300. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  301. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  302. package/bundled/locales/zh-CN/skills/release-standards/guide.md +51 -43
  303. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  304. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  305. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  306. package/bundled/locales/zh-CN/skills/requirement-assistant/guide.md +88 -79
  307. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  308. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  309. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  310. package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +2 -2
  311. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  312. package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
  313. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  314. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  315. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  316. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  317. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  318. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  319. package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +2 -2
  320. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  321. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  322. package/bundled/locales/zh-CN/skills/tdd-assistant/guide.md +217 -156
  323. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  324. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  325. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  326. package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +25 -12
  327. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  328. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  329. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  330. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  331. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  332. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  333. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  334. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  335. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  336. package/bundled/locales/zh-TW/CHANGELOG.md +2323 -1128
  337. package/bundled/locales/zh-TW/CLAUDE.md +962 -76
  338. package/bundled/locales/zh-TW/README.md +3 -3
  339. package/bundled/locales/zh-TW/SECURITY.md +4 -3
  340. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  341. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
  342. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  343. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
  344. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
  345. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
  346. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
  347. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  348. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  349. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  350. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  351. package/bundled/locales/zh-TW/core/accessibility-standards.md +895 -46
  352. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  353. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  354. package/bundled/locales/zh-TW/core/agent-dispatch.md +102 -33
  355. package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
  356. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  357. package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
  358. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  359. package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
  360. package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
  361. package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
  362. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  363. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  364. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  365. package/bundled/locales/zh-TW/core/branch-completion.md +130 -34
  366. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  367. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  368. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  369. package/bundled/locales/zh-TW/core/chaos-engineering-standards.md +138 -36
  370. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  371. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  372. package/bundled/locales/zh-TW/core/code-review-checklist.md +19 -7
  373. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  374. package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
  375. package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
  376. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  377. package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
  378. package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
  379. package/bundled/locales/zh-TW/core/developer-memory.md +102 -12
  380. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  381. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  382. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  383. package/bundled/locales/zh-TW/core/environment-standards.md +250 -72
  384. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  385. package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
  386. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  387. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  388. package/bundled/locales/zh-TW/core/feature-flag-standards.md +202 -57
  389. package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
  390. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  391. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  392. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  393. package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +234 -487
  394. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  395. package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
  396. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  397. package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
  398. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  399. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  400. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  401. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  402. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  403. package/bundled/locales/zh-TW/core/mock-boundary.md +74 -6
  404. package/bundled/locales/zh-TW/core/observability-standards.md +284 -40
  405. package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
  406. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  407. package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
  408. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  409. package/bundled/locales/zh-TW/core/project-context-memory.md +210 -31
  410. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  411. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  412. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  413. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  414. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  415. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  416. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  417. package/bundled/locales/zh-TW/core/runbook-standards.md +296 -23
  418. package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
  419. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  420. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  421. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  422. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  423. package/bundled/locales/zh-TW/core/slo-standards.md +301 -49
  424. package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
  425. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  426. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  427. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  428. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  429. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  430. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  431. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  432. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  433. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  434. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  435. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  436. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  437. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  438. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  439. package/bundled/locales/zh-TW/core/turn-completion-integrity.md +8 -6
  440. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  441. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  442. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  443. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  444. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  445. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +2 -1
  446. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  447. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
  448. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  449. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
  450. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  451. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
  452. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  453. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
  454. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  455. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  456. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +2 -0
  457. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  458. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  459. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  460. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  461. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  462. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  463. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  464. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  465. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  466. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  467. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  468. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  469. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  470. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  471. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  472. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  473. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  474. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  475. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  476. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  477. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  478. package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +584 -475
  479. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  480. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  481. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  482. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  483. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  484. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  485. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  486. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  487. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  488. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  489. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  490. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  491. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  492. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  493. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  494. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  495. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  496. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  497. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  498. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  499. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  500. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  501. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  502. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  503. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  504. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  505. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  506. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  507. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  508. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  509. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  510. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  511. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  512. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  513. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  514. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  515. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  516. package/bundled/locales/zh-TW/skills/README.md +2 -1
  517. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  518. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  519. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  520. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  521. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  522. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  523. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  524. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  525. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  526. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  527. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  528. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  529. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  530. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  531. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  532. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  533. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  534. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  535. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  536. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  537. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  538. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  539. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  540. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  541. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  542. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  543. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  544. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  545. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  546. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  547. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  548. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  549. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  550. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  551. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  552. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  553. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  554. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  555. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  556. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  557. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  558. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  559. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  560. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  561. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  562. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  563. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  564. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  565. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  566. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  567. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  568. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  569. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  570. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  571. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  572. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  573. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  574. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  575. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  576. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  577. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  578. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  579. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  580. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  581. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  582. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  583. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  584. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  585. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  586. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  587. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  588. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  589. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  590. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  591. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  592. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  593. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  594. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  595. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  596. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  597. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  598. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  599. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  600. package/bundled/locales/zh-TW/skills/commit-standards/guide.md +137 -17
  601. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  602. package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
  603. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  604. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  605. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  606. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  607. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  608. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  609. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  610. package/bundled/locales/zh-TW/skills/docs-generator/guide.md +4 -3
  611. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  612. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  613. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  614. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  615. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  616. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  617. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  618. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  619. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  620. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  621. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  622. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  623. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  624. package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +85 -18
  625. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  626. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  627. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  628. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  629. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  630. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  631. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  632. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  633. package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +91 -45
  634. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  635. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  636. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  637. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  638. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  639. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  640. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  641. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  642. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  643. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  644. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  645. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  646. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  647. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  648. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  649. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  650. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  651. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  652. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  653. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  654. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  655. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  656. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  657. package/bundled/locales/zh-TW/skills/tdd-assistant/language-examples.md +693 -47
  658. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  659. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  660. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  661. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  662. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  663. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  664. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  665. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  666. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  667. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  668. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  669. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  670. package/bundled/skills/.claude-plugin/plugin.json +71 -0
  671. package/bundled/skills/commit-standards/SKILL.md +2 -2
  672. package/bundled/skills/commit-standards/guide.md +3 -2
  673. package/bundled/skills/commit-standards/language-options.md +19 -17
  674. package/package.json +2 -2
  675. package/src/commands/audit.js +28 -1
  676. package/src/commands/check.js +72 -3
  677. package/src/commands/compile.js +37 -4
  678. package/src/commands/config.js +49 -24
  679. package/src/commands/init.js +78 -30
  680. package/src/commands/open-work.js +6 -2
  681. package/src/commands/release-messages.js +228 -0
  682. package/src/commands/release.js +127 -68
  683. package/src/commands/run-intent.js +11 -0
  684. package/src/commands/spec.js +4 -2
  685. package/src/commands/update.js +227 -47
  686. package/src/compilers/claude-code-compiler.js +9 -1
  687. package/src/config/ai-agent-paths.js +14 -1
  688. package/src/core/installed-formats.js +15 -0
  689. package/src/core/open-work-config.js +20 -1
  690. package/src/core/project-config.js +55 -0
  691. package/src/i18n/messages.js +106 -2
  692. package/src/installers/hooks-installer.js +1 -1
  693. package/src/installers/manifest-installer.js +1 -1
  694. package/src/installers/skills-installer.js +1 -1
  695. package/src/installers/standards-installer.js +3 -1
  696. package/src/mcp/server.js +9 -3
  697. package/src/prompts/init.js +26 -22
  698. package/src/reconciler/actual-state-scanner.js +2 -8
  699. package/src/reconciler/backup-locations.js +5 -0
  700. package/src/reconciler/backup-manager.js +19 -11
  701. package/src/reconciler/desired-state-calculator.js +89 -57
  702. package/src/reconciler/plan-executor.js +101 -8
  703. package/src/reconciler/recorded-versions.js +49 -0
  704. package/src/reconciler/relative-path.js +23 -0
  705. package/src/uninstallers/hook-uninstaller.js +9 -1
  706. package/src/uninstallers/skills-uninstaller.js +22 -3
  707. package/src/utils/available-standards-report.js +25 -4
  708. package/src/utils/available-standards.js +13 -3
  709. package/src/utils/build-manifest.js +1 -1
  710. package/src/utils/commit-message-judge.js +60 -13
  711. package/src/utils/friction-detector.js +23 -11
  712. package/src/utils/git-hooks.js +106 -4
  713. package/src/utils/integration-generator.js +95 -67
  714. package/src/utils/legacy-hook-migration.js +121 -2
  715. package/src/utils/open-work-tracking.mjs +105 -16
  716. package/src/utils/sdd-header.js +16 -4
  717. package/src/utils/skills-installer.js +2 -1
  718. package/src/utils/spinner.js +14 -4
  719. package/src/utils/standard-validator.js +3 -2
  720. package/standards-registry.json +10 -8
  721. package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
@@ -1,9 +1,9 @@
1
1
  ---
2
2
  source: ../../../core/mock-boundary.md
3
- source_version: 1.1.0
4
- translation_version: 1.1.0
5
- last_synced: 2026-07-01
6
- source_hash: fe4715991a4c
3
+ source_version: 1.3.0
4
+ translation_version: 1.3.0
5
+ last_synced: 2026-10-28
6
+ source_hash: b95f3da59a8e
7
7
  status: current
8
8
  ---
9
9
 
@@ -11,8 +11,8 @@ status: current
11
11
 
12
12
  > **Language**: [English](../../../core/mock-boundary.md) | 繁體中文
13
13
 
14
- **版本**: 1.1.0
15
- **最後更新**: 2026-07-01
14
+ **版本**: 1.3.0
15
+ **最後更新**: 2026-10-28
16
16
  **適用範圍**: 所有具備單元測試與整合測試的軟體專案
17
17
  **Scope**: universal
18
18
  **產業標準**: ISTQB Foundation(Test Doubles), xUnit Patterns(Gerard Meszaros)
@@ -110,6 +110,67 @@ class DeterministicDispatcher implements BackgroundDispatcher {
110
110
 
111
111
  ---
112
112
 
113
+ ## 攔截型 Hook:測宿主的入口,不是測比對函式
114
+
115
+ **hook** 是 AI 宿主(Claude Code、Codex、Gemini CLI、Antigravity CLI 等)在生命週期事件上執行的腳本。有些 hook 能**擋下**宿主原本要做的事:拒絕一次工具呼叫、拒絕一則提示、不讓一個回合結束。對這類 hook,空心測試根本不需要任何 mock——測試只是從來沒碰到宿主會呼叫的入口。
116
+
117
+ hook 有兩層。**判斷層**決定這條指令危不危險;**接線層**讀宿主送來的 stdin 資料,並用宿主會讀的訊號回答(結束碼,或標準輸出的 JSON)。匯入判斷函式的單元測試只練到第一層,而宿主讀的是第二層。結束碼錯、欄位名稱讀錯、輸出格式宿主不認,這些都不會讓那支測試變紅。
118
+
119
+ ### 反例:UDS 自己的危險指令 hook,擋下 0/26
120
+
121
+ `scripts/hooks/check-dangerous-cmd.mjs` 是 PreToolUse hook。偵測到危險指令時它 `exit 1`。Claude Code 只有 `exit 2` 才擋下工具呼叫;其他非 0 結束碼都是不阻擋的 hook 錯誤,指令照樣執行。它的測試匯入比對函式(`isDangerousCommand()`)直接呼叫,所以綠了好幾個月。
122
+
123
+ 重播 11,617 次真實 shell 呼叫(2026-10-27),規則 `rm -rf /` 命中 26 次,宿主擋下 **0** 次。26 次中有 25 次是無害的暫存清理,例如 `rm -rf /tmp/x`;沒有任何一次是真的要清空根目錄。同一個規則還漏掉 `rm -fr /` 與 `rm -r -f /`。修正與入口測試在 PR #281 出貨。
124
+
125
+ ### 規則
126
+
127
+ **H1(MUST)**:能擋下工具呼叫、提示或回合的 hook,至少要有一支測試同時做到下列三件事:
128
+
129
+ 1. **另起行程執行 hook**,用宿主設定檔裡執行它的同一個指令。啟動腳本算數;匯入不算。
130
+ 2. **在 stdin 送入宿主自己的資料**,欄位名稱用該宿主的(見下表:Claude Code 送 `tool_name`/`tool_input`,Antigravity 送 `toolCall`)。照作者想像的宿主格式做出來的資料什麼也證明不了。
131
+ 3. **斷言宿主據以判斷的訊號**:確切的結束碼,或宿主在標準輸出解析的 JSON。「非 0」「有錯誤結束」「stderr 含某個字」都不算:exit 1 是非 0,卻在 Claude Code 上什麼也沒擋。
132
+
133
+ 匯入並呼叫內部函式的測試可以存在,對判斷層也有用,但**不計入** H1。
134
+
135
+ **H2(SHOULD)**:擋下的案例旁邊,用同樣方式跑一個放行的案例,並斷言宿主的放行訊號(例如 exit 0 且標準輸出為空)。一個什麼都擋的 hook 可以通過只測擋下的測試。
136
+
137
+ **H3(SHOULD)**:切斷檢查——把 hook 的擋下訊號改掉(例如 `exit 2` 改成 `exit 1`),確認入口測試變紅。維持綠色,代表那支測試沒在守接線。
138
+
139
+ H1 也適用於「唯一作用是讓宿主讀到它的訊號」的 hook,例如用 exit 2 把 stderr 送到模型面前的 PostToolUse hook。工具已經跑完、無法撤銷,但錯的結束碼一樣會讓這支 hook 無聲無息。
140
+
141
+ ### 各宿主把什麼當成「已擋下」
142
+
143
+ 2026-10-28 取自各宿主自己的官方文件。宿主會改這些約定;採信某一格之前請重查出處。格子寫「未查到」,是讀過該頁而頁面沒寫,不等於「沒有」。
144
+
145
+ | 宿主 | 事件 | 擋下 | 不擋下 | 出處 |
146
+ |---|---|---|---|---|
147
+ | Claude Code | PreToolUse | exit **2**(stderr 是理由);或 exit 0 並在 stdout 輸出 `{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"..."}}` | 其他任何結束碼,**包含 1**,都是不阻擋的 hook 錯誤,動作照常進行;無效的 JSON 同理。文件寫明的例外:設定了 `onFailure: "block"` 的 hook,失敗時會擋下 | code.claude.com/docs/en/hooks:Exit code output、Exit code 2、Other exit codes、Decision control |
148
+ | Claude Code | UserPromptSubmit | exit **2**(提示不會送到模型);或 exit 0 並在 stdout 輸出 `{"decision":"block","reason":"..."}` | 其他任何結束碼(同樣有 `onFailure: "block"` 的例外) | 同頁,Exit code 2 behavior per event |
149
+ | Claude Code | PostToolUse | 不能擋:工具已經執行。exit 2 只會把 stderr 顯示給模型 | 以擋下而言,任何結束碼都不行 | 同頁,Exit code 2 behavior per event |
150
+ | Codex | PreToolUse | exit **2** 並把理由寫到 stderr;或 stdout 輸出 `{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"..."}}`;舊式 `{"decision":"block","reason":"..."}` 也接受 | stdout 的純文字會被忽略;`permissionDecision:"ask"`、`continue:false`、`stopReason`、`suppressOutput` 尚不支援,該次 hook 執行被標為失敗而工具呼叫繼續;其他非 0 結束碼:未查到 | developers.openai.com/codex/hooks,PreToolUse |
151
+ | Codex | UserPromptSubmit | exit **2** 並把理由寫到 stderr;或 stdout 輸出 `{"decision":"block","reason":"..."}` | stdout 純文字會被當成額外脈絡;其他非 0 結束碼:未查到 | 同頁,UserPromptSubmit |
152
+ | Codex | PermissionRequest | stdout 輸出 `{"hookSpecificOutput":{"decision":{"behavior":"deny","message":"..."}}}`;任一 `deny` 即勝出 | 此事件的 exit 2:未查到;stdout 純文字會被忽略 | 同頁,PermissionRequest |
153
+ | Gemini CLI(舊版) | BeforeTool | exit **2**(stderr 是送給 agent 的理由);或 exit 0 並在 stdout 輸出 `{"decision":"deny","reason":"..."}`(`"block"` 是別名)。文件把 JSON 形式列為優先路徑 | 其他任何結束碼只是警告,CLI 繼續 | geminicli.com/docs/hooks/reference,Global hook mechanics 與 BeforeTool |
154
+ | Gemini CLI(舊版) | BeforeAgent、BeforeModel | exit **2** 中止該回合(BeforeAgent 還會把提示從脈絡抹除;BeforeModel 跳過 LLM 呼叫);或 `decision:"deny"` | 同上 | 同頁 |
155
+ | Antigravity CLI(`agy`) | PreToolUse | exit 0 並在 stdout 輸出 `{"decision":"deny","reason":"..."}`(「Hard blocks execution immediately」)。`decision` 欄位必填,其他值為 `allow`、`auto_approve`、`ask`、`force_ask`、`deny_unless_prior_grant`。stdin 帶的是 `toolCall.name` 與 `toolCall.args`,不是 Claude Code 的欄位名 | 結束碼語意:未查到(官方頁面沒寫)。不要假設 Claude Code 的 exit 2 適用。第三方文章宣稱任何非 0 都視為拒絕;那不是官方說法,此處不採用 | antigravity.google/docs/hooks,Input and output contract,PreToolUse |
156
+ | Cursor 與其他宿主 | 任何 | 未查到(本版未調查) | 未查到 | 無 |
157
+
158
+ Stop 類事件(Claude Code 與 Codex 的 Stop、Gemini CLI 的 AfterAgent、Antigravity 的 Stop)**不在這裡重複**。它們的擋下約定寫在 [turn-completion-integrity](turn-completion-integrity.md) 的「支援的執行環境」表,那是唯一寫下它們的地方。該表也記錄了一個 Antigravity hook 失敗後被靜默放行的案例,與本節要防的接線失敗是同一型。
159
+
160
+ ### 重播驗證的是接線,不是規則
161
+
162
+ 把錄下的真實呼叫重播給 hook(例如用 rules-to-guards)是檢查接線的有力方法。但它有一個每次回報結果時都必須講明的限制:若同一份規則清單同時決定「該擋」與「不該擋」,重播只證明 hook 照它的規則運作,**不證明規則本身是對的**。
163
+
164
+ 0/26 之所以量得出來,是因為宿主的約定(exit 2 才擋)是 hook 之外的事實。至於「哪些指令值得擋」,手上只有 hook 自己的比對式:26 次命中都與它一致,真正的危險 0 次,而它沒涵蓋的 `rm -fr /` 永遠不會在重播裡顯示為漏掉,因為答案來源與 hook 共用同一個盲點。
165
+
166
+ 所以重播的結果只能報「接線正確」或「接線錯誤」,不要由它得出「規則正確」。要對規則下結論,請去讀實際命中的指令,或另備一份不看 hook 比對式寫成的獨立答案(見 [verification-oracle](verification-oracle.md))。
167
+
168
+ ### UDS 的執行方式
169
+
170
+ UDS 在 CI 對自己出貨的 hook 檢查這條規則:`node scripts/check-hook-entry-tests.mjs`(npm 指令 `check:hook-entry-tests`),出貨的、能擋下的 hook 若沒有「啟動它、送 stdin、斷言宿主訊號」的測試就判失敗。它是靜態文字分析:只證明「形狀對的測試存在」,不證明 hook 退化時那支測試會變紅——那是 H3 的工作。
171
+
172
+ ---
173
+
113
174
  ## 空心測試偵測
114
175
 
115
176
  提交測試檔之前,請檢查:
@@ -118,6 +179,7 @@ class DeterministicDispatcher implements BackgroundDispatcher {
118
179
  2. **所有斷言都是 `.toHaveBeenCalled()` 系列** → 加入輸出值斷言
119
180
  3. **Mock 路徑與受測對象目錄相同** → 自我引用 mock;移除之
120
181
  4. **Mock 設定行數多於斷言行數** → 很可能是空心測試
182
+ 5. **攔截型 hook 的測試只匯入並呼叫它的函式** → 補一支啟動 hook 並斷言宿主訊號的入口測試(見「攔截型 Hook」)
121
183
 
122
184
  ---
123
185
 
@@ -128,6 +190,7 @@ class DeterministicDispatcher implements BackgroundDispatcher {
128
190
  - **Orphan Mock**:跨模組 mock 卻沒有對應的整合測試
129
191
  - **Security Bypass Mock**:auth/權限邏輯被換成直接放行的 stub
130
192
  - **Database Mock Cascade**:DB 回傳寫死的資料,隱藏真實查詢錯誤
193
+ - **Matcher-Only Hook Test**:攔截型 hook 的測試只匯入並呼叫其判斷函式,從未照宿主的方式執行 hook。hook 什麼也沒擋,測試卻是綠的(UDS 自己的 0/26)
131
194
  - **Poll/Sleep for Background Result**:用 sleep 或 poll 等待 fire-and-forget 背景工作完成。race 依然存在——timeout 只是多數時候把它遮住,同時拖慢整套測試;在共用 runner 上更會把 flakiness 洩漏進其他 MR 的 CI。改注入 deterministic runner 並 await 被追蹤的 task。
132
195
 
133
196
  ---
@@ -142,6 +205,8 @@ class DeterministicDispatcher implements BackgroundDispatcher {
142
205
  | 禁止 mock 安全機制 | 測試涉及 auth/權限 | 使用真實測試使用者 + 真實 token |
143
206
  | 空心審查 | Mock 數量 ≥ import 數量 | 加入輸出值斷言 |
144
207
  | 背景工作禁止 poll/sleep | 測試斷言某個 fire-and-forget 副作用 | 注入 deterministic runner;await 被追蹤的 task |
208
+ | 攔截型 hook 要有宿主入口測試 | hook 能擋下工具呼叫、提示或回合 | 啟動它、在 stdin 送宿主的資料、斷言宿主據以判斷的結束碼或 stdout JSON |
209
+ | 重播只證明接線 | 回報把真實呼叫重播給 hook 的結果 | 報「接線正確」;除非規則另以獨立答案核對過,否則不報「規則正確」 |
145
210
 
146
211
  ---
147
212
 
@@ -150,6 +215,8 @@ class DeterministicDispatcher implements BackgroundDispatcher {
150
215
  - **testing**:Mock 邊界規則適用於測試金字塔的所有測試層級
151
216
  - **test-completeness-dimensions**:維度 8(AI 測試品質)引用了這些規則
152
217
  - **flow-based-testing**:Flow 測試必須遵循 mock 邊界規則
218
+ - **turn-completion-integrity**:Stop 類事件的擋下約定寫在那裡;工具與提示事件的寫在本標準,兩邊都不重複對方
219
+ - **verification-oracle**:用來判斷 hook 規則對不對的答案來源,不得由 hook 自己的比對式推出
153
220
 
154
221
  ---
155
222
 
@@ -159,3 +226,4 @@ class DeterministicDispatcher implements BackgroundDispatcher {
159
226
  |------|------|------|
160
227
  | 1.0.0 | 2026-05-04 | 初始標準:空心測試問題、可/不可 Mock 表格、偵測、反模式、規則摘要 |
161
228
  | 1.1.0 | 2026-07-01 | 新增可注入的背景執行作為 seam(平行於 clock injection):可 Mock 表列、`可注入的背景執行` 章節、`Poll/Sleep for Background Result` 反模式,以及背景工作禁止 poll/sleep 規則(issue #143) |
229
+ | 1.3.0 | 2026-10-28 | 新增《攔截型 Hook:測宿主的入口,不是測比對函式》:H1 MUST(啟動 hook、送宿主的 stdin 資料、斷言宿主據以判斷的訊號)、H2/H3 SHOULD、各宿主擋下訊號對照表,以及「重播驗證接線、不驗證規則」的註記,並以 UDS 自己的 0/26 為反例。版本號與 `mock-boundary.ai.yaml` 對齊——該檔先前把「背景執行」那次新增記為 1.2.0,本檔記為 1.1.0 |
@@ -2,73 +2,292 @@
2
2
  source: ../../../core/observability-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: d6bf74a0b5be
6
7
  status: current
7
8
  ---
8
9
 
9
10
  # 可觀測性標準
10
11
 
11
- > 版本: 1.0.0 | 最後更新: 2026-04-01
12
+ > **語言**: [English](../../../core/observability-standards.md) | 繁體中文
13
+
14
+ **版本**:1.0.0
15
+ **最後更新**:2026-03-31
16
+ **適用範圍**:所有軟體專案
17
+ **範疇**:通用
18
+ **業界標準**:OpenTelemetry、W3C Trace Context、Google SRE(黃金信號)
19
+ **參考資料**:[opentelemetry.io](https://opentelemetry.io/)、[sre.google](https://sre.google/)
20
+
21
+ ---
12
22
 
13
23
  ## 概述
14
24
 
15
- 本文件定義可觀測性標準,涵蓋三大支柱:**Logs(日誌)**、**Metrics(指標)** 和 **Traces(追蹤)**。補充現有的 [日誌標準](logging-standards.md),新增全面的 Metrics 與 Traces 指引、統一關聯框架及操作檢查清單。
25
+ 本文件定義可觀測性標準,用於跨越三大支柱建置具備可觀測性的系統:**Logs(日誌)**、**Metrics(指標)** 與 **Traces(追蹤)**。本文件補充現有的 [日誌標準](logging-standards.md),新增全面的 Metrics 與 Traces 指引、統一的關聯框架以及維運檢查清單。
16
26
 
17
- 完整 Logs 指引(結構化日誌、日誌等級、敏感資料處理、OpenTelemetry 整合)請參閱 [日誌標準](logging-standards.md)。
27
+ 有關完整的 Logs 指引(包括結構化日誌、日誌等級、敏感資料處理與 OpenTelemetry 整合),請參閱 [日誌標準](logging-standards.md)。
18
28
 
19
29
  ---
20
30
 
21
31
  ## 三大支柱框架
22
32
 
33
+ 現代可觀測性依賴三大互補的支柱,各自提供觀察系統行為的不同視角:
34
+
35
+ ```
36
+ ┌──────────┐ trace_id ┌──────────┐ trace_id ┌──────────┐
37
+ │ LOGS │◄───────────────►│ TRACES │◄───────────────►│ METRICS │
38
+ │ (Events) │ │ (Spans) │ │(Counters)│
39
+ └──────────┘ └──────────┘ └──────────┘
40
+ │ │ │
41
+ └────────── service.name ────┴──────── service.name ──────┘
42
+ ```
43
+
23
44
  | 支柱 | 擷取內容 | 使用時機 | 粒度 |
24
45
  |------|---------|---------|------|
25
46
  | **Logs** | 具備上下文的離散事件 | 除錯、稽核追蹤、錯誤詳情 | 高(每事件) |
26
47
  | **Metrics** | 隨時間變化的數值量測 | 儀表板、告警、容量規劃 | 低(聚合) |
27
- | **Traces** | 跨服務的請求流程 | 延遲分析、依賴對應 | 中(每請求) |
48
+ | **Traces** | 跨服務的請求流程 | 延遲分析、相依性對應 | 中(每請求) |
28
49
 
29
50
  ### 跨支柱關聯
30
51
 
31
- - **Metric 異常 → Trace**:使用 Exemplars 連結到特定 Trace
32
- - **Trace → Logs**:使用 `trace_id` 和 `span_id` 查找特定請求的日誌
33
- - **Logs → Metric**:將日誌模式聚合為指標(如:從錯誤日誌計算錯誤率)
52
+ 可觀測性的強大之處在於跨支柱的關聯分析:
53
+
54
+ 1. **Metric 異常 → Trace**:在 Metric 上使用 Exemplar 連結到呈現異常行為的特定追蹤
55
+ 2. **Trace → Logs**:使用嵌入在日誌中的 `trace_id` 與 `span_id` 找出特定請求的所有日誌項目
56
+ 3. **Logs → Metric**:將日誌模式聚合為指標(例如:從錯誤日誌計算錯誤率)
34
57
 
35
- 關鍵關聯欄位:`trace_id`、`service.name`
58
+ **關鍵關聯欄位:**
59
+ - `trace_id` — 連結 Logs ↔ Traces ↔ Metrics(透過 Exemplar)
60
+ - `service.name` — 依服務識別過濾所有三大支柱
36
61
 
37
62
  ---
38
63
 
39
- ## Metric 類型
64
+ ## Metrics
65
+
66
+ ### Metric 類型
67
+
68
+ 依據您需要量測的內容選擇合適的 Metric 類型:
40
69
 
41
70
  | 類型 | 用途 | 行為 | 使用情境 |
42
71
  |------|------|------|---------|
43
72
  | **Counter** | 單調遞增計數 | 只增不減(重啟時重置) | 請求數、錯誤數、傳送位元組 |
44
- | **Gauge** | 即時數值(可增可減) | 表示當前狀態 | 溫度、佇列深度、活躍連線 |
45
- | **Histogram** | 跨 Bucket 的值分布 | 記錄值到預定義 Bucket | 請求持續時間、回應大小 |
46
- | **Summary** | 客戶端計算的百分位數 | 在客戶端計算分位數 | 舊系統、不需伺服器端聚合時 |
73
+ | **Gauge** | 即時數值(可增可減) | 表示當前狀態 | 溫度、佇列深度、作用中連線 |
74
+ | **Histogram** | 跨 Bucket 的數值分布 | 記錄數值到預定義的 Bucket | 請求持續時間、回應大小 |
75
+ | **Summary** | 客戶端計算的百分位數 | 在客戶端計算分位數 | 舊系統、不需要伺服器端聚合時 |
76
+
77
+ **決策指引:**
78
+ ```
79
+ Does the value only go up?
80
+ ├─ Yes → Counter (e.g., http.server.request.total)
81
+ └─ No
82
+ ├─ Do you need distribution/percentiles?
83
+ │ ├─ Yes → Histogram (e.g., http.server.request.duration.seconds)
84
+ │ └─ No → Gauge (e.g., system.memory.usage.bytes)
85
+ └─ Legacy requirement for client-side percentiles?
86
+ └─ Yes → Summary
87
+ ```
88
+
89
+ ### 命名慣例
90
+
91
+ 遵循以下模式:`<domain>.<entity>.<action>.<unit>`
92
+
93
+ | 組成部分 | 說明 | 範例 |
94
+ |-----------|-------------|---------|
95
+ | `domain` | 系統領域 | `http`, `db`, `queue`, `system` |
96
+ | `entity` | 資源類型 | `server`, `client`, `connection` |
97
+ | `action` | 量測項目 | `request`, `query`, `usage` |
98
+ | `unit` | 量測單位 | `seconds`, `bytes`, `total` |
99
+
100
+ **範例:**
101
+ - `http.server.request.duration.seconds` — HTTP 伺服器請求持續時間
102
+ - `http.server.request.total` — HTTP 總請求數(Counter)
103
+ - `db.client.query.duration.seconds` — 資料庫查詢持續時間
104
+ - `system.memory.usage.bytes` — 記憶體使用量(Gauge)
105
+ - `queue.consumer.lag.messages` — 以訊息數計的取用端延遲
106
+
107
+ **規則:**
108
+ - 多詞組成的部分使用 `snake_case`
109
+ - Gauge 與 Histogram 務必包含單位後綴
110
+ - Counter 使用 `.total` 後綴
111
+ - 避免縮寫(使用 `request` 而非 `req`)
112
+
113
+ ### Label 最佳實踐
114
+
115
+ Label(亦稱標籤 tags 或屬性 attributes)為 Metric 增添維度。
116
+
117
+ **Do:**
118
+ - 使用具有有界、低基數(low-cardinality)值的 Label
119
+ - 常見 Label:`method`、`status_code`、`service`、`environment`
120
+ - 在相關的 Metric 之間保持 Label 集合的一致性
121
+
122
+ **Don't — 預防高基數:**
123
+
124
+ > ⚠️ **警告**:基數超過 **1000 個唯一值**的 Label 會導致過度的記憶體使用量與儲存成本。高基數資料(使用者 ID、請求 ID、IP 位址)應記錄在 **Logs 或 Traces** 中,而非作為 Metric Label。
125
+
126
+ | 不佳(高基數) | 良好(低基數) |
127
+ |------------------------|----------------------|
128
+ | `user_id="usr_12345"` | 使用帶有 `user_id` 欄位的 Logs |
129
+ | `request_id="req_abc"` | 使用帶有 `span_id` 的 Traces |
130
+ | `url="/api/users/12345"` | `route="/api/users/{id}"` |
131
+ | `ip="192.168.1.100"` | `region="us-east-1"` |
47
132
 
48
133
  ---
49
134
 
50
- ## Golden Signals(黃金信號)
135
+ ## Traces
136
+
137
+ ### Span 設計原則
138
+
139
+ Span 代表一次追蹤中的單一工作單元。
140
+
141
+ **命名:**
142
+ - 使用具描述性的名稱:`db.query.users.findById`、`http.server.POST./api/orders`
143
+ - 包含操作類型與目標
144
+ - 避免使用如 `doWork` 或 `process` 等通用名稱
145
+
146
+ **必要 Span 屬性:**
147
+ | 屬性 | 說明 | 範例 |
148
+ |-----------|-------------|---------|
149
+ | `service.name` | 服務識別 | `payment-service` |
150
+ | `span.kind` | Client/Server/Internal | `SERVER` |
151
+ | 操作專屬屬性 | 取決於操作類型 | `http.method=POST` |
152
+
153
+ **粒度指引:**
154
+ - **太粗**:整個請求處理只有一個 Span → 無法看清瓶頸
155
+ - **太細**:每個函式呼叫一個 Span → 過多的額外負擔與雜訊
156
+ - **恰到好處**:每個重大 I/O 操作或業務步驟一個 Span
157
+
158
+ **經驗法則:** 在以下情況建立 Span:
159
+ 1. 跨越網路邊界(HTTP 呼叫、資料庫查詢、訊息發送)
160
+ 2. 發生具業務重要性的步驟(建立訂單、處理付款)
161
+ 3. 發生潛在的緩慢操作(檔案 I/O、計算 > 10ms)
51
162
 
52
- 每個服務上線前應監控:
163
+ ### 取樣策略
53
164
 
54
- | 信號 | 量測 | 建議指標 |
55
- |------|------|---------|
56
- | **Latency(延遲)** | P50、P95、P99 百分位數 | `http.server.request.duration.seconds` |
57
- | **Traffic(流量)** | 每秒請求數(RPS) | `http.server.request.total` |
58
- | **Errors(錯誤)** | 錯誤 / 總請求(百分比) | 5xx / total |
59
- | **Saturation(飽和度)** | CPU、記憶體、連線池使用率 | `system.cpu.utilization` 等 |
165
+ 正式環境的追蹤可能會產生龐大的資料量。使用取樣來控制成本,同時保有可觀測性。
166
+
167
+ | 策略 | 運作方式 | 優點 | 缺點 | 使用時機 |
168
+ |----------|-------------|------|------|----------|
169
+ | **Head-based** | 在追蹤開始時決策(例如:10% 取樣率) | 簡單、低額外負擔、成本可預測 | 可能遺漏重要追蹤(錯誤、緩慢) | 高流量服務、成本敏感情境 |
170
+ | **Tail-based** | 在追蹤完成後決策(保留錯誤/緩慢追蹤) | 保留異常、擷取重要追蹤 | 需要緩衝區、資源用量較高 | 錯誤偵測、效能分析 |
171
+ | **Adaptive** | 根據流量動態調整比例 | 應對突發流量、成本平衡 | 實作與調校較複雜 | 流量模式多變的服務 |
172
+
173
+ **建議:**
174
+ - 大多數服務先從 Head-based 取樣(1-10%)開始
175
+ - 對於必須擷取錯誤的關鍵路徑,加入 Tail-based 取樣
176
+ - 流量 > 10K RPS 的服務可考慮採用 Adaptive 取樣
177
+
178
+ ### 效能負擔控制
179
+
180
+ 追蹤會增加額外負擔。請將其控制在可管理範圍內:
181
+
182
+ | 指標 | 目標 | 超標時處置 |
183
+ |--------|--------|-------------------|
184
+ | CPU 負擔 | < 2% | 降低取樣率 |
185
+ | 記憶體負擔 | < 50MB | 減少 Span 屬性數量 |
186
+ | 網路負擔 | < 流量的 1% | 批次匯出、壓縮 |
187
+ | 延遲影響 | 每個 Span < 1ms | 使用非同步匯出 |
188
+
189
+ ### 跨服務傳遞
190
+
191
+ 對於分散式系統,使用 W3C Trace Context 標準傳遞追蹤上下文:
192
+
193
+ **W3C Trace Context 標頭:**
194
+ ```
195
+ traceparent: 00-<trace_id>-<span_id>-<flags>
196
+ tracestate: <vendor>=<value>
197
+ ```
198
+
199
+ **跨邊界傳遞:**
200
+ - **HTTP**:`traceparent` 與 `tracestate` 標頭
201
+ - **gRPC**:Metadata 鍵值
202
+ - **訊息佇列**:訊息標頭/屬性
203
+ - **非同步工作**:儲存在工作詮釋資料(job metadata)中
204
+
205
+ ---
206
+
207
+ ## Golden Signals 檢查清單
208
+
209
+ 根據 Google SRE 的四個黃金信號(Four Golden Signals),每個服務在進入正式環境前都應(SHOULD)監控以下項目:
210
+
211
+ ### 延遲(Latency)
212
+
213
+ | 面向 | 量測方式 | 建議指標 |
214
+ |--------|------------|-------------------|
215
+ | 請求持續時間 | 使用 Histogram 的 P50、P95、P99 百分位數 | `http.server.request.duration.seconds` |
216
+ | 成功與失敗比較 | 分開計算成功/錯誤回應的延遲 | 新增 `status` 標籤 |
217
+ | 告警門檻 | P99 > X ms 持續 5 分鐘 | 基於 SLO 目標 |
218
+
219
+ ### 流量(Traffic)
220
+
221
+ | 面向 | 量測方式 | 建議指標 |
222
+ |--------|------------|-------------------|
223
+ | 請求量 | 每秒請求數(RPS) | `http.server.request.total`(Counter,rate) |
224
+ | 依端點 | 依路由/方法細分 | 新增 `route`、`method` 標籤 |
225
+ | 告警門檻 | 突降 > 50% 或突增 > 200% | 與上週同期相比 |
226
+
227
+ ### 錯誤(Errors)
228
+
229
+ | 面向 | 量測方式 | 建議指標 |
230
+ |--------|------------|-------------------|
231
+ | 錯誤率 | 錯誤數 / 總請求數(百分比) | `http.server.request.total{status=~"5.."}` / `http.server.request.total` |
232
+ | 依類型 | 依錯誤碼/類別細分 | 新增 `status_code`、`error_type` 標籤 |
233
+ | 告警門檻 | 錯誤率 > X% 持續 5 分鐘 | 基於 SLO 目標 |
234
+
235
+ ### 飽和度(Saturation)
236
+
237
+ | 面向 | 量測方式 | 建議指標 |
238
+ |--------|------------|-------------------|
239
+ | CPU 使用率 | 可用 CPU 百分比 | `system.cpu.utilization`(Gauge) |
240
+ | 記憶體使用率 | 可用記憶體百分比 | `system.memory.utilization`(Gauge) |
241
+ | 連線池 | 活躍/最大連線數 | `db.client.connection.pool.usage`(Gauge) |
242
+ | 磁碟 I/O | 讀取/寫入吞吐量與佇列深度 | `system.disk.io`(Counter) |
243
+ | 告警門檻 | 資源 > 80% 持續 10 分鐘 | 飽和前預警 |
60
244
 
61
245
  ---
62
246
 
63
247
  ## 可觀測性成熟度模型
64
248
 
65
- | 等級 | 名稱 | 特徵 |
66
- |------|------|------|
67
- | **L0** | 無可觀測性 | 無結構化日誌;僅 stdout/stderr |
68
- | **L1** | 基礎日誌 | 結構化 Logs + JSON 格式 + 集中收集 |
69
- | **L2** | 指標驅動 | Logs + Metrics + 儀表板 + 基礎告警 |
70
- | **L3** | 完整可觀測性 | 三大支柱運作 + 關聯查詢 + SLO 告警 |
71
- | **L4** | 智慧可觀測性 | AIOps 異常偵測 + 預測告警 + 自動修復 |
249
+ 使用此模型來評估團隊目前的可觀測性水準並規劃改善措施:
250
+
251
+ | 等級 | 名稱 | 特徵 | 升級行動 |
252
+ |-------|------|----------------|-----------------|
253
+ | **L0** | 無可觀測性 | 無結構化日誌;僅有 stdout/stderr;透過 SSH 與 `tail -f` 進行除錯 | 實作結構化日誌;集中收集日誌 |
254
+ | **L1** | 基礎日誌 | 採用 JSON 格式的結構化 Logs;集中收集;具備基礎搜尋能力 | 新增關鍵業務指標;建立第一個儀表板 |
255
+ | **L2** | 指標驅動 | Logs + Metrics 就緒;為關鍵服務建立儀表板;基於門檻值的基礎告警 | 啟用分散式追蹤;實作基於 SLO 的告警 |
256
+ | **L3** | 完整可觀測性 | 三大支柱皆運作;關聯查詢運作正常;基於 SLO 的告警;監控黃金信號 | 新增異常偵測;針對已知問題實作自動修復 |
257
+ | **L4** | 智慧可觀測性 | AIOps 異常偵測;預測性告警;自動修復;持續最佳化 | 維護與最佳化;在組織內分享經驗學習 |
258
+
259
+ **自我評估問題:**
260
+ 1. 您能否在所有服務中找到特定請求的日誌?(L1+)
261
+ 2. 您能否檢視顯示目前錯誤率與延遲的儀表板?(L2+)
262
+ 3. 您能否追蹤一個請求從 ingress 到資料庫並返回的完整流程?(L3+)
263
+ 4. 您的系統能否在使用者回報之前自動偵測異常?(L4)
264
+
265
+ ---
266
+
267
+ ## 檢測檢查清單
268
+
269
+ 在將服務部署至正式環境之前,請驗證以下項目:
270
+
271
+ - [ ] **啟用結構化日誌** — 採用具備 `trace_id` 關聯的 JSON 格式(參閱 [日誌標準](logging-standards.md))
272
+ - [ ] **HTTP/gRPC 入口指標** — 所有端點的請求數、持續時間直方圖與錯誤率
273
+ - [ ] **關鍵業務操作自訂指標** — 追蹤關鍵業務事件(已建立訂單、已處理付款)
274
+ - [ ] **啟用分散式追蹤** — 設定 Span 傳遞、設定取樣率、支援 W3C Trace Context 標頭
275
+ - [ ] **健康檢查端點** — 實作存活探針(liveness probe,程序是否正在執行?)與就緒探針(readiness probe,是否能處理流量?)
276
+ - [ ] **涵蓋黃金信號的儀表板** — 至少將延遲(Latency)、流量(Traffic)、錯誤(Errors)與飽和度(Saturation)視覺化
277
+ - [ ] **定義告警規則** — 至少設定 SLO 燃燒率告警(參閱 [告警標準](alerting-standards.md))
278
+ - [ ] **設定日誌保留期** — 依日誌等級設定保留政策
279
+ - [ ] **排除敏感資料** — 日誌/追蹤中不含密碼、權杖(token)或個人識別資訊(PII)
280
+
281
+ ---
282
+
283
+ ## OpenTelemetry 整合
284
+
285
+ OpenTelemetry(OTel)是建議使用的檢測框架。有關詳細的 OTel 語意慣例與整合模式,請參閱 [日誌標準 — OpenTelemetry 整合](logging-standards.md#opentelemetry-integration) 章節。
286
+
287
+ 重點摘要:
288
+ - 在支援處使用 OTel SDK 進行自動檢測(auto-instrumentation)
289
+ - 屬性命名遵循 OTel 語意慣例
290
+ - 匯出至 OTel Collector 以建立中立於廠商的資料管線
72
291
 
73
292
  ---
74
293
 
@@ -76,31 +295,56 @@ status: current
76
295
 
77
296
  ### Metric 類型選擇
78
297
  ```
79
- 只會增加? → Counter
80
- 可增可減? → Gauge
81
- 需要分布? → Histogram
82
- 客戶端百分位數? → Summary
298
+ Only goes up? → Counter
299
+ Goes up and down? → Gauge
300
+ Need distribution? → Histogram
301
+ Client percentiles? → Summary
83
302
  ```
84
303
 
85
304
  ### 取樣策略選擇
86
305
  ```
87
- 高流量、成本敏感? → Head-based(1-10%)
88
- 必須擷取所有錯誤? → Tail-based
89
- 流量變化大? → Adaptive
306
+ High traffic, cost-sensitive? → Head-based (1-10%)
307
+ Must capture all errors? → Tail-based
308
+ Traffic varies widely? → Adaptive
90
309
  ```
91
310
 
92
311
  ### 成熟度等級快速檢查
93
312
  ```
94
- 無結構化日誌? → L0
95
- 結構化日誌、已集中? → L1
96
- Logs + Metrics + 儀表板? → L2
97
- 三大支柱 + SLO 告警? → L3
98
- AIOps + 自動修復? → L4
313
+ No structured logs? → L0
314
+ Structured logs, centralized? → L1
315
+ Logs + Metrics + Dashboards? → L2
316
+ All three pillars + SLO alerts? → L3
317
+ AIOps + Auto-remediation? → L4
99
318
  ```
100
319
 
101
320
  ---
102
321
 
322
+ ## 參考資料
323
+
324
+ - [OpenTelemetry 規格](https://opentelemetry.io/docs/specs/otel/) — 可觀測性檢測的業界標準
325
+ - [OpenTelemetry 語意慣例](https://opentelemetry.io/docs/specs/semconv/) — 標準化屬性命名
326
+ - [W3C Trace Context](https://www.w3.org/TR/trace-context/) — 分散式追蹤上下文傳遞
327
+ - [Google SRE — Monitoring Distributed Systems](https://sre.google/sre-book/monitoring-distributed-systems/) — 黃金信號起源
328
+ - [Google SRE — Alerting on SLOs](https://sre.google/workbook/alerting-on-slos/) — 多時間窗口燃燒率告警
329
+
330
+ ---
331
+
103
332
  **相關標準:**
104
333
  - [日誌標準](logging-standards.md) — 完整 Logs 支柱指引
105
334
  - [SLO 標準](slo-standards.md) — SLI/SLO/Error Budget 定義
106
335
  - [告警標準](alerting-standards.md) — 告警設計與管理
336
+ - [效能標準](performance-standards.md) — 效能目標與基準測試
337
+
338
+ ---
339
+
340
+ ## 版本歷史
341
+
342
+ | 版本 | 日期 | 變更 |
343
+ |---------|------|---------|
344
+ | 1.0.0 | 2026-03-31 | 初版發布:Metrics、Traces、黃金信號、成熟度模型、檢測檢查清單 |
345
+
346
+ ---
347
+
348
+ ## 授權條款
349
+
350
+ 本標準依 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 釋出。