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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (712) hide show
  1. package/bin/uds.js +12 -1
  2. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  3. package/bundled/ai/standards/commit-message.ai.yaml +12 -2
  4. package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
  5. package/bundled/core/commit-message-guide.md +22 -19
  6. package/bundled/core/secret-management-standards.md +13 -1
  7. package/bundled/extensions/locales/zh-tw.md +19 -19
  8. package/bundled/hooks/validate-commit-msg.mjs +52 -9
  9. package/bundled/locales/zh-CN/CHANGELOG.md +2312 -1102
  10. package/bundled/locales/zh-CN/CLAUDE.md +987 -101
  11. package/bundled/locales/zh-CN/README.md +3 -3
  12. package/bundled/locales/zh-CN/SECURITY.md +3 -3
  13. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  14. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
  15. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  16. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
  17. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
  18. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
  19. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
  20. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  21. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  22. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  23. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  24. package/bundled/locales/zh-CN/core/accessibility-standards.md +871 -62
  25. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  26. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  27. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  28. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  29. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  30. package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +311 -72
  31. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  32. package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
  33. package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
  34. package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
  35. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  36. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  37. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  38. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  39. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  40. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  41. package/bundled/locales/zh-CN/core/changelog-standards.md +485 -63
  42. package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
  43. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  44. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  45. package/bundled/locales/zh-CN/core/code-review-checklist.md +37 -23
  46. package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
  47. package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
  48. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  49. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  50. package/bundled/locales/zh-CN/core/deprecation-standards.md +155 -40
  51. package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
  52. package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
  53. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  54. package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
  55. package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
  56. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  57. package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
  58. package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
  59. package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
  60. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  61. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  62. package/bundled/locales/zh-CN/core/feature-flag-standards.md +202 -57
  63. package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
  64. package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
  65. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  66. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  67. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  68. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  69. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  70. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  71. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  72. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  73. package/bundled/locales/zh-CN/core/mutation-testing.md +45 -6
  74. package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
  75. package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
  76. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  77. package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
  78. package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
  79. package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
  80. package/bundled/locales/zh-CN/core/project-structure.md +550 -170
  81. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  82. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  83. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  84. package/bundled/locales/zh-CN/core/retrospective-standards.md +215 -22
  85. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  86. package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
  87. package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
  88. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  89. package/bundled/locales/zh-CN/core/security-standards.md +169 -16
  90. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  91. package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
  92. package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
  93. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  94. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  95. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  96. package/bundled/locales/zh-CN/core/supply-chain-security-standards.md +159 -32
  97. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  98. package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
  99. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  100. package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
  101. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  102. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  103. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  104. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  105. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  106. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  107. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  108. package/bundled/locales/zh-CN/core/versioning.md +737 -73
  109. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  110. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  111. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  112. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +2 -1
  113. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  114. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
  115. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
  116. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  117. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
  118. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  119. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
  120. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  121. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  122. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +2 -0
  123. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  124. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  125. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  126. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  127. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  128. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  129. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  130. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  131. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  132. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  133. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  134. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  135. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  136. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  137. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  138. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  139. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  140. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  141. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  142. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  143. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  144. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  145. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  146. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  147. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  148. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  149. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  150. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  151. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  152. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  153. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  154. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  155. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  156. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  157. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  158. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  159. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  160. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  161. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  162. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  163. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  164. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  165. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  166. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  167. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  168. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  169. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  170. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  171. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  172. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  173. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  174. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  175. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  176. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  177. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  178. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  179. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  180. package/bundled/locales/zh-CN/skills/README.md +2 -1
  181. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  182. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  183. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  184. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  185. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  186. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  187. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  188. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  189. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  190. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  191. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  192. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  193. package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +217 -137
  194. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  195. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  196. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  197. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  198. package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +148 -132
  199. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  200. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  201. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  202. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  203. package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +122 -121
  204. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  205. package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
  206. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  207. package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
  208. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  209. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  210. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  211. package/bundled/locales/zh-CN/skills/code-review-assistant/guide.md +119 -45
  212. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  213. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  214. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  215. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  216. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  217. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  218. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  219. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  220. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  221. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  222. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  223. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  224. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  225. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  226. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  227. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  228. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  229. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  230. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  231. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  232. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  233. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  234. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  235. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  236. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  237. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  238. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  239. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  240. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  241. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  242. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  243. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  244. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  245. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  246. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  247. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  248. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  249. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  250. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  251. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  252. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  253. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  254. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  255. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  256. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  257. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  258. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  259. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  260. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  261. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +4 -4
  262. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  263. package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
  264. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  265. package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
  266. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  267. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  268. package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +4 -2
  269. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  270. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  271. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  272. package/bundled/locales/zh-CN/skills/docs-generator/guide.md +8 -7
  273. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  274. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  275. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  276. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  277. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  278. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  279. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  280. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  281. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  282. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  283. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  284. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  285. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  286. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  287. package/bundled/locales/zh-CN/skills/project-discovery/guide.md +158 -157
  288. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  289. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  290. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  291. package/bundled/locales/zh-CN/skills/refactoring-assistant/guide.md +172 -171
  292. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  293. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  294. package/bundled/locales/zh-CN/skills/release-standards/guide.md +51 -43
  295. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  296. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  297. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  298. package/bundled/locales/zh-CN/skills/requirement-assistant/guide.md +88 -79
  299. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  300. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  301. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  302. package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +2 -2
  303. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  304. package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
  305. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  306. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  307. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  308. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  309. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  310. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  311. package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +2 -2
  312. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  313. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  314. package/bundled/locales/zh-CN/skills/tdd-assistant/guide.md +217 -156
  315. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  316. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  317. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  318. package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +25 -12
  319. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  320. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  321. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  322. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  323. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  324. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  325. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  326. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  327. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  328. package/bundled/locales/zh-TW/CHANGELOG.md +2291 -1110
  329. package/bundled/locales/zh-TW/CLAUDE.md +962 -76
  330. package/bundled/locales/zh-TW/README.md +3 -3
  331. package/bundled/locales/zh-TW/SECURITY.md +3 -3
  332. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  333. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
  334. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  335. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
  336. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
  337. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
  338. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
  339. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  340. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  341. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  342. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  343. package/bundled/locales/zh-TW/core/accessibility-standards.md +895 -46
  344. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  345. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  346. package/bundled/locales/zh-TW/core/agent-dispatch.md +102 -33
  347. package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
  348. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  349. package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
  350. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  351. package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
  352. package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
  353. package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
  354. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  355. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  356. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  357. package/bundled/locales/zh-TW/core/branch-completion.md +130 -34
  358. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  359. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  360. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  361. package/bundled/locales/zh-TW/core/chaos-engineering-standards.md +138 -36
  362. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  363. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  364. package/bundled/locales/zh-TW/core/code-review-checklist.md +19 -7
  365. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  366. package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
  367. package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
  368. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  369. package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
  370. package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
  371. package/bundled/locales/zh-TW/core/developer-memory.md +102 -12
  372. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  373. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  374. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  375. package/bundled/locales/zh-TW/core/environment-standards.md +250 -72
  376. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  377. package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
  378. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  379. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  380. package/bundled/locales/zh-TW/core/feature-flag-standards.md +202 -57
  381. package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
  382. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  383. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  384. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  385. package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +234 -487
  386. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  387. package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
  388. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  389. package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
  390. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  391. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  392. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  393. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  394. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  395. package/bundled/locales/zh-TW/core/observability-standards.md +284 -40
  396. package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
  397. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  398. package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
  399. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  400. package/bundled/locales/zh-TW/core/project-context-memory.md +210 -31
  401. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  402. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  403. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  404. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  405. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  406. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  407. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  408. package/bundled/locales/zh-TW/core/runbook-standards.md +296 -23
  409. package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
  410. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  411. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  412. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  413. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  414. package/bundled/locales/zh-TW/core/slo-standards.md +301 -49
  415. package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
  416. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  417. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  418. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  419. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  420. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  421. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  422. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  423. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  424. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  425. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  426. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  427. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  428. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  429. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  430. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  431. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  432. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  433. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  434. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  435. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +2 -1
  436. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  437. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
  438. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  439. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
  440. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  441. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
  442. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  443. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
  444. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  445. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  446. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +2 -0
  447. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  448. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  449. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  450. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  451. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  452. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  453. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  454. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  455. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  456. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  457. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  458. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  459. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  460. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  461. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  462. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  463. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  464. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  465. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  466. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  467. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  468. package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +584 -475
  469. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  470. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  471. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  472. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  473. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  474. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  475. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  476. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  477. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  478. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  479. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  480. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  481. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  482. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  483. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  484. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  485. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  486. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  487. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  488. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  489. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  490. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  491. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  492. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  493. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  494. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  495. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  496. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  497. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  498. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  499. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  500. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  501. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  502. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  503. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  504. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  505. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  506. package/bundled/locales/zh-TW/skills/README.md +2 -1
  507. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  508. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  509. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  510. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  511. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  512. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  513. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  514. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  515. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  516. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  517. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  518. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  519. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  520. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  521. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  522. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  523. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  524. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  525. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  526. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  527. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  528. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  529. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  530. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  531. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  532. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  533. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  534. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  535. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  536. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  537. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  538. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  539. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  540. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  541. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  542. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  543. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  544. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  545. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  546. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  547. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  548. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  549. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  550. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  551. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  552. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  553. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  554. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  555. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  556. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  557. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  558. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  559. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  560. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  561. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  562. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  563. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  564. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  565. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  566. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  567. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  568. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  569. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  570. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  571. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  572. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  573. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  574. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  575. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  576. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  577. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  578. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  579. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  580. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  581. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  582. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  583. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  584. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  585. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  586. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  587. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  588. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  589. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  590. package/bundled/locales/zh-TW/skills/commit-standards/guide.md +137 -17
  591. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  592. package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
  593. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  594. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  595. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  596. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  597. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  598. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  599. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  600. package/bundled/locales/zh-TW/skills/docs-generator/guide.md +4 -3
  601. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  602. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  603. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  604. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  605. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  606. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  607. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  608. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  609. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  610. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  611. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  612. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  613. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  614. package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +85 -18
  615. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  616. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  617. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  618. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  619. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  620. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  621. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  622. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  623. package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +91 -45
  624. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  625. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  626. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  627. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  628. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  629. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  630. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  631. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  632. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  633. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  634. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  635. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  636. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  637. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  638. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  639. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  640. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  641. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  642. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  643. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  644. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  645. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  646. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  647. package/bundled/locales/zh-TW/skills/tdd-assistant/language-examples.md +693 -47
  648. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  649. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  650. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  651. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  652. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  653. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  654. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  655. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  656. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  657. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  658. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  659. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  660. package/bundled/skills/.claude-plugin/plugin.json +71 -0
  661. package/bundled/skills/commit-standards/SKILL.md +2 -2
  662. package/bundled/skills/commit-standards/guide.md +3 -2
  663. package/bundled/skills/commit-standards/language-options.md +19 -17
  664. package/package.json +2 -2
  665. package/src/commands/audit.js +28 -1
  666. package/src/commands/check.js +77 -7
  667. package/src/commands/compile.js +37 -4
  668. package/src/commands/config.js +49 -24
  669. package/src/commands/init.js +78 -30
  670. package/src/commands/open-work.js +6 -2
  671. package/src/commands/release-messages.js +228 -0
  672. package/src/commands/release.js +127 -68
  673. package/src/commands/run-intent.js +11 -0
  674. package/src/commands/spec-split.js +2 -1
  675. package/src/commands/spec.js +11 -2
  676. package/src/commands/update.js +184 -30
  677. package/src/compilers/claude-code-compiler.js +9 -1
  678. package/src/config/ai-agent-paths.js +14 -1
  679. package/src/core/installed-formats.js +15 -0
  680. package/src/core/open-work-config.js +20 -1
  681. package/src/core/project-config.js +55 -0
  682. package/src/i18n/messages.js +160 -2
  683. package/src/installers/hooks-installer.js +1 -1
  684. package/src/installers/manifest-installer.js +1 -1
  685. package/src/installers/skills-installer.js +1 -1
  686. package/src/installers/standards-installer.js +3 -1
  687. package/src/mcp/server.js +9 -3
  688. package/src/prompts/init.js +26 -22
  689. package/src/reconciler/actual-state-scanner.js +2 -8
  690. package/src/reconciler/backup-locations.js +5 -0
  691. package/src/reconciler/backup-manager.js +19 -11
  692. package/src/reconciler/desired-state-calculator.js +89 -57
  693. package/src/reconciler/plan-executor.js +101 -8
  694. package/src/reconciler/recorded-versions.js +49 -0
  695. package/src/reconciler/relative-path.js +23 -0
  696. package/src/uninstallers/hook-uninstaller.js +9 -1
  697. package/src/uninstallers/skills-uninstaller.js +22 -3
  698. package/src/utils/available-standards-report.js +25 -4
  699. package/src/utils/available-standards.js +13 -3
  700. package/src/utils/build-manifest.js +1 -1
  701. package/src/utils/commit-message-judge.js +60 -13
  702. package/src/utils/friction-detector.js +23 -11
  703. package/src/utils/git-hooks.js +106 -4
  704. package/src/utils/integration-generator.js +95 -67
  705. package/src/utils/legacy-hook-migration.js +121 -2
  706. package/src/utils/open-work-tracking.mjs +105 -16
  707. package/src/utils/sdd-header.js +16 -4
  708. package/src/utils/skills-installer.js +2 -1
  709. package/src/utils/spinner.js +14 -4
  710. package/src/utils/standard-validator.js +3 -2
  711. package/standards-registry.json +10 -8
  712. package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
