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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (688) hide show
  1. package/README.md +13 -3
  2. package/bin/uds.js +75 -3
  3. package/bundled/ai/options/code-review/pr-review.ai.yaml +20 -1
  4. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  5. package/bundled/ai/standards/ai-response-navigation.ai.yaml +43 -3
  6. package/bundled/ai/standards/checkin-standards.ai.yaml +25 -6
  7. package/bundled/ai/standards/code-review.ai.yaml +15 -2
  8. package/bundled/ai/standards/commit-message.ai.yaml +18 -4
  9. package/bundled/ai/standards/developer-memory.ai.yaml +12 -2
  10. package/bundled/ai/standards/full-coverage-testing.ai.yaml +86 -7
  11. package/bundled/ai/standards/open-work-tracking.ai.yaml +196 -11
  12. package/bundled/ai/standards/pipeline-security-gates.ai.yaml +53 -4
  13. package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
  14. package/bundled/core/ai-response-navigation.md +128 -12
  15. package/bundled/core/code-review-checklist.md +20 -2
  16. package/bundled/core/commit-message-guide.md +22 -19
  17. package/bundled/core/developer-memory.md +12 -2
  18. package/bundled/core/full-coverage-testing.md +99 -5
  19. package/bundled/core/open-work-tracking.md +157 -17
  20. package/bundled/core/pipeline-security-gates.md +63 -0
  21. package/bundled/core/project-context-memory.md +10 -2
  22. package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
  23. package/bundled/extensions/languages/csharp-style.md +464 -0
  24. package/bundled/extensions/languages/php-style.md +700 -0
  25. package/bundled/extensions/locales/zh-cn.md +717 -0
  26. package/bundled/extensions/locales/zh-tw.md +717 -0
  27. package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
  28. package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
  29. package/bundled/locales/COVERAGE.md +5 -4
  30. package/bundled/locales/zh-CN/CHANGELOG.md +199 -3
  31. package/bundled/locales/zh-CN/README.md +3 -3
  32. package/bundled/locales/zh-CN/SECURITY.md +3 -2
  33. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  34. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
  35. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  36. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
  37. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
  38. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
  39. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
  40. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  41. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  42. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  43. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  44. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  45. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  46. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  47. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  48. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  49. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  50. package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
  51. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  52. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  53. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  54. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  55. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  56. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  57. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  58. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  59. package/bundled/locales/zh-CN/core/code-review-checklist.md +54 -23
  60. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  61. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  62. package/bundled/locales/zh-CN/core/developer-memory.md +159 -60
  63. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  64. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  65. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  66. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  67. package/bundled/locales/zh-CN/core/full-coverage-testing.md +103 -9
  68. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  69. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  70. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  71. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  72. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  73. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  74. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  75. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  76. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  77. package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
  78. package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
  79. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  80. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  81. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  82. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  83. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  84. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  85. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  86. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  87. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  88. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  89. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  90. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  91. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  92. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  93. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  94. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  95. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  96. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  97. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  98. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  99. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  100. package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
  101. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +9 -3
  102. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  103. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +68 -33
  104. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +29 -15
  105. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  106. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
  107. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  108. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
  109. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  110. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  111. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +46 -0
  112. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  113. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  114. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  115. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  116. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  117. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  118. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  119. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  120. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  121. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  122. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  123. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  124. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  125. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  126. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  127. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  128. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  129. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  130. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  131. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  132. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  133. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  134. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  135. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  136. package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
  137. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  138. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  139. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  140. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  141. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  142. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  143. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  144. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  145. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  146. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  147. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  148. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  149. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  150. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  151. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  152. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  153. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  154. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  155. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  156. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  157. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  158. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  159. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  160. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  161. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  162. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  163. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  164. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  165. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  166. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  167. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  168. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  169. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  170. package/bundled/locales/zh-CN/skills/README.md +3 -1
  171. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  172. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  173. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  174. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  175. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  176. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  177. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  178. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  179. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  180. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  181. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  182. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  183. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  184. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  185. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  186. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  187. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  188. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  189. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  190. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  191. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  192. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  193. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  194. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  195. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  196. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  197. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  198. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  199. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  200. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  201. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  202. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  203. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  204. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  205. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  206. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  207. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  208. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  209. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  210. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  211. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  212. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  213. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  214. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  215. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  216. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  217. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  218. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  219. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  220. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  221. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  222. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  223. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  224. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  225. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  226. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  227. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  228. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  229. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  230. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  231. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  232. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  233. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  234. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  235. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  236. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  237. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  238. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  239. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  240. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  241. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  242. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  243. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  244. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  245. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -2
  246. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  247. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  248. package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
  249. package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
  250. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  251. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  252. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  253. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  254. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  255. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  256. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  257. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  258. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  259. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  260. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  261. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  262. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  263. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  264. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  265. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  266. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  267. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  268. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  269. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  270. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  271. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  272. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  273. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  274. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  275. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  276. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  277. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  278. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  279. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  280. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  281. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  282. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  283. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  284. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  285. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  286. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  287. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  288. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  289. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  290. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  291. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  292. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  293. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  294. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  295. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  296. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  297. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  298. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  299. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  300. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  301. package/bundled/locales/zh-TW/CHANGELOG.md +199 -3
  302. package/bundled/locales/zh-TW/README.md +3 -3
  303. package/bundled/locales/zh-TW/SECURITY.md +3 -2
  304. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  305. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
  306. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  307. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
  308. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
  309. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
  310. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
  311. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  312. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  313. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  314. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  315. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  316. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  317. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  318. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  319. package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
  320. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  321. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  322. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  323. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  324. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  325. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  326. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  327. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  328. package/bundled/locales/zh-TW/core/code-review-checklist.md +36 -7
  329. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  330. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  331. package/bundled/locales/zh-TW/core/developer-memory.md +111 -12
  332. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  333. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  334. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  335. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  336. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  337. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  338. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  339. package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
  340. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  341. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  342. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  343. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  344. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  345. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  346. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  347. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  348. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  349. package/bundled/locales/zh-TW/core/open-work-tracking.md +92 -16
  350. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  351. package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
  352. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  353. package/bundled/locales/zh-TW/core/project-context-memory.md +215 -31
  354. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  355. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  356. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  357. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  358. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  359. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  360. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  361. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  362. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  363. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  364. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  365. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  366. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  367. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  368. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  369. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  370. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  371. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  372. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  373. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  374. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  375. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  376. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  377. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  378. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  379. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  380. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  381. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  382. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  383. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  384. package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
  385. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +9 -3
  386. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  387. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +61 -26
  388. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  389. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +29 -15
  390. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  391. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
  392. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  393. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
  394. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  395. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  396. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +46 -0
  397. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  398. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  399. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  400. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  401. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  402. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  403. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  404. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  405. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  406. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  407. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  408. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  409. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  410. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  411. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  412. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  413. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  414. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  415. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  416. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  417. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  418. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  419. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  420. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  421. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  422. package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
  423. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  424. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  425. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  426. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  427. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  428. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  429. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  430. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  431. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  432. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  433. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  434. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  435. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  436. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  437. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  438. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  439. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  440. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  441. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  442. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  443. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  444. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  445. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  446. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  447. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  448. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  449. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  450. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  451. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  452. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  453. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  454. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  455. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  456. package/bundled/locales/zh-TW/skills/README.md +3 -1
  457. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  458. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  459. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  460. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  461. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  462. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  463. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  464. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  465. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  466. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  467. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  468. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  469. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  470. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  471. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  472. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  473. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  474. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  475. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  476. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  477. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  478. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  479. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  480. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  481. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  482. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  483. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  484. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  485. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  486. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  487. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  488. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  489. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  490. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  491. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  492. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  493. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  494. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  495. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  496. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  497. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  498. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  499. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  500. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  501. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  502. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  503. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  504. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  505. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  506. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  507. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  508. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  509. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  510. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  511. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  512. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  513. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  514. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  515. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  516. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  517. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  518. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  519. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  520. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  521. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  522. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  523. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  524. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  525. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  526. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  527. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  528. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  529. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  530. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  531. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  532. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  533. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  534. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  535. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  536. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  537. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  538. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  539. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  540. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  541. package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
  542. package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
  543. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  544. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  545. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  546. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  547. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  548. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  549. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  550. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  551. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  552. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  553. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  554. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  555. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  556. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  557. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  558. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  559. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  560. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  561. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  562. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  563. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  564. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  565. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  566. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  567. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  568. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  569. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  570. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  571. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  572. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  573. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  574. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  575. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  576. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  577. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  578. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  579. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  580. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  581. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  582. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  583. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  584. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  585. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  586. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  587. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  588. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  589. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  590. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  591. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  592. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  593. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  594. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  595. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  596. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  597. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  598. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  599. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  600. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  601. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  602. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  603. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  604. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  605. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  606. package/bundled/skills/README.md +1 -0
  607. package/bundled/skills/SKILL_NAMING.md +9 -0
  608. package/bundled/skills/commit-standards/SKILL.md +2 -2
  609. package/bundled/skills/commit-standards/guide.md +3 -2
  610. package/bundled/skills/commit-standards/language-options.md +19 -17
  611. package/bundled/skills/comprehension-ladder/SKILL.md +283 -0
  612. package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
  613. package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
  614. package/bundled/templates/gates/check-stubs.mjs +644 -0
  615. package/package.json +5 -3
  616. package/src/commands/audit.js +20 -2
  617. package/src/commands/check.js +155 -28
  618. package/src/commands/deps.js +31 -1
  619. package/src/commands/hitl.js +3 -0
  620. package/src/commands/init.js +159 -48
  621. package/src/commands/list.js +12 -3
  622. package/src/commands/mcp.js +2 -3
  623. package/src/commands/open-work.js +123 -0
  624. package/src/commands/quickstart.js +29 -13
  625. package/src/commands/release.js +102 -19
  626. package/src/commands/run-intent.js +10 -0
  627. package/src/commands/simulate.js +20 -8
  628. package/src/commands/skills.js +59 -33
  629. package/src/commands/spec-split.js +30 -17
  630. package/src/commands/spec.js +55 -21
  631. package/src/commands/uninstall.js +146 -32
  632. package/src/commands/update.js +471 -93
  633. package/src/core/install-records.js +192 -0
  634. package/src/core/manifest.js +12 -10
  635. package/src/core/marketplace-sentinel.js +5 -0
  636. package/src/core/open-work-config.js +122 -0
  637. package/src/core/project-config.js +92 -38
  638. package/src/flows/init-flow.js +10 -0
  639. package/src/hitl/manager.js +4 -2
  640. package/src/i18n/messages.js +413 -78
  641. package/src/installers/hooks-installer.js +236 -27
  642. package/src/installers/integration-installer.js +5 -1
  643. package/src/installers/skills-installer.js +3 -1
  644. package/src/installers/standards-installer.js +16 -23
  645. package/src/mcp/__tests__/server.test.js +0 -1
  646. package/src/mcp/server.js +16 -4
  647. package/src/prompts/init.js +148 -13
  648. package/src/reconciler/backup-locations.js +80 -0
  649. package/src/reconciler/backup-manager.js +451 -123
  650. package/src/reconciler/index.js +86 -10
  651. package/src/reconciler/install-roots.js +90 -0
  652. package/src/reconciler/plan-executor.js +37 -15
  653. package/src/uninstallers/hook-uninstaller.js +220 -33
  654. package/src/uninstallers/integration-uninstaller.js +35 -5
  655. package/src/uninstallers/skills-uninstaller.js +95 -16
  656. package/src/uninstallers/standards-uninstaller.js +56 -7
  657. package/src/utils/agents-installer.js +10 -17
  658. package/src/utils/available-standards-report.js +144 -0
  659. package/src/utils/available-standards.js +216 -0
  660. package/src/utils/command-hash-ownership.js +103 -0
  661. package/src/utils/commit-message-judge.js +155 -0
  662. package/src/utils/copier.js +80 -2
  663. package/src/utils/deps-applicability.js +25 -0
  664. package/src/utils/detector.js +46 -1
  665. package/src/utils/friction-detector.js +27 -0
  666. package/src/utils/gate-scripts.js +141 -0
  667. package/src/utils/git-hooks.js +139 -7
  668. package/src/utils/hasher.js +36 -0
  669. package/src/utils/health-scorer.js +10 -7
  670. package/src/utils/installed-names-ownership.js +114 -0
  671. package/src/utils/integration-generator.js +36 -24
  672. package/src/utils/legacy-hook-migration.js +112 -0
  673. package/src/utils/locale.js +19 -0
  674. package/src/utils/open-work-tracking.mjs +1754 -0
  675. package/src/utils/prompt-closed.js +18 -0
  676. package/src/utils/sdd-header.js +66 -0
  677. package/src/utils/skill-frontmatter.js +102 -0
  678. package/src/utils/skill-hash-ownership.js +64 -0
  679. package/src/utils/skill-name-collision.js +169 -0
  680. package/src/utils/skills-install-paths.js +114 -0
  681. package/src/utils/skills-installer.js +75 -106
  682. package/src/utils/standard-validator.js +98 -27
  683. package/src/utils/test-change-check.js +160 -0
  684. package/src/utils/test-policy.js +214 -0
  685. package/src/utils/transient-fs.js +113 -0
  686. package/src/utils/update-summary.js +29 -0
  687. package/src/vibe/micro-spec.js +15 -0
  688. package/standards-registry.json +48 -9
