universal-dev-standards 5.0.0-rc.8 → 5.0.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 (355) hide show
  1. package/bin/uds.js +5 -3
  2. package/bundled/ai/standards/acceptance-criteria-traceability.ai.yaml +178 -0
  3. package/bundled/ai/standards/agent-dispatch.ai.yaml +69 -0
  4. package/bundled/ai/standards/ai-command-behavior.ai.yaml +45 -0
  5. package/bundled/ai/standards/api-design-standards.ai.yaml +192 -0
  6. package/bundled/ai/standards/branch-completion.ai.yaml +82 -0
  7. package/bundled/ai/standards/change-batching-standards.ai.yaml +195 -0
  8. package/bundled/ai/standards/database-standards.ai.yaml +220 -0
  9. package/bundled/ai/standards/error-codes.ai.yaml +37 -2
  10. package/bundled/ai/standards/git-worktree.ai.yaml +77 -0
  11. package/bundled/ai/standards/logging.ai.yaml +21 -2
  12. package/bundled/ai/standards/model-selection.ai.yaml +81 -0
  13. package/bundled/ai/standards/pipeline-integration-standards.ai.yaml +184 -0
  14. package/bundled/ai/standards/systematic-debugging.ai.yaml +73 -0
  15. package/bundled/ai/standards/verification-evidence.ai.yaml +84 -0
  16. package/bundled/ai/standards/workflow-enforcement.ai.yaml +253 -0
  17. package/bundled/core/acceptance-criteria-traceability.md +293 -0
  18. package/bundled/core/agent-dispatch.md +149 -0
  19. package/bundled/core/ai-command-behavior.md +239 -0
  20. package/bundled/core/api-design-standards.md +938 -0
  21. package/bundled/core/branch-completion.md +158 -0
  22. package/bundled/core/change-batching-standards.md +257 -0
  23. package/bundled/core/checkin-standards.md +43 -6
  24. package/bundled/core/database-standards.md +828 -0
  25. package/bundled/core/error-code-standards.md +228 -2
  26. package/bundled/core/forward-derivation-standards.md +54 -2
  27. package/bundled/core/git-worktree.md +131 -0
  28. package/bundled/core/model-selection.md +153 -0
  29. package/bundled/core/pipeline-integration-standards.md +230 -0
  30. package/bundled/core/systematic-debugging.md +156 -0
  31. package/bundled/core/testing-standards.md +49 -39
  32. package/bundled/core/verification-evidence.md +172 -0
  33. package/bundled/core/workflow-enforcement.md +132 -0
  34. package/bundled/locales/zh-CN/CLAUDE.md +2 -2
  35. package/bundled/locales/zh-CN/README.md +4 -4
  36. package/bundled/locales/zh-CN/SECURITY.md +92 -0
  37. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +301 -0
  38. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +47 -0
  39. package/bundled/locales/zh-CN/core/accessibility-standards.md +124 -0
  40. package/bundled/locales/zh-CN/core/agent-dispatch.md +113 -0
  41. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +103 -0
  42. package/bundled/locales/zh-CN/core/ai-command-behavior.md +247 -0
  43. package/bundled/locales/zh-CN/core/api-design-standards.md +946 -0
  44. package/bundled/locales/zh-CN/core/behavior-driven-development.md +48 -0
  45. package/bundled/locales/zh-CN/core/branch-completion.md +112 -0
  46. package/bundled/locales/zh-CN/core/change-batching-standards.md +265 -0
  47. package/bundled/locales/zh-CN/core/checkin-standards.md +43 -5
  48. package/bundled/locales/zh-CN/core/context-aware-loading.md +106 -0
  49. package/bundled/locales/zh-CN/core/database-standards.md +836 -0
  50. package/bundled/locales/zh-CN/core/deployment-standards.md +80 -0
  51. package/bundled/locales/zh-CN/core/error-code-standards.md +2 -2
  52. package/bundled/locales/zh-CN/core/forward-derivation-standards.md +493 -0
  53. package/bundled/locales/zh-CN/core/git-worktree.md +101 -0
  54. package/bundled/locales/zh-CN/core/model-selection.md +112 -0
  55. package/bundled/locales/zh-CN/core/performance-standards.md +104 -0
  56. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +238 -0
  57. package/bundled/locales/zh-CN/core/project-context-memory.md +124 -0
  58. package/bundled/locales/zh-CN/core/requirement-engineering.md +49 -0
  59. package/bundled/locales/zh-CN/core/security-standards.md +100 -0
  60. package/bundled/locales/zh-CN/core/systematic-debugging.md +106 -0
  61. package/bundled/locales/zh-CN/core/test-governance.md +116 -0
  62. package/bundled/locales/zh-CN/core/testing-standards.md +392 -156
  63. package/bundled/locales/zh-CN/core/verification-evidence.md +118 -0
  64. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +104 -0
  65. package/bundled/locales/zh-CN/core/workflow-enforcement.md +132 -0
  66. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +27 -1
  67. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +9 -1
  68. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +37 -9
  69. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +652 -0
  70. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +1 -1
  71. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +29 -4
  72. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +143 -72
  73. package/bundled/locales/zh-CN/skills/ac-coverage-assistant/SKILL.md +126 -0
  74. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +100 -0
  75. package/bundled/locales/zh-CN/skills/brainstorm-assistant/SKILL.md +119 -0
  76. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +82 -0
  77. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +97 -0
  78. package/bundled/locales/zh-CN/skills/commands/api-design.md +94 -0
  79. package/bundled/locales/zh-CN/skills/commands/atdd.md +163 -0
  80. package/bundled/locales/zh-CN/skills/commands/audit.md +77 -0
  81. package/bundled/locales/zh-CN/skills/commands/bdd.md +1 -1
  82. package/bundled/locales/zh-CN/skills/commands/brainstorm.md +87 -0
  83. package/bundled/locales/zh-CN/skills/commands/changelog.md +63 -0
  84. package/bundled/locales/zh-CN/skills/commands/check.md +219 -0
  85. package/bundled/locales/zh-CN/skills/commands/checkin.md +61 -0
  86. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +77 -0
  87. package/bundled/locales/zh-CN/skills/commands/commit.md +81 -0
  88. package/bundled/locales/zh-CN/skills/commands/config.md +207 -0
  89. package/bundled/locales/zh-CN/skills/commands/coverage.md +74 -0
  90. package/bundled/locales/zh-CN/skills/commands/database.md +78 -0
  91. package/bundled/locales/zh-CN/skills/commands/derive-all.md +58 -0
  92. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +54 -0
  93. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +53 -0
  94. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +54 -0
  95. package/bundled/locales/zh-CN/skills/commands/derive.md +78 -0
  96. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +119 -0
  97. package/bundled/locales/zh-CN/skills/commands/discover.md +86 -0
  98. package/bundled/locales/zh-CN/skills/commands/docgen.md +67 -0
  99. package/bundled/locales/zh-CN/skills/commands/docs.md +65 -0
  100. package/bundled/locales/zh-CN/skills/commands/durable.md +87 -0
  101. package/bundled/locales/zh-CN/skills/commands/guide.md +52 -0
  102. package/bundled/locales/zh-CN/skills/commands/incident.md +92 -0
  103. package/bundled/locales/zh-CN/skills/commands/init.md +272 -0
  104. package/bundled/locales/zh-CN/skills/commands/methodology.md +1 -1
  105. package/bundled/locales/zh-CN/skills/commands/metrics.md +73 -0
  106. package/bundled/locales/zh-CN/skills/commands/migrate.md +92 -0
  107. package/bundled/locales/zh-CN/skills/commands/pr.md +80 -0
  108. package/bundled/locales/zh-CN/skills/commands/refactor.md +1 -1
  109. package/bundled/locales/zh-CN/skills/commands/release.md +62 -0
  110. package/bundled/locales/zh-CN/skills/commands/requirement.md +54 -0
  111. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +47 -0
  112. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +51 -0
  113. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +51 -0
  114. package/bundled/locales/zh-CN/skills/commands/reverse.md +63 -0
  115. package/bundled/locales/zh-CN/skills/commands/review.md +50 -0
  116. package/bundled/locales/zh-CN/skills/commands/scan.md +76 -0
  117. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +40 -0
  118. package/bundled/locales/zh-CN/skills/commands/sdd.md +379 -0
  119. package/bundled/locales/zh-CN/skills/commands/security.md +75 -0
  120. package/bundled/locales/zh-CN/skills/commands/tdd.md +111 -0
  121. package/bundled/locales/zh-CN/skills/commands/update.md +337 -0
  122. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +1 -2
  123. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +97 -0
  124. package/bundled/locales/zh-CN/skills/dev-workflow-guide/SKILL.md +145 -0
  125. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +84 -0
  126. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +107 -0
  127. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +67 -0
  128. package/bundled/locales/zh-CN/skills/migration-assistant/SKILL.md +77 -0
  129. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +90 -0
  130. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +79 -0
  131. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +72 -0
  132. package/bundled/locales/zh-CN/skills/spec-driven-dev/SKILL.md +73 -10
  133. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +267 -122
  134. package/bundled/locales/zh-TW/CLAUDE.md +2 -2
  135. package/bundled/locales/zh-TW/README.md +4 -4
  136. package/bundled/locales/zh-TW/SECURITY.md +92 -0
  137. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +301 -0
  138. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +47 -0
  139. package/bundled/locales/zh-TW/core/accessibility-standards.md +84 -0
  140. package/bundled/locales/zh-TW/core/agent-dispatch.md +89 -0
  141. package/bundled/locales/zh-TW/core/ai-agreement-standards.md +87 -0
  142. package/bundled/locales/zh-TW/core/ai-command-behavior.md +247 -0
  143. package/bundled/locales/zh-TW/core/api-design-standards.md +946 -0
  144. package/bundled/locales/zh-TW/core/behavior-driven-development.md +63 -0
  145. package/bundled/locales/zh-TW/core/branch-completion.md +76 -0
  146. package/bundled/locales/zh-TW/core/change-batching-standards.md +265 -0
  147. package/bundled/locales/zh-TW/core/checkin-standards.md +39 -5
  148. package/bundled/locales/zh-TW/core/context-aware-loading.md +86 -0
  149. package/bundled/locales/zh-TW/core/database-standards.md +836 -0
  150. package/bundled/locales/zh-TW/core/deployment-standards.md +66 -0
  151. package/bundled/locales/zh-TW/core/error-code-standards.md +230 -4
  152. package/bundled/locales/zh-TW/core/forward-derivation-standards.md +62 -2
  153. package/bundled/locales/zh-TW/core/git-worktree.md +104 -0
  154. package/bundled/locales/zh-TW/core/model-selection.md +83 -0
  155. package/bundled/locales/zh-TW/core/performance-standards.md +84 -0
  156. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +238 -0
  157. package/bundled/locales/zh-TW/core/project-context-memory.md +79 -0
  158. package/bundled/locales/zh-TW/core/requirement-engineering.md +79 -0
  159. package/bundled/locales/zh-TW/core/security-standards.md +74 -0
  160. package/bundled/locales/zh-TW/core/systematic-debugging.md +95 -0
  161. package/bundled/locales/zh-TW/core/test-governance.md +88 -0
  162. package/bundled/locales/zh-TW/core/testing-standards.md +309 -86
  163. package/bundled/locales/zh-TW/core/verification-evidence.md +94 -0
  164. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +88 -0
  165. package/bundled/locales/zh-TW/core/workflow-enforcement.md +132 -0
  166. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +27 -1
  167. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +9 -1
  168. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +37 -9
  169. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +652 -0
  170. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +1 -1
  171. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +29 -4
  172. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +142 -71
  173. package/bundled/locales/zh-TW/skills/ac-coverage-assistant/SKILL.md +127 -0
  174. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +1 -4
  175. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +1 -4
  176. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +97 -0
  177. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +1 -4
  178. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +1 -4
  179. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +1 -4
  180. package/bundled/locales/zh-TW/skills/brainstorm-assistant/SKILL.md +1 -4
  181. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +1 -4
  182. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +1 -4
  183. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +79 -0
  184. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +1 -4
  185. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +95 -0
  186. package/bundled/locales/zh-TW/skills/commands/api-design.md +92 -0
  187. package/bundled/locales/zh-TW/skills/commands/atdd.md +167 -0
  188. package/bundled/locales/zh-TW/skills/commands/audit.md +75 -0
  189. package/bundled/locales/zh-TW/skills/commands/bdd.md +1 -1
  190. package/bundled/locales/zh-TW/skills/commands/brainstorm.md +91 -0
  191. package/bundled/locales/zh-TW/skills/commands/changelog.md +67 -0
  192. package/bundled/locales/zh-TW/skills/commands/check.md +223 -0
  193. package/bundled/locales/zh-TW/skills/commands/checkin.md +65 -0
  194. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +75 -0
  195. package/bundled/locales/zh-TW/skills/commands/commit.md +85 -0
  196. package/bundled/locales/zh-TW/skills/commands/config.md +211 -0
  197. package/bundled/locales/zh-TW/skills/commands/coverage.md +78 -0
  198. package/bundled/locales/zh-TW/skills/commands/database.md +76 -0
  199. package/bundled/locales/zh-TW/skills/commands/derive-all.md +62 -0
  200. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +58 -0
  201. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +54 -0
  202. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +55 -0
  203. package/bundled/locales/zh-TW/skills/commands/derive.md +79 -0
  204. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +120 -0
  205. package/bundled/locales/zh-TW/skills/commands/discover.md +87 -0
  206. package/bundled/locales/zh-TW/skills/commands/docgen.md +68 -0
  207. package/bundled/locales/zh-TW/skills/commands/docs.md +66 -0
  208. package/bundled/locales/zh-TW/skills/commands/durable.md +85 -0
  209. package/bundled/locales/zh-TW/skills/commands/guide.md +51 -0
  210. package/bundled/locales/zh-TW/skills/commands/incident.md +90 -0
  211. package/bundled/locales/zh-TW/skills/commands/init.md +273 -0
  212. package/bundled/locales/zh-TW/skills/commands/methodology.md +1 -1
  213. package/bundled/locales/zh-TW/skills/commands/metrics.md +71 -0
  214. package/bundled/locales/zh-TW/skills/commands/migrate.md +90 -0
  215. package/bundled/locales/zh-TW/skills/commands/pr.md +78 -0
  216. package/bundled/locales/zh-TW/skills/commands/refactor.md +1 -1
  217. package/bundled/locales/zh-TW/skills/commands/release.md +63 -0
  218. package/bundled/locales/zh-TW/skills/commands/requirement.md +61 -0
  219. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +54 -0
  220. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +58 -0
  221. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +58 -0
  222. package/bundled/locales/zh-TW/skills/commands/reverse.md +70 -0
  223. package/bundled/locales/zh-TW/skills/commands/review.md +57 -0
  224. package/bundled/locales/zh-TW/skills/commands/scan.md +74 -0
  225. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +47 -0
  226. package/bundled/locales/zh-TW/skills/commands/sdd.md +362 -0
  227. package/bundled/locales/zh-TW/skills/commands/security.md +73 -0
  228. package/bundled/locales/zh-TW/skills/commands/tdd.md +115 -0
  229. package/bundled/locales/zh-TW/skills/commands/update.md +326 -0
  230. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -6
  231. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +94 -0
  232. package/bundled/locales/zh-TW/skills/dev-workflow-guide/SKILL.md +140 -0
  233. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +1 -4
  234. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +1 -4
  235. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +81 -0
  236. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +1 -4
  237. package/bundled/locales/zh-TW/skills/forward-derivation/SKILL.md +1 -4
  238. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +1 -4
  239. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +104 -0
  240. package/bundled/locales/zh-TW/skills/logging-guide/SKILL.md +1 -4
  241. package/bundled/locales/zh-TW/skills/methodology-system/SKILL.md +1 -4
  242. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +64 -0
  243. package/bundled/locales/zh-TW/skills/migration-assistant/SKILL.md +74 -0
  244. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +87 -0
  245. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +1 -4
  246. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +1 -4
  247. package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +1 -4
  248. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +1 -4
  249. package/bundled/locales/zh-TW/skills/reverse-engineer/SKILL.md +1 -4
  250. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +76 -0
  251. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +69 -0
  252. package/bundled/locales/zh-TW/skills/spec-driven-dev/SKILL.md +74 -14
  253. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +243 -98
  254. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +1 -4
  255. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +1 -4
  256. package/bundled/locales/zh-TW/skills/testing-guide/SKILL.md +1 -5
  257. package/bundled/skills/README.md +11 -0
  258. package/bundled/skills/ac-coverage-assistant/SKILL.md +127 -0
  259. package/bundled/skills/ai-collaboration-standards/SKILL.md +10 -0
  260. package/bundled/skills/ai-friendly-architecture/SKILL.md +10 -0
  261. package/bundled/skills/ai-instruction-standards/SKILL.md +10 -0
  262. package/bundled/skills/api-design-assistant/SKILL.md +119 -0
  263. package/bundled/skills/atdd-assistant/SKILL.md +7 -0
  264. package/bundled/skills/bdd-assistant/SKILL.md +7 -0
  265. package/bundled/skills/brainstorm-assistant/SKILL.md +7 -0
  266. package/bundled/skills/checkin-assistant/SKILL.md +7 -0
  267. package/bundled/skills/ci-cd-assistant/SKILL.md +97 -0
  268. package/bundled/skills/code-review-assistant/SKILL.md +7 -0
  269. package/bundled/skills/commands/README.md +70 -0
  270. package/bundled/skills/commands/ac-coverage.md +135 -0
  271. package/bundled/skills/commands/api-design.md +86 -0
  272. package/bundled/skills/commands/atdd.md +69 -0
  273. package/bundled/skills/commands/audit.md +69 -0
  274. package/bundled/skills/commands/bdd.md +101 -0
  275. package/bundled/skills/commands/brainstorm.md +45 -0
  276. package/bundled/skills/commands/changelog.md +34 -0
  277. package/bundled/skills/commands/check.md +52 -1
  278. package/bundled/skills/commands/checkin.md +46 -0
  279. package/bundled/skills/commands/ci-cd.md +69 -0
  280. package/bundled/skills/commands/commit.md +79 -0
  281. package/bundled/skills/commands/config.md +48 -0
  282. package/bundled/skills/commands/coverage.md +53 -0
  283. package/bundled/skills/commands/database.md +70 -0
  284. package/bundled/skills/commands/derive-all.md +40 -0
  285. package/bundled/skills/commands/derive-atdd.md +33 -0
  286. package/bundled/skills/commands/derive-bdd.md +39 -0
  287. package/bundled/skills/commands/derive-tdd.md +40 -0
  288. package/bundled/skills/commands/derive.md +47 -0
  289. package/bundled/skills/commands/dev-workflow.md +104 -7
  290. package/bundled/skills/commands/discover.md +39 -0
  291. package/bundled/skills/commands/docgen.md +35 -0
  292. package/bundled/skills/commands/docs.md +40 -0
  293. package/bundled/skills/commands/durable.md +79 -0
  294. package/bundled/skills/commands/incident.md +84 -0
  295. package/bundled/skills/commands/init.md +55 -0
  296. package/bundled/skills/commands/methodology.md +72 -0
  297. package/bundled/skills/commands/metrics.md +65 -0
  298. package/bundled/skills/commands/migrate.md +84 -0
  299. package/bundled/skills/commands/pr.md +72 -0
  300. package/bundled/skills/commands/refactor.md +51 -0
  301. package/bundled/skills/commands/release.md +60 -0
  302. package/bundled/skills/commands/requirement.md +38 -0
  303. package/bundled/skills/commands/reverse-bdd.md +34 -0
  304. package/bundled/skills/commands/reverse-sdd.md +42 -0
  305. package/bundled/skills/commands/reverse-tdd.md +40 -0
  306. package/bundled/skills/commands/reverse.md +41 -0
  307. package/bundled/skills/commands/review.md +39 -0
  308. package/bundled/skills/commands/scan.md +68 -0
  309. package/bundled/skills/commands/sdd-retro.md +48 -0
  310. package/bundled/skills/commands/sdd.md +220 -0
  311. package/bundled/skills/commands/security.md +67 -0
  312. package/bundled/skills/commands/tdd.md +101 -0
  313. package/bundled/skills/commands/update.md +61 -0
  314. package/bundled/skills/commit-standards/SKILL.md +8 -2
  315. package/bundled/skills/database-assistant/SKILL.md +118 -0
  316. package/bundled/skills/dev-workflow-guide/SKILL.md +53 -7
  317. package/bundled/skills/dev-workflow-guide/workflow-phases.md +24 -0
  318. package/bundled/skills/durable-execution-assistant/SKILL.md +116 -0
  319. package/bundled/skills/forward-derivation/SKILL.md +7 -0
  320. package/bundled/skills/incident-response-assistant/SKILL.md +132 -0
  321. package/bundled/skills/methodology-system/SKILL.md +24 -2
  322. package/bundled/skills/metrics-dashboard-assistant/SKILL.md +109 -0
  323. package/bundled/skills/migration-assistant/SKILL.md +119 -0
  324. package/bundled/skills/pr-automation-assistant/SKILL.md +114 -0
  325. package/bundled/skills/project-discovery/SKILL.md +7 -0
  326. package/bundled/skills/refactoring-assistant/SKILL.md +7 -0
  327. package/bundled/skills/release-standards/SKILL.md +7 -0
  328. package/bundled/skills/requirement-assistant/SKILL.md +7 -0
  329. package/bundled/skills/reverse-engineer/SKILL.md +7 -0
  330. package/bundled/skills/security-assistant/SKILL.md +105 -0
  331. package/bundled/skills/security-scan-assistant/SKILL.md +96 -0
  332. package/bundled/skills/spec-driven-dev/SKILL.md +84 -4
  333. package/bundled/skills/spec-driven-dev/guide.md +156 -22
  334. package/bundled/skills/tdd-assistant/SKILL.md +7 -0
  335. package/bundled/skills/test-coverage-assistant/SKILL.md +11 -0
  336. package/bundled/skills/testing-guide/SKILL.md +23 -0
  337. package/package.json +1 -1
  338. package/src/commands/check.js +154 -8
  339. package/src/commands/config.js +231 -104
  340. package/src/commands/init.js +23 -3
  341. package/src/commands/update.js +250 -25
  342. package/src/config/ai-agent-paths.js +16 -0
  343. package/src/config/workflow-definitions.js +184 -0
  344. package/src/core/constants.js +6 -0
  345. package/src/flows/init-flow.js +23 -6
  346. package/src/i18n/messages.js +51 -3
  347. package/src/installers/integration-installer.js +67 -2
  348. package/src/installers/manifest-installer.js +1 -0
  349. package/src/installers/standards-installer.js +3 -2
  350. package/src/prompts/init.js +50 -3
  351. package/src/reconciler/manifest-migrator.js +2 -2
  352. package/src/reconciler/plan-executor.js +11 -0
  353. package/src/utils/integration-generator.js +327 -14
  354. package/src/utils/workflow-gate.js +292 -0
  355. package/standards-registry.json +160 -5
