universal-dev-standards 6.14.0-beta.9 → 6.14.1-beta.1

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 (721) hide show
  1. package/bin/uds.js +12 -1
  2. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  3. package/bundled/ai/standards/commit-message.ai.yaml +12 -2
  4. package/bundled/ai/standards/mock-boundary.ai.yaml +138 -2
  5. package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
  6. package/bundled/ai/standards/turn-completion-integrity.ai.yaml +6 -2
  7. package/bundled/core/commit-message-guide.md +22 -19
  8. package/bundled/core/mock-boundary.md +70 -2
  9. package/bundled/core/secret-management-standards.md +13 -1
  10. package/bundled/core/turn-completion-integrity.md +8 -2
  11. package/bundled/extensions/locales/zh-tw.md +19 -19
  12. package/bundled/hooks/check-dangerous-cmd.mjs +161 -26
  13. package/bundled/hooks/check-logging-standard.mjs +35 -6
  14. package/bundled/hooks/validate-commit-msg.mjs +317 -28
  15. package/bundled/locales/zh-CN/CHANGELOG.md +2323 -1099
  16. package/bundled/locales/zh-CN/CLAUDE.md +987 -101
  17. package/bundled/locales/zh-CN/README.md +3 -3
  18. package/bundled/locales/zh-CN/SECURITY.md +4 -3
  19. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  20. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
  21. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  22. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
  23. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
  24. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
  25. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
  26. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  27. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  28. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  29. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  30. package/bundled/locales/zh-CN/core/accessibility-standards.md +871 -62
  31. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  32. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  33. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  34. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  35. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  36. package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +311 -72
  37. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  38. package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
  39. package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
  40. package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
  41. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  42. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  43. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  44. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  45. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  46. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  47. package/bundled/locales/zh-CN/core/changelog-standards.md +485 -63
  48. package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
  49. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  50. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  51. package/bundled/locales/zh-CN/core/code-review-checklist.md +37 -23
  52. package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
  53. package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
  54. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  55. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  56. package/bundled/locales/zh-CN/core/deprecation-standards.md +155 -40
  57. package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
  58. package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
  59. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  60. package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
  61. package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
  62. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  63. package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
  64. package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
  65. package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
  66. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  67. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  68. package/bundled/locales/zh-CN/core/feature-flag-standards.md +202 -57
  69. package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
  70. package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
  71. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  72. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  73. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  74. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  75. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  76. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  77. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  78. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  79. package/bundled/locales/zh-CN/core/mock-boundary.md +74 -6
  80. package/bundled/locales/zh-CN/core/mutation-testing.md +45 -6
  81. package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
  82. package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
  83. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  84. package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
  85. package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
  86. package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
  87. package/bundled/locales/zh-CN/core/project-structure.md +550 -170
  88. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  89. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  90. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  91. package/bundled/locales/zh-CN/core/retrospective-standards.md +215 -22
  92. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  93. package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
  94. package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
  95. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  96. package/bundled/locales/zh-CN/core/security-standards.md +169 -16
  97. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  98. package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
  99. package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
  100. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  101. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  102. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  103. package/bundled/locales/zh-CN/core/supply-chain-security-standards.md +159 -32
  104. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  105. package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
  106. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  107. package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
  108. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  109. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  110. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  111. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  112. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  113. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  114. package/bundled/locales/zh-CN/core/turn-completion-integrity.md +8 -6
  115. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  116. package/bundled/locales/zh-CN/core/versioning.md +737 -73
  117. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  118. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  119. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  120. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +2 -1
  121. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  122. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
  123. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
  124. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  125. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
  126. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  127. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
  128. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  129. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  130. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +2 -0
  131. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  132. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  133. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  134. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  135. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  136. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  137. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  138. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  139. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  140. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  141. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  142. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  143. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  144. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  145. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  146. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  147. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  148. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  149. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  150. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  151. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  152. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  153. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  154. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  155. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  156. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  157. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  158. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  159. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  160. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  161. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  162. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  163. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  164. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  165. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  166. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  167. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  168. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  169. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  170. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  171. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  172. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  173. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  174. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  175. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  176. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  177. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  178. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  179. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  180. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  181. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  182. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  183. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  184. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  185. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  186. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  187. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  188. package/bundled/locales/zh-CN/skills/README.md +2 -1
  189. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  190. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  191. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  192. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  193. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  194. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  195. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  196. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  197. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  198. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  199. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  200. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  201. package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +217 -137
  202. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  203. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  204. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  205. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  206. package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +148 -132
  207. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  208. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  209. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  210. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  211. package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +122 -121
  212. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  213. package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
  214. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  215. package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
  216. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  217. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  218. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  219. package/bundled/locales/zh-CN/skills/code-review-assistant/guide.md +119 -45
  220. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  221. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  222. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  223. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  224. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  225. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  226. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  227. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  228. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  229. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  230. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  231. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  232. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  233. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  234. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  235. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  236. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  237. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  238. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  239. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  240. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  241. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  242. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  243. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  244. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  245. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  246. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  247. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  248. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  249. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  250. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  251. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  252. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  253. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  254. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  255. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  256. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  257. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  258. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  259. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  260. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  261. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  262. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  263. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  264. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  265. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  266. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  267. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  268. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  269. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +4 -4
  270. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  271. package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
  272. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  273. package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
  274. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  275. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  276. package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +4 -2
  277. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  278. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  279. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  280. package/bundled/locales/zh-CN/skills/docs-generator/guide.md +8 -7
  281. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  282. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  283. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  284. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  285. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  286. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  287. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  288. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  289. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  290. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  291. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  292. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  293. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  294. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  295. package/bundled/locales/zh-CN/skills/project-discovery/guide.md +158 -157
  296. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  297. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  298. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  299. package/bundled/locales/zh-CN/skills/refactoring-assistant/guide.md +172 -171
  300. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  301. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  302. package/bundled/locales/zh-CN/skills/release-standards/guide.md +51 -43
  303. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  304. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  305. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  306. package/bundled/locales/zh-CN/skills/requirement-assistant/guide.md +88 -79
  307. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  308. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  309. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  310. package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +2 -2
  311. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  312. package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
  313. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  314. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  315. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  316. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  317. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  318. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  319. package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +2 -2
  320. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  321. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  322. package/bundled/locales/zh-CN/skills/tdd-assistant/guide.md +217 -156
  323. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  324. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  325. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  326. package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +25 -12
  327. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  328. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  329. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  330. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  331. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  332. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  333. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  334. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  335. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  336. package/bundled/locales/zh-TW/CHANGELOG.md +2323 -1128
  337. package/bundled/locales/zh-TW/CLAUDE.md +962 -76
  338. package/bundled/locales/zh-TW/README.md +3 -3
  339. package/bundled/locales/zh-TW/SECURITY.md +4 -3
  340. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  341. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
  342. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  343. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
  344. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
  345. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
  346. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
  347. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  348. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  349. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  350. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  351. package/bundled/locales/zh-TW/core/accessibility-standards.md +895 -46
  352. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  353. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  354. package/bundled/locales/zh-TW/core/agent-dispatch.md +102 -33
  355. package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
  356. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  357. package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
  358. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  359. package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
  360. package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
  361. package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
  362. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  363. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  364. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  365. package/bundled/locales/zh-TW/core/branch-completion.md +130 -34
  366. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  367. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  368. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  369. package/bundled/locales/zh-TW/core/chaos-engineering-standards.md +138 -36
  370. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  371. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  372. package/bundled/locales/zh-TW/core/code-review-checklist.md +19 -7
  373. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  374. package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
  375. package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
  376. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  377. package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
  378. package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
  379. package/bundled/locales/zh-TW/core/developer-memory.md +102 -12
  380. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  381. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  382. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  383. package/bundled/locales/zh-TW/core/environment-standards.md +250 -72
  384. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  385. package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
  386. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  387. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  388. package/bundled/locales/zh-TW/core/feature-flag-standards.md +202 -57
  389. package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
  390. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  391. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  392. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  393. package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +234 -487
  394. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  395. package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
  396. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  397. package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
  398. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  399. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  400. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  401. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  402. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  403. package/bundled/locales/zh-TW/core/mock-boundary.md +74 -6
  404. package/bundled/locales/zh-TW/core/observability-standards.md +284 -40
  405. package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
  406. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  407. package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
  408. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  409. package/bundled/locales/zh-TW/core/project-context-memory.md +210 -31
  410. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  411. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  412. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  413. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  414. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  415. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  416. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  417. package/bundled/locales/zh-TW/core/runbook-standards.md +296 -23
  418. package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
  419. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  420. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  421. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  422. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  423. package/bundled/locales/zh-TW/core/slo-standards.md +301 -49
  424. package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
  425. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  426. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  427. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  428. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  429. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  430. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  431. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  432. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  433. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  434. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  435. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  436. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  437. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  438. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  439. package/bundled/locales/zh-TW/core/turn-completion-integrity.md +8 -6
  440. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  441. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  442. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  443. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  444. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  445. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +2 -1
  446. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  447. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
  448. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  449. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
  450. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  451. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
  452. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  453. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
  454. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  455. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  456. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +2 -0
  457. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  458. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  459. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  460. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  461. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  462. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  463. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  464. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  465. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  466. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  467. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  468. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  469. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  470. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  471. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  472. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  473. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  474. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  475. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  476. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  477. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  478. package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +584 -475
  479. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  480. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  481. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  482. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  483. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  484. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  485. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  486. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  487. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  488. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  489. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  490. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  491. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  492. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  493. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  494. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  495. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  496. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  497. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  498. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  499. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  500. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  501. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  502. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  503. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  504. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  505. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  506. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  507. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  508. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  509. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  510. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  511. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  512. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  513. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  514. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  515. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  516. package/bundled/locales/zh-TW/skills/README.md +2 -1
  517. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  518. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  519. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  520. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  521. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  522. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  523. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  524. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  525. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  526. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  527. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  528. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  529. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  530. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  531. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  532. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  533. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  534. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  535. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  536. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  537. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  538. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  539. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  540. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  541. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  542. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  543. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  544. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  545. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  546. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  547. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  548. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  549. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  550. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  551. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  552. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  553. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  554. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  555. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  556. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  557. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  558. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  559. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  560. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  561. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  562. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  563. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  564. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  565. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  566. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  567. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  568. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  569. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  570. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  571. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  572. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  573. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  574. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  575. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  576. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  577. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  578. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  579. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  580. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  581. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  582. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  583. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  584. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  585. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  586. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  587. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  588. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  589. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  590. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  591. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  592. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  593. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  594. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  595. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  596. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  597. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  598. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  599. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  600. package/bundled/locales/zh-TW/skills/commit-standards/guide.md +137 -17
  601. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  602. package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
  603. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  604. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  605. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  606. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  607. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  608. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  609. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  610. package/bundled/locales/zh-TW/skills/docs-generator/guide.md +4 -3
  611. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  612. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  613. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  614. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  615. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  616. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  617. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  618. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  619. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  620. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  621. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  622. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  623. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  624. package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +85 -18
  625. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  626. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  627. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  628. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  629. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  630. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  631. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  632. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  633. package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +91 -45
  634. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  635. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  636. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  637. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  638. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  639. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  640. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  641. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  642. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  643. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  644. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  645. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  646. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  647. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  648. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  649. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  650. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  651. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  652. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  653. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  654. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  655. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  656. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  657. package/bundled/locales/zh-TW/skills/tdd-assistant/language-examples.md +693 -47
  658. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  659. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  660. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  661. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  662. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  663. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  664. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  665. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  666. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  667. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  668. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  669. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  670. package/bundled/skills/.claude-plugin/plugin.json +71 -0
  671. package/bundled/skills/commit-standards/SKILL.md +2 -2
  672. package/bundled/skills/commit-standards/guide.md +3 -2
  673. package/bundled/skills/commit-standards/language-options.md +19 -17
  674. package/package.json +2 -2
  675. package/src/commands/audit.js +28 -1
  676. package/src/commands/check.js +72 -3
  677. package/src/commands/compile.js +37 -4
  678. package/src/commands/config.js +49 -24
  679. package/src/commands/init.js +78 -30
  680. package/src/commands/open-work.js +6 -2
  681. package/src/commands/release-messages.js +228 -0
  682. package/src/commands/release.js +127 -68
  683. package/src/commands/run-intent.js +11 -0
  684. package/src/commands/spec.js +4 -2
  685. package/src/commands/update.js +227 -47
  686. package/src/compilers/claude-code-compiler.js +9 -1
  687. package/src/config/ai-agent-paths.js +14 -1
  688. package/src/core/installed-formats.js +15 -0
  689. package/src/core/open-work-config.js +20 -1
  690. package/src/core/project-config.js +55 -0
  691. package/src/i18n/messages.js +106 -2
  692. package/src/installers/hooks-installer.js +1 -1
  693. package/src/installers/manifest-installer.js +1 -1
  694. package/src/installers/skills-installer.js +1 -1
  695. package/src/installers/standards-installer.js +3 -1
  696. package/src/mcp/server.js +9 -3
  697. package/src/prompts/init.js +26 -22
  698. package/src/reconciler/actual-state-scanner.js +2 -8
  699. package/src/reconciler/backup-locations.js +5 -0
  700. package/src/reconciler/backup-manager.js +19 -11
  701. package/src/reconciler/desired-state-calculator.js +89 -57
  702. package/src/reconciler/plan-executor.js +101 -8
  703. package/src/reconciler/recorded-versions.js +49 -0
  704. package/src/reconciler/relative-path.js +23 -0
  705. package/src/uninstallers/hook-uninstaller.js +9 -1
  706. package/src/uninstallers/skills-uninstaller.js +22 -3
  707. package/src/utils/available-standards-report.js +25 -4
  708. package/src/utils/available-standards.js +13 -3
  709. package/src/utils/build-manifest.js +1 -1
  710. package/src/utils/commit-message-judge.js +60 -13
  711. package/src/utils/friction-detector.js +23 -11
  712. package/src/utils/git-hooks.js +106 -4
  713. package/src/utils/integration-generator.js +95 -67
  714. package/src/utils/legacy-hook-migration.js +121 -2
  715. package/src/utils/open-work-tracking.mjs +105 -16
  716. package/src/utils/sdd-header.js +16 -4
  717. package/src/utils/skills-installer.js +2 -1
  718. package/src/utils/spinner.js +14 -4
  719. package/src/utils/standard-validator.js +3 -2
  720. package/standards-registry.json +10 -8
  721. package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