@@ -2,11 +2,12 @@
2
2
  source: ../../../../skills/commands/reverse-tdd.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-03-19
5
+ last_synced: 2026-10-12
6
+ source_hash: 63db65495ddc
6
7
  ---
7
8
 
8
9
  ---
9
- description: [UDS] Analyze BDD-TDD coverage gaps
10
+ description: [UDS] 分析 BDD-TDD 覆蓋差距
10
11
  allowed-tools: Read, Grep, Glob, Write
11
12
  argument-hint: "[feature file or test directory | Feature 檔案或測試目錄]"
12
13
  ---
@@ -52,6 +53,46 @@ argument-hint: "[feature file or test directory | Feature 檔案或測試目錄]
52
53
  | `/reverse-tdd features/` | 分析所有 feature 檔案 |
53
54
  | `/reverse-tdd features/auth.feature` | 分析特定 feature |
54
55
 
56
+ ## AI 代理行為
57
+
58
+ > 遵循 [AI 命令行為標準](../../core/ai-command-behavior.md)
59
+
60
+ ### 進入路由
61
+
62
+ | 輸入 | AI 動作 |
63
+ |------|---------|
64
+ | `/reverse-tdd` | 詢問要分析的 feature 檔案或測試目錄 |
65
+ | `/reverse-tdd <path>` | 直接分析指定路徑 |
66
+
67
+ ### 互動腳本
68
+
69
+ 1. 解析 `.feature` 檔案中的所有場景
70
+ 2. 掃描測試目錄尋找對應的單元測試
71
+ 3. 建立 BDD 場景 → TDD 測試的對應關係
72
+ 4. 識別覆蓋差距(有場景無對應測試)
73
+ 5. 產生差距報告
74
+
75
+ **決策:差距嚴重度**
76
+ - IF 覆蓋率 ≥ 80% → 標記為 ✅ Good,列出剩餘差距
77
+ - IF 覆蓋率 50-79% → 標記為 ⚠️ Needs Improvement,建議優先補測試的場景
78
+ - IF 覆蓋率 < 50% → 標記為 ❌ Critical,建議系統性補強
79
+
80
+ 🛑 **STOP**: 展示差距報告後等待使用者決定下一步
81
+
82
+ ### 停止點
83
+
84
+ | 停止點 | 等待內容 |
85
+ |--------|---------|
86
+ | 差距報告展示後 | 使用者決定是否要 AI 協助補測試 |
87
+
88
+ ### 錯誤處理
89
+
90
+ | 錯誤條件 | AI 動作 |
91
+ |----------|---------|
92
+ | 無 `.feature` 檔案 | 引導到 `/derive-bdd` 或 `/reverse-bdd` 先產生 |
93
+ | 測試目錄為空 | 報告 0% 覆蓋率,建議從 `/derive-tdd` 產生骨架 |
94
+ | 場景與測試命名不一致無法自動對應 | 列出無法對應的項目,詢問使用者手動確認 |
95
+
55
96
  ## 參考
