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,27 +1,31 @@
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-23
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
- # 正向推演标准 | Forward Derivation Standards
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
- > **语言**: [English](../../../core/forward-derivation-standards.md) | 简体中文
19
+ > **语言**: [English](../../../core/forward-derivation-standards.md) | [繁體中文](../../zh-TW/core/forward-derivation-standards.md) | 简体中文
16
20
 
17
21
  ---
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
30
  - 从已批准规格更快启动 TDD
27
31
  - 减少手动转换错误
@@ -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
+ | **解析 SPEC** | 读取已批准的规格文档 | SPEC 元数据、章节 | [Source] |
65
+ | **提取 AC** | 解析验收条件(GWT 或条列) | 结构化 AC 列表 | [Derived] |
66
+ | **生成 BDD** | 将 AC 转换为 Gherkin 场景 | .feature 文件 | [Generated] |
67
+ | **生成 TDD** | 从 AC 创建测试骨架 | 带 TODO 的测试文件 | [Generated] |
68
+ | **生成 ATDD** | 创建验收测试表格 | Markdown 测试表格 | [Generated] |
69
+ | **生成契约** | 提取前置/后置条件 | contract.json, schema.json | [Generated] |
70
+ | **人类审查** | 验证生成的输出 | 已批准的测试结构 | [Reviewed] |
65
71
 
66
72
  ---
67
73
 
@@ -69,73 +75,107 @@ 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. 确定性标签
130
138
 
131
139
  使用这些标签标示推演确定性:
132
140
 
133
- | 标签 | 定义 | 范例 |
141
+ | 标签 | 定义 | 示例 |
134
142
  |------|------|------|
135
- | `[来源]` | 直接来自 SPEC 的内容 | 功能标题、AC 文字 |
136
- | `[推演]` | 从 SPEC 内容转换 | 从条列 AC 推演的 GWT |
137
- | `[生成]` | AI 生成的结构 | 测试骨架、TODO 注释 |
138
- | `[TODO]` | 需要人类实现 | 测试断言、步骤定义 |
143
+ | `[Source]` | 直接来自 SPEC 的内容 | 功能标题、AC 文本 |
144
+ | `[Derived]` | 从 SPEC 内容转换 | 从条列 AC 转换的 GWT |
145
+ | `[Generated]` | AI 生成的结构 | 测试骨架、TODO 注释 |
146
+ | `[TODO]` | 需要人工实现 | 测试断言、步骤定义 |
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
+ | 无清单 / 无 test_levels | 所有级别(与默认相同) |
166
+
167
+ **映射**:
168
+
169
+ | test_levels 值 | 推演输出 |
170
+ |-------------------|------------------|
171
+ | `unit-testing` | `/derive-tdd`(始终包含) |
172
+ | `integration-testing` | `/derive-it` |
173
+ | `system-testing` | `/derive-it`(system = 更广泛的集成) |
174
+ | `e2e-testing` | `/derive-e2e` |
175
+
176
+ **注意**:BDD(.feature)、ATDD(acceptance.md)和契约(contract.json)始终都会生成,不受 test_levels 影响,因为它们属于规格产物,而非特定于某个测试级别。
177
+
178
+ **AI Agent 指令**:执行 `/derive all` 时,首先检查 `test_levels` 配置。如果 `e2e-testing` 不在已配置的级别中,则跳过 E2E 骨架生成并通知用户:"Skipping E2E derivation — not in project test_levels configuration. Run `uds config --type test_levels` to add it."
139
179
 
140
180
  ---
141
181
 
@@ -146,140 +186,291 @@ 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
  ---
270
442
 
271
443
  ## 条列式转 GWT 转换
272
444
 
273
- 当 AC 以条列点撰写时,使用此模式转换:
445
+ 当 AC 以条列点编写时,使用此模式转换:
274
446
 
275
447
  ### 转换规则
276
448
 
277
449
  | 条列模式 | 对应到 | 范例 |
278
450
  |----------|--------|------|
