universal-dev-standards 6.13.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 (693) 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 +254 -4
  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/ai/standards/turn-completion-integrity.ai.yaml +14 -7
  15. package/bundled/core/ai-response-navigation.md +128 -12
  16. package/bundled/core/code-review-checklist.md +20 -2
  17. package/bundled/core/commit-message-guide.md +22 -19
  18. package/bundled/core/developer-memory.md +12 -2
  19. package/bundled/core/full-coverage-testing.md +99 -5
  20. package/bundled/core/open-work-tracking.md +251 -8
  21. package/bundled/core/pipeline-security-gates.md +63 -0
  22. package/bundled/core/project-context-memory.md +10 -2
  23. package/bundled/core/turn-completion-integrity.md +58 -11
  24. package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
  25. package/bundled/extensions/languages/csharp-style.md +464 -0
  26. package/bundled/extensions/languages/php-style.md +700 -0
  27. package/bundled/extensions/locales/zh-cn.md +717 -0
  28. package/bundled/extensions/locales/zh-tw.md +717 -0
  29. package/bundled/hooks/check-turn-completion-agy.mjs +147 -0
  30. package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
  31. package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
  32. package/bundled/locales/COVERAGE.md +5 -4
  33. package/bundled/locales/zh-CN/CHANGELOG.md +211 -3
  34. package/bundled/locales/zh-CN/README.md +3 -3
  35. package/bundled/locales/zh-CN/SECURITY.md +3 -1
  36. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  37. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
  38. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  39. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
  40. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
  41. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
  42. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
  43. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  44. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  45. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  46. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  47. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  48. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  49. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  50. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  51. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  52. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  53. package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
  54. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  55. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  56. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  57. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  58. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  59. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  60. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  61. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  62. package/bundled/locales/zh-CN/core/code-review-checklist.md +54 -23
  63. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  64. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  65. package/bundled/locales/zh-CN/core/developer-memory.md +159 -60
  66. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  67. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  68. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  69. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  70. package/bundled/locales/zh-CN/core/full-coverage-testing.md +103 -9
  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/pipeline-integration-standards.md +2 -1
  80. package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
  81. package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
  82. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  83. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  84. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  85. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  86. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  87. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  88. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  89. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  90. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  91. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  92. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  93. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  94. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  95. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  96. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  97. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  98. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  99. package/bundled/locales/zh-CN/core/turn-completion-integrity.md +46 -13
  100. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  101. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  102. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  103. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  104. package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
  105. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +11 -2
  106. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  107. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +76 -40
  108. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +32 -15
  109. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  110. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
  111. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  112. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
  113. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  114. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  115. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +46 -0
  116. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  117. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  118. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  119. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  120. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  121. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  122. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  123. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  124. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  125. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  126. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  127. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  128. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  129. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  130. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  131. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  132. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  133. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  134. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  135. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  136. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  137. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  138. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  139. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  140. package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
  141. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  142. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  143. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  144. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  145. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  146. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  147. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  148. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  149. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  150. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  151. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  152. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  153. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  154. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  155. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  156. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  157. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  158. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  159. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  160. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  161. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  162. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  163. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  164. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  165. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  166. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  167. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  168. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  169. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  170. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  171. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  172. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  173. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  174. package/bundled/locales/zh-CN/skills/README.md +3 -1
  175. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  176. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  177. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  178. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  179. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  180. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  181. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  182. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  183. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  184. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  185. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  186. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  187. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  188. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  189. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  190. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  191. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  192. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  193. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  194. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  195. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  196. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  197. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  198. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  199. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  200. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  201. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  202. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  203. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  204. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  205. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  206. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  207. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  208. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  209. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  210. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  211. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  212. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  213. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  214. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  215. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  216. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  217. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  218. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  219. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  220. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  221. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  222. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  223. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  224. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  225. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  226. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  227. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  228. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  229. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  230. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  231. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  232. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  233. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  234. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  235. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  236. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  237. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  238. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  239. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  240. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  241. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  242. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  243. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  244. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  245. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  246. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  247. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  248. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  249. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -2
  250. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  251. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  252. package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
  253. package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
  254. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  255. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  256. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  257. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  258. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  259. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  260. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  261. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  262. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  263. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  264. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  265. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  266. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  267. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  268. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  269. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  270. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  271. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  272. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  273. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  274. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  275. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  276. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  277. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  278. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  279. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  280. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  281. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  282. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  283. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  284. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  285. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  286. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  287. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  288. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  289. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  290. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  291. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  292. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  293. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  294. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  295. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  296. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  297. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  298. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  299. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  300. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  301. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  302. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  303. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  304. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  305. package/bundled/locales/zh-TW/CHANGELOG.md +211 -3
  306. package/bundled/locales/zh-TW/README.md +3 -3
  307. package/bundled/locales/zh-TW/SECURITY.md +3 -1
  308. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  309. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
  310. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  311. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
  312. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
  313. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
  314. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
  315. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  316. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  317. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  318. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  319. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  320. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  321. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  322. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  323. package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
  324. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  325. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  326. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  327. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  328. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  329. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  330. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  331. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  332. package/bundled/locales/zh-TW/core/code-review-checklist.md +36 -7
  333. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  334. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  335. package/bundled/locales/zh-TW/core/developer-memory.md +111 -12
  336. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  337. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  338. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  339. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  340. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  341. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  342. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  343. package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
  344. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  345. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  346. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  347. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  348. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  349. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  350. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  351. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  352. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  353. package/bundled/locales/zh-TW/core/open-work-tracking.md +164 -9
  354. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  355. package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
  356. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  357. package/bundled/locales/zh-TW/core/project-context-memory.md +215 -31
  358. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  359. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  360. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  361. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  362. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  363. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  364. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  365. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  366. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  367. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  368. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  369. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  370. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  371. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  372. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  373. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  374. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  375. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  376. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  377. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  378. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  379. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  380. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  381. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  382. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  383. package/bundled/locales/zh-TW/core/turn-completion-integrity.md +46 -13
  384. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  385. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  386. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  387. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  388. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  389. package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
  390. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +11 -2
  391. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  392. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +69 -33
  393. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  394. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +32 -15
  395. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  396. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
  397. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  398. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
  399. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  400. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  401. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +46 -0
  402. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  403. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  404. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  405. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  406. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  407. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  408. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  409. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  410. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  411. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  412. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  413. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  414. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  415. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  416. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  417. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  418. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  419. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  420. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  421. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  422. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  423. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  424. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  425. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  426. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  427. package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
  428. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  429. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  430. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  431. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  432. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  433. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  434. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  435. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  436. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  437. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  438. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  439. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  440. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  441. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  442. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  443. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  444. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  445. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  446. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  447. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  448. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  449. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  450. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  451. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  452. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  453. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  454. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  455. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  456. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  457. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  458. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  459. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  460. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  461. package/bundled/locales/zh-TW/skills/README.md +3 -1
  462. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  463. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  464. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  465. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  466. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  467. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  468. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  469. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  470. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  471. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  472. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  473. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  474. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  475. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  476. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  477. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  478. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  479. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  480. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  481. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  482. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  483. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  484. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  485. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  486. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  487. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  488. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  489. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  490. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  491. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  492. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  493. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  494. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  495. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  496. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  497. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  498. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  499. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  500. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  501. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  502. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  503. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  504. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  505. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  506. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  507. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  508. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  509. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  510. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  511. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  512. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  513. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  514. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  515. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  516. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  517. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  518. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  519. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  520. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  521. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  522. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  523. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  524. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  525. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  526. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  527. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  528. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  529. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  530. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  531. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  532. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  533. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  534. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  535. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  536. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  537. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  538. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  539. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  540. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  541. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  542. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  543. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  544. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  545. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  546. package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
  547. package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
  548. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  549. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  550. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  551. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  552. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  553. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  554. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  555. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  556. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  557. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  558. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  559. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  560. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  561. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  562. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  563. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  564. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  565. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  566. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  567. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  568. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  569. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  570. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  571. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  572. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  573. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  574. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  575. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  576. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  577. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  578. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  579. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  580. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  581. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  582. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  583. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  584. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  585. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  586. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  587. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  588. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  589. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  590. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  591. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  592. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  593. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  594. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  595. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  596. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  597. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  598. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  599. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  600. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  601. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  602. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  603. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  604. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  605. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  606. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  607. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  608. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  609. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  610. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  611. package/bundled/skills/README.md +1 -0
  612. package/bundled/skills/SKILL_NAMING.md +9 -0
  613. package/bundled/skills/commit-standards/SKILL.md +2 -2
  614. package/bundled/skills/commit-standards/guide.md +3 -2
  615. package/bundled/skills/commit-standards/language-options.md +19 -17
  616. package/bundled/skills/comprehension-ladder/SKILL.md +283 -0
  617. package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
  618. package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
  619. package/bundled/templates/gates/check-stubs.mjs +644 -0
  620. package/package.json +5 -3
  621. package/src/commands/audit.js +20 -2
  622. package/src/commands/check.js +155 -28
  623. package/src/commands/deps.js +31 -1
  624. package/src/commands/hitl.js +3 -0
  625. package/src/commands/init.js +173 -49
  626. package/src/commands/list.js +12 -3
  627. package/src/commands/mcp.js +2 -3
  628. package/src/commands/open-work.js +123 -0
  629. package/src/commands/quickstart.js +29 -13
  630. package/src/commands/release.js +102 -19
  631. package/src/commands/run-intent.js +10 -0
  632. package/src/commands/simulate.js +20 -8
  633. package/src/commands/skills.js +59 -33
  634. package/src/commands/spec-split.js +30 -17
  635. package/src/commands/spec.js +55 -21
  636. package/src/commands/uninstall.js +146 -32
  637. package/src/commands/update.js +471 -93
  638. package/src/core/install-records.js +192 -0
  639. package/src/core/manifest.js +12 -10
  640. package/src/core/marketplace-sentinel.js +5 -0
  641. package/src/core/open-work-config.js +122 -0
  642. package/src/core/project-config.js +92 -38
  643. package/src/flows/init-flow.js +10 -0
  644. package/src/hitl/manager.js +4 -2
  645. package/src/i18n/messages.js +413 -78
  646. package/src/installers/hooks-installer.js +320 -24
  647. package/src/installers/integration-installer.js +5 -1
  648. package/src/installers/skills-installer.js +3 -1
  649. package/src/installers/standards-installer.js +16 -23
  650. package/src/mcp/__tests__/server.test.js +0 -1
  651. package/src/mcp/server.js +16 -4
  652. package/src/prompts/init.js +148 -13
  653. package/src/reconciler/backup-locations.js +80 -0
  654. package/src/reconciler/backup-manager.js +451 -123
  655. package/src/reconciler/index.js +86 -10
  656. package/src/reconciler/install-roots.js +90 -0
  657. package/src/reconciler/plan-executor.js +37 -15
  658. package/src/uninstallers/hook-uninstaller.js +323 -33
  659. package/src/uninstallers/integration-uninstaller.js +35 -5
  660. package/src/uninstallers/skills-uninstaller.js +95 -16
  661. package/src/uninstallers/standards-uninstaller.js +56 -7
  662. package/src/utils/agents-installer.js +10 -17
  663. package/src/utils/available-standards-report.js +144 -0
  664. package/src/utils/available-standards.js +216 -0
  665. package/src/utils/command-hash-ownership.js +103 -0
  666. package/src/utils/commit-message-judge.js +155 -0
  667. package/src/utils/copier.js +80 -2
  668. package/src/utils/deps-applicability.js +25 -0
  669. package/src/utils/detector.js +46 -1
  670. package/src/utils/friction-detector.js +27 -0
  671. package/src/utils/gate-scripts.js +141 -0
  672. package/src/utils/git-hooks.js +139 -7
  673. package/src/utils/hasher.js +36 -0
  674. package/src/utils/health-scorer.js +10 -7
  675. package/src/utils/installed-names-ownership.js +114 -0
  676. package/src/utils/integration-generator.js +36 -24
  677. package/src/utils/legacy-hook-migration.js +112 -0
  678. package/src/utils/locale.js +19 -0
  679. package/src/utils/open-work-tracking.mjs +1754 -0
  680. package/src/utils/prompt-closed.js +18 -0
  681. package/src/utils/sdd-header.js +66 -0
  682. package/src/utils/skill-frontmatter.js +102 -0
  683. package/src/utils/skill-hash-ownership.js +64 -0
  684. package/src/utils/skill-name-collision.js +169 -0
  685. package/src/utils/skills-install-paths.js +114 -0
  686. package/src/utils/skills-installer.js +75 -106
  687. package/src/utils/standard-validator.js +98 -27
  688. package/src/utils/test-change-check.js +160 -0
  689. package/src/utils/test-policy.js +214 -0
  690. package/src/utils/transient-fs.js +113 -0
  691. package/src/utils/update-summary.js +29 -0
  692. package/src/vibe/micro-spec.js +15 -0
  693. package/standards-registry.json +48 -9
