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,7 +2,8 @@
2
2
  source: ../../../core/test-governance.md
3
3
  source_version: 1.2.0
4
4
  translation_version: 1.2.0
5
- last_synced: 2026-08-14
5
+ last_synced: 2026-10-11
6
+ source_hash: 45e889042c57
6
7
  status: current
7
8
  ---
8
9
 
@@ -10,6 +11,8 @@ status: current
10
11
 
11
12
  > **語言**: [English](../../../core/test-governance.md) | 繁體中文
12
13
 
14
+ **版本**: 1.2.0
15
+ **最後更新**: 2026-08-14
13
16
  **適用性**: 所有軟體專案
14
17
  **範圍**: 通用 (Universal)
15
18
 
@@ -47,30 +50,26 @@ status: current
47
50
 
48
51
  | ID | 名稱 | 衡量指標 |
49
52
  |----|------|----------|
50
- | QO-1 | 缺陷密度 | < 1 缺陷/KLOC(正式發布) |
51
- | QO-2 | 測試覆蓋率 | 依測試金字塔比例 |
52
- | QO-3 | 回歸率 | < 5% 每次迭代 |
53
+ | QO-1 | 功能正確性 | 測試通過率 >= 95% |
54
+ | QO-2 | 防止回歸 | CI 中零回歸失敗 |
55
+ | QO-3 | 程式碼品質 | 零 lint/型別錯誤,靜態分析通過 |
53
56
 
54
- ### 測試金字塔
57
+ ### 層級權責
55
58
 
56
- | 層級 | 比例 | 執行時間 | 說明 |
57
- |------|------|----------|------|
58
- | 單元測試 (UT) | 70% | < 100ms/test | 測試個別函式/方法 |
59
- | 整合測試 (IT) | 20% | < 1s/test | 測試元件互動 |
60
- | 端對端測試 (E2E) | 7% | 數秒/test | 測試使用者工作流 |
61
- | 效能/安全測試 | 3% | 分鐘級 | 非功能測試 |
59
+ | 層級 | 負責人 | 環境 | 金字塔比例 |
60
+ |------|--------|------|------------|
61
+ | 單元測試 (UT) | 開發者 | local | 70% |
62
+ | 整合測試 (IT) | 開發者 | local / ci | 20% |
63
+ | 系統測試 (ST) | QA / 開發者 | ci / sit | 7% |
64
+ | 端對端測試 (E2E) | QA | staging | 3% |
62
65
 
63
- ### 完成定義 (DoD)
66
+ ### 靜態分析
64
67
 
65
- 每個功能完成前必須滿足:
68
+ 在執行測試前先執行靜態分析工具:
66
69
 
67
- | 項目 | 說明 |
68
- |------|------|
69
- | 所有測試通過 | 100% 通過率 |
70
- | 覆蓋率達標 | 符合金字塔比例 |
71
- | 無已知缺陷 | P0/P1 缺陷為零 |
72
- | 程式碼審查完成 | 至少一位審查者核准 |
73
- | 文件更新 | API 文件和 CHANGELOG 已更新 |
70
+ - `ruff check .`(Python)
71
+ - `eslint .`(TypeScript/JavaScript)
72
+ - `mypy .`(Python 型別檢查)
74
73
 
75
74
  ### 門檻閘門必須 Fail Closed
76
75
 
@@ -89,14 +88,59 @@ status: current
89
88
 
90
89
  一個計算出數字、印出來、卻永遠 `exit 0` 的包裝腳本,既不滿足本條規則,也不滿足 `verification-evidence` 的證據有效性規則 1——工具的 exit code 不再帶有任何關於它量測對象的資訊。
91
90
 
