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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (711) hide show
  1. package/bin/uds.js +12 -1
  2. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  3. package/bundled/ai/standards/commit-message.ai.yaml +12 -2
  4. package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
  5. package/bundled/core/commit-message-guide.md +22 -19
  6. package/bundled/core/secret-management-standards.md +13 -1
  7. package/bundled/extensions/locales/zh-tw.md +19 -19
  8. package/bundled/hooks/validate-commit-msg.mjs +52 -9
  9. package/bundled/locales/zh-CN/CHANGELOG.md +2309 -1110
  10. package/bundled/locales/zh-CN/CLAUDE.md +987 -101
  11. package/bundled/locales/zh-CN/README.md +3 -3
  12. package/bundled/locales/zh-CN/SECURITY.md +3 -3
  13. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  14. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
  15. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  16. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
  17. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
  18. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
  19. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
  20. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  21. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  22. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  23. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  24. package/bundled/locales/zh-CN/core/accessibility-standards.md +871 -62
  25. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  26. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  27. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  28. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  29. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  30. package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +311 -72
  31. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  32. package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
  33. package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
  34. package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
  35. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  36. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  37. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  38. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  39. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  40. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  41. package/bundled/locales/zh-CN/core/changelog-standards.md +485 -63
  42. package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
  43. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  44. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  45. package/bundled/locales/zh-CN/core/code-review-checklist.md +37 -23
  46. package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
  47. package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
  48. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  49. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  50. package/bundled/locales/zh-CN/core/deprecation-standards.md +155 -40
  51. package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
  52. package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
  53. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  54. package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
  55. package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
  56. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  57. package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
  58. package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
  59. package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
  60. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  61. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  62. package/bundled/locales/zh-CN/core/feature-flag-standards.md +202 -57
  63. package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
  64. package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
  65. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  66. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  67. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  68. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  69. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  70. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  71. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  72. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  73. package/bundled/locales/zh-CN/core/mutation-testing.md +45 -6
  74. package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
  75. package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
  76. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  77. package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
  78. package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
  79. package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
  80. package/bundled/locales/zh-CN/core/project-structure.md +550 -170
  81. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  82. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  83. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  84. package/bundled/locales/zh-CN/core/retrospective-standards.md +215 -22
  85. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  86. package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
  87. package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
  88. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  89. package/bundled/locales/zh-CN/core/security-standards.md +169 -16
  90. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  91. package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
  92. package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
  93. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  94. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  95. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  96. package/bundled/locales/zh-CN/core/supply-chain-security-standards.md +159 -32
  97. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  98. package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
  99. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  100. package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
  101. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  102. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  103. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  104. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  105. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  106. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  107. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  108. package/bundled/locales/zh-CN/core/versioning.md +737 -73
  109. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  110. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  111. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  112. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +2 -1
  113. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  114. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
  115. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
  116. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  117. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
  118. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  119. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
  120. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  121. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  122. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +2 -0
  123. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  124. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  125. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  126. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  127. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  128. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  129. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  130. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  131. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  132. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  133. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  134. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  135. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  136. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  137. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  138. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  139. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  140. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  141. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  142. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  143. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  144. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  145. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  146. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  147. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  148. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  149. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  150. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  151. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  152. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  153. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  154. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  155. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  156. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  157. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  158. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  159. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  160. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  161. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  162. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  163. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  164. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  165. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  166. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  167. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  168. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  169. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  170. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  171. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  172. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  173. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  174. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  175. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  176. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  177. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  178. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  179. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  180. package/bundled/locales/zh-CN/skills/README.md +2 -1
  181. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  182. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  183. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  184. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  185. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  186. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  187. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  188. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  189. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  190. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  191. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  192. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  193. package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +217 -137
  194. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  195. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  196. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  197. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  198. package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +148 -132
  199. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  200. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  201. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  202. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  203. package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +122 -121
  204. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  205. package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
  206. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  207. package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
  208. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  209. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  210. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  211. package/bundled/locales/zh-CN/skills/code-review-assistant/guide.md +119 -45
  212. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  213. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  214. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  215. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  216. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  217. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  218. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  219. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  220. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  221. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  222. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  223. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  224. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  225. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  226. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  227. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  228. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  229. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  230. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  231. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  232. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  233. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  234. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  235. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  236. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  237. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  238. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  239. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  240. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  241. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  242. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  243. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  244. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  245. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  246. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  247. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  248. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  249. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  250. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  251. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  252. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  253. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  254. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  255. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  256. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  257. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  258. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  259. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  260. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  261. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +4 -4
  262. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  263. package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
  264. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  265. package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
  266. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  267. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  268. package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +4 -2
  269. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  270. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  271. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  272. package/bundled/locales/zh-CN/skills/docs-generator/guide.md +8 -7
  273. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  274. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  275. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  276. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  277. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  278. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  279. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  280. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  281. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  282. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  283. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  284. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  285. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  286. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  287. package/bundled/locales/zh-CN/skills/project-discovery/guide.md +158 -157
  288. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  289. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  290. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  291. package/bundled/locales/zh-CN/skills/refactoring-assistant/guide.md +172 -171
  292. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  293. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  294. package/bundled/locales/zh-CN/skills/release-standards/guide.md +51 -43
  295. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  296. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  297. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  298. package/bundled/locales/zh-CN/skills/requirement-assistant/guide.md +88 -79
  299. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  300. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  301. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  302. package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +2 -2
  303. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  304. package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
  305. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  306. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  307. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  308. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  309. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  310. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  311. package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +2 -2
  312. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  313. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  314. package/bundled/locales/zh-CN/skills/tdd-assistant/guide.md +217 -156
  315. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  316. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  317. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  318. package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +25 -12
  319. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  320. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  321. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  322. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  323. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  324. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  325. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  326. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  327. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  328. package/bundled/locales/zh-TW/CHANGELOG.md +2282 -1112
  329. package/bundled/locales/zh-TW/CLAUDE.md +962 -76
  330. package/bundled/locales/zh-TW/README.md +3 -3
  331. package/bundled/locales/zh-TW/SECURITY.md +3 -3
  332. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  333. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
  334. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  335. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
  336. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
  337. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
  338. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
  339. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  340. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  341. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  342. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  343. package/bundled/locales/zh-TW/core/accessibility-standards.md +895 -46
  344. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  345. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  346. package/bundled/locales/zh-TW/core/agent-dispatch.md +102 -33
  347. package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
  348. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  349. package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
  350. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  351. package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
  352. package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
  353. package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
  354. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  355. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  356. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  357. package/bundled/locales/zh-TW/core/branch-completion.md +130 -34
  358. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  359. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  360. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  361. package/bundled/locales/zh-TW/core/chaos-engineering-standards.md +138 -36
  362. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  363. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  364. package/bundled/locales/zh-TW/core/code-review-checklist.md +19 -7
  365. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  366. package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
  367. package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
  368. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  369. package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
  370. package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
  371. package/bundled/locales/zh-TW/core/developer-memory.md +102 -12
  372. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  373. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  374. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  375. package/bundled/locales/zh-TW/core/environment-standards.md +250 -72
  376. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  377. package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
  378. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  379. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  380. package/bundled/locales/zh-TW/core/feature-flag-standards.md +202 -57
  381. package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
  382. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  383. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  384. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  385. package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +234 -487
  386. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  387. package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
  388. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  389. package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
  390. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  391. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  392. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  393. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  394. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  395. package/bundled/locales/zh-TW/core/observability-standards.md +284 -40
  396. package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
  397. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  398. package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
  399. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  400. package/bundled/locales/zh-TW/core/project-context-memory.md +210 -31
  401. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  402. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  403. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  404. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  405. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  406. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  407. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  408. package/bundled/locales/zh-TW/core/runbook-standards.md +296 -23
  409. package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
  410. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  411. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  412. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  413. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  414. package/bundled/locales/zh-TW/core/slo-standards.md +301 -49
  415. package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
  416. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  417. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  418. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  419. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  420. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  421. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  422. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  423. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  424. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  425. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  426. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  427. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  428. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  429. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  430. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  431. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  432. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  433. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  434. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  435. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +2 -1
  436. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  437. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
  438. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  439. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
  440. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  441. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
  442. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  443. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
  444. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  445. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  446. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +2 -0
  447. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  448. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  449. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  450. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  451. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  452. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  453. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  454. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  455. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  456. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  457. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  458. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  459. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  460. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  461. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  462. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  463. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  464. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  465. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  466. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  467. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  468. package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +584 -475
  469. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  470. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  471. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  472. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  473. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  474. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  475. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  476. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  477. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  478. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  479. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  480. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  481. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  482. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  483. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  484. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  485. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  486. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  487. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  488. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  489. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  490. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  491. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  492. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  493. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  494. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  495. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  496. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  497. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  498. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  499. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  500. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  501. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  502. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  503. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  504. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  505. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  506. package/bundled/locales/zh-TW/skills/README.md +2 -1
  507. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  508. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  509. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  510. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  511. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  512. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  513. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  514. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  515. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  516. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  517. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  518. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  519. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  520. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  521. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  522. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  523. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  524. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  525. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  526. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  527. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  528. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  529. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  530. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  531. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  532. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  533. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  534. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  535. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  536. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  537. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  538. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  539. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  540. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  541. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  542. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  543. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  544. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  545. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  546. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  547. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  548. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  549. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  550. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  551. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  552. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  553. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  554. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  555. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  556. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  557. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  558. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  559. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  560. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  561. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  562. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  563. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  564. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  565. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  566. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  567. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  568. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  569. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  570. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  571. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  572. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  573. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  574. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  575. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  576. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  577. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  578. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  579. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  580. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  581. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  582. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  583. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  584. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  585. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  586. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  587. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  588. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  589. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  590. package/bundled/locales/zh-TW/skills/commit-standards/guide.md +137 -17
  591. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  592. package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
  593. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  594. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  595. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  596. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  597. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  598. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  599. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  600. package/bundled/locales/zh-TW/skills/docs-generator/guide.md +4 -3
  601. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  602. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  603. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  604. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  605. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  606. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  607. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  608. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  609. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  610. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  611. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  612. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  613. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  614. package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +85 -18
  615. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  616. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  617. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  618. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  619. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  620. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  621. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  622. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  623. package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +91 -45
  624. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  625. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  626. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  627. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  628. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  629. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  630. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  631. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  632. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  633. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  634. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  635. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  636. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  637. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  638. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  639. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  640. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  641. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  642. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  643. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  644. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  645. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  646. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  647. package/bundled/locales/zh-TW/skills/tdd-assistant/language-examples.md +693 -47
  648. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  649. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  650. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  651. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  652. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  653. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  654. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  655. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  656. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  657. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  658. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  659. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  660. package/bundled/skills/.claude-plugin/plugin.json +71 -0
  661. package/bundled/skills/commit-standards/SKILL.md +2 -2
  662. package/bundled/skills/commit-standards/guide.md +3 -2
  663. package/bundled/skills/commit-standards/language-options.md +19 -17
  664. package/package.json +2 -2
  665. package/src/commands/audit.js +28 -1
  666. package/src/commands/check.js +72 -3
  667. package/src/commands/compile.js +37 -4
  668. package/src/commands/config.js +49 -24
  669. package/src/commands/init.js +78 -30
  670. package/src/commands/open-work.js +6 -2
  671. package/src/commands/release-messages.js +228 -0
  672. package/src/commands/release.js +127 -68
  673. package/src/commands/run-intent.js +11 -0
  674. package/src/commands/spec.js +4 -2
  675. package/src/commands/update.js +173 -20
  676. package/src/compilers/claude-code-compiler.js +9 -1
  677. package/src/config/ai-agent-paths.js +14 -1
  678. package/src/core/installed-formats.js +15 -0
  679. package/src/core/open-work-config.js +20 -1
  680. package/src/core/project-config.js +55 -0
  681. package/src/i18n/messages.js +106 -2
  682. package/src/installers/hooks-installer.js +1 -1
  683. package/src/installers/manifest-installer.js +1 -1
  684. package/src/installers/skills-installer.js +1 -1
  685. package/src/installers/standards-installer.js +3 -1
  686. package/src/mcp/server.js +9 -3
  687. package/src/prompts/init.js +26 -22
  688. package/src/reconciler/actual-state-scanner.js +2 -8
  689. package/src/reconciler/backup-locations.js +5 -0
  690. package/src/reconciler/backup-manager.js +19 -11
  691. package/src/reconciler/desired-state-calculator.js +89 -57
  692. package/src/reconciler/plan-executor.js +101 -8
  693. package/src/reconciler/recorded-versions.js +49 -0
  694. package/src/reconciler/relative-path.js +23 -0
  695. package/src/uninstallers/hook-uninstaller.js +9 -1
  696. package/src/uninstallers/skills-uninstaller.js +22 -3
  697. package/src/utils/available-standards-report.js +25 -4
  698. package/src/utils/available-standards.js +13 -3
  699. package/src/utils/build-manifest.js +1 -1
  700. package/src/utils/commit-message-judge.js +60 -13
  701. package/src/utils/friction-detector.js +23 -11
  702. package/src/utils/git-hooks.js +106 -4
  703. package/src/utils/integration-generator.js +95 -67
  704. package/src/utils/legacy-hook-migration.js +121 -2
  705. package/src/utils/open-work-tracking.mjs +105 -16
  706. package/src/utils/sdd-header.js +16 -4
  707. package/src/utils/skills-installer.js +2 -1
  708. package/src/utils/spinner.js +14 -4
  709. package/src/utils/standard-validator.js +3 -2
  710. package/standards-registry.json +10 -8
  711. package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