279
- | 条件/状态 | Given | 「用户已登录」→ Given 用户已登录 |
280
- | 用户动作 | When | 「用户点击按钮」→ When 用户点击按钮 |
281
- | 系统响应 | Then | 「显示消息」→ Then 显示消息 |
282
- | 「可以/应该/必须」 | When + Then | 「用户可以删除项目」→ When 用户删除项目 Then 项目已移除 |
451
+ | 条件/状态 | Given | “用户已登录” → Given 用户已登录 |
452
+ | 用户动作 | When | “用户点击按钮” → When 用户点击按钮 |
453
+ | 系统响应 | Then | “显示消息” → Then 显示消息 |
454
+ | “可以/应该/必须” | When + Then | “用户可以删除项目” → When 用户删除项目 Then 项目已移除 |
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
+ ```
283
474
 
284
475
  ---
285
476
 
@@ -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
  └───────────────────────────────────────────────────────────────────────┘
@@ -327,27 +518,216 @@ spec-review → forward-derivation → discovery
327
518
 
328
519
  1. **规格审查 (SDD)**:规格已批准
329
520
  2. **正向推演**:自动生成 BDD 场景、TDD 骨架
330
- 3. **探索 (BDD)**:与利害关系人审查和精炼生成的场景
521
+ 3. **探索 (BDD)**:与利益相关者审查和完善生成的场景
331
522
  4. **TDD 红灯**:使用生成的骨架开始实现测试
332
523
 
333
524
  ---
334
525
 
335
526
  ## 终端投影:用户指南
336
527
 
337
- 推演链不止于测试。**用户指南是同一条链的终端投影**——E2E/旅程测试以机器验证的那条作业流程,其供人阅读的视图。「用户读到的操作步骤」与「E2E 实际验证的行为」因此成为一个被维持的不变量。
528
+ 推演链不止于测试。**用户指南是同一条链的终端投影**——E2E/旅程测试以机器验证的那条工作流程,其供人阅读的视图。“用户读到的操作步骤”与“E2E 实际验证的行为”成为一个被维持的不变量。
338
529
 
339
- - **单一真实来源**:SPEC 的验收条件(AC)。所有下游产物——BDD 场景、TDD/IT/E2E 骨架、ATDD 表格、契约,**以及用户指南**——都是同一条 AC 主干的投影。用户指南不是另一个要互相对照的来源,而是又一个投影。
340
- - **仅限 user-facing AC**:唯有**终端用户可直接观察或操作**的 AC(UI 流程、CLI 指令、对外 API 的用户语义)才需要用户指南步骤。纯内部 AC(重构、内部模块契约、性能门槛、安全内控)无用户指南义务。**判不准时一律归 user-facing**——保守预设;必须明确标记才能排除。
341
- - **共用编号(`T-NNN`)**:每个用户指南步骤标 `T-NNN`,且该 `T-NNN` 必须是某个真实 journey/E2E 测试的 id。用户指南与 E2E 套件是同一作业流程的两个投影、共用一把尺。模棱两可或未标记一律报为**未覆盖**(宁可冗余不要遗漏)。
342
- - ✅ 用户指南步骤 `T-012「创建项目」` ↔ journey spec 中的 E2E 测试 `T-012`。
343
- - ❌ 用户指南自造 `UG-3` 却无对应测试 → drift,报为未覆盖。
344
- - **Drift 反例**:用户指南写「2-click checkout」、E2E 却仍验「3-step payment」——没有共用编号就无人察觉。共用 `T-NNN` 把这种 drift 变成被报出的覆盖缺口。
530
+ - **单一真实来源**:SPEC 的验收条件(AC)。所有下游产物——BDD 场景、TDD/IT/E2E 骨架、ATDD 表格、契约,**以及用户指南**——都是同一条 AC 主干的投影。用户指南不是另一个要互相对照的来源;它是又一个投影。
531
+ - **仅限 user-facing AC**:唯有**终端用户可直接观察或操作**的 AC(UI 流程、CLI 命令、面向用户的 API 语义)才需要用户指南步骤。纯内部 AC(重构、内部模块契约、性能阈值、安全控制)无用户指南义务。**拿不准时一律视作 user-facing**——保守默认;必须明确标记才能排除。
532
+ - **共享编号(`T-NNN`)**:每个用户指南步骤都标记 `T-NNN`,且该 `T-NNN` 必须是某个真实旅程/E2E 测试的 id。用户指南与 E2E 测试套件是同一工作流程的两个投影,共享一把尺子。模棱两可或缺失的标记均被报告为**未覆盖**(宁可冗余不可遗漏)。
533
+ - ✅ 用户指南步骤 `T-012 "Create a project"` ↔ 旅程规格中的 E2E 测试 `T-012`。
534
+ - ❌ 用户指南自造 `UG-3` 却无对应测试 → 漂移,报告为未覆盖。
535
+ - **漂移示例**:用户指南写着“2-click checkout”,而 E2E 仍验证“3-step payment”——若没有共享编号,无人会察觉。共享 `T-NNN` 将这种漂移转化为被报告的覆盖缺口。
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)会滋生漂移;将每个产物投影回单一 AC 主干(N×1)则能消除它。
349
540
 
350
- > **规则**:每个测试或文件产物都必须回溯到某个 AC。另立**平行编号体系**——一条脱离 AC 主干的第二套 `T-NNN` 系列——即为违规。只有一把尺:AC 主干,且 `T-NNN` 由 journey/E2E 测试与用户指南共用。
541
+ > **规则**:每个测试或文档产物都必须回溯到某个 AC。另立**平行编号体系**——即脱离 AC 主干的第二套 `T-NNN` 风格系列——属于违规。尺子只有一把:AC 主干,且 `T-NNN` 由旅程/E2E 测试与用户指南共享。
542
+
543
+ ---
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
+ #### 数据库
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
+ #### 消息队列
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
+ #### 服务到服务
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 测试骨架。
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
+ 此摘要仅供参考——开发人员可根据自身判断覆盖建议的层级。
351
731
 
352
732
  ---
353
733
 
@@ -356,34 +736,46 @@ spec-review → forward-derivation → discovery
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 或 .feature | .it.test.* | AC → 集成测试骨架 |
743
+ | `/derive-e2e` | SPEC-XXX.md 或 .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 + Contracts) |
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
- | `--dry-run` | boolean | false | 预览不创建文件 |
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,8 +801,8 @@ spec-review → forward-derivation → discovery
409
801
  推演步骤可通过 Pipeline 事件自动触发:
410
802
 
411
803
  | Hook | 触发条件 | 动作 |
412
- |------|---------|------|
413
- | `on-spec-approved` | Spec 状态变更为「已批准」 | 启动推演 Pipeline |
804
+ |------|---------|--------|
805
+ | `on-spec-approved` | Spec 状态变更为“已批准” | 启动推演 Pipeline |
414
806
  | `on-derivation-complete` | 所有推演输出已生成 | 转换至 TDD RED 阶段 |
415
807
  | `on-tdd-green` | 所有推演测试通过 | 触发审查阶段 |
416
808
 
@@ -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
  ### 生成反模式
@@ -457,7 +874,7 @@ spec-review → forward-derivation → discovery
457
874
  | 反模式 | 影响 | 正确做法 |
458
875
  |--------|------|----------|
459
876
  | **从草稿 SPEC 推演** | 无效输出 | 只使用已批准的规格 |
460
- | **跳过人类审查** | 品质问题 | 永远审查生成的输出 |
877
+ | **跳过人类审查** | 质量问题 | 永远审查生成的输出 |
461
878
  | **将骨架视为完整** | 缺少断言 | 填写 [TODO] 区块 |
462
879
  | **忽略语言惯例** | 不一致的代码 | 使用适当的语言模板 |
463
880
 
@@ -486,14 +903,54 @@ spec-review → forward-derivation → discovery
486
903
 
487
904
  ---
488
905
 
489
- ## 相关规范
906
+ ## 工具整合
907
+
908
+ ### Skill 参考
909
+
910
+ - [Forward Derivation Skill](../skills/spec-derivation/SKILL.md) - 详细的工作流实现
911
+ - [Spec-Driven Development Skill](../skills/spec-driven-dev/SKILL.md) - SDD 工作流程
912
+ - [BDD Assistant Skill](../skills/bdd-assistant/SKILL.md) - Gherkin 精炼
913
+ - [TDD Assistant Skill](../skills/tdd-assistant/SKILL.md) - 测试实现
914
+
915
+ ---
916
+
917
+ ## 相关标准
490
918
 
491
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) - Double-Loop 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 整合章节 —— 自动 TDD 转换、pipeline hooks、自动 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/) 发布。