@@ -1,15 +1,18 @@
1
1
  ---
2
2
  source: ../../../core/test-governance.md
3
- source_version: 1.1.0
4
- translation_version: 1.1.0
5
- last_synced: 2026-04-20
6
- status: stale
3
+ source_version: 1.2.0
4
+ translation_version: 1.2.0
5
+ last_synced: 2026-10-11
6
+ source_hash: 45e889042c57
7
+ status: current
7
8
  ---
8
9
 
9
- > **语言**: [English](../../../core/test-governance.md) | 简体中文
10
-
11
10
  # 测试治理标准
12
11
 
12
+ > **语言**: [English](../../../core/test-governance.md) | 简体中文
13
+
14
+ **版本**: 1.2.0
15
+ **最后更新**: 2026-08-14
13
16
  **适用范围**: 所有软件项目
14
17
  **范围**: universal
15
18
 
@@ -36,29 +39,29 @@ status: stale
36
39
  |------|---------|------|
37
40
  | 完成定义(DoD) | 敏捷/Scrum | 任务/功能完成的检查清单 |
38
41
  | 测试完成条件 | ISO 29119-2 | 测试活动的退出条件 |
39
- | 系统集成测试 | ISO 12207 | 非正式 ISO 术语,但为行业标准 |
42
+ | 系统集成测试 | ISO 12207 | 非 ISO 正式术语,但为行业标准 |
40
43
  | 金字塔比例 70/20/7/3 | Mike Cohn(经验值) | 推荐默认值,非强制 |
