universal-dev-standards 6.14.0-beta.1 → 6.14.0-beta.10

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 (688) hide show
  1. package/README.md +13 -3
  2. package/bin/uds.js +75 -3
  3. package/bundled/ai/options/code-review/pr-review.ai.yaml +20 -1
  4. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  5. package/bundled/ai/standards/ai-response-navigation.ai.yaml +43 -3
  6. package/bundled/ai/standards/checkin-standards.ai.yaml +25 -6
  7. package/bundled/ai/standards/code-review.ai.yaml +15 -2
  8. package/bundled/ai/standards/commit-message.ai.yaml +18 -4
  9. package/bundled/ai/standards/developer-memory.ai.yaml +12 -2
  10. package/bundled/ai/standards/full-coverage-testing.ai.yaml +86 -7
  11. package/bundled/ai/standards/open-work-tracking.ai.yaml +196 -11
  12. package/bundled/ai/standards/pipeline-security-gates.ai.yaml +53 -4
  13. package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
  14. package/bundled/core/ai-response-navigation.md +128 -12
  15. package/bundled/core/code-review-checklist.md +20 -2
  16. package/bundled/core/commit-message-guide.md +22 -19
  17. package/bundled/core/developer-memory.md +12 -2
  18. package/bundled/core/full-coverage-testing.md +99 -5
  19. package/bundled/core/open-work-tracking.md +157 -17
  20. package/bundled/core/pipeline-security-gates.md +63 -0
  21. package/bundled/core/project-context-memory.md +10 -2
  22. package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
  23. package/bundled/extensions/languages/csharp-style.md +464 -0
  24. package/bundled/extensions/languages/php-style.md +700 -0
  25. package/bundled/extensions/locales/zh-cn.md +717 -0
  26. package/bundled/extensions/locales/zh-tw.md +717 -0
  27. package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
  28. package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
  29. package/bundled/locales/COVERAGE.md +5 -4
  30. package/bundled/locales/zh-CN/CHANGELOG.md +199 -3
  31. package/bundled/locales/zh-CN/README.md +3 -3
  32. package/bundled/locales/zh-CN/SECURITY.md +3 -2
  33. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  34. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
  35. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  36. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
  37. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
  38. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
  39. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
  40. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  41. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  42. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  43. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  44. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  45. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  46. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  47. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  48. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  49. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  50. package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
  51. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  52. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  53. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  54. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  55. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  56. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  57. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  58. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  59. package/bundled/locales/zh-CN/core/code-review-checklist.md +54 -23
  60. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  61. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  62. package/bundled/locales/zh-CN/core/developer-memory.md +159 -60
  63. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  64. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  65. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  66. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  67. package/bundled/locales/zh-CN/core/full-coverage-testing.md +103 -9
  68. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  69. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  70. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  71. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  72. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  73. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  74. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  75. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  76. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  77. package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
  78. package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
  79. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  80. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  81. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  82. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  83. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  84. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  85. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  86. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  87. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  88. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  89. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  90. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  91. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  92. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  93. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  94. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  95. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  96. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  97. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  98. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  99. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  100. package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
  101. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +9 -3
  102. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  103. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +68 -33
  104. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +29 -15
  105. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  106. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
  107. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  108. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
  109. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  110. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  111. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +46 -0
  112. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  113. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  114. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  115. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  116. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  117. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  118. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  119. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  120. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  121. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  122. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  123. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  124. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  125. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  126. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  127. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  128. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  129. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  130. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  131. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  132. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  133. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  134. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  135. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  136. package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
  137. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  138. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  139. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  140. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  141. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  142. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  143. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  144. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  145. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  146. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  147. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  148. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  149. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  150. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  151. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  152. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  153. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  154. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  155. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  156. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  157. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  158. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  159. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  160. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  161. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  162. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  163. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  164. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  165. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  166. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  167. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  168. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  169. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  170. package/bundled/locales/zh-CN/skills/README.md +3 -1
  171. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  172. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  173. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  174. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  175. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  176. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  177. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  178. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  179. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  180. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  181. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  182. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  183. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  184. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  185. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  186. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  187. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  188. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  189. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  190. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  191. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  192. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  193. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  194. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  195. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  196. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  197. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  198. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  199. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  200. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  201. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  202. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  203. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  204. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  205. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  206. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  207. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  208. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  209. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  210. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  211. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  212. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  213. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  214. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  215. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  216. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  217. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  218. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  219. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  220. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  221. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  222. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  223. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  224. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  225. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  226. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  227. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  228. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  229. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  230. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  231. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  232. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  233. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  234. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  235. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  236. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  237. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  238. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  239. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  240. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  241. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  242. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  243. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  244. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  245. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -2
  246. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  247. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  248. package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
  249. package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
  250. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  251. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  252. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  253. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  254. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  255. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  256. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  257. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  258. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  259. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  260. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  261. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  262. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  263. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  264. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  265. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  266. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  267. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  268. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  269. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  270. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  271. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  272. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  273. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  274. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  275. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  276. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  277. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  278. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  279. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  280. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  281. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  282. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  283. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  284. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  285. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  286. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  287. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  288. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  289. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  290. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  291. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  292. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  293. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  294. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  295. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  296. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  297. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  298. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  299. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  300. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  301. package/bundled/locales/zh-TW/CHANGELOG.md +199 -3
  302. package/bundled/locales/zh-TW/README.md +3 -3
  303. package/bundled/locales/zh-TW/SECURITY.md +3 -2
  304. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  305. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
  306. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  307. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
  308. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
  309. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
  310. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
  311. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  312. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  313. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  314. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  315. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  316. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  317. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  318. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  319. package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
  320. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  321. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  322. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  323. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  324. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  325. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  326. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  327. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  328. package/bundled/locales/zh-TW/core/code-review-checklist.md +36 -7
  329. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  330. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  331. package/bundled/locales/zh-TW/core/developer-memory.md +111 -12
  332. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  333. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  334. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  335. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  336. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  337. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  338. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  339. package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
  340. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  341. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  342. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  343. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  344. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  345. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  346. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  347. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  348. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  349. package/bundled/locales/zh-TW/core/open-work-tracking.md +92 -16
  350. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  351. package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
  352. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  353. package/bundled/locales/zh-TW/core/project-context-memory.md +215 -31
  354. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  355. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  356. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  357. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  358. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  359. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  360. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  361. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  362. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  363. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  364. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  365. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  366. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  367. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  368. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  369. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  370. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  371. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  372. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  373. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  374. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  375. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  376. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  377. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  378. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  379. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  380. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  381. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  382. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  383. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  384. package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
  385. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +9 -3
  386. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  387. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +61 -26
  388. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  389. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +29 -15
  390. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  391. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
  392. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  393. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
  394. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  395. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  396. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +46 -0
  397. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  398. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  399. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  400. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  401. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  402. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  403. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  404. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  405. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  406. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  407. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  408. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  409. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  410. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  411. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  412. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  413. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  414. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  415. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  416. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  417. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  418. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  419. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  420. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  421. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  422. package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
  423. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  424. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  425. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  426. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  427. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  428. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  429. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  430. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  431. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  432. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  433. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  434. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  435. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  436. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  437. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  438. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  439. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  440. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  441. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  442. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  443. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  444. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  445. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  446. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  447. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  448. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  449. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  450. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  451. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  452. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  453. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  454. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  455. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  456. package/bundled/locales/zh-TW/skills/README.md +3 -1
  457. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  458. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  459. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  460. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  461. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  462. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  463. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  464. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  465. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  466. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  467. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  468. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  469. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  470. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  471. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  472. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  473. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  474. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  475. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  476. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  477. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  478. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  479. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  480. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  481. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  482. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  483. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  484. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  485. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  486. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  487. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  488. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  489. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  490. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  491. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  492. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  493. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  494. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  495. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  496. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  497. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  498. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  499. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  500. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  501. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  502. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  503. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  504. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  505. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  506. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  507. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  508. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  509. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  510. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  511. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  512. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  513. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  514. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  515. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  516. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  517. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  518. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  519. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  520. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  521. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  522. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  523. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  524. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  525. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  526. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  527. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  528. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  529. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  530. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  531. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  532. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  533. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  534. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  535. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  536. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  537. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  538. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  539. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  540. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  541. package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
  542. package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
  543. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  544. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  545. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  546. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  547. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  548. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  549. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  550. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  551. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  552. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  553. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  554. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  555. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  556. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  557. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  558. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  559. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  560. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  561. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  562. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  563. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  564. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  565. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  566. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  567. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  568. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  569. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  570. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  571. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  572. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  573. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  574. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  575. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  576. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  577. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  578. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  579. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  580. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  581. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  582. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  583. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  584. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  585. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  586. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  587. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  588. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  589. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  590. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  591. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  592. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  593. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  594. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  595. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  596. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  597. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  598. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  599. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  600. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  601. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  602. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  603. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  604. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  605. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  606. package/bundled/skills/README.md +1 -0
  607. package/bundled/skills/SKILL_NAMING.md +9 -0
  608. package/bundled/skills/commit-standards/SKILL.md +2 -2
  609. package/bundled/skills/commit-standards/guide.md +3 -2
  610. package/bundled/skills/commit-standards/language-options.md +19 -17
  611. package/bundled/skills/comprehension-ladder/SKILL.md +283 -0
  612. package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
  613. package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
  614. package/bundled/templates/gates/check-stubs.mjs +644 -0
  615. package/package.json +5 -3
  616. package/src/commands/audit.js +20 -2
  617. package/src/commands/check.js +155 -28
  618. package/src/commands/deps.js +31 -1
  619. package/src/commands/hitl.js +3 -0
  620. package/src/commands/init.js +159 -48
  621. package/src/commands/list.js +12 -3
  622. package/src/commands/mcp.js +2 -3
  623. package/src/commands/open-work.js +123 -0
  624. package/src/commands/quickstart.js +29 -13
  625. package/src/commands/release.js +102 -19
  626. package/src/commands/run-intent.js +10 -0
  627. package/src/commands/simulate.js +20 -8
  628. package/src/commands/skills.js +59 -33
  629. package/src/commands/spec-split.js +30 -17
  630. package/src/commands/spec.js +55 -21
  631. package/src/commands/uninstall.js +146 -32
  632. package/src/commands/update.js +471 -93
  633. package/src/core/install-records.js +192 -0
  634. package/src/core/manifest.js +12 -10
  635. package/src/core/marketplace-sentinel.js +5 -0
  636. package/src/core/open-work-config.js +122 -0
  637. package/src/core/project-config.js +92 -38
  638. package/src/flows/init-flow.js +10 -0
  639. package/src/hitl/manager.js +4 -2
  640. package/src/i18n/messages.js +413 -78
  641. package/src/installers/hooks-installer.js +236 -27
  642. package/src/installers/integration-installer.js +5 -1
  643. package/src/installers/skills-installer.js +3 -1
  644. package/src/installers/standards-installer.js +16 -23
  645. package/src/mcp/__tests__/server.test.js +0 -1
  646. package/src/mcp/server.js +16 -4
  647. package/src/prompts/init.js +148 -13
  648. package/src/reconciler/backup-locations.js +80 -0
  649. package/src/reconciler/backup-manager.js +451 -123
  650. package/src/reconciler/index.js +86 -10
  651. package/src/reconciler/install-roots.js +90 -0
  652. package/src/reconciler/plan-executor.js +37 -15
  653. package/src/uninstallers/hook-uninstaller.js +220 -33
  654. package/src/uninstallers/integration-uninstaller.js +35 -5
  655. package/src/uninstallers/skills-uninstaller.js +95 -16
  656. package/src/uninstallers/standards-uninstaller.js +56 -7
  657. package/src/utils/agents-installer.js +10 -17
  658. package/src/utils/available-standards-report.js +144 -0
  659. package/src/utils/available-standards.js +216 -0
  660. package/src/utils/command-hash-ownership.js +103 -0
  661. package/src/utils/commit-message-judge.js +155 -0
  662. package/src/utils/copier.js +80 -2
  663. package/src/utils/deps-applicability.js +25 -0
  664. package/src/utils/detector.js +46 -1
  665. package/src/utils/friction-detector.js +27 -0
  666. package/src/utils/gate-scripts.js +141 -0
  667. package/src/utils/git-hooks.js +139 -7
  668. package/src/utils/hasher.js +36 -0
  669. package/src/utils/health-scorer.js +10 -7
  670. package/src/utils/installed-names-ownership.js +114 -0
  671. package/src/utils/integration-generator.js +36 -24
  672. package/src/utils/legacy-hook-migration.js +112 -0
  673. package/src/utils/locale.js +19 -0
  674. package/src/utils/open-work-tracking.mjs +1754 -0
  675. package/src/utils/prompt-closed.js +18 -0
  676. package/src/utils/sdd-header.js +66 -0
  677. package/src/utils/skill-frontmatter.js +102 -0
  678. package/src/utils/skill-hash-ownership.js +64 -0
  679. package/src/utils/skill-name-collision.js +169 -0
  680. package/src/utils/skills-install-paths.js +114 -0
  681. package/src/utils/skills-installer.js +75 -106
  682. package/src/utils/standard-validator.js +98 -27
  683. package/src/utils/test-change-check.js +160 -0
  684. package/src/utils/test-policy.js +214 -0
  685. package/src/utils/transient-fs.js +113 -0
  686. package/src/utils/update-summary.js +29 -0
  687. package/src/vibe/micro-spec.js +15 -0
  688. package/standards-registry.json +48 -9