@@ -2,36 +2,39 @@
2
2
  source: ../../../core/ai-instruction-standards.md
3
3
  source_version: 1.1.1
4
4
  translation_version: 1.1.1
5
- last_synced: 2026-08-19
5
+ last_synced: 2026-10-11
6
+ source_hash: 64bcd0b65483
6
7
  status: current
7
8
  ---
8
9
 
9
10
  # AI 指令文件规范
10
11
 
11
- > **语言**: [English](../../../core/ai-instruction-standards.md) | [简体中文](../../zh-TW/core/ai-instruction-standards.md) | 简体中文
12
+ > **语言**: [English](../../../core/ai-instruction-standards.md) | [繁體中文](../../zh-TW/core/ai-instruction-standards.md) | 简体中文
12
13
 
13
- **版本**: 1.1.0
14
- **最后更新**: 2026-05-28
14
+ **版本**: 1.1.1
15
+ **最后更新**: 2026-08-19
15
16
  **适用范围**: 所有使用 AI 编码助手的项目
17
+ **范围**: partial
18
+ **行业标准**: 无(新兴 AI 工具实践)
16
19
 
17
20
  ---
18
21
 
19
22
  ## 目的
20
23
 
21
- 本规范定义创建和维护 AI 指令文件(又称「系统提示词文件」)的最佳实践。这些文件引导 AI 助手理解项目特定的惯例、标准和工作流程。
24
+ 本规范定义创建和维护 AI 指令文件(又称「系统提示词文件」)的最佳实践。这些文件引导 AI 助手理解项目特定的惯例、标准和工作流程。v1.1.0 将范围扩展到 skill 层级的指令文件(SKILL.md),并新增 i18n 策略。
22
25
 
