universal-dev-standards 5.16.0 → 6.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 (540) hide show
  1. package/bin/uds.js +13 -135
  2. package/bundled/ai/standards/acceptance-criteria-traceability.ai.yaml +13 -4
  3. package/bundled/ai/standards/accessibility-standards.ai.yaml +1 -1
  4. package/bundled/ai/standards/ai-response-navigation.ai.yaml +15 -2
  5. package/bundled/ai/standards/api-design-standards.ai.yaml +27 -4
  6. package/bundled/ai/standards/behavior-snapshot.ai.yaml +86 -9
  7. package/bundled/ai/standards/checkin-standards.ai.yaml +2 -2
  8. package/bundled/ai/standards/code-review.ai.yaml +2 -2
  9. package/bundled/ai/standards/context-aware-loading.ai.yaml +3 -3
  10. package/bundled/ai/standards/data-migration-testing.ai.yaml +79 -3
  11. package/bundled/ai/standards/deprecation-standards.ai.yaml +10 -2
  12. package/bundled/ai/standards/developer-memory.ai.yaml +4 -3
  13. package/bundled/ai/standards/flow-based-testing.ai.yaml +2 -2
  14. package/bundled/ai/standards/forward-derivation-standards.ai.yaml +26 -2
  15. package/bundled/ai/standards/full-coverage-testing.ai.yaml +34 -2
  16. package/bundled/ai/standards/git-worktree.ai.yaml +3 -3
  17. package/bundled/ai/standards/logging.ai.yaml +97 -3
  18. package/bundled/ai/standards/mock-boundary.ai.yaml +48 -2
  19. package/bundled/ai/standards/model-provenance.ai.yaml +297 -0
  20. package/bundled/ai/standards/model-selection.ai.yaml +11 -2
  21. package/bundled/ai/standards/observability-standards.ai.yaml +10 -0
  22. package/bundled/ai/standards/performance-standards.ai.yaml +46 -1
  23. package/bundled/ai/standards/pii-classification.ai.yaml +15 -1
  24. package/bundled/ai/standards/pipeline-security-gates.ai.yaml +10 -0
  25. package/bundled/ai/standards/privacy-standards.ai.yaml +2 -2
  26. package/bundled/ai/standards/project-context-memory.ai.yaml +2 -2
  27. package/bundled/ai/standards/refactoring-standards.ai.yaml +68 -3
  28. package/bundled/ai/standards/resource-cost-boundary.ai.yaml +279 -0
  29. package/bundled/ai/standards/reverse-engineering-standards.ai.yaml +55 -2
  30. package/bundled/ai/standards/security-testing.ai.yaml +13 -2
  31. package/bundled/ai/standards/skill-standard-alignment-check.ai.yaml +37 -2
  32. package/bundled/ai/standards/user-journey-testing.ai.yaml +107 -0
  33. package/bundled/ai/standards/verification-oracle.ai.yaml +278 -0
  34. package/bundled/ai/standards/versioning.ai.yaml +32 -38
  35. package/bundled/core/acceptance-criteria-traceability.md +15 -5
  36. package/bundled/core/accessibility-standards.md +8 -4
  37. package/bundled/core/ai-friendly-architecture.md +1 -1
  38. package/bundled/core/ai-response-navigation.md +31 -3
  39. package/bundled/core/anti-sycophancy-prompting.md +1 -1
  40. package/bundled/core/api-design-standards.md +92 -7
  41. package/bundled/core/audit-trail.md +119 -0
  42. package/bundled/core/behavior-snapshot.md +94 -7
  43. package/bundled/core/browser-compatibility-standards.md +15 -2
  44. package/bundled/core/checkin-standards.md +9 -2
  45. package/bundled/core/code-review-checklist.md +10 -2
  46. package/bundled/core/container-image-standards.md +97 -0
  47. package/bundled/core/context-aware-loading.md +2 -2
  48. package/bundled/core/cost-budget-test.md +1 -1
  49. package/bundled/core/cross-flow-regression.md +3 -2
  50. package/bundled/core/data-contract.md +104 -0
  51. package/bundled/core/data-migration-testing.md +90 -0
  52. package/bundled/core/data-pipeline.md +113 -0
  53. package/bundled/core/deprecation-standards.md +16 -2
  54. package/bundled/core/developer-memory.md +13 -8
  55. package/bundled/core/documentation-writing-standards.md +1 -1
  56. package/bundled/core/error-code-standards.md +4 -3
  57. package/bundled/core/flaky-test-management.md +1 -1
  58. package/bundled/core/flow-based-testing.md +3 -3
  59. package/bundled/core/forward-derivation-standards.md +33 -5
  60. package/bundled/core/full-coverage-testing.md +72 -0
  61. package/bundled/core/git-worktree.md +4 -4
  62. package/bundled/core/guides/performance-guide.md +1 -1
  63. package/bundled/core/guides/security-guide.md +1 -1
  64. package/bundled/core/health-check-standards.md +2 -2
  65. package/bundled/core/iac-design-principles.md +97 -0
  66. package/bundled/core/incident-response.md +119 -0
  67. package/bundled/core/license-compliance.md +2 -0
  68. package/bundled/core/logging-standards.md +78 -2
  69. package/bundled/core/mock-boundary.md +54 -2
  70. package/bundled/core/model-provenance.md +181 -0
  71. package/bundled/core/model-selection.md +27 -2
  72. package/bundled/core/packaging-standards.md +1 -0
  73. package/bundled/core/performance-standards.md +96 -2
  74. package/bundled/core/pii-classification.md +148 -0
  75. package/bundled/core/pipeline-security-gates.md +22 -2
  76. package/bundled/core/postmortem-standards.md +2 -0
  77. package/bundled/core/prd-standards.md +91 -0
  78. package/bundled/core/privacy-standards.md +14 -3
  79. package/bundled/core/product-metrics-standards.md +100 -0
  80. package/bundled/core/project-context-memory.md +8 -2
  81. package/bundled/core/prompt-regression.md +1 -1
  82. package/bundled/core/refactoring-standards.md +44 -3
  83. package/bundled/core/replay-test.md +1 -1
  84. package/bundled/core/resource-cost-boundary.md +180 -0
  85. package/bundled/core/reverse-engineering-standards.md +66 -2
  86. package/bundled/core/runbook.md +113 -0
  87. package/bundled/core/schema-evolution.md +105 -0
  88. package/bundled/core/secret-management-standards.md +110 -0
  89. package/bundled/core/security-testing.md +26 -2
  90. package/bundled/core/self-review-protocol.md +2 -2
  91. package/bundled/core/skill-standard-alignment-check.md +53 -0
  92. package/bundled/core/slo-sli.md +109 -0
  93. package/bundled/core/smoke-test.md +1 -1
  94. package/bundled/core/spec-driven-development.md +21 -3
  95. package/bundled/core/tech-debt-standards.md +1 -1
  96. package/bundled/core/test-data-standards.md +2 -2
  97. package/bundled/core/user-journey-testing.md +102 -0
  98. package/bundled/core/user-story-mapping.md +96 -0
  99. package/bundled/core/verification-oracle.md +167 -0
  100. package/bundled/core/versioning.md +133 -109
  101. package/bundled/locales/COVERAGE.md +84 -73
  102. package/bundled/locales/zh-CN/CHANGELOG.md +81 -6
  103. package/bundled/locales/zh-CN/CLAUDE.md +1 -1
  104. package/bundled/locales/zh-CN/README.md +22 -9
  105. package/bundled/locales/zh-CN/SECURITY.md +1 -1
  106. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -2
  107. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +4 -6
  108. package/bundled/locales/zh-CN/core/accessibility-standards.md +1 -1
  109. package/bundled/locales/zh-CN/core/adversarial-test.md +226 -0
  110. package/bundled/locales/zh-CN/core/agent-behavior-discipline.md +187 -0
  111. package/bundled/locales/zh-CN/core/ai-response-navigation.md +32 -6
  112. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +1 -1
  113. package/bundled/locales/zh-CN/core/api-design-standards.md +1 -1
  114. package/bundled/locales/zh-CN/core/behavior-snapshot.md +335 -0
  115. package/bundled/locales/zh-CN/core/browser-compatibility-standards.md +229 -0
  116. package/bundled/locales/zh-CN/core/cd-deployment-strategies.md +135 -0
  117. package/bundled/locales/zh-CN/core/chaos-injection-tests.md +130 -0
  118. package/bundled/locales/zh-CN/core/checkin-standards.md +1 -1
  119. package/bundled/locales/zh-CN/core/code-review-checklist.md +1 -1
  120. package/bundled/locales/zh-CN/core/container-security.md +535 -0
  121. package/bundled/locales/zh-CN/core/context-aware-loading.md +1 -1
  122. package/bundled/locales/zh-CN/core/contract-testing-standards.md +191 -0
  123. package/bundled/locales/zh-CN/core/cost-budget-test.md +86 -0
  124. package/bundled/locales/zh-CN/core/cross-flow-regression.md +199 -0
  125. package/bundled/locales/zh-CN/core/data-migration-testing.md +217 -0
  126. package/bundled/locales/zh-CN/core/deployment-standards.md +328 -9
  127. package/bundled/locales/zh-CN/core/deprecation-standards.md +1 -1
  128. package/bundled/locales/zh-CN/core/developer-memory.md +2 -2
  129. package/bundled/locales/zh-CN/core/disaster-recovery-drill.md +87 -0
  130. package/bundled/locales/zh-CN/core/documentation-structure.md +1 -1
  131. package/bundled/locales/zh-CN/core/documentation-writing-standards.md +1 -1
  132. package/bundled/locales/zh-CN/core/error-code-standards.md +2 -2
  133. package/bundled/locales/zh-CN/core/feature-manifest-standard.md +222 -0
  134. package/bundled/locales/zh-CN/core/flaky-test-management.md +87 -0
  135. package/bundled/locales/zh-CN/core/flow-based-testing.md +284 -0
  136. package/bundled/locales/zh-CN/core/forward-derivation-standards.md +3 -4
  137. package/bundled/locales/zh-CN/core/full-coverage-testing.md +197 -0
  138. package/bundled/locales/zh-CN/core/git-worktree.md +1 -1
  139. package/bundled/locales/zh-CN/core/governance-layer.md +160 -0
  140. package/bundled/locales/zh-CN/core/guides/performance-guide.md +515 -0
  141. package/bundled/locales/zh-CN/core/guides/security-guide.md +494 -0
  142. package/bundled/locales/zh-CN/core/knowledge-graph-memory.md +128 -0
  143. package/bundled/locales/zh-CN/core/license-compliance.md +129 -0
  144. package/bundled/locales/zh-CN/core/llm-output-validation.md +192 -0
  145. package/bundled/locales/zh-CN/core/logging-standards.md +130 -8
  146. package/bundled/locales/zh-CN/core/mock-boundary.md +109 -0
  147. package/bundled/locales/zh-CN/core/model-selection.md +28 -5
  148. package/bundled/locales/zh-CN/core/mutation-testing.md +106 -0
  149. package/bundled/locales/zh-CN/core/no-cicd-deployment.md +219 -0
  150. package/bundled/locales/zh-CN/core/packaging-standards.md +76 -5
  151. package/bundled/locales/zh-CN/core/pipeline-security-gates.md +126 -0
  152. package/bundled/locales/zh-CN/core/policy-as-code-testing.md +203 -0
  153. package/bundled/locales/zh-CN/core/privacy-standards.md +1 -1
  154. package/bundled/locales/zh-CN/core/project-context-memory.md +1 -1
  155. package/bundled/locales/zh-CN/core/prompt-regression.md +88 -0
  156. package/bundled/locales/zh-CN/core/property-based-testing.md +87 -0
  157. package/bundled/locales/zh-CN/core/release-quality-manifest.md +207 -0
  158. package/bundled/locales/zh-CN/core/release-readiness-gate.md +193 -0
  159. package/bundled/locales/zh-CN/core/replay-test.md +102 -0
  160. package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +46 -1
  161. package/bundled/locales/zh-CN/core/rollback-standards.md +120 -0
  162. package/bundled/locales/zh-CN/core/sast-advanced.md +309 -0
  163. package/bundled/locales/zh-CN/core/secure-op.md +328 -0
  164. package/bundled/locales/zh-CN/core/security-testing.md +96 -0
  165. package/bundled/locales/zh-CN/core/self-review-protocol.md +167 -0
  166. package/bundled/locales/zh-CN/core/server-ops-security.md +507 -0
  167. package/bundled/locales/zh-CN/core/smoke-test.md +79 -0
  168. package/bundled/locales/zh-CN/core/spec-driven-development.md +55 -5
  169. package/bundled/locales/zh-CN/core/supply-chain-attestation.md +131 -0
  170. package/bundled/locales/zh-CN/core/versioning.md +1 -1
  171. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +31 -6
  172. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +61 -34
  173. package/bundled/locales/zh-CN/docs/MIGRATION-v6.md +88 -0
  174. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +2 -2
  175. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +14 -14
  176. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +105 -0
  177. package/bundled/locales/zh-CN/docs/user/FAQ.md +132 -0
  178. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +144 -0
  179. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +178 -0
  180. package/bundled/locales/zh-CN/docs/user/README.md +70 -0
  181. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +190 -0
  182. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +1 -1
  183. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +1 -1
  184. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +3 -3
  185. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +3 -3
  186. package/bundled/locales/zh-CN/methodologies/guides/sdd-guide.md +836 -0
  187. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +166 -0
  188. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +140 -0
  189. package/bundled/locales/zh-CN/options/code-review/automated-review.md +214 -0
  190. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +166 -0
  191. package/bundled/locales/zh-CN/options/code-review/pr-review.md +167 -0
  192. package/bundled/locales/zh-CN/options/documentation/api-docs.md +191 -0
  193. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +150 -0
  194. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +131 -0
  195. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +144 -0
  196. package/bundled/locales/zh-CN/options/project-structure/php.md +168 -0
  197. package/bundled/locales/zh-CN/options/project-structure/ruby.md +156 -0
  198. package/bundled/locales/zh-CN/options/project-structure/rust.md +136 -0
  199. package/bundled/locales/zh-CN/options/project-structure/swift.md +165 -0
  200. package/bundled/locales/zh-CN/options/testing/contract-testing.md +237 -0
  201. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +200 -0
  202. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +144 -0
  203. package/bundled/locales/zh-CN/options/testing/performance-testing.md +251 -0
  204. package/bundled/locales/zh-CN/options/testing/security-testing.md +192 -0
  205. package/bundled/locales/zh-CN/skills/README.md +89 -126
  206. package/bundled/locales/zh-CN/skills/ac-coverage/SKILL.md +5 -7
  207. package/bundled/locales/zh-CN/skills/adr-assistant/SKILL.md +1 -1
  208. package/bundled/locales/zh-CN/skills/agents/code-architect.md +263 -0
  209. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +410 -0
  210. package/bundled/locales/zh-CN/skills/agents/reviewer.md +357 -0
  211. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +410 -0
  212. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +368 -0
  213. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +2 -2
  214. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +2 -2
  215. package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +1 -1
  216. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +1 -1
  217. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +3 -4
  218. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +2 -2
  219. package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +1 -2
  220. package/bundled/locales/zh-CN/skills/brainstorm-assistant/SKILL.md +109 -13
  221. package/bundled/locales/zh-CN/skills/brainstorm-assistant/guide.md +30 -8
  222. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +1 -1
  223. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +50 -0
  224. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +5 -5
  225. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +1 -1
  226. package/bundled/locales/zh-CN/skills/commands/atdd.md +3 -3
  227. package/bundled/locales/zh-CN/skills/commands/bdd.md +2 -2
  228. package/bundled/locales/zh-CN/skills/commands/brainstorm.md +26 -17
  229. package/bundled/locales/zh-CN/skills/commands/{review.md → code-review.md} +4 -4
  230. package/bundled/locales/zh-CN/skills/commands/derive-all.md +1 -1
  231. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +1 -1
  232. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +2 -3
  233. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +1 -1
  234. package/bundled/locales/zh-CN/skills/commands/derive.md +1 -1
  235. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +2 -2
  236. package/bundled/locales/zh-CN/skills/commands/methodology.md +4 -4
  237. package/bundled/locales/zh-CN/skills/commands/pr.md +1 -1
  238. package/bundled/locales/zh-CN/skills/commands/tdd.md +1 -1
  239. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +1 -1
  240. package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +1 -1
  241. package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +1 -1
  242. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +456 -0
  243. package/bundled/locales/zh-CN/skills/dev-methodology/guide.md +6 -6
  244. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +296 -0
  245. package/bundled/locales/zh-CN/skills/dev-workflow-guide/SKILL.md +5 -5
  246. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +1 -1
  247. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +1 -1
  248. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +2 -2
  249. package/bundled/locales/zh-CN/skills/journey-test-assistant/SKILL.md +1 -1
  250. package/bundled/locales/zh-CN/skills/logging-guide/SKILL.md +146 -142
  251. package/bundled/locales/zh-CN/skills/migration-assistant/SKILL.md +1 -1
  252. package/bundled/locales/zh-CN/skills/observability-assistant/guide.md +1 -1
  253. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +1 -1
  254. package/bundled/locales/zh-CN/skills/project-discovery/guide.md +2 -2
  255. package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +1 -1
  256. package/bundled/locales/zh-CN/skills/runbook-assistant/guide.md +1 -1
  257. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +1 -1
  258. package/bundled/locales/zh-CN/skills/skill-builder/SKILL.md +3 -3
  259. package/bundled/locales/zh-CN/skills/slo-assistant/guide.md +1 -1
  260. package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +1 -1
  261. package/bundled/locales/zh-CN/skills/spec-derivation/guide.md +8 -9
  262. package/bundled/locales/zh-CN/skills/spec-driven-dev/SKILL.md +2 -2
  263. package/bundled/locales/zh-CN/skills/sweep/SKILL.md +1 -1
  264. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +1 -1
  265. package/bundled/locales/zh-CN/skills/testing-guide/SKILL.md +2 -2
  266. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +2298 -0
  267. package/bundled/locales/zh-CN/skills/workflows/README.md +451 -0
  268. package/bundled/locales/zh-TW/CHANGELOG.md +81 -6
  269. package/bundled/locales/zh-TW/CLAUDE.md +1 -1
  270. package/bundled/locales/zh-TW/MAINTENANCE.md +25 -2
  271. package/bundled/locales/zh-TW/README.md +22 -9
  272. package/bundled/locales/zh-TW/SECURITY.md +1 -1
  273. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -2
  274. package/bundled/locales/zh-TW/ai/standards/versioning.ai.yaml +8 -48
  275. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +4 -6
  276. package/bundled/locales/zh-TW/core/accessibility-standards.md +1 -1
  277. package/bundled/locales/zh-TW/core/adversarial-test.md +226 -0
  278. package/bundled/locales/zh-TW/core/agent-behavior-discipline.md +187 -0
  279. package/bundled/locales/zh-TW/core/ai-response-navigation.md +32 -6
  280. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +1 -1
  281. package/bundled/locales/zh-TW/core/api-design-standards.md +91 -9
  282. package/bundled/locales/zh-TW/core/audit-trail.md +110 -0
  283. package/bundled/locales/zh-TW/core/behavior-snapshot.md +335 -0
  284. package/bundled/locales/zh-TW/core/browser-compatibility-standards.md +1 -0
  285. package/bundled/locales/zh-TW/core/cd-deployment-strategies.md +135 -0
  286. package/bundled/locales/zh-TW/core/chaos-injection-tests.md +130 -0
  287. package/bundled/locales/zh-TW/core/checkin-standards.md +1 -1
  288. package/bundled/locales/zh-TW/core/code-review-checklist.md +1 -1
  289. package/bundled/locales/zh-TW/core/container-image-standards.md +93 -0
  290. package/bundled/locales/zh-TW/core/container-security.md +535 -0
  291. package/bundled/locales/zh-TW/core/cost-budget-test.md +86 -0
  292. package/bundled/locales/zh-TW/core/cross-flow-regression.md +1 -0
  293. package/bundled/locales/zh-TW/core/data-contract.md +101 -0
  294. package/bundled/locales/zh-TW/core/data-migration-testing.md +217 -0
  295. package/bundled/locales/zh-TW/core/data-pipeline.md +105 -0
  296. package/bundled/locales/zh-TW/core/deployment-standards.md +363 -25
  297. package/bundled/locales/zh-TW/core/deprecation-standards.md +17 -4
  298. package/bundled/locales/zh-TW/core/developer-memory.md +2 -2
  299. package/bundled/locales/zh-TW/core/disaster-recovery-drill.md +87 -0
  300. package/bundled/locales/zh-TW/core/documentation-writing-standards.md +1 -1
  301. package/bundled/locales/zh-TW/core/error-code-standards.md +2 -2
  302. package/bundled/locales/zh-TW/core/feature-manifest-standard.md +222 -0
  303. package/bundled/locales/zh-TW/core/flaky-test-management.md +87 -0
  304. package/bundled/locales/zh-TW/core/flow-based-testing.md +284 -0
  305. package/bundled/locales/zh-TW/core/forward-derivation-standards.md +3 -4
  306. package/bundled/locales/zh-TW/core/full-coverage-testing.md +250 -0
  307. package/bundled/locales/zh-TW/core/git-worktree.md +1 -1
  308. package/bundled/locales/zh-TW/core/guides/performance-guide.md +515 -0
  309. package/bundled/locales/zh-TW/core/guides/security-guide.md +494 -0
  310. package/bundled/locales/zh-TW/core/iac-design-principles.md +90 -0
  311. package/bundled/locales/zh-TW/core/incident-response.md +111 -0
  312. package/bundled/locales/zh-TW/core/license-compliance.md +129 -0
  313. package/bundled/locales/zh-TW/core/llm-output-validation.md +192 -0
  314. package/bundled/locales/zh-TW/core/logging-standards.md +208 -4
  315. package/bundled/locales/zh-TW/core/mock-boundary.md +161 -0
  316. package/bundled/locales/zh-TW/core/model-provenance.md +173 -0
  317. package/bundled/locales/zh-TW/core/model-selection.md +28 -5
  318. package/bundled/locales/zh-TW/core/mutation-testing.md +106 -0
  319. package/bundled/locales/zh-TW/core/no-cicd-deployment.md +219 -0
  320. package/bundled/locales/zh-TW/core/packaging-standards.md +76 -5
  321. package/bundled/locales/zh-TW/core/performance-standards.md +84 -5
  322. package/bundled/locales/zh-TW/core/pii-classification.md +102 -0
  323. package/bundled/locales/zh-TW/core/pipeline-security-gates.md +126 -0
  324. package/bundled/locales/zh-TW/core/policy-as-code-testing.md +203 -0
  325. package/bundled/locales/zh-TW/core/prd-standards.md +88 -0
  326. package/bundled/locales/zh-TW/core/privacy-standards.md +1 -1
  327. package/bundled/locales/zh-TW/core/product-metrics-standards.md +96 -0
  328. package/bundled/locales/zh-TW/core/project-context-memory.md +1 -1
  329. package/bundled/locales/zh-TW/core/prompt-regression.md +88 -0
  330. package/bundled/locales/zh-TW/core/property-based-testing.md +87 -0
  331. package/bundled/locales/zh-TW/core/refactoring-standards.md +43 -6
  332. package/bundled/locales/zh-TW/core/release-quality-manifest.md +207 -0
  333. package/bundled/locales/zh-TW/core/replay-test.md +102 -0
  334. package/bundled/locales/zh-TW/core/resource-cost-boundary.md +175 -0
  335. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +64 -5
  336. package/bundled/locales/zh-TW/core/rollback-standards.md +120 -0
  337. package/bundled/locales/zh-TW/core/runbook.md +110 -0
  338. package/bundled/locales/zh-TW/core/sast-advanced.md +309 -0
  339. package/bundled/locales/zh-TW/core/schema-evolution.md +98 -0
  340. package/bundled/locales/zh-TW/core/secret-management-standards.md +101 -0
  341. package/bundled/locales/zh-TW/core/secure-op.md +328 -0
  342. package/bundled/locales/zh-TW/core/security-testing.md +96 -0
  343. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -2
  344. package/bundled/locales/zh-TW/core/server-ops-security.md +507 -0
  345. package/bundled/locales/zh-TW/core/slo-sli.md +108 -0
  346. package/bundled/locales/zh-TW/core/smoke-test.md +79 -0
  347. package/bundled/locales/zh-TW/core/spec-driven-development.md +39 -13
  348. package/bundled/locales/zh-TW/core/supply-chain-attestation.md +131 -0
  349. package/bundled/locales/zh-TW/core/user-journey-testing.md +111 -0
  350. package/bundled/locales/zh-TW/core/user-story-mapping.md +94 -0
  351. package/bundled/locales/zh-TW/core/verification-oracle.md +159 -0
  352. package/bundled/locales/zh-TW/core/versioning.md +112 -112
  353. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +31 -6
  354. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +6 -6
  355. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +61 -34
  356. package/bundled/locales/zh-TW/docs/MIGRATION-v6.md +88 -0
  357. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -2
  358. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +14 -14
  359. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +105 -0
  360. package/bundled/locales/zh-TW/docs/user/FAQ.md +132 -0
  361. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +144 -0
  362. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +178 -0
  363. package/bundled/locales/zh-TW/docs/user/README.md +70 -0
  364. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +190 -0
  365. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +1 -1
  366. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +1 -1
  367. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +3 -3
  368. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +3 -3
  369. package/bundled/locales/zh-TW/methodologies/guides/sdd-guide.md +523 -26
  370. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +166 -0
  371. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +140 -0
  372. package/bundled/locales/zh-TW/options/code-review/automated-review.md +214 -0
  373. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +166 -0
  374. package/bundled/locales/zh-TW/options/code-review/pr-review.md +167 -0
  375. package/bundled/locales/zh-TW/options/documentation/api-docs.md +191 -0
  376. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +150 -0
  377. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +131 -0
  378. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +144 -0
  379. package/bundled/locales/zh-TW/options/project-structure/php.md +168 -0
  380. package/bundled/locales/zh-TW/options/project-structure/ruby.md +156 -0
  381. package/bundled/locales/zh-TW/options/project-structure/rust.md +136 -0
  382. package/bundled/locales/zh-TW/options/project-structure/swift.md +165 -0
  383. package/bundled/locales/zh-TW/options/testing/contract-testing.md +237 -0
  384. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +200 -0
  385. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +144 -0
  386. package/bundled/locales/zh-TW/options/testing/performance-testing.md +251 -0
  387. package/bundled/locales/zh-TW/options/testing/security-testing.md +192 -0
  388. package/bundled/locales/zh-TW/skills/README.md +91 -128
  389. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +4 -6
  390. package/bundled/locales/zh-TW/skills/adr-assistant/SKILL.md +1 -1
  391. package/bundled/locales/zh-TW/skills/agents/code-architect.md +263 -0
  392. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +410 -0
  393. package/bundled/locales/zh-TW/skills/agents/reviewer.md +357 -0
  394. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +410 -0
  395. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +368 -0
  396. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +2 -2
  397. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +2 -2
  398. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +1 -1
  399. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +2 -0
  400. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +1 -1
  401. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +3 -4
  402. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +2 -2
  403. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +2 -0
  404. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +1 -2
  405. package/bundled/locales/zh-TW/skills/brainstorm-assistant/SKILL.md +110 -14
  406. package/bundled/locales/zh-TW/skills/brainstorm-assistant/guide.md +31 -7
  407. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +3 -1
  408. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +50 -0
  409. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +7 -5
  410. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +1 -1
  411. package/bundled/locales/zh-TW/skills/commands/atdd.md +3 -3
  412. package/bundled/locales/zh-TW/skills/commands/bdd.md +2 -2
  413. package/bundled/locales/zh-TW/skills/commands/brainstorm.md +26 -17
  414. package/bundled/locales/zh-TW/skills/commands/{review.md → code-review.md} +5 -5
  415. package/bundled/locales/zh-TW/skills/commands/derive-all.md +1 -1
  416. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +1 -1
  417. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +2 -3
  418. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +1 -1
  419. package/bundled/locales/zh-TW/skills/commands/derive.md +1 -1
  420. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +2 -2
  421. package/bundled/locales/zh-TW/skills/commands/methodology.md +4 -4
  422. package/bundled/locales/zh-TW/skills/commands/pr.md +1 -1
  423. package/bundled/locales/zh-TW/skills/commands/tdd.md +1 -1
  424. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +1 -1
  425. package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +1 -1
  426. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +456 -0
  427. package/bundled/locales/zh-TW/skills/dev-methodology/guide.md +5 -5
  428. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +296 -0
  429. package/bundled/locales/zh-TW/skills/dev-workflow-guide/SKILL.md +5 -5
  430. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +1 -1
  431. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +1 -1
  432. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +2 -2
  433. package/bundled/locales/zh-TW/skills/logging-guide/SKILL.md +29 -27
  434. package/bundled/locales/zh-TW/skills/migration-assistant/SKILL.md +1 -1
  435. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +3 -1
  436. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +2 -2
  437. package/bundled/locales/zh-TW/skills/reverse-engineer/SKILL.md +1 -1
  438. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +1 -1
  439. package/bundled/locales/zh-TW/skills/spec-derivation/guide.md +7 -8
  440. package/bundled/locales/zh-TW/skills/spec-driven-dev/SKILL.md +2 -2
  441. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +1 -1
  442. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +3 -1
  443. package/bundled/locales/zh-TW/skills/testing-guide/SKILL.md +2 -2
  444. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +2298 -0
  445. package/bundled/locales/zh-TW/skills/workflows/README.md +451 -0
  446. package/bundled/skills/README.md +1 -1
  447. package/bundled/skills/ac-coverage/SKILL.md +17 -7
  448. package/bundled/skills/adr-assistant/SKILL.md +1 -1
  449. package/bundled/skills/agents/code-architect.md +1 -1
  450. package/bundled/skills/agents/doc-writer.md +1 -1
  451. package/bundled/skills/agents/reviewer.md +2 -2
  452. package/bundled/skills/agents/spec-analyst.md +1 -1
  453. package/bundled/skills/agents/test-specialist.md +1 -1
  454. package/bundled/skills/ai-collaboration-standards/SKILL.md +2 -2
  455. package/bundled/skills/ai-friendly-architecture/SKILL.md +2 -2
  456. package/bundled/skills/ai-instruction-standards/SKILL.md +1 -1
  457. package/bundled/skills/atdd-assistant/SKILL.md +7 -0
  458. package/bundled/skills/atdd-assistant/acceptance-criteria-guide.md +1 -1
  459. package/bundled/skills/atdd-assistant/atdd-workflow.md +6 -8
  460. package/bundled/skills/audit-assistant/SKILL.md +2 -2
  461. package/bundled/skills/bdd-assistant/SKILL.md +7 -0
  462. package/bundled/skills/bdd-assistant/guide.md +1 -2
  463. package/bundled/skills/brainstorm-assistant/SKILL.md +133 -11
  464. package/bundled/skills/brainstorm-assistant/guide.md +33 -5
  465. package/bundled/skills/checkin-assistant/SKILL.md +8 -1
  466. package/bundled/skills/ci-cd-assistant/SKILL.md +57 -0
  467. package/bundled/skills/code-review-assistant/SKILL.md +15 -8
  468. package/bundled/skills/commands/COMMAND-FAMILY-OVERVIEW.md +2 -2
  469. package/bundled/skills/commands/COMMAND-INDEX.json +3 -3
  470. package/bundled/skills/commands/README.md +2 -2
  471. package/bundled/skills/commands/ac-coverage.md +1 -1
  472. package/bundled/skills/commands/atdd.md +2 -2
  473. package/bundled/skills/commands/bdd.md +2 -2
  474. package/bundled/skills/commands/brainstorm.md +25 -14
  475. package/bundled/skills/commands/{review.md → code-review.md} +6 -6
  476. package/bundled/skills/commands/derive-all.md +1 -1
  477. package/bundled/skills/commands/derive-atdd.md +1 -1
  478. package/bundled/skills/commands/derive-bdd.md +2 -3
  479. package/bundled/skills/commands/derive-tdd.md +1 -1
  480. package/bundled/skills/commands/derive.md +1 -1
  481. package/bundled/skills/commands/dev-workflow.md +1 -1
  482. package/bundled/skills/commands/journey-test.md +45 -0
  483. package/bundled/skills/commands/methodology.md +4 -4
  484. package/bundled/skills/commands/pr.md +1 -1
  485. package/bundled/skills/commands/skill-builder.md +42 -0
  486. package/bundled/skills/commands/tdd.md +1 -1
  487. package/bundled/skills/dev-methodology/create-methodology.md +1 -1
  488. package/bundled/skills/dev-methodology/guide.md +1 -1
  489. package/bundled/skills/dev-methodology/runtime.md +1 -1
  490. package/bundled/skills/dev-workflow-guide/SKILL.md +3 -3
  491. package/bundled/skills/dev-workflow-guide/workflow-phases.md +3 -3
  492. package/bundled/skills/docs-generator/SKILL.md +3 -3
  493. package/bundled/skills/incident-response-assistant/SKILL.md +2 -2
  494. package/bundled/skills/logging-guide/SKILL.md +38 -2
  495. package/bundled/skills/migration-assistant/SKILL.md +226 -0
  496. package/bundled/skills/observability-assistant/SKILL.md +74 -0
  497. package/bundled/skills/pr-automation-assistant/SKILL.md +5 -1
  498. package/bundled/skills/project-discovery/guide.md +2 -2
  499. package/bundled/skills/push/SKILL.md +1 -1
  500. package/bundled/skills/release-standards/SKILL.md +19 -5
  501. package/bundled/skills/security-assistant/SKILL.md +1 -1
  502. package/bundled/skills/skill-builder/SKILL.md +1 -1
  503. package/bundled/skills/spec-derivation/guide.md +3 -4
  504. package/bundled/skills/spec-driven-dev/SKILL.md +27 -0
  505. package/bundled/skills/sweep/SKILL.md +1 -1
  506. package/bundled/skills/tdd-assistant/SKILL.md +8 -1
  507. package/bundled/skills/testing-guide/SKILL.md +1 -1
  508. package/bundled/skills/testing-guide/testing-theory.md +1 -1
  509. package/bundled/skills/workflows/README.md +2 -2
  510. package/package.json +3 -3
  511. package/src/commands/audit.js +30 -9
  512. package/src/commands/config.js +33 -2
  513. package/src/commands/hitl.js +14 -1
  514. package/src/commands/init.js +110 -58
  515. package/src/commands/quickstart.js +1 -2
  516. package/src/commands/release.js +51 -6
  517. package/src/commands/run-intent.js +9 -0
  518. package/src/commands/spec-split.js +27 -2
  519. package/src/commands/update.js +22 -6
  520. package/src/config/ai-agent-paths.js +3 -1
  521. package/src/i18n/messages.js +3 -102
  522. package/src/missions/MissionManager.js +44 -12
  523. package/src/utils/build-manifest.js +35 -3
  524. package/src/utils/friction-detector.js +71 -22
  525. package/src/utils/health-checker.js +29 -2
  526. package/src/utils/transaction.js +111 -0
  527. package/src/utils/version-promote.js +16 -0
  528. package/standards-registry.json +58 -146
  529. package/bundled/ai/standards/agent-communication-protocol.ai.yaml +0 -42
  530. package/bundled/ai/standards/agent-dispatch.ai.yaml +0 -42
  531. package/bundled/ai/standards/branch-completion.ai.yaml +0 -44
  532. package/bundled/ai/standards/change-batching-standards.ai.yaml +0 -44
  533. package/bundled/ai/standards/execution-history.ai.yaml +0 -42
  534. package/bundled/ai/standards/pipeline-integration-standards.ai.yaml +0 -42
  535. package/bundled/ai/standards/workflow-enforcement.ai.yaml +0 -44
  536. package/bundled/ai/standards/workflow-state-protocol.ai.yaml +0 -43
  537. package/src/commands/flow.js +0 -260
  538. package/src/commands/start.js +0 -372
  539. package/src/commands/sweep.js +0 -151
  540. package/src/commands/workflow.js +0 -681