41
44
 
42
45
  ---
43
46
 
44
47
  ## 测试策略
45
48
 
46
- ### 品质目标
49
+ ### 质量目标
47
50
 
48
51
  | ID | 名称 | 度量 |
49
52
  |----|------|------|
50
53
  | QO-1 | 功能正确性 | 测试通过率 >= 95% |
51
54
  | QO-2 | 回归预防 | CI 中零回归失败 |
52
- | QO-3 | 代码品质 | 零 lint/类型错误,静态分析通过 |
55
+ | QO-3 | 代码质量 | 零 lint/类型错误,静态分析通过 |
53
56
 
54
57
  ### 级别归属
55
58
 
56
59
  | 级别 | 负责人 | 环境 | 金字塔比例 |
57
60
  |------|--------|------|-----------|
58
- | 单元测试(UT) | 开发者 | 本地 | 70% |
59
- | 集成测试(IT) | 开发者 | 本地 / CI | 20% |
60
- | 系统测试(ST) | QA / 开发者 | CI / SIT | 7% |
61
- | E2E 测试 | QA | 预发布 | 3% |
61
+ | 单元测试(UT) | 开发者 | local | 70% |
62
+ | 集成测试(IT) | 开发者 | local / ci | 20% |
63
+ | 系统测试(ST) | QA / 开发者 | ci / sit | 7% |
64
+ | E2E 测试 | QA | staging | 3% |
62
65
 
63
66
  ### 静态分析
64
67
 
@@ -66,40 +69,76 @@ status: stale
66
69
 
67
70
  - `ruff check .`(Python)
68
71
  - `eslint .`(TypeScript/JavaScript)
