universal-dev-standards 6.14.0-beta.1 → 6.14.0-beta.10

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 (688) hide show
  1. package/README.md +13 -3
  2. package/bin/uds.js +75 -3
  3. package/bundled/ai/options/code-review/pr-review.ai.yaml +20 -1
  4. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  5. package/bundled/ai/standards/ai-response-navigation.ai.yaml +43 -3
  6. package/bundled/ai/standards/checkin-standards.ai.yaml +25 -6
  7. package/bundled/ai/standards/code-review.ai.yaml +15 -2
  8. package/bundled/ai/standards/commit-message.ai.yaml +18 -4
  9. package/bundled/ai/standards/developer-memory.ai.yaml +12 -2
  10. package/bundled/ai/standards/full-coverage-testing.ai.yaml +86 -7
  11. package/bundled/ai/standards/open-work-tracking.ai.yaml +196 -11
  12. package/bundled/ai/standards/pipeline-security-gates.ai.yaml +53 -4
  13. package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
  14. package/bundled/core/ai-response-navigation.md +128 -12
  15. package/bundled/core/code-review-checklist.md +20 -2
  16. package/bundled/core/commit-message-guide.md +22 -19
  17. package/bundled/core/developer-memory.md +12 -2
  18. package/bundled/core/full-coverage-testing.md +99 -5
  19. package/bundled/core/open-work-tracking.md +157 -17
  20. package/bundled/core/pipeline-security-gates.md +63 -0
  21. package/bundled/core/project-context-memory.md +10 -2
  22. package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
  23. package/bundled/extensions/languages/csharp-style.md +464 -0
  24. package/bundled/extensions/languages/php-style.md +700 -0
  25. package/bundled/extensions/locales/zh-cn.md +717 -0
  26. package/bundled/extensions/locales/zh-tw.md +717 -0
  27. package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
  28. package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
  29. package/bundled/locales/COVERAGE.md +5 -4
  30. package/bundled/locales/zh-CN/CHANGELOG.md +199 -3
  31. package/bundled/locales/zh-CN/README.md +3 -3
  32. package/bundled/locales/zh-CN/SECURITY.md +3 -2
  33. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  34. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
  35. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  36. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
  37. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
  38. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
  39. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
  40. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  41. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  42. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  43. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  44. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  45. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  46. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  47. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  48. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  49. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  50. package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
  51. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  52. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  53. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  54. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  55. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  56. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  57. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  58. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  59. package/bundled/locales/zh-CN/core/code-review-checklist.md +54 -23
  60. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  61. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  62. package/bundled/locales/zh-CN/core/developer-memory.md +159 -60
  63. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  64. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  65. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  66. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  67. package/bundled/locales/zh-CN/core/full-coverage-testing.md +103 -9
  68. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  69. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  70. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  71. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  72. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  73. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  74. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  75. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  76. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  77. package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
  78. package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
  79. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  80. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  81. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  82. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  83. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  84. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  85. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  86. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  87. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  88. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  89. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  90. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  91. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  92. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  93. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  94. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  95. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  96. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  97. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  98. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  99. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  100. package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
  101. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +9 -3
  102. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  103. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +68 -33
  104. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +29 -15
  105. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  106. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
  107. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  108. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
  109. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  110. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  111. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +46 -0
  112. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  113. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  114. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  115. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  116. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  117. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  118. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  119. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  120. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  121. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  122. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  123. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  124. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  125. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  126. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  127. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  128. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  129. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  130. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  131. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  132. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  133. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  134. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  135. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  136. package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
  137. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  138. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  139. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  140. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  141. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  142. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  143. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  144. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  145. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  146. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  147. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  148. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  149. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  150. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  151. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  152. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  153. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  154. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  155. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  156. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  157. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  158. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  159. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  160. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  161. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  162. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  163. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  164. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  165. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  166. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  167. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  168. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  169. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  170. package/bundled/locales/zh-CN/skills/README.md +3 -1
  171. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  172. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  173. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  174. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  175. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  176. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  177. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  178. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  179. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  180. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  181. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  182. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  183. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  184. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  185. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  186. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  187. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  188. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  189. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  190. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  191. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  192. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  193. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  194. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  195. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  196. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  197. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  198. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  199. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  200. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  201. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  202. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  203. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  204. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  205. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  206. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  207. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  208. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  209. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  210. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  211. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  212. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  213. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  214. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  215. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  216. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  217. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  218. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  219. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  220. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  221. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  222. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  223. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  224. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  225. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  226. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  227. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  228. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  229. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  230. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  231. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  232. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  233. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  234. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  235. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  236. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  237. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  238. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  239. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  240. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  241. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  242. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  243. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  244. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  245. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -2
  246. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  247. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  248. package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
  249. package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
  250. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  251. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  252. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  253. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  254. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  255. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  256. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  257. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  258. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  259. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  260. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  261. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  262. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  263. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  264. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  265. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  266. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  267. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  268. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  269. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  270. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  271. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  272. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  273. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  274. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  275. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  276. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  277. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  278. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  279. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  280. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  281. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  282. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  283. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  284. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  285. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  286. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  287. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  288. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  289. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  290. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  291. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  292. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  293. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  294. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  295. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  296. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  297. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  298. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  299. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  300. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  301. package/bundled/locales/zh-TW/CHANGELOG.md +199 -3
  302. package/bundled/locales/zh-TW/README.md +3 -3
  303. package/bundled/locales/zh-TW/SECURITY.md +3 -2
  304. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  305. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
  306. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  307. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
  308. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
  309. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
  310. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
  311. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  312. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  313. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  314. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  315. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  316. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  317. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  318. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  319. package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
  320. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  321. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  322. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  323. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  324. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  325. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  326. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  327. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  328. package/bundled/locales/zh-TW/core/code-review-checklist.md +36 -7
  329. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  330. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  331. package/bundled/locales/zh-TW/core/developer-memory.md +111 -12
  332. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  333. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  334. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  335. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  336. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  337. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  338. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  339. package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
  340. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  341. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  342. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  343. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  344. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  345. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  346. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  347. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  348. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  349. package/bundled/locales/zh-TW/core/open-work-tracking.md +92 -16
  350. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  351. package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
  352. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  353. package/bundled/locales/zh-TW/core/project-context-memory.md +215 -31
  354. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  355. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  356. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  357. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  358. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  359. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  360. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  361. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  362. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  363. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  364. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  365. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  366. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  367. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  368. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  369. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  370. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  371. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  372. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  373. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  374. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  375. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  376. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  377. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  378. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  379. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  380. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  381. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  382. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  383. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  384. package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
  385. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +9 -3
  386. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  387. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +61 -26
  388. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  389. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +29 -15
  390. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  391. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
  392. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  393. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
  394. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  395. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  396. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +46 -0
  397. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  398. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  399. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  400. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  401. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  402. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  403. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  404. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  405. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  406. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  407. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  408. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  409. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  410. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  411. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  412. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  413. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  414. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  415. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  416. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  417. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  418. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  419. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  420. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  421. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  422. package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
  423. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  424. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  425. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  426. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  427. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  428. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  429. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  430. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  431. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  432. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  433. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  434. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  435. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  436. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  437. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  438. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  439. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  440. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  441. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  442. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  443. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  444. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  445. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  446. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  447. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  448. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  449. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  450. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  451. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  452. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  453. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  454. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  455. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  456. package/bundled/locales/zh-TW/skills/README.md +3 -1
  457. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  458. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  459. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  460. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  461. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  462. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  463. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  464. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  465. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  466. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  467. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  468. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  469. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  470. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  471. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  472. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  473. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  474. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  475. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  476. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  477. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  478. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  479. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  480. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  481. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  482. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  483. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  484. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  485. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  486. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  487. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  488. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  489. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  490. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  491. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  492. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  493. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  494. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  495. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  496. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  497. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  498. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  499. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  500. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  501. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  502. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  503. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  504. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  505. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  506. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  507. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  508. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  509. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  510. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  511. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  512. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  513. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  514. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  515. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  516. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  517. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  518. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  519. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  520. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  521. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  522. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  523. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  524. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  525. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  526. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  527. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  528. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  529. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  530. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  531. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  532. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  533. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  534. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  535. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  536. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  537. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  538. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  539. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  540. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  541. package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
  542. package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
  543. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  544. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  545. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  546. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  547. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  548. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  549. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  550. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  551. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  552. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  553. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  554. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  555. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  556. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  557. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  558. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  559. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  560. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  561. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  562. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  563. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  564. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  565. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  566. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  567. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  568. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  569. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  570. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  571. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  572. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  573. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  574. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  575. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  576. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  577. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  578. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  579. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  580. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  581. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  582. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  583. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  584. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  585. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  586. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  587. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  588. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  589. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  590. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  591. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  592. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  593. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  594. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  595. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  596. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  597. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  598. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  599. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  600. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  601. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  602. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  603. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  604. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  605. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  606. package/bundled/skills/README.md +1 -0
  607. package/bundled/skills/SKILL_NAMING.md +9 -0
  608. package/bundled/skills/commit-standards/SKILL.md +2 -2
  609. package/bundled/skills/commit-standards/guide.md +3 -2
  610. package/bundled/skills/commit-standards/language-options.md +19 -17
  611. package/bundled/skills/comprehension-ladder/SKILL.md +283 -0
  612. package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
  613. package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
  614. package/bundled/templates/gates/check-stubs.mjs +644 -0
  615. package/package.json +5 -3
  616. package/src/commands/audit.js +20 -2
  617. package/src/commands/check.js +155 -28
  618. package/src/commands/deps.js +31 -1
  619. package/src/commands/hitl.js +3 -0
  620. package/src/commands/init.js +159 -48
  621. package/src/commands/list.js +12 -3
  622. package/src/commands/mcp.js +2 -3
  623. package/src/commands/open-work.js +123 -0
  624. package/src/commands/quickstart.js +29 -13
  625. package/src/commands/release.js +102 -19
  626. package/src/commands/run-intent.js +10 -0
  627. package/src/commands/simulate.js +20 -8
  628. package/src/commands/skills.js +59 -33
  629. package/src/commands/spec-split.js +30 -17
  630. package/src/commands/spec.js +55 -21
  631. package/src/commands/uninstall.js +146 -32
  632. package/src/commands/update.js +471 -93
  633. package/src/core/install-records.js +192 -0
  634. package/src/core/manifest.js +12 -10
  635. package/src/core/marketplace-sentinel.js +5 -0
  636. package/src/core/open-work-config.js +122 -0
  637. package/src/core/project-config.js +92 -38
  638. package/src/flows/init-flow.js +10 -0
  639. package/src/hitl/manager.js +4 -2
  640. package/src/i18n/messages.js +413 -78
  641. package/src/installers/hooks-installer.js +236 -27
  642. package/src/installers/integration-installer.js +5 -1
  643. package/src/installers/skills-installer.js +3 -1
  644. package/src/installers/standards-installer.js +16 -23
  645. package/src/mcp/__tests__/server.test.js +0 -1
  646. package/src/mcp/server.js +16 -4
  647. package/src/prompts/init.js +148 -13
  648. package/src/reconciler/backup-locations.js +80 -0
  649. package/src/reconciler/backup-manager.js +451 -123
  650. package/src/reconciler/index.js +86 -10
  651. package/src/reconciler/install-roots.js +90 -0
  652. package/src/reconciler/plan-executor.js +37 -15
  653. package/src/uninstallers/hook-uninstaller.js +220 -33
  654. package/src/uninstallers/integration-uninstaller.js +35 -5
  655. package/src/uninstallers/skills-uninstaller.js +95 -16
  656. package/src/uninstallers/standards-uninstaller.js +56 -7
  657. package/src/utils/agents-installer.js +10 -17
  658. package/src/utils/available-standards-report.js +144 -0
  659. package/src/utils/available-standards.js +216 -0
  660. package/src/utils/command-hash-ownership.js +103 -0
  661. package/src/utils/commit-message-judge.js +155 -0
  662. package/src/utils/copier.js +80 -2
  663. package/src/utils/deps-applicability.js +25 -0
  664. package/src/utils/detector.js +46 -1
  665. package/src/utils/friction-detector.js +27 -0
  666. package/src/utils/gate-scripts.js +141 -0
  667. package/src/utils/git-hooks.js +139 -7
  668. package/src/utils/hasher.js +36 -0
  669. package/src/utils/health-scorer.js +10 -7
  670. package/src/utils/installed-names-ownership.js +114 -0
  671. package/src/utils/integration-generator.js +36 -24
  672. package/src/utils/legacy-hook-migration.js +112 -0
  673. package/src/utils/locale.js +19 -0
  674. package/src/utils/open-work-tracking.mjs +1754 -0
  675. package/src/utils/prompt-closed.js +18 -0
  676. package/src/utils/sdd-header.js +66 -0
  677. package/src/utils/skill-frontmatter.js +102 -0
  678. package/src/utils/skill-hash-ownership.js +64 -0
  679. package/src/utils/skill-name-collision.js +169 -0
  680. package/src/utils/skills-install-paths.js +114 -0
  681. package/src/utils/skills-installer.js +75 -106
  682. package/src/utils/standard-validator.js +98 -27
  683. package/src/utils/test-change-check.js +160 -0
  684. package/src/utils/test-policy.js +214 -0
  685. package/src/utils/transient-fs.js +113 -0
  686. package/src/utils/update-summary.js +29 -0
  687. package/src/vibe/micro-spec.js +15 -0
  688. package/standards-registry.json +48 -9