@@ -2,36 +2,47 @@
2
2
  source: ../../CLAUDE.md
3
3
  source_version: 1.2.0
4
4
  translation_version: 1.2.0
5
- last_synced: 2026-01-08
5
+ last_synced: 2026-10-16
6
+ source_hash: a1de69c3a838
6
7
  status: current
7
8
  ---
8
9
 
9
- # 通用開發標準 - 專案規範
10
+ # Universal Development Standards - 專案規範
10
11
 
11
- 本文件定義 Universal Development Standards 專案本身的開發規範。作為一個提供開發標準給其他專案的框架,我們實踐自己所倡導的理念(「吃自己的狗糧」)。
12
+ 本文件定義 Universal Development Standards 專案本身的開發標準。作為一個提供開發標準給其他專案的框架,我們實踐自己所倡導的理念(「吃自己的狗糧」)。
12
13
 
13
14
  ## 專案概述
14
15
 
15
- Universal Development Standards 是一個語言無關、框架無關的文件化標準框架。它提供:
16
+ Universal Development Standards 是一個語言無關、框架無關的開發標準框架。它提供:
16
17
 
17
- - **核心規範** (`core/`):153 個基礎開發標準
18
+ - **核心標準** (`core/`):70+ 個基礎開發標準
18
19
  - **AI 技能** (`skills/`):用於 AI 輔助開發的 Claude Code 技能
19
20
  - **CLI 工具** (`cli/`):用於採用標準的 Node.js CLI
20
- - **整合** (`integrations/`):各種 AI 工具的配置
21
+ - **整合** (`integrations/`):各種 AI 工具的設定
21
22
  - **本地化** (`locales/`):多語言支援(英文、繁體中文)
22
23
 
23
- ## 技術棧
24
+ ## 技術堆疊
24
25
 
25
26
  | 元件 | 技術 | 版本 |
26
- |------|------|------|
27
- | 運行環境 | Node.js | >= 18.0.0 |
27
+ |-----------|------------|---------|
28
+ | 執行環境 | Node.js | >= 18.0.0 |
28
29
  | 模組系統 | ES Modules | - |
29
- | 測試框架 | Vitest | ^4.0.16 |
30
+ | 測試 | Vitest | ^4.0.16 |
30
31
  | 程式碼檢查 | ESLint | ^8.56.0 |
31
32
  | CLI 框架 | Commander.js | ^12.1.0 |
32
33
  | 互動式提示 | Inquirer.js | ^9.2.12 |
33
34
 
34
- ## 開發規範
35
+ ## 開發標準
36
+
37
+ > **核心標準使用規則**:
38
+ > 驗證標準、檢查程式碼或執行任務時,**優先**閱讀 `core/` 中的精簡規則(例如 `core/testing-standards.md`)。
39
+ > **僅**在明確要求教育內容、詳細說明或教學課程時,才閱讀 `core/guides/` 或 `methodologies/guides/`。
40
+ > 這可確保 token 效率與聚焦的上下文。
41
+
42
+ > **單一事實來源優先順序(僅限來源儲存庫)**:
43
+ > 在此 UDS 來源儲存庫中,`core/*.md` 是**即時的單一事實來源**。
44
+ > `<!-- UDS:STANDARDS:START -->` 區塊內的 `.standards/*.ai.yaml` 檔案是由 `npx universal-dev-standards install/update` 維護的**採用者 dogfooding 快照**——根據 DEC-044,`uds update` 無法在來源儲存庫中執行,因此此快照會落後於 `core/`。
45
+ > 當兩者分歧時,**一律優先採用 `core/`**。從此儲存庫 CWD 啟動的 Subagents 必須將 `core/*.md` 視為具權威性。
35
46
 
36
47
  ### 1. Commit 訊息格式
37
48
 
@@ -47,7 +58,7 @@ Universal Development Standards 是一個語言無關、框架無關的文件化
47
58
 
48
59
  **類型:**
49
60
  - `feat`:新功能或標準
50
- - `fix`:錯誤修復或糾正
61
+ - `fix`:錯誤修復或修正
51
62
  - `docs`:文件更新
52
63
  - `chore`:維護任務
53
64
  - `test`:測試相關變更
@@ -56,20 +67,20 @@ Universal Development Standards 是一個語言無關、框架無關的文件化
56
67
 
57
68
  **範例:**
58
69
  ```bash
59
- feat(core): 新增測試完整度維度標準
60
- docs(skills): 更新 Claude Code 技能文件
61
- fix(cli): 修復 Windows 路徑解析問題
62
- chore(i18n): 同步翻譯與原始檔案
70
+ feat(core): add new testing completeness dimensions
71
+ docs(skills): update Claude Code skill documentation
72
+ fix(cli): resolve path resolution issue on Windows
73
+ chore(i18n): sync translations with source files
63
74
  ```
64
75
 
65
76
  ### 2. 分支策略
66
77
 
67
- 遵循 `core/git-workflow.md` 中定義的 Git 工作流:
78
+ 遵循 `core/git-workflow.md` 中定義的 Git 工作流程:
68
79
 
69
80
  | 分支 | 用途 |
70
- |------|------|
71
- | `main` | 穩定、生產就緒的版本 |
72
- | `feature/*` | 新功能和增強 |
81
+ |--------|---------|
82
+ | `main` | 穩定、生產就緒的發布版本 |
83
+ | `feature/*` | 新功能與增強 |
73
84
  | `fix/*` | 錯誤修復 |