56
97
 
57
98
  - 上層指令:[/reverse](../reverse-engineer/SKILL.md)
@@ -2,12 +2,13 @@
2
2
  source: ../../../../skills/commands/reverse.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-03-19
5
+ last_synced: 2026-10-12
6
+ source_hash: 32adc0c367f3
6
7
  ---
7
8
 
8
9
  ---
9
10
  name: reverse
10
- description: [UDS] Reverse engineer code to Specs, BDD, or TDD coverage.
11
+ description: [UDS] 將程式碼反向工程為規格、BDD 或 TDD 覆蓋分析。
11
12
  argument-hint: "[spec|bdd|tdd] <input> [--output <file>]"
12
13
  ---
13
14
 
@@ -64,6 +65,47 @@ argument-hint: "[spec|bdd|tdd] <input> [--output <file>]"
64
65
  * **確定性標記**:在輸出中使用 `[Confirmed]`、`[Inferred]`、`[Unknown]` 標記。
65
66
  * **來源標註**:為所有反向推導的邏輯標註 `file:line`。
66
67
 
68
+ ## AI Agent Behavior | AI 代理行為
69
+
70
+ > 遵循 [AI Command Behavior Standards](../../core/ai-command-behavior.md)
71
+
72
+ ### Entry Router | 進入路由
73
+
74
+ | 輸入 | AI 動作 |
75
+ |------|---------|
76
+ | `/reverse` | 詢問使用者要執行哪個子命令(spec/bdd/tdd)和目標 |
77
+ | `/reverse <subcommand> <input>` | 直接對指定目標執行指定子命令 |
78
+ | `/reverse <subcommand>` | 執行子命令,詢問目標檔案/目錄 |
79
+
80
+ ### Interaction Script | 互動腳本
81
+
82
+ 1. 確認子命令和輸入目標
83
+ 2. 分派到對應的 `/reverse-sdd`、`/reverse-bdd`、`/reverse-tdd`
84
+ 3. 收集子命令結果
85
+ 4. 展示結果摘要
86
+
87
+ **決策:子命令選擇**
88
+ - IF `spec` → 分派到 `/reverse-sdd`
89
+ - IF `bdd` → 分派到 `/reverse-bdd`
90
+ - IF `tdd` → 分派到 `/reverse-tdd`
91
+ - IF 未指定 → 問使用者選擇
92
+
93
+ 🛑 **STOP**: 結果展示後等待使用者確認
94
+
95
+ ### Stop Points | 停止點
96
+
97
+ | 停止點 | 等待內容 |
98
+ |--------|---------|
99
+ | 反向工程結果展示後 | 確認結果正確並寫入 |
100
+
101
+ ### Error Handling | 錯誤處理
102
+
103
+ | 錯誤條件 | AI 動作 |
104
+ |----------|---------|
105
+ | 目標檔案/目錄不存在 | 告知並詢問正確路徑 |
106
+ | 子命令無效 | 列出可用子命令(spec/bdd/tdd) |
107
+ | 目標為空目錄或空檔案 | 告知無內容可分析 |
108
+
67
109
  ## 參考
