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
@@ -2,95 +2,294 @@
2
2
  source: ../../../core/test-data-standards.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-04-10
5
+ last_synced: 2026-10-11
6
+ source_hash: 67bb6b804e50
6
7
  status: current
7
8
  ---
8
9
 
9
10
  # 測試資料標準
10
11
 
11
- > 版本: 1.0.0 | 最後更新: 2026-04-01
12
+ > **語言**: [English](../../../core/test-data-standards.md) | 繁體中文
13
+
14
+ **版本**: 1.0.0
15
+ **最後更新**: 2026-03-31
16
+ **適用性**: 所有軟體專案
17
+ **範圍**: 通用 (Universal)
18
+ **參考**: [測試標準](testing-standards.md)、[安全標準](security-standards.md)
19
+
20
+ ---
12
21
 
13
22
  ## 概述
14
23
 
15
- 本文件定義跨所有測試層級的測試資料管理標準,涵蓋資料策略選擇、PII 匿名化、Fixture 與 Schema Migration 同步、測試隔離原則、Factory Pattern 及常見反模式。
24
+ 本文件定義跨所有測試層級的測試資料管理標準,涵蓋資料策略選擇、個人可識別資訊(PII)的匿名化、Fixture 與 Schema Migration 同步、測試隔離原則、用於建立資料的 Factory Pattern,以及應避免的常見反模式。
25
+
26
+ 妥善管理的測試資料能確保測試**可靠**(結果具確定性)、**安全**(不洩漏 PII)且**可維護**(schema 變更時易於更新)。
16
27
 
17
28
  ---
18
29
 
19
30
  ## 測試資料策略
20
31
 
32
+ 依測試層級與資料複雜度選擇適當的測試資料策略:
33
+
21
34
  | 策略 | 說明 | 適用場景 | 測試層級 |
22
35
  |------|------|---------|---------|
23
36
  | **Inline Data** | 直接在測試程式碼中定義資料 | 簡單、聚焦的值 | Unit tests |
24
- | **Fixture Files** | 外部 JSON/YAML/SQL 檔案 | 共用參考資料、複雜結構 | Integration tests |
37
+ | **Fixture Files** | 由測試載入的外部 JSON/YAML/SQL 檔案 | 共用參考資料、複雜結構 | Integration tests |
25
38
  | **Seed Scripts** | 填充資料庫的可執行腳本 | 完整環境設定、真實資料集 | E2E tests |
26
39
 
40
+ ### Inline Data
41
+
42
+ 直接在測試函式中定義測試資料,讓測試保持自包含且易於理解。
43
+
44
+ **使用時機:**
45
+ - 輸入/輸出簡單的單元測試
46
+ - 資料量小(1-5 個物件)
47
+ - 每個測試需要略有不同的資料
48
+
49
+ **概念範例:**
50
+ ```
51
+ // Inline: data is right next to the assertion
52
+ const user = { name: 'Jane Doe', email: 'jane@example.com', role: 'admin' };
53
+ expect(greet(user)).toBe('Hello, Admin Jane Doe');
54
+ ```
55
+
56
+ ### Fixture Files
57
+
58
+ 將測試資料存放在外部檔案(JSON、YAML、CSV 或 SQL)中,由測試在執行時載入。
59
+
60
+ **使用時機:**
61
+ - 需要複雜或大量資料集的整合測試
62
+ - 多個測試共用相同的參考資料(唯讀)
63
+ - 資料代表擬真的領域物件
64
+
65
+ **最佳實踐:**
66
+ - 將 fixture 存放在專用的 `tests/fixtures/` 或 `__fixtures__/` 目錄
67
+ - 以描述性方式命名檔案:`valid-order-with-items.json`、`expired-subscription.json`
68
+ - 保持 fixture 小而聚焦——每個 fixture 一個情境
69
+ - 絕不在執行時修改 fixture 檔案
70
+
71
+ ### Seed Scripts
72
+
73
+ 以測試資料設定資料庫或外部服務的可執行腳本。
74
+
75
+ **使用時機:**
76
+ - 需要完整填充環境的 E2E 測試
77
+ - 使用擬真資料量的效能/負載測試
78
+ - 與真實資料庫互動的測試
79
+
80
+ **最佳實踐:**
81
+ - 讓 seed 腳本具冪等性(可安全多次執行)
82
+ - 同時包含設定(setup)與拆除(teardown)邏輯
83
+ - 將 seed 腳本與 schema migration 一起做版本控管
84
+ - 記錄 seeding 後的預期狀態
85
+
27
86
  ### 策略選擇指南