74
85
  | `docs/*` | 文件更新 |
75
86
  | `chore/*` | 維護任務 |
@@ -77,15 +88,15 @@ chore(i18n): 同步翻譯與原始檔案
77
88
  ### 3. 程式碼風格
78
89
 
79
90
  **JavaScript:**
80
- - 使用單引號作為字串
91
+ - 字串使用單引號
81
92
  - 語句以分號結尾
82
93
  - 使用 ES Module 語法(`import`/`export`)
83
- - 遵循 `cli/.eslintrc.json` 中的 ESLint 配置
94
+ - 遵循 `cli/.eslintrc.json` 中的 ESLint 設定
84
95
 
85
96
  **Markdown:**
86
97
  - 使用 ATX 風格標題(`#`、`##`、`###`)
87
98
  - 標題前後包含空行
88
- - 使用帶語言規範的圍欄式程式碼區塊
99
+ - 使用指定語言的圍欄式程式碼區塊
89
100
 
90
101
  ### 4. 測試要求
91
102
 
@@ -96,9 +107,9 @@ chore(i18n): 同步翻譯與原始檔案
96
107
 
97
108
  ### 5. 翻譯同步
98
109
 
99
- 修改核心規範時:
100
- 1. 先更新英文原始檔案
101
- 2. 同步變更到 `locales/zh-TW/` 目錄
110
+ 修改核心標準時:
111
+ 1. 先更新英文來源檔案
112
+ 2. 同步變更至 `locales/zh-TW/` 目錄
102
113
  3. 執行翻譯檢查:`./scripts/check-translation-sync.sh`
103
114
 
104
115
  ## 快速指令
@@ -106,49 +117,65 @@ chore(i18n): 同步翻譯與原始檔案
106
117
  ### macOS / Linux
107
118
 
108
119
  ```bash
109
- # CLI 開發(在 cli/ 目錄執行)
120
+ # CLI development (run from cli/ directory)
110
121
  cd cli
111
- npm install # 安裝依賴
112
- npm test # 執行測試
113
- npm run test:watch # 以 watch 模式執行測試
114
- npm run lint # 檢查程式碼風格
115
- npm run test:coverage # 產生覆蓋率報告
122
+ npm install # Install dependencies
123
+ npm test # Run tests
124
+ npm run test:watch # Run tests in watch mode
125
+ npm run lint # Check code style
126
+ npm run test:coverage # Generate coverage report
116
127
 
117
- # 翻譯同步檢查(從根目錄執行)
128
+ # Translation sync check (run from root)
118
129
  ./scripts/check-translation-sync.sh
119
130
 
120
- # 版本同步檢查(從根目錄執行)
131
+ # Version sync check (run from root)
121
132
  ./scripts/check-version-sync.sh
122
133
 
123
- # 標準一致性檢查(從根目錄執行)
134
+ # Standards consistency check (run from root)
124
135
  ./scripts/check-standards-sync.sh
125
136
 
126
- # 本地 CLI 測試
137
+ # Pre-release check (run all checks at once)
138
+ ./scripts/pre-release-check.sh
139
+
140
+ # Local CLI testing
127
141
  node cli/bin/uds.js list
128
142
  node cli/bin/uds.js init --help
143
+
144
+ # Health score (self-diagnosis)
145
+ node cli/bin/uds.js audit --score --self
146
+ node cli/bin/uds.js audit --score --self --format json
147
+
148
+ # External reference check
149
+ node scripts/check-external-references.mjs
150
+
151
+ # Hook statistics analysis (requires opt-in: .uds/config.json {"hookStats": true})
152
+ node scripts/analyze-hook-stats.mjs
129
153
  ```
130
154
 
131
155
  ### Windows (PowerShell)
132
156
 
133
157
  ```powershell
134
- # CLI 開發(在 cli\ 目錄執行)
158
+ # CLI development (run from cli\ directory)
135
159
  cd cli
136
- npm install # 安裝依賴
137
- npm test # 執行測試
138
- npm run test:watch # 以 watch 模式執行測試
139
- npm run lint # 檢查程式碼風格
140
- npm run test:coverage # 產生覆蓋率報告
160
+ npm install # Install dependencies
161
+ npm test # Run tests
162
+ npm run test:watch # Run tests in watch mode
163
+ npm run lint # Check code style
164
+ npm run test:coverage # Generate coverage report
141
165
 
142
- # 翻譯同步檢查(從根目錄執行)
166
+ # Translation sync check (run from root)
143
167
  .\scripts\check-translation-sync.ps1
144
168
 
145
- # 版本同步檢查(從根目錄執行)
169
+ # Version sync check (run from root)
146
170
  .\scripts\check-version-sync.ps1
147
171
 
148
- # 標準一致性檢查(從根目錄執行)
172
+ # Standards consistency check (run from root)
149
173
  .\scripts\check-standards-sync.ps1
150
174
 
151
- # 本地 CLI 測試
175
+ # Pre-release check (run all checks at once)
176
+ .\scripts\pre-release-check.ps1
177
+
178
+ # Local CLI testing
152
179
  node cli\bin\uds.js list
153
180
  node cli\bin\uds.js init --help
154
181
  ```
@@ -156,63 +183,844 @@ node cli\bin\uds.js init --help
156
183
  ### Windows (Git Bash)
157
184
 