68
110
 
69
111
  * [反向工程技能](../reverse-engineer/SKILL.md)
@@ -2,7 +2,8 @@
2
2
  source: ../../../../skills/commands/runbook.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-04-10
5
+ last_synced: 2026-10-12
6
+ source_hash: 204f37312d01
6
7
  status: current
7
8
  description: "[UDS] 引導 Runbook 建立、維護、演練和覆蓋率報告"
8
9
  ---
@@ -10,9 +11,53 @@ description: "[UDS] 引導 Runbook 建立、維護、演練和覆蓋率報告"
10
11
  ---
11
12
  description: "[UDS] 引導 Runbook 建立、維護、演練和覆蓋率報告"
12
13
  allowed-tools: Read, Write, Grep, Glob
13
- argument-hint: "[create | drill | coverage] [告警名稱]"
14
+ argument-hint: "[create | drill | coverage] [alert name | 告警名稱]"
14
15
  ---
15
16
 
16
17
  # Runbook 助手
17
18
 
18
19
  詳見 [SKILL.md](../runbook-assistant/SKILL.md)。
20
+
21
+ ## AI Agent Behavior | AI 代理行為
22
+
23
+ > 遵循 [AI Command Behavior Standards](../../core/ai-command-behavior.md)
24
+
25
+ ### Entry Router | 進入路由
26
+
27
+ | 輸入 | AI 動作 |
28
+ |------|---------|
29
+ | `/runbook` | 詢問目標告警或服務,進入 runbook 導覽選單 |
30
+ | `/runbook create` | 啟動 runbook 建立流程 |
31
+ | `/runbook create <alert>` | 針對指定告警直接建立 runbook |
32
+ | `/runbook drill` | 啟動 runbook 演練模擬流程 |
33
+ | `/runbook coverage` | 產生 runbook 覆蓋率報告 |
34
+
35
+ ### Interaction Script | 互動腳本
36
+
37
+ 1. 確認操作模式(建立 / 演練 / 覆蓋率)
38
+ 2. 依模式執行對應流程,收集必要資訊
39
+ 3. 輸出 runbook 草稿或報告
40
+
41
+ **決策:建立模式**
42
+ - IF 告警名稱已提供 → 直接填入模板並產生草稿
43
+ - IF 告警名稱未提供 → 詢問告警名稱、嚴重程度、負責團隊
44
+
45
+ **決策:演練模式**
46
+ - 逐步模擬告警觸發情境,確認執行步驟可行性
47
+ - IF 步驟有疑義 → 停止並請使用者確認或修正
48
+
49
+ 🛑 **STOP**: runbook 草稿產生後等待使用者審查與修正
50
+
51
+ ### Stop Points | 停止點
52
+
53
+ | 停止點 | 等待內容 |
54
+ |--------|---------|
55
+ | 草稿產生後 | 使用者審查並確認內容正確 |
56
+ | 演練每個關鍵步驟後 | 使用者確認步驟可執行 |
57
+
58
+ ### Error Handling | 錯誤處理
59
+
60
+ | 錯誤條件 | AI 動作 |
61
+ |----------|---------|
62
+ | 告警名稱不明確 | 請使用者提供告警名稱或描述觸發條件 |
63
+ | 無現有 runbook 可演練 | 提示先執行 `create` 建立 runbook |
@@ -2,12 +2,13 @@
2
2
  source: ../../../../skills/commands/scan.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-03-25
5
+ last_synced: 2026-10-12
6
+ source_hash: 31b6b2d2d6c9
6
7
  status: current
7
8
  ---
8
9
 
9
10
  ---
10
- description: "[UDS] Guide automated security scanning, dependency auditing and secret detection"
11
+ description: "[UDS] 引導自動化安全掃描、相依套件審計和機密偵測"
11
12
  allowed-tools: Read, Grep, Glob, Bash(npm:audit, npx:*)
12
13
  argument-hint: "[scan type or target | 掃描類型或目標]"
13
14
  ---
@@ -2,11 +2,12 @@
2
2
  source: ../../../../skills/commands/sdd-retro.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-03-19
5
+ last_synced: 2026-10-12
6
+ source_hash: 34792a9bf741
6
7
  ---
7
8
 