28
87
 
29
88
  ```
30
- Unit test? → Inline data(簡單、自包含)
31
- Integration test? → Fixture files(共用、結構化)
32
- E2E test? → Seed scripts(完整環境設定)
89
+ What test level?
90
+ ├─ Unit test
91
+ │ └─ Use inline data (simple, self-contained)
92
+ ├─ Integration test
93
+ │ └─ Use fixture files (shared, structured)
94
+ └─ E2E test
95
+ └─ Use seed scripts (full environment setup)
33
96
  ```
34
97
 
35
98
  ---
36
99
 
37
100
  ## 資料匿名化規則
38
101
 
39
- 測試需要擬真資料時,**絕不使用真實 PII**:
102
+ 測試需要擬真資料時,**絕不使用真實 PII**。依欄位類型套用下列匿名化技術:
103
+
104
+ | PII 欄位 | 匿名化技術 | 範例(前 → 後) |
105
+ |----------|-----------|----------------|
106
+ | **姓名** | 使用 Faker 函式庫或虛構化名 | `John Smith` → `Jane Doe`(產生) |
107
+ | **Email** | 將網域替換為 `@example.com` | `john@company.com` → `user1@example.com` |
108
+ | **電話** | 以固定前綴進行格式保留遮罩 | `+1-555-123-4567` → `+1-555-000-0001` |
109
+ | **地址** | 泛化為虛構地址 | `123 Main St, NYC` → `1 Test Ave, Anytown` |
110
+ | **ID** | 對原值做 Hash,或使用流水號/UUID 產生 | `SSN: 123-45-6789` → `ID: test-uuid-0001` |
111
+
112
+ ### 規則
40
113
 
41
- | PII 欄位 | 匿名化技術 | 範例 |
42
- |----------|-----------|------|
43
- | **姓名** | 使用 Faker 或虛構化名 | `John Smith` → `Jane Doe` |
44
- | **Email** | 替換為 `@example.com` | `john@company.com` → `user1@example.com` |
45
- | **電話** | 格式保留遮罩 | `+1-555-123-4567` → `+1-555-000-0001` |
46
- | **地址** | 泛化為虛構地址 | `123 Main St` → `1 Test Ave, Anytown` |
47
- | **ID** | Hash 或 UUID 產生 | `SSN: 123-45-6789` → `ID: test-uuid-0001` |
114
+ 1. **絕不複製正式環境資料**到測試環境,除非已完全匿名化
115
+ 2. **使用確定性產生方式**,當測試需要可重現的資料時(設定 seed 的 Faker)
116
+ 3. **驗證匿名化後的資料**仍保留格式限制(例如有效的 email 格式)
117
+ 4. **記錄匿名化對應方式**,讓原始欄位語意清楚可辨
118
+ 5. **檢查 CI 日誌中的測試資料**——確保測試輸出中沒有出現真實 PII
48
119
 
49
120
  ---
50
121
 
51
122
  ## Fixture 與 Schema Migration 同步
52
123
 
53
- 1. **原子更新**:Migration 變更欄位時,同一 commit 更新所有相關 fixture
54
- 2. **自動偵測**:CI 驗證 fixture 與當前 schema 一致
55
- 3. **Fixture 版本化**:加入 `_schema_version` 欄位
56
- 4. **Migration 檢查清單**:PR 範本加入「更新測試 fixture」項目
124
+ 資料庫 schema 變更時,fixture 檔案**必須**同步更新。過時的 fixture 會造成偽陽性(測試通過但程式碼有問題)或偽陰性(測試失敗但程式碼正確)。
125
+
126
+ ### 同步規則
127
+
128
+ 1. **原子更新**:當 migration 新增/移除/重新命名欄位時,在**同一個 commit** 中更新所有引用該資料表的 fixture
129
+ 2. **自動偵測**:加入 CI 檢查,依當前 schema 驗證 fixture 檔案
130
+ - 載入每個 fixture 並驗證其符合預期 schema
131
+ - 標記任何欄位過時或缺漏的 fixture
132
+ 3. **Fixture 版本化**:在 fixture 檔案中加入 schema 版本註記
133
+ ```json
134
+ {
135
+ "_schema_version": "2026-03-31-add-status-column",
136
+ "users": [{ "name": "Test User", "email": "test@example.com", "status": "active" }]
137
+ }
138
+ ```
139
+ 4. **Migration 檢查清單**:在 migration 的 PR 範本中將「更新測試 fixture」列為必要步驟
140
+ 5. **過時 fixture 偵測**:執行自動化檢查,偵測引用 schema 中已不存在之欄位或資料表的 fixture
57
141
 