69
- - `cargo clippy`(Rust)
72
+ - `mypy .`(Python 类型检查)
73
+
74
+ ### 阈值关卡必须失败即关闭(Fail Closed)
75
+
76
+ 一个只打印百分比、却不论该数值是否达到阈值都以 `0` 退出的度量层,是报告,而不是关卡。即使它打印的数值随着提交逐步下滑,它仍保持绿灯,也没有任何机制会阻止下一次合并。
77
+
78
+ 每个带有通过/失败阈值的检查 — 覆盖率、lint、变异分数或任何其他有界度量 — 都必须将"低于阈值"转换为非零退出码,并使用工具自身的强制执行参数,而不是事后再解析打印输出的包装脚本:
79
+
80
+ | 工具 | 失败即关闭参数 |
81
+ |------|-------------------|
82
+ | pytest-cov | `--cov-fail-under=<N>` |
83
+ | coverage.py | `coverage report --fail-under=<N>` |
84
+ | diff-cover | `diff-cover coverage.xml --fail-under=<N>` |
85
+ | nyc / Istanbul | `--check-coverage --lines <N>` |
86
+ | Stryker Mutator | `stryker.config.json` 中的 `thresholds.break` |
87
+ | ESLint | `--max-warnings 0` |
88
+
89
+ 一个计算数值、打印数值、然后总是 `exit 0` 的包装脚本,既不满足本规则,也不满足 `verification-evidence` 的证据有效性(Evidence Validity)规则 1 — 此时工具的退出码已不再携带任何关于其所度量产物的信息。
70
90
 
71
91
  ---
72
92
 
73
- ## 测试完成条件
93
+ ## 完成条件
94
+
95
+ 测试完成条件定义测试活动何时可被视为已完成。
96
+ - **ISO 29119** 称之为"测试完成条件"(Test Completion Criteria)或"测试退出条件"(Test Exit Criteria)
97
+ - **敏捷/Scrum** 称之为"完成定义(DoD)"
74
98
 
75
- ### 按级别定义
99
+ ### 任务级别
76
100
 
77
- | 级别 | 完成条件 |
78
- |------|---------|
79
- | **单元测试** | 所有测试通过、覆盖率 >= 目标、无 TODO 测试 |
80
- | **集成测试** | API 契约验证通过、数据库迁移测试通过 |
81
- | **系统测试** | 所有用户场景通过、性能目标达标 |
82
- | **E2E 测试** | 关键用户流程通过、无阻塞级缺陷 |
101
+ 每个任务的完成条件(每个任务完成后检查):
83
102
 
84
- ### 完成定义(DoD)检查清单
103
+ | 检查项 | 必需 | 描述 |
104
+ |--------|------|------|
105
+ | verify_command_passed | 是 | 任务的验证命令或各测试级别全部通过 |
106
+ | no_lint_errors | 是 | 变更文件中无 lint 错误 |
107
+ | type_check_passed | 是 | 类型检查通过 |
85
108
 
86
- - [ ] 所有测试通过
87
- - [ ] 代码审查已完成
88
- - [ ] 文档已更新
89
- - [ ] 无已知阻塞级缺陷
90
- - [ ] 性能目标达标
91
- - [ ] 安全扫描通过
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 | 否 | 文档反映了变更 |
92
129
 
93
130
  ---
94
131
 
95
132
  ## 环境管理
96
133
 
97
- | 环境 | 用途 | 数据 |
98
- |------|------|------|
99
- | **本地** | 开发和单元测试 | 模拟数据 |
100
- | **CI** | 自动化测试 | 测试夹具 |
101
- | **SIT** | 集成测试 | 模拟数据 |
102
- | **预发布** | E2E 和验收测试 | 脱敏生产数据 |
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 验证过程 + 集成过程一致。
103
142
 
104
143
  ---
105
144
 
@@ -107,21 +146,33 @@ status: stale
107
146
 
108
147
  | ID | 触发条件 | 指令 | 优先级 |
109
148
  |----|---------|------|--------|
110
- | enforce-completion-criteria | 完成任务或功能时 | 在将任务/功能标记为完成之前,验证所有必要的完成条件已满足 | 必须 |
149
+ | enforce-completion-criteria | 完成任务或功能时 | 在将任务/功能标记为完成之前,验证所有必需的完成条件均已满足 | 必须 |
111
150
  | pyramid-compliance | 规划测试策略时 | 以 70/20/7/3 金字塔比例作为指导方针。允许偏差,但需有文档记录的理由 | 必须 |
112
- | sit-isolation | 运行系统测试时 | 系统测试应对外部依赖使用 Stub,但使用真实的内部服务。使用 SIT 环境进行系统级验证 | 建议 |
113
- | test-execution-continuity | 新增或完成测试用例时 | 测试用例必须连接到自动化执行触发器(CI gate、build hook 或定时执行)。存在但从未执行的测试提供假信心,比没有测试更糟。在将测试覆盖率标记为完成前,请确认执行历程存在。| 必须 |
151
+ | sit-isolation | 运行系统测试时 | 系统测试应对外部依赖使用 stub,但使用真实的内部服务。使用 SIT 环境进行系统级验证 | 建议 |
152
+ | test-execution-continuity | 新增或完成测试用例时 | 测试用例必须连接到自动化执行触发器(CI gate、build hook 或定时执行)。存在但从未执行的测试会带来虚假的信心,比没有测试更糟。在将测试覆盖标记为完成前,请确认存在执行历史。 | 必须 |
153
+ | fail-closed-threshold-gate | 配置或审查任何覆盖率/lint/变异/其他阈值检查时 | 该检查必须使用工具的 fail-under(或等效)强制执行参数,使其在未达阈值时以非零退出。只打印数值且总是以 0 退出的脚本是报告而非关卡,不满足本规则 | 必须 |
154
+
155
+ ---
156
+
157
+ ## 模板
158
+
159
+ - [测试计划模板](../../../templates/test-plan-template.md) — 参考 ISO 29119-3
160
+ - [测试用例模板](../../../templates/test-case-template.md) — 参考 ISO 29119-3
114
161
 
115
162
  ---
116
163
 
117
164
  ## 相关标准
118
165
 