8
9
  ---
9
- description: [UDS] Create retroactive specs for untracked feat/fix commits
10
+ description: [UDS] 為未追蹤的 feat/fix commits 建立追溯規格
10
11
  allowed-tools: Read, Write, Grep, Glob, Bash(git log:*), Bash(git show:*), Bash(git diff:*), Bash(mkdir:*)
11
12
  argument-hint: "[--since=<date> | --last=<N> | 自動掃描]"
12
13
  ---
@@ -40,8 +41,56 @@ argument-hint: "[--since=<date> | --last=<N> | 自動掃描]"
40
41
  /sdd-retro --last=10
41
42
  ```
42
43
 
44
+ ## AI Agent Behavior | AI 代理行為
45
+
46
+ > 遵循 [AI Command Behavior Standards](../../core/ai-command-behavior.md)
47
+
48
+ ### Entry Router | 進入路由
49
+
50
+ | 輸入 | AI 動作 |
51
+ |------|---------|
52
+ | `/sdd-retro` | 掃描所有 feat/fix commits(無 `Refs:` footer),顯示摘要 |
53
+ | `/sdd-retro --since=<date>` | 僅掃描指定日期後的 commits |
54
+ | `/sdd-retro --last=<N>` | 僅掃描最近 N 筆 commits |
55
+
56
+ ### Interaction Script | 互動腳本
57
+
58
+ 1. 執行 `git log` 掃描符合條件的 commits
59
+ 2. 過濾已有 `Refs: SPEC-` 的 commits
60
+ 3. 依 scope 分群相關 commits
61
+
62
+ **決策:掃描結果**
63
+ - IF 無未追蹤的 commits → 告知使用者「所有 feat/fix commits 都已追蹤」,結束
64
+ - IF 有未追蹤的 commits → 顯示分群清單,問使用者要為哪些群組建立 retro spec
65
+ - ELSE → 顯示清單供選擇
66
+
67
+ 🛑 **STOP**: 掃描結果展示後等待使用者選擇要追蹤的群組
68
+
69
+ 4. 為使用者選定的群組生成 retro spec(使用 SDD 格式,status: Archived)
70
+ 5. 展示生成的 spec 內容
71
+
72
+ 🛑 **STOP**: 展示 spec 內容後等待使用者確認寫入檔案
73
+
74
+ 6. 寫入 `docs/specs/` 並建議更新原 commits 的 footer(如有需要)
75
+
76
+ ### Stop Points | 停止點
77
+
78
+ | 停止點 | 等待內容 |
79
+ |--------|---------|
80
+ | 掃描結果展示後 | 使用者選擇要追蹤哪些群組 |
81
+ | Spec 內容生成後 | 確認寫入檔案 |
82
+
83
+ ### Error Handling | 錯誤處理
84
+
85
+ | 錯誤條件 | AI 動作 |
86
+ |----------|---------|
87
+ | 不在 git 儲存庫中 | 告知使用者需要在 git 儲存庫中執行 |
88
+ | git log 無結果 | 告知無符合條件的 commits |
89
+ | `docs/specs/` 目錄不存在 | 自動建立目錄 |
90
+ | commit message 格式不符合 Conventional Commits | 標記為 `[Unknown]` scope,仍嘗試分析 |
91
+
43
92
  ## 參考
44
93
 
45
94
  - SDD 工作流程:[sdd 指令](sdd.md)
46
95
  - Commit 規範:[commit 指令](commit.md)
47
- - 規格:[SPEC-011](../../docs/specs/cli/shared/SPEC-011-retroactive-spec-tracking.md)
96
+ - 規格:[SPEC-011](../../../../docs/specs/cli/shared/SPEC-011-retroactive-spec-tracking.md)
@@ -2,11 +2,12 @@
2
2
  source: ../../../../skills/commands/sdd.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-03-19
5
+ last_synced: 2026-10-12
6
+ source_hash: 3e985d7d90bd
6
7
  ---
7
8
 
8
9
  ---
9
- description: [UDS] Create or review specification documents for Spec-Driven Development
10
+ description: [UDS] 建立或審查規格驅動開發的規格文件
10
11
  allowed-tools: Read, Write, Grep, Glob, Bash(git:*), Bash(npm test:*)
11
12
  argument-hint: "[create|review|approve|implement|verify] [spec name or file | 規格名稱或檔案]"
12
13
  ---
@@ -61,6 +62,186 @@ grep -E "^- \[(x|X)\]" docs/specs/SPEC-XXX.md
61
62
 
62
63
  ---
63
64
 
65
+ ## AI 代理行為
66
+
67
+ > 遵循 [AI Command Behavior Standards](../../core/ai-command-behavior.md)
68
+
69
+ ### 進入路由
70
+
71
+ | 輸入 | AI 動作 | AI 行為 |
72
+ |------|---------|---------|
73
+ | `/sdd` | 1. 檢查 `docs/specs/` 是否有進行中的 spec 2. **有進行中的 spec** → 顯示狀態摘要,問使用者要繼續哪個還是新建 3. **無進行中的 spec** → 問使用者想做什麼功能,進入 discuss | 檢查進行中的規格;顯示狀態或開始 discuss |
74
+ | `/sdd <feature-name>` | 進入 **discuss** 階段(以 feature-name 為主題) | 針對該功能進入 discuss 階段 |
75
+ | `/sdd <phase>` | 進入指定 phase,執行 Pre-Flight Check。無指定 spec 時,列出該 phase 可操作的 spec 清單 | 進入指定階段,列出符合條件的規格 |
76
+ | `/sdd <phase> <spec-file>` | 進入指定 phase,對指定 spec 執行 Pre-Flight Check 後開始 | 針對指定規格進入該階段 |
77
+ | `/sdd --evaluate` | 僅執行 Scope Evaluation(Phase 0),輸出範圍評估結果 | 僅執行範圍評估 |
78
+ | `/sdd --sync-check` | 僅執行同步檢查,輸出同步狀態 | 僅執行同步檢查 |
79
+
80
+ ### 互動腳本
81
+
82
+ #### 階段 0.5:Discuss
83
+
84
+ 1. 讀取相關程式碼和文件,建立對現狀的理解
85
+ 2. 列出識別到的灰色地帶(ambiguities),以編號問題呈現
86
+ 3. 逐一與使用者討論,收斂答案
87
+ 4. 鎖定範圍(In Scope / Out of Scope / Deferred)
88
+
89
+ **決策:灰色地帶解決程度**
90
+ - IF 所有問題都有明確答案 → 輸出 scope summary,建議進入 create
91
+ - IF 仍有未解問題 → 列出剩餘問題,問使用者是否接受風險繼續
92
+ - IF 使用者說「先這樣」 → 記錄未解問題為 `[OPEN]`,允許進入 create
93
+
94
+ **產出格式:**
95
+ ```markdown
96
+ ### Discuss Summary
97
+ **Feature**: [name]
98
+ **In Scope**: [list]
99
+ **Out of Scope**: [list]
100
+ **Deferred**: [list]
101
+ **Open Questions**: [list or "None"]
102
+ **read_first**: [file list]
103
+ ```
104
+
105
+ 🛑 **STOP**: 顯示 Discuss Summary 後等待使用者確認進入 create
106
+
107
+ #### 階段 1:Create
108
+
109
+ 1. 基於 discuss 結論和 read_first 檔案,撰寫完整 spec
110
+ 2. 使用 Spec Document Structure 模板
111
+ 3. 所有 AC 使用 Given/When/Then 格式
112
+ 4. 為 spec 指定 ID(查看 `docs/specs/` 目錄決定下一個編號)
113
+ 5. 撰寫 Test Plan
114
+ 6. 填寫 Assumptions & Open Questions(必填),使用 `[Assumption]`/`[Need Confirmation]` 標籤
115
+ 7. IF spec 有 >3 ACs → 建議建立 `.ac.yaml` sidecar(參考 `specs/schemas/acceptance-criteria.schema.yaml`)
116
+ 8. IF spec 定義 API/data flow → 建議填寫 I/O Contract 章節
117
+ 9. IF spec 涉及 AI Agent 行為 → 填寫 AI Agent Behavior 章節
118
+
119
+ **決策:Spec 放置位置**
120
+ - IF 是 CLI 相關 → `docs/specs/cli/`
121
+ - IF 是 Core Standard 相關 → `docs/specs/standards/`
122
+ - IF 是 Skill 相關 → `docs/specs/skills/`
123
+ - IF 是架構相關 → `docs/specs/architecture/`
124
+ - IF 是跨元件 → `docs/specs/system/`
125
+ - ELSE → `docs/specs/`
126
+
127
+ 🛑 **STOP**: 撰寫完 spec 後展示內容,等待使用者確認再寫入檔案
128
+
129
+ #### 階段 2:Review
130
+
131
+ 1. 讀取指定 spec 檔案
132
+ 2. 逐項檢查以下維度:
133
+
134
+ | 檢查維度 | 檢查內容 |
135
+ |----------|---------|
136
+ | Requirements 完整性 | 所有 REQ 都有 Scenario |
137
+ | AC 可測試性 | 每個 AC 都是 Given/When/Then 格式 |
138
+ | AC 覆蓋率 | 每個 REQ 至少有一個 AC 對應 |
139
+ | Technical Design 可行性 | 設計不依賴不存在的 API/工具 |
140
+ | Test Plan 對應 | Test Plan 涵蓋所有 AC |
141
+ | 範圍一致性 | 沒有超出 discuss 鎖定的範圍 |
142
+ | 無歧義 | 沒有模糊用語(「等等」「適當地」) |
143
+ | 假設標記完整性 | 所有假設都有 `[Assumption]` 標籤和驗證方式 |
144
+ | 待釐清追蹤 | 所有 `[Need Confirmation]` 項目有負責人和期限 |
145
+
146
+ 3. 輸出 Review 結果表格
147
+ 4. 更新 spec status 為 `Review`
148
+
149
+ **決策:Review 結果**
150
+ - IF 全部通過 → 建議進入 approve
151
+ - IF 有 blocking issue → 列出問題,建議修改後重新 review
152
+ - IF 只有 suggestion → 列出建議,使用者可選擇修改或直接 approve
153
+
154
+ 🛑 **STOP**: 顯示 review 結果後等待使用者決定
155
+
156
+ #### 階段 3:Approve
157
+
158
+ 1. 讀取 spec,確認 status = `Review`
159
+ 2. 逐項展示 Approval Checklist(5 項),標記通過/未通過
160
+ 3. 等待使用者確認核准
161
+
162
+ **決策:Approval 結果**
163
+ - IF 使用者確認核准 → 更新 spec metadata(status, approved-date, approved-by)
164
+ - IF 使用者拒絕 → 記錄原因,建議回到 review 或 create
165
+
166
+ 🛑 **STOP**: 展示 checklist 結果後等待使用者明確說「核准」或「approved」
167
+
168
+ #### 階段 4:Implement
169
+
170
+ 1. 讀取 approved spec,列出所有 AC
171
+ 2. 產出實作計畫:每個 AC 要改哪些檔案、預估複雜度
172
+ 3. 等待使用者確認計畫
173
+
174
+ 🛑 **STOP**: 顯示實作計畫後等待使用者確認
175
+
176
+ 4. 逐 AC 實作:
177
+ a. 撰寫程式碼
178
+ b. 撰寫對應測試
179
+ c. 執行測試確認通過
180
+ d. 更新 spec 中的 AC checkbox
181
+
182
+ **決策:Commit 節奏**
183
+ - IF AC 之間相互獨立 → 每完成一個 AC 就提示可以 commit
184
+ - IF AC 之間緊耦合 → 合併完成後一起提示 commit
185
+ - 不自動執行 git commit — 僅提示使用者
186
+
187
+ **決策:測試失敗**
188
+ - IF 測試失敗 → 修復後重新測試,最多重試 3 次
189
+ - IF 3 次仍失敗 → 🛑 STOP,報告問題,等待使用者指導
190
+
191
+ 🛑 **STOP**: 每個獨立 AC 完成後暫停,展示進度,等待使用者確認繼續
192
+
193
+ #### 階段 5:Verify
194
+
195
+ 1. 讀取 spec,列出所有 AC
196
+ 2. 對每個 AC 收集證據:
197
+ - 程式碼位置(file:line)
198
+ - 測試位置(file:line)
199
+ - 測試結果(執行測試)
200
+ 3. 檢查是否有偏差(Added / Modified / Omitted)
201
+ 4. 產生 Verification Report
202
+
203
+ **決策:驗證結果**
204
+ - IF 全部 PASS → 更新 spec status 為 `Implemented`,建議歸檔
205
+ - IF 有 FAIL → 列出失敗項目,建議回到 implement 修復
206
+ - IF 迭代次數 ≥ 3 → 🛑 STOP,強制升級(review spec / rethink / escalate)
207
+
208
+ 🛑 **STOP**: 顯示 Verification Report 後等待使用者決定下一步
209
+
210
+ #### 階段 6:Archive
211
+
212
+ 1. 確認 spec status = `Implemented` 且 verify 通過
213
+ 2. 連結相關 commit/PR
214
+ 3. 更新 spec status 為 `Archived`
215
+
216
+ 🛑 **STOP**: 確認歸檔前等待使用者確認
217
+
218
+ ### 停止點總覽
219
+
220
+ | 階段 | 停止點 | 等待內容 |
221
+ |------|--------|---------|
222
+ | discuss | Discuss Summary 輸出後 | 確認進入 create |
223
+ | create | Spec 撰寫完成後 | 確認寫入檔案 |
224
+ | review | Review 結果輸出後 | 決定修改或進入 approve |
225
+ | approve | Checklist 展示後 | 明確核准 |
226
+ | implement | 實作計畫展示後 | 確認開始實作 |
227
+ | implement | 每個獨立 AC 完成後 | 確認繼續下一個 |
228
+ | verify | Verification Report 輸出後 | 決定歸檔或修復 |
229
+ | archive | 歸檔前 | 確認歸檔 |
230
+
231
+ ### 錯誤處理
232
+
233
+ | 錯誤條件 | AI 動作 | AI 行為 |
234
+ |----------|---------|---------|
235
+ | Pre-Flight Check 失敗 | 說明哪個條件未滿足,引導到正確的 phase | 說明失敗原因,引導至正確階段 |
236
+ | Spec 檔案不存在 | 列出可用的 spec 檔案,或建議 `/sdd create` | 列出可用規格或建議建立 |
237
+ | Spec status 不符合目標 phase | 顯示當前 status,說明需要先完成哪個 phase | 顯示當前狀態,說明需先完成的階段 |
238
+ | `docs/specs/` 目錄不存在 | 自動建立目錄,繼續流程 | 自動建立目錄 |
239
+ | 使用者提供的 feature name 與現有 spec 重複 | 顯示現有 spec,問使用者是要繼續還是新建 | 顯示現有規格,詢問繼續或新建 |
240
+ | 實作中測試反覆失敗(>3 次) | 停止自動修復,報告問題,等待使用者指導 | 停止自動修復,回報問題,等待指導 |
241
+ | 非預期狀態(無法判斷正確行為) | 停止並詢問使用者,不猜測 | 停止並詢問,絕不猜測 |
242
+
243
+ ---
244
+
64
245
  ## SDD 工作流程
65
246
 
66
247
  ```