58
142
  ---
59
143
 
60
144
  ## 測試隔離原則
61
145
 
146
+ 每個測試**必須**獨立。依賴共用狀態或執行順序的測試既脆弱又不可靠。
147
+
148
+ ### 核心規則
149
+
150
+ 1. **建立自己的資料**:每個測試在 `beforeEach` 或 `setUp` 區塊中建立它所需的確切資料
151
+ 2. **自行清理**:每個測試在 `afterEach` 或 `tearDown` 中銷毀或回滾自己的資料
152
+ 3. **無共用可變狀態**:測試**不得**讀寫其他測試也會使用的共用可變變數、資料庫列或檔案
153
+ 4. **可平行執行**:測試應設計成可平行執行而不互相干擾
154
+ 5. **冪等**:執行一次或多次測試,應產生相同結果
155
+
156
+ ### 各測試層級的隔離策略
157
+
62
158
  | 測試層級 | 隔離策略 |
63
159
  |---------|---------|
64
160
  | **Unit** | 純函式;mock 外部依賴 |
65
- | **Integration** | Transaction rollback;測試專用 schema |
161
+ | **Integration** | Transaction rollback;測試專用的資料庫 schema |
66
162
  | **E2E** | 專用測試環境;唯一命名空間資料 |
67
163
 
68
- 核心規則:每個測試建立自己的資料、清理自己的資料、無共用可變狀態、可平行執行、冪等。
164
+ ### Transaction Rollback 模式
165
+
166
+ 對資料庫整合測試,將每個測試包在一個 transaction 中,並在之後回滾:
167
+
168
+ ```
169
+ beforeEach: BEGIN TRANSACTION
170
+ test runs (INSERT, UPDATE, SELECT)
171
+ afterEach: ROLLBACK
172
+ ```
173
+
174
+ 這可確保測試之間零副作用。
69
175
 
70
176
  ---
71
177
 
72
178
  ## Factory Pattern
73
179
 
74
- Factory 提供合理預設值,可按測試需求覆寫:
180
+ 使用 Factory Pattern 建立具合理預設值、且可依各測試覆寫的測試資料。
181
+
182
+ ### 定義
183
+
184
+ **測試資料 factory** 是一個函式,它:
185
+ 1. 為所有必要欄位提供**合理預設值**
186
+ 2. 允許針對特定測試情境**覆寫**任何預設值
187
+ 3. 支援自動建立**關聯/相關資料**
188
+
189
+ ### 概念範例
75
190
 
76
191
  ```
192
+ // Factory with defaults
77
193
  function createUser(overrides = {}) {
78
194
  return {
79
195
  id: generateUUID(),
80
196
  name: 'Default User',
81
197
  email: 'default@example.com',
82
198
  role: 'viewer',
199
+ createdAt: new Date(),
200
+ ...overrides // Override any default
201
+ };
202
+ }
203
+
204
+ // Usage: override only what matters for this test
205
+ const admin = createUser({ role: 'admin' });
206
+ const named = createUser({ name: 'Specific Name' });
207
+ ```
208
+
209
+ ### 關聯資料
210
+
211
+ Factory 應支援建立相關實體:
212
+
213
+ ```
214
+ // Factory that creates associated data
215
+ function createOrder(overrides = {}) {
216
+ const user = overrides.user || createUser();
217
+ return {
218
+ id: generateUUID(),
219
+ userId: user.id,
220
+ items: overrides.items || [createOrderItem()],
221
+ status: 'pending',
83
222
  ...overrides
84
223
  };
85
224
  }
86
225
  ```
87
226
 