@@ -0,0 +1,118 @@
1
+ ---
2
+ source: ../../../core/verification-evidence.md
3
+ source_version: 1.0.0
4
+ translation_version: 1.0.0
5
+ last_synced: 2026-03-24
6
+ status: current
7
+ ---
8
+
9
+ > **语言**: [English](../../../core/verification-evidence.md) | 简体中文
10
+
11
+ # 验证证据标准
12
+
13
+ **版本**: 1.0.0
14
+ **最后更新**: 2026-03-20
15
+ **适用范围**: 所有 AI 辅助开发工作流
16
+ **范围**: universal
17
+ **灵感来源**: [Superpowers](https://github.com/obra/superpowers) — verification-before-completion (MIT)
18
+
19
+ ---
20
+
21
+ ## 目的
22
+
23
+ 建立"铁律":无验证证据不可声称完成。防止 AI 代理虚构成功结果,确保每个完成声明都有可执行的证据支持。
24
+
25
+ ---
26
+
27
+ ## 术语表
28
+
29
+ | 术语 | 定义 |
30
+ |------|------|
31
+ | 验证证据 | 验证命令执行及其结果的结构化记录 |
32
+ | 铁律 | 绝对规则:无证据 = 不可声称完成 |
33
+ | RED-GREEN 循环 | 通过显示测试修复前失败、修复后通过来证明 Bug 修复 |
34
+ | 退出码 | 命令的数字返回值(0 = 成功,非零 = 失败) |
35
+
36
+ ---
37
+
38
+ ## 铁律
39
+
40
+ > **无验证证据 = 不可声称完成。**
41
+
42
+ 代理声称"已完成"不是证据。验证必须是可独立执行且产生可观察输出的。
43
+
44
+ ---
45
+
46
+ ## 证据格式
47
+
48
+ 每次验证必须产生结构化的证据记录:
49
+
50
+ ```json
51
+ {
52
+ "command": "pnpm test -- --filter core",
53
+ "exit_code": 0,
54
+ "output": "Tests: 47 passed, 0 failed\nDuration: 3.2s",
55
+ "timestamp": "2026-03-20T14:30:00Z"
56
+ }
57
+ ```
58
+
59
+ ### 必需字段
60
+
61
+ | 字段 | 类型 | 必需 | 描述 |
62
+ |------|------|------|------|
63
+ | `command` | string | 是 | 执行的确切命令 |
64
+ | `exit_code` | number | 是 | 命令的退出码 |
65
+ | `output` | string | 是 | 命令输出(可截断) |
66
+ | `timestamp` | string | 是 | ISO 8601 时间戳 |
67
+
68
+ ---
69
+
70
+ ## 验证类型
71
+
72
+ | 类型 | 描述 | 命令示例 |
73
+ |------|------|---------|
74
+ | **测试套件** | 运行项目测试套件 | `pnpm test` |
75
+ | **类型检查** | 验证类型正确性 | `pnpm tsc --noEmit` |
76
+ | **Lint** | 检查代码风格 | `pnpm lint` |
77
+ | **构建** | 验证构建成功 | `pnpm build` |
78
+ | **手动验证** | 运行特定验证脚本 | `curl http://localhost:3000/health` |
79
+
80
+ ---
81
+
82
+ ## RED-GREEN 循环(Bug 修复)
83
+
84
+ 修复 Bug 时,必须展示两个证据:
85
+
86
+ 1. **RED**:修复前测试失败
87
+ 2. **GREEN**:修复后测试通过
88
+
89
+ ```json
90
+ [
91
+ {
92
+ "phase": "RED",
93
+ "command": "pnpm test -- auth.test.ts",
94
+ "exit_code": 1,
95
+ "output": "FAIL: expected 200, received 401"
96
+ },
97
+ {
98
+ "phase": "GREEN",
99
+ "command": "pnpm test -- auth.test.ts",
100
+ "exit_code": 0,
101
+ "output": "PASS: all 3 tests passed"
102
+ }
103
+ ]
104
+ ```
105
+
106
+ ---
107
+
108
+ ## 相关标准
109
+
110
+ - [系统化调试](systematic-debugging.md)
111
+ - [测试治理](test-governance.md)
112
+ - [测试标准](testing-standards.md)
113
+
114
+ ---
115
+
116
+ ## 许可证
117
+
118
+ 本标准采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 发布。
@@ -0,0 +1,104 @@
1
+ ---
2
+ source: ../../../core/virtual-organization-standards.md
3
+ source_version: 1.0.0
4
+ translation_version: 1.0.0
5
+ last_synced: 2026-03-24
6
+ status: current
7
+ ---
8
+
9
+ > **语言**: [English](../../../core/virtual-organization-standards.md) | 简体中文
10
+
11
+ # 虚拟组织标准
12
+
13
+ **版本**: 1.0.0
14
+ **最后更新**: 2026-01-29
15
+ **适用范围**: 项目设置和 AI 工具配置
16
+ **范围**: universal
17
+ **行业标准**: ISO 12207 §6.2
18
+ **参考**: [iso.org](https://www.iso.org/standard/63712.html)
19
+ **ISO 12207 映射**: 组织项目赋能过程(6.2)
20
+
21
+ ---
22
+
23
+ ## 目的
24
+
25
+ 本标准将 AI 生态系统视为"虚拟组织"。它定义如何将 AI 能力(技能)、基础设施和品质保证作为组织资产来管理,确保"虚拟劳动力"是有能力且合规的。
26
+
27
+ ---
28
+
29
+ ## 1. 虚拟劳动力管理(人力资源)
30
+
31
+ 在 Vibe Coding 中,"人力资源管理"转化为管理 AI 代理的能力。
32
+
33
+ ### 1.1 技能管理
34
+
35
+ 技能是虚拟员工的"资质"。
36
+
37
+ - **获取**: 技能必须明确安装(如通过 `skills/` 目录或插件)
38
+ - **胜任力**: 技能必须在特定项目上下文中验证
39
+ - **角色定义**: 代理应被分配"角色"(技能集合),而非通用的
40
+
41
+ | 角色 | 推荐技能集 |
42
+ |------|-----------|
43
+ | **架构师代理** | `system-design`、`diagram-generation`、`codebase-analysis` |
44
+ | **测试代理** | `test-runner`、`coverage-analyzer`、`mock-generator` |
45
+ | **重构代理** | `static-analysis`、`code-metrics`、`refactoring-patterns` |
46
+
47
+ ### 1.2 入职(上下文加载)
48
+
49
+ "入职"AI 代理意味着加载正确的上下文和配置。
50
+
51
+ - **项目引导**: 加载 `README.md`、架构文档和标准
52
+ - **规则对齐**: 加载 `core/ai-agreement-standards.md`
53
+
54
+ ---
55
+
56
+ ## 2. 基础设施管理(工具)
57
+
58
+ ### 2.1 工具集成
59
+
60
+ AI 代理的"办公环境"包括:
61
+
62
+ - **MCP 服务器**: 通过 Model Context Protocol 标准化集成
63
+ - **API 访问**: 密钥和端点的安全管理
64
+ - **沙箱**: 代码执行的隔离环境(防止系统损坏)
65
+
66
+ ### 2.2 知识库
67
+
68
+ AI 代理的"企业图书馆":
69
+
70
+ - **向量数据库**: 用于大规模文档检索
71
+ - **代码片段库**: 可复用的代码模式和模板
72
+
73
+ ---
74
+
75
+ ## 3. 品质管理系统(QMS)
76
+
77
+ ### 3.1 品质策略
78
+
79
+ | 方面 | 实施方式 |
80
+ |------|---------|
81
+ | **代码品质** | 自动化 linting、类型检查、代码审查 |
82
+ | **测试品质** | 测试覆盖率门槛、测试金字塔比例 |
83
+ | **文档品质** | 文档模板、审查流程 |
84
+ | **安全品质** | 安全扫描、依赖审计 |
85
+
86
+ ### 3.2 持续改进
87
+
88
+ - 定期回顾 AI 代理的产出品质
89
+ - 根据项目需求更新技能集
90
+ - 维护品质指标的趋势分析
91
+
92
+ ---
93
+
94
+ ## 相关标准
95
+
96
+ - [AI 协议标准](ai-agreement-standards.md)
97
+ - [AI 指令标准](../../../core/ai-instruction-standards.md)
98
+ - [情境感知加载](context-aware-loading.md)
99
+
100
+ ---
101
+
102
+ ## 许可证
103
+
104
+ 本标准采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 发布。
@@ -0,0 +1,132 @@
1
+ # 工作流程强制执行标准
2
+
3
+ **适用范围**:所有使用结构化开发方法论的软件项目
4
+ **范围**:通用
5
+
6
+ ## 概述
7
+
8
+ 本标准定义了机器可强制执行的工作流程闸门,防止在开发方法论(SDD、TDD、BDD)中跳过阶段。除了依赖开发者的自律外,工作流程闸门在阶段转换时提供自动化检查。
9
+
10
+ ## 核心原则
11
+
12
+ > **引导而非阻断。** 当前置条件失败时,总是提供可操作的指引:缺少什么、为什么重要、以及如何修复。
13
+
14
+ ## 执行模式
15
+
16
+ 项目可通过 `.uds/config.yaml` 配置执行行为:
17
+
18
+ | 模式 | 行为 | 使用场景 |
19
+ |------|------|---------|
20
+ | `enforce` | 阻断阶段转换 + 显示指引 | 承诺流程纪律的团队 |
21
+ | `suggest` | 显示警告 + 允许覆盖 | 渐进式采用的团队 |
22
+ | `off` | 不执行任何检查 | 选择退出 |
23
+
24
+ **默认值**:`enforce`
25
+
26
+ ```yaml
27
+ # .uds/config.yaml
28
+ workflow:
29
+ enforcement_mode: enforce # enforce | suggest | off
30
+ ```
31
+
32
+ ## 阶段闸门架构
33
+
34
+ ### 运作方式
35
+
36
+ 1. 用户调用工作流程命令(例如 `/sdd implement`)
37
+ 2. AI 助手检查该阶段的前置条件
38
+ 3. 如果前置条件通过 → 正常进行
39
+ 4. 如果前置条件失败:
40
+ - **enforce 模式**:停止、解释、引导到正确阶段
41
+ - **suggest 模式**:警告、允许覆盖
42
+ - **off 模式**:完全跳过检查
43
+
44
+ ### 闸门类型
45
+
46
+ | 闸门类型 | 阻断 | 描述 |
47
+ |---------|------|------|
48
+ | **硬闸门** | 是 | 必须通过才能继续(例如:规格必须为已核准才能实作) |
49
+ | **软闸门** | 否 | 建议性警告(例如:建议在 commit 中引用规格) |
50
+
51
+ ## SDD 阶段闸门
52
+
53
+ ```
54
+ discuss → create → review → approve → implement → verify
55
+ ```
56
+
57
+ | 阶段 | 前置条件 |
58
+ |------|---------|
59
+ | discuss | 无(入口点) |
60
+ | create | 检查孤儿规格(软闸门) |
61
+ | review | 规格存在且状态 = Draft |
62
+ | approve | 规格存在且状态 = Review,所有评论已处理 |
63
+ | implement | 规格存在且状态 = Approved |
64
+ | verify | 实作存在,所有 AC 有代码 + 测试 |
65
+
66
+ ## TDD 阶段闸门
67
+
68
+ ```
69
+ RED → GREEN → REFACTOR → (重复)
70
+ ```
71
+
72
+ | 阶段 | 前置条件 |
73
+ |------|---------|
74
+ | RED | 功能/行为已明确定义 |
75
+ | GREEN | 至少一个失败的测试存在(不是错误,而是断言失败) |
76
+ | REFACTOR | 所有测试通过 |
77
+
78
+ **关键强制规则**:AI 不得在失败测试存在之前撰写实作代码。这是 TDD 的基本契约。
79
+
80
+ ## BDD 阶段闸门
81
+
82
+ ```
83
+ DISCOVERY → FORMULATION → AUTOMATION → LIVING DOCS
84
+ ```
85
+
86
+ | 阶段 | 前置条件 |
87
+ |------|---------|
88
+ | DISCOVERY | 行为/功能已识别 |
89
+ | FORMULATION | 探索阶段产出的具体范例存在 |
90
+ | AUTOMATION | 包含 Gherkin 场景的 `.feature` 文件存在 |
91
+ | LIVING DOCS | 步骤定义已实作,所有场景通过 |
92
+
93
+ ## 提交闸门
94
+
95
+ | 检查 | 类型 | 触发 |
96
+ |------|------|------|
97
+ | 存在已暂存的变更 | 硬闸门 | 所有提交 |
98
+ | 无合并冲突 | 硬闸门 | 所有提交 |
99
+ | 测试通过 | 硬闸门 | feat/fix 提交 |
100
+ | 规格引用 | 软闸门 | 有活跃规格的 feat/fix 提交 |
101
+
102
+ ## 实作注意事项
103
+
104
+ ### 对于 AI 助手
105
+
106
+ AI 助手应该:
107
+ 1. 在执行任何工作流程阶段**之前**检查闸门
108
+ 2. 使用项目配置中的执行模式
109
+ 3. 当闸门失败时提供清晰、可操作的指引
110
+ 4. 在开始新工作流程前检查是否有可恢复的工作流程状态
111
+ 5. 在 `.workflow-state/` 中追踪阶段转换
112
+
113
+ ### 对于 CLI 工具
114
+
115
+ CLI 工具可通过以下方式整合闸门:
116
+ 1. `WorkflowGate` 模块 — 验证阶段转换
117
+ 2. Pre-commit hooks — 警告工作流程合规性
118
+ 3. `uds check` — 报告工作流程状态
119
+
120
+ ### 对于 Git Hooks
121
+
122
+ Git 层级的执行应为**仅警告**(非阻断),以避免让开发者感到挫折。AI 层级处理阻断性执行,因为它可以解释和引导。
123
+
124
+ ## 与其他标准的关系
125
+
126
+ | 标准 | 关系 |
127
+ |------|------|
128
+ | [工作流状态协议](workflow-state-protocol.md) | 闸门检查由此协议管理的状态文件 |
129
+ | [规格驱动开发](spec-driven-development.md) | SDD 阶段闸门强制 SDD 工作流程 |
130
+ | [测试标准](testing-standards.md) | TDD/BDD 闸门强制测试方法论 |
131
+ | [提交消息指南](commit-message-guide.md) | 提交闸门强制规格追踪性 |
132
+ | [签入标准](checkin-standards.md) | Pre-commit 闸门补充签入规则 |
@@ -1,6 +1,6 @@
1
1
  # UDS 速查表
2
2
 
3
- > Quick reference for all UDS features | Last updated: 2026-03-17
3
+ > Quick reference for all UDS features | Last updated: 2026-03-24
4
4
 
5
5
  **Language**: [English](../../../docs/CHEATSHEET.md) | [繁體中文](../../zh-TW/docs/CHEATSHEET.md) | 简体中文
6
6
 
@@ -24,6 +24,7 @@
24
24
 
25
25
  | Command | 说明 |
26
26
  |---------|-------------|
27
+ | `/ac-coverage` | "[UDS] Generate AC-to-test traceability matrix and coverage report" |
27
28
  | `/atdd` | [UDS] Guide through Acceptance Test-Driven Development workflow |
28
29
  | `/bdd` | [UDS] Guide through Behavior-Driven Development workflow |
29
30
  | `/brainstorm` | "[UDS] Structured AI-assisted brainstorming before spec creation" |
@@ -62,31 +63,42 @@
62
63
 
63
64
  | Skill | 说明 |
64
65
  |-------|-------------|
66
+ | `ac-coverage-assistant` | "[UDS] Analyze AC-to-test traceability and coverage" |
65
67
  | `ai-collaboration-standards` | Prevent AI hallucination and ensure evidence-based responses |
66
68
  | `ai-friendly-architecture` | Design AI-friendly architecture with explicit patterns, laye |
67
69
  | `ai-instruction-standards` | Create and maintain AI instruction files (CLAUDE.md, .cursor |
70
+ | `api-design-assistant` | Guide API design following REST, GraphQL, and gRPC best prac |
68
71
  | `atdd-assistant` | "[UDS] Guide through Acceptance Test-Driven Development work |
69
72
  | `audit-assistant` | "[UDS] UDS Health & Feedback System \| UDS 健康檢查與回饋系統" |
70
73
  | `bdd-assistant` | "[UDS] Guide through Behavior-Driven Development workflow" |
71
74
  | `brainstorm-assistant` | "[UDS] Structured AI-assisted brainstorming before spec crea |
72
75
  | `changelog-guide` | "[UDS] Generate and maintain CHANGELOG.md entries" |
73
76
  | `checkin-assistant` | "[UDS] Pre-commit quality gates verification" |
77
+ | `ci-cd-assistant` | Guide CI/CD pipeline design, configuration, and optimization |
74
78
  | `code-review-assistant` | "[UDS] Perform systematic code review with checklist" |
75
79
  | `commit-standards` | "[UDS] Generate commit messages following Conventional Commi |
80
+ | `database-assistant` | Guide database design, migration, and query optimization. |
76
81
  | `dev-workflow-guide` | "[UDS] Guide for mapping software development phases to UDS |
77
82
  | `docs-generator` | "[UDS] Generate usage documentation from project sources" |
78
83
  | `documentation-guide` | Guide documentation structure, content requirements, and pro |
84
+ | `durable-execution-assistant` | "[UDS] Guide workflow failure recovery with checkpoints, ret |
79
85
  | `error-code-guide` | Design consistent error codes following the PREFIX_CATEGORY_ |
80
86
  | `forward-derivation` | "[UDS] Derive BDD scenarios, TDD skeletons, or ATDD tables f |
81
87
  | `git-workflow-guide` | Guide Git branching strategies, branch naming, and merge ope |
88
+ | `incident-response-assistant` | Guide incident response, root cause analysis, and post-morte |
82
89
  | `logging-guide` | Implement structured logging with proper log levels and sens |
83
90
  | `methodology-system` | "[UDS] Manage development methodology workflow" |
91
+ | `metrics-dashboard-assistant` | "[UDS] Track development metrics, code quality indicators, a |
92
+ | `migration-assistant` | "[UDS] Guide code migration, framework upgrades, and technol |
93
+ | `pr-automation-assistant` | Guide pull request creation, review automation, and merge st |
84
94
  | `project-discovery` | "[UDS] Assess project health, architecture, and risks before |
85
95
  | `project-structure-guide` | Guide for organizing project directories following language- |
86
96
  | `refactoring-assistant` | "[UDS] Guide refactoring decisions and strategy selection" |
87
97
  | `release-standards` | "[UDS] Guide release process and changelogs" |
88
98
  | `requirement-assistant` | "[UDS] Write user stories and requirements following INVEST |
89
99
  | `reverse-engineer` | "[UDS] System archeology — reverse engineer code across Logi |
100
+ | `security-assistant` | Guide security review and vulnerability assessment following |
101
+ | `security-scan-assistant` | Guide automated security scanning, dependency auditing, and |
90
102
  | `spec-driven-dev` | "[UDS] Create or review specification documents for Spec-Dri |
91
103
  | `tdd-assistant` | "[UDS] Guide through Test-Driven Development workflow" |
92
104
  | `test-coverage-assistant` | "[UDS] Analyze test coverage and provide recommendations" |
@@ -116,18 +128,24 @@
116
128
 
117
129
  | Standard | 说明 |
118
130
  |----------|-------------|
131
+ | `acceptance-criteria-traceability` | Acceptance Criteria Traceability Standards |
119
132
  | `acceptance-test-driven-development` | Acceptance Test-Driven Development (ATDD) Standards |
120
133
  | `accessibility-standards` | This standard defines comprehensive guidelines for |
134
+ | `agent-dispatch` | Define standards for dispatching AI sub-agents in |
121
135
  | `ai-agreement-standards` | This standard formalizes the interaction between H |
122
136
  | `ai-friendly-architecture` | This standard defines architecture and documentati |
123
137
  | `ai-instruction-standards` | This standard defines best practices for creating |
124
138
  | `anti-hallucination` | This standard defines strict guidelines for AI ass |
139
+ | `api-design-standards` | This standard defines comprehensive guidelines for |
125
140
  | `behavior-driven-development` | Behavior-Driven Development (BDD) Standards |
141
+ | `branch-completion` | Define a standardized workflow for completing deve |
142
+ | `change-batching-standards` | Change Batching Standards |
126
143
  | `changelog-standards` | This standard defines how to write and maintain a |
127
144
  | `checkin-standards` | This standard defines quality gates that MUST be p |
128
145
  | `code-review-checklist` | This standard provides a comprehensive checklist f |
129
146
  | `commit-message-guide` | Standardized commit messages improve code review e |
130
147
  | `context-aware-loading` | This standard defines a protocol for AI tools to s |
148
+ | `database-standards` | This standard defines guidelines for database desi |
131
149
  | `deployment-standards` | This standard defines guidelines for safely deploy |
132
150
  | `developer-memory` | This standard defines a structured system for capt |
133
151
  | `documentation-structure` | This standard defines a consistent documentation s |
@@ -135,8 +153,11 @@
135
153
  | `error-code-standards` | Error Code Standards |
136
154
  | `forward-derivation-standards` | This standard defines the principles and workflows |
137
155
  | `git-workflow` | This standard defines Git branching strategies and |
156
+ | `git-worktree` | Define a lifecycle for using Git worktrees to isol |
138
157
  | `logging-standards` | Logging Standards |
158
+ | `model-selection` | Define a cost-effective strategy for selecting AI |
139
159
  | `performance-standards` | This standard defines comprehensive guidelines for |
160
+ | `pipeline-integration-standards` | Pipeline Integration Standards |
140
161
  | `project-context-memory` | This standard defines a structured system for capt |
141
162
  | `project-structure` | This standard defines conventions for project dire |
142
163
  | `refactoring-standards` | This standard defines comprehensive guidelines for |
@@ -145,12 +166,15 @@
145
166
  | `security-standards` | This standard defines comprehensive security guide |
146
167
  | `spec-driven-development` | Spec-Driven Development (SDD) Standards |
147
168
  | `structured-task-definition` | Structured Task Definition Standards |
169
+ | `systematic-debugging` | Define a structured, four-phase debugging workflow |
148
170
  | `test-completeness-dimensions` | This document defines a systematic framework for e |
149
171
  | `test-driven-development` | Test-Driven Development (TDD) Standards |
150
172
  | `test-governance` | Test Governance Standards |
151
173
  | `testing-standards` | This standard defines actionable testing rules and |
174
+ | `verification-evidence` | Establish an "Iron Law" that no task can be claime |
152
175
  | `versioning` | This standard defines how to version software rele |
153
176
  | `virtual-organization-standards` | This standard treats the AI ecosystem as a "Virtua |
177
+ | `workflow-enforcement` | Workflow Enforcement Standards |
154
178
  | `workflow-state-protocol` | Workflow State Protocol |
155
179
 
156
180
  ## 📜 脚本
@@ -164,6 +188,7 @@
164
188
  | `check-cli-docs-sync.sh` | CLI-to-Documentation Sync Checker |
165
189
  | `check-commands-sync.ps1` | Check Commands Sync |
166
190
  | `check-commands-sync.sh` | Commands Sync Checker |
191
+ | `check-commit-spec-reference.sh` | Commit-msg Spec Reference Suggestion — WARNING ONL |
167
192
  | `check-docs-integrity.ps1` | Check Docs Integrity |
168
193
  | `check-docs-integrity.sh` | Documentation Integrity Checker |
169
194
  | `check-docs-sync.ps1` | Check Docs Sync |
@@ -186,6 +211,7 @@
186
211
  | `check-usage-docs-sync.sh` | check-usage-docs-sync.sh |
187
212
  | `check-version-sync.ps1` | Check Version Sync |
188
213
  | `check-version-sync.sh` | Version Sync Checker |
214
+ | `check-workflow-compliance.sh` | Workflow Compliance Check — WARNING ONLY (non-bloc |
189
215
  | `convert-md-to-yaml.mjs` | Markdown to AI-YAML Conversion Script |
190
216
  | `fix-manifest-paths.ps1` | Fix Manifest Paths |
191
217
  | `fix-manifest-paths.sh` | Manifest Path Fixer |
@@ -728,7 +728,7 @@ You are an AI assistant that prioritizes accuracy over confidence...
728
728
  ---
729
729
 
730
730
  ## Commit Message Standards
731
- Reference: .standards/commit-message-guide.md
731
+ Reference: .standards/commit-message.ai.yaml
732
732
 
733
733
  ### Format Structure
734
734
  <type>(<scope>): <subject>
@@ -864,6 +864,8 @@ uds init --experimental
864
864
  |------|----------|------|
865
865
  | 非交互模式 | `-y, --yes` | 跳过交互提示,使用默认值 |
866
866
  | 实验性功能 | `-E, --experimental` | 启用实验性功能(开发方法论选择) |
867
+ | AGENTS.md | `--agents-md` | 生成 AGENTS.md 通用摘要(默认:未选 codex/opencode 时自动生成) |
868
+ | 不生成 AGENTS.md | `--no-agents-md` | 跳过 AGENTS.md 生成 |
867
869
  | 模式(已弃用) | `-m, --mode` | 安装模式(skills, full)- 请改用 `--skills-location` |
868
870
 
869
871
  ### 完整 CLI 示例
@@ -888,6 +890,12 @@ uds init -y \
888
890
  # 企业级完整设置
889
891
  uds init -y --content-mode full
890
892
 
893
+ # 生成 AGENTS.md 通用摘要(--yes 模式默认生成)
894
+ uds init -y --agents-md
895
+
896
+ # 跳过 AGENTS.md 生成
897
+ uds init -y --no-agents-md
898
+
891
899
  # 繁体中文团队
892
900
  uds init -y --commit-lang traditional-chinese --locale zh-cn
893
901
 
@@ -1,7 +1,7 @@
1
1
  # UDS 功能参考手册
2
2
 
3
3
  > Universal Development Standards - 完整功能文档
4
- > Auto-generated | Last updated: 2026-03-17
4
+ > Auto-generated | Last updated: 2026-03-24
5
5
 
6
6
  **Language**: [English](../../../docs/FEATURE-REFERENCE.md) | [繁體中文](../../zh-TW/docs/FEATURE-REFERENCE.md) | 简体中文
7
7
 
@@ -10,14 +10,14 @@
10
10
  ## 目录
11
11
 
12
12
  1. [CLI 指令](#cli-commands) (9)
13
- 2. [斜线命令](#slash-commands) (33)
14
- 3. [技能](#skills) (29)
13
+ 2. [斜线命令](#slash-commands) (45)
14
+ 3. [技能](#skills) (40)
15
15
  4. [代理](#agents) (5)
16
16
  5. [工作流程](#workflows) (5)
17
- 6. [核心规范](#core-standards) (36)
18
- 7. [脚本](#scripts) (39)
17
+ 6. [核心规范](#core-standards) (48)
18
+ 7. [脚本](#scripts) (41)
19
19
 
20
- **Total Features: 156**
20
+ **Total Features: 182**
21
21
 
22
22
  ---
23
23
 
@@ -50,6 +50,8 @@
50
50
  | `--locale` | Locale extension (zh-tw) |
51
51
  | `--skills-location` | Skills location (marketplace, user, project, none) [default: marketplace] |
52
52
  | `--content-mode` | Content mode for integration files (minimal, index, full) [default: index] |
53
+ | `--agents-md` | Generate AGENTS.md universal summary |
54
+ | `--no-agents-md` | Skip AGENTS.md generation |
53
55
  | `-y, --yes` | Use defaults, skip interactive prompts |
54
56
  | `-E, --experimental` | Enable experimental features (methodology) |
55
57
 
@@ -148,6 +150,7 @@
148
150
 
149
151
  | Command | 说明 |
150
152
  |---------|-------------|
153
+ | `/ac-coverage` | "[UDS] Generate AC-to-test traceability matrix and coverage report" |
151
154
  | `/atdd` | [UDS] Guide through Acceptance Test-Driven Development workflow |
152
155
  | `/bdd` | [UDS] Guide through Behavior-Driven Development workflow |
153
156
  | `/brainstorm` | "[UDS] Structured AI-assisted brainstorming before spec creation" |
@@ -188,31 +191,42 @@
188
191
 
189
192
  | Skill | 说明 |
190
193
  |-------|-------------|
194
+ | `ac-coverage-assistant` | "[UDS] Analyze AC-to-test traceability and coverage" |
191
195
  | `ai-collaboration-standards` | Prevent AI hallucination and ensure evidence-based responses when analyzing code or making suggestions. |
192
196
  | `ai-friendly-architecture` | Design AI-friendly architecture with explicit patterns, layered documentation, and semantic boundaries. |
193
197
  | `ai-instruction-standards` | Create and maintain AI instruction files (CLAUDE.md, .cursorrules, etc.) with proper structure. |
198
+ | `api-design-assistant` | Guide API design following REST, GraphQL, and gRPC best practices. |
194
199
  | `atdd-assistant` | "[UDS] Guide through Acceptance Test-Driven Development workflow" |
195
200
  | `audit-assistant` | "[UDS] UDS Health & Feedback System \| UDS 健康檢查與回饋系統" |
196
201
  | `bdd-assistant` | "[UDS] Guide through Behavior-Driven Development workflow" |
197
202
  | `brainstorm-assistant` | "[UDS] Structured AI-assisted brainstorming before spec creation" |
198
203
  | `changelog-guide` | "[UDS] Generate and maintain CHANGELOG.md entries" |
199
204
  | `checkin-assistant` | "[UDS] Pre-commit quality gates verification" |
205
+ | `ci-cd-assistant` | Guide CI/CD pipeline design, configuration, and optimization. |
200
206
  | `code-review-assistant` | "[UDS] Perform systematic code review with checklist" |
201
207
  | `commit-standards` | "[UDS] Generate commit messages following Conventional Commits standard" |
208
+ | `database-assistant` | Guide database design, migration, and query optimization. |
202
209
  | `dev-workflow-guide` | "[UDS] Guide for mapping software development phases to UDS commands and features" |
203
210
  | `docs-generator` | "[UDS] Generate usage documentation from project sources" |
204
211
  | `documentation-guide` | Guide documentation structure, content requirements, and project documentation best practices. |
212
+ | `durable-execution-assistant` | "[UDS] Guide workflow failure recovery with checkpoints, retries, and rollback" |
205
213
  | `error-code-guide` | Design consistent error codes following the PREFIX_CATEGORY_NUMBER format. |
206
214
  | `forward-derivation` | "[UDS] Derive BDD scenarios, TDD skeletons, or ATDD tables from specifications" |
207
215
  | `git-workflow-guide` | Guide Git branching strategies, branch naming, and merge operations. |
216
+ | `incident-response-assistant` | Guide incident response, root cause analysis, and post-mortem documentation. |
208
217
  | `logging-guide` | Implement structured logging with proper log levels and sensitive data handling. |
209
218
  | `methodology-system` | "[UDS] Manage development methodology workflow" |
219
+ | `metrics-dashboard-assistant` | "[UDS] Track development metrics, code quality indicators, and project health" |
220
+ | `migration-assistant` | "[UDS] Guide code migration, framework upgrades, and technology modernization" |
221
+ | `pr-automation-assistant` | Guide pull request creation, review automation, and merge strategies. |
210
222
  | `project-discovery` | "[UDS] Assess project health, architecture, and risks before adding features" |
211
223
  | `project-structure-guide` | Guide for organizing project directories following language-specific best practices. |
212
224
  | `refactoring-assistant` | "[UDS] Guide refactoring decisions and strategy selection" |
213
225
  | `release-standards` | "[UDS] Guide release process and changelogs" |
214
226
  | `requirement-assistant` | "[UDS] Write user stories and requirements following INVEST criteria" |
215
227
  | `reverse-engineer` | "[UDS] System archeology — reverse engineer code across Logic, Data, and Runtime dimensions" |
228
+ | `security-assistant` | Guide security review and vulnerability assessment following OWASP standards. |
229
+ | `security-scan-assistant` | Guide automated security scanning, dependency auditing, and secret detection. |
216
230
  | `spec-driven-dev` | "[UDS] Create or review specification documents for Spec-Driven Development" |
217
231
  | `tdd-assistant` | "[UDS] Guide through Test-Driven Development workflow" |
218
232
  | `test-coverage-assistant` | "[UDS] Analyze test coverage and provide recommendations" |
@@ -248,27 +262,36 @@
248
262
 
249
263
  | Standard | 版本 | 说明 |
250
264
  |----------|---------|-------------|
265
+ | `acceptance-criteria-traceability` | - | |
251
266
  | `acceptance-test-driven-development` | 1.1.0 | |
252
267
  | `accessibility-standards` | 1.0.0 | This standard defines comprehensive guidelines for creating accessible software |
268
+ | `agent-dispatch` | 1.0.0 | Define standards for dispatching AI sub-agents in parallel, coordinating their w |
253
269
  | `ai-agreement-standards` | 1.0.0 | This standard formalizes the interaction between Human (Acquirer) and AI (Suppli |
254
270
  | `ai-friendly-architecture` | 1.0.0 | This standard defines architecture and documentation practices that maximize the |
255
271
  | `ai-instruction-standards` | 1.0.0 | This standard defines best practices for creating and maintaining AI instruction |
256
272
  | `anti-hallucination` | 1.5.0 | This standard defines strict guidelines for AI assistants to prevent hallucinati |
273
+ | `api-design-standards` | 1.0.0 | This standard defines comprehensive guidelines for designing, building, and main |
257
274
  | `behavior-driven-development` | 1.1.0 | |
275
+ | `branch-completion` | 1.0.0 | Define a standardized workflow for completing development branches, including pr |
276
+ | `change-batching-standards` | - | |
258
277
  | `changelog-standards` | 1.0.2 | This standard defines how to write and maintain a CHANGELOG.md file to communica |
259
- | `checkin-standards` | 1.4.0 | This standard defines quality gates that MUST be passed before committing code t |
278
+ | `checkin-standards` | 1.5.0 | This standard defines quality gates that MUST be passed before committing code t |
260
279
  | `code-review-checklist` | 1.3.0 | This standard provides a comprehensive checklist for reviewing code changes, ens |
261
280
  | `commit-message-guide` | 1.3.0 | Standardized commit messages improve code review efficiency, facilitate automate |
262
281
  | `context-aware-loading` | 1.0.0 | This standard defines a protocol for AI tools to selectively load development st |
282
+ | `database-standards` | 1.0.0 | This standard defines guidelines for database design, querying, migration, and o |
263
283
  | `deployment-standards` | 1.0.0 | This standard defines guidelines for safely deploying software to production, co |
264
284
  | `developer-memory` | 1.0.0 | This standard defines a structured system for capturing, retrieving, and surfaci |
265
285
  | `documentation-structure` | 1.5.0 | This standard defines a consistent documentation structure for software projects |
266
286
  | `documentation-writing-standards` | 1.2.0 | This standard defines documentation requirements based on project types and prov |
267
- | `error-code-standards` | 1.1.0 | |
268
- | `forward-derivation-standards` | 1.1.0 | This standard defines the principles and workflows for Forward Derivation—automa |
287
+ | `error-code-standards` | 1.2.0 | |
288
+ | `forward-derivation-standards` | 1.2.0 | This standard defines the principles and workflows for Forward Derivation—automa |
269
289
  | `git-workflow` | 1.4.0 | This standard defines Git branching strategies and workflows to ensure consisten |
290
+ | `git-worktree` | 1.0.0 | Define a lifecycle for using Git worktrees to isolate development work, ensuring |
270
291
  | `logging-standards` | 1.2.0 | |
292
+ | `model-selection` | 1.0.0 | Define a cost-effective strategy for selecting AI model tiers based on task comp |
271
293
  | `performance-standards` | 1.1.0 | This standard defines comprehensive guidelines for software performance engineer |
294
+ | `pipeline-integration-standards` | - | |
272
295
  | `project-context-memory` | 1.1.0 | This standard defines a structured system for capturing, retrieving, and enforci |
273
296
  | `project-structure` | 1.2.0 | This standard defines conventions for project directory structure beyond documen |
274
297
  | `refactoring-standards` | 2.1.0 | This standard defines comprehensive guidelines for code refactoring, covering ev |
@@ -277,12 +300,15 @@
277
300
  | `security-standards` | 1.1.0 | This standard defines comprehensive security guidelines for software development |
278
301
  | `spec-driven-development` | 2.1.0 | |
279
302
  | `structured-task-definition` | 1.0.0 | |
303
+ | `systematic-debugging` | 1.0.0 | Define a structured, four-phase debugging workflow that prevents the common anti |
280
304
  | `test-completeness-dimensions` | 1.1.0 | This document defines a systematic framework for evaluating test completeness. I |
281
305
  | `test-driven-development` | 1.2.0 | |
282
306
  | `test-governance` | - | |
283
307
  | `testing-standards` | 3.0.0 | This standard defines actionable testing rules and conventions for AI agents and |
308
+ | `verification-evidence` | 1.0.0 | Establish an "Iron Law" that no task can be claimed as complete without verifica |
284
309
  | `versioning` | 1.2.0 | This standard defines how to version software releases using Semantic Versioning |
285
310
  | `virtual-organization-standards` | 1.0.0 | This standard treats the AI ecosystem as a "Virtual Organization." It defines ho |
311
+ | `workflow-enforcement` | - | |
286
312
  | `workflow-state-protocol` | 1.0.0 | |
287
313
 
288
314
  ---
@@ -298,6 +324,7 @@
298
324
  | `check-cli-docs-sync.sh` | CLI-to-Documentation Sync Checker |
299
325
  | `check-commands-sync.ps1` | Check Commands Sync |
300
326
  | `check-commands-sync.sh` | Commands Sync Checker |
327
+ | `check-commit-spec-reference.sh` | Commit-msg Spec Reference Suggestion — WARNING ONLY (non-blocking) |
301
328
  | `check-docs-integrity.ps1` | Check Docs Integrity |
302
329
  | `check-docs-integrity.sh` | Documentation Integrity Checker |
303
330
  | `check-docs-sync.ps1` | Check Docs Sync |
@@ -320,6 +347,7 @@
320
347
  | `check-usage-docs-sync.sh` | check-usage-docs-sync.sh |
321
348
  | `check-version-sync.ps1` | Check Version Sync |
322
349
  | `check-version-sync.sh` | Version Sync Checker |
350
+ | `check-workflow-compliance.sh` | Workflow Compliance Check — WARNING ONLY (non-blocking) |
323
351
  | `convert-md-to-yaml.mjs` | Markdown to AI-YAML Conversion Script |
324
352
  | `fix-manifest-paths.ps1` | Fix Manifest Paths |
325
353
  | `fix-manifest-paths.sh` | Manifest Path Fixer |