@@ -229,13 +410,13 @@ sync-to:
229
410
 
230
411
  ## 規格狀態
231
412
 
232
- | 狀態 | 說明 |
233
- |------|------|
234
- | Draft | 草稿中 |
235
- | Review | 審查中 |
236
- | Approved | 已核准 |
237
- | Implemented | 已實作 |
238
- | Archived | 已歸檔 |
413
+ | 狀態 | Description | 說明 |
414
+ |------|-------------|------|
415
+ | Draft | Work in progress | 草稿中 |
416
+ | Review | Under review | 審查中 |
417
+ | Approved | Ready for implementation | 已核准 |
418
+ | Implemented | Code complete | 已實作 |
419
+ | Archived | Completed or deprecated | 已歸檔 |
239
420
 
240
421
  ## 驗收標準格式
241
422
 
@@ -298,11 +479,11 @@ Brief description of the feature.
298
479
 
299
480
  ## Input/Output Contract (Optional) / 輸入輸出合約(可選)
300
481
 
301
- ### Input Contract / 輸入合約
482
+ ### Input Contract
302
483
  | Field | Type | Required | Source | Description |
303
484
  |-------|------|----------|--------|-------------|
304
485
 
305
- ### Output Contract / 輸出合約
486
+ ### Output Contract
306
487
  | Field | Type | Guarantee | Consumer | Description |