23
26
  ---
24
27
 
25
28
  ## 支持的 AI 工具
26
29
 
27
- | AI 工具 | 指令文件 | 格式 |
28
- |---------|---------|------|
29
- | Claude Code | `CLAUDE.md` | Markdown |
30
- | Cursor | `.cursorrules` | Markdown |
31
- | Windsurf | `.windsurfrules` | Markdown |
32
- | Cline | `.clinerules` | Markdown |
33
- | GitHub Copilot | `.github/copilot-instructions.md` | Markdown |
34
- | OpenCode | `.opencode/instructions.md` | Markdown |
30
+ | AI 工具 | 指令文件 | 格式 | Skill 层级指令 |
31
+ |---------|---------|------|---------------|
32
+ | Claude Code | `CLAUDE.md` | Markdown | `.claude/skills/{name}/SKILL.md` |
33
+ | Cursor | `.cursorrules` | Markdown | n/a |
34
+ | Windsurf | `.windsurfrules` | Markdown | n/a |
35
+ | Cline | `.clinerules` | Markdown | n/a |
36
+ | GitHub Copilot | `.github/copilot-instructions.md` | Markdown | n/a |
37
+ | OpenCode | `.opencode/instructions.md` | Markdown | n/a |
35
38
 
36
39
  ---