@@ -0,0 +1,451 @@
1
+ ---
2
+ source: skills/workflows/README.md
3
+ source_version: 1.0.0
4
+ translation_version: 1.0.0
5
+ status: current
6
+ ---
7
+
8
+ # UDS Workflows
9
+
10
+ > **语言**: [English](../../../../skills/workflows/README.md) | 简体中文
11
+
12
+ **Version**: 1.1.0
13
+ **Last Updated**: 2026-01-21
14
+ **Status**: Experimental
15
+
16
+ ---
17
+
18
+ ## 概览
19
+
20
+ UDS Workflows 通过 orchestrate 多个 agent 来完成复杂的开发任务。每个 workflow 定义一连串步骤,其中每个步骤可由 agent 执行,或需要人工介入。
21
+
22
+ ## Workflow YAML 格式
23
+
24
+ ### Schema
25
+
26
+ ```yaml
27
+ name: workflow-name # Unique identifier (kebab-case)
28
+ version: 1.0.0 # Semantic version
29
+ description: | # Multi-line description
30
+ Brief description of the workflow.
31
+
32
+ # Workflow metadata
33
+ metadata:
34
+ author: universal-dev-standards
35
+ category: development # development | review | testing | documentation
36
+ difficulty: intermediate # beginner | intermediate | advanced
37
+ estimated_steps: 6 # Approximate number of steps
38
+
39
+ # Prerequisites
40
+ prerequisites:
41
+ - Project initialized with UDS
42
+ - Git repository configured
43
+ - AI tool with Task support (recommended)
44
+
45
+ # Steps definition
46
+ steps:
47
+ - id: step-1
48
+ name: Step Name
49
+ description: What this step does
50
+ type: agent # agent | manual | conditional
51
+ agent: agent-name # Required if type=agent
52
+ inputs: # Optional: what this step needs
53
+ - user_requirements
54
+ outputs: # Optional: what this step produces
55
+ - analysis_report
56
+
57
+ - id: step-2
58
+ name: Manual Step
59
+ type: manual
60
+ description: Human intervention required
61
+ instructions: |
62
+ Detailed instructions for the manual step.
63
+ checklist:
64
+ - [ ] Item 1
65
+ - [ ] Item 2
66
+
67
+ - id: step-3
68
+ name: Conditional Step
69
+ type: conditional
70
+ condition: analysis_report.has_issues
71
+ then:
72
+ agent: reviewer
73
+ task: Review and fix issues
74
+ else:
75
+ skip: true
76
+
77
+ # Output artifacts
78
+ outputs:
79
+ - name: final_report
80
+ description: Generated documentation
81
+ format: markdown
82
+ ```
83
+
84
+ ### RLM Context 配置 (v1.1.0)
85
+
86
+ Workflow 可纳入受 RLM 启发的 context 处理机制,以应对大型代码库:
87
+
88
+ ```yaml
89
+ # === RLM CONTEXT CONFIGURATION ===
90
+ context-strategy:
91
+ enable-rlm: true # Enable RLM-aware processing
92
+ max-context-per-step: 100000 # Maximum tokens per step
93
+ context-inheritance: selective # full | selective | summary
94
+
95
+ steps:
96
+ - id: parallel-analysis
97
+ type: parallel-agents # NEW: Execute agent on multiple inputs
98
+ agent: code-architect
99
+ foreach: ${modules} # Dynamic iteration variable
100
+ context-mode: focused # minimal | focused | full
101
+ merge-strategy: aggregate # aggregate | sequential | summary
102
+ outputs: [analysis_results]
103
+ ```
104
+
105
+ #### Context 继承模式
106
+
107
+ | 模式 | 说明 | 使用场景 |
108
+ |------|-------------|----------|
109
+ | `full` | 将所有先前的 output 传递给下一个步骤 | 顺序分析 |
110
+ | `selective` | 仅传递指定的 output | 内存效率高的 pipeline |
111
+ | `summary` | 传递 output 的摘要版本 | 大规模处理 |
112
+
113
+ #### 步骤的 Context 模式
114
+
115
+ | 模式 | 说明 | Token 用量 |
116
+ |------|-------------|-------------|
117
+ | `minimal` | 仅必要的 context | 低 |
118
+ | `focused` | 与当前项目相关的 context | 中 |
119
+ | `full` | 完整可用的 context | 高 |
120
+
121
+ #### 并行结果的 Merge 策略
122
+
123
+ | 策略 | 说明 | Output 格式 |
124
+ |----------|-------------|---------------|
125
+ | `aggregate` | 将所有结果合并为数组 | 结果数组 |
126
+ | `sequential` | 维持处理顺序 | 有序列表 |
127
+ | `summary` | AI 生成的所有结果摘要 | 单一摘要 |
128
+
129
+ ### 步骤类型
130
+
131
+ | 类型 | 说明 | 执行方式 |
132
+ |------|-------------|-----------|
133
+ | `agent` | 由 UDS agent 执行 | 自动 |
134
+ | `manual` | 需要人工介入 | 交互式 |
135
+ | `conditional` | 依条件分支 | 视条件而定 |
136
+ | `parallel-agents` | 对多个输入并行执行 agent | 并行 (v1.1.0) |
137
+
138
+ #### Parallel-Agents 步骤配置 (v1.1.0)
139
+
140
+ ```yaml
141
+ - id: parallel-module-analysis
142
+ name: Analyze Modules in Parallel
143
+ type: parallel-agents
144
+ agent: code-architect
145
+ foreach: ${modules} # Variable containing items to iterate
146
+ context-mode: focused # minimal | focused | full
147
+ merge-strategy: aggregate # How to combine results
148
+ max-concurrent: 3 # Optional: limit concurrent executions
149
+ timeout: 300 # Optional: timeout per item (seconds)
150
+ inputs: # Optional: additional inputs
151
+ - project_context
152
+ outputs:
153
+ - module_analysis_results
154
+ ```
155
+
156
+ ## 内置 Workflows
157
+
158
+ | Workflow | 步骤数 | 说明 |
159
+ |----------|-------|-------------|
160
+ | [integrated-flow](../../../../skills/workflows/integrated-flow.workflow.yaml) | 8 | 完整的 ATDD → SDD → BDD → TDD 循环 |
161
+ | [feature-dev](../../../../skills/workflows/feature-dev.workflow.yaml) | 6 | 功能开发 workflow |
162
+ | [code-review](../../../../skills/workflows/code-review.workflow.yaml) | 4 | 全面性 code review workflow |
163
+ | [large-codebase-analysis](../../../../skills/workflows/large-codebase-analysis.workflow.yaml) | 4 | 针对 50+ 文件项目的 RLM 强化 workflow |
164
+
165
+ ## 用法
166
+
167
+ ### CLI 安装
168
+
169
+ ```bash
170
+ # List available workflows
171
+ uds workflow list
172
+
173
+ # Install specific workflow
174
+ uds workflow install integrated-flow
175
+
176
+ # Install all workflows
177
+ uds workflow install --all
178
+ ```
179
+
180
+ ### 执行
181
+
182
+ Workflow 采逐步执行。对于支持 Task tool 的工具(Claude Code、OpenCode):
183
+
184
+ ```
185
+ User: Start the integrated-flow workflow for user authentication
186
+
187
+ AI: Starting Integrated Development Flow...
188
+
189
+ Step 1/8: Specification Workshop (spec-analyst)
190
+ [Agent executes analysis...]
191
+
192
+ Step 2/8: Spec Proposal (spec-analyst)
193
+ [Agent drafts proposal...]
194
+
195
+ Step 3/8: Spec Review (manual)
196
+ Please review the specification:
197
+ - [ ] Requirements are clear
198
+ - [ ] Acceptance criteria defined
199
+ - [ ] Risks identified
200
+
201
+ [User confirms...]
202
+
203
+ Step 4/8: Discovery (test-specialist)
204
+ [Agent identifies test scenarios...]
205
+
206
+ ...continues...
207
+ ```
208
+
209
+ ### 不支持 Task 的工具
210
+
211
+ Workflow 会转换为引导式检查清单:
212
+
213
+ ```markdown
214
+ ## Integrated Development Flow
215
+
216
+ ### Step 1: Specification Workshop
217
+ **Agent**: spec-analyst
218
+ **Task**: Analyze requirements and identify acceptance criteria
219
+
220
+ [Copy this to your AI assistant]
221
+
222
+ ### Step 2: Spec Proposal
223
+ ...
224
+ ```
225
+
226
+ ## 创建自定义 Workflow
227
+
228
+ ### 1. 创建 Workflow 文件
229
+
230
+ ```bash
231
+ mkdir -p .claude/workflows
232
+ touch .claude/workflows/my-workflow.workflow.yaml
233
+ ```
234
+
235
+ ### 2. 定义 Workflow
236
+
237
+ ```yaml
238
+ name: my-custom-workflow
239
+ version: 1.0.0
240
+ description: Custom workflow for my project
241
+
242
+ steps:
243
+ - id: analyze
244
+ name: Analyze Requirements
245
+ type: agent
246
+ agent: spec-analyst
247
+ outputs: [requirements_doc]
248
+
249
+ - id: implement
250
+ name: Implementation
251
+ type: manual
252
+ description: Implement based on analysis
253
+
254
+ - id: review
255
+ name: Code Review
256
+ type: agent
257
+ agent: reviewer
258
+ inputs: [code_changes]
259
+ ```
260
+
261
+ ## Workflow vs Agent vs Skill
262
+
263
+ | 维度 | Workflow | Agent | Skill |
264
+ |--------|----------|-------|-------|
265
+ | **目的** | orchestrate 多步骤流程 | 执行自主任务 | 提供知识/context |
266
+ | **组成** | 包含多个 agent | 使用 skill 作为 context | 独立运作 |
267
+ | **状态** | 追踪跨步骤的进度 | 单一任务状态 | 无状态 |
268
+ | **用户参与** | 可包含人工步骤 | 最少 | 无 |
269
+
270
+ ## 以 Wave 为基础的并行执行 (v1.2.0)
271
+
272
+ Workflow 中的步骤可分组为 **wave** 以进行并行执行。同一 wave 中的步骤彼此独立,可由不同的 sub-agent 并行执行。Wave 之间顺序执行——wave N 中的所有步骤都必须完成,wave N+1 才会开始。
273
+
274
+ ### Wave 配置
275
+
276
+ ```yaml
277
+ steps:
278
+ # Wave 1: Independent analysis steps (run in parallel)
279
+ - id: analyze-requirements
280
+ name: Analyze Requirements
281
+ type: agent
282
+ agent: spec-analyst
283
+ wave: 1
284
+ outputs: [requirements_analysis]
285
+
286
+ - id: analyze-architecture
287
+ name: Analyze Architecture
288
+ type: agent
289
+ agent: code-architect
290
+ wave: 1
291
+ outputs: [architecture_analysis]
292
+
293
+ # Wave 2: Depends on wave 1 outputs (barrier point)
294
+ - id: design
295
+ name: Design Solution
296
+ type: agent
297
+ agent: code-architect
298
+ wave: 2
299
+ inputs: [requirements_analysis, architecture_analysis]
300
+ outputs: [design_doc]
301
+
302
+ # Manual steps are automatic barrier points
303
+ - id: review
304
+ name: Review Design
305
+ type: manual
306
+ wave: 3
307
+ ```
308
+
309
+ ### Wave 规则
310
+
311
+ | 规则 | 说明 |
312
+ |------|-------------|
313
+ | **独立性** | 同一 wave 中的步骤不得彼此相依 |
314
+ | **Barrier** | wave N 中的所有步骤必须完成,wave N+1 才会开始 |
315
+ | **Manual barrier** | `manual` 类型步骤为自动 barrier 点 |
316
+ | **选填字段** | `wave` 字段为选填;若未指定,步骤将顺序执行 |
317
+ | **向后兼容** | 没有 wave 字段的 workflow 仍如以往运作 |
318
+
319
+ ---
320
+
321
+ ## 步骤验证 Pipeline (v1.2.0)
322
+
323
+ 每个 workflow 步骤可包含两层验证,灵感来自 CrewAI 的验证 pipeline 与 DSPy 的 metric 函数。
324
+
325
+ ### 两层验证
326
+
327
+ ```yaml
328
+ steps:
329
+ - id: generate-spec
330
+ name: Generate Specification
331
+ type: agent
332
+ agent: spec-analyst
333
+ outputs: [spec_document]
334
+ validation:
335
+ # Layer 1: Deterministic (always runs first)
336
+ deterministic:
337
+ - check: file_exists
338
+ path: "docs/specs/{{spec_id}}.md"
339
+ - check: contains_sections
340
+ sections: [Summary, Motivation, "Acceptance Criteria"]
341
+ - check: ac_format
342
+ pattern: "Given .+, When .+, Then .+"
343
+
344
+ # Layer 2: Semantic (only runs if Layer 1 passes)
345
+ semantic:
346
+ - check: consistency
347
+ description: AC covers all requirements mentioned in Motivation
348
+ - check: completeness
349
+ description: No TODO or placeholder sections remain
350
+ ```
351
+
352
+ ### 验证规则
353
+
354
+ | Layer | 类型 | 执行时机 | 失败时 |
355
+ |-------|------|-------------|------------|
356
+ | **Layer 1** | Deterministic | 永远最先执行 | 立即停止,显示修正选项 |
357
+ | **Layer 2** | Semantic | Layer 1 通过后 | 警告,建议改善 |
358
+
359
+ **Fail-fast 原则**:若 deterministic 验证失败,semantic 检查将完全跳过。这可避免在根本上已损坏的 output 上浪费时间进行质量评估。
360
+
361
+ ---
362
+
363
+ ## Agent Communication Protocol (v1.2.0)
364
+
365
+ 定义 agent 在 workflow 内如何交换数据。
366
+
367
+ ### 三个通信层
368
+
369
+ | Layer | 机制 | 说明 |
370
+ |-------|-----------|-------------|
371
+ | **Artifact passing** | 以文件为基础 | 步骤产生文件作为 output;下游步骤通过文件路径读取 |
372
+ | **Reducer patterns** | append / replace / merge | 多个 output 如何合并 |
373
+ | **Context isolation** | 每步骤干净启动 | 每个 agent 步骤以干净 context 启动,仅接收指定的 input |
374
+
375
+ ### Reducer 模式
376
+
377
+ ```yaml
378
+ steps:
379
+ - id: collect-reviews
380
+ type: parallel-agents
381
+ agent: reviewer
382
+ foreach: ${modules}
383
+ outputs: [review_results]
384
+ reducer: append # Collect all results into array
385
+
386
+ - id: merge-configs
387
+ type: agent
388
+ agent: code-architect
389
+ inputs: [review_results]
390
+ reducer: merge # Deep merge results into single object
391
+ ```
392
+
393
+ | 模式 | 说明 | 使用场景 |
394
+ |---------|-------------|----------|
395
+ | `append` | 将所有结果收集为有序列表 | 并行 review、多模块分析 |
396
+ | `replace` | 后到的 output 覆写先前的 | Config 覆写、最新者胜 |
397
+ | `merge` | 将结果深度合并为单一对象 | 结合部分分析 |
398
+
399
+ ### Context Isolation
400
+
401
+ 每个 agent 步骤以**干净 context** 启动,仅包含:
402
+ 1. 该步骤声明的 `inputs`(来自前一步骤的 output)
403
+ 2. 该 agent 的 skill(来自 AGENT.md 的 `skills` 字段)
404
+ 3. Workflow 共享的 `prerequisites`
405
+
406
+ 这可防止 context 污染,并确保 agent 行为可重现。
407
+
408
+ ---
409
+
410
+ ## 最佳实践
411
+
412
+ ### 该做的
413
+
414
+ - 将复杂任务拆解为离散步骤
415
+ - 为关键决策纳入人工检查点
416
+ - 为每个步骤定义清楚的 input/output
417
+ - 使用 conditional 步骤进行错误处理
418
+ - 清楚记录 prerequisites
419
+
420
+ ### 不该做的
421
+
422
+ - 不要创建过长的 workflow(>10 步骤)
423
+ - 不要跳过 review/verification 步骤
424
+ - 不要假设所有工具都支持自动执行
425
+ - 不要把步骤切得太细
426
+
427
+ ---
428
+
429
+ ## 相关资源
430
+
431
+ - [Agents 文档](../agents/README.md)
432
+ - [Skills 文档](../README.md)
433
+ - [方法论系统](../dev-methodology/SKILL.md)
434
+
435
+ ---
436
+
437
+ ## 版本历史
438
+
439
+ | Version | Date | Changes |
440
+ |---------|------|---------|
441
+ | 1.2.0 | 2026-03-17 | Added wave-based parallel execution, step validation pipeline, agent communication protocol |
442
+ | 1.1.0 | 2026-01-21 | Added RLM context configuration, parallel-agents step type, large-codebase-analysis workflow |
443
+ | 1.0.0 | 2026-01-20 | Initial release |
444
+
445
+ ---
446
+
447
+ ## License
448
+
449
+ 本文档以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 释出。
450
+
451
+ **来源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
@@ -1,8 +1,8 @@
1
1
  ---