88
- 最佳實踐:每個實體一個 factory、最小預設值、可組合、無副作用。
227
+ ### 最佳實踐
228
+
229
+ 1. **每個實體一個 factory**:`createUser()`、`createOrder()`、`createProduct()`
230
+ 2. **最小預設值**:只包含必要欄位;保持預設值簡單
231
+ 3. **可組合**:Factory 可呼叫其他 factory 來建立相關資料
232
+ 4. **無副作用**:Factory 只回傳資料物件;不寫入資料庫(那是另一個步驟)
233
+ 5. **Traits/預設組合**:為常見情境定義具名預設組合:`createUser({ ...adminTraits })`
234
+
235
+ ---
236
+
237
+ ## 反模式
238
+
239
+ 避免下列常見的測試資料反模式:
240
+
241
+ ### 1. 共用可變資料
242
+
243
+ **問題**:多個測試讀寫相同的資料(全域變數、共用的資料庫列)。
244
+
245
+ **為何有害**:測試變得依賴執行順序。一個測試的變更會影響另一個測試的預期,造成間歇性失敗。
246
+
247
+ **修正**:每個測試建立並擁有自己的資料。使用 factory 與 setup/teardown hook。
248
+
249
+ ### 2. 寫死的 ID
250
+
251
+ **問題**:測試使用寫死的 ID,例如 `userId: 1` 或 `orderId: 'abc-123'`。
252
+
253
+ **為何有害**:平行執行時測試之間的 ID 會衝突。對自動遞增值的假設在不同環境間會失效。
254
+
255
+ **修正**:在 factory 中產生唯一 ID(UUID)。絕不假設特定的 ID 值。
256
+
257
+ ### 3. 依賴執行順序
258
+
259
+ **問題**:測試 B 假設測試 A 已執行並建立了某些資料。
260
+
261
+ **為何有害**:測試在單獨執行、以不同順序執行或平行執行時會失敗,使除錯極為困難。
262
+
263
+ **修正**:每個測試都完全自包含,擁有自己的 setup 與 teardown。任何測試都不應依賴另一個測試的副作用。
264
+
265
+ ### 4. 使用正式環境資料
266
+
267
+ **問題**:將正式環境資料庫快照複製到測試環境。
268
+
269
+ **為何有害**:暴露真實 PII(法律/合規風險)、產生拖慢 CI 的龐大測試資料集,且包含不可預測的資料而導致測試脆弱。
270
+
271
+ **修正**:使用匿名化的合成資料。以 factory 與 Faker 函式庫產生測試資料。保持資料集最小且為特定目的而建。
89
272
 
90
273
  ---
91
274
 
92
275
  ## 快速參考卡
93
276
 
277
+ ### 策略選擇
278
+ ```
279
+ Unit test? → Inline data
280
+ Integration test? → Fixture files
281
+ E2E test? → Seed scripts
282
+ ```
283
+
284
+ ### 匿名化快速檢查
285
+ ```
286
+ Name? → Faker / pseudonym
287
+ Email? → @example.com domain
288
+ Phone? → Format-preserving mask
289
+ Address? → Fictitious / generalized
290
+ ID? → Hash / UUID / sequential
291
+ ```
292
+
94
293
  ### 隔離檢查清單