37
40
 
@@ -173,85 +176,104 @@ AI 指令档常需提供多语言版本——既为了国际采用者,也为
173
176
  | 层 | 内容 | Canonical (en) | Locale ({lang}) | 为何分这层 |
174
177
  |----|------|---------------|----------------|-----------|
175
178
  | **L1 — Metadata** | YAML frontmatter `description`、`argument-hint`、`allowed-tools` | **必须英文** | **必须对应 locale 语言** | AI 触发讯号;英文 token 效率最高 + 训练语料密度高 |
176
- | **L2 — 指令(Instructions)** | 对 AI 的命令式规则 | **必须英文** | 对应 locale 语言(可选;可保留英文)| AI 读英文指令最精准 |
177
- | **L3 — 输出范本(Output Templates)** | 范例输出、回应格式、情境范本 | 英文(canonical 锁定英文)| **强制对应 locale**(mandatory)| **唯一直接影响 AI 输出语言的层** |
178
- | **L4 — 人类文件** | 维护者注解、贡献者说明 | 英文 | 对应 locale 语言(强烈建议)| 给人类维护者读,AI 不读 |
179
+ | **L2 — 指令(Instructions)** | 对 AI 的命令式规则(步骤、行为、allowed-tools 的理由) | **必须英文** | 对应 locale 语言(可选;可保留英文)| AI 读英文指令最精准;只有维护者需要以自己的语言阅读指令时,locale 版才有用 |
180
+ | **L3 — 输出范本(Output Templates)** | 范例输出、回应格式、情境范本 | 英文(canonical 锁定英文)| **强制对应 locale**(mandatory)| **唯一直接影响 AI 输出语言的层**——AI 会沿用它看到的范本语言 |
181
+ | **L4 — 人类文件** | 维护者注解、操作说明、贡献者说明 | 英文 | 对应 locale 语言(强烈建议)| 给人类维护者读,AI 不读 |
179
182
 