92
- ## 測試環境管理
91
+ ---
92
+
93
+ ## 完成準則
94
+
95
+ 測試完成準則定義測試活動何時可視為完成。
96
+ - **ISO 29119** 稱之為「測試完成準則」(Test Completion Criteria) 或「測試退出準則」(Test Exit Criteria)
97
+ - **Agile/Scrum** 稱之為「完成定義」(Definition of Done, DoD)
98
+
99
+ ### 任務層級
100
+
101
+ 每個任務的完成準則(於每個任務完成後檢查):
102
+
103
+ | 檢查項 | 必要 | 說明 |
104
+ |--------|------|------|
105
+ | verify_command_passed | 是 | 任務的驗證指令或各測試層級全部通過 |
106
+ | no_lint_errors | 是 | 變更的檔案中沒有 lint 錯誤 |
107
+ | type_check_passed | 是 | 型別檢查通過 |
108
+
109
+ ### 功能層級
110
+
111
+ 每個功能的完成準則(於功能邊界檢查):
112
+
113
+ | 檢查項 | 必要 | 說明 |
114
+ |--------|------|------|
115
+ | all_tasks_passed | 是 | 該功能中的所有任務皆已成功完成 |
116
+ | acceptance_criteria_met | 是 | 所有驗收條件皆已驗證 |
117
+ | no_regression | 是 | 沒有破壞任何既有測試 |
118
+
119
+ ### 發布層級
120
+
121
+ 發布的完成準則(於發布前檢查):
122
+
123
+ | 檢查項 | 必要 | 說明 |
124
+ |--------|------|------|
125
+ | all_features_complete | 是 | 所有規劃的功能皆已完成 |
126
+ | e2e_pass | 是 | 完整 E2E 測試套件通過 |
127
+ | static_analysis_clean | 是 | 靜態分析回報零問題 |
128
+ | documentation_updated | 否 | 文件反映了變更內容 |
129
+
130
+ ---
131
+
132
+ ## 環境管理
93
133
 
94
- | 環境 | 用途 | 管理責任 |
95
- |------|------|----------|
96
- | 本地 (Local) | 開發者單元測試 | 開發者 |
97
- | CI | 自動化測試 | CI/CD 管線 |
98
- | Staging | 整合和 E2E 測試 | DevOps |
99
- | Production | 煙霧測試和監控 | SRE |
134
+ | 環境 | 說明 | 用途 | Mock 策略 |
135
+ |------|------|------|-----------|
136
+ | local | 開發者工作站 | 單元測試、快速整合測試 | 記憶體內的 Mock 與 Stub |
137
+ | ci | CI/CD 管線 | 完整測試套件、lint、型別檢查、靜態分析 | 容器化相依性(testcontainers) |
138
+ | sit | 系統整合測試 | 與真實服務互動的系統測試 | 外部 API 使用 Stub,內部服務使用真實服務 |
139
+ | staging | 預備正式環境 | E2E 測試、煙霧測試 | 不使用 Mock,使用真實外部服務 |
140
+
141
+ > **注意**:SIT = 系統整合測試 (System Integration Testing),對齊 ISO 12207 驗證流程 + 整合流程。
142
+
143
+ ---
100
144
 
101
145
  ## 規則
102
146
 
@@ -105,14 +149,30 @@ status: current
105
149
  | enforce-completion-criteria | 完成任務或功能時 | 在將任務/功能標記為完成前,驗證所有必要的完成準則已達成 | 必須 |
106
150
  | pyramid-compliance | 規劃測試策略時 | 以 70/20/7/3 金字塔比例為指引。可接受偏差,但需有文件記錄的正當理由 | 必須 |
107
151
  | sit-isolation | 執行系統測試時 | 系統測試應對外部相依性使用 Stub,但使用真實的內部服務。使用 SIT 環境進行系統層級的驗證 | 建議 |
108
- | test-execution-continuity | 新增或完成測試案例時 | 測試案例必須連接到自動化執行觸發器(CI gate、build hook 或排程執行)。存在但從未執行的測試提供假信心,比沒有測試更糟。在將測試覆蓋率標記為完成前,請確認執行歷程存在。| 必須 |
152
+ | test-execution-continuity | 新增或完成測試案例時 | 測試案例必須連接到自動化執行觸發器(CI gate、build hook 或排程執行)。存在但從未執行的測試提供假信心,比沒有測試更糟。在將測試覆蓋率標記為完成前,請確認執行歷程存在。 | 必須 |
109
153
  | fail-closed-threshold-gate | 設定或審查任何 coverage/lint/mutation 或其他門檻檢查時 | 該檢查必須使用工具自己的 fail-under(或等價)強制旗標,使其在未達門檻時以非 0 退出。只印出數字、永遠 exit 0 的腳本是報告,不是閘門,不滿足本條 | 必須 |
110
154
 
111
155
  ---
112
156
 