@@ -1,16 +1,20 @@
1
1
  ---
2
2
  source: ../../../core/forward-derivation-standards.md
3
- source_version: 1.2.0
4
- translation_version: 1.2.0
5
- last_synced: 2026-03-18
6
- status: stale
3
+ source_version: 1.3.0
4
+ translation_version: 1.3.0
5
+ last_synced: 2026-10-16
6
+ source_hash: aaa890a7c159
7
+ status: current
7
8
  ---
8
9
 
9
10
  # 正向推演標準 | Forward Derivation Standards
10
11
 
11
- **版本**: 1.2.0
12
+ **版本**: 1.3.0
12
13
  **最後更新**: 2026-03-18
13
14
  **適用範圍**: 所有使用規格驅動開發的專案
15
+ **範疇**: uds-specific
16
+ **業界標準**: JSON Schema 2020-12
17
+ **參考資料**: [specmatic.io](https://specmatic.io/)
14
18
 
15
19
  > **語言**: [English](../../../core/forward-derivation-standards.md) | 繁體中文
16
20
 
@@ -18,12 +22,12 @@ status: stale
18
22
 
19
23
  ## 目的
20
24
 
21
- 本規範定義正向推演的原則和工作流程——從已批准的 SDD 規格自動生成 BDD 場景、TDD 測試骨架和 ATDD 驗收測試。正向推演與[反向工程標準](reverse-engineering-standards.md)互補,形成對稱的推演系統。
25
+ 本標準定義正向推演的原則與工作流程——從已核准的 SDD 規格自動生成 BDD 場景、TDD 測試骨架與 ATDD 驗收測試。正向推演與[反向工程標準](reverse-engineering-standards.md)互補,形成對稱的推演系統。
22
26
 
23
27
  **主要優點**:
24
28
  - 一致的測試結構與規格對齊
25
29
  - 從需求到測試的可追溯性(@SPEC-XXX、@AC-N 標籤)
26
- - 從已批准規格更快啟動 TDD
30
+ - 從已核准的規格更快啟動 TDD
27
31
  - 減少手動轉換錯誤
28
32
 
29
33
  ---
@@ -32,22 +36,23 @@ status: stale
32
36
 
33
37
  ```
34
38
  ┌──────────────────────────────────────────────────────────────────────────┐
35
- │ 正向推演工作流程 │
39
+ │ Forward Derivation Workflow │
36
40
  ├──────────────────────────────────────────────────────────────────────────┤
37
41
  │ │
38
42
  │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌───────────┐ │
39
- │ │ 解析 SPEC │───▶│ 提取 AC │───▶│ 生成 BDD │───▶│ 生成 │ │
40
- │ │ │ │ │ │ │ │ TDD/ATDD │ │
43
+ │ │ Parse SPEC │───▶│Extract AC │───▶│Generate BDD │───▶│Generate │ │
44
+ │ │ 解析規格 │ │提取驗收條件 │ │生成 BDD │ │TDD/ATDD │ │
41
45
  │ └─────────────┘ └─────────────┘ └─────────────┘ └───────────┘ │
42
46
  │ │ │ │ │ │
43
47
  │ │ │ │ ▼ │
44
48
  │ │ │ │ ┌───────────────┐ │
45
- │ │ │ │ │ 人類審查 │ │
49
+ │ │ │ │ │ Human Review │ │
50
+ │ │ │ │ │ 人類審查 │ │
46
51
  │ │ │ │ └───────────────┘ │
47
52
  │ │ │ │ │ │
48
53
  │ ▼ ▼ ▼ ▼ │
49
- │ [來源] [已解析] [已生成] [已審查] │
50
- │ SPEC-XXX.md AC 列表 .feature/.test 可使用 │
54
+ │ [Source] [Parsed] [Generated] [Reviewed] │
55
+ │ SPEC-XXX.md AC List .feature/.test Ready to use │
51
56
  │ │
52
57
  └──────────────────────────────────────────────────────────────────────────┘
53
58
  ```
@@ -56,12 +61,13 @@ status: stale
56
61
 
57
62
  | 階段 | 描述 | 輸出 | 確定性等級 |
58
63
  |------|------|------|-----------|
59
- | **解析 SPEC** | 讀取已批准的規格文件 | SPEC 元資料、區塊 | [來源] |
60
- | **提取 AC** | 解析驗收條件(GWT 或條列) | 結構化 AC 列表 | [推演] |
61
- | **生成 BDD** | 將 AC 轉換為 Gherkin 場景 | .feature 檔案 | [生成] |
62
- | **生成 TDD** | 從 AC 建立測試骨架 | 帶 TODO 的測試檔案 | [生成] |
63
- | **生成 ATDD** | 建立驗收測試表格 | Markdown 測試表格 | [生成] |
64
- | **人類審查** | 驗證生成的輸出 | 批准的測試結構 | [已審查] |
64
+ | **Parse SPEC** | 讀取已核准的規格文件 | SPEC 元資料、章節 | [Source] |
65
+ | **Extract AC** | 解析驗收條件(GWT 或條列) | 結構化 AC 列表 | [Derived] |
66
+ | **Generate BDD** | 將 AC 轉換為 Gherkin 場景 | .feature 檔案 | [Generated] |
67
+ | **Generate TDD** | 從 AC 建立測試骨架 | 包含 TODO 的測試檔案 | [Generated] |
68
+ | **Generate ATDD** | 建立驗收測試表格 | Markdown 測試表格 | [Generated] |
69
+ | **Generate Contracts** | 提取前置/後置條件 | contract.json、schema.json | [Generated] |
70
+ | **Human Review** | 驗證生成的輸出 | 已核准的測試結構 | [Reviewed] |
65
71
 
66
72
  ---
67
73
 
@@ -69,61 +75,63 @@ status: stale
69
75
 
70
76
  ### 1. 規格限定生成
71
77
 
72
- **規則**:只推演規格中存在的內容。不添加 AC 未明確定義的功能、場景或測試。
78
+ **規則**:僅推演已核准規格中存在的內容。絕不添加超出 AC 明確定義範圍的功能、場景或測試。
73
79
 
74
- **正確示範**:
80
+ **正向推演原則**:只推演規格中明確存在的內容。不添加 AC 未明確定義的功能、場景或測試。
81
+
82
+ **正確**:
75
83
  ```markdown
76
84
  # SPEC AC
77
- - [ ] 使用者可以使用電子郵件和密碼登入
85
+ - [ ] User can login with email and password
78
86
 
79
- # 生成的 BDD(正確)
80
- Scenario: 使用者以電子郵件和密碼登入
87
+ # Generated BDD (correct)
88
+ Scenario: User login with email and password
81
89
  ```
82
90
 
83
- **錯誤示範**:
91
+ **錯誤**:
84
92
  ```markdown
85
- # 生成的 BDD(錯誤 - 超出規格範圍)
86
- Scenario: 使用者以電子郵件和密碼登入
87
- Scenario: 使用者以社群帳號登入 # <-- 不在 AC 中
88
- Scenario: 使用者密碼恢復 # <-- 不在 AC 中
93
+ # Generated BDD (wrong - adding beyond spec)
94
+ Scenario: User login with email and password
95
+ Scenario: User login with social auth # <-- NOT in AC
96
+ Scenario: User password recovery # <-- NOT in AC
89
97
  ```
90
98
 
91
99
  ### 2. 反幻覺合規
92
100
 
93
- **規則**:本規範嚴格遵循[反幻覺標準](anti-hallucination.md):
101
+ **規則**:本標準嚴格遵循[反幻覺標準](anti-hallucination.md):
94
102
 
95
- - **1:1 對應**:每個 AC 產生恰好一個場景/測試群組
96
- - **禁止捏造**:不發明驗收條件或測試案例
97
- - **來源標註**:所有生成項目標註來源 SPEC 和 AC 編號
103
+ - **1:1 對應**:每個 AC 恰好產生一個場景/測試群組
104
+ - **禁止捏造**:絕不捏造驗收條件或測試案例
105
+ - **來源標註**:所有生成項目皆參照來源 SPEC 與 AC 編號
98
106
 
99
107
  **反幻覺檢查**:
100
108
  ```
101
- 輸入:SPEC 有 N 個驗收條件
102
- 輸出:恰好 N 個場景(BDD)、N 個測試群組(TDD)、N 個驗收表格(ATDD)
109
+ Input: SPEC with N acceptance criteria
110
+ Output: Exactly N scenarios (BDD), N test groups (TDD), N acceptance tables (ATDD)
103
111
 
104
- 若輸出數量 ≠ 輸入數量 → 違規
112
+ If output count ≠ input count → VIOLATION
105
113
  ```
106
114
 
107
115
  ### 3. 來源標註
108
116
 
109
- **規則**:每個生成項目必須包含可追溯性:
117
+ **規則**:每個生成的項目都必須包含可追溯性:
110
118
 
111
119
  ```gherkin
112
- # BDD 範例
120
+ # BDD Example
113
121
  # Generated from: specs/SPEC-001.md
114
122
  # AC: AC-1
115
123
 
116
124
  @SPEC-001 @AC-1
117
- Scenario: 使用者以有效憑證登入
125
+ Scenario: User login with valid credentials
118
126
  ```
119
127
 
120
128
  ```typescript
121
- // TDD 範例
129
+ // TDD Example
122
130
  /**
123
131
  * Generated from: specs/SPEC-001.md
124
132
  * AC: AC-1
125
133
  */
126
- describe('AC-1: 使用者以有效憑證登入', () => {
134
+ describe('AC-1: User login with valid credentials', () => {
127
135
  ```
128
136
 
129
137
  ### 4. 確定性標籤
@@ -132,11 +140,43 @@ describe('AC-1: 使用者以有效憑證登入', () => {
132
140
 
133
141
  | 標籤 | 定義 | 範例 |
134
142
  |------|------|------|
135
- | `[來源]` | 直接來自 SPEC 的內容 | 功能標題、AC 文字 |
136
- | `[推演]` | 從 SPEC 內容轉換 | 從條列 AC 推演的 GWT |
137
- | `[生成]` | AI 生成的結構 | 測試骨架、TODO 註解 |
143
+ | `[Source]` | 直接來自 SPEC 的內容 | 功能標題、AC 文字 |
144
+ | `[Derived]` | 從 SPEC 內容轉換 | 從條列 AC 轉換的 GWT |
145
+ | `[Generated]` | AI 生成的結構 | 測試骨架、TODO 註解 |
138
146
  | `[TODO]` | 需要人類實作 | 測試斷言、步驟定義 |
139
147
 
148
+ ### 5. 測試層級組態感知
149
+
150
+ **規則**:在推演測試之前,`/derive` 應檢查專案的 `test_levels` 組態,以決定要生成哪些測試層級。這可確保推演遵循團隊的測試策略。
151
+
152
+ **組態來源**(依序檢查):
153
+ 1. `.standards/.uds.manifest.json` → `options.test_levels`
154
+ 2. `uds-manifest.json` → `stats` 或根層級的 `test_levels`
155
+ 3. 若未找到任何組態 → 預設為所有層級(`unit-testing`、`integration-testing`、`system-testing`、`e2e-testing`)
156
+
157
+ **行為**:
158
+
159
+ | 設定的 test_levels | `/derive all` 產出 |
160
+ |-------------------|-------------------|
161
+ | `['unit-testing']` | 僅 BDD + TDD |
162
+ | `['unit-testing', 'integration-testing']` | BDD + TDD + IT |
163
+ | `['unit-testing', 'integration-testing', 'e2e-testing']` | BDD + TDD + IT + E2E |
164
+ | `['unit-testing', 'integration-testing', 'system-testing', 'e2e-testing']`(預設) | BDD + TDD + IT + E2E(全部) |
165
+ | 無 manifest / 無 test_levels | 所有層級(同預設) |
166
+
167
+ **對應**:
168
+
169
+ | test_levels 值 | 推演輸出 |
170
+ |----------------|---------|
171
+ | `unit-testing` | `/derive-tdd`(一律包含) |
172
+ | `integration-testing` | `/derive-it` |
173
+ | `system-testing` | `/derive-it`(系統 = 涵蓋範圍更廣的整合) |
174
+ | `e2e-testing` | `/derive-e2e` |
175
+
176
+ **附註**:無論 `test_levels` 為何,BDD(.feature)、ATDD(acceptance.md)與契約(contract.json)都會生成,因為它們屬於規格產物,而非特定測試層級專用。
177
+
178
+ **AI Agent 指令**:執行 `/derive all` 時,請先檢查 `test_levels` 組態。如果 `e2e-testing` 不在設定的層級中,請略過 E2E 骨架生成並通知使用者:「略過 E2E 推演——未包含在專案 test_levels 組態中。請執行 `uds config --type test_levels` 以加入。」
179
+
140
180
  ---
141
181
 
142
182
  ## 輸入格式要求
@@ -146,124 +186,256 @@ describe('AC-1: 使用者以有效憑證登入', () => {
146
186
  #### 格式 1:Given-When-Then(推薦)
147
187
 
148
188
  ```markdown
149
- ### AC-1: 使用者登入
150
- **Given** 已註冊的使用者有有效憑證
151
- **When** 使用者提交含電子郵件和密碼的登入表單
152
- **Then** 使用者被導向儀表板
153
- **And** 建立工作階段權杖
189
+ ### AC-1: User Login
190
+ **Given** a registered user with valid credentials
191
+ **When** the user submits login form with email and password
192
+ **Then** the user is redirected to dashboard
193
+ **And** a session token is created
154
194
  ```
155
195
 
156
196
  #### 格式 2:條列式
157
197
 
158
198
  ```markdown
159
- ### AC-1: 使用者登入
160
- - 使用者可以使用電子郵件和密碼登入
161
- - 登入成功導向儀表板
162
- - 無效憑證顯示錯誤訊息
199
+ ### AC-1: User Login
200
+ - User can login with email and password
201
+ - Login redirects to dashboard on success
202
+ - Login shows error for invalid credentials
163
203
  ```
164
204
 
165
205
  #### 格式 3:勾選清單
166
206
 
167
207
  ```markdown
168
- ## 驗收條件
169
- - [ ] 使用者可以使用電子郵件和密碼登入
170
- - [ ] 登入成功時建立工作階段
171
- - [ ] 無效憑證時顯示錯誤訊息
208
+ ## Acceptance Criteria
209
+ - [ ] User can login with email and password
210
+ - [ ] Session is created on successful login
211
+ - [ ] Error message shown for invalid credentials
172
212
  ```
173
213
 
174
214
  ---
175
215
 
176
216
  ## 輸出格式
177
217
 
178
- ### BDD 輸出(.feature)
218
+ ### BDD 輸出 (.feature)
179
219
 
180
220
  ```gherkin
181
221
  # Generated from: specs/SPEC-001.md
182
222
  # Generator: forward-derivation v1.0.0
183
223
  # Generated at: 2026-01-19T10:00:00Z
184
224
 
185
- Feature: 使用者認證
186
- 作為使用者
187
- 我想要登入系統
188
- 以便存取我的儀表板
225
+ Feature: User Authentication
226
+ As a user
227
+ I want to login to the system
228
+ So that I can access my dashboard
189
229
 
190
230
  @SPEC-001 @AC-1 @happy-path
191
- Scenario: 使用者以有效憑證登入
192
- # [來源] 來自 SPEC-001 AC-1
193
- Given 已註冊的使用者有有效憑證
194
- When 使用者提交登入表單
195
- Then 使用者被導向儀表板
231
+ Scenario: User login with valid credentials
232
+ # [Source] From SPEC-001 AC-1
233
+ Given a registered user with valid credentials
234
+ When the user submits login form with email and password
235
+ Then the user is redirected to dashboard
236
+ And a session token is created
196
237
 
197
238
  @SPEC-001 @AC-2 @error-handling
198
- Scenario: 無效憑證登入失敗
199
- # [來源] 來自 SPEC-001 AC-2
200
- Given 使用者有無效憑證
201
- When 使用者提交登入表單
202
- Then 顯示錯誤訊息
239
+ Scenario: Login fails with invalid credentials
240
+ # [Source] From SPEC-001 AC-2
241
+ Given a user with invalid credentials
242
+ When the user submits login form
243
+ Then an error message is displayed
244
+ And no session is created
203
245
  ```
204
246
 
205
- ### TDD 輸出(.test.ts)
247
+ ### TDD 輸出 (.test.ts)
206
248
 
207
249
  ```typescript
208
250
  /**
209
- * Tests for SPEC-001: 使用者認證
251
+ * Tests for SPEC-001: User Authentication
210
252
  * Generated from: specs/SPEC-001.md
211
253
  * Generated at: 2026-01-19T10:00:00Z
212
254
  * AC Coverage: AC-1, AC-2
213
255
  *
214
- * [生成] 此檔案包含測試骨架。
215
- * [TODO] 實作測試邏輯和斷言。
256
+ * [Generated] This file contains test skeletons.
257
+ * [TODO] Implement test logic and assertions.
216
258
  */
217
259
 
218
- describe('SPEC-001: 使用者認證', () => {
260
+ describe('SPEC-001: User Authentication', () => {
219
261
  /**
220
- * AC-1: 使用者以有效憑證登入
221
- * [來源] specs/SPEC-001.md#AC-1
262
+ * AC-1: User login with valid credentials
263
+ * [Source] specs/SPEC-001.md#AC-1
222
264
  */
223
- describe('AC-1: 使用者以有效憑證登入', () => {
265
+ describe('AC-1: User login with valid credentials', () => {
224
266
  it('should redirect to dashboard on successful login', async () => {
225
267
  // Arrange
226
- // [TODO] 設定已註冊使用者和有效憑證
268
+ // [TODO] Set up registered user with valid credentials
227
269
 
228
270
  // Act
229
- // [TODO] 提交登入表單
271
+ // [TODO] Submit login form with email and password
230
272
 
231
273
  // Assert
232
- // [TODO] 驗證導向儀表板
233
- expect(true).toBe(true); // Placeholder
274
+ // [TODO] Verify redirect to dashboard
275
+ // [TODO] Verify session token is created
276
+ expect(true).toBe(true); // Placeholder - replace with actual assertion
277
+ });
278
+ });
279
+
280
+ /**
281
+ * AC-2: Login fails with invalid credentials
282
+ * [Source] specs/SPEC-001.md#AC-2
283
+ */
284
+ describe('AC-2: Login fails with invalid credentials', () => {
285
+ it('should display error message for invalid credentials', async () => {
286
+ // Arrange
287
+ // [TODO] Set up user with invalid credentials
288
+
289
+ // Act
290
+ // [TODO] Submit login form
291
+
292
+ // Assert
293
+ // [TODO] Verify error message is displayed
294
+ // [TODO] Verify no session is created
295
+ expect(true).toBe(true); // Placeholder - replace with actual assertion
234
296
  });
235
297
  });
236
298
  });
237
299
  ```
238
300
 
239
- ### ATDD 輸出(acceptance.md)
301
+ ### ATDD 輸出 (acceptance.md)
240
302
 
241
303
  ```markdown
242
- # SPEC-001 驗收測試
304
+ # SPEC-001 Acceptance Tests
305
+
306
+ **Specification**: [SPEC-001](../specs/SPEC-001.md)
307
+ **Generated**: 2026-01-19
308
+ **Status**: Pending Review
309
+
310
+ ---
311
+
312
+ ## AT-001: User login with valid credentials
313
+
314
+ **Source**: AC-1 from SPEC-001
315
+
316
+ | Step | Action | Expected Result | Pass/Fail |
317
+ |------|--------|-----------------|-----------|
318
+ | 1 | Navigate to login page | Login form is displayed | [ ] |
319
+ | 2 | Enter valid email | Email field accepts input | [ ] |
320
+ | 3 | Enter valid password | Password field accepts input (masked) | [ ] |
321
+ | 4 | Click "Login" button | Form is submitted | [ ] |
322
+ | 5 | Verify redirect | User is on dashboard page | [ ] |
323
+ | 6 | Verify session | Session token exists in storage | [ ] |
243
324
 
244
- **規格**: [SPEC-001](../specs/SPEC-001.md)
245
- **生成時間**: 2026-01-19
246
- **狀態**: 待審查
325
+ **Prerequisites**: User account exists in system
326
+
327
+ **Tester**: _______________
328
+ **Date**: _______________
329
+ **Result**: [ ] Pass / [ ] Fail
330
+ **Notes**: _______________
247
331
 
248
332
  ---
249
333
 
250
- ## AT-001: 使用者以有效憑證登入
334
+ ## AT-002: Login fails with invalid credentials
335
+
336
+ **Source**: AC-2 from SPEC-001
251
337
 
252
- **來源**: SPEC-001 的 AC-1
338
+ | Step | Action | Expected Result | Pass/Fail |
339
+ |------|--------|-----------------|-----------|
340
+ | 1 | Navigate to login page | Login form is displayed | [ ] |
341
+ | 2 | Enter invalid email | Email field accepts input | [ ] |
342
+ | 3 | Enter invalid password | Password field accepts input | [ ] |
343
+ | 4 | Click "Login" button | Form is submitted | [ ] |
344
+ | 5 | Verify error | Error message is displayed | [ ] |
345
+ | 6 | Verify no session | No session token in storage | [ ] |
253
346
 
254
- | 步驟 | 動作 | 預期結果 | 通過/失敗 |
255
- |------|------|----------|-----------|
256
- | 1 | 導航到登入頁面 | 顯示登入表單 | [ ] |
257
- | 2 | 輸入有效電子郵件 | 欄位接受輸入 | [ ] |
258
- | 3 | 輸入有效密碼 | 欄位接受輸入(遮罩) | [ ] |
259
- | 4 | 點擊「登入」按鈕 | 表單已提交 | [ ] |
260
- | 5 | 驗證導向 | 使用者在儀表板頁面 | [ ] |
347
+ **Tester**: _______________
348
+ **Date**: _______________
349
+ **Result**: [ ] Pass / [ ] Fail
350
+ **Notes**: _______________
351
+ ```
261
352
 
262
- **前置條件**: 系統中存在使用者帳號
353
+ ### 契約輸出 (contract.json)
354
+
355
+ ```json
356
+ {
357
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
358
+ "metadata": {
359
+ "generatedFrom": "specs/SPEC-001.md",
360
+ "generatedAt": "2026-01-25T10:00:00Z",
361
+ "generator": "forward-derivation v1.1.0",
362
+ "acCoverage": ["AC-1", "AC-2"]
363
+ },
364
+ "contracts": [
365
+ {
366
+ "id": "AC-1",
367
+ "name": "User login with valid credentials",
368
+ "preconditions": [
369
+ { "type": "state", "description": "User is registered in system" },
370
+ { "type": "input", "description": "Valid email and password provided" }
371
+ ],
372
+ "postconditions": [
373
+ { "type": "state", "description": "User session created" },
374
+ { "type": "output", "description": "Redirect to dashboard" }
375
+ ],
376
+ "invariants": [
377
+ { "description": "Session token is cryptographically secure" }
378
+ ]
379
+ },
380
+ {
381
+ "id": "AC-2",
382
+ "name": "Login fails with invalid credentials",
383
+ "preconditions": [
384
+ { "type": "input", "description": "Invalid credentials provided" }
385
+ ],
386
+ "postconditions": [
387
+ { "type": "state", "description": "No session created" },
388
+ { "type": "output", "description": "Error message displayed" }
389
+ ]
390
+ }
391
+ ]
392
+ }
393
+ ```
263
394
 
264
- **測試人員**: _______________
265
- **日期**: _______________
266
- **結果**: [ ] 通過 / [ ] 失敗
395
+ ### Schema 輸出 (schema.json)
396
+
397
+ ```json
398
+ {
399
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
400
+ "metadata": {
401
+ "generatedFrom": "specs/SPEC-001.md",
402
+ "generatedAt": "2026-01-25T10:00:00Z",
403
+ "generator": "forward-derivation v1.1.0"
404
+ },
405
+ "schemas": {
406
+ "LoginRequest": {
407
+ "type": "object",
408
+ "required": ["email", "password"],
409
+ "properties": {
410
+ "email": {
411
+ "type": "string",
412
+ "format": "email",
413
+ "description": "[Source] SPEC-001 AC-1: Valid email required"
414
+ },
415
+ "password": {
416
+ "type": "string",
417
+ "minLength": 8,
418
+ "description": "[Source] SPEC-001 AC-1: Password required"
419
+ }
420
+ }
421
+ },
422
+ "LoginResponse": {
423
+ "type": "object",
424
+ "required": ["success"],
425
+ "properties": {
426
+ "success": { "type": "boolean" },
427
+ "sessionToken": {
428
+ "type": "string",
429
+ "description": "[Source] SPEC-001 AC-1: Session token on success"
430
+ },
431
+ "errorMessage": {
432
+ "type": "string",
433
+ "description": "[Source] SPEC-001 AC-2: Error message on failure"
434
+ }
435
+ }
436
+ }
437
+ }
438
+ }
267
439
  ```
268
440
 
269
441
  ---
@@ -281,6 +453,25 @@ describe('SPEC-001: 使用者認證', () => {
281
453
  | 系統回應 | Then | 「顯示訊息」→ Then 顯示訊息 |
282
454
  | 「可以/應該/必須」 | When + Then | 「使用者可以刪除項目」→ When 使用者刪除項目 Then 項目已移除 |
283
455
 
456
+ ### 轉換範例
457
+
458
+ **輸入(條列式)**:
459
+ ```markdown
460
+ - [ ] User can add item to cart
461
+ - [ ] Cart displays item count
462
+ - [ ] Cart total updates automatically
463
+ ```
464
+
465
+ **輸出(GWT)**:
466
+ ```gherkin
467
+ Scenario: Add item to cart
468
+ Given user is on product page
469
+ When user clicks "Add to Cart" button
470
+ Then item is added to cart
471
+ And cart displays updated item count
472
+ And cart total updates automatically
473
+ ```
474
+
284
475
  ---
285
476
 
286
477
  ## 與開發方法論的整合
@@ -289,14 +480,14 @@ describe('SPEC-001: 使用者認證', () => {
289
480
 
290
481
  ```
291
482
  ┌───────────────────────────────────────────────────────────────────────┐
292
- │ 對稱推演系統 │
483
+ │ Symmetrical Derivation System │
293
484
  ├───────────────────────────────────────────────────────────────────────┤
294
485
  │ │
295
- │ 反向工程 正向推演 │
296
- │ (程式碼 → 規格) (規格 → 測試) │
486
+ │ REVERSE ENGINEERING FORWARD DERIVATION │
487
+ │ (Code → Spec) (Spec → Tests) │
297
488
  │ │
298
489
  │ ┌───────────────┐ ┌───────────────┐ │
299
- │ │ 現有程式碼 │ │ 已批准 SPEC │ │
490
+ │ │ Existing Code │ │ Approved SPEC │ │
300
491
  │ └───────┬───────┘ └───────┬───────┘ │
301
492
  │ │ │ │
302
493
  │ ▼ ▼ │
@@ -308,10 +499,10 @@ describe('SPEC-001: 使用者認證', () => {
308
499
  │ │ │ │
309
500
  │ ▼ ▼ │
310
501
  │ ┌───────────────┐ ┌───────────────┐ │
311
- │ │ 初稿 SPEC │ │ .feature │ │
312
- │ │ [已確認] │ │ .test.ts │ │
313
- │ │ [推斷] │ │ acceptance.md │ │
314
- │ │ [未知] │ │ [生成] │ │
502
+ │ │ Draft SPEC │ │ .feature │ │
503
+ │ │ [Confirmed] │ │ .test.ts │ │
504
+ │ │ [Inferred] │ │ acceptance.md │ │
505
+ │ │ [Unknown] │ │ [Generated] │ │
315
506
  │ └───────────────┘ └───────────────┘ │
316
507
  │ │
317
508
  └───────────────────────────────────────────────────────────────────────┘
@@ -339,51 +530,252 @@ spec-review → forward-derivation → discovery
339
530
  - **單一真實來源**:SPEC 的驗收條件(AC)。所有下游產物——BDD 場景、TDD/IT/E2E 骨架、ATDD 表格、契約,**以及使用者指南**——都是同一條 AC 主幹的投影。使用者指南不是另一個要互相對照的來源,而是又一個投影。
340
531
  - **僅限 user-facing AC**:唯有**終端使用者可直接觀察或操作**的 AC(UI 流程、CLI 指令、對外 API 的使用者語意)才需要使用者指南步驟。純內部 AC(重構、內部模組契約、效能門檻、安全內控)無使用者指南義務。**判不準時一律歸 user-facing**——保守預設;必須明確標記才能排除。
341
532
  - **共用編號(`T-NNN`)**:每個使用者指南步驟標 `T-NNN`,且該 `T-NNN` 必須是某個真實 journey/E2E 測試的 id。使用者指南與 E2E 套件是同一作業流程的兩個投影、共用一把尺。模稜兩可或未標記一律報為**未覆蓋**(寧可冗餘不要遺漏)。
342
- - ✅ 使用者指南步驟 `T-012「建立專案」` ↔ journey spec 中的 E2E 測試 `T-012`。
533
+ - ✅ 使用者指南步驟 `T-012 "Create a project"` ↔ journey spec 中的 E2E 測試 `T-012`。
343
534
  - ❌ 使用者指南自造 `UG-3` 卻無對應測試 → drift,報為未覆蓋。
344
- - **Drift 反例**:使用者指南寫「2-click checkout」、E2E 卻仍驗「3-step payment」——沒有共用編號就無人察覺。共用 `T-NNN` 把這種 drift 變成被報出的覆蓋缺口。
535
+ - **Drift 反例**:使用者指南寫 "2-click checkout"、E2E 卻仍驗 "3-step payment"——沒有共用編號就無人察覺。共用 `T-NNN` 把這種 drift 變成被報出的覆蓋缺口。
345
536
 
346
537
  ### 單一主幹原則(非平行對照)
347
538
 
348
- 測試與文件來源是**同一條 AC 主幹的多層投影**,不是互相對照的獨立真實來源。TDD/IT/E2E 是同一主幹的金字塔**層級**(依 AC 性質分層),非彼此競爭的來源。兩兩對照 N 個來源(N×N)會滋生 drift;把每個產物投影回單一 AC 主幹(N×1)則消除它。
539
+ 測試與文件來源是**同一條 AC 主幹的多層投影**,不是互相對照的獨立真實來源。TDD/IT/E2E 是同一主幹的金字塔*層級*(參見測試層級決策樹),非彼此競爭的來源。兩兩對照 N 個來源(N×N)會滋生 drift;把每個產物投影回單一 AC 主幹(N×1)則消除它。
349
540
 
350
541
  > **規則**:每個測試或文件產物都必須回溯到某個 AC。另立**平行編號體系**——一條脫離 AC 主幹的第二套 `T-NNN` 系列——即為違規。只有一把尺:AC 主幹,且 `T-NNN` 由 journey/E2E 測試與使用者指南共用。
351
542
 
352
543
  ---
353
544
 
545
+ ## 測試層級決策樹
546
+
547
+ 根據 AC 的性質決定應生成哪種測試層級:
548
+
549
+ ```
550
+ AC 涉及使用者介面操作(點擊、瀏覽、重導向、表單填寫)?
551
+ ├─ Yes → E2E Test
552
+ └─ No
553
+ ├─ AC 涉及多個服務/元件互動(API 呼叫、DB 查詢、Queue)?
554
+ │ ├─ Yes → Integration Test
555
+ │ └─ No → Unit Test(已由 /derive-tdd 覆蓋)
556
+ └─ AC 涉及外部系統呼叫(第三方 API、外部 DB)?
557
+ └─ Yes → Integration Test
558
+ ```
559
+
560
+ ---
561
+
562
+ ## 整合測試推演
563
+
564
+ 當 AC 涉及多個服務/元件互動或外部系統呼叫時,生成 Integration Test 骨架。
565
+
566
+ ### 介面範本
567
+
568
+ #### HTTP API
569
+
570
+ ```
571
+ Setup:
572
+ - Start test server / mock server
573
+ - Seed test data (DB fixtures, mock responses)
574
+
575
+ Request:
576
+ - Send HTTP request (method, path, headers, body)
577
+ - [TODO] Fill in request details from AC
578
+
579
+ Assert:
580
+ - Verify response status code
581
+ - Verify response body structure
582
+ - Verify side effects (DB state, event published)
583
+ - [TODO] Fill in expected values from AC
584
+
585
+ Teardown:
586
+ - Clean up test data
587
+ - Stop test server / mock server
588
+ ```
589
+
590
+ #### Database
591
+
592
+ ```
593
+ Setup:
594
+ - Connect to test database
595
+ - Run migrations / seed schema
596
+ - Insert prerequisite data
597
+
598
+ Action:
599
+ - Execute query / repository method
600
+ - [TODO] Fill in operation details from AC
601
+
602
+ Assert:
603
+ - Verify returned data matches expected
604
+ - Verify data persistence (read-after-write)
605
+ - Verify constraints (unique, foreign key)
606
+ - [TODO] Fill in expected results from AC
607
+
608
+ Teardown:
609
+ - Rollback transaction / truncate tables
610
+ - Disconnect from test database
611
+ ```
612
+
613
+ #### Message Queue
614
+
615
+ ```
616
+ Setup:
617
+ - Connect to test queue (or in-memory broker)
618
+ - Subscribe to target topic/queue
619
+ - Prepare message payload
620
+
621
+ Action:
622
+ - Publish message to queue
623
+ - [TODO] Fill in message details from AC
624
+
625
+ Assert:
626
+ - Verify message received by consumer
627
+ - Verify message payload structure
628
+ - Verify consumer side effects (DB write, API call)
629
+ - [TODO] Fill in expected behavior from AC
630
+
631
+ Teardown:
632
+ - Drain queue
633
+ - Disconnect from broker
634
+ ```
635
+
636
+ #### Service-to-Service
637
+
638
+ ```
639
+ Setup:
640
+ - Start dependent service (or mock/stub)
641
+ - Configure service discovery / endpoints
642
+ - Prepare request context
643
+
644
+ Action:
645
+ - Call target service method / endpoint
646
+ - [TODO] Fill in service call details from AC
647
+
648
+ Assert:
649
+ - Verify response from target service
650
+ - Verify downstream service was called correctly
651
+ - Verify error propagation (if applicable)
652
+ - [TODO] Fill in expected interactions from AC
653
+
654
+ Teardown:
655
+ - Stop mock services
656
+ - Clean up shared state
657
+ ```
658
+
659
+ ---
660
+
661
+ ## E2E 測試推演
662
+
663
+ 當 AC 涉及使用者介面操作時,生成 E2E Test 骨架。
664
+
665
+ ### Browser E2E Skeleton | 瀏覽器 E2E 骨架
666
+
667
+ ```
668
+ Environment:
669
+ - Launch browser (headless or headed)
670
+ - Set viewport, locale, auth state
671
+ - [TODO] Configure environment from AC prerequisites
672
+
673
+ Navigation:
674
+ - Navigate to target URL / page
675
+ - Wait for page load / element visibility
676
+ - [TODO] Fill in target page from AC
677
+
678
+ Interaction:
679
+ - Perform user actions (click, type, select, scroll)
680
+ - [TODO] Fill in user actions from AC steps
681
+
682
+ Assertion:
683
+ - Verify page state (URL, title, element text)
684
+ - Verify visual elements (visible, hidden, enabled)
685
+ - Verify data changes reflected in UI
686
+ - [TODO] Fill in expected outcomes from AC
687
+
688
+ Cleanup:
689
+ - Reset application state
690
+ - Close browser context
691
+ ```
692
+
693
+ ### Gherkin Step Mapping | Gherkin 步驟映射
694
+
695
+ | Gherkin 關鍵字 | 對應到 | E2E 階段 |
696
+ |-----------------|---------|-----------|
697
+ | `Given` | 設定 + 導航 | 環境準備、頁面導航、前置狀態 |
698
+ | `When` | 互動 | 使用者動作(點擊、輸入、提交) |
699
+ | `Then` | 斷言 | 驗證預期結果(頁面狀態、UI 元素、資料) |
700
+ | `And` / `But` | 延伸前一項 | 額外的設定、互動或斷言 |
701
+
702
+ **映射範例**:
703
+
704
+ ```gherkin
705
+ # Gherkin (from BDD)
706
+ Given a logged-in user on the dashboard → Environment: set auth state; Navigation: go to /dashboard
707
+ When the user clicks "Create Project" → Interaction: click button "Create Project"
708
+ And fills in the project name "My Project" → Interaction: type "My Project" into name field
709
+ And clicks "Submit" → Interaction: click button "Submit"
710
+ Then a success message is displayed → Assertion: verify success message visible
711
+ And the project appears in the project list → Assertion: verify "My Project" in project list
712
+ ```
713
+
714
+ ---
715
+
716
+ ## AC 層級摘要標記
717
+
718
+ 當 `/derive all` 產生多層級輸出時,在輸出的末尾包含一份 **AC 層級摘要**(AC Level Summary),以協助開發人員理解每個 AC 為何被分配到特定測試層級:
719
+
720
+ ```markdown
721
+ ## AC Level Summary
722
+ | AC | Suggested Level | Rationale |
723
+ |----|----------------|-----------|
724
+ | AC-1 | E2E | Involves UI redirect and page navigation |
725
+ | AC-2 | Integration | API endpoint with database interaction |
726
+ | AC-3 | Unit | Pure calculation, no external dependencies |
727
+ | AC-4 | Integration | Calls external payment gateway API |
728
+ ```
729
+
730
+ 此摘要僅供參考——開發人員可根據自身判斷覆寫建議的層級。
731
+
732
+ ---
733
+
354
734
  ## 命令
355
735
 
356
736
  ### 命令參考
357
737
 
358
738
  | 命令 | 輸入 | 輸出 | 目的 |
359
- |------|------|------|------|
739
+ |---------|-------|--------|---------|
360
740
  | `/derive-bdd` | SPEC-XXX.md | .feature | AC → Gherkin 場景 |
361
741
  | `/derive-tdd` | SPEC-XXX.md | .test.ts | AC → 測試骨架 |
742
+ | `/derive-it` | SPEC-XXX.md or .feature | .it.test.* | AC → 整合測試骨架 |
743
+ | `/derive-e2e` | SPEC-XXX.md or .feature | .e2e.test.* | AC → E2E 測試骨架 |
362
744
  | `/derive-atdd` | SPEC-XXX.md | acceptance.md | AC → 驗收測試表格 |
363
- | `/derive-all` | SPEC-XXX.md | 以上全部 | 完整推演管道 |
745
+ | `/derive-contracts` | SPEC-XXX.md | contract.json, schema.json | AC → 合約與 schema 定義 |
746
+ | `/derive-all` | SPEC-XXX.md | 以上全部 | 完整推演管線(BDD + TDD + IT + E2E + ATDD + 合約) |
364
747
 
365
748
  ### 命令參數
366
749
 
367
750
  | 參數 | 類型 | 預設值 | 描述 |
368
- |------|------|--------|------|
369
- | `--lang` | string | typescript | 目標語言: ts, js, python, java, go |
370
- | `--framework` | string | vitest | 框架: vitest, jest, pytest, junit, go-test |
751
+ |-----------|------|---------|-------------|
752
+ | `--lang` | string | typescript | 目標:ts, js, python, java, go |
753
+ | `--framework` | string | vitest | 框架:vitest, jest, pytest, junit, go-test |
371
754
  | `--output-dir` | string | ./generated | 輸出目錄 |
372
755
  | `--dry-run` | boolean | false | 預覽不建立檔案 |
373
756
 
374
757
  ### 使用範例
375
758
 
376
759
  ```bash
377
- # 從規格生成 BDD 場景
760
+ # Generate BDD scenarios from specification
378
761
  /derive-bdd specs/SPEC-001.md
379
762
 
380
- # 使用 Python/pytest 生成 TDD 測試骨架
763
+ # Generate TDD test skeleton with Python/pytest
381
764
  /derive-tdd specs/SPEC-001.md --lang python --framework pytest
382
765
 
383
- # 生成所有輸出
766
+ # Generate contract and schema definitions for verification
767
+ /derive-contracts specs/SPEC-001.md --output-dir ./contracts
768
+
769
+ # Generate integration test skeletons
770
+ /derive-it specs/SPEC-001.md --lang python --framework pytest
771
+
772
+ # Generate E2E test skeletons
773
+ /derive-e2e specs/SPEC-001.md --framework playwright
774
+
775
+ # Generate all outputs (BDD + TDD + IT + E2E + ATDD + Contracts)
384
776
  /derive-all specs/SPEC-001.md --output-dir ./generated
385
777
 
386
- # 預覽不建立檔案
778
+ # Preview without creating files
387
779
  /derive-all specs/SPEC-001.md --dry-run
388
780
  ```
389
781
 
@@ -398,7 +790,7 @@ spec-review → forward-derivation → discovery
398
790
  #### Auto-TDD 進入規則
399
791
 
400
792
  | 規則 | 說明 |
401
- |------|------|
793
+ |------|-------------|
402
794
  | **推演完整性** | 所有推演輸出(BDD、TDD、ATDD)必須在進入 TDD 前完成生成 |
403
795
  | **RED 狀態初始化** | Pipeline 在生成測試骨架後將 TDD 狀態設為 RED |
404
796
  | **測試骨架驗證** | 生成的測試檔案必須能編譯/解析無誤後才能進入 RED |
@@ -409,7 +801,7 @@ spec-review → forward-derivation → discovery
409
801
  推演步驟可透過 Pipeline 事件自動觸發:
410
802
 
411
803
  | Hook | 觸發條件 | 動作 |
412
- |------|---------|------|
804
+ |------|---------|--------|
413
805
  | `on-spec-approved` | Spec 狀態變更為「已批准」 | 啟動推演 Pipeline |
414
806
  | `on-derivation-complete` | 所有推演輸出已生成 | 轉換至 TDD RED 階段 |
415
807
  | `on-tdd-green` | 所有推演測試通過 | 觸發審查階段 |
@@ -426,20 +818,45 @@ spec-review → forward-derivation → discovery
426
818
  1. **Spec 批准**:Pipeline 偵測到 Spec 批准(透過 hook 或輪詢)
427
819
  2. **完整推演**:Pipeline 以專案配置的語言/框架執行 `/derive-all`
428
820
  3. **計數驗證**:Pipeline 驗證輸出數量與 AC 數量匹配(反幻覺)
429
- 4. **RED 狀態**:Pipeline 將 TDD 狀態設為 RED;測試骨架存在但 assertion 為 [TODO]
821
+ 4. **RED 狀態**:Pipeline 將 TDD 狀態設為 RED;測試骨架存在但斷言為 [TODO]
430
822
 
431
823
  #### 與 Pipeline 階段的整合
432
824
 
433
825
  正向推演對應 [Pipeline 整合標準](pipeline-integration-standards.md) 6 階段模型中的 **DERIVE** 階段:
434
826
 
435
827
  | Pipeline 階段 | 正向推演角色 |
436
- |--------------|------------|
828
+ |---------------|------------------------|
437
829
  | SPEC | 輸入:已批准的規格 |
438
830
  | **DERIVE** | 執行:解析 AC → 生成 BDD/TDD/ATDD 輸出 |
439
831
  | BUILD | 輸出:測試骨架進入 TDD RED→GREEN 循環 |
440
832
 
441
833
  ---
442
834
 
835
+ ## 失敗處理與復原
836
+
837
+ 正向推演定義了數個關卡(AC 解析、計數驗證、骨架驗證、人類審查)。本節定義當關卡**失敗**時的處理方式——即 失敗 → 回滾 → 重試/升級呈報 → 重新驗證 的路徑——確保失敗的推演絕不靜默產出部分或幻覺輸出。
838
+
839
+ ### 失敗 → 復原矩陣
840
+
841
+ | 失敗情況 | 偵測階段 | 復原動作 | 重新驗證 |
842
+ |---------|-------------|-----------------|-----------|
843
+ | **解析錯誤**——AC 不在支援的格式中(GWT / 條列式) | DERIVE(解析 AC) | 中止該 AC 的生成;回報 `file:line` 與預期格式;不為其產出骨架。待 SPEC 修復後重新排隊。 | 修正後的 AC 解析成功 |
844
+ | **AC 計數不符**——生成的測試數量 ≠ AC 數量 | 計數驗證 | **[違反反幻覺規則]** 回滾整批並在嚴格 1:1 對應下重新生成。絕不可透過新增或刪除測試來「湊齊數量」——這會掩蓋幻覺。 | 計數檢查通過(測試數 = AC 數) |
845
+ | **骨架無法解析/編譯** | 骨架驗證 | 回滾有問題的檔案;使用正確的語言範本重新生成。若第二次仍失敗,將該 AC 標記為 `[BLOCKED]` 並呈報給人工處理。 | 檔案解析/編譯通過 |
846
+ | **人類審查退回**——審查者指出邏輯錯誤或未填寫的 `[TODO]` | 人類審查關卡 | 記錄退回原因;將該回饋作為額外限制,僅重新生成被退回的項目。絕不可自動批准。 | 審查者接受 |
847
+ | **缺少來源標註**——輸出缺少 `@SPEC-XXX` / `@AC-N` | 任何階段 | 阻止轉換至 TDD RED;補上來源標註後重新產出。 | 每個輸出皆帶有來源標註 |
848
+
849
+ ### 復原規則
850
+
851
+ | 規則 | 說明 | 嚴重程度 |
852
+ |------|-------------|----------|
853
+ | **FD-FAIL-001** | 關卡失敗必須中斷流程——絕不可在有未解決失敗的情況下進入 TDD RED。 | 必要 |
854
+ | **FD-FAIL-002** | 計數不符屬於強制回滾,而非調節對帳;嚴禁透過新增或刪除測試來湊數(這會掩蓋幻覺)。 | 必要 |
855
+ | **FD-FAIL-003** | 自動重試有次數限制(最多 2 次,針對瞬時或範本錯誤);重試耗盡時將 AC 標記為 `[BLOCKED]` 並呈報給人工處理。 | 必要 |
856
+ | **FD-FAIL-004** | 每個復原路徑皆以重新驗證失敗的關卡結束——在原始檢查通過之前,復原不算完成。 | 必要 |
857
+
858
+ ---
859
+
443
860
  ## 應避免的反模式
444
861
 
445
862
  ### 生成反模式
@@ -486,14 +903,54 @@ spec-review → forward-derivation → discovery
486
903
 
487
904
  ---
488
905
 
906
+ ## 工具整合
907
+
908
+ ### Skill 參考
909
+
910
+ - [正向推演 Skill](../skills/spec-derivation/SKILL.md) - 詳細工作流程實作
911
+ - [規格驅動開發 Skill](../skills/spec-driven-dev/SKILL.md) - SDD 工作流程
912
+ - [BDD 助理 Skill](../skills/bdd-assistant/SKILL.md) - Gherkin 精煉
913
+ - [TDD 助理 Skill](../skills/tdd-assistant/SKILL.md) - 測試實作
914
+
915
+ ---
916
+
489
917
  ## 相關規範
490
918
 
491
- - [反向工程標準](reverse-engineering-standards.md) - 對稱對應(程式碼 → 規格)
919
+ - [反向工程標準](reverse-engineering-standards.md) - 對稱的對應標準(程式碼 → 規格)
492
920
  - [規格驅動開發](spec-driven-development.md) - 輸入規格格式
493
- - [行為驅動開發](../../../core/behavior-driven-development.md) - BDD 輸出格式
494
- - [測試驅動開發](test-driven-development.md) - TDD 輸出用法
495
- - [驗收測試驅動開發](../../../core/acceptance-test-driven-development.md) - ATDD 輸出格式
496
- - [反幻覺指南](anti-hallucination.md) - 生成合規
921
+ - [行為驅動開發](behavior-driven-development.md) - BDD 輸出格式
922
+ - [測試驅動開發](test-driven-development.md) - TDD 輸出使用方式
923
+ - [驗收測試驅動開發](acceptance-test-driven-development.md) - ATDD 輸出格式
924
+ - [反幻覺指引](anti-hallucination.md) - 生成合規性
925
+
926
+ ---
927
+
928
+ ## 參考資料
929
+
930
+ ### 書籍
931
+
932
+ - Steve Freeman & Nat Pryce - "Growing Object-Oriented Software, Guided by Tests" (2009) - 雙迴圈 TDD 模式基礎
933
+ - Gojko Adzic - "Specification by Example" (2011) - 從規格到測試推演的概念
934
+
935
+ ### 線上資源
936
+
937
+ #### 合約測試
938
+
939
+ - [Microsoft: Consumer-Driven Contract Testing](https://microsoft.github.io/code-with-engineering-playbook/automated-testing/cdc-testing/) - 關於 CDC 測試的工程實務手冊
940
+ - [BrowserStack: Contract Testing Guide](https://www.browserstack.com/guide/contract-testing) - 全面的合約測試概述
941
+ - [Specmatic: AI-powered API Contract Testing](https://specmatic.io/) - 現代合約優先開發工具
942
+
943
+ #### 驗證理論
944
+
945
+ - [Wikipedia: Formal Verification](https://en.wikipedia.org/wiki/Formal_verification) - 驗證的理論基礎
946
+ - [Wikipedia: Design by Contract](https://en.wikipedia.org/wiki/Design_by_contract) - Bertrand Meyer 的 DbC 概念 (1986)
947
+
948
+ #### SDD 與正向推演
949
+
950
+ - [Thoughtworks: Spec-Driven Development](https://www.thoughtworks.com/en-us/insights/blog/agile-engineering-practices/spec-driven-development-unpacking-2025-new-engineering-practices) - SDD 方法論定義
951
+ - [Martin Fowler: SDD Tools (Kiro, spec-kit, Tessl)](https://martinfowler.com/articles/exploring-gen-ai/sdd-3-tools.html) - AI 時代 SDD 工具探索
952
+ - [GitHub spec-kit](https://github.com/github/spec-kit/blob/main/spec-driven.md) - GitHub 的 SDD 實作
953
+ - [InfoQ: Spec-Driven Development](https://www.infoq.com/articles/spec-driven-development/) - SDD 實務概述
497
954
 
498
955
  ---
499
956
 
@@ -501,11 +958,13 @@ spec-review → forward-derivation → discovery
501
958
 
502
959
  | 版本 | 日期 | 變更 |
503
960
  |------|------|------|
504
- | 1.2.0 | 2026-03-18 | 新增:Pipeline 整合章節 — auto-TDD 轉換、pipeline hooks、auto-TDD 進入工作流程 |
961
+ | 1.3.0 | 2026-06-18 | 新增:失敗處理與復原章節 — failure→rollback→retry/escalate→re-verify 矩陣 + 復原規則 FD-FAIL-001..004(XSPEC-292 T7) |
962
+ | 1.2.0 | 2026-03-18 | 新增:Pipeline 整合章節 — auto-TDD 轉換、Pipeline hooks、auto-TDD 進入工作流程 |
963
+ | 1.1.0 | 2026-01-25 | 新增:合約輸出 (contract.json)、Schema 輸出 (schema.json)、用於驗證產物生成的 /derive-contracts 命令 |
505
964
  | 1.0.0 | 2026-01-19 | 初始發布 |
506
965
 
507
966
  ---
508
967
 
509
968
  ## 授權
510
969
 
511
- 本規範採用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權。
970
+ 本標準以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 釋出。