180
- **关键 insight**:L1(description)是 AI 用来决定「**是否调用**」此 skill 的触发讯号——它**不**影响 AI 之后说什么。L3(output template)才是控制 AI 输出语言的唯一开关。**i18n 强制检查应该聚焦在 L3——加强 L1 的强制是常见错误。**
183
+ **关键 insight**:L1(description)是 AI 用来决定「**是否调用**」此 skill 的触发讯号——它**不**影响 AI 之后说什么。L3(output template)才是控制 AI 输出语言的唯一开关,因为 AI 会模仿它看到的范本语言。**i18n 强制检查应该聚焦在 L3——加强 L1 的强制是常见错误,解决的是错的问题。**
181
184
 
182
185
  ### Canonical / Locale 档案结构
183
186
 
184
187
  UDS 标准与 skill 的 locale 变体结构:
185
188
 
186
189
  ```text
187
- core/{name}.md
188
- core/{name}.ai.yaml
189
- locales/{lang}/core/{name}.md
190
- locales/{lang}/ai/standards/{name}.ai.yaml
191
- skills/{name}/SKILL.md
192
- locales/{lang}/skills/{name}/SKILL.md
190
+ core/{name}.md ← canonical (English) — single source of truth
191
+ core/{name}.ai.yaml ← canonical structured (English)
192
+ locales/{lang}/core/{name}.md ← locale variant (matches lang)
193
+ locales/{lang}/ai/standards/{name}.ai.yaml ← locale .ai.yaml (matches lang)
194
+ skills/{name}/SKILL.md ← canonical skill (English)
195
+ locales/{lang}/skills/{name}/SKILL.md ← locale skill variant
193
196
  ```
194
197
 
195
198
  **命名惯例**:使用 BCP 47 语言标签——`zh-TW`、`zh-CN`、`ja`、`ko`、`en-US` 等。
196
199
 
197
200
  ### Locale 变体 Frontmatter 必填栏位
198
201
 
202
+ 每个 locale 变体都必须带有可追溯的 frontmatter,才能侦测漂移:
203
+
199
204
  ```yaml
200
205
  ---
201
- name: {与 canonical 同名}
202
- source: {指回 canonical 的相对路径}
203
- source_version: {翻译时 canonical 的版本}
204
- translation_version: {本翻译的版本}
206
+ name: {same name as canonical}
207
+ source: {relative path back to canonical}
208
+ source_version: {version of canonical at time of translation}
209
+ translation_version: {version of this translation}
205
210
  ---
206
211
  ```
207
212
 
208
- `source_version` 落后超过 2 个 minor 版本会触发 drift 警告。
213
+ canonical 更新(bump `source_version`)时,locale 维护者应重新同步并 bump `translation_version`。`source_version` 落后超过 2 个 minor 版本会触发 drift 警告(见「Chimera 防范」)。
209
214
 
210
215
  ### 责任边界
211
216
 
212
217
  | 角色 | 拥有 | 必须做 |
213
218
  |------|------|--------|
214
- | **Canonical 拥有者** | `core/{name}.md` 等 | 维持 L1/L2/L3/L4 为英文;breaking change 时 bump `source_version` |
215
- | **Locale 维护者** | `locales/{lang}/...` | `translation_version` 对齐 `source_version`;翻译 L1(必)、L2(选)、L3(必)、L4(建议)|
216
- | **采用者** | 自己的 `.claude/skills/`、`CLAUDE.md` | 用 `uds init --locale {lang}`(首次)或 `uds update --locale {lang}`(重新同步)安装;**绝不**手动修改 canonical |
219
+ | **Canonical 拥有者** | `core/{name}.md`、`core/{name}.ai.yaml`、`skills/{name}/SKILL.md` | 维持 L1/L2/L3/L4 为英文;每次 breaking change 都 bump `source_version` |
220
+ | **Locale 维护者** | `locales/{lang}/...` 档案 | `translation_version` 对齐 `source_version`;翻译 L1(必)、L2(选)、L3(必)、L4(建议)|
221
+ | **采用者(下游项目)** | 自己的 `.claude/skills/`、`CLAUDE.md` 等 | 用 `uds init --locale {lang}`(首次)或 `uds update --locale {lang}`(重新同步)安装;**绝不**手动修改 canonical 档案(一律编辑 locale 变体或使用 overlay)|
217
222
 
218
223
  ### Chimera 防范
219
224
 
225
+ **Chimera** 指违反分层规则、混用语言的档案。常见的 chimera 模式:
226
+
220
227
  | 模式 | 严重度 | 侦测方式 |
221
228
  |------|--------|----------|