157
+ ## 範本
158
+
159
+ - [測試計劃範本](../../../templates/test-plan-template.md) — 參考 ISO 29119-3
160
+ - [測試案例範本](../../../templates/test-case-template.md) — 參考 ISO 29119-3
161
+
162
+ ---
163
+
113
164
  ## 相關標準
114
165
 
115
- - [測試標準](testing-standards.md)
116
- - [提交規範](checkin-standards.md)
117
- - [部署標準](deployment-standards.md)
118
- - [驗證證據標準](verification-evidence.md) —— 證據有效性規範的是產出 exit code 之後如何**解讀**它;`fail-closed-threshold-gate` 規範的是閘門必須如何被**建造**,讓 exit code 一開始就帶有真實資訊
166
+ - [測試標準](testing-standards.md) — 測試金字塔與覆蓋比例
167
+ - [測試完整度維度](test-completeness-dimensions.md) — 8 維度測試覆蓋
168
+ - [提交規範](checkin-standards.md) — 提交前品質關卡
169
+ - [驗證證據標準](verification-evidence.md) — 證據有效性規範的是產出 exit code 之後如何**解讀**它;`fail-closed-threshold-gate` 規範的是閘門必須如何被**建造**,讓 exit code 一開始就帶有真實資訊
170
+
171
+ ---
172
+
173
+ ## 版本歷史
174
+
175
+ | 版本 | 日期 | 變更 |
176
+ |------|------|------|
177
+ | 1.0.0 | 2026-03-11 | 初始版本 — 測試政策、完成準則、環境管理 |
178
+ | 1.2.0 | 2026-08-14 | 新增 `fail-closed-threshold-gate` — coverage/lint/mutation 門檻檢查在未達門檻時必須以非 0 退出,而不只是印出數字 |
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/testing-standards.md
3
3
  source_version: 3.2.0
4
4
  translation_version: 3.2.0
5
- last_synced: 2026-04-20
5
+ last_synced: 2026-10-11
6
+ source_hash: 4d5d70b73aa6
6
7
  status: current
7
8
  ---
8
9
 
@@ -10,8 +11,8 @@ status: current
10
11
 
11
12
  > **Language**: [English](../../../core/testing-standards.md) | 繁體中文
12
13
 
13
- **版本**: 3.1.0
14
- **最後更新**: 2026-03-25
14
+ **版本**: 3.2.0
15
+ **最後更新**: 2026-04-20
15
16
  **適用範圍**: 所有軟體專案
16
17
  **Scope**: universal
17
18
  **產業標準**: ISTQB CTFL v4.0, ISO/IEC/IEEE 29119
@@ -482,39 +483,85 @@ tests/
482
483
 
483
484
  > **參考**:ISTQB CTFL v4.0 §4.4、James Bach 的 Session-Based Test Management (SBTM)
484
485
 
485
- 探索式測試是一種結構化方法,測試設計、執行與學習同時進行,透過發現腳本測試無法預見的未知缺陷來補充自動化測試。
486
+ 探索式測試是一種結構化方法,測試設計、執行與學習同時進行。它透過發現腳本測試無法預見的未知缺陷,來補充自動化測試。
486
487
 
487
488
  ### Session-Based Test Management (SBTM)
488
489
 
490
+ 每個探索式測試 session 都遵循 SBTM 框架:
491
+
489
492
  | 元素 | 說明 | 需求 |
490
493
  |------|------|------|
491
- | **Time Box** | 固定 60-90 分鐘的 session | 必要 |
494
+ | **Time Box** | 固定 60-90 分鐘的 session 時長 | 必要 |
492
495
  | **Charter** | 明確的探索目標、測試區域與預期風險 | 必要 |
493
496
  | **Session Notes** | 步驟、觀察、偏差與問題的結構化記錄 | 必要 |
494
- | **Debrief** | Session 後與團隊回顧 | 建議 |
497
+ | **Debrief** | Session 後與團隊或測試負責人回顧 | 建議 |
498
+
499
+ **Charter 格式**:
500
+ ```
501
+ Explore [target area]
502
+ With [resources/techniques]
503
+ To discover [expected information/risks]
504
+ ```
495
505
 
496
506
  ### 啟發法(SFDPOT)
497
507
 