307
488
  |-------|------|-----------|----------|-------------|
308
489
 
@@ -340,23 +521,23 @@ Brief description of the feature.
340
521
 
341
522
  ## 使用方式
342
523
 
343
- | 指令 | 用途 |
344
- |------|------|
345
- | `/sdd` | 互動式規格建立精靈 |
346
- | `/sdd discuss` | 啟動功能討論階段 |
347
- | `/sdd discuss auth-flow` | 討論特定功能 |
348
- | `/sdd auth-flow` | 為特定功能建立規格 |
349
- | `/sdd create auth-flow` | 明確指定建立階段 |
350
- | `/sdd review` | 審查現有規格 |
351
- | `/sdd review specs/SPEC-001.md` | 審查指定規格 |
352
- | `/sdd approve` | 列出待核准規格 |
353
- | `/sdd approve specs/SPEC-001.md` | 核准指定規格 |
354
- | `/sdd implement` | 列出已核准規格 |
355
- | `/sdd implement specs/SPEC-001.md` | 追蹤指定規格的實作 |
356
- | `/sdd verify` | 列出已實作規格 |
357
- | `/sdd verify specs/SPEC-001.md` | 驗證指定規格的實作 |
358
- | `/sdd --evaluate` | 僅執行範圍評估 |
359
- | `/sdd --sync-check` | 檢查同步狀態 |
524
+ | 指令 | Purpose | 用途 |
525
+ |------|---------|------|
526
+ | `/sdd` | Interactive spec creation wizard | 互動式規格建立精靈 |
527
+ | `/sdd discuss` | Start discuss phase for a feature | 啟動功能討論階段 |
528
+ | `/sdd discuss auth-flow` | Discuss specific feature | 討論特定功能 |
529
+ | `/sdd auth-flow` | Create spec for specific feature | 為特定功能建立規格 |
530
+ | `/sdd create auth-flow` | Explicit create phase | 明確指定建立階段 |
531
+ | `/sdd review` | Review existing specs | 審查現有規格 |
532
+ | `/sdd review specs/SPEC-001.md` | Review specific spec | 審查指定規格 |
533
+ | `/sdd approve` | List specs pending approval | 列出待核准規格 |
534
+ | `/sdd approve specs/SPEC-001.md` | Approve specific spec | 核准指定規格 |
535
+ | `/sdd implement` | List approved specs | 列出已核准規格 |
536
+ | `/sdd implement specs/SPEC-001.md` | Track implementation for spec | 追蹤指定規格的實作 |
537
+ | `/sdd verify` | List implemented specs | 列出已實作規格 |
538
+ | `/sdd verify specs/SPEC-001.md` | Verify implementation for spec | 驗證指定規格的實作 |
539
+ | `/sdd --evaluate` | Run scope evaluation only | 僅執行範圍評估 |
540
+ | `/sdd --sync-check` | Check sync status | 檢查同步狀態 |
360
541
 