@@ -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
 
@@ -1,18 +1,22 @@
1
1
  ---
2
2
  source: ../../../core/checkin-standards.md
3
- source_version: 1.6.0
4
- translation_version: 1.6.0
5
- last_synced: 2026-04-20
6
- status: stale
3
+ source_version: 1.8.0
4
+ translation_version: 1.8.0
5
+ last_synced: 2026-10-11
6
+ source_hash: cba0d018453b
7
+ status: current
7
8
  ---
8
9
 
9
10
  # 程式碼簽入檢查點標準
10
11
 
11
12
  > **語言**: [English](../../../core/checkin-standards.md) | 繁體中文
12
13
 
13
- **版本**: 1.5.0
14
- **最後更新**: 2026-03-18
14
+ **版本**: 1.8.0
15
+ **最後更新**: 2026-07-09
15
16
  **適用範圍**: 所有使用版本控制的軟體專案
17
+ **Scope**: partial
18
+ **業界標準**: SWEBOK v4.0 第 6 章
19
+ **參考資料**: [computer.org](https://www.computer.org/education/bodies-of-knowledge/software-engineering/v4)
16
20
 
17
21
  ---
18
22
 
@@ -101,7 +105,7 @@ pytest --cov=src tests/
101
105
  ```
102
106
 
103
107
  **驗證**:
104
- - Run all test suites locally
108
+ - 在本機執行所有相關測試(參見上方「所有相關測試通過」——直接執行已變更程式碼的測試,以及受變更影響的測試;若專案有測試影響分析工具則加以使用);當範圍不明確,或變更觸及共用/核心路徑時,改為執行完整測試套件
105
109
  - Review test coverage report
106
110
  - Ensure new code paths are tested
107
111
 
@@ -156,6 +160,12 @@ describe('Regression: [BUG-ID or description]', () => {
156
160
  - Cyclomatic complexity ≤10
157
161
  - No duplicated code blocks
158
162
 
163
+ > 以上門檻為 UDS 預設值,可依專案調整。循環複雜度
164
+ > ≤10 遵循 McCabe 的原始建議(McCabe, 1976)——也是多數
165
+ > linter(ESLint `complexity`、SonarQube)的預設值;方法長度與
166
+ > 巢狀深度限制則是以可讀性為目標的常見風格指南預設值,並非
167
+ > 硬性規則。請依你的語言/團隊調整。
168
+
159
169
  - [ ] **安全性已檢查**
160
170
  - No hardcoded secrets (passwords, API keys)
161
171
  - No SQL injection vulnerabilities
@@ -199,11 +209,11 @@ dotnet list package --vulnerable
199
209
  - Breaking changes noted
200
210
  - Setup instructions current
201
211
 
202
- - [ ] **CHANGELOG 已更新(如適用)**
203
- - 對於使用者可感知的變更:已新增條目至 `[Unreleased]` 區段
212
+ - [ ] **CHANGELOG 已更新(僅限發布前)**
213
+ - CHANGELOG 於發布準備期間更新,而非每次 commit 更新
214
+ - 對於使用者可感知的變更:發布前已新增條目至 `[Unreleased]` 區段
204
215
  - Breaking changes marked with **BREAKING** prefix
205
- - 遵循 [versioning.md](versioning.md) 和 [changelog-standards.md](changelog-standards.md) 排除規則
206
- - 注意:內部重構、僅測試、僅文件的變更通常不需要 CHANGELOG 條目
216
+ - 各工作流程的更新時機請參見 [changelog-standards.md](changelog-standards.md)
207
217
 
208
218
  **文件格式**:
209
219
  ```
@@ -485,7 +495,7 @@ git status
485
495
 
486
496
  ## 特殊情境處理
487
497
 
488
- ### 緊急離開
498
+ ### 緊急離開(下班前)
489
499
 
490
500
  當需要暫時離開但工作未完成時:
491
501
 
@@ -911,8 +921,6 @@ obj/
911
921
  node_modules/
912
922
  ```
913
923
 
914
- ---
915
-
916
924
  ### 舊版專案檔案同步(project-file-sync)
917
925
 
918
926
  > **適用範圍**:.NET Framework、MSBuild `.csproj` 及任何需要明確登錄檔案的舊版格式。
@@ -1012,6 +1020,7 @@ git commit -m "feat(module-c): add export to CSV feature"
1012
1020
 
1013
1021
  | 版本 | 日期 | 變更 |
1014
1022
  |---------|------|---------|
1023
+ | 1.7.0 | 2026-06-18 | 新增:程式碼異味門檻的來源與可調整說明(McCabe 1976 循環複雜度;linter 預設值)(XSPEC-292 T8) |
1015
1024
  | 1.5.0 | 2026-03-18 | 新增:AC 覆蓋率驗證、批次閾值觸發、自動簽入規則 |
1016
1025
  | 1.4.0 | 2026-01-16 | 新增:Bug 修復測試評估章節與決策矩陣 |
1017
1026
  | 1.3.0 | 2026-01-05 | 新增:SWEBOK v4.0 第 6 章(軟體配置管理)至參考資料 |
@@ -1029,19 +1038,36 @@ git commit -m "feat(module-c): add export to CSV feature"
1029
1038
 
1030
1039
  ### 規則嚴重性分類
1031
1040
 
1041
+ 將 lint 規則分為三個嚴重性層級,並明確定義 CI 行為:
1042
+
1032
1043
  | 層級 | CI 行為 | 適用場景 | 範例 |
1033
1044
  |------|---------|----------|------|
1034
1045
  | **Error** | 阻擋 CI(build 失敗) | 可能的 Bug、安全問題 | 未使用變數、未處理 Promise、`eval` 使用 |
1035
- | **Warning** | 通過但回報 | 品質建議 | 函式過長、巢狀過深、TODO 標記 |
1036
- | **Info** | 靜默通過 | 風格偏好 | 行尾空白、import 排序 |
1046
+ | **Warning** | 通過但回報 | 品質建議,應修正 | 函式過長、巢狀過深、TODO 標記 |
1047
+ | **Info** | 靜默通過 | 風格偏好、資訊性 | 行尾空白、import 排序 |
1048
+
1049
+ **規則分類決策樹:**
1050
+
1051
+ ```
1052
+ Could this rule violation cause a bug?
1053
+ ├─ Yes → Error
1054
+ └─ No
1055
+ ├─ Could it degrade maintainability?
1056
+ │ ├─ Yes → Warning
1057
+ │ └─ No → Info
1058
+ └─ Does it involve security?
1059
+ └─ Yes → Error
1060
+ ```
1037
1061
 
1038
1062
  ### Auto-fix 策略
1039
1063
 
1040
- | 類別 | 範例 | 允許自動修復 |
1041
- |------|------|-------------|
1042
- | **安全修復** | 縮排、分號、import 排序 | 是 |
1043
- | **需確認** | 變數重命名、型別推斷 | 確認後修復 |
1044
- | **禁止自動修復** | 移除未使用變數、重構複雜邏輯 | 否(需人工判斷) |
1064
+ 並非所有 lint 規則都應自動修復。依安全性分類:
1065
+
1066
+ | 類別 | 條件 | 範例 | 允許自動修復 |
1067
+ |------|------|------|-------------|
1068
+ | **✅ 可安全自動修復** | 修復結果確定,不改變語意 | 縮排、分號、import 排序、尾隨逗號 | 是 |
1069
+ | **⚠️ 需確認** | 修復可能改變語意 | 變數重命名、型別推斷 | 確認後修復 |
1070
+ | **❌ 禁止自動修復** | 修復需要理解上下文 | 移除未使用變數、重構複雜邏輯 | 否(需人工判斷) |
1045
1071
 
1046
1072
  **Auto-fix 時機:**
1047
1073
 
@@ -1053,20 +1079,51 @@ git commit -m "feat(module-c): add export to CSV feature"
1053
1079
 
1054
1080
  ### 團隊一致性原則
1055
1081
 
1082
+ 目標不是通用的風格——而是**團隊內的一致性**:
1083
+
1056
1084
  | 原則 | 說明 |
1057
1085
  |------|------|
1058
1086
  | **團隊決定** | 風格選擇由團隊投票,非個人偏好 |
1059
1087
  | **設定納入版控** | Lint 設定檔必須提交至 Git |
1060
- | **決定後不辯論** | 採用後全員遵循,避免 bikeshedding |
1088
+ | **決定後不辯論(no bikeshedding)** | 採用後全員遵循,盡量減少風格爭論 |
1061
1089
  | **自動化優先** | 能由工具強制的規則不依賴人工審查 |
1062
1090
  | **新專案嚴格** | 新專案使用嚴格規則集;既有專案漸進採用 |
1063
1091
 
1064
1092
  ### 漸進採用
1065
1093
 
1094
+ 既有專案導入 linting 時:
1095
+
1066
1096
  1. **僅對新增/修改檔案套用嚴格規則** — 不要求一次修復整個 codebase
1067
- 2. **允許 `// eslint-disable-next-line` 但設上限** — 例如每專案 < 100 個
1068
- 3. **每季減少 disable 數量** — 每季減少 25%
1069
- 4. **全面強制** — 最終於所有檔案啟用
1097
+ 2. **允許 `// eslint-disable-next-line` 但設上限** — 允許既有違規使用 disable 標記,但設定最大數量(例如每專案 < 100 個)
1098
+ 3. **每季減少 disable 數量** — 每季將允許的 disable 數量減少 25%
1099
+ 4. **全面強制** — 最終於所有檔案啟用完整強制
1100
+
1101
+ ### 語言無關的設定範本
1102
+
1103
+ 為任何語言設定 linting 時,可參考此語言無關的 YAML 範本:
1104
+
1105
+ ```yaml
1106
+ # Lint Configuration Strategy (language-agnostic)
1107
+ rules:
1108
+ # Error-level: Block CI
1109
+ security: error # Security-related checks (e.g., eval, SQL injection patterns)
1110
+ possible-bugs: error # Likely bug patterns (e.g., unused vars, unreachable code)
1111
+ type-safety: error # Type-related issues (if applicable)
1112
+
1113
+ # Warning-level: Report but pass CI
1114
+ maintainability: warning # Complexity, duplication, long functions
1115
+ naming: warning # Naming conventions
1116
+ documentation: warning # Missing docs for public APIs
1117
+
1118
+ # Info-level: Silent
1119
+ style: info # Formatting preferences
1120
+ import-order: info # Import organization
1121
+
1122
+ auto_fix:
1123
+ on_save: true # Format on save in editor
1124
+ on_commit: true # Fix safe rules in pre-commit hook
1125
+ on_ci: false # CI only checks, never fixes
1126
+ ```
1070
1127
 
1071
1128
  ---
1072
1129
 
@@ -1076,10 +1133,11 @@ git commit -m "feat(module-c): add export to CSV feature"
1076
1133
  - [測試標準](testing-standards.md)(或使用 `/testing-guide` 技能)
1077
1134
  - [Commit 訊息規範](commit-message-guide.md)
1078
1135
  - [程式碼審查清單](code-review-checklist.md)
1079
- - [部署標準](deployment-standards.md) - 品質關卡與部署就緒性
1136
+ - [部署標準](deployment-standards.md) - 品質關卡是部署就緒性的輸入
1080
1137
  - [驗收條件追溯標準](acceptance-criteria-traceability.md) - AC 覆蓋率驗證
1081
1138
  - [變更批次合併標準](change-batching-standards.md) - 批次閾值觸發
1082
1139
  - [Pipeline 整合標準](pipeline-integration-standards.md) - 自動簽入
1140
+ - [發布就緒關卡](release-readiness-gate.md) - **簽入 ≠ 發布就緒**:通過每次 commit 的關卡是上線的必要條件但非充分條件;發布時「完成」的意義請參見 16 維度發布關卡
1083
1141
 
1084
1142
  ---
1085
1143
 
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/circuit-breaker.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: 5e7ea0ed4762
6
7
  status: current
7
8
  ---
8
9
 
@@ -10,102 +11,62 @@ status: current
10
11
 
11
12
  > **語言**: [English](../../../core/circuit-breaker.md) | 繁體中文
12
13
 
13
- **版本**: 1.0.0
14
- **最後更新**: 2026-04-15
15
- **適用範圍**: 所有依賴外部 API 或具備重試機制的 Agent 組件
16
- **Scope**: universal
17
- **來源**: XSPEC-036(claude-code-book Ch.2 MAX_CONSECUTIVE_AUTOCOMPACT_FAILURES)
18
-
19
- ---
20
-
21
- ## 目的
22
-
23
- 通用斷路器模式:連續失敗後開路,防止 API 呼叫雪崩。
24
-
25
- 任何依賴外部 API 或重試機制的 Agent 組件都應使用斷路器保護。實測:引入斷路器前每日浪費約 250K API 呼叫(1279 個 session 各超過 50 次連續失敗)。
26
-
27
- ---
14
+ > **來源**: XSPEC-036 | **借鑑自**: claude-code-book Ch.2
28
15
 
29
- ## 核心規範
30
-
31
- - 任何重試機制必須使用斷路器包裝,不得直接無限重試
32
- - 斷路器狀態必須透過遙測可觀測(`circuit_breaker_state_change` 事件)
33
- - OPEN 狀態下的請求必須立即失敗(fail fast),不等待 timeout
34
- - `failureThreshold` 預設值為 3,與 claude-code-book 及常見 Fix Loop 實作慣例一致
35
- - 斷路器必須按照「功能單元」建立,不得全域共享單一斷路器
36
-
37
- ---
38
-
39
- ## 三態模型
40
-
41
- | 狀態 | 描述 | 轉換條件 |
42
- |------|------|----------|
43
- | **CLOSED**(閉路) | 正常運作,請求正常轉發 | 連續失敗次數 >= `failureThreshold` → OPEN |
44
- | **OPEN**(開路) | 立即拒絕所有請求,回傳 `CircuitOpenError` | 等待 `cooldownMs` 後 → HALF_OPEN |
45
- | **HALF_OPEN**(半開) | 允許一次探針呼叫 | 成功 → CLOSED;失敗 → OPEN |
46
-
47
- ---
16
+ ## 概述
48
17
 
49
- ## 介面定義
18
+ 斷路器模式保護 Agent 系統,避免因重複失敗而引發 API 雪崩。連續 `failureThreshold` 次失敗後,斷路器開啟並立即拒絕所有請求——不必等待逾時。冷卻期過後,允許一次探測呼叫以測試是否恢復。
50
19
 
51
- ### CircuitBreaker
20
+ 實際數據:在引入斷路器之前,claude-code-book 量測到每天約 25 萬次 API 呼叫被浪費,涉及 1,279 個各自連續失敗超過 50 次的工作階段(最多:連續失敗 3,272 次)。
52
21
 
53
- | 欄位/方法 | 類型 | 說明 |
54
- |-----------|------|------|
55
- | `name` | `string` | 斷路器識別名稱 |
56
- | `state` | `CLOSED \| HALF_OPEN \| OPEN` | 目前狀態 |
57
- | `execute<T>(fn)` | `async () => Promise<T>` | 受保護的執行入口 |
58
- | `getState()` | `() => CircuitBreakerState` | 查詢目前狀態 |
59
- | `reset()` | `() => void` | 手動重設(管理員用) |
22
+ ## 狀態
60
23
 
61
- ### CircuitBreakerConfig
24
+ ```
25
+ CLOSED ──(N consecutive failures)──→ OPEN
26
+ OPEN ──(cooldownMs elapsed)──→ HALF_OPEN
27
+ HALF_OPEN ──(probe success)──→ CLOSED
28
+ HALF_OPEN ──(probe failure)──→ OPEN
29
+ ```
62
30
 
63
- | 欄位 | 類型 | 預設值 | 說明 |
64
- |------|------|--------|------|
65
- | `failureThreshold` | `number` | `3` | 連續失敗 N 次後開路 |
66
- | `cooldownMs` | `number` | `30000` | OPEN → HALF_OPEN 等待時間(毫秒) |
67
- | `successThreshold` | `number` | `1` | HALF_OPEN → CLOSED 需要的連續成功次數 |
68
-
69
- ### CircuitOpenError
70
-
71
- | 欄位 | 類型 |
72
- |------|------|
73
- | `code` | `"CIRCUIT_OPEN"` |
74
- | `breakerName` | `string` |
75
- | `state` | `"OPEN"` |
76
- | `cooldownRemainingMs` | `number` |
77
-
78
- ---
79
-
80
- ## 遙測事件
81
-
82
- **`circuit_breaker_state_change`**(每次狀態轉換時上傳)
83
-
84
- | 欄位 | 類型 |
31
+ | 狀態 | 行為 |
85
32
  |------|------|
86
- | `breaker_name` | `string` |
87
- | `from_state` | `CLOSED \| HALF_OPEN \| OPEN` |
88
- | `to_state` | `CLOSED \| HALF_OPEN \| OPEN` |
89
- | `failure_count` | `number` |
90
- | `timestamp` | `string` |
91
-
92
- ---
33
+ | **CLOSED** | 正常運作,請求照常轉送 |
34
+ | **OPEN** | 所有請求立即以 `CircuitOpenError` 拒絕 |
35
+ | **HALF_OPEN** | 允許一次探測請求;成功 → CLOSED,失敗 → OPEN |
36
+
37
+ ## 設定
38
+
39
+ | 參數 | 預設值 | 說明 |
40
+ |------|--------|------|
41
+ | `failureThreshold` | 3 | 開啟前的連續失敗次數 |
42
+ | `cooldownMs` | 30000 | OPEN → HALF_OPEN 的等待時間(毫秒) |
43
+ | `successThreshold` | 1 | 關閉所需的探測成功次數 |
44
+
45
+ ## 介面
46
+
47
+ ```typescript
48
+ interface CircuitBreaker {
49
+ readonly name: string;
50
+ readonly state: "CLOSED" | "HALF_OPEN" | "OPEN";
51
+ execute<T>(fn: () => Promise<T>): Promise<T>; // throws CircuitOpenError when OPEN
52
+ getState(): CircuitBreakerState;
53
+ reset(): void; // admin manual reset
54
+ }
55
+ ```
93
56
 
94
57
  ## 適用場景
95
58
 
96
- - Fix Loop Agent 呼叫重試(採用層)
97
- - Judge / Quality Gate 重試(採用層)
98
- - LLM API 呼叫(不穩定保護;採用層)
99
- - Feedback Loop 重試(採用層)
100
- - FLARE 主動檢索重試(採用層)
101
- - AutoCompact 風格的對話壓縮(claude-code-book 為原始靈感來源)
59
+ - Fix Loop(採用層)重試
60
+ - LLM API 呼叫保護(採用層)
61
+ - Feedback Loop(採用層)重試
62
+ - FLARE 主動檢索(採用層)的檢索重試
63
+ - 任何對外部依賴使用重試的組件
102
64
 
103
- ---
65
+ ## 參考資料
104
66
 
105
- ## 錯誤碼
67
+ - AI 最佳化版本:[ai/standards/circuit-breaker.ai.yaml](../../../ai/standards/circuit-breaker.ai.yaml)
68
+ - XSPEC-036:跨專案規格
69
+ - 借鑑自:[claude-code-book](https://github.com/lintsinghua/claude-code-book) Ch.2 `MAX_CONSECUTIVE_AUTOCOMPACT_FAILURES`
106
70
 
107
- | 代碼 | 說明 |
108
- |------|------|
109
- | `CB-001` | `CIRCUIT_OPEN` — 斷路器開路,請求被拒絕 |
110
- | `CB-002` | `PROBE_FAILED` — HALF_OPEN 探針失敗,重新開路 |
111
- | `CB-003` | `INVALID_CONFIG` — `failureThreshold` 必須 >= 1 |
71
+
72
+ **Scope**: universal