508
+ 使用 SFDPOT 助記法(James Bach 的 Heuristic Test Strategy Model)引導從六個維度進行探索:
509
+
498
510
  | 維度 | 關注領域 | 範例問題 |
499
511
  |------|----------|----------|
500
512
  | Structure | 系統元件與其關係 | 存在哪些模組?如何連接? |
501
- | Function | 系統提供的功能與能力 | 每個功能做什麼?邊界情況? |
502
- | Data | 輸入/輸出資料、邊界值 | 接受哪些資料類型?邊界發生什麼? |
503
- | Platform | OS、瀏覽器、硬體差異 | 所有支援平台都能運作? |
513
+ | Function | 系統提供的功能與能力 | 每個功能做什麼?有哪些邊界情況? |
514
+ | Data | 輸入/輸出資料、邊界值、格式 | 接受哪些資料類型?在邊界會發生什麼? |
515
+ | Platform | OS、瀏覽器、硬體、環境差異 | 在所有支援的平台上都能運作嗎? |
504
516
  | Operations | 安裝、設定、維護、監控 | 能乾淨安裝嗎?如何維護? |
505
- | Time | 並發、逾時、排程、時區 | 並發存取時會發生什麼? |
517
+ | Time | 並發、逾時、排程、時區 | 並發存取時會發生什麼?逾時如何處理? |
518
+
519
+ > **提示**:每個 session 至少使用 3 個 SFDPOT 維度,以確保廣泛的覆蓋。
520
+
521
+ ### Session 記錄範本
522
+
523
+ 每個探索式測試 session **必須**使用此範本產出 session 記錄:
524
+
525
+ | 欄位 | 說明 | 必要 |
526
+ |------|------|------|
527
+ | **Charter** | 探索目標與範圍 | 是 |
528
+ | **Area** | 受測的功能區域或元件 | 是 |
529
+ | **Duration** | 實際花費時間(在 60-90 分鐘 time box 內) | 是 |
530
+ | **Notes** | 執行步驟、觀察、與 charter 的偏差 | 是 |
531
+ | **Bugs Found** | 發現的缺陷清單及其嚴重度 | 是 |
532
+ | **Follow-up** | 待辦事項:新 charter、自動化候選項目、待釐清問題 | 是 |
533
+
534
+ **Session 記錄範例**:
535
+ ```markdown
536
+ ## Session Record
537
+ - **Charter**: Explore login flow with invalid credentials to discover error handling gaps
538
+ - **Area**: Authentication module
539
+ - **Duration**: 75 minutes
540
+ - **Notes**: Tested SQL injection, XSS in username, Unicode characters, empty fields...
541
+ - **Bugs Found**: 2 (BUG-101: XSS not sanitized in error message, BUG-102: No rate limiting)
542
+ - **Follow-up**: Write automated regression for BUG-101, new charter for password reset flow
543
+ ```
506
544
 
507
545
  ### 自動化互補
508
546
 
547
+ 探索式測試與自動化測試扮演互補的角色:
548
+
509
549
  | 面向 | 探索式測試 | 自動化測試 |
510
550
  |------|-----------|-----------|
511
551
  | **目的** | 發現未知缺陷 | 防止已知回歸 |
512
- | **時機** | 新功能、風險區域、發布前 | 每次 build、CI |
513
- | **優勢** | 創造力、適應性 | 速度、可重複性 |
552
+ | **時機** | 新功能、風險區域、發布前 | 每次 build、持續整合 |
553
+ | **優勢** | 創造力、適應性、情境理解 | 速度、可重複性、覆蓋率 |
554
+ | **成本** | 每個 session 的人力投入 | 長期的維護成本 |
555
+
556
+ **發現到保護循環**:
514
557
 
515
- **發現到保護循環**:探索 → 記錄 → 自動化 → 保護 → 重複
558
+ 1. **探索** — 進行探索式 session,發現新缺陷
559
+ 2. **回報** — 在 session 記錄中記錄發現的 Bug
560
+ 3. **自動化** — 將已確認的 Bug 轉為自動化迴歸測試
561
+ 4. **保護** — 自動化測試防止問題在未來的 build 中再次發生
562
+ 5. **重複** — 新的探索式 session 聚焦於尚未探索的區域
516
563
 