95
294
  ```
96
295
  [ ] 測試建立自己的資料
@@ -102,6 +301,29 @@ function createUser(overrides = {}) {
102
301
 
103
302
  ---
104
303
 
304
+ ## 參考
305
+
306
+ - [測試標準](testing-standards.md) — 測試層級、覆蓋率與品質要求
307
+ - [安全標準](security-standards.md) — 資料保護與 PII 處理
308
+ - [單元測試標準](../options/testing/unit-testing.md) — 單元測試模式與最佳實踐
309
+ - [整合測試標準](../options/testing/integration-testing.md) — 整合測試策略
310
+
311
+ ---
312
+
313
+ **相關標準:**
314
+ - [測試標準](testing-standards.md) — 整體測試框架
315
+ - [效能標準](performance-standards.md) — 效能測試的資料考量
316
+
317
+ ---
318
+
319
+ ## 版本歷史
320
+
321
+ | 版本 | 日期 | 變更 |
322
+ |------|------|------|
323
+ | 1.0.0 | 2026-03-31 | 初始版本:策略、匿名化、Fixture 同步、隔離、Factory Pattern、反模式 |
324
+
325
+ ---
326
+
105
327
  ## 授權
106
328
 
107
329
  本標準以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權釋出。
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/test-driven-development.md
3
3
  source_version: 1.2.0
4
4
  translation_version: 1.2.0
5
- last_synced: 2026-04-22
5
+ last_synced: 2026-10-11
6
+ source_hash: 1e7fecd7c0f3
6
7
  status: current
7
8
  ---
8
9
 
@@ -14,6 +15,7 @@ status: current
14
15
  **最後更新**: 2026-01-25
15
16
  **適用性**: 所有採用測試驅動開發的專案
16
17
  **範圍**: 通用 (Universal)
18
+ **業界標準**: 無(Kent Beck 實踐,1999)
17
19
 
18
20
  ---
19
21
 
@@ -46,4 +48,5 @@ TDD 是傳統測試驅動開發家族的一部分(與 BDD 和 ATDD 並列)
46
48
  ## 相關標準
47
49
 
48
50
  - [測試標準](testing-standards.md)
51
+ - [行為驅動開發](behavior-driven-development.md)
49
52
  - [規格驅動開發](spec-driven-development.md)
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/test-governance.md
3
3
  source_version: 1.2.0
4
4
  translation_version: 1.2.0
5
- last_synced: 2026-08-14
5
+ last_synced: 2026-10-11
6
+ source_hash: 45e889042c57
6
7
  status: current
7
8
  ---
8
9
 
@@ -10,6 +11,8 @@ status: current
10
11
 
11
12
  > **語言**: [English](../../../core/test-governance.md) | 繁體中文
12
13
 
14
+ **版本**: 1.2.0
15
+ **最後更新**: 2026-08-14
13
16
  **適用性**: 所有軟體專案
14
17
  **範圍**: 通用 (Universal)
15
18
 
@@ -47,30 +50,26 @@ status: current
47
50
 
48
51
  | ID | 名稱 | 衡量指標 |
49
52
  |----|------|----------|
50
- | QO-1 | 缺陷密度 | < 1 缺陷/KLOC(正式發布) |
51
- | QO-2 | 測試覆蓋率 | 依測試金字塔比例 |
52
- | QO-3 | 回歸率 | < 5% 每次迭代 |
53
+ | QO-1 | 功能正確性 | 測試通過率 >= 95% |
54
+ | QO-2 | 防止回歸 | CI 中零回歸失敗 |
55
+ | QO-3 | 程式碼品質 | 零 lint/型別錯誤,靜態分析通過 |
53
56
 
54
- ### 測試金字塔
57
+ ### 層級權責
55
58
 
56
- | 層級 | 比例 | 執行時間 | 說明 |
57
- |------|------|----------|------|
58
- | 單元測試 (UT) | 70% | < 100ms/test | 測試個別函式/方法 |
59
- | 整合測試 (IT) | 20% | < 1s/test | 測試元件互動 |
60
- | 端對端測試 (E2E) | 7% | 數秒/test | 測試使用者工作流 |
61
- | 效能/安全測試 | 3% | 分鐘級 | 非功能測試 |
59
+ | 層級 | 負責人 | 環境 | 金字塔比例 |
60
+ |------|--------|------|------------|
61
+ | 單元測試 (UT) | 開發者 | local | 70% |
62
+ | 整合測試 (IT) | 開發者 | local / ci | 20% |
63
+ | 系統測試 (ST) | QA / 開發者 | ci / sit | 7% |
64
+ | 端對端測試 (E2E) | QA | staging | 3% |
62
65
 
63
- ### 完成定義 (DoD)
66
+ ### 靜態分析
64
67
 
65
- 每個功能完成前必須滿足:
68
+ 在執行測試前先執行靜態分析工具:
66
69
 
67
- | 項目 | 說明 |
68
- |------|------|
69
- | 所有測試通過 | 100% 通過率 |
70
- | 覆蓋率達標 | 符合金字塔比例 |
71
- | 無已知缺陷 | P0/P1 缺陷為零 |
72
- | 程式碼審查完成 | 至少一位審查者核准 |
73
- | 文件更新 | API 文件和 CHANGELOG 已更新 |
70
+ - `ruff check .`(Python)
71
+ - `eslint .`(TypeScript/JavaScript)
72
+ - `mypy .`(Python 型別檢查)
74
73
 
75
74
  ### 門檻閘門必須 Fail Closed
76
75
 
@@ -89,14 +88,59 @@ status: current
89
88
 
90
89
  一個計算出數字、印出來、卻永遠 `exit 0` 的包裝腳本,既不滿足本條規則,也不滿足 `verification-evidence` 的證據有效性規則 1——工具的 exit code 不再帶有任何關於它量測對象的資訊。
91
90
 
92
- ## 測試環境管理
91
+ ---
92
+
93
+ ## 完成準則
94
+
95
+ 測試完成準則定義測試活動何時可視為完成。
96
+ - **ISO 29119** 稱之為「測試完成準則」(Test Completion Criteria) 或「測試退出準則」(Test Exit Criteria)
97
+ - **Agile/Scrum** 稱之為「完成定義」(Definition of Done, DoD)
98
+
99
+ ### 任務層級
100
+
101
+ 每個任務的完成準則(於每個任務完成後檢查):
102
+
103
+ | 檢查項 | 必要 | 說明 |
104
+ |--------|------|------|
105
+ | verify_command_passed | 是 | 任務的驗證指令或各測試層級全部通過 |
106
+ | no_lint_errors | 是 | 變更的檔案中沒有 lint 錯誤 |
107
+ | type_check_passed | 是 | 型別檢查通過 |
108
+
109
+ ### 功能層級
110
+
111
+ 每個功能的完成準則(於功能邊界檢查):
112
+
113
+ | 檢查項 | 必要 | 說明 |
114
+ |--------|------|------|
115
+ | all_tasks_passed | 是 | 該功能中的所有任務皆已成功完成 |
116
+ | acceptance_criteria_met | 是 | 所有驗收條件皆已驗證 |
117
+ | no_regression | 是 | 沒有破壞任何既有測試 |
118
+
119
+ ### 發布層級
120
+
121
+ 發布的完成準則(於發布前檢查):
122
+
123
+ | 檢查項 | 必要 | 說明 |
124
+ |--------|------|------|
125
+ | all_features_complete | 是 | 所有規劃的功能皆已完成 |
126
+ | e2e_pass | 是 | 完整 E2E 測試套件通過 |
127
+ | static_analysis_clean | 是 | 靜態分析回報零問題 |
128
+ | documentation_updated | 否 | 文件反映了變更內容 |
129
+
130
+ ---
131
+
132
+ ## 環境管理
93
133
 
94
- | 環境 | 用途 | 管理責任 |
95
- |------|------|----------|
96
- | 本地 (Local) | 開發者單元測試 | 開發者 |
97
- | CI | 自動化測試 | CI/CD 管線 |
98
- | Staging | 整合和 E2E 測試 | DevOps |
99
- | Production | 煙霧測試和監控 | SRE |
134
+ | 環境 | 說明 | 用途 | Mock 策略 |
135
+ |------|------|------|-----------|
136
+ | local | 開發者工作站 | 單元測試、快速整合測試 | 記憶體內的 Mock 與 Stub |
137
+ | ci | CI/CD 管線 | 完整測試套件、lint、型別檢查、靜態分析 | 容器化相依性(testcontainers) |
138
+ | sit | 系統整合測試 | 與真實服務互動的系統測試 | 外部 API 使用 Stub,內部服務使用真實服務 |
139
+ | staging | 預備正式環境 | E2E 測試、煙霧測試 | 不使用 Mock,使用真實外部服務 |
140
+
141
+ > **注意**:SIT = 系統整合測試 (System Integration Testing),對齊 ISO 12207 驗證流程 + 整合流程。
142
+
143
+ ---
100
144
 
101
145
  ## 規則
102
146
 
@@ -105,14 +149,30 @@ status: current
105
149
  | enforce-completion-criteria | 完成任務或功能時 | 在將任務/功能標記為完成前,驗證所有必要的完成準則已達成 | 必須 |
106
150
  | pyramid-compliance | 規劃測試策略時 | 以 70/20/7/3 金字塔比例為指引。可接受偏差,但需有文件記錄的正當理由 | 必須 |
107
151
  | sit-isolation | 執行系統測試時 | 系統測試應對外部相依性使用 Stub,但使用真實的內部服務。使用 SIT 環境進行系統層級的驗證 | 建議 |
108
- | test-execution-continuity | 新增或完成測試案例時 | 測試案例必須連接到自動化執行觸發器(CI gate、build hook 或排程執行)。存在但從未執行的測試提供假信心,比沒有測試更糟。在將測試覆蓋率標記為完成前,請確認執行歷程存在。| 必須 |
152
+ | test-execution-continuity | 新增或完成測試案例時 | 測試案例必須連接到自動化執行觸發器(CI gate、build hook 或排程執行)。存在但從未執行的測試提供假信心,比沒有測試更糟。在將測試覆蓋率標記為完成前,請確認執行歷程存在。 | 必須 |
109
153
  | fail-closed-threshold-gate | 設定或審查任何 coverage/lint/mutation 或其他門檻檢查時 | 該檢查必須使用工具自己的 fail-under(或等價)強制旗標,使其在未達門檻時以非 0 退出。只印出數字、永遠 exit 0 的腳本是報告,不是閘門,不滿足本條 | 必須 |
110
154
 
111
155
  ---
112
156
 
157
+ ## 範本
158
+
159
+ - [測試計劃範本](../../../templates/test-plan-template.md) — 參考 ISO 29119-3
160
+ - [測試案例範本](../../../templates/test-case-template.md) — 參考 ISO 29119-3
161
+
162
+ ---
163
+
113
164
  ## 相關標準
114
165
 
115
- - [測試標準](testing-standards.md)
116
- - [提交規範](checkin-standards.md)
117
- - [部署標準](deployment-standards.md)
118
- - [驗證證據標準](verification-evidence.md) —— 證據有效性規範的是產出 exit code 之後如何**解讀**它;`fail-closed-threshold-gate` 規範的是閘門必須如何被**建造**,讓 exit code 一開始就帶有真實資訊
166
+ - [測試標準](testing-standards.md) — 測試金字塔與覆蓋比例
167
+ - [測試完整度維度](test-completeness-dimensions.md) — 8 維度測試覆蓋
168
+ - [提交規範](checkin-standards.md) — 提交前品質關卡
169
+ - [驗證證據標準](verification-evidence.md) — 證據有效性規範的是產出 exit code 之後如何**解讀**它;`fail-closed-threshold-gate` 規範的是閘門必須如何被**建造**,讓 exit code 一開始就帶有真實資訊
170
+
171
+ ---
172
+
173
+ ## 版本歷史
174
+
175
+ | 版本 | 日期 | 變更 |
176
+ |------|------|------|
177
+ | 1.0.0 | 2026-03-11 | 初始版本 — 測試政策、完成準則、環境管理 |
178
+ | 1.2.0 | 2026-08-14 | 新增 `fail-closed-threshold-gate` — coverage/lint/mutation 門檻檢查在未達門檻時必須以非 0 退出,而不只是印出數字 |
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/testing-standards.md
3
3
  source_version: 3.2.0
4
4
  translation_version: 3.2.0
5
- last_synced: 2026-04-20
5
+ last_synced: 2026-10-11
6
+ source_hash: 4d5d70b73aa6
6
7
  status: current
7
8
  ---
8
9
 
@@ -10,8 +11,8 @@ status: current
10
11
 
11
12
  > **Language**: [English](../../../core/testing-standards.md) | 繁體中文
12
13
 
13
- **版本**: 3.1.0
14
- **最後更新**: 2026-03-25
14
+ **版本**: 3.2.0
15
+ **最後更新**: 2026-04-20
15
16
  **適用範圍**: 所有軟體專案
16
17
  **Scope**: universal
17
18
  **產業標準**: ISTQB CTFL v4.0, ISO/IEC/IEEE 29119
@@ -482,39 +483,85 @@ tests/
482
483
 
483
484
  > **參考**:ISTQB CTFL v4.0 §4.4、James Bach 的 Session-Based Test Management (SBTM)
484
485
 
485
- 探索式測試是一種結構化方法,測試設計、執行與學習同時進行,透過發現腳本測試無法預見的未知缺陷來補充自動化測試。
486
+ 探索式測試是一種結構化方法,測試設計、執行與學習同時進行。它透過發現腳本測試無法預見的未知缺陷,來補充自動化測試。
486
487
 
487
488
  ### Session-Based Test Management (SBTM)
488
489
 
490
+ 每個探索式測試 session 都遵循 SBTM 框架:
491
+
489
492
  | 元素 | 說明 | 需求 |
490
493
  |------|------|------|
491
- | **Time Box** | 固定 60-90 分鐘的 session | 必要 |
494
+ | **Time Box** | 固定 60-90 分鐘的 session 時長 | 必要 |
492
495
  | **Charter** | 明確的探索目標、測試區域與預期風險 | 必要 |
493
496
  | **Session Notes** | 步驟、觀察、偏差與問題的結構化記錄 | 必要 |
494
- | **Debrief** | Session 後與團隊回顧 | 建議 |
497
+ | **Debrief** | Session 後與團隊或測試負責人回顧 | 建議 |
498
+
499
+ **Charter 格式**:
500
+ ```
501
+ Explore [target area]
502
+ With [resources/techniques]
503
+ To discover [expected information/risks]
504
+ ```
495
505
 
496
506
  ### 啟發法(SFDPOT)
497
507
 
508
+ 使用 SFDPOT 助記法(James Bach 的 Heuristic Test Strategy Model)引導從六個維度進行探索:
509
+
498
510
  | 維度 | 關注領域 | 範例問題 |
499
511
  |------|----------|----------|
500
512
  | Structure | 系統元件與其關係 | 存在哪些模組?如何連接? |
501
- | Function | 系統提供的功能與能力 | 每個功能做什麼?邊界情況? |
502
- | Data | 輸入/輸出資料、邊界值 | 接受哪些資料類型?邊界發生什麼? |
503
- | Platform | OS、瀏覽器、硬體差異 | 所有支援平台都能運作? |
513
+ | Function | 系統提供的功能與能力 | 每個功能做什麼?有哪些邊界情況? |
514
+ | Data | 輸入/輸出資料、邊界值、格式 | 接受哪些資料類型?在邊界會發生什麼? |
515
+ | Platform | OS、瀏覽器、硬體、環境差異 | 在所有支援的平台上都能運作嗎? |
504
516
  | Operations | 安裝、設定、維護、監控 | 能乾淨安裝嗎?如何維護? |
505
- | Time | 並發、逾時、排程、時區 | 並發存取時會發生什麼? |
517
+ | Time | 並發、逾時、排程、時區 | 並發存取時會發生什麼?逾時如何處理? |
518
+
519
+ > **提示**:每個 session 至少使用 3 個 SFDPOT 維度,以確保廣泛的覆蓋。
520
+
521
+ ### Session 記錄範本
522
+
523
+ 每個探索式測試 session **必須**使用此範本產出 session 記錄:
524
+
525
+ | 欄位 | 說明 | 必要 |
526
+ |------|------|------|
527
+ | **Charter** | 探索目標與範圍 | 是 |
528
+ | **Area** | 受測的功能區域或元件 | 是 |
529
+ | **Duration** | 實際花費時間(在 60-90 分鐘 time box 內) | 是 |
530
+ | **Notes** | 執行步驟、觀察、與 charter 的偏差 | 是 |
531
+ | **Bugs Found** | 發現的缺陷清單及其嚴重度 | 是 |
532
+ | **Follow-up** | 待辦事項:新 charter、自動化候選項目、待釐清問題 | 是 |
533
+
534
+ **Session 記錄範例**:
535
+ ```markdown
536
+ ## Session Record
537
+ - **Charter**: Explore login flow with invalid credentials to discover error handling gaps
538
+ - **Area**: Authentication module
539
+ - **Duration**: 75 minutes
540
+ - **Notes**: Tested SQL injection, XSS in username, Unicode characters, empty fields...
541
+ - **Bugs Found**: 2 (BUG-101: XSS not sanitized in error message, BUG-102: No rate limiting)
542
+ - **Follow-up**: Write automated regression for BUG-101, new charter for password reset flow
543
+ ```
506
544
 
507
545
  ### 自動化互補
508
546
 
547
+ 探索式測試與自動化測試扮演互補的角色:
548
+
509
549
  | 面向 | 探索式測試 | 自動化測試 |
510
550
  |------|-----------|-----------|
511
551
  | **目的** | 發現未知缺陷 | 防止已知回歸 |
512
- | **時機** | 新功能、風險區域、發布前 | 每次 build、CI |
513
- | **優勢** | 創造力、適應性 | 速度、可重複性 |
552
+ | **時機** | 新功能、風險區域、發布前 | 每次 build、持續整合 |
553
+ | **優勢** | 創造力、適應性、情境理解 | 速度、可重複性、覆蓋率 |
554
+ | **成本** | 每個 session 的人力投入 | 長期的維護成本 |
555
+
556
+ **發現到保護循環**:
514
557
 
515
- **發現到保護循環**:探索 → 記錄 → 自動化 → 保護 → 重複
558
+ 1. **探索** — 進行探索式 session,發現新缺陷
559
+ 2. **回報** — 在 session 記錄中記錄發現的 Bug
560
+ 3. **自動化** — 將已確認的 Bug 轉為自動化迴歸測試
561
+ 4. **保護** — 自動化測試防止問題在未來的 build 中再次發生
562
+ 5. **重複** — 新的探索式 session 聚焦於尚未探索的區域
516
563
 
517
- > **規則**:透過探索式測試發現的每個 Bug 應在同一 Sprint 內新增對應的自動化迴歸測試。
564
+ > **規則**:透過探索式測試發現的每個 Bug **應該**在同一 Sprint 內新增對應的自動化迴歸測試。這能將一次性的發現轉化為永久的保護。
518
565
 
519
566
  ---
520
567