@@ -2,23 +2,27 @@
2
2
  source: ../../../core/test-completeness-dimensions.md
3
3
  source_version: 1.1.0
4
4
  translation_version: 1.1.0
5
- last_synced: 2026-01-24
5
+ last_synced: 2026-10-11
6
+ source_hash: 13876de2fdea
6
7
  status: current
7
8
  ---
8
9
 
9
10
  # 测试完整性维度
10
11
 
11
- **版本**: 1.0.0
12
- **最后更新**: 2025-12-24
13
- **适用范围**: 所有需要测试的软体专案
12
+ **版本**: 1.1.0
13
+ **最后更新**: 2026-01-24
14
+ **适用范围**: 所有有测试需求的软件项目
15
+ **范围**: universal
16
+ **行业标准**: ISTQB AI Testing Syllabus
17
+ **参考资料**: [istqb.org](https://istqb.org/certifications/certified-tester-ai-testing-ct-ai/)
14
18
 
15
- [English](../../../core/test-completeness-dimensions.md) | [繁体中文](.)
19
+ [English](../../../core/test-completeness-dimensions.md) | [繁體中文](../../zh-TW/core/test-completeness-dimensions.md) | 简体中文
16
20
 
17
21
  ---
18
22
 
19
23
  ## 目的
20
24
 
21
- 本文件定义评估测试完整性的系统性框架。为开发者提供检核清单,确保测试覆盖多个维度。
25
+ 本文档定义评估测试完整性的系统性框架。为开发者提供检查清单,确保测试在多个维度上得到全面覆盖。
22
26
 
23
27
  ---
24
28
 
@@ -27,18 +31,18 @@ status: current
27
31
  完整的测试套件应为每个功能涵盖以下 8 个维度:
28
32
 
29
33
  ```
30
- ┌──────────────────────────────────────────────────────────────────┐
31
- │ 测试完整性 = 8 个维度 │
32
- ├──────────────────────────────────────────────────────────────────┤
33
- │ 1. 正向路径 正常预期行为 │
34
- │ 2. 边界条件 最小/最大值、限制 │
35
- │ 3. 错误处理 无效输入、异常状况 │
36
- │ 4. 权限验证 角色访问控制 │
37
- │ 5. 状态转换 前后验证 │
38
- │ 6. 验证逻辑 格式、业务规则 │
39
- │ 7. 集成验证 实际查询验证 │
40
- │ 8. AI 生成质量 AI 测试的有效性评估 │
41
- └──────────────────────────────────────────────────────────────────┘
34
+ ┌─────────────────────────────────────────────────────────────┐
35
+ │ Test Completeness = 8 Dimensions │
36
+ ├─────────────────────────────────────────────────────────────┤
37
+ │ 1. Happy Path Normal expected behavior │
38
+ │ 2. Boundary Min/max values, limits │
39
+ │ 3. Error Handling Invalid input, exceptions │
40
+ │ 4. Authorization Role-based access control │
41
+ │ 5. State Changes Before/after verification │
42
+ │ 6. Validation Format, business rules │
43
+ │ 7. Integration Real query verification │
44
+ │ 8. AI Generation AI-generated test quality (NEW) │
45
+ └─────────────────────────────────────────────────────────────┘
42
46
  ```
43
47
 
44
48
  ---
@@ -47,15 +51,15 @@ status: current
47
51
 
48
52
  ### 1. 正向路径
49
53
 
50
- 测试使用有效输入的正常预期流程。
54
+ 使用有效输入测试正常的预期流程。
51
55
 
52
- **测试内容**:
56
+ **测试内容**:
53
57
  - 有效输入产生预期输出
54
- - 成功状态码/回应
55
- - 资料正确建立/修改
58
+ - 成功状态码/响应
59
+ - 数据被正确创建/修改
56
60
  - 副作用如预期发生
57
61
 
58
- **范例**:
62
+ **示例**:
59
63
  ```csharp
60
64
  [Fact]
61
65
  public async Task CreateUser_WithValidData_ReturnsSuccess()
@@ -83,14 +87,14 @@ public async Task CreateUser_WithValidData_ReturnsSuccess()
83
87
 
84
88
  测试有效范围边缘的值。
85
89
 
86
- **测试内容**:
90
+ **测试内容**:
87
91
  - 最小有效值
88
92
  - 最大有效值
89
93
  - 略小于最小值(无效)
90
94
  - 略大于最大值(无效)
91
95
  - 空集合 vs. 单一项目 vs. 多个项目
92
96
 
93
- **范例**:
97
+ **示例**:
94
98
  ```csharp
95
99
  [Theory]
96
100
  [InlineData(0, false)] // Below minimum
@@ -127,14 +131,14 @@ public async Task BatchProcess_ExceedingLimit_ReturnsError()
127
131
 
128
132
  测试系统如何处理无效输入和异常状况。
129
133
 
130
- **测试内容**:
134
+ **测试内容**:
131
135
  - 无效输入格式
132
- - 缺少必填栏位
133
- - 重复资料冲突
136
+ - 缺少必填字段
137
+ - 重复数据冲突
134
138
  - 资源未找到
135
139
  - 外部服务故障
136
140
 
137
- **范例**:
141
+ **示例**:
138
142
  ```csharp
139
143
  [Fact]
140
144
  public async Task CreateUser_DuplicateEmail_ReturnsConflict()
@@ -189,15 +193,15 @@ public async Task CreateUser_MissingRequiredFields_ReturnsValidationError()
189
193
 
190
194
  ### 4. 权限验证
191
195
 
192
- 测试每个操作的角色存取控制。
196
+ 测试每个操作的基于角色的访问控制。
193
197
 
194
- **测试内容**:
198
+ **测试内容**:
195
199
  - 每个角色允许的操作
196
- - 每个角色拒绝的操作
197
- - 未认证存取
198
- - 跨租户/跨使用者资料存取
200
+ - 每个角色被拒绝的操作
201
+ - 未认证访问
202
+ - 跨租户/跨用户数据访问
199
203
 
200
- **权限测试矩阵**:
204
+ **权限测试矩阵**:
201
205
 
202
206
  为每个功能建立矩阵:
203
207
 
@@ -208,9 +212,9 @@ public async Task CreateUser_MissingRequiredFields_ReturnsValidationError()
208
212
  | Update | ✅ | ⚠️ Own dept | ❌ | ❌ |
209
213
  | Delete | ✅ | ❌ | ❌ | ❌ |
210
214
 
211
- 每个储存格应有对应的测试案例。
215
+ 每个单元格都应有对应的测试用例。
212
216
 
213
- **范例**:
217
+ **示例**:
214
218
  ```csharp
215
219
  [Fact]
216
220
  public async Task DeleteUser_AsAdmin_Succeeds()
@@ -257,15 +261,15 @@ public async Task GetUsers_AsManager_ReturnsOnlyDepartmentMembers()
257
261
 
258
262
  ### 5. 状态转换
259
263
 
260
- 验证操作正确修改系统状态。
264
+ 验证操作是否正确修改系统状态。
261
265
 
262
- **测试内容**:
263
- - 操作前状态
264
- - 操作后状态
265
- - 状态转换(enabled → disabled, pending → approved)
266
- - 幂等性(重复操作有相同结果)
266
+ **测试内容**:
267
+ - 操作前的状态
268
+ - 操作后的状态
269
+ - 状态转换(enabled → disabled,pending → approved)
270
+ - 幂等性(重复操作得到相同结果)
267
271
 
268
- **范例**:
272
+ **示例**:
269
273
  ```csharp
270
274
  [Fact]
271
275
  public async Task DisableUser_UpdatesStateCorrectly()
@@ -305,13 +309,13 @@ public async Task EnableUser_FromDisabledState_UpdatesStateCorrectly()
305
309
 
306
310
  测试业务规则和格式验证。
307
311
 
308
- **测试内容**:
312
+ **测试内容**:
309
313
  - 格式验证(email、phone 等)
310
314
  - 业务规则验证
311
- - 跨栏位验证
312
- - 特定领域限制
315
+ - 跨字段验证
316
+ - 特定领域约束
313
317
 
314
- **范例**:
318
+ **示例**:
315
319
  ```csharp
316
320
  [Theory]
317
321
  [InlineData("user@example.com", true)]
@@ -367,19 +371,19 @@ public async Task CreateOrder_QuantityExceedsStock_ReturnsBusinessRuleError()
367
371
 
368
372
  ### 7. 集成验证
369
373
 
370
- 验证实际资料库查询和外部集成正确运作。
374
+ 验证实际的数据库查询和外部集成是否正确运作。
371
375
 
372
- **何时需要**:
376
+ **何时需要**:
373
377
 
374
- 根据[测试标准](testing-standards.md)(或 `/testing-guide` 技能),如果单元测试对查询参数使用万用匹配器(`It.IsAny<>`, `any()`, `Arg.Any<>`),必须有集成测试。
378
+ 根据[测试标准](testing-standards.md)(或 `/testing-guide` 技能),如果单元测试对查询参数使用通配匹配器(`It.IsAny<>`、`any()`、`Arg.Any<>`),则必须有集成测试。
375
379
 
376
- **测试内容**:
377
- - 查询述词回传正确资料
378
- - 实体关联正确载入
380
+ **测试内容**:
381
+ - 查询谓词返回正确数据
382
+ - 实体关联被正确加载
379
383
  - 分页正确运作
380
384
  - 排序和筛选正确运作
381
385
 
382
- **范例**:
386
+ **示例**:
383
387
  ```csharp
384
388
  // Unit test - cannot verify query logic
385
389
  [Fact]
@@ -418,165 +422,230 @@ public async Task GetActiveUsers_RealDatabase_ReturnsOnlyActiveUsers()
418
422
 
419
423
  ### 8. AI 生成质量
420
424
 
421
- 评估 AI 生成测试的有效性和可维护性。
425
+ 评估 AI 生成测试的质量与有效性。
422
426
 
423
- **何时需要**:
427
+ **为何此维度重要**:
424
428
 
425
- 当使用 AI 工具(GitHub Copilot、Claude、ChatGPT)生成测试时,需评估其质量。
429
+ AI 编程助手可以快速生成测试,但数量 ≠ 质量。此维度确保 AI 生成的测试提供真正的价值。
426
430
 
427
- **评估标准**:
431
+ **质量评估标准**:
428
432
 
429
- | 标准 | 说明 | 通过条件 |
430
- |------|------|---------|
431
- | **意图清晰** | 测试目的明确 | 测试名称描述行为 |
432
- | **独立性** | 测试互不依赖 | 可单独执行通过 |
433
- | **断言有效** | 断言验证正确行为 | 非仅检查 "not null" |
434
- | **边界覆盖** | 含边界案例 | 最小/最大值已测试 |
435
- | **可读性** | 代码易理解 | 无需注释即可理解 |
433
+ | 标准 | 低质量 | 高质量 |
434
+ |------|--------|--------|
435
+ | **测试目的** | 测试显而易见的 getter/setter | 测试业务逻辑与边界情况 |
436
+ | **断言深度** | 仅有 `result != null` | 验证具体的值与状态 |
437
+ | **独立性** | 测试依赖执行顺序 | 每个测试自给自足 |
438
+ | **命名** | `test1`、`test2` | 描述性名称:`should_reject_invalid_email` |
439
+ | **覆盖意图** | 覆盖代码行而非行为 | 有意义地覆盖所有代码路径 |
440
+
441
+ **AI 测试生成检查清单**:
436
442
 
437
- **评估范例**:
443
+ ```
444
+ □ Test Purpose Verification
445
+ □ Does the test verify meaningful behavior?
446
+ □ Would a bug cause the test to fail?
447
+ □ Is the test testing the right thing?
448
+
449
+ □ Assertion Quality
450
+ □ Are assertions specific (not just "not null")?
451
+ □ Do assertions verify the expected output values?
452
+ □ Are edge cases in assertions covered?
453
+
454
+ □ Test Independence
455
+ □ Can tests run in any order?
456
+ □ Does each test set up its own data?
457
+ □ No shared mutable state between tests?
458
+
459
+ □ Mutation Score
460
+ □ Would mutations in the code be caught?
461
+ □ Does the test fail when logic is changed?
462
+ ```
463
+
464
+ **示例 - 评估 AI 生成的测试**:
438
465
 
439
466
  ```csharp
440
- // ❌ 差:AI 生成的低质量测试
467
+ // ❌ Poor AI-generated test - tests almost nothing
441
468
  [Fact]
442
- public void Test1()
469
+ public void CalculateDiscount_Test()
443
470
  {
444
- var result = _service.Process(null);
445
- Assert.NotNull(result); // 仅检查非空
471
+ var service = new PricingService();
472
+ var result = service.CalculateDiscount(100, "VIP");
473
+ Assert.NotNull(result); // Only checks not null!
446
474
  }
447
475
 
448
- // ✅ 好:AI 生成的高质量测试
476
+ // ✅ Good test - verifies specific business logic
449
477
  [Fact]
450
- public void Process_WithEmptyInput_ReturnsEmptyResult()
478
+ public void CalculateDiscount_VipCustomer_Returns20PercentDiscount()
451
479
  {
452
480
  // Arrange
453
- var input = Array.Empty<Item>();
481
+ var service = new PricingService();
482
+ var originalPrice = 100m;
483
+ var customerType = "VIP";
454
484
 
455
485
  // Act
456
- var result = _service.Process(input);
486
+ var result = service.CalculateDiscount(originalPrice, customerType);
457
487
 
458
488
  // Assert
459
- result.Should().BeEmpty();
460
- result.ProcessedAt.Should().BeCloseTo(DateTime.UtcNow, TimeSpan.FromSeconds(1));
489
+ result.DiscountAmount.Should().Be(20m); // VIP gets 20%
490
+ result.FinalPrice.Should().Be(80m);
491
+ result.DiscountType.Should().Be("VIP_DISCOUNT");
461
492
  }
462
493
  ```
463
494
 
464
- **AI 测试反模式**:
495
+ **AI 测试质量指标**:
465
496
 
466
- | 反模式 | 问题 | 修正 |
467
- |--------|------|------|
468
- | 仅检查非空 | 无实际验证 | 断言具体值 |
469
- | 硬编码魔术值 | 难以维护 | 使用常量或工厂 |
470
- | 测试名称如 `Test1` | 无法理解意图 | 使用描述性名称 |
471
- | 无边界案例 | 覆盖不完整 | 加入边界测试 |
497
+ | 指标 | 目标 | 测量方式 |
498
+ |------|------|---------|
499
+ | 变异分数 | > 80% | 被杀死的变异 / 变异总数 |
500
+ | 断言密度 | 每个测试 > 2 | 断言数 / 测试数 |
501
+ | 行为覆盖率 | 100% | 已测试的业务规则 / 规则总数 |
502
+ | 边界情况覆盖率 | > 90% | 已测试的边界情况 / 已识别的边界情况 |
472
503
 
473
504
  ---
474
505
 
475
506
  ## Mutation Testing
476
507
 
477
- ### 概念
508
+ ### 概述
478
509
 
479
- Mutation Testing 通过在代码中引入小变异(mutations)来评估测试质量。如果测试套件未能检测到变异,表示测试不够强健。
510
+ Mutation Testing(变异测试)通过对代码引入微小改动(变异),并检查测试是否能捕获这些改动,来验证测试的有效性。
480
511
 
481
- ### 变异操作符
512
+ ```
513
+ ┌─────────────────────────────────────────────────────────────┐
514
+ │ Mutation Testing Flow │
515
+ ├─────────────────────────────────────────────────────────────┤
516
+ │ │
517
+ │ Original Code Mutate Mutated Code │
518
+ │ ────────────── ──────► ────────────── │
519
+ │ if (x > 0) if (x >= 0) ← mutation │
520
+ │ │
521
+ │ Run Tests │
522
+ │ ──────────► │
523
+ │ │
524
+ │ Test FAILS? → Mutation KILLED ✅ (test is effective) │
525
+ │ Test PASSES? → Mutation SURVIVED ❌ (test is weak) │
526
+ │ │
527
+ │ Mutation Score = Killed / Total Mutations │
528
+ │ │
529
+ └─────────────────────────────────────────────────────────────┘
530
+ ```
531
+
532
+ ### 常见变异操作符
482
533
 
483
- | 操作符 | 原始 | 变异 |
484
- |--------|------|------|
485
- | 关系运算符 | `>` | `>=`, `<`, `==` |
486
- | 算术运算符 | `+` | `-`, `*` |
487
- | 逻辑运算符 | `&&` | `\|\|` |
488
- | 返回值 | `return x` | `return null` |
489
- | 条件边界 | `i < 10` | `i <= 10` |
534
+ | 操作符 | 原始 | 变异后 | 测试应捕获 |
535
+ |--------|------|--------|-----------|
536
+ | 边界 | `>` | `>=` | 差一错误(off-by-one) |
537
+ | 取反 | `true` | `false` | 布尔逻辑 |
538
+ | 算术 | `+` | `-` | 数学运算 |
539
+ | 返回值 | `return x` | `return null` | 返回值的使用 |
540
+ | 移除调用 | `validate()` | (已移除) | 副作用 |
541
+ | 常量 | `0` | `1` | 魔术数字的使用 |
490
542
 
491
- ### 工具推荐
543
+ ### Mutation Testing 工具
492
544
 
493
545
  | 语言 | 工具 | 链接 |
494
546
  |------|------|------|
495
- | JavaScript/TypeScript | Stryker | stryker-mutator.io |
496
- | Java | PIT | pitest.org |
497
- | C# | Stryker.NET | stryker-mutator.io/docs/stryker-net |
498
- | Python | mutmut | github.com/boxed/mutmut |
547
+ | Java | PIT | https://pitest.org/ |
548
+ | JavaScript/TypeScript | Stryker | https://stryker-mutator.io/ |
549
+ | C# | Stryker.NET | https://stryker-mutator.io/docs/stryker-net/ |
550
+ | Python | mutmut | https://github.com/boxed/mutmut |
551
+ | Go | go-mutesting | https://github.com/zimmski/go-mutesting |
499
552
 
500
553
  ### 结果解读
501
554
 
502
- | 指标 | 意义 | 目标 |
503
- |------|------|------|
504
- | 杀死的变异 | 测试检测到变异 | 越高越好 |
505
- | 存活的变异 | 测试未检测到 | 需要加强测试 |
506
- | 变异分数 | 杀死数 / 总数 | > 80% |
555
+ | 变异分数 | 解读 | 行动 |
556
+ |----------|------|------|
557
+ | > 90% | 优秀 | 维持此水平 |
558
+ | 80-90% | 良好 | 检查存活的变异 |
559
+ | 60-80% | 尚可 | 补充缺失的测试用例 |
560
+ | < 60% | 较差 | 存在明显的测试缺口 |
507
561
 
508
- ### 范例配置 (Stryker)
562
+ ### 示例:Stryker 配置
509
563
 
510
564
  ```json
565
+ // stryker.config.json (JavaScript/TypeScript)
511
566
  {
512
- "stryker": {
513
- "mutate": ["src/**/*.ts", "!src/**/*.spec.ts"],
514
- "testRunner": "jest",
515
- "reporters": ["html", "clear-text"],
516
- "thresholds": {
517
- "high": 80,
518
- "low": 60,
519
- "break": 50
520
- }
567
+ "packageManager": "npm",
568
+ "reporters": ["html", "clear-text", "progress"],
569
+ "testRunner": "jest",
570
+ "coverageAnalysis": "perTest",
571
+ "mutate": [
572
+ "src/**/*.ts",
573
+ "!src/**/*.spec.ts",
574
+ "!src/**/*.test.ts"
575
+ ],
576
+ "thresholds": {
577
+ "high": 80,
578
+ "low": 60,
579
+ "break": 50
521
580
  }
522
581
  }
523
582
  ```
524
583
 
584
+ ### 何时使用 Mutation Testing
585
+
586
+ | 场景 | 建议 |
587
+ |------|------|
588
+ | 关键业务逻辑 | ✅ 是 |
589
+ | 安全敏感代码 | ✅ 是 |
590
+ | AI 生成测试之后 | ✅ 是 |
591
+ | 简单 CRUD 操作 | ⚠️ 可选 |
592
+ | UI/展示层代码 | ❌ 通常不值得 |
593
+
525
594
  ---
526
595
 
527
- ## 测试案例设计清单
596
+ ## 测试用例设计清单
528
597
 
529
- 使用此清单检核每个功能的完整性:
598
+ 对每个功能使用此清单以确保完整性:
530
599
 
531
600
  ```
532
- 功能: ___________________
533
-
534
- □ 正向路径
535
- □ 有效输入产生预期成功
536
- □ 回传/建立正确资料
537
- □ 副作用如预期发生
538
-
539
- □ 边界条件
540
- □ 最小有效值
541
- □ 最大有效值
542
- □ 空集合
543
- □ 单一项目集合
544
- □ 大型集合(如适用)
545
-
546
- □ 错误处理
547
- □ 无效输入格式
548
- □ 缺少必填栏位
549
- □ 重复/冲突情境
550
- □ 未找到情境
551
- □ 外部服务故障(如适用)
552
-
553
- □ 权限验证
554
- □ 每个允许角色已测试
555
- □ 每个拒绝角色已测试
556
- □ 未认证存取已测试
557
- □ 跨边界存取已测试
558
-
559
- □ 状态变更
560
- □ 初始状态已验证
561
- □ 最终状态已验证
562
- □ 所有有效状态转换已测试
563
-
564
- □ 验证
565
- □ 格式验证(email、phone 等)
566
- □ 业务规则验证
567
- □ 跨栏位验证
568
-
569
- □ 集成(如果单元测试使用万用匹配器)
570
- □ 查询述词已验证
571
- □ 实体关联已验证
572
- □ 分页已验证
573
- □ 排序/筛选已验证
574
-
575
- □ AI 生成质量(如使用 AI 生成测试)
576
- □ 测试意图清晰
577
- □ 断言验证具体值
578
- □ 包含边界案例
579
- □ 测试名称描述行为
601
+ Feature: ___________________
602
+
603
+ □ Happy Path
604
+ □ Valid input produces expected success
605
+ □ Correct data is returned/created
606
+ □ Side effects occur as expected
607
+
608
+ □ Boundary Conditions
609
+ □ Minimum valid value
610
+ □ Maximum valid value
611
+ □ Empty collection
612
+ □ Single item collection
613
+ □ Large collection (if applicable)
614
+
615
+ □ Error Handling
616
+ □ Invalid input format
617
+ □ Missing required fields
618
+ □ Duplicate/conflict scenarios
619
+ □ Not found scenarios
620
+ □ External service failure (if applicable)
621
+
622
+ □ Authorization
623
+ □ Each permitted role tested
624
+ □ Each denied role tested
625
+ □ Unauthenticated access tested
626
+ □ Cross-boundary access tested
627
+
628
+ □ State Changes
629
+ □ Initial state verified
630
+ □ Final state verified
631
+ □ All valid state transitions tested
632
+
633
+ □ Validation
634
+ □ Format validation (email, phone, etc.)
635
+ □ Business rule validation
636
+ □ Cross-field validation
637
+
638
+ □ Integration (if UT uses wildcards)
639
+ □ Query predicates verified
640
+ □ Entity relationships verified
641
+ □ Pagination verified
642
+ □ Sorting/filtering verified
643
+
644
+ □ AI Generation Quality (if AI-generated)
645
+ □ Tests verify meaningful behavior
646
+ □ Assertions are specific (not just "not null")
647
+ □ Mutation score > 80%
648
+ □ Edge cases covered
580
649
  ```
581
650
 
582
651
  ---
@@ -585,16 +654,16 @@ Mutation Testing 通过在代码中引入小变异(mutations)来评估测试
585
654
 
586
655
  对于有定义错误码的 API,确保每个错误码都有测试:
587
656
 
588
- | 代码 | 意义 | 测试情境 |
657
+ | 代码 | 意义 | 测试场景 |
589
658
  |------|------|----------|
590
659
  | 200 | 成功 | 正向路径测试 |
591
- | 400 | 错误请求 | 无效格式、缺少栏位 |
660
+ | 400 | 错误请求 | 无效格式、缺少字段 |
592
661
  | 401 | 未认证 | 无效/缺少 token |
593
- | 403 | 禁止 | 有效 token、权限不足 |
662
+ | 403 | 禁止访问 | 有效 token、权限不足 |
594
663
  | 404 | 未找到 | 不存在的资源 |
595
- | 409 | 冲突 | 重复资料 |
664
+ | 409 | 冲突 | 重复数据 |
596
665
  | 422 | 无法处理 | 违反业务规则 |
597
- | 500 | 服务器错误 | 例外处理 |
666
+ | 500 | 服务器错误 | 异常处理 |
598
667
 
599
668
  ---
600
669
 
@@ -611,7 +680,7 @@ Mutation Testing 通过在代码中引入小变异(mutations)来评估测试
611
680
  | 后台任务 | 1, 3, 5, 8* |
612
681
  | 外部集成 | 1, 3, 7, 8* |
613
682
 
614
- *维度 8 仅在使用 AI 生成测试时适用
683
+ *维度 8(AI 生成质量)仅在测试由 AI 生成时适用
615
684
 
616
685
  ---
617
686
 
@@ -620,21 +689,23 @@ Mutation Testing 通过在代码中引入小变异(mutations)来评估测试
620
689
  避免这些常见错误:
621
690
 
622
691
  ```
623
- ❌ 只测试正向路径
692
+ ❌ Testing only happy path
693
+
694
+ ❌ Missing authorization tests for multi-role systems
624
695
 
625
- ❌ 多角色系统缺少权限测试
696
+ ❌ Not verifying state changes
626
697
 
627
- ❌ 未验证状态变更
698
+ ❌ Using wildcards in UT without corresponding IT
628
699
 
629
- ❌ 单元测试使用万用匹配器但无对应集成测试
700
+ ❌ Same values for ID and business identifier in test data
630
701
 
631
- ❌ 测试数据的 ID 与业务标识码使用相同值
702
+ ❌ Testing implementation details instead of behavior
632
703
 
633
- ❌ 测试实现细节而非行为
704
+ ❌ Accepting AI-generated tests without review
634
705
 
635
- ❌ 盲目信任 AI 生成的测试而不审查
706
+ ❌ Assuming high line coverage means effective tests
636
707
 
637
- ❌ AI 测试仅检查非空而无具体断言
708
+ ❌ Skipping mutation testing for critical code
638
709
  ```
639
710
 
640
711
  ---
@@ -643,26 +714,27 @@ Mutation Testing 通过在代码中引入小变异(mutations)来评估测试
643
714
 
644
715
  - [测试驱动开发](test-driven-development.md) - TDD/BDD/ATDD 方法论
645
716
  - [测试标准](testing-standards.md) - 核心测试标准(或使用 `/testing-guide` 技能)
646
- - [程序码审查清单](code-review-checklist.md) - 审查测试完整性
647
- - [签入标准](checkin-standards.md) - 提交前测试需求
717
+ - [代码审查检查清单](code-review-checklist.md) - 审查测试完整性
718
+ - [签入标准](checkin-standards.md) - 提交前测试要求
648
719
 
649
720
  ---
650
721
 
651
- ## 版本历史
722
+ ## 参考资料
652
723
 
653
- | 版本 | 日期 | 变更 |
654
- |------|------|------|
655
- | 1.1.0 | 2026-01-24 | 新增:第 8 维度 AI 生成质量、Mutation Testing 章节 |
656
- | 1.0.0 | 2025-12-24 | 初始发布,包含 7 维度框架 |
724
+ - [ISTQB AI Testing Syllabus](https://www.istqb.org/certifications/ai-testing) - 基础级 AI 测试认证
725
+ - [Stryker Mutation Testing](https://stryker-mutator.io/) - 多语言 Mutation Testing 框架
726
+ - [PIT Mutation Testing](https://pitest.org/) - Java Mutation Testing
727
+ - [Google Testing Blog - Mutation Testing](https://testing.googleblog.com/2021/04/mutation-testing.html) - Google 对 Mutation Testing 的观点
728
+ - [ISTQB Foundation Level Syllabus](https://www.istqb.org/certifications/certified-tester-foundation-level) - 核心测试概念
657
729
 
658
730
  ---
659
731
 
660
- ## 参考资料
732
+ ## 版本历史
661
733
 
662
- - [ISTQB AI Testing Guidelines](https://www.istqb.org/) - 软件测试认证
663
- - [Stryker Mutator](https://stryker-mutator.io/) - JavaScript/TypeScript Mutation Testing
664
- - [PIT Mutation Testing](https://pitest.org/) - Java Mutation Testing
665
- - [Mutation Testing 概念](https://en.wikipedia.org/wiki/Mutation_testing) - Wikipedia
734
+ | 版本 | 日期 | 变更 |
735
+ |------|------|------|
736
+ | 1.1.0 | 2026-01-24 | 新增:第 8 维度(AI 生成质量)、Mutation Testing 章节 |
737
+ | 1.0.0 | 2025-12-24 | 初始发布,包含 7 维度框架 |
666
738
 
667
739
  ---
668
740