517
- > **規則**:透過探索式測試發現的每個 Bug 應在同一 Sprint 內新增對應的自動化迴歸測試。
564
+ > **規則**:透過探索式測試發現的每個 Bug **應該**在同一 Sprint 內新增對應的自動化迴歸測試。這能將一次性的發現轉化為永久的保護。
518
565
 
519
566
  ---
520
567
 
@@ -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 可靠性套件)
14
+ > **來源**: XSPEC-067 | **驅動來源**: DEC-043 Wave 1 可靠性套件 | **狀態**: Trial(2026-04-17 ~ 2026-10-17)
18
15
 
19
- ---
20
-
21
- ## 目的
22
-
23
- Timeout 標準:層級預算(cascading 0.8×)、deadline propagation、與 circuit-breaker 整合。
24
-
25
- 避免多層呼叫鏈中下層 timeout 大於上層(導致上層先 timeout 而下層仍在執行的資源浪費)。透過 cascading 預算規則(每層 ≤ 0.8× 上層)與 deadline propagation(傳 absolute timestamp)讓整條呼叫鏈都能精準 fail-fast。
26
-
27
- ---
16
+ ## 概述
28
17
 
29
- ## 核心規範
18
+ Timeout 標準 — 避免多層呼叫鏈中下層 timeout 大於上層(導致上層先 timeout 而下層仍在執行的資源浪費)。透過 cascading 預算規則(每層 ≤ 0.8× 上層)與 deadline propagation(傳 absolute timestamp)讓整條呼叫鏈精準 fail-fast。與 `circuit-breaker` 整合,timeout 計入 failure count。
30
19
 
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)
20
+ ## 核心原則
36
21
 
37
- ---
38
-
39
- ## Cascading 預算規則
40
-
41
- **規則**:每下一層 timeout ≤ 0.8 × 上層 timeout
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,配置違規
42
27
 