222
- | Canonical 的 `description` 含 CJK | ❌ Error | Lint |
223
- | Locale 变体的 `description` 是纯 ASCII | ❌ Error | Lint |
224
- | Locale 变体缺 `source:` frontmatter | ❌ Error | Lint |
225
- | Canonical L3 含非英文范例 | ⚠️ Warn | Lint |
226
- | 采用者档案与 canonical/locale 都不同 | ⚠️ Warn | Sync check |
227
- | `translation_version` 落后过多 | ⚠️ Warn | Drift check |
229
+ | Canonical 的 `description` 栏位含 CJK | ❌ Error | Lint: `canonical:description-must-be-ascii` |
230
+ | Locale 变体的 `description` 栏位是纯 ASCII | ❌ Error | Lint: `locale:description-must-match-language` |
231
+ | Locale 变体缺 `source:` frontmatter | ❌ Error | Lint: `locale:must-have-source-frontmatter` |
232
+ | Canonical L3 输出范本含非英文范例回应 | ⚠️ Warn | Lint: `canonical:l3-language-consistency` |
233
+ | `.claude/skills/` 中的采用者档案与 canonical 及任何 locale 变体都不同 | ⚠️ Warn | Sync check: `adopter:must-match-installed-locale` |
234
+ | `translation_version` 落后 `source_version` 超过 2 个 minor 版本 | ⚠️ Warn | Drift check |
235
+
236
+ Pre-commit / CI lint 应强制执行 error 级规则;warn 级规则显示在仪表板上,但不阻断。
228
237
 
229
238
  ### 采用者安装
230
239
 
240
+ 采用者通过 UDS CLI 安装指令档:
241
+
231
242
  ```bash
232
- uds init --locale zh-cn # 首次以简体中文安装 skills 与 standards
233
- uds update --locale zh-cn # 对既有采用重新同步
243
+ uds init --locale zh-tw # first-time install of skills + standards in Traditional Chinese
244
+ uds update --locale zh-tw # re-sync an existing adoption
234
245
  ```
235
246
 
236
- **Locale 解析优先顺序**:`--locale` flag > `.uds/install.yaml` > `UDS_LOCALE` env > fallback `en`
247
+ **Locale 解析优先顺序**:
248
+ 1. `--locale` CLI flag(最高优先)
249
+ 2. `.uds/install.yaml` 的 `locale:` 栏位
250
+ 3. 环境变量 `UDS_LOCALE`
251
+ 4. Fallback:`en`
252
+
253
+ **Locale 不存在时的 fallback**:某个 skill 没有所请求的 locale 变体时,CLI 会:
254
+ - 安装 canonical(英文)档案
255
+ - 发出 WARN,列出改用 fallback 的 skills
256
+ - **不**阻断安装
237
257
 
238
- Locale 不存在时 fallback 到 canonical + WARN,**不**阻断安装。
258
+ 这让 locale 覆盖不完整时,采用者仍能正常安装。采用者可查阅 `locales/COVERAGE.md`,取得哪些已翻译、哪些未翻译的权威清单。
239
259
 
240
260
  ### 迁移:已有 chimera 的采用者
241
261
 
242
- 1. **辨识 chimera**:比对采用者档案与 UDS canonical / locale 变体
243
- 2. **安装正确变体**:`uds update --locale {lang}`
244
- 3. **保留专案级客制**:抽出为 overlay
245
- 4. **丢弃纯翻译**:locale 变体取代之
262
+ 若采用者已在自己的项目中手动修改过 canonical 档案(例如翻译了 `.claude/skills/` 里的 description):
263
+
264
+ 1. **辨识 chimera**:比对采用者档案与 UDS canonical 及 canonical 的 locale 变体。
265
+ 2. **安装正确变体**:执行 `uds update --locale {lang}`,以 locale 变体取代 chimera 档案。
266
+ 3. **保留项目级客制**:若 chimera 含有正当的项目级客制(不只是翻译),将其抽出为 overlay,或记录在采用者的客制化纪录中(例如 `UDS-CUSTOMIZATION.md`)。
267
+ 4. **丢弃纯翻译**:只是翻译的 chimera 变更应丢弃——正确的 locale 变体会取代它们。
246
268
 
247
269
  ### 快速参考
248
270
 
249
271
  | 动作 | 何时 | 工具 / 档案 |
250
272
  |------|------|------------|
251
- | 新增语言支援 | 想支援新 locale | `locales/{lang}/...` |
252
- | 更新 canonical | 改进英文 source | Bump `source_version` |
253
- | 翻译 / 同步 locale | 新增或更新 locale 内容 | Bump `translation_version` |
254
- | 检查覆盖率 | 定期 review | `locales/COVERAGE.md` |
273
+ | 新增语言支援 | 想支援新 locale | 建立 `locales/{lang}/...`,镜射 canonical 结构 |
274
+ | 更新 canonical | 改进英文 source | Bump `source_version`;通知 locale 维护者 |
275
+ | 翻译 / 同步 locale | 新增或更新 locale 内容 | Bump `translation_version`;引用当前的 `source_version` |
276
+ | 检查覆盖率 | 定期 review | 查看自动产生的 `locales/COVERAGE.md` |
255
277
  | 带 locale 安装 | 采用者初设 | `uds init --locale {lang}` |
