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,31 +2,35 @@
2
2
  source: ../../../core/branch-completion.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-03-24
5
+ last_synced: 2026-10-16
6
+ source_hash: 630cbaa0dc61
6
7
  status: current
7
8
  ---
8
9
 
9
10
  # 分支完成工作流程
10
11
 
11
12
  <!-- UDS:REFERENCE-ONLY since=6.0.0 -->
12
- > **僅供參考——UDS 不會安裝這條標準。** 它的機器可讀檔 `.ai.yaml` 已於 6.0.0 移除;
13
- > 本文件保留在此,供實作它的採用層參考,**不由 `uds init` 或 `uds update` 出貨**。
14
- > 本告示所對照的清單是
15
- > [`scripts/reference-only-standards.json`](../../../scripts/reference-only-standards.json),
16
- > 遷移紀錄見 [`docs/MIGRATION-v6.md`](../../../docs/MIGRATION-v6.md) §2。
13
+ > **僅供參考——UDS 不會安裝這條標準。** 它的機器可讀檔
14
+ > `.ai.yaml` 已於 6.0.0 移除;本文件保留在此,供實作它的採用層
15
+ > 參考,且**不由 `uds init` 或
16
+ > `uds update` 發布**。本告示所對照的清單是
17
+ > [`scripts/reference-only-standards.json`](../../../scripts/reference-only-standards.json);
18
+ > 遷移紀錄見 [`docs/MIGRATION-v6.md`](../docs/MIGRATION-v6.md) §2。
17
19
 
18
20
  > **語言**: [English](../../../core/branch-completion.md) | 繁體中文
19
21
 
20
22
  **版本**: 1.0.0
21
23
  **最後更新**: 2026-03-20