43
- **範例**(Client timeout=10s,呼叫鏈 Client → Gateway → Service A → DB):
28
+ ## Cascading 預算範例
44
29
 
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) |
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
+ ```
51
36
 
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 總和不得超過此值 |
49
+ | 類型 | 預設值(ms) | 用途 |
50
+ |------|--------------|------|
51
+ | `connect_timeout` | 5000 | 建立 TCP / TLS 連線 |
52
+ | `request_timeout` | 30000 | 發送請求到收到完整回應 |
53
+ | `idle_timeout` | 60000 | 連線閒置多久後關閉 |
54
+ | `total_deadline` | 60000 | 含所有重試的整體上限 |
83
55
 
84
- ---
85
-
86
- ## 與 circuit-breaker 整合
56
+ ## 使用範例
87
57
 
88
- | 規則 | 說明 |
89
- |------|------|
90
- | Rule 1 | 每次 timeout 觸發視為一次失敗,計入 breaker 的 failure count |
91
- | Rule 2 | 連續 timeout 達 failureThreshold 時 breaker 進入 OPEN |
92
- | Rule 3 | OPEN 狀態下的請求應套用極短 timeout(或直接 fail-fast) |
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
93
61
 
94
- ---
95
-
96
- ## 情境範例
62
+ ## 錯誤碼
97
63
 
98
- **情境 1:cascading 預算驗證**
99
- - Client timeout=10s,各層依序 8s → 6.4s → 5.12s
64
+ - `TIMEOUT-001` — `REQUEST_TIMEOUT`(單次請求超時)
65
+ - `TIMEOUT-002` — `DEADLINE_EXCEEDED`(整體 deadline 已過)
66
+ - `TIMEOUT-003` — `CASCADING_BUDGET_VIOLATION`(下層 > 上層,配置錯誤)
100
67
 
101
- **情境 2:deadline 已過期 fail-fast**
102
- - 條件:請求抵達 Service A 時 X-Deadline 已過期
103
- - 結果:立即回 DEADLINE_EXCEEDED,不呼叫 DB
68
+ ## 參考資料
104
69
 
105
- **情境 3:timeout 觸發 circuit breaker**
106
- - 條件:連續 3 次下游呼叫皆 timeout(failureThreshold=3)
107
- - 結果:circuit-breaker 進入 OPEN,第 4 次立即回 CircuitOpenError
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
108
75
 
109
- ---
110
-
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
+ **Scope**: universal
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/token-budget.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: 72030e8c343a
6
7
  status: current
7
8
  ---
8
9
 
@@ -10,134 +11,62 @@ status: current
10
11
 
11
12
  > **語言**: [English](../../../core/token-budget.md) | 繁體中文
12
13
 
13
- **版本**: 1.0.0
14
- **最後更新**: 2026-04-15
15
- **適用範圍**: 所有有 token 預算限制的 Agent 執行環境
16
- **Scope**: universal
17
- **來源**: XSPEC-036(claude-code-book Ch.7 four-zone threshold model)
18
-
19
- ---
20
-
21
- ## 目的
22
-
23
- Token 閾值四區模型:以使用率百分比劃分四個運作區間,漸進觸發不同強度的保護策略。
24
-
25
- 比「打到上限才停」更優雅,為使用者提供早期預警和自動降級機會。
26
-
27
- ---
28
-
29
- ## 核心規範
30
-
31
- - 所有有 token 預算限制的執行環境必須使用四區模型監控使用率
32
- - WARNING 區必須記錄日誌並發出可觀測事件,不得靜默
33
- - DANGER 區必須觸發輕量保護策略(如截斷工具結果、縮減輸出預算)
34
- - BLOCKING 區必須拒絕新請求,回傳 `TOKEN_BUDGET_EXCEEDED` 而非讓請求超時崩潰
35
- - 壓縮操作本身需保留足夠的輸出空間(否則壓縮本身也可能失敗)
36
-
37
- ---
38
-
39
- ## 四區模型
40
-
41
- | 區間 | 使用率範圍 | 行動 | 日誌等級 |
42
- |------|----------|------|---------|
43
- | **SAFE**(安全) | 0% – 84% | 正常執行 | — |
44
- | **WARNING**(警告) | 85% – 89% | 發出 `TOKEN_BUDGET_WARNING` 事件,通知 Coordinator/使用者 | `info` |
45
- | **DANGER**(危險) | 90% – 94% | 觸發輕量壓縮策略 | `warn` |
46
- | **BLOCKING**(阻塞) | 95% – 100% | 拒絕新請求,回傳 `TOKEN_BUDGET_EXCEEDED` | `error` |
47
-
48
- ### WARNING 區可選行動
49
-
50
- - 降低 `model_tier`(capable → standard)
51
- - 提示使用者考慮分割任務
52
-
53
- ### DANGER 區必要行動
54
-
55
- - 截斷超大工具結果(Tool Result Snip)
56
- - 縮減後續 Agent 的 `maxToolRounds`(建議降低 20%)
14
+ > **來源**: XSPEC-036 | **借鑑自**: claude-code-book Ch.7
57
15
 
58
- ### DANGER 區可選行動
16
+ ## 概述
59
17
 
60
- - 將重要輸出持久化到磁碟,上下文只保留摘要
18
+ Token 預算區間模型將 token 使用量劃分為四個漸進的區間,每個區間觸發強度逐步升高的保護策略。這可避免「一切正常直到突然崩潰」的失效模式,讓系統在撞到硬上限之前有時間優雅降級。
61
19
 
62
- ---
63
-
64
- ## 閾值常數
20
+ ## 區間
65
21
 
66
- | 常數 | 值 |
67
- |------|-----|
68
- | `WARNING_THRESHOLD` | `0.85` |
69
- | `DANGER_THRESHOLD` | `0.90` |
70
- | `BLOCKING_THRESHOLD` | `0.95` |
22
+ | 區間 | 範圍 | 行動 | 日誌等級 |
23
+ |------|------|------|---------|
24
+ | **SAFE**(安全) | 0–84% | 正常執行 | — |
25
+ | **WARNING**(警告) | 85–89% | 發出事件,通知 Coordinator | info |
26
+ | **DANGER**(危險) | 90–94% | 觸發輕量壓縮(Snip) | warn |
27
+ | **BLOCKING**(阻塞) | 95–100% | 拒絕新請求,回傳錯誤 | error |
71
28
 
72
- ---
29
+ ## 常數
73
30
 
74
- ## 類型定義
31
+ ```typescript
32
+ const TOKEN_BUDGET_ZONE = {
33
+ WARNING_THRESHOLD: 0.85,
34
+ DANGER_THRESHOLD: 0.90,
35
+ BLOCKING_THRESHOLD: 0.95,
36
+ } as const;
75
37
 