2
2
  source: ../../CHANGELOG.md
3
- source_version: 5.16.0
4
- translation_version: 5.16.0
5
- last_synced: 2026-06-08
3
+ source_version: 6.0.0
4
+ translation_version: 6.0.0
5
+ last_synced: 2026-07-06
6
6
  status: current
7
7
  ---
8
8
 
@@ -17,6 +17,81 @@ status: current
17
17
 
18
18
  ## [Unreleased]
19
19
 
20
+ ## [6.0.0] - 2026-07-06
21
+
22
+ > ⚠️ **重大版本(Major release)。** 包含一項 breaking 更名,並移除 8 個已棄用的機器可讀標準與 4 個已棄用的 CLI 命令(皆自 5.4.0 起帶有「將於 6.0.0 移除」告示)。**請參閱 [v6 遷移指南](docs/MIGRATION-v6.md)**([English](../../docs/MIGRATION-v6.md) | [简体中文](../zh-CN/docs/MIGRATION-v6.md))。
23
+
24
+ ### 變更 — BREAKING
25
+
26
+ - **`review` 命令/skill 更名為 `code-review`**(T1)。`/review` 的呼叫端必須遷移至 `/code-review`;flow-id `review-flow` → `code-review-flow`。見遷移指南 §1。
27
+
28
+ ### 移除 — BREAKING(自 5.4.0 起排定)
29
+
30
+ - **移除 8 個已棄用的 `.ai.yaml` 標準 stub**(runtime 已依 XSPEC-086/095 / DEC-049 於 5.4.0 移至 adoption layer):`agent-communication-protocol`、`agent-dispatch`、`branch-completion`、`change-batching-standards`、`execution-history`、`pipeline-integration-standards`、`workflow-enforcement`、`workflow-state-protocol`。人類可讀的 `core/*.md` 文件保留作為參考(現列於 registry-check 的 REFERENCE_ONLY 清單);registry 條目已移除。見遷移指南 §2。
31
+ - **移除 4 個已棄用的 CLI 命令**:`uds start` / `uds mission:*`、`uds workflow:*`、`uds flow:*`、`uds sweep`(orchestration 屬 adoption layer 職責;`/sweep` skill 取代 `uds sweep`)。並清理引用已移除命令的死 i18n 鍵與過時的 in-CLI 提示(`config` next-steps、`quickstart` recipes)。見遷移指南 §3。
32
+
33
+ ### 新增 — 新標準(coverage-roadmap waves + 旗艦標準)
34
+
35
+ - **領域與生命週期標準補齊**:product — `prd-standards`、`product-metrics`、`user-story-mapping`(XSPEC-069);infra — `container-image`、`secret-management`、`iac-design`(XSPEC-065);SRE — `incident-response`、`slo-sli`、`runbook`(XSPEC-063);data engineering — `data-pipeline`、`schema-evolution`、`data-contract`(XSPEC-068);compliance — `audit-trail`、`pii-classification`(XSPEC-066)。
36
+ - **旗艦標準**:`verification-oracle`(XSPEC-256)、`model-provenance`(XSPEC-255)、`resource-cost-boundary`(XSPEC-277)。
37
+ - **`user-journey-testing`** 以一級標準(first-class standard)身分發布(ai/standards + core + zh-TW + registry)。
38
+ - **`logging-standards` 強制事件目錄(mandatory events catalog)**(XSPEC-234)。
39
+
40
+ ### 新增 — UDS Stage 2 硬化(T5–T16)
41
+
42
+ - **Canonical AC 註記**(T5):涵蓋 `acceptance-criteria-traceability` 與 worked examples。
43
+ - **附出處的量化門檻**(T8):`browser-compatibility` 95%/90% gate、`checkin` code-smell、`accessibility` session-timeout、`code-review` PR 大小/回應時間 + 大量變更例外、`project-context-memory` 7 天陳舊度、`developer-memory` 退役、`privacy` DPIA「large scale」。
44
+ - **Failure Handling 章節**(T7):`git-worktree` 暫時性失敗重試、`reverse-engineering` 升級(escalation)、`forward-derivation` 復原。
45
+ - **跨職能交接**(T16):`security-testing` finding-remediation 生命週期、`pii-classification` 發現與交接契約。
46
+ - **Glossary 術語正規化**:作為 canonical 真實來源(T6)。
47
+ - **CLI 硬化**(T11/T12):Mission `FAILED` 終止狀態 + resume 防護、具 rollback 的 transactional `init`、`hitl`/`run`/`release`/config 的輸入驗證。
48
+
49
+ ### 新增 — 遷移與重構完整性家族
50
+
51
+ - `migration-assistant` 切換後(post-cutover)資料對帳(XSPEC-284 P0)、狀態機與時序對等(XSPEC-287);`full-coverage-testing` 遷移錯誤路徑完整性(XSPEC-288);`performance-standards` 遷移非功能對等(XSPEC-286)。
52
+
53
+ ### 新增 — 工具與工作流程
54
+
55
+ - **`/brainstorm` v4 的 BQS v1 品質契約**(XSPEC-296)。
56
+ - **`ci-cd-assistant` skill 新增 CI Job Orchestration Patterns** — trigger 分離、共用資源序列化、change-detection gating、advisory vs gating、`npm ci` `EUSAGE` 疑難排解(UDS #126 / XSPEC-300)。
57
+ - **`pipeline-security-gates` 新增部署前 attestation 驗證閘門**。
58
+ - **release 流程新增發版前 issue/PR triage 閘門**(XSPEC-265)。
59
+ - `release verify` 現在使用已記錄的 manifest checksum。
60
+ - `/journey-test` 與 `/skill-builder` 註冊為正式命令。
61
+ - 可選的 model-tier 註記(R6,XSPEC-270 Work Package A)。
62
+ - `sync-standard` 四層同步工具;Phase 2 內容覆蓋稽核 metadata。
63
+
64
+ ### 新增 — 事故驅動的防漂移與可測試性
65
+
66
+ - **`refactoring-standards` Semantic Duplication 與 Copy-Drift**(#142):命名 Copy-Drift 反模式(同一領域事實在多處重複實作,或儲存的衍生彙總值與其來源之間沒有強制綁定——文字型重複度量測不到),以及 Single-Source-of-Truth / Derive-Don't-Duplicate 對策(每個事實一個單元、以推導取代儲存、儲存的彙總值在單一收斂點重算、以 golden + architecture 測試鎖住),另加遷移用的 Intentional-Divergence Registry。
67
+ - **`mock-boundary` 可注入的背景執行**(#143):將 in-process fire-and-forget 工作(`Task.Run`、未 await 的 promise、`setTimeout`、goroutine、executor)視為如同時鐘般的可注入接縫——production 保留真實 fire-and-forget,測試 dispatcher 則 inline 執行並追蹤 task 以達成確定性完成;新增 Poll/Sleep-for-Background-Result 反模式與 no-poll/sleep 規則。
68
+
69
+ ### 變更
70
+
71
+ - **API versioning 與 deprecation 整併為單一真實來源** — producer 端的 API-versioning 內容併入 `api-design-standards`;不一致的 deprecation 時程已調和(XSPEC-298 R8)。
72
+ - **`versioning` 新增 Deployment Version Identity 章節**,含 build-metadata 判別符(discriminator)注意事項(XSPEC-298 R1)。
73
+ - **`versioning` 建置身分與多語言 versioning**(XSPEC-298 R2/R3):.NET/JVM/多語言專案的 git-height 推導 versioning(MinVer / Nerdbank.GitVersioning / GitVersion);建置身分升級為需求——已部署服務 MUST 經由 `/version`|`/health` 揭露 `version + commit sha + build time`,且 Phase-5 驗證 MUST 斷言 sha 與已部署 artifact 相符(#138)。
74
+
75
+ ### 棄用
76
+
77
+ - **6 個 workflow skill** 標記為 `reference` 並附可見的棄用告示;已棄用的 runtime 命令加上結構化 `@superseded-by` 指標(XSPEC-291 §4)。
78
+
79
+ ### 修正
80
+
81
+ - **`uds audit` 假陽性**:`options/` 檔案被誤報 missing(health check 現在會遞迴進子目錄)、CP950 主控台亂碼、非 TTY 崩潰(#115);unused-standard 偵測改以 canonical id 而非檔名比對(#125)。
82
+ - **Bundle ⇄ source 對等已恢復** — 25 個標準已同步進 `.standards/` self-adoption tree。
83
+ - 多項 docs/i18n 完整性修正:過時的標準/skill/命令數量、壞掉的 locale 交叉連結、command/skill 索引重新產生、anchor-slugger 與 table-parity 路徑。
84
+
85
+ ## [5.17.0] - 2026-06-08
86
+
87
+ ### 新增 — 可執行 SDD 一致性與 AC 格式擴充(XSPEC-262/263/264)
88
+
89
+ - **`/sdd analyze` 跨 artifact 一致性(XSPEC-262,`scripts/sdd-analyze.ts`)**:acceptance-criteria-traceability + forward-derivation single-spine 的可執行面。7 類信號——孤兒測試/未覆蓋/not_implemented/跨 spec AC 衝突/孤兒 .feature/AC 無 scenario/手冊↔E2E drift(`T-NNN`,實現 XSPEC-260 R5)。`npm run sdd:analyze`;12 bats 測試。
90
+ - **EARS 記法作為可選 AC 格式(XSPEC-263)**:spec-driven-development v2.3.0 加 5 種 EARS 模板;schema 加可選 `ears` 欄位(given/when/then 由 required 放寬、向後相容)。GWT 維持預設首選。
91
+ - **結構化 Bugfix 規格模板(XSPEC-264)**:sdd-guide 決策樹細分 trivial vs regression-prone,新增輕量 `<BUG-ID>.bugfix.md` 模板(current/expected/**unchanged** + root-cause + regression-test 當 AC)。
92
+
93
+ > 註:Bugfix 模板的 sdd-guide locale(zh-TW/zh-CN)同步交 XSPEC-248 迴路(既有 locale drift)。
94
+
20
95
  ## [5.16.0] - 2026-06-08
21
96
 
22
97
  ### 新增 — 測試推導鏈延伸至使用者指南(XSPEC-260)
@@ -484,9 +559,9 @@ status: current
484
559
  - `docs/CLI-INIT-OPTIONS.md`
485
560
  - `skills/commands/bdd.md`
486
561
  - `skills/commands/methodology.md`
487
- - `skills/methodology-system/SKILL.md`
488
- - `skills/methodology-system/create-methodology.md`
489
- - `skills/methodology-system/runtime.md`
562
+ - `skills/dev-methodology/SKILL.md`
563
+ - `skills/dev-methodology/create-methodology.md`
564
+ - `skills/dev-methodology/runtime.md`
490
565
  - **文件**:更新穩定版本參考從 3.3.0 至 3.4.2
491
566
 
492
567
  ## [3.5.0-beta.10] - 2026-01-12
@@ -14,7 +14,7 @@ status: current
14
14
 
15
15
  Universal Development Standards 是一個語言無關、框架無關的文件化標準框架。它提供:
16
16
 
17
- - **核心規範** (`core/`):125 個基礎開發標準
17
+ - **核心規範** (`core/`):145 個基礎開發標準
18
18
  - **AI 技能** (`skills/`):用於 AI 輔助開發的 Claude Code 技能
19
19
  - **CLI 工具** (`cli/`):用於採用標準的 Node.js CLI
20
20
  - **整合** (`integrations/`):各種 AI 工具的配置
@@ -2,7 +2,8 @@
2
2
  source: ../../MAINTENANCE.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-04-22
5
+ last_synced: 2026-06-10
6
+ source_hash: ec4410b9245b
6
7
  status: current
7
8
  ---
8
9
 
@@ -20,4 +21,26 @@ status: current
20
21
 
21
22
  日常維護請遵循 `CLAUDE.md` 中的驗證步驟(§Post-Modification Verification)。
22
23
 
23
- - [歸檔版本 v1.1.0](../../docs/archive/MAINTENANCE-v1.md)原始獨立指南
24
+ - 歸檔版本 v1.1.0 — 原始獨立指南(歷史檔案已移除)
25
+
26
+ ## Bundle-Source 一致性(XSPEC-072 / DEC-045)
27
+
28
+ 每次發行前,請確認 bundle 一致性檢查通過:
29
+
30
+ ```bash
31
+ cd cli
32
+ npm run prepack # 從 ai/ 重新產生 cli/bundled/
33
+ npm run check:bundle-parity # 必須以 exit 0 結束(source == bundled,扣除排除項)
34
+ ```
35
+
36
+ 若一致性檢查失敗:
37
+ 1. **`.standards/` 中的新檔案不在 `ai/`** → 複製至 `ai/standards/`(若供採用者使用),或加入 `cli/scripts/bundle-exclude.json`(若僅供 UDS 內部使用)
38
+ 2. **`ai/` 中的新檔案不在 `.standards/`** → 複製至 `.standards/`
39
+ 3. **新選項檔案** → 確保同時存在於 `ai/options/<cat>/` 與 `.standards/options/<cat>/`
40
+
41
+ `scripts/bump-version.sh` 目前**不會**自動執行一致性檢查 — 請在標記版本前手動執行。GHA 工作流程 `bundle-parity.yml` 會在 PR 和推送至 `main` 時發生任何不符時強制失敗。
42
+
43
+ ## 翻譯版本
44
+
45
+ - [繁體中文](./MAINTENANCE.md)
46
+ - [简体中文](../zh-CN/MAINTENANCE.md)
@@ -1,8 +1,9 @@
1
1
  ---
2
2
  source: ../../README.md
3
- source_version: 5.2.0
4
- translation_version: 5.2.0
5
- last_synced: 2026-04-22
3
+ source_version: 5.17.0
4
+ translation_version: 5.17.0
5
+ last_synced: 2026-06-10
6
+ source_hash: 651c07df0abe
6
7
  status: current
7
8
  ---
8
9
 
@@ -14,7 +15,7 @@ status: current
14
15
 
15
16
  > **語言**: [English](../../README.md) | 繁體中文 | [简体中文](../zh-CN/README.md)
16
17
 
17
- **版本**: 5.16.0 | **發布日期**: 2026-05-28 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
18
+ **版本**: 6.0.0 | **發布日期**: 2026-07-06 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
18
19
 
19
20
  語言無關、框架無關的軟體專案文件標準。透過 AI 原生工作流,確保不同技術堆疊之間的一致性、品質和可維護性。
20
21
 
@@ -56,6 +57,18 @@ npx universal-dev-standards init
56
57
  >
57
58
  > 另請參閱:[每日開發工作流程指南](adoption/DAILY-WORKFLOW-GUIDE.md)
58
59
 
60
+ ### 📚 文件
61
+
62
+ | 我想要... | 文件 |
63
+ |---|---|
64
+ | **UDS 新手?** 5 分鐘快速入門 | [docs/user/GETTING-STARTED.md](../../docs/user/GETTING-STARTED.md) |
65
+ | 依 Tier 和分類瀏覽所有 54 個 Skills | [docs/user/SKILLS-INDEX.md](../../docs/user/SKILLS-INDEX.md) |
66
+ | 查看所有斜線命令 | [docs/user/COMMANDS-INDEX.md](../../docs/user/COMMANDS-INDEX.md) |
67
+ | 快速參考卡 | [docs/user/CHEATSHEET.md](../../docs/user/CHEATSHEET.md) |
68
+ | 常見問題 | [docs/user/FAQ.md](../../docs/user/FAQ.md) |
69
+ | 疑難排解 | [docs/user/TROUBLESHOOTING.md](../../docs/user/TROUBLESHOOTING.md) |
70
+ | 了解 UDS 術語 | [docs/user/GLOSSARY.md](../../docs/user/GLOSSARY.md) |
71
+
59
72
  ---
60
73
 
61
74
  ## ✨ 功能特色
@@ -63,9 +76,9 @@ npx universal-dev-standards init
63
76
  <!-- UDS_STATS_TABLE_START -->
64
77
  | 類別 | 數量 | 說明 |
65
78
  |----------|-------|-------------|
66
- | **核心標準** | 127 | 通用開發準則 |
67
- | **AI Skills** | 54 | 互動式技能 |
68
- | **斜線命令** | 48 | 快速操作 |
79
+ | **核心標準** | 146 | 通用開發準則 |
80
+ | **AI Skills** | 55 | 互動式技能 |
81
+ | **斜線命令** | 51 | 快速操作 |
69
82
  | **CLI 指令** | 6 | list, init, configure, check, update, skills |
70
83
  <!-- UDS_STATS_TABLE_END -->
71
84
 
@@ -141,10 +154,10 @@ uds uninstall # 從專案移除標準
141
154
 
142
155
  使用 `uds config` 管理您的偏好設定:
143
156
 
144
- | 參數 | 指令範例 | 說明 |
157
+ | 參數 | 指令 | 說明 |
145
158
  | :--- | :--- | :--- |
146
159
  | **提交語言** | `uds config --lang zh-TW` | 設定 AI 提交訊息的偏好語言 |
147
- | **標準等級** | `uds init --level 2` | 選擇採用深度 (1: 基本, 3: 全面) |
160
+ | **標準** | `uds init` | 安裝所有可用標準 |
148
161
  | **工具模式** | `uds config --mode skills` | 在 Skills、Standards 或兩者之間切換 |
149
162
 
150
163
  ---
@@ -13,7 +13,7 @@ status: current
13
13
  <!-- UDS_SUPPORTED_VERSIONS_START -->
14
14
  | 版本 | 支援狀態 |
15
15
  |------|--------|
16
- | 5.15.0 | ✅ 最新正式版 |
16
+ | 5.17.0 | ✅ 最新正式版 |
17
17
  | < 5.0.0 | ❌ 已終止支援 |
18
18
  <!-- UDS_SUPPORTED_VERSIONS_END -->
19
19