22
- **適用性**: 所有使用 Git 分支工作流的專案
23
- **範圍**: 通用 (Universal)
24
+ **適用性**: 所有使用 Git 分支工作流程的專案
25
+ **範圍**: 通用 (universal)
24
26
  **靈感來源**: [Superpowers](https://github.com/obra/superpowers) — finishing-a-development-branch (MIT)
25
27
 
26
28
  ---
27
29
 
28
30
  ## 目的
29
31
 
32
+ 定義分支完成的標準化工作流程,包含前置檢查、四個完成選項與安全丟棄流程。本標準可防止過早合併、遺忘分支與意外資料遺失。
33
+
30
34
  定義分支完成的標準化工作流,包含前置檢查、四個完成選項與安全丟棄流程。防止過早合併、遺忘分支與意外資料遺失。
31
35
 
32
36
  ---
@@ -34,8 +38,8 @@ status: current
34
38
  ## 術語表
35
39
 
36
40
  | 術語 | 定義 |
37
- |------|------|
38
- | 分支完成 (Branch Completion) | 完成功能/修復分支工作的過程 |
41
+ |------|-----------|
42
+ | 分支完成 (Branch Completion) | 完成功能/修復分支工作的流程 |
39
43
  | 前置條件 (Prerequisites) | 分支被視為完成前必須滿足的條件 |
40
44
  | 丟棄確認 (Discard Confirmation) | 刪除工作前需要明確輸入的安全機制 |
41
45
 
@@ -43,41 +47,133 @@ status: current
43
47
 
44
48
  ## 核心原則 — 先測試再討論
45
49
 
46
- > **所有測試必須通過,才能討論完成選項。**
50
+ > **所有測試必須通過,才能討論任何完成選項。**
51
+
52
+ 所有測試必須通過,才能討論完成選項。
47
53
 
48
54
  ---
49
55
 
50
56
  ## 前置條件
51
57
 
52
- 在選擇任何完成選項之前,必須通過以下檢查:
58
+ 在分支可以被完成之前,下列所有檢查項目都必須通過:
59
+
60
+ | 檢查項目 | 指令(範例) | 必要 |
61
+ |-------|-------------------|----------|
62
+ | 所有測試通過 | `pnpm test` | 是 |
63
+ | Lint 通過 | `pnpm lint` | 是 |
64
+ | 型別檢查通過 | `pnpm tsc --noEmit` | 是 |
65
+ | 無未提交的變更 | `git status --porcelain` | 是 |
53
66
 
54
- | 檢查項目 | 說明 |
55
- |----------|------|
56
- | 所有測試通過 | `npm test` 或專案對應的測試指令 |
57
- | 無未提交的變更 | `git status` 顯示乾淨的工作目錄 |
58
- | 分支已與目標分支同步 | 已 rebase 或 merge 最新的目標分支 |
59
- | 程式碼品質通過 | linting、type check 等品質門檻 |
67
+ 若有任何前置條件失敗,該分支即**尚未準備好完成**。請先修復問題。
68
+
69
+ ---
60
70
 
61
71
  ## 四個完成選項
62
72
 
63
- | 選項 | 適用場景 | 指令 |
64
- |------|----------|------|
65
- | **Merge** | 功能完成,準備合併到目標分支 | `git merge` 或建立 PR |
66
- | **Squash Merge** | 多個小提交需要壓縮為一個 | `git merge --squash` |
67
- | **Rebase** | 保持線性歷史 | `git rebase target-branch` |
68
- | **Discard** | 放棄此分支的工作 | 需丟棄確認 |
73
+ ### 選項 1: 本地合併 (Merge Locally)
74
+
75
+ 在你的本地機器上將分支合併至目標分支。
76
+
77
+ ```bash
78
+ git checkout main
79
+ git merge --no-ff feature/my-feature
80
+ git branch -d feature/my-feature
81
+ # If worktree exists:
82
+ git worktree remove .worktrees/my-feature
83
+ ```
84
+
85
+ **適用時機**: 小型變更、個人工作、無需審查。
86
+
87
+ ### 選項 2: 建立 PR (Create Pull Request)
88
+
89
+ 推送分支並建立 Pull Request 以供審查。
90
+
91
+ ```bash
92
+ git push -u origin feature/my-feature
93
+ gh pr create --title "feat: add my feature" --body "..."
94
+ ```
95
+
96
+ **適用時機**: 團隊專案、需要審查的變更、CI/CD 管線。
97
+
98
+ ### 選項 3: 保持現狀 (Keep As-Is)
99
+
100
+ 保留分支,不進行合併也不建立 PR。
101
+
102
+ - 記錄分支狀態與推遲原因
103
+ - 設定提醒以便後續重新檢視
104
+
105
+ **適用時機**: 進行中的工作、等待相依項目、探索替代方案。
106
+
107
+ ### 選項 4: 丟棄 (Discard)
108
+
109
+ 刪除分支及其所有變更。
110
+
111
+ **安全要求**: 使用者必須透過輸入分支名稱進行**明確確認**。
69
112
 
70
- ## 安全丟棄流程
113
+ ```
114
+ ⚠️ You are about to discard branch 'feature/my-feature'.
115
+ This will permanently delete all uncommitted and committed changes on this branch.
116
+ Type the branch name to confirm: feature/my-feature
117
+ ```
71
118
 
72
- 丟棄分支前必須:
119
+ ```bash
120
+ # After confirmation:
121
+ git checkout main
122
+ git branch -D feature/my-feature
123
+ # If worktree exists:
124
+ git worktree remove .worktrees/my-feature
125
+ ```
73
126
 
74
- 1. **確認** — 明確輸入分支名稱確認丟棄意圖
75
- 2. **備份** — 建立標籤保留最後狀態:`git tag archive/branch-name`
76
- 3. **清理** — 刪除本地和遠端分支
127
+ **適用時機**: 放棄的實驗、已被取代的做法。
77
128
 
78
- ## 相關標準
129
+ 丟棄操作需要使用者明確確認(輸入分支名稱),防止誤刪。
130
+
131
+ ---
132
+
133
+ ## 決策流程
134
+
135
+ ```
136
+ Prerequisites pass?
137
+ ├── No → Fix issues first
138
+ └── Yes → Choose completion option:
139
+ ├── 1. Merge locally
140
+ ├── 2. Create PR
141
+ ├── 3. Keep as-is
142
+ └── 4. Discard (requires confirmation)
143
+ ```
144
+
145
+ ---
146
+
147
+ ## Worktree 整合
148
+
149
+ 如果分支有相關聯的 worktree,worktree 必須作為完成流程的一部分進行清理:
150
+
151
+ | 完成選項 | Worktree 操作 |
152
+ |------------------|----------------|
153
+ | 本地合併 | 合併後移除 worktree |
154
+ | 建立 PR | 保留 worktree 直到 PR 合併 |
155
+ | 保持現狀 | 保留 worktree |
156
+ | 丟棄 | 立即移除 worktree |
157
+
158
+ ---
159
+
160
+ ## 規則
161
+
162
+ | ID | 觸發條件 | 行動 | 優先級 |
163
+ |----|---------|--------|----------|
164
+ | BC-001 | 使用者選擇丟棄 | 要求分支名稱確認 | 緊急 (Critical) |
165
+ | BC-002 | 分支具有關聯的 worktree | 完成時清理 worktree | 高 (High) |
166
+ | BC-003 | 未滿足前置條件 | 阻擋完成,顯示未通過的檢查 | 高 (High) |
167
+ | BC-004 | 分支閒置超過 14 天 | 通知使用者完成或丟棄 | 中 (Medium) |
168
+
169
+ ---
170
+
171
+ ## 參考資料
172
+
173
+ - **Superpowers**: [finishing-a-development-branch](https://github.com/obra/superpowers) (MIT)
174
+ - **Git Flow**: 分支生命週期管理
175
+ - **Trunk-Based Development**: 短期分支模式
176
+
177
+ ---
79
178
 
80
- - [Git Worktree 隔離](git-worktree.md)
81
- - [代理派遣與並行協調](agent-dispatch.md)
82
- - [提交規範](checkin-standards.md)
83
- - [Git 工作流](git-workflow.md)
179
+ > **分支完成 ≠ 發布就緒。** 完成的分支代表其自身的所有品質閘門皆已通過。這並不代表產品已準備好出貨。關於正式環境部署前必須通過的 16 維度發布閘門,請參閱 `release-readiness-gate.md`。
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/capability-declaration.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-04-20
5
+ last_synced: 2026-10-11
6
+ source_hash: 5890495db0da
6
7
  status: current
7
8
  ---
8
9
 
@@ -10,102 +11,63 @@ status: current
10
11
 
11
12
  > **語言**: [English](../../../core/capability-declaration.md) | 繁體中文
12
13
 
13
- **版本**: 1.0.0
14
- **最後更新**: 2026-04-15
15
- **適用範圍**: 所有工具、Adapter、Agent 組件
16
- **Scope**: universal
17
- **來源**: XSPEC-037(claude-code-book Ch.3 Fail-Closed buildTool factory)
18
-
19
- ---
14
+ > **來源**: XSPEC-037 | **借鑑自**: claude-code-book Ch.3
20
15
 
21
- ## 目的
16
+ ## 概述
22
17
 
23
- Fail-Closed 能力聲明:工具/Adapter/Agent 必須顯式聲明安全性,缺省為最保守預設。
24
-
25
- 所有工具、Adapter 和 Agent 能力預設為「不安全、需授權」。開發者必須顯式聲明 `isConcurrencySafe: true` 才能享受並行優化。「忘記設權限」的結果是保守行為而非危險行為。
26
-
27
- ---
18
+ 能力聲明標準要求所有工具、Adapter 和 Agent 顯式聲明其安全性質。**所有性質預設為最保守的(Fail-Closed)值**——忘記聲明能力的開發者得到的是安全行為,而非危險行為。
28
19
 
29
- ## 核心規範
20
+ 借鑑自 claude-code-book 的 `buildTool` 工廠設計:其中 `isConcurrencySafe()` 與 `isReadOnly()` 預設為 `false`,效能優化必須顯式選擇啟用。
30
21
 
31
- - 所有工具、Adapter、Agent 必須實作 `CapabilityDeclaration`(即使使用預設值)
32
- - `isConcurrencySafe` 和 `isReadOnly` 預設為 `false` — 必須顯式聲明才能解鎖優化路徑
33
- - 框架必須在缺少聲明時使用 `FAIL_CLOSED_DEFAULTS`,並記錄警告
34
- - 聲明必須反映實際能力,虛假聲明(如謊稱 `isReadOnly`)視為安全漏洞
35
- - `trustLevel` 影響沙箱隔離強度,不可降低至低於 `userSettings` 允許的等級
22
+ ## Fail-Closed 預設值
36
23
 
37
- ---
24
+ ```typescript
25
+ const FAIL_CLOSED_DEFAULTS: CapabilityDeclaration = {
26
+ isConcurrencySafe: false, // Cannot run in parallel
27
+ isReadOnly: false, // Assumed to have side effects
28
+ requiresUserConfirmation: true, // Must confirm before execution
29
+ trustLevel: "untrusted", // Maximum sandbox restrictions
30
+ };
31
+ ```
38
32
 
39
33
  ## CapabilityDeclaration 介面
40
34
 
41
35
  | 欄位 | 類型 | 預設值 | 說明 |
42
36
  |------|------|--------|------|
43
- | `isConcurrencySafe` | `boolean` | `false` | 是否對並行執行安全(無競態、無共享可變狀態)。設為 `true` 後可加入並行批次執行 |
44
- | `isReadOnly` | `boolean` | `false` | 是否為純讀取操作(不修改任何持久化狀態)。設為 `true` 後可跳過寫入相關的 Safety Hook 階段 |
45
- | `requiresUserConfirmation` | `boolean` | `true` | 執行前是否需要使用者明確確認。設為 `false` 後進入自動執行模式(需 `userSettings` 允許) |
46
- | `trustLevel` | enum | `untrusted` | 工具的信任等級,影響沙箱隔離強度 |
47
-
48
- ### trustLevel 值對應
49
-
50
- | 值 | 說明 |
51
- |----|------|
52
- | `trusted` | 內建工具或已審核插件,無沙箱限制 |
53
- | `sandboxed` | 第三方工具,在受限環境中執行 |
54
- | `untrusted` | 未知來源,最嚴格限制(預設) |
55
-
56
- ---
37
+ | `isConcurrencySafe` | boolean | **false** | 可安全地與其他操作並行執行 |
38
+ | `isReadOnly` | boolean | **false** | 不做任何持久化狀態變更 |
39
+ | `requiresUserConfirmation` | boolean | **true** | 執行前需要使用者明確核准 |
40
+ | `trustLevel` | enum | **untrusted** | 沙箱隔離等級 |
57
41
 
58
- ## Fail-Closed 預設值
59
-
60
- 缺少聲明時使用的保守預設:
61
-
62
- | 欄位 | 值 |
63
- |------|-----|
64
- | `isConcurrencySafe` | `false` |
65
- | `isReadOnly` | `false` |
66
- | `requiresUserConfirmation` | `true` |
67
- | `trustLevel` | `untrusted` |
68
-
69
- 使用預設時記錄警告:`[WARN] Capability not declared, using Fail-Closed defaults for: {component_name}`
70
-
71
- ---
42
+ ## 信任等級
72
43
 
73
- ## 常見工具聲明範例
44
+ | 等級 | 說明 | 沙箱 |
45
+ |------|------|------|
46
+ | `trusted` | 內建或已審核插件 | 無限制 |
47
+ | `sandboxed` | 第三方工具 | 受限的執行環境 |
48
+ | `untrusted` | 未知來源 | 最嚴格限制(預設) |
74
49
 
75
- | 工具 | `isConcurrencySafe` | `isReadOnly` | `requiresUserConfirmation` | `trustLevel` |
76
- |------|--------------------|--------------|-----------------------------|-------------|
77
- | GrepTool | `true` | `true` | `false` | `trusted` |
78
- | GlobTool | `true` | `true` | `false` | `trusted` |
79
- | FileReadTool | `true` | `true` | `false` | `trusted` |
80
- | FileEditTool | `false` | `false` | `true` | `trusted` |
81
- | BashTool | `false` | `false` | `true` | `sandboxed` |
50
+ ## 常見工具聲明
82
51
 
83
- ---
52
+ | 工具 | isConcurrencySafe | isReadOnly | requiresConfirmation | trustLevel |
53
+ |------|-------------------|------------|---------------------|------------|
54
+ | GrepTool | ✅ true | ✅ true | ❌ false | trusted |
55
+ | GlobTool | ✅ true | ✅ true | ❌ false | trusted |
56
+ | FileReadTool | ✅ true | ✅ true | ❌ false | trusted |
57
+ | FileEditTool | ❌ false | ❌ false | ✅ true | trusted |
58
+ | BashTool | ❌ false | ❌ false | ✅ true | sandboxed |
84
59
 
85
60
  ## 執行規範
86
61
 
87
- | 情況 | 行動 |
88
- |------|------|
89
- | 缺少聲明 | 使用 `FAIL_CLOSED_DEFAULTS`,記錄警告 |
90
- | 虛假聲明(聲明 `isReadOnly: true` 但實際執行了寫入) | 記錄 `CAPABILITY_MISMATCH` 事件,降級至 `FAIL_CLOSED_DEFAULTS` |
91
-
92
- ---
93
-
94
- ## 適用組件
62
+ - **缺少聲明**:使用 `FAIL_CLOSED_DEFAULTS` 並記錄 `[WARN] Capability not declared for: {name}`
63
+ - **虛假聲明偵測**:若聲明 `isReadOnly: true` 卻執行寫入 → 記錄 `CAPABILITY_MISMATCH` 事件,退回 Fail-Closed
64
+ - **並行**:只有 `isConcurrencySafe: true` 的組件可被批次納入並行執行
95
65
 
96
- - AgentAdapter 實作(採用層;如 ClaudeAdapter / OpenCodeAdapter / CliAdapter)
97
- - Tool 呼叫系統(採用層)
98
- - ToolExecutor 實作(採用層)
99
- - Agent(採用層;planner / builder / evaluator 等)
100
- - 所有 MCP 工具插件
66
+ ## 參考資料
101
67
 
102
- ---
68
+ - AI 最佳化版本:[ai/standards/capability-declaration.ai.yaml](../../../ai/standards/capability-declaration.ai.yaml)
69
+ - XSPEC-037:跨專案規格
70
+ - 借鑑自:[claude-code-book](https://github.com/lintsinghua/claude-code-book) Ch.3 `buildTool` Fail-Closed 工廠
103
71
 
104
- ## 錯誤碼
105
72
 
106
- | 代碼 | 說明 |
107
- |------|------|
108
- | `CAP-001` | `CAPABILITY_NOT_DECLARED` — 使用 Fail-Closed 預設 |
109
- | `CAP-002` | `CAPABILITY_MISMATCH` — 實際行為與聲明不符 |
110
- | `CAP-003` | `TRUST_LEVEL_INSUFFICIENT` — `trustLevel` 低於場景要求 |
111
- | `CAP-004` | `CONCURRENT_UNSAFE` — 嘗試並行執行 `isConcurrencySafe: false` 的組件 |
73
+ **Scope**: universal
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/change-batching-standards.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-03-18
5
+ last_synced: 2026-10-11
6
+ source_hash: 3ba2c359b2f9
6
7
  status: current
7
8
  ---
8
9
 
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/changelog-standards.md
3
3
  source_version: 1.0.2
4
4
  translation_version: 1.0.2
5
- last_synced: 2025-12-30
5
+ last_synced: 2026-10-11
6
+ source_hash: bb36e2ce7d8f
6
7
  status: current
7
8
  ---
8
9
 
@@ -13,6 +14,9 @@ status: current
13
14
  **版本**: 1.0.2
14
15
  **最後更新**: 2025-12-24
15
16
  **適用範圍**: 所有有版本發布的軟體專案
17
+ **範圍**: universal
18
+ **產業標準**: Keep a Changelog 1.1.0
19
+ **參考資源**: [keepachangelog.com](https://keepachangelog.com/)
16
20
 
17
21
  ---
18
22
 
@@ -85,14 +89,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
85
89
 
86
90
  ### 變更分類
87
91
 
88
- | 分類 | 使用時機 |
89
- |------|----------|
90
- | **Added** | 新功能 |
91
- | **Changed** | 現有功能的變更 |
92
- | **Deprecated** | 即將移除的功能 |
93
- | **Removed** | 已移除的功能 |
94
- | **Fixed** | 錯誤修復 |
95
- | **Security** | 安全性修補 |
92
+ | 分類 | 用途 | 使用時機 |
93
+ |------|------|----------|
94
+ | **Added** | 新功能 | 為使用者新增的功能 |
95
+ | **Changed** | 修改 | 現有功能的變更 |
96
+ | **Deprecated** | 即將移除 | 未來將被移除的功能 |
97
+ | **Removed** | 已移除的功能 | 本版本中移除的功能 |
98
+ | **Fixed** | 錯誤修復 | 任何錯誤修復 |
99
+ | **Security** | 安全性修補 | 弱點修復 |
96
100
 
97
101
  ### 版本標題格式
98
102
 
@@ -536,6 +540,7 @@ git ls-files | grep -E "path/to/file"
536
540
  - [Versioning Standard](versioning.md) - 語義化版本標準
537
541
  - [Commit Message Guide](commit-message-guide.md) - Commit 訊息規範
538
542
  - [Git Workflow Standards](git-workflow.md) - Git 工作流程標準
543
+ - [Deployment Standards](deployment-standards.md) - 記錄已部署的變更
539
544
 
540
545
  ---
541
546
 
@@ -2,91 +2,193 @@
2
2
  source: ../../../core/chaos-engineering-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: 20b92ddacd4c
6
7
  status: current
7
8
  ---
8
9
 
9
10
  # 混沌工程標準
10
11
 
11
- > 版本: 1.0.0 | 最後更新: 2026-04-01
12
+ > **語言**: [English](../../../core/chaos-engineering-standards.md) | 繁體中文
13
+
14
+ **版本**: 1.0.0
15
+ **最後更新**: 2026-03-31
16
+ **適用性**: 所有軟體專案
17
+ **範疇**: universal
18
+ **授權**: CC BY 4.0
19
+ **參考資料**: [Principles of Chaos Engineering](https://principlesofchaos.org/), [Netflix Chaos Engineering](https://netflixtechblog.com/tagged/chaos-engineering)
20
+
21
+ ---
12
22
 
13
23
  ## 概述
14
24
 
15
- 本文件定義混沌工程標準,涵蓋實驗工作流、故障注入類型、安全護欄、漸進式混沌階段、SLO 整合及實驗記錄範本。目標是透過科學化的混沌實驗持續驗證系統韌性。
25
+ 本文件定義混沌工程標準,涵蓋實驗工作流程、故障注入類型、安全護欄、漸進式混沌階段、SLO 整合及實驗記錄範本。目標是透過科學化的混沌實驗持續驗證系統韌性。
16
26
 
17
27
  ---
18
28
 
19
- ## 實驗工作流
29
+ ## 1. 實驗工作流程
20
30
 
21
- 混沌實驗遵循 4 步驟科學方法:
31
+ 混沌實驗遵循 4 步驟科學方法來驗證系統韌性。
32
+
33
+ ### 4 步驟流程
22
34
 
23
35
  | 步驟 | 名稱 | 說明 |
24
36
  |------|------|------|
25
- | **步驟 1** | **假設** | 定義穩態假設:「在故障 X 下,系統應維持行為 Y」 |
26
- | **步驟 2** | **實驗** | 設計並執行故障注入,記錄參數、持續時間與範圍 |
27
- | **步驟 3** | **觀察** | 監控系統指標、日誌與告警,對比實際行為與假設 |
28
- | **步驟 4** | **結論** | 分析結果:假設確認或推翻,記錄發現與改進項目 |
37
+ | **步驟 1** | **假設** | 定義穩態假設:「在故障 X 下,系統應維持行為 Y。」描述預期行為與可量測指標。 |
38
+ | **步驟 2** | **實驗** | 設計並執行故障注入。記錄實驗參數、持續時間與範圍。 |
39
+ | **步驟 3** | **觀察** | 監控系統指標、日誌與告警。對比實際行為與假設。 |
40
+ | **步驟 4** | **結論** | 分析結果:假設確認或推翻。記錄發現與改進項目。 |
41
+
42
+ ### 假設指南
43
+
44
+ 一個結構良好的穩態假設應當:
45
+ - 定義何謂「正常」(例如:p99 延遲 < 200ms、錯誤率 < 0.1%)
46
+ - 指定受測的故障條件
47
+ - 敘述故障期間的預期系統行為
48
+ - 具備可證偽性與可量測性
29
49
 
30
50
  ---
31
51
 
32
- ## 故障注入類型
52
+ ## 2. 故障注入類型
53
+
54
+ 五種標準故障注入類型涵蓋分散式系統中最常見的失敗模式。
33
55
 
34
56
  | 類型 | 說明 | 範例 |
35
57
  |------|------|------|
36
- | **Network Latency** | 注入網路延遲或封包遺失 | 200ms 延遲、5% 封包遺失 |
37
- | **Service Disruption** | 終止或降級服務實例 | 隨機 kill pods、關閉可用區 |
38
- | **Resource Exhaustion** | 耗盡運算資源 | CPU 飽和、記憶體壓力、磁碟空間耗盡 |
39
- | **Dependency Failure** | 模擬外部依賴故障 | 資料庫連線中斷、第三方 API 返回 503 |
40
- | **Clock Skew** | 引入時鐘漂移 | 時鐘偏移 5 分鐘、NTP 服務中斷 |
58
+ | **Network Latency** | 注入網路延遲或封包遺失 | 增加 200ms 延遲、5% 封包遺失、DNS 解析延遲 |
59
+ | **Service Disruption** | 終止或降級服務實例 | 隨機 kill pods、關閉可用區、重啟服務 |
60
+ | **Resource Exhaustion** | 耗盡運算資源 | CPU 飽和、記憶體壓力、磁碟空間耗盡、檔案描述子耗盡 |
61
+ | **Dependency Failure** | 模擬外部相依性故障 | 資料庫連線中斷、第三方 API 回傳 503、快取無法使用 |
62
+ | **Clock Skew** | 引入時鐘漂移或 NTP 異常 | 時鐘向前/向後偏移 5 分鐘、NTP 服務中斷 |
63
+
64
+ ### 選擇故障類型
65
+
66
+ 根據以下面向選擇故障注入類型:
67
+ - 系統架構與已知弱點
68
+ - 歷史事故模式
69
+ - 相依性關鍵度分析
70
+ - SLO 風險評估
41
71
 
42
72
  ---
43
73
 
44
- ## 安全護欄
74
+ ## 3. 安全護欄
45
75
 
46
- 每個混沌實驗**必須**具備三項安全機制:
76
+ 每個混沌實驗都必須具備安全護欄,以防止不受控制的損害。
47
77
 
48
- | 機制 | 說明 |
49
- |------|------|
50
- | **Blast Radius** | 限制影響範圍(最多 N% 流量、M 個實例) |
51
- | **Auto-Stop** | 定義自動終止條件(錯誤率超限、延遲超限) |
52
- | **Rollback** | 一鍵移除所有注入故障並恢復正常狀態 |
78
+ ### 三項安全機制
79
+
80
+ | 機制 | 說明 | 範例 |
81
+ |------|------|------|
82
+ | **Blast Radius** | 將影響範圍限制在受控的子集內 | 最多影響 N% 流量、最多影響 M 個實例、僅限單一區域 |
83
+ | **Auto-Stop** | 定義中止實驗的自動終止條件 | 錯誤率超過閾值、延遲超過上限、健康檢查失敗次數超過限制 |
84
+ | **Rollback** | 提供一鍵機制以移除所有注入的故障並恢復正常狀態 | 用於還原所有故障注入的緊急停止開關(kill switch)、自動化清理腳本、基礎架構回滾 |
85
+
86
+ ### 護欄要求
87
+
88
+ - 每個實驗在執行前都必須定義這三項機制
89
+ - Auto-Stop 條件必須進行即時監控
90
+ - Rollback 必須在實驗開始前完成測試
91
+ - 執行期間必須有指定的「實驗負責人」在場
53
92
 
54
93
  ---
55
94
 
56
- ## 漸進式混沌
95
+ ## 4. 漸進式混沌
96
+
97
+ 混沌工程的採用遵循漸進式的 3 階段方法,各階段在推進之前都必須滿足相應的前提條件。
98
+
99
+ ### 3 階段進程
57
100
 
58
101
  | 階段 | 環境 | 前提條件 |
59
102
  |------|------|---------|
60
- | **階段 1** | **非生產** | 基礎監控就位;團隊理解混沌工程原則 |
61
- | **階段 2** | **Staging** | 完成 3+ 階段 1 實驗;完整可觀測性;自動化 rollback 已驗證 |
62
- | **階段 3** | **生產** | 階段 2 無重大問題;管理層核准;事件回應計畫就緒 |
103
+ | **階段 1** | **非生產** | 基礎監控就位;團隊理解混沌工程原則;安全護欄已定義 |
104
+ | **階段 2** | **Staging** | 在階段 1 完成 3 次以上成功的實驗;已部署完整可觀測性系統;自動化 rollback 已驗證 |
105
+ | **階段 3** | **生產** | 階段 2 完成且無重大問題;已證明成熟的安全護欄;取得管理層核准;事件回應計畫就緒 |
106
+
107
+ ### 階段晉級準則
108
+
109
+ - 每個階段都需要具備完成前提條件的文件化證據
110
+ - 階段晉級決策應由團隊進行審查
111
+ - 若發現新風險,退回前一階段是可接受的
63
112
 
64
113
  ---
65
114
 
66
- ## SLO 整合
115
+ ## 5. SLO 整合
116
+
117
+ 混沌實驗必須與 SLO 的 Error Budget 管理協調配合,以避免對服務可靠性造成過度影響。
118
+
119
+ ### Error Budget 限制
67
120
 
68
121
  | 規則 | 閾值 | 說明 |
69
122
  |------|------|------|
70
- | **單次實驗限制** | **10%** | 單次實驗不得消耗超過 Error Budget 的 10% |
71
- | **暫停閾值** | **30%** | Error Budget 剩餘低於 30% 時暫停實驗 |
72
- | **預算報告** | — | 所有混沌實驗的 Error Budget 影響必須記錄 |
123
+ | **單次實驗限制** | **10%** | 單次混沌實驗不得消耗超過總 Error Budget 的 10% |
124
+ | **暫停閾值** | **30%** | 當剩餘 Error Budget 低於 30% 時,應暫停混沌實驗 |
125
+ | **預算報告** | — | 混沌實驗對 Error Budget 造成的所有影響,都必須記錄在 Error Budget 報告中 |
126
+
127
+ ### 整合指南
128
+
129
+ - 在 Error Budget 充裕時(剩餘 > 50%)排定混沌實驗
130
+ - 在執行可能影響 SLI 的實驗前,與 SLO 負責人進行協調
131
+ - 在可行的情況下,將混沌引起的錯誤與自然發生的錯誤分開追蹤
132
+ - 在定期的 SLO 審查會議中審視混沌實驗的影響
73
133
 
74
134
  ---
75
135
 
76
- ## 實驗記錄範本
136
+ ## 6. 實驗記錄範本
137
+
138
+ 每個完成的混沌實驗都必須使用標準記錄範本進行記錄。
77
139
 
78
- 每個完成的混沌實驗必須使用 5 區段記錄格式:
140
+ ### 5 區段記錄格式
79
141
 
80
142
  | 區段 | 內容 |
81
143
  |------|------|
82
144
  | **假設** | 穩態假設描述、預期行為、可量測指標 |
83
145
  | **方法** | 故障注入類型、參數、持續時間、blast radius、環境 |
84
- | **結果** | 實際系統行為、指標變化、告警觸發、使用者影響 |
85
- | **學習** | 假設確認/推翻、發現的弱點、非預期行為 |
146
+ | **結果** | 實際觀察到的系統行為、指標變化、告警觸發、使用者影響 |
147
+ | **學習** | 假設確認或推翻、發現的弱點、非預期行為 |
86
148
  | **行動** | 後續改進計畫、負責人、時程、相關 ticket |
87
149
 
150
+ ### 記錄範例
151
+
152
+ ```markdown
153
+ ## Chaos Experiment Record
154
+
155
+ ### Hypothesis
156
+ Under a 200ms network latency injection on the payment service,
157
+ the checkout flow should complete within 3 seconds (p99) with zero failed transactions.
158
+
159
+ ### Method
160
+ - **Type**: Network Latency
161
+ - **Target**: payment-service pods (2 of 6)
162
+ - **Parameters**: 200ms delay on all outbound requests
163
+ - **Duration**: 15 minutes
164
+ - **Blast Radius**: 33% of payment service instances
165
+ - **Environment**: Staging
166
+
167
+ ### Result
168
+ - Checkout p99 latency increased to 2.8s (within threshold)
169
+ - 0 failed transactions
170
+ - 2 timeout alerts triggered (expected)
171
+ - No user-facing errors
172
+
173
+ ### Learning
174
+ - Hypothesis CONFIRMED
175
+ - Retry logic worked as expected
176
+ - Timeout alert threshold may need adjustment (too sensitive)
177
+
178
+ ### Action
179
+ - [ ] Adjust timeout alert threshold from 2s to 3s (owner: SRE team, by: next sprint)
180
+ - [ ] Add circuit breaker metrics to dashboard (owner: platform team, by: next sprint)
181
+ ```
182
+
88
183
  ---
89
184
 
90
- ## 授權
185
+ ## 參考資料
186
+
187
+ - [Principles of Chaos Engineering](https://principlesofchaos.org/)
188
+ - [Netflix Chaos Engineering](https://netflixtechblog.com/tagged/chaos-engineering)
189
+ - [Gremlin Chaos Engineering Guide](https://www.gremlin.com/chaos-engineering/)
190
+ - [AWS Fault Injection Simulator](https://aws.amazon.com/fis/)
191
+
192
+ ---
91
193
 
92
- 本標準以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權釋出。
194
+ *本標準以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權釋出。*