76
- ### TokenBudgetZone
77
-
78
- ```
79
- safe | warning | danger | blocking
38
+ type TokenBudgetZone = "safe" | "warning" | "danger" | "blocking";
80
39
  ```
81
40
 
82
- ### TokenBudgetStatus
83
-
84
- | 欄位 | 類型 |
85
- |------|------|
86
- | `current_tokens` | `number` |
87
- | `max_tokens` | `number` |
88
- | `usage_ratio` | `number` |
89
- | `zone` | `TokenBudgetZone` |
90
-
91
- ### TokenBudgetExceededError
92
-
93
- | 欄位 | 類型 |
94
- |------|------|
95
- | `code` | `"TOKEN_BUDGET_EXCEEDED"` |
96
- | `current_tokens` | `number` |
97
- | `max_tokens` | `number` |
98
- | `usage_ratio` | `number` |
99
- | `zone` | `"blocking"` |
100
-
101
- ---
102
-
103
- ## 壓縮後預算常數參考
41
+ ## DANGER 區行動
104
42
 
105
- | 常數 | 值 |
106
- |------|-----|
107
- | `MAX_FILES_TO_RESTORE` | `5` |
108
- | `TOTAL_TOKEN_BUDGET` | `50000` |
109
- | `MAX_TOKENS_PER_FILE` | `5000` |
110
- | `MAX_TOKENS_PER_SKILL` | `5000` |
43
+ 進入 DANGER 區(90–94%)時:
44
+ 1. **Tool Result Snip**:截斷超大工具輸出,保留摘要
45
+ 2. **縮減 maxToolRounds**:後續 Agent 降低 20%
46
+ 3. **持久化到磁碟**:將重要輸出移出上下文
111
47
 
112
- ---
48
+ ## 壓縮後預算
113
49
 
114
- ## 遙測事件
50
+ 壓縮操作本身需要輸出空間才能成功。保留常數:
115
51
 
116
- **`token_budget_zone_change`**
117
-
118
- | 欄位 | 類型 |
119
- |------|------|
120
- | `from_zone` | `TokenBudgetZone` |
121
- | `to_zone` | `TokenBudgetZone` |
122
- | `usage_ratio` | `number` |
123
- | `agent_name` | `string` |
124
- | `timestamp` | `string` |
125
-
126
- ---
52
+ | 常數 | 值 | 用途 |
53
+ |------|-----|------|
54
+ | `MAX_FILES_TO_RESTORE` | 5 | 壓縮後最多還原的檔案數 |
55
+ | `TOTAL_TOKEN_BUDGET` | 50,000 | 壓縮後的總 token 預算 |
56
+ | `MAX_TOKENS_PER_FILE` | 5,000 | 每個檔案的 token 上限 |
127
57
 
128
58
  ## 適用場景
129
59
 
130
- - Task 執行(Token 預算監控;採用層)
131
- - 多 Agent Pipeline(跨 Agent 累積上下文監控;採用層)
60
+ - Task 執行的 token 監控(採用層)
61
+ - 多 Agent Pipeline 的累積上下文管理(採用層)
132
62
  - PipelineMemory Snip 觸發條件(採用層)
133
- - 任何有 `maxTotalTokens` 限制的 Agent 執行環境
63
+ - 任何有 `maxTotalTokens` 限制的環境
134
64
 
135
- ---
65
+ ## 參考資料
136
66
 
137
- ## 錯誤碼
67
+ - AI 最佳化版本:[ai/standards/token-budget.ai.yaml](../../../ai/standards/token-budget.ai.yaml)
68
+ - XSPEC-036:跨專案規格
69
+ - 借鑑自:[claude-code-book](https://github.com/lintsinghua/claude-code-book) Ch.7 四區上下文管理
138
70
 
139
- | 代碼 | 說明 |
140
- |------|------|
141
- | `TB-001` | `TOKEN_BUDGET_EXCEEDED` — 已進入 BLOCKING 區,拒絕新請求 |
142
- | `TB-002` | `TOKEN_BUDGET_WARNING` — 已進入 WARNING 區,建議採取行動 |
143
- | `TB-003` | `SNIP_FAILED` — 輕量壓縮失敗,仍在 DANGER 區 |
71
+
72
+ **Scope**: universal