361
542
  ## 典型 SDD 工作流程
362
543
 
@@ -2,12 +2,13 @@
2
2
  source: ../../../../skills/commands/security.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-03-25
5
+ last_synced: 2026-10-12
6
+ source_hash: 6362f4f8221b
6
7
  status: current
7
8
  ---
8
9
 
9
10
  ---
10
- description: "[UDS] Guide security review and vulnerability assessment following OWASP standards"
11
+ description: "[UDS] 引導安全審查和漏洞評估,遵循 OWASP 標準"
11
12
  allowed-tools: Read, Grep, Glob
12
13
  argument-hint: "[module or file to audit | 要審計的模組或檔案]"
13
14
  ---
@@ -2,7 +2,8 @@
2
2
  source: ../../../../skills/commands/slo.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-04-10
5
+ last_synced: 2026-10-12
6
+ source_hash: 80f530e0fbf1
6
7
  status: current
7
8
  description: "[UDS] 引導 SLI 選取、SLO 設定和 Error Budget 管理"
8
9
  ---
@@ -10,9 +11,54 @@ description: "[UDS] 引導 SLI 選取、SLO 設定和 Error Budget 管理"
10
11
  ---
11
12
  description: "[UDS] 引導 SLI 選取、SLO 設定和 Error Budget 管理"
12
13
  allowed-tools: Read, Write, Grep, Glob
13
- argument-hint: "[create | review | budget] [服務名稱]"
14
+ argument-hint: "[create | review | budget] [service name | 服務名稱]"
14
15
  ---
15
16
 
16
17
  # SLO 助手
17
18
 
18
19
  詳見 [SKILL.md](../slo-assistant/SKILL.md)。
20
+
21
+ ## AI Agent Behavior | AI 代理行為
22
+
23
+ > 遵循 [AI Command Behavior Standards](../../core/ai-command-behavior.md)
24
+
25
+ ### Entry Router | 進入路由
26
+
27
+ | 輸入 | AI 動作 |
28
+ |------|---------|
29
+ | `/slo` | 詢問目標服務,進入 SLO 設計導覽 |
30
+ | `/slo create` | 啟動新 SLO 建立流程 |
31
+ | `/slo create <service>` | 針對指定服務直接啟動 SLO 建立 |
32
+ | `/slo review` | 審查現有 SLO 設定合理性 |
33
+ | `/slo budget` | 查看 Error Budget 消耗狀況與建議 |
34
+
35
+ ### Interaction Script | 互動腳本
36
+
37
+ 1. 確認操作模式(建立 / 審查 / Error Budget)
38
+ 2. 依模式引導使用者完成 SLI 選擇、目標設定或現況分析
39
+ 3. 輸出 SLO 定義草稿或 Error Budget 報告
40
+
41
+ **決策:建立模式**
42
+ - 引導選擇 SLI 類型(Availability / Latency / Quality)
43
+ - 詢問目標值(如 99.9%)與測量區間(rolling 28d)
44
+ - IF 目標值過高(>99.99%)→ 警告工程成本,建議先設較保守目標
45
+
46
+ **決策:Error Budget 模式**
47
+ - IF budget 剩餘 < 10% → 建議暫停非必要發布
48
+ - IF budget 已燒盡 → 提示凍結發布,優先處理可靠性
49
+
50
+ 🛑 **STOP**: SLO 草稿完成後等待使用者確認目標值與告警閾值
51
+
52
+ ### Stop Points | 停止點
53
+
54
+ | 停止點 | 等待內容 |
55
+ |--------|---------|
56
+ | SLI 選擇完成後 | 使用者確認選定的可靠性指標 |
57
+ | SLO 草稿產生後 | 使用者審查目標值與告警設定 |
58
+
59
+ ### Error Handling | 錯誤處理
60
+
61
+ | 錯誤條件 | AI 動作 |
62
+ |----------|---------|
63
+ | 服務無監控資料 | 建議先導入基礎 metrics,再設定 SLO |
64
+ | 目標值格式錯誤 | 提示正確格式(如 `99.9%` 或 `0.999`) |