256
278
  | 带 locale 重新同步 | 既有采用 | `uds update --locale {lang}` |
257
279
  | 跑 i18n lint | Commit 前 / CI | `uds check --i18n` |
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/ai-response-navigation.md
3
3
  source_version: 1.4.0
4
4
  translation_version: 1.4.0
5
- last_synced: 2026-10-05
5
+ last_synced: 2026-10-11
6
+ source_hash: 1439c64bce23
6
7
  status: current
7
8
  ---
8
9
 
@@ -2,13 +2,23 @@
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) | [繁體中文](../../zh-TW/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
 
@@ -18,6 +28,8 @@ status: current
18
28
 
19
29
  ## 告警严重度分类(P1-P4)
20
30
 
31
+ ### 严重度定义
32
+
21
33
  | 级别 | 名称 | 标准 | 响应时间 | 通知渠道 |
22
34
  |------|------|------|---------|---------|
23
35
  | **P1** | 关键 | 完全服务中断;数据丢失风险;安全漏洞 | < 5 分钟 | 电话 + SMS + Chat |
@@ -25,10 +37,32 @@ status: current
25
37
  | **P3** | 警告 | 性能降级;资源接近上限;次要功能受影响 | < 4 小时 | Chat + Ticket |
26
38
  | **P4** | 信息 | 异常趋势;预防性通知;非紧急维护 | 下个工作日 | Email + Ticket |
27
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
+ ```
57
+
28
58
  ---
29
59
 
30
60
  ## 升级路径
31
61
 
62
+ ### 升级矩阵模板
63
+
64
+ 为每个严重度级别定义升级层级:
65
+
32
66
  | 时间 | P1(关键) | P2(高) | P3(警告) |
33
67
  |------|-----------|---------|-----------|
34
68
  | 0 分钟 | 值班工程师 | 值班工程师 | — |
@@ -37,43 +71,207 @@ status: current
37
71
  | 30 分钟(未解决) | VP Engineering | 工程经理 | — |
38
72
  | 60 分钟(未解决) | CTO/高管 | VP Engineering | 值班主管 |
39
73
 
74
+ ### 自动升级规则
75
+
76
+ - P1 告警若未确认将在 **5 分钟**后自动升级
77
+ - P2 告警若未确认将在 **15 分钟**后自动升级
78
+ - P3 告警若未确认将在 **4 小时**后自动升级
79
+ - 自动升级通知包含原始告警上下文及已耗费时间
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 | 必须有 Runbook 链接 |
116
+ | P2 | 必须有 Runbook 链接 |
117
+ | P3 | 应该有 Runbook 链接 |
118
+ | P4 | 应该有 Runbook 链接 |
119
+
120
+ 有关 Runbook 格式与维护,请参阅 [Runbook 标准](runbook-standards.md)。
52
121
 
53
122
  ---
54
123
 
55
124
  ## 降噪策略
56
125
 
126
+ ### 去重
127
+
128
+ 在时间窗口内合并具有相同指纹(service + alert_name + labels)的告警:
129
+
130
+ - 5 分钟内多次触发的同一告警 → 合并为一条通知
131
+ - 在合并通知中包含触发次数:`"Triggered 12 times in last 5 minutes"`
132
+ - 告警解决时重置去重窗口
133
+
134
+ ### 分组
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
+ - 子告警在通知中列为“相关告警”
147
+
148
+ ### 抑制 / 维护窗口
149
+
150
+ 在已知维护期间将告警静音:
151
+
152
+ - 定义包含开始/结束时间以及受影响服务的维护窗口
153
+ - 受影响服务的所有 P3/P4 告警均被静音
154
+ - P1/P2 告警**绝不**静音(安全覆盖)
155
+ - 维护窗口会被记录以供审计
156
+
157
+ ### 缓冲 / 阈值滞后
158
+
159
+ 防止指标在阈值附近波动时告警反复震荡:
160
+
57
161
  | 策略 | 运作方式 | 使用场景 |
58
162
  |------|---------|---------|
59
- | **Deduplication** | 合并相同告警 | 同一告警重复触发 |
60
- | **Grouping** | 按根因分组 | 多个服务告警(级联故障) |
61
- | **Suppression** | 计划维护期间静音 | 预定维护 |
62
- | **Dampening** | 条件持续 N 分钟才触发 | 指标在阈值附近波动 |
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. **代码审查** — 变更需同行审查
182
+
183
+ 1. **存储于 Git** — 告警定义视为代码,以相同的严格程度对待
184
+ 2. **代码审查** — 变更在部署前需经同行审查
71
185
  3. **自动测试** — CI 在合并前验证告警规则
72
186
  4. **通过 CI/CD 部署** — 告警变更走部署流程
73
187
 
188
+ ### 告警规则测试
189
+
190
+ 当提交修改告警规则的 PR 时,自动化测试应该验证:
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
+ ```
205
+
206
+ ---
207
+
208
+ ## 基于 SLO 的告警(最佳实践)
209
+
210
+ ### 多窗口多消耗率
211
+
212
+ 针对定义了 SLO 的服务,推荐的告警策略如下:
213
+
214
+ **示例:30 天窗口内 99.9% 可用性 SLO**
215
+
216
+ | 窗口 | 消耗率 | 告警级别 | 含义 |
217
+ |------|--------|----------|------|
218
+ | 1 小时 | 14.4x | P1(呼叫) | 按此速率,预算将在约 2 天内耗尽 |
219
+ | 6 小时 | 6x | P2(告警) | 按此速率,预算将在约 5 天内耗尽 |
220
+ | 3 天 | 1x | P3(工单) | 预计在月底前耗尽预算 |
221
+
222
+ **公式:**
223
+ ```
224
+ Burn Rate = (Error Rate in Window) / (1 - SLO Target)
225
+
226
+ Example:
227
+ SLO = 99.9%, Window = 1 hour, Errors in window = 1.44%
228
+ Burn Rate = 0.0144 / 0.001 = 14.4x
229
+ ```
230
+
231
+ ### 传统告警 vs 基于 SLO 的告警对比
232
+
233
+ | 维度 | 传统阈值告警 | 基于 SLO 的告警 |
234
+ |------|-------------|-----------------|
235
+ | **设定依据** | 基于经验的阈值 | 用户体验目标 |
236
+ | **误报率** | 较高(静态阈值无法自适应) | 较低(消耗率考虑了自然波动) |
237
+ | **漏报率** | 较高(缓慢劣化不易察觉) | 较低(消耗率可捕获缓慢消耗) |
238
+ | **维护成本** | 高(需频繁调优阈值) | 低(仅在 SLO 变更时更新) |
239
+ | **前提条件** | 无 | 必须有明确定义的 SLO |
240
+
241
+ ---
242
+
243
+ ## 告警质量指标
244
+
245
+ ### 核心指标
246
+
247
+ 追踪以下指标以持续提升告警质量:
248
+
249
+ | 指标 | 定义 | 目标 |
250
+ |------|------|------|
251
+ | **信噪比(SNR)** | 可操作告警数 / 总告警数 | > 80% |
252
+ | **MTTA**(平均确认时间) | 从触发告警到人工确认的平均时间 | 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
+
74
272
  ---
75
273
 
76
- ## Quick Reference Card
274
+ ## 快速参考卡
77
275
 
78
276
  ### 告警设计检查清单
79
277
  ```
@@ -95,34 +293,31 @@ status: current
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) — 基于日志的告警模式
102
310
 
103
- # 告警标准
104
-
105
- > 版本: 1.0.0 | 最后更新: 2026-04-01
106
-
107
- ## 概述
108
-
109
- 本文件定义告警策略标准,涵盖告警分级(P1-P4)、升级路径、可操作告警设计、降噪策略和基于 SLO 的告警。
110
-
111
- ## 告警分级
311
+ ---
112
312
 
113
- | 等级 | 名称 | 响应时间 | 通知方式 |
114
- |------|------|----------|----------|
115
- | P1 | Critical | < 5 分钟 | 电话 + 短信 + 即时通讯 |
116
- | P2 | High | < 15 分钟 | 短信 + 即时通讯 |
117
- | P3 | Warning | < 4 小时 | 即时通讯 + 工单 |
118
- | P4 | Info | 下个工作日 | 邮件 + 工单 |
313
+ ## 版本历史
119
314
 
120
- ## 相关标准
315
+ | 版本 | 日期 | 变更内容 |
316
+ |------|------|----------|
317
+ | 1.0.0 | 2026-03-31 | 初始版本:严重度分类、升级机制、可操作告警、降噪、基于 SLO 的告警、质量指标 |
121
318
 
122
- - [SLO 标准](slo-standards.md)
123
- - [可观测性标准](observability-standards.md)
124
- - [Runbook 标准](runbook-standards.md)
319
+ ---
125
320
 
126
321
  ## 许可
127
322
 
128
- CC BY 4.0
323
+ 本标准基于 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 许可协议发布。