119
- - [测试标准](testing-standards.md)
120
- - [验证证据](verification-evidence.md)
121
- - [部署标准](deployment-standards.md)
166
+ - [测试标准](testing-standards.md) — 测试金字塔与覆盖率比例
167
+ - [测试完整性维度](test-completeness-dimensions.md) — 8 维度测试覆盖
168
+ - [签入标准](checkin-standards.md) — 提交前质量关卡
169
+ - [验证证据](verification-evidence.md) — 证据有效性(Evidence Validity)规范退出码产生后应如何*解读*;`fail-closed-threshold-gate` 则规范关卡应如何*构建*,使退出码从一开始就携带真实信息
122
170
 
123
171
  ---
124
172
 
125
- ## 许可证
173
+ ## 版本历史
126
174
 
127
- 本标准采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 发布。
175
+ | 版本 | 日期 | 变更内容 |
176
+ |------|------|----------|
177
+ | 1.0.0 | 2026-03-11 | 初始版本 — 测试策略、完成条件、环境管理 |
178
+ | 1.2.0 | 2026-08-14 | 新增 `fail-closed-threshold-gate` — 覆盖率/lint/变异阈值检查在低于阈值时必须以非零退出,而不只是打印数值 |
@@ -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
  > **语言**: [English](../../../core/testing-standards.md) | [繁體中文](../../zh-TW/core/testing-standards.md) | 简体中文
12
13
 
13
- **版本**: 3.1.0
14
- **最后更新**: 2026-03-24
14
+ **版本**: 3.2.0
15
+ **最后更新**: 2026-04-20
15
16
  **适用性**: 所有软件项目
16
17
  **范围**: universal
17
18
  **行业标准**: ISTQB CTFL v4.0, ISO/IEC/IEEE 29119
@@ -49,7 +50,6 @@ status: current
49
50
  ## 覆盖率目标(主要指标)
50
51
 
51
52
  > **覆盖率是测试质量的主要指标。** 更高的覆盖率代表更多代码受到测试保护。
52
- > **覆蓋率是測試品質的主要指標。** 更高的覆蓋率代表更多程式碼受到測試保護。
53
53
 
54
54
  | 指标 | 最低要求 | 标准 | 理想 |
55
55
  |------|----------|------|------|
@@ -245,18 +245,18 @@ E2E 环境前置检查(`globalSetup`、`beforeAll`)必须验证**所有受
245
245
 
246
246
  **反模式** — 只验 login:
247
247
  ```ts
248
- // ❌ 即使功能页返回 500 也会通过
248
+ // ❌ Passes even when feature pages return 500
249
249
  await page.goto('/login');
250
250
  expect(response.status()).toBe(200);
251
251
  ```
252
252
 
253
253
  **正确模式** — 明确的覆盖列表:
254
254
  ```ts
255
- // ✅ 验证套件涵盖的所有页面
255
+ // ✅ Verify all pages covered by the suite
256
256
  const PAGES_UNDER_TEST = ['/login', '/dashboard', '/feature-x'];
257
257
  for (const path of PAGES_UNDER_TEST) {
258
258
  const res = await fetch(`${BASE_URL}${path}`);
259
- expect(res.status).toBeLessThan(500); // 遇到 5xx 立即失败
259
+ expect(res.status).toBeLessThan(500); // fail fast on 5xx
260
260
  }
261
261
  ```
262
262
 