158
185
  ```bash
159
- # 與 macOS / Linux 相同的指令在 Git Bash 中可用
186
+ # Same commands as macOS / Linux work in Git Bash
160
187
  ./scripts/check-translation-sync.sh
161
188
  ./scripts/check-version-sync.sh
162
189
  ./scripts/check-standards-sync.sh
190
+ ./scripts/pre-release-check.sh
191
+ ```
192
+
193
+ ## Testing Workflow / 測試工作流程
194
+
195
+ ### When to Run Tests / 何時執行測試
196
+
197
+ | 時機 | 指令 | 目的 |
198
+ |------|------|------|
199
+ | 開發期間 | `npm run test:watch` | 即時回饋 |
200
+ | 提交前 | 自動執行(git hook) | 防止迴歸 |
201
+ | PR 前 | `./scripts/pre-release-check.sh` | 完整驗證 |
202
+ | CI/CD | 自動執行(GitHub Actions) | 持續整合 |
203
+
204
+ ### Git Hooks (Automatic) / Git Hooks(自動執行)
205
+
206
+ Pre-commit hook(`cli/.husky/pre-commit`)會自動執行:
207
+ - `npm run test:unit` - 僅單元測試,排除 E2E(快速,< 5 秒)
208
+ - `eslint --fix` - 透過 lint-staged 自動修正程式碼風格
209
+ - `check-standards-sync.sh` - 若修改了 core/*.md 檔案
210
+ - `check-cli-docs-sync.sh` - 若修改了 cli/bin/*.js 檔案
211
+
212
+ > **注意**:若有任何檢查失敗,commit 將會中止。
213
+
214
+ ### Manual Testing Commands / 手動測試指令
215
+
216
+ ```bash
217
+ # In cli/ directory
218
+ npm test # Run all tests once
219
+ npm run test:watch # Watch mode for development
220
+ npm run test:coverage # Generate coverage report
221
+ npm run lint # Check code style
222
+ ```
223
+
224
+ ### AI Assistant Testing Guidelines / AI 助手測試指南
225
+
226
+ > **重要**:本節為 AI 助手(Claude Code 等)提供在此專案中如何高效率執行測試的指引。
227
+
228
+ **Test Suite Characteristics / 測試套件特性:**
229
+ - 完整測試套件:跨 30+ 個檔案約 1,000 個測試(單元測試 + E2E)
230
+ - 單元測試:執行時間 < 10 秒
231
+ - E2E 測試:約 6 分鐘(產生 CLI 子行程)
232
+ - 完整套件執行時間:約 6 分鐘
233
+
234
+ **🚀 Recommended AI Agent Commands / 推薦的 AI Agent 指令:**
235
+
236
+ | 情境 | 指令 | 執行時間 |
237
+ |------|------|----------|
238
+ | **快速開發** | `cd cli && npm run test:quick` | < 6 秒(864 個測試) |
239
+ | **測試發現** | `cd cli && npm run test:discover` | < 1 秒 |
240
+ | **僅限單元測試** | `cd cli && npm run test:unit` | < 3 秒 |
241
+ | **排除 E2E 測試** | `cd cli && npm run test:fast` | < 5 秒 |
242
+ | **特定變更** | `npm test -- tests/unit/core/ tests/commands/` | < 2 秒 |
243
+
244
+ **📋 Test Discovery Tool / 測試發現工具:**
245
+ ```bash
246
+ # Discover all tests and get execution commands
247
+ cd cli && npm run test:discover
248
+
249
+ # Show commands for different scenarios
250
+ cd cli && node scripts/test-discovery.mjs commands development
163
251
  ```
164
252
 
253
+ **⚠️ Avoid / 避免:**
254
+ - 使用 `--reporter=summary` 或自訂 reporter(相容性問題)
255
+ - 未先確認目前工作目錄就執行測試
256
+
257
+ **✅ Best Practice / 最佳實踐:**
258
+ ```bash
259
+ # ✅ Recommended: Quick development testing
260
+ cd cli && npm run test:quick
261
+
262
+ # ✅ Good: Test specific modules
263
+ npm test -- tests/commands/ai-context.test.js tests/unit/utils/workflows-installer.test.js
264
+
265
+ # ✅ Good: Use test discovery for targeted testing
266
+ cd cli && npm run test:discover
267
+
268
+ # ✅ Full test suite is now fast enough to run directly
269
+ cd cli && npm test # ~6 minutes
270
+ ```
271
+
272
+ ### Test Certificate System (Optional) / 測試憑證系統(可選)
273
+
274
+ 測試憑證系統可用於進階工作流程,但由於完整測試套件執行速度很快(約 6 分鐘),因此在發布前檢查中預設不使用。
275
+
276
+ **Commands / 指令:**
277
+ ```bash
278
+ # Generate certificate after passing tests (optional)
279
+ cd cli && npm run test:with-cert
280
+
281
+ # Verify existing certificate
282
+ cd cli && npm run test:verify
283
+ ```
284
+
285
+ > **注意**:發布前檢查(`pre-release-check.sh`)一律執行完整的測試套件。如有需要,憑證系統可用於自訂的 CI/CD 工作流程。
286
+
287
+ ## 程式碼簽入標準(強制執行)
288
+
289
+ 每一次 commit 在提交之前都必須通過這些品質關卡:
290
+
291
+ ### 核心理念
292
+
293
+ 每個 commit 都應該:
294
+ - ✅ 是一個完整的工作邏輯單元
295
+ - ✅ 讓程式碼庫保持在可正常運作的狀態
296
+ - ✅ 可被還原且不破壞功能
297
+ - ✅ 包含其自有的測試(針對新功能)
298
+
299
+ ### 強制檢查清單
300
+
301
+ 在每一次 commit 之前,請確認:
302
+
303
+ 1. **建置驗證**
304
+ - [ ] 程式碼編譯成功(零錯誤)
305
+ - [ ] 所有相依性均已滿足
306
+
307
+ 2. **測試驗證**
308
+ - [ ] 所有現有測試均通過(100% 通過率)
309
+ - [ ] 新程式碼具有對應的測試
310
+ - [ ] 測試覆蓋率未降低
311
+
312
+ 3. **程式碼品質**
313
+ - [ ] 符合程式碼撰寫標準
314
+ - [ ] 無寫死的機密資訊(密碼、API 金鑰)
315
+ - [ ] 無安全性弱點
316
+
317
+ 4. **文件**
318
+ - [ ] API 文件已更新(若適用)
319
+ - [ ] CHANGELOG 僅在發布前更新,而非每個 commit 更新(遵循 [changelog-standards.md](core/changelog-standards.md))
320
+
321
+ 5. **工作流程合規**
322
+ - [ ] 分支命名正確(`feature/`、`fix/`、`docs/`、`chore/`)
323
+ - [ ] Commit 訊息遵循 Conventional Commits 規範
324
+ - [ ] 與目標分支保持同步
325
+
326
+ ### ❌ 絕不可提交的情況
327
+
328
+ - 建置有錯誤
329
+ - 測試失敗
330
+ - 功能未完成且會破壞現有功能
331
+ - 關鍵邏輯包含 WIP/TODO 註解
332
+ - 包含除錯程式碼(console.log、print 陳述式)
333
+ - 包含被註解掉的程式碼區塊
334
+
335
+ ### 快速驗證指令
336
+
337
+ ```bash
338
+ # In cli/ directory
339
+ npm run lint # Check code style
340
+ npm test # Run all tests
341
+ npm run build # Verify build (if applicable)
342
+ ```
343
+
344
+ ### 參考資料
345
+
346
+ 完整的簽入標準請參閱 [core/checkin-standards.md](core/checkin-standards.md)
347
+
348
+ ---
349
+
165
350
  ## AI 協作指南
166
351
 
167
352
  在此專案中使用 AI 助手(Claude Code、Cursor 等)時:
168
353
 
354
+ ### Conversation Language / 對話語言
355
+
356
+ - **所有與 AI 助手的對話皆應以繁體中文進行**
357
+ - AI 助手應以繁體中文回覆使用者的問題與請求
358
+
169
359
  ### 應該做的:
170
- - 參考 `core/` 中現有標準以保持一致性
360
+ - 參考 `core/` 中的現有標準以保持一致性
171
361
  - 文件遵循雙語格式(英文 + 繁體中文)
172
362
  - 修改核心規範後檢查翻譯同步
173
- - 提交前執行測試和程式碼檢查
363
+ - 提交前執行測試與程式碼檢查(linting)
174
364
 
175
365
  ### 不應該做的:
176
- - 建立新標準時不遵循現有範本結構
177
- - 修改翻譯檔案而不更新原始檔案
366
+ - 未遵循現有範本結構建立新標準
367
+ - 修改翻譯檔案卻未更新原始檔案
178
368
  - 跳過 PR 的程式碼審查檢查清單
179
- - 在核心規範中引入特定語言或框架的內容
369
+ - 在核心規範中引入特定語言或特定框架的內容
370
+ - 未先閱讀程式碼就對其做出斷言(參見反幻覺規範)
371
+ - 未先執行測試就提交程式碼
180
372
 
181
373
  ### 專案特定脈絡:
182
374
  - 本專案使用 ES Modules(非 CommonJS)
183
- - 所有核心規範應保持語言/框架無關
184
- - 需要雙語文件(英文主版本,zh-TW 翻譯)
185
- - CLI 工具是主要程式碼元件;大部分內容是 Markdown
375
+ - 所有核心規範應保持語言/框架無關
376
+ - 需要雙語文件(英文為主,zh-TW 翻譯)
377
+ - CLI 工具是主要程式碼元件;大部分內容為 Markdown
378
+
379
+ ### BDD/TDD Output Directories / BDD/TDD 輸出目錄
380
+
381
+ 從 SDD 規格產生 BDD 與 TDD 檔案時:
382
+
383
+ | 類型 | 目錄 | 說明 |
384
+ |------|-----------|-------------|
385
+ | BDD Features | `tests/features/` | Gherkin .feature 檔案 |
386
+ | TDD Unit Tests | `cli/tests/unit/` | Vitest 單元測試 |
387
+ | SDD Specs | `docs/specs/` | 規格文件 |
388
+
389
+ **BDD Feature 檔案格式:**
390
+ - 包含 `@SPEC-XXX` 與 `@AC-N` 標籤以利追蹤
391
+ - 包含 `# [Source: path:AC-N]` 註解以註明來源出處
392
+ - 每個 AC 一個 Scenario(1:1 對應)
393
+
394
+ **TDD 測試檔案格式:**
395
+ - 巢狀 describe:SPEC 層級 → AC 層級
396
+ - AAA 模式註解(Arrange-Act-Assert)
397
+ - 使用 `[TODO]` 標記作為實作預留位置
398
+
399
+ ### Anti-Hallucination Standards / 反幻覺規範
400
+
401
+ 在此專案中工作時,AI 助手必須遵循 [core/anti-hallucination.md](core/anti-hallucination.md):
402
+
403
+ | 要求 | 說明 |
404
+ |-------------|-------------|
405
+ | **以證據為基礎(Evidence-Based)** | 僅分析已明確閱讀的內容 |
406
+ | **標明來源出處(Source Attribution)** | 使用 `[Source: Code]`、`[Source: Docs]` 標籤並附帶 file:line 參照 |
407
+ | **確定性分級(Certainty Classification)** | 使用 `[Confirmed]`、`[Inferred]`、`[Assumption]`、`[Unknown]` 標籤 |
408
+ | **提供建議(Recommendations)** | 提供選項時務必包含建議選項與理由 |
409
+ | **禁止捏造(No Fabrication)** | 絕不可在未經查證的情況下捏造 API、設定或需求 |
410
+
411
+ ### Code Review Standards / 程式碼審查規範
412
+
413
+ 審查程式碼或 PR 時,遵循 [core/code-review-checklist.md](core/code-review-checklist.md):
414
+
415
+ **審查清單類別:**
416
+ 1. 功能性(Functionality)- 是否能正確運作?
417
+ 2. 設計與架構(Design & Architecture)- 是否遵循專案模式?
418
+ 3. 程式碼品質(Code Quality)- 簡潔、DRY、SOLID?
419
+ 4. 可讀性(Readability)- 是否易於理解?
420
+ 5. 測試(Testing)- 覆蓋率是否充足?
421
+ 6. 安全性(Security)- 是否無漏洞?
422
+ 7. 效能(Performance)- 是否具備效率?
423
+ 8. 錯誤處理(Error Handling)- 是否妥善處理?
424
+ 9. 文件(Documentation)- 是否已更新?
425
+ 10. 相依套件(Dependencies)- 是否有充分理由?
426
+
427
+ **評論前綴:**
428
+
429
+ | 前綴 | 意義 |
430
+ |--------|---------|
431
+ | ❗ BLOCKING | 合併前必須修復 |
432
+ | ⚠️ IMPORTANT | 應予以修復 |
433
+ | 💡 SUGGESTION | 有則更好(選用) |
434
+ | ❓ QUESTION | 需要釐清 |
435
+
436
+ ### Testing Standards / 測試規範
186
437
 
187
- ### 規範合規參考
438
+ 關於測試要求,遵循 [core/testing-standards.md](core/testing-standards.md):
439
+
440
+ **測試金字塔(預設比例):**
441
+
442
+ | 層級 | 比例 | 用途 |
443
+ |-------|-------|---------|
444
+ | 單元測試(UT) | 70% | 測試個別函式/方法 |
445
+ | 整合測試(IT) | 20% | 測試元件間的互動 |
446
+ | 端對端測試(E2E) | 10% | 測試使用者工作流程 |
447
+
448
+ **關鍵要求:**
449
+ - 所有新功能必須有對應的測試
450
+ - 提交前執行測試
451
+ - 維持或提高測試覆蓋率
452
+ - 使用具描述性的測試名稱,遵循 `should_[expected]_when_[condition]` 模式
453
+
454
+ ### Standards Compliance Reference / 規範合規參考
188
455
 
189
456
  | 任務 | 必須遵循 | 參考 |
457
+ |------|-------------|-----------|
458
+ | 程式碼分析 | 反幻覺規範 | [core/anti-hallucination.md](core/anti-hallucination.md) |
459
+ | PR 審查 | 程式碼審查清單 | [core/code-review-checklist.md](core/code-review-checklist.md) |
460
+ | 新增功能 | 測試規範 | [core/testing-standards.md](core/testing-standards.md) |
461
+ | 任何提交 | 提交規範 | [core/checkin-standards.md](core/checkin-standards.md) |
462
+ | 新功能設計 | 規格驅動開發 | [core/spec-driven-development.md](core/spec-driven-development.md) |
463
+ | 新增/修改 Core↔Skill | /sdd + 同步檢查 | 參見下方的「Core↔Skill 同步規則」 |
464
+ | 回溯規格追蹤 | /sdd-retro | 參見下方的「規格追蹤」 |
465
+ | 撰寫 AI 指令 | AI 指令規範 | [core/ai-instruction-standards.md](core/ai-instruction-standards.md) |
466
+ | 撰寫文件 | 文件撰寫規範 | [core/documentation-writing-standards.md](core/documentation-writing-standards.md) |
467
+ | 適用於 AI 的專案架構 | AI 友善架構 | [core/ai-friendly-architecture.md](core/ai-friendly-architecture.md) |
468
+ | 標準載入策略 | 上下文感知載入 | [core/context-aware-loading.md](core/context-aware-loading.md) |
469
+ | 跨工作階段狀態 | 專案上下文記憶 | [core/project-context-memory.md](core/project-context-memory.md) |
470
+
471
+ ---
472
+
473
+ ## 採用層整合策略
474
+
475
+ UDS 定位為**純標準庫**(Standards Definition Library)。它定義「該做什麼」,並透過 `.standards/` 由任意採用層(Adapters / Pipelines / Agents / IDE)讀取與執行。UDS 本身**不綁定**任何特定下游產品、不提供 runtime、不指定授權模式。
476
+
477
+ ```
478
+ UDS(標準定義;MIT + CC BY 4.0)──→ 採用層(任意 Adapter / Pipeline / Agent / IDE)
479
+ ```
480
+
481
+ ### UDS 的角色
482
+
483
+ 1. **標準來源**:UDS 定義 70+ 項標準供任意採用層消費
484
+ 2. **工具無關**:UDS 支援 12+ 種 AI 工具與一般 CI / IDE 整合
485
+ 3. **授權獨立**:UDS 採 MIT + CC BY 4.0;採用層的授權選擇與 UDS 無關
486
+
487
+ ### 標準如何流向採用層
488
+
489
+ | 流向 | 機制 | 說明 |
490
+ |------|------|------|
491
+ | UDS → 採用層 | `.standards/` copy-once | 採用層透過 `uds init` 安裝標準,於 Quality Gate / Agent prompt / IDE rule 中讀取 |
492
+ | UDS → CI 整合 | `.standards/` 引用 | CI / pre-commit hook 讀取對應 `.ai.yaml` 進行驗證 |
493
+ | UDS → 採用層 bridges | 例如 TestPolicy 格式 | 採用層在 UDS 之上建立特定 bridge(如 test-governance → TestPolicy)|
494
+
495
+ ### 對 UDS 開發的影響
496
+
497
+ - 新增/修改標準時,需考慮**通用採用場景**(不假設特定下游產品的內部結構)
498
+ - 標準格式需保持中性、可攜(不嵌入採用層的實作細節)
499
+ - 標準的 scope 標記(universal/partial/uds-specific)影響可攜性
500
+
501
+ ---
502
+
503
+ <!-- UDS:STANDARDS:START -->
504
+ <!-- WARNING: This block is managed by UDS (universal-dev-standards). DO NOT manually edit. Use 'npx universal-dev-standards install' or 'npx universal-dev-standards update' to modify. -->
505
+ <!-- WARNING: This block is managed by UDS (universal-dev-standards). DO NOT manually edit. Use 'npx universal-dev-standards install' or 'npx universal-dev-standards update' to modify. -->
506
+ ## Commit 訊息語言
507
+ 以**雙語**格式(英文 + 繁體中文)撰寫 commit 訊息。
508
+ 格式:`<type>(<scope>): <English>. <中文>.`
509
+ 內文必須為雙語:英文在前 → 空行 → 中文在後。絕不可在單一段落中混合語言。
510
+
511
+ ## 規範遵循指示
512
+
513
+ **MUST follow**(每次都要遵守):
514
+ | 任務 | 規範 | 時機 |
515
+ |------|----------|------|
516
+ | 撰寫 commit | [commit-message.ai.yaml](../../.standards/commit-message.ai.yaml) | 每次 commit |
517
+ | 專案脈絡 | [project-context-memory.ai.yaml](../../.standards/project-context-memory.ai.yaml) | 規劃與編寫程式碼 |
518
+
519
+ **SHOULD follow**(相關任務時參考):
520
+ | 任務 | 規範 | 時機 |
190
521
  |------|----------|------|
191
- | 程式碼分析 | 反幻覺標準 | [core/anti-hallucination.md](../../core/anti-hallucination.md) |
192
- | PR 審查 | 程式碼審查清單 | [core/code-review-checklist.md](../../core/code-review-checklist.md) |
193
- | 新增功能 | 測試標準 | [core/testing-standards.md](../../core/testing-standards.md) |
194
- | 任何提交 | 提交規範 | [core/checkin-standards.md](../../core/checkin-standards.md) |
195
- | 新功能設計 | 規格驅動開發 | [core/spec-driven-development.md](../../core/spec-driven-development.md) |
196
- | 撰寫 AI 指令 | AI 指令標準 | [core/ai-instruction-standards.md](../../core/ai-instruction-standards.md) |
197
- | 撰寫文件 | 文件撰寫標準 | [core/documentation-writing-standards.md](../../core/documentation-writing-standards.md) |
522
+ | Git 工作流程 | [git-workflow.ai.yaml](../../.standards/git-workflow.ai.yaml) | 分支/合併決策 |
523
+ | 撰寫測試 | [testing.ai.yaml](../../.standards/testing.ai.yaml) | 建立測試時 |
524
+ | 開發者記憶 | [developer-memory.ai.yaml](../../.standards/developer-memory.ai.yaml) | 一律遵守(通訊協定) |
525
+
526
+ ## 已安裝標準索引
527
+
528
+ 本專案採用 UDS 標準。所有規範位於 `.standards/`:
529
+
530
+ ### 核心(55 個標準)
531
+ - `anti-hallucination.ai.yaml` - anti-hallucination.ai.yaml
532
+ - `ai-friendly-architecture.ai.yaml` - ai-friendly-architecture.ai.yaml
533
+ - `commit-message.ai.yaml` - 提交訊息格式
534
+ - `english.ai.yaml` - english.ai.yaml
535
+ - `checkin-standards.ai.yaml` - checkin-standards.ai.yaml
536
+ - `spec-driven-development.ai.yaml` - spec-driven-development.ai.yaml
537
+ - `code-review.ai.yaml` - code-review.ai.yaml
538
+ - `git-workflow.ai.yaml` - Git 工作流程
539
+ - `github-flow.ai.yaml` - github-flow.ai.yaml
540
+ - `squash-merge.ai.yaml` - squash-merge.ai.yaml
541
+ - `versioning.ai.yaml` - versioning.ai.yaml
542
+ - `changelog.ai.yaml` - changelog.ai.yaml
543
+ - `testing.ai.yaml` - 測試標準
544
+ - `unit-testing.ai.yaml` - unit-testing.ai.yaml
545
+ - `integration-testing.ai.yaml` - integration-testing.ai.yaml
546
+ - `documentation-structure.ai.yaml` - documentation-structure.ai.yaml
547
+ - `documentation-writing-standards.ai.yaml` - documentation-writing-standards.ai.yaml
548
+ - `ai-instruction-standards.ai.yaml` - ai-instruction-standards.ai.yaml
549
+ - `project-structure.ai.yaml` - project-structure.ai.yaml
550
+ - `error-codes.ai.yaml` - error-codes.ai.yaml
551
+ - `logging.ai.yaml` - logging.ai.yaml
552
+ - `test-completeness-dimensions.ai.yaml` - test-completeness-dimensions.ai.yaml
553
+ - `test-driven-development.ai.yaml` - test-driven-development.ai.yaml
554
+ - `behavior-driven-development.ai.yaml` - behavior-driven-development.ai.yaml
555
+ - `acceptance-test-driven-development.ai.yaml` - acceptance-test-driven-development.ai.yaml
556
+ - `reverse-engineering-standards.ai.yaml` - reverse-engineering-standards.ai.yaml
557
+ - `forward-derivation-standards.ai.yaml` - forward-derivation-standards.ai.yaml
558
+ - `ai-agreement-standards.ai.yaml` - ai-agreement-standards.ai.yaml
559
+ - `virtual-organization-standards.ai.yaml` - virtual-organization-standards.ai.yaml
560
+ - `refactoring-standards.ai.yaml` - refactoring-standards.ai.yaml
561
+ - `requirement-engineering.ai.yaml` - requirement-engineering.ai.yaml
562
+ - `security-standards.ai.yaml` - security-standards.ai.yaml
563
+ - `performance-standards.ai.yaml` - performance-standards.ai.yaml
564
+ - `accessibility-standards.ai.yaml` - accessibility-standards.ai.yaml
565
+ - `requirement-checklist.md` - requirement-checklist.md
566
+ - `requirement-template.md` - requirement-template.md
567
+ - `requirement-document-template.md` - requirement-document-template.md
568
+ - `deployment-standards.ai.yaml` - deployment-standards.ai.yaml
569
+ - `developer-memory.ai.yaml` - 開發者持久記憶
570
+ - `project-context-memory.ai.yaml` - 專案情境記憶
571
+ - `context-aware-loading.ai.yaml` - context-aware-loading.ai.yaml
572
+ - `test-governance.ai.yaml` - test-governance.ai.yaml
573
+ - `structured-task-definition.ai.yaml` - structured-task-definition.ai.yaml
574
+ - `acceptance-criteria-traceability.ai.yaml` - acceptance-criteria-traceability.ai.yaml
575
+ - `api-design-standards.ai.yaml` - api-design-standards.ai.yaml
576
+ - `database-standards.ai.yaml` - database-standards.ai.yaml
577
+ - `systematic-debugging.ai.yaml` - systematic-debugging.ai.yaml
578
+ - `model-selection.ai.yaml` - model-selection.ai.yaml
579
+ - `git-worktree.ai.yaml` - git-worktree.ai.yaml
580
+ - `verification-evidence.ai.yaml` - verification-evidence.ai.yaml
581
+ - `ai-command-behavior.ai.yaml` - ai-command-behavior.ai.yaml
582
+ - `ai-response-navigation.ai.yaml` - ai-response-navigation.ai.yaml
583
+ - `documentation-lifecycle.ai.yaml` - documentation-lifecycle.ai.yaml
584
+ - `adr-standards.ai.yaml` - adr-standards.ai.yaml
585
+ - `retrospective-standards.ai.yaml` - retrospective-standards.ai.yaml
586
+ - `dual-phase-output.ai.yaml` - 雙階段 LLM 輸出標準(<analysis> 丟棄 + <summary> 保留)
587
+ - `circuit-breaker.ai.yaml` - 通用斷路器(三態 CLOSED/HALF_OPEN/OPEN,防 API 雪崩)
588
+ - `token-budget.ai.yaml` - Token 閾值四區模型(安全/警告/危險/阻塞)
589
+ - `security-decision.ai.yaml` - 安全決策鐵律(deny > ask > allow 優先級仲裁)
590
+ - `capability-declaration.ai.yaml` - Fail-Closed 能力聲明(工具/Adapter 預設不安全)
591
+ <!-- UDS:STANDARDS:END -->
592
+
593
+ ---
594
+
595
+ ## 修改後驗證
596
+
597
+ **重要**:完成以下任何修改後,AI 助手必須驗證所有相關檔案均已更新(具體細節請參閱以下章節)。完整的維護工作流程在 AsiaOstrich dev-platform 規劃中心內部追蹤(`cross-project/ops/uds-operation.md`)。
598
+
599
+ | 修改類型 | 關鍵檢查項目 |
600
+ |---|---|
601
+ | 新增/修改核心標準 | 更新 registry、翻譯、Related Standards 章節 |
602
+ | 新增/修改 Skill | 更新 skillFiles 對應、Skill 數量測試 |
603
+ | 新增/修改 AI 工具整合 | 更新 ai-agent-paths.js、CLAUDE.md 整合清單 |
604
+ | 準備發布 | 執行 bump-version.mjs、更新 CHANGELOG、驗證同步腳本 |
605
+ | 任何多檔案變更 | 執行 check-standards-sync.sh + check-translation-sync.sh |
606
+ | 新增/修改安裝指令 | 跨平台指令同步(見下文) |
607
+
608
+ ### 快速驗證(所有變更)
609
+
610
+ 在進行任何修改後,請執行:
611
+ ```bash
612
+ # Run all checks at once (recommended)
613
+ ./scripts/pre-release-check.sh
614
+
615
+ # Or run individual checks:
616
+ ./scripts/check-standards-sync.sh
617
+ ./scripts/check-translation-sync.sh
618
+ ./scripts/check-version-sync.sh
619
+ ./scripts/check-ai-agent-sync.sh
620
+ ./scripts/check-spec-sync.sh # Core↔Skill sync
621
+ ./scripts/check-scope-sync.sh # Scope universality check
622
+ ./scripts/check-docs-integrity.sh # Documentation integrity
623
+ ./scripts/check-orphan-specs.sh # Orphan spec detection
624
+ npx tsx scripts/check-ai-behavior-sync.ts # AI Agent Behavior coverage
625
+ cd cli && npm test && npm run lint
626
+ ```
627
+
628
+ > **AI Agent 同步檢查 SOP**:AI Agent 同步 SOP 在 dev-platform 規劃中心內部維護(`cross-project/ops/uds-ai-agent-sync-sop.md`)。
629
+
630
+ ### Core↔Skill 同步規則(UDS 專用)
631
+
632
+ > ⚠️ 本節為 UDS 專案專用。UDS 專案維護 Core Standard、Skill 與 Command 之間的雙向關係。
633
+
634
+ #### 同步架構
635
+
636
+ ```
637
+ Core Standard ◄──────────► Skill ◄──────────► Command
638
+ │ │ │
639
+ └───────────────────────┴───────────────────┘
640
+ ▼
641
+ Translations
642
+ ```
643
+
644
+ #### 同步矩陣
645
+
646
+ | 變更來源 | 必須評估同步至 |
647
+ |---|---|
648
+ | Core Standard | → Skill、Command、AI YAML、Translations |
649
+ | Skill | → Core Standard(若適用)、Command、Translations |
650
+ | Command | → Skill、Translations |
651
+
652
+ #### Core↔Skill 對應
653
+
654
+ | 類別 | 說明 | 範例 |
655
+ |---|---|---|
656
+ | **Has Core Standard** | Skill 實作了 Core Standard | `commit-standards` ↔ `commit-message-guide.md` |
657
+ | **Utility Skill** | 不需要 Core Standard(工具/產生器) | `docs-generator`、`code-formatter` |
658
+ | **Static Skill** | 僅供參考,無互動 | 僅連結至標準的 Skill |
659
+
660
+ #### 強制 /sdd 工作流程
661
+
662
+ **以下任何變更均必須先使用 `/sdd`:**
663
+
664
+ 1. **新增功能**
665
+ - 新增 Core Standard
666
+ - 新增 Skill
667
+ - 新增 Slash Command
668
+
669
+ 2. **修改功能**
670
+ - 修改 Core Standard 內容
671
+ - 修改 Skill 行為
672
+ - 修改 Command 功能
673
+
674
+ 3. **移除功能**
675
+ - 移除標準
676
+ - 移除 Skill/Command
677
+
678
+ **例外情況(可跳過 /sdd):**
679
+ - 錯字修正
680
+ - 格式變更
681
+ - 純翻譯更新
682
+ - 緊急熱修復(必須事後補寫文件記錄)
683
+
684
+ #### 同步檢查腳本
685
+
686
+ **macOS / Linux:**
687
+ ```bash
688
+ ./scripts/check-spec-sync.sh
689
+ ```
690
+
691
+ **Windows PowerShell:**
692
+ ```powershell
693
+ .\scripts\check-spec-sync.ps1
694
+ ```
695
+
696
+ 預期輸出:
697
+ ```
698
+ ✓ commit-standards ↔ core/commit-message-guide.md
699
+ ✓ testing-guide ↔ core/testing-standards.md
700
+ ⚠ docs-generator (utility, no core standard required)
701
+ ✓ All Skills synced with Core Standards
702
+ ```
703
+
704
+ ### Spec 追蹤
705
+
706
+ 三種機制確保 spec 可追蹤性:
707
+
708
+ 1. **`/commit` spec 評估** —— 對於 `feat`/`fix` commit,AI 會建議建立或連結 spec。詳情請參閱 [`skills/commands/commit.md`](skills/commands/commit.md)。
709
+ 2. **`/sdd-retro`** —— 為未追蹤的 commit(例如緊急熱修復)事後補建 spec。詳情請參閱 [`skills/commands/sdd-retro.md`](skills/commands/sdd-retro.md)。
710
+ 3. **孤立 spec 偵測** —— `check-orphan-specs.sh` 會標記停滯在非終止狀態的 spec。已作為步驟 15 整合至 `pre-release-check.sh`(僅發出警告)。
711
+
712
+ ### Scope 通用性標記系統
713
+
714
+ 所有 Core Standard 與 Skill 皆標記有 `scope` 欄位,用以表示其通用性:
715
+
716
+ | Scope | 說明 | 用法 |
717
+ |---|---|---|
718
+ | `universal` | 完全通用,任何專案皆可使用 | 可直接採用 |
719
+ | `partial` | 概念通用但包含 UDS 專用細節 | 採用前請先檢視 |
720
+ | `uds-specific` | UDS 專案專用工具或工作流程 | 僅供內部使用 |
721
+
722
+ #### 分布統計
723
+
724
+ **目前分布:**
725
+ - **Core Standards**:14 個 universal(61%)、7 個 partial(30%)、2 個 uds-specific(9%)
726
+ - **Skills**:12 個 universal(48%)、10 個 partial(40%)、3 個 uds-specific(12%)
727
+
728
+ #### 標記位置
729
+
730
+ - **Skills**:位於 `SKILL.md` 的 YAML frontmatter 中
731
+ ```yaml
732
+ ---
733
+ name: skill-name
734
+ scope: universal
735
+ description: ...
736
+ ---
737
+ ```
738
+
739
+ - **Core Standards**:位於 Markdown metadata 中
740
+ ```markdown
741
+ **Applicability**: All software projects
742
+ **Scope**: universal
743
+ ```
744
+
745
+ #### 範圍檢查腳本
746
+
747
+ **macOS / Linux:**
748
+ ```bash
749
+ ./scripts/check-scope-sync.sh
750
+ ```
751
+
752
+ **Windows PowerShell:**
753
+ ```powershell
754
+ .\scripts\check-scope-sync.ps1
755
+ ```
756
+
757
+ ### 跨平台指令同步(UDS 專用)
758
+
759
+ > ⚠️ 本節為 UDS 專案專用。並非所有專案都需要維護包含跨平台指令的雙語翻譯。
760
+
761
+ #### 何時檢查
762
+
763
+ 修改這些 UDS 專案檔案後,請驗證跨平台指令同步:
764
+ - 採用指南(`adoption/`)
765
+ - Skill 安裝說明(`skills/*/README.md`)
766
+ - 維護指南(`ai/MAINTENANCE.md`)
767
+ - 檢查清單(`adoption/checklists/`)
768
+
769
+ #### 需要同步的檔案
770
+
771
+ 有 33 個檔案需要維護跨平台指令:
772
+ - 英文來源:11 個檔案
773
+ - zh-TW 翻譯:11 個檔案
774
+ - zh-CN 翻譯:11 個檔案
775
+
776
+ #### 標準指令對照
777
+
778
+ | Bash | PowerShell | 用途 |
779
+ |---|---|---|
780
+ | `cp file dest/` | `Copy-Item file dest\` | 複製檔案 |
781
+ | `cp -r dir/ dest/` | `Copy-Item -Recurse dir\ dest\` | 遞迴複製 |
782
+ | `mkdir -p dir` | `New-Item -ItemType Directory -Force -Path dir` | 建立目錄 |
783
+ | `~/` | `$env:USERPROFILE\` | 使用者目錄 |
784
+ | `./script.sh` | `.\script.ps1` | 執行腳本 |
785
+
786
+ #### 標籤慣例
787
+
788
+ 針對特定平台的程式碼區塊請使用以下標籤:
789
+ - `**macOS / Linux:**` 後接 bash 程式碼區塊
790
+ - `**Windows PowerShell:**` 後接 powershell 程式碼區塊
791
+
792
+ ---
793
+
794
+ ## 發布流程
795
+
796
+ 準備發布或協助版本管理時:
797
+
798
+ ### 參考文件
799
+
800
+ - **完整發布工作流程**:[skills/release-standards/release-workflow.md](skills/release-standards/release-workflow.md)
801
+ - **語意化版本控制**:[skills/release-standards/semantic-versioning.md](skills/release-standards/semantic-versioning.md)
802
+ - **版本控制標準**:[core/versioning.md](core/versioning.md)
803
+ - **CHANGELOG 格式**:[skills/release-standards/changelog-format.md](skills/release-standards/changelog-format.md)
804
+
805
+ ### AI 助手的關鍵要點
806
+
807
+ 1. **絕不手動執行 `npm publish`**:GitHub Actions 會自動處理此操作
808
+ 2. **版本偵測完全自動**:`.github/workflows/publish.yml` 會偵測版本類型並使用正確的 npm 標籤
809
+ 3. **務必遵循檢查清單**:release-workflow.md 中的預發布檢查
810
+ 4. **CHANGELOG 優先**:建立發布前先更新 CHANGELOG.md
811
+
812
+ ### 發布類型
813
+
814
+ | 類型 | 版本模式 | npm 標籤 | 自動偵測 |
815
+ |------|----------------|---------|---------------|
816
+ | Stable | `X.Y.Z` | `@latest` | ✅ 是 |
817
+ | Beta | `X.Y.Z-beta.N` | `@beta` | ✅ 是 |
818
+ | Alpha | `X.Y.Z-alpha.N` | `@alpha` | ✅ 是 |
819
+ | RC | `X.Y.Z-rc.N` | `@rc` | ✅ 是 |
820
+
821
+ ### AI 助手工作流程
822
+
823
+ 當使用者要求準備發布時:
824
+
825
+ 1. **詢問發布類型**:beta、alpha、rc 或 stable
826
+ 2. **執行預發布檢查**:測試、程式碼檢查(linting)、git 狀態
827
+ 3. **執行 `bump-version.mjs`** — 以不可分割的方式(atomically)更新所有版本檔案(請參閱下方的 UDS 特定章節)
828
+ 4. **更新 CHANGELOG.md**(英文 + zh-TW + zh-CN):遵循 release-workflow.md 中的格式
829
+ 5. **提交、標記、推送**:`git add -A && git commit && git tag vX.Y.Z && git push origin main vX.Y.Z`
830
+ 6. **建立 GitHub Release**:使用 `gh release create` 指令
831
+
832
+ > ⚠️ **絕不要手動更新個別版本檔案**。請一律使用 `node scripts/bump-version.mjs`(或其 macOS/Linux 包裝指令檔 `scripts/bump-version.sh`),以避免遺漏檔案。
833
+
834
+ ### UDS 專案特定發布步驟
835
+
836
+ > ⚠️ **重要**:本節包含 UDS 特定需求,除了標準發布工作流程外**必須**嚴格遵守。
837
+
838
+ #### 步驟 0:執行 bump-version.mjs(強制)
839
+
840
+ **請一律使用版本升級指令檔** — 它會以不可分割的方式(atomically)更新所有檔案並執行驗證:
841
+
842
+ ```bash
843
+ # Cross-platform (macOS / Linux / Windows) — the only copy of the bump logic
844
+ node scripts/bump-version.mjs 5.2.0-beta.1 # Pre-release
845
+ node scripts/bump-version.mjs 5.2.0 # Stable
846
+
847
+ # macOS / Linux convenience wrapper (thin exec into the .mjs above):
848
+ ./scripts/bump-version.sh 5.2.0-beta.1
849
+ ./scripts/bump-version.sh 5.2.0
850
+
851
+ # After bump-version.mjs:
852
+ # → Update CHANGELOG.md (EN + zh-TW + zh-CN) manually
853
+ # → git add -A && git commit -m "chore(release): X.Y.Z"
854
+ # → git tag vX.Y.Z && git push origin main vX.Y.Z
855
+ ```
856
+
857
+ 此指令檔會自動處理以下檔案:
858
+
859
+ | 檔案 | 欄位 | Alpha/Beta/RC | 穩定版 |
860
+ |------|-------|---------------|--------|
861
+ | `cli/package.json` | `"version"` | ✅ 自動 | ✅ 自動 |
862
+ | `cli/package-lock.json` | `"version"` + `packages[""].version` | ✅ 自動 | ✅ 自動 |
863
+ | `cli/standards-registry.json` | `"version"` (3 處) | ✅ 自動 | ✅ 自動 |
864
+ | `uds-manifest.json` | `"version"` + `"last_updated"` | ✅ 自動 | ✅ 自動 |
865
+ | `README.md` | `**Version**:` | ✅ 自動 | ✅ 自動 |
866
+ | `locales/zh-TW/README.md` | `**版本**:` | ✅ 自動 | ✅ 自動 |
867
+ | `locales/zh-CN/README.md` | `**版本**:` | ✅ 自動 | ✅ 自動 |
868
+ | `locales/zh-TW/CHANGELOG.md` | frontmatter | ✅ 自動 | ✅ 自動 |
869
+ | `locales/zh-CN/CHANGELOG.md` | frontmatter | ✅ 自動 | ✅ 自動 |
870
+ | `.claude-plugin/plugin.json` | `"version"` | ❌ 略過 | ✅ 自動 |
871
+ | `.claude-plugin/marketplace.json` | `"version"` | ❌ 略過 | ✅ 自動 |
872
+
873
+ > **Marketplace 版本策略**:`.claude-plugin/` 檔案僅在穩定版本發布時更新。這樣可以防止 beta/alpha 版本自動推播給 Claude Plugin Marketplace 使用者。Marketplace 使用者將只會收到穩定版本。
874
+
875
+ #### 預發布驗證指令檔
876
+
877
+ ```bash
878
+ # macOS / Linux
879
+ ./scripts/pre-release-check.sh
880
+
881
+ # Windows PowerShell
882
+ .\scripts\pre-release-check.ps1
883
+ ```
884
+
885
+ 這會執行 19 項檢查,包括:
886
+ 1. Git 工作目錄狀態
887
+ 2. 版本同步(`check-version-sync.sh`)
888
+ 3. 標準同步(`check-standards-sync.sh`)
889
+ 4. 翻譯同步(`check-translation-sync.sh`)
890
+ 5-11. CLI-docs、docs、AI agent、使用文件、spec、scope、指令同步檢查
891
+ 12. 文件完整性(`check-docs-integrity.sh`)
892
+ 13. Skill 後續步驟同步(`check-skill-next-steps-sync.sh`)
893
+ 14. 程式碼檢查(Linting)
894
+ 15. 孤立規格偵測(`check-orphan-specs.sh`)
895
+ 16. AI Agent 行為涵蓋率(`check-ai-behavior-sync.ts`)
896
+ 17. 工作流程合規性
897
+ 18. 單元測試
898
+ 19. E2E 測試(Bug 回歸)
899
+
900
+ #### 翻譯同步(穩定版本)
901
+
902
+ 對於穩定版本,請確保翻譯已同步:
903
+ ```bash
904
+ ./scripts/check-translation-sync.sh # zh-TW
905
+ ./scripts/check-translation-sync.sh zh-CN # zh-CN
906
+ ```
907
+
908
+ #### UDS 三階段發布工作流程(Alpha→Beta→Stable)
909
+
910
+ > **附註**:此工作流程專屬於 UDS 專案。通用發布工作流程(請參閱 `release-workflow.md`)採用較簡單的 Beta→Stable 模式,適用於大多數專案。
911
+
912
+ **工作流程理念**:先定版本,再驗證。在測試前指派版本號,以確保驗證目標對準確切的發布版本。
913
+
914
+ **階段概述:**
915
+
916
+ | 階段 | 版本模式 | npm 標籤 | 目的 |
917
+ |-------|-----------------|---------|---------|
918
+ | 階段 1:Alpha | `X.Y.Z-alpha.N` | `@alpha` | 內部驗證、預發布檢查 |
919
+ | 階段 2:Beta | `X.Y.Z-beta.N` | `@beta` | 公開測試、搶先體驗者回饋 |
920
+ | 階段 3:Stable | `X.Y.Z` | `@latest` | 生產環境發布 |
921
+
922
+ **詳細步驟:**
923
+
924
+ **階段 1:Alpha 發布(內部)**
925
+ 1. 更新版本至 alpha:`npm version X.Y.Z-alpha.1 --no-git-tag-version`
926
+ 2. 僅更新 CLI 版本檔案(2 個檔案):
927
+ - `cli/package.json`
928
+ - `cli/standards-registry.json`
929
+ 3. **請勿更新** `.claude-plugin/` 檔案(保留先前的穩定版本)
930
+ 4. 執行預發布檢查:`./scripts/pre-release-check.sh`
931
+ 5. 使用 alpha 說明更新 CHANGELOG
932
+ 6. 提交:`chore(release): X.Y.Z-alpha.1`
933
+ 7. 建立標籤:`vX.Y.Z-alpha.1`
934
+ 8. 推送並建立 GitHub Release(標記為預發布版本)
935
+
936
+ **階段 2:Beta 發布(公開測試)**
937
+ 1. Alpha 驗證通過後,更新至 beta:`npm version X.Y.Z-beta.1 --no-git-tag-version`
938
+ 2. 僅更新 CLI 版本檔案(2 個檔案):
939
+ - `cli/package.json`
940
+ - `cli/standards-registry.json`
941
+ 3. **請勿更新** `.claude-plugin/` 檔案(保留先前的穩定版本)
942
+ 4. 執行完整測試套件
943
+ 5. 使用 beta 說明更新 CHANGELOG
944
+ 6. 提交:`chore(release): X.Y.Z-beta.1`
945
+ 7. 建立標籤:`vX.Y.Z-beta.1`
946
+ 8. 推送並建立 GitHub Release(標記為預發布版本)
947
+ 9. 向搶先體驗者公佈以收集回饋
948
+
949
+ **階段 3:Stable 發布(正式環境)**
950
+ 1. Beta 測試完成後,更新至 stable:`npm version X.Y.Z --no-git-tag-version`
951
+ 2. 更新**所有**版本檔案(5 個檔案):
952
+ - `cli/package.json`
953
+ - `cli/standards-registry.json`
954
+ - `.claude-plugin/plugin.json` ← 在此處更新 Marketplace
955
+ - `.claude-plugin/marketplace.json` ← 在此處更新 Marketplace
956
+ - `README.md`
957
+ 3. 定稿 CHANGELOG(移除 beta 警告,加入穩定版說明)
958
+ 4. 同步翻譯:`./scripts/check-translation-sync.sh`
959
+ 5. 執行最終預發布檢查
960
+ 6. 提交:`chore(release): X.Y.Z`
961
+ 7. 建立標籤:`vX.Y.Z`
962
+ 8. 推送並建立 GitHub Release
963
+ 9. 驗證 npm 發布:`npm view universal-dev-standards dist-tags`
964
+
965
+ **何時使用此工作流程:**
966
+ - 包含重大變更(breaking changes)的主要版本發布
967
+ - 需要大量測試的功能
968
+ - 需要搶先體驗者驗證的發布
969
+
970
+ **何時略過 Alpha(僅 Beta→Stable):**
971
+ - 修補版本發布(僅錯誤修復)
972
+ - 風險較低的次要版本發布
973
+ - 緊急安全性修復
974
+
975
+ ### 互動範例
976
+
977
+ ```
978
+ User: "我想發布 beta 版本"
979
+
980
+ AI:
981
+ 我會協助你準備 beta 版本發布。
982
+
983
+ 首先,讓我執行預發布檢查:
984
+ 1. ✅ 執行測試
985
+ 2. ✅ 執行 linting
986
+ 3. ✅ 檢查 git 狀態
987
+
988
+ 請提供以下資訊:
989
+ 1. 版本號是多少?(例如:3.2.2-beta.1)
990
+ 2. 主要包含哪些變更?
991
+
992
+ 確認後,我會:
993
+ 1. 更新 cli/package.json 版本號
994
+ 2. 更新 CHANGELOG.md
995
+ 3. 建立 git tag (vX.Y.Z-beta.N)
996
+ 4. 提交並推送變更
997
+ 5. 提供建立 GitHub Release 的步驟
998
+
999
+ **重要**:建立 GitHub Release 後,GitHub Actions 會自動:
1000
+ - 偵測版本類型(beta)
1001
+ - 發布到 npm 並標記為 @beta
1002
+ - 無需手動執行 npm publish
1003
+ ```
1004
+
1005
+ ---
198
1006
 
199
1007
  ## 檔案結構參考
200
1008
 
201
1009
  ```