@@ -292,11 +292,11 @@ for (const path of PAGES_UNDER_TEST) {
292
292
  **规则**: 如果 Mock 的方法接受查询/过滤/谓词参数,你**必须**有一个对应的集成测试来验证查询逻辑。
293
293
 
294
294
  ```python
295
- # 示例 - Python
296
- # ❌ 此测试无法验证查询的正确性
295
+ # Example - Python
296
+ # ❌ This test cannot verify query correctness
297
297
  mock_repo.find.return_value = users
298
298
 
299
- # ✓ 添加集成测试来验证实际查询
299
+ # ✓ Add integration test to verify actual query
300
300
  ```
301
301
 
302
302
  ---
@@ -315,10 +315,10 @@ mock_repo.find.return_value = users
315
315
  当实体同时具有代理键(自动生成的 ID)和业务标识符时,测试数据**必须**为每个键使用不同的值。
316
316
 
317
317
  ```python
318
- # ❌ 错误: id 等于 business_code — 映射错误不会被检测到
318
+ # ❌ Wrong: id equals business_code - mapping errors undetected
319
319
  dept = Department(id=1, business_code=1)
320
320
 
321
- # ✓ 正确: 不同的值可以捕获映射错误
321
+ # ✓ Correct: distinct values catch mapping errors
322
322
  dept = Department(id=1, business_code=1001)
323
323
  ```
324
324
 
@@ -327,11 +327,11 @@ dept = Department(id=1, business_code=1001)
327
327
  对于具有复合主键的实体,确保每条记录具有唯一的键组合。
328
328
 
329
329
  ```python
330
- # ❌ 键冲突
330
+ # ❌ Key collision
331
331
  batch1 = BatchRecord(id=0, send_time=now)
332
- batch2 = BatchRecord(id=0, send_time=now) # 冲突!
332
+ batch2 = BatchRecord(id=0, send_time=now) # Conflict!
333
333
 
334
- # ✓ 唯一组合
334
+ # ✓ Unique combinations
335
335
  batch1 = BatchRecord(id=0, send_time=now + timedelta(seconds=1))
336
336
  batch2 = BatchRecord(id=0, send_time=now + timedelta(seconds=2))
337
337
  ```
@@ -398,9 +398,9 @@ batch2 = BatchRecord(id=0, send_time=now + timedelta(seconds=2))
398
398
  ### AAA 模式
399
399
 
400
400
  ```
401
- // Arrange - 设置测试数据和环境
402
- // Act - 执行被测行为
403
- // Assert - 验证结果
401
+ // Arrange - Set up test data and environment
402
+ // Act - Execute the behavior under test
403
+ // Assert - Verify the result
404
404
  ```
405
405
 
406
406
  ### FIRST 原则
@@ -467,13 +467,13 @@ batch2 = BatchRecord(id=0, send_time=now + timedelta(seconds=2))
467
467
 
468
468
  ```
469
469
  tests/
470
- ├── README.md # 测试概览和状态
471
- ├── results/ # 测试执行报告
472
- ├── coverage/ # 覆盖率报告
473
- ├── docs/ # 测试文档
474
- ├── unit/ # 单元测试
475
- ├── integration/ # 集成测试
476
- └── e2e/ # 端到端测试
470
+ ├── README.md # Test overview and status
471
+ ├── results/ # Test execution reports
472
+ ├── coverage/ # Coverage reports
473
+ ├── docs/ # Test documentation
474
+ ├── unit/ # Unit tests
475
+ ├── integration/ # Integration tests
476
+ └── e2e/ # End-to-end tests
477
477
  ```
478
478
 
479
479
  ---
@@ -486,35 +486,81 @@ tests/
486
486
 
487
487
  ### Session-Based Test Management (SBTM)
488
488
 
489
+ 每个探索式测试 session 都遵循 SBTM 框架:
490
+
489
491
  | 元素 | 说明 | 需求 |
490
492
  |------|------|------|
491
- | **Time Box** | 固定 60-90 分钟的 session | 必要 |
493
+ | **Time Box** | 固定 60-90 分钟的 session 时长 | 必要 |
492
494
  | **Charter** | 明确的探索目标、测试区域与预期风险 | 必要 |
493
495
  | **Session Notes** | 步骤、观察、偏差与问题的结构化记录 | 必要 |
494
- | **Debrief** | Session 后与团队回顾 | 建议 |
496
+ | **Debrief** | Session 结束后与团队或测试负责人进行回顾 | 建议 |
497
+
498
+ **Charter 格式**:
499
+ ```
500
+ Explore [target area]
501
+ With [resources/techniques]
502
+ To discover [expected information/risks]
503
+ ```
495
504
 
496
505
  ### 启发法(SFDPOT)
497
506
 
507
+ 使用 SFDPOT 助记法(James Bach 的 Heuristic Test Strategy Model)引导在六个维度上进行探索:
508
+
498
509
  | 维度 | 关注领域 | 示例问题 |
499
510
  |------|----------|----------|
500
- | Structure | 系统组件与其关系 | 存在哪些模块?如何连接? |
501
- | Function | 系统提供的功能与能力 | 每个功能做什么?边界情况? |
502
- | Data | 输入/输出数据、边界值 | 接受哪些数据类型?边界发生什么? |
503
- | Platform | OS、浏览器、硬件差异 | 所有支持平台都能运作? |
504
- | Operations | 安装、配置、维护、监控 | 能干净安装吗?如何维护? |
505
- | Time | 并发、超时、排程、时区 | 并发访问时会发生什么? |
511
+ | Structure | 系统组件与其关系 | 存在哪些模块?它们如何连接? |
512
+ | Function | 系统提供的功能与能力 | 每个功能做什么?边界情况有哪些? |
513
+ | Data | 输入/输出数据、边界值、格式 | 接受哪些数据类型?在边界时会发生什么? |
514
+ | Platform | 操作系统、浏览器、硬件、环境差异 | 在所有支持的平台上都能运作吗? |
515
+ | Operations | 安装、配置、维护、监控 | 能否干净地安装?如何维护? |
516
+ | Time | 并发、超时、调度、时区 | 并发访问时会发生什么?超时如何处理? |
517
+
518
+ > **提示**:每个 session 至少使用 3 个 SFDPOT 维度,以确保覆盖面足够广。
519
+
520
+ ### Session 记录模板
521
+
522
+ 每个探索式测试 session **必须**使用以下模板产出 session 记录:
523
+
524
+ | 字段 | 说明 | 必填 |
525
+ |------|------|------|
526
+ | **Charter** | 探索目标与范围 | 是 |
527
+ | **Area** | 受测的功能区域或组件 | 是 |
528
+ | **Duration** | 实际花费时间(在 60-90 分钟 time box 内) | 是 |
529
+ | **Notes** | 执行步骤、观察结果、与 charter 的偏差 | 是 |
530
+ | **Bugs Found** | 发现的缺陷清单及其严重程度 | 是 |
531
+ | **Follow-up** | 后续行动项:新的 charter、自动化候选项、待解问题 | 是 |
532
+
533
+ **Session 记录示例**:
534
+ ```markdown
535
+ ## Session Record
536
+ - **Charter**: Explore login flow with invalid credentials to discover error handling gaps
537
+ - **Area**: Authentication module
538
+ - **Duration**: 75 minutes
539
+ - **Notes**: Tested SQL injection, XSS in username, Unicode characters, empty fields...
540
+ - **Bugs Found**: 2 (BUG-101: XSS not sanitized in error message, BUG-102: No rate limiting)
541
+ - **Follow-up**: Write automated regression for BUG-101, new charter for password reset flow
542
+ ```
506
543
 
507
544
  ### 自动化互补
508
545
 
546
+ 探索式测试与自动化测试扮演互补的角色:
547
+
509
548
  | 方面 | 探索式测试 | 自动化测试 |
510
549
  |------|-----------|-----------|
511
550
  | **目的** | 发现未知缺陷 | 防止已知回归 |
512
- | **时机** | 新功能、风险区域、发布前 | 每次 build、CI |
513
- | **优势** | 创造力、适应性 | 速度、可重复性 |
551
+ | **时机** | 新功能、风险区域、发布前 | 每次 build、持续集成 |
552
+ | **优势** | 创造力、适应性、情境理解 | 速度、可重复性、覆盖率 |
553
+ | **成本** | 每个 session 的人力投入 | 长期的维护成本 |
554
+
555
+ **发现到保护循环**:
514
556
 
515
- **发现到保护循环**:探索 → 记录 → 自动化 → 保护 → 重复
557
+ 1. **探索** — 执行探索式 session,发现新缺陷
558
+ 2. **报告** — 在 session 记录中记录发现的 Bug
559
+ 3. **自动化** — 将已确认的 Bug 转为自动化回归测试
560
+ 4. **保护** — 自动化测试防止未来 build 中再次发生
561
+ 5. **重复** — 新的探索式 session 聚焦于尚未探索的区域
516
562
 
517
- > **规则**:通过探索式测试发现的每个 Bug 应在同一 Sprint 内新增对应的自动化回归测试。
563
+ > **规则**:通过探索式测试发现的每个 Bug **应该**在同一 Sprint 内新增对应的自动化回归测试。这能把一次性的发现转化为永久的保护。
518
564
 
519
565
  ---
520
566
 
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/timeout-standards.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-04-20
5
+ last_synced: 2026-10-11
6
+ source_hash: df4f00d1e5e2
6
7
  status: current
7
8
  ---
8
9
 
@@ -10,108 +11,67 @@ status: current
10
11
 
11
12
  > **语言**: [English](../../../core/timeout-standards.md) | 简体中文
12
13
 
13
- **版本**: 1.0.0
14
- **最后更新**: 2026-04-17
15
- **状态**: Trial(到期 2026-10-17)
16
- **适用范围**: universal
17
- **来源**: XSPEC-067(DEC-043 Wave 1 可靠性套件)
18
-
19
- ---
14
+ > **来源**: XSPEC-067 | **驱动来源**: DEC-043 Wave 1 可靠性套件 | **状态**: Trial(2026-04-17 ~ 2026-10-17)
20
15
 
21
- ## 目的
16
+ ## 概述
22
17
 
23
- Timeout 标准:层级预算(cascading 0.8×)、deadline propagation、与 circuit-breaker 整合。
18
+ Timeout 标准——避免多层调用链中下层 timeout 大于上层(导致上层先 timeout 而下层仍在执行的资源浪费)。通过 cascading 预算规则(每层 ≤ 0.8× 上层)与 deadline propagation(传递 absolute timestamp)让整条调用链精准 fail-fast。与 `circuit-breaker` 整合,timeout 计入 failure count。
24
19
 
25
- 避免多层调用链中下层 timeout 大于上层(导致上层先 timeout 而下层仍在执行的资源浪费)。通过 cascading 预算规则(每层 ≤ 0.8× 上层)与 deadline propagation(传 absolute timestamp)让整条调用链都能精准 fail-fast。
20
+ ## 核心原则
26
21
 
27
- ---
22
+ - **Cascading 预算**:多层调用的 timeout 必须逐层递减,每下一层 ≤ `0.8 × 上层`(预留 20% buffer)
23
+ - **Deadline Propagation**:跨服务调用必须传递 deadline(absolute timestamp),不得只传 relative duration
24
+ - **Fail-fast on Expired**:收到请求后若 `now > deadline`,立即 fail-fast,禁止发起下游调用
25
+ - **Breaker 整合**:timeout 触发计入对应 circuit-breaker 的 failure count
26
+ - **禁止倒置**:下层 timeout 大于上层 timeout 等同没设 timeout,属于配置违规
28
27
 
29
- ## 核心规范
30
-
31
- - 多层调用的 timeout 必须逐层递减,每下一层 ≤ 0.8 × 上层(预留 20% buffer)
32
- - 跨服务调用必须传递 deadline(absolute timestamp),不得只传 relative duration
33
- - 收到请求后若 `now > deadline`,必须立即 fail-fast,禁止发起下游调用
34
- - Timeout 触发必须计入对应 circuit-breaker 的 failure count
35
- - 禁止下层 timeout 大于上层 timeout(违反 fail-fast,等同没设 timeout)
36
-
37
- ---
28
+ ## Cascading 预算示例
38
29
 
39
- ## Cascading 预算规则
30
+ ```
31
+ Client timeout = 10000 ms
32
+ Gateway timeout = 8000 ms (10000 × 0.8)
33
+ Service A timeout = 6400 ms (8000 × 0.8)
34
+ Downstream DB timeout = 5120 ms (6400 × 0.8)
35
+ ```
40
36
 
41
- **规则**:每下一层 timeout ≤ 0.8 × 上层 timeout
42
-
43
- **示例**(Client timeout=10s,调用链 Client → Gateway → Service A → DB):
44
-
45
- | 层级 | timeout |
46
- |------|---------|
47
- | Client | 10,000ms |
48
- | Gateway | 8,000ms(10000 × 0.8) |
49
- | Service A | 6,400ms(8000 × 0.8) |
50
- | DB | 5,120ms(6400 × 0.8) |
51
-
52
- **理由**:
53
- - 预留 20% buffer 给序列化、网络传输、重试等开销
54
- - 避免上层先 timeout 而下层仍在执行(资源浪费)
55
- - 0.8 是业界经验值(gRPC / Envoy 常用 0.7~0.85)
56
-
57
- ---
37
+ 0.8 为业界经验值(gRPC / Envoy 常用 0.7~0.85),预留 20% buffer 给序列化、网络传输、重试开销。
58
38
 
59
39
  ## Deadline Propagation
60
40
 
61
- | 字段 | 值 |
62
- |------|-----|
63
- | 格式 | absolute ISO-8601 timestamp(非 relative duration) |
64
- | Header 名称 | `X-Deadline` |
65
-
66
- **规则**:
67
- 1. 发起调用前计算 `deadline = now + timeout`,写入 header
68
- 2. 收到请求后立即检查 `now > deadline_header` → 若是则 fail-fast(回 `DEADLINE_EXCEEDED`)
69
- 3. 向下游调用时 `timeout = min(cascading_budget, deadline - now)`,取两者较小
70
-
71
- **理由**:Relative duration(如 timeout=5s)无法在多层调用中累积扣除;absolute timestamp 让每一层都能精准计算剩余时间。
72
-
73
- ---
41
+ - Header:`X-Deadline`
42
+ - 格式:absolute ISO-8601 timestamp(不是 relative duration)
43
+ - 发起调用前:`deadline = now + timeout`,写入 header
44
+ - 收到请求后:立即检查 `now > deadline_header`,若是则回 `DEADLINE_EXCEEDED`
45
+ - 向下游调用:`timeout = min(cascading_budget, deadline - now)`
74
46
 
75
47
  ## Timeout 类型
76
48
 
77
- | 类型 | 默认值 | 说明 |
78
- |------|--------|------|
79
- | `connect_timeout` | 5,000ms | 建立 TCP / TLS 连接的时间上限 |
80
- | `request_timeout` | 30,000ms | 发送请求到收到完整响应的时间上限;受 cascading 预算约束 |
81
- | `idle_timeout` | 60,000ms | 连接闲置多久后关闭;server 端设置 |
82
- | `total_deadline` | 60,000ms | 含所有重试在内的整体上限;retry × attempt_timeout 总和不得超过此值 |
83
-
84
- ---
85
-
86
- ## 与 circuit-breaker 整合
49
+ | 类型 | 默认值 ms | 用途 |
50
+ |----------|------------|---------|
51
+ | `connect_timeout` | 5000 | 建立 TCP / TLS 连接 |
52
+ | `request_timeout` | 30000 | 发送请求到收到完整响应 |
53
+ | `idle_timeout` | 60000 | 连接闲置多久后关闭 |
54
+ | `total_deadline` | 60000 | 含所有重试的整体上限 |
87
55
 
88
- | 规则 | 说明 |
89
- |------|------|
90
- | Rule 1 | 每次 timeout 触发视为一次失败,计入 breaker 的 failure count |
91
- | Rule 2 | 连续 timeout 达 failureThreshold 时 breaker 进入 OPEN |
92
- | Rule 3 | OPEN 状态下的请求应套用极短 timeout(或直接 fail-fast) |
56
+ ## 使用示例
93
57
 
94
- ---
95
-
96
- ## 情境示例
58
+ - **情境 1 — Cascading 预算**:Client 10s → Gateway 8s → Service A 6.4s → DB 5.12s,确保下层先 timeout,上层有机会 fallback
59
+ - **情境 2 — Deadline 过期**:请求抵达 Service A 时 `X-Deadline` 已过期,立即回 `DEADLINE_EXCEEDED`,不调用 DB
60
+ - **情境 3 — Timeout 触发 breaker**:连续 3 次下游调用皆 timeout(failureThreshold=3),第 4 次 breaker 进入 OPEN
97
61
 
98
- **情境 1:cascading 预算验证**
99
- - Client timeout=10s,各层依序 8s → 6.4s → 5.12s
62
+ ## 错误码
100
63
 
101
- **情境 2:deadline 已过期 fail-fast**
102
- - 条件:请求抵达 Service A 时 X-Deadline 已过期
103
- - 结果:立即回 DEADLINE_EXCEEDED,不调用 DB
64
+ - `TIMEOUT-001` — `REQUEST_TIMEOUT`(单次请求超时)
65
+ - `TIMEOUT-002` — `DEADLINE_EXCEEDED`(整体 deadline 已过)
66
+ - `TIMEOUT-003` — `CASCADING_BUDGET_VIOLATION`(下层 > 上层,配置错误)
104
67
 
105
- **情境 3:timeout 触发 circuit breaker**
106
- - 条件:连续 3 次下游调用皆 timeout(failureThreshold=3)
107
- - 结果:circuit-breaker 进入 OPEN,第 4 次立即回 CircuitOpenError
68
+ ## 参考资料
108
69
 
109
- ---
70
+ - AI 优化版:[ai/standards/timeout-standards.ai.yaml](../../../ai/standards/timeout-standards.ai.yaml)
71
+ - XSPEC-067:DEC-043 Wave 1 可靠性套件跨项目规格
72
+ - DEC-043:UDS 覆盖完整性路线图(驱动来源)
73
+ - 相关:`circuit-breaker`、`retry-standards`、`failure-source-taxonomy`
74
+ - 业界参考:gRPC deadline propagation、Envoy timeout budgeting、Google SRE Book Ch.22
110
75
 
111
- ## 错误码
112
76
 
113
- | 代码 | 说明 |
114
- |------|------|
115
- | `TIMEOUT-001` | `REQUEST_TIMEOUT` — 单次请求超时 |
116
- | `TIMEOUT-002` | `DEADLINE_EXCEEDED` — 整体 deadline 已过,拒绝发起/处理请求 |
117
- | `TIMEOUT-003` | `CASCADING_BUDGET_VIOLATION` — 下层 timeout > 上层 timeout(配置错误)|
77
+ **适用范围**: universal