202
1010
  universal-dev-standards/
203
- ├── core/ # 核心規範(49 個檔案)
204
- ├── skills/ # AI 工具技能
205
- │ └── claude-code/ # Claude Code 技能(26 個技能)
206
- ├── cli/ # Node.js CLI 工具
207
- │ ├── src/ # 原始碼
208
- │ ├── tests/ # 測試檔案
209
- │ └── package.json # 依賴
210
- ├── locales/ # 翻譯
211
- │ └── zh-TW/ # 繁體中文
212
- ├── integrations/ # AI 工具配置
213
- ├── templates/ # 文件範本
214
- ├── adoption/ # 採用指南
215
- └── scripts/ # 維護腳本
1011
+ ├── core/ # Core standards (71 files)
1012
+ ├── skills/ # AI tool skills
1013
+ │ └── claude-code/ # Claude Code skills (26 skills)
1014
+ ├── cli/ # Node.js CLI tool
1015
+ │ ├── src/ # Source code
1016
+ │ ├── tests/ # Test files
1017
+ │ └── package.json # Dependencies
1018
+ ├── locales/ # Translations
1019
+ │ └── zh-TW/ # Traditional Chinese
1020
+ ├── integrations/ # AI tool configurations
1021
+ ├── templates/ # Document templates
1022
+ ├── adoption/ # Adoption guides
1023
+ └── scripts/ # Maintenance scripts
216
1024
  ```
217
1025
 
218
1026
  ## 貢獻
@@ -223,3 +1031,81 @@ universal-dev-standards/
223
1031
 
224
1032
  - 文件(Markdown):CC BY 4.0
225
1033
  - 程式碼(JavaScript):MIT
1034
+
1035
+
1036
+ ## Available UDS Slash Commands | UDS 可用命令
1037
+
1038
+ > Auto-generated index for SPEC-INTSYNC-001 sync compliance. The authoritative descriptions live in `skills/commands/*.md` and `skills/commands/COMMAND-INDEX.json`.
1039
+
1040
+ > 為 SPEC-INTSYNC-001 同步合規自動產生的索引。權威描述位於 `skills/commands/*.md` 與 `COMMAND-INDEX.json`。
1041
+
1042
+ ### core
1043
+
1044
+ - `/commit`
1045
+ - `/code-review`
1046
+ - `/sdd`
1047
+ - `/check`
1048
+ - `/init`
1049
+ - `/update`
1050
+ - `/config`
1051
+
1052
+ ### testing
1053
+
1054
+ - `/tdd`
1055
+ - `/bdd`
1056
+ - `/atdd`
1057
+ - `/e2e`
1058
+ - `/coverage`
1059
+ - `/ac-coverage`
1060
+ - `/derive`
1061
+ - `/derive-bdd`
1062
+ - `/derive-tdd`
1063
+ - `/derive-atdd`
1064
+ - `/derive-all`
1065
+ - `/journey-test`
1066
+
1067
+ ### quality
1068
+
1069
+ - `/checkin`
1070
+ - `/refactor`
1071
+ - `/scan`
1072
+ - `/security`
1073
+ - `/reverse`
1074
+ - `/reverse-sdd`
1075
+ - `/reverse-bdd`
1076
+ - `/reverse-tdd`
1077
+
1078
+ ### docs
1079
+
1080
+ - `/docs`
1081
+ - `/docgen`
1082
+ - `/changelog`
1083
+ - `/requirement`
1084
+ - `/brainstorm`
1085
+ - `/sdd-retro`
1086
+ - `/pr`
1087
+
1088
+ ### ops
1089
+
1090
+ - `/observability`
1091
+ - `/slo`
1092
+ - `/runbook`
1093
+ - `/incident`
1094
+ - `/metrics`
1095
+ - `/durable`
1096
+ - `/ci-cd`
1097
+
1098
+ ### methodology
1099
+
1100
+ - `/methodology`
1101
+ - `/dev-workflow`
1102
+ - `/discover`
1103
+ - `/release`
1104
+ - `/audit`
1105
+ - `/migrate`
1106
+ - `/skill-builder`
1107
+
1108
+ ### reference
1109
+
1110
+ - `/database`
1111
+ - `/api-design`