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,9 +1,9 @@
1
1
  ---
2
2
  source: ../../../core/full-coverage-testing.md
3
- source_version: 1.1.0
4
- translation_version: 1.1.0
5
- last_synced: 2026-07-23
6
- source_hash: 8ca921c68533
3
+ source_version: 1.3.0
4
+ translation_version: 1.3.0
5
+ last_synced: 2026-10-08
6
+ source_hash: 6962df9f7135
7
7
  status: current
8
8
  ---
9
9
 
@@ -12,7 +12,7 @@ status: current
12
12
  > **Language**: [English](../../../core/full-coverage-testing.md) | 繁體中文
13
13
 
14
14
  > **AI 最佳化版本**: `ai/standards/full-coverage-testing.ai.yaml`
15
- > **XSPEC**: XSPEC-178
15
+ > **XSPEC**: XSPEC-178、XSPEC-444(R2、R5——提交前警告與隨附閘門腳本)、XSPEC-470(R1——恆真式=預期值不獨立)
16
16
  > **取代**: 金字塔門檻模型(UT≥80%、IT≥70%、E2E 僅 happy-path)
17
17
 
18
18
  ## 概述
@@ -61,18 +61,58 @@ Coverage improved: 91.3% → 92.0%. New baseline set.
61
61
 
62
62
  ### 禁止:恆真斷言(Tautology Assertions)
63
63
 
64
- 無論行為如何都會通過的斷言,提供的是虛假覆蓋率。
64
+ 斷言若不可能與實作產生分歧,提供的就是虛假覆蓋率。恆真斷言有兩種:
65
+
66
+ 1. **恆為真**——不管程式做什麼都會通過:`expect(true).toBe(true)`、`assert 200 == 200`。
67
+ 2. **預期值不獨立**——預期值由被測的程式碼產生,或由測試裡再寫一遍的同一套邏輯產生。實作正確時它會通過;實作與那份複本以同樣方式出錯時,它照樣通過。
68
+
69
+ 第二種用 [`verification-oracle`](verification-oracle.md) 的詞彙定義:斷言的**預言(oracle)**是「說明正確答案是什麼」的來源,恆真式就是**預言本身就是被測實作**的斷言。本標準不另立第二套「獨立真值」定義,直接採用該標準的:登錄的真值案例、已知的字面值、手算例,或規格(見其 *Oracle-ability Spectrum*)。
65
70
 
66
71
  ```typescript
67
72
  // ❌ FORBIDDEN — always passes, tests nothing
68
73
  expect(true).toBe(true)
69
74
  expect(result).toBeDefined() // without specific value
70
75
 
71
- // ✅ REQUIRED — verifies actual behavior
76
+ // ❌ FORBIDDEN — the oracle is the implementation
77
+ expect(countInstalled(manifest)).toBe(countInstalled(manifest)) // the same call on both sides
78
+ expect(countInstalled(manifest)).toBe(manifest.standards.filter(s => s.installed).length) // the same logic, typed again
79
+ // ^ 這一例要靠審查者判斷:自動檢查只抓下方〈隨附掃描腳本判定什麼、哪些留給審查者〉列的子集,這一例不在其中
80
+
81
+ // ✅ REQUIRED — a value that was decided before the code ran
72
82
  expect(result).toBe(90)
73
83
  expect(result).toEqual({ discount: 10, total: 90 })
84
+ expect(countInstalled({ standards: [{ id: 'a', installed: true }, { id: 'b', installed: false }] })).toBe(1)
74
85
  ```
75
86
 
87
+ 並非每個「兩個算出來的值互相比較」都是恆真式。下列是正常測試,**不會**被回報:
88
+
89
+ | 看起來相似 | 為什麼它是真測試 |
90
+ |------------|------------------|
91
+ | 動作之後 `expect(snapshot(dir)).toEqual(before)` | 問的是「有沒有任何東西變動?」——兩個值取自不同時間點 |
92
+ | `expect(parse(a)).toEqual(parseWithOldEngine(a))` | 預言是另一份獨立寫成的實作 |
93
+ | 名稱就是在講決定性的測試裡 `expect(hash(x)).toBe(hash(x))` | 比較兩次呼叫正是這支測試的目的 |
94
+ | `report` 與 `rows` 來自不同資料路徑時的 `expect(report.total).toBe(rows.reduce(...))` | 兩個來源之間的對帳 |
95
+
96
+ #### 隨附掃描腳本判定什麼、哪些留給審查者
97
+
98
+ `scripts/check-anti-fake-tests.mjs`(見下方〈兩支掃描腳本〉)只點名光看文字就能判定的兩種形狀。它讀 **JavaScript/TypeScript**(`toBe`、`toEqual`、`toStrictEqual`、chai 的 `to.equal`/`to.eql`、node 的 `assert.equal`/`strictEqual`/`deepEqual`/`deepStrictEqual`):
99
+
100
+ | 形狀 | 範例 | 回報條件 |
101
+ |------|------|----------|
102
+ | **同一個呼叫(same call)** | `expect(total(items)).toBe(total(items))` | 兩側是同一個函式、同樣的參數(呼叫裡沒有另一個呼叫或 `new`),寫在同一個敘述裡,且測試名稱不是在講「比較兩次呼叫」(決定性、冪等、快取、同一性) |
103
+ | **重算(recomputed)** | `expect(total(items)).toBe(items.reduce((s, i) => s + i.price, 0))` | 被測呼叫吃一個輸入,預期值把同一個輸入(就是引數本身,如 `items.reduce`,不是它的某個欄位)送進 `reduce`、`map`、`flatMap` 或 `filter`,且回呼只用到自己的參數(外加 `Math`、`Number`、`String` 這類純內建)、不含任何字面值、不是單純的複製(`(x) => x`、`(x) => ({ ...x })`);被測呼叫是單一呼叫,裡面沒有別的呼叫或 `new`,後面也沒有接 `.length` 之類的屬性存取。只讀斷言本身的文字:前面幾行設定過的名稱一律不展開 |
104
+
105
+ 下列看起來相似的寫法**刻意放過**,因為光看文字分不出它們和正當測試的差別:`expect(priceOf(ids)).toEqual(ids.map(id => KNOWN_PRICES[id]))`(預期值查寫死的價目表,是獨立來源);`expect(activeOf(users)).toEqual(users.filter(u => u.id === 2))`(字面值是測試作者提供的知識);`expect(render(now())).toBe(render(now()))`(兩次 `now()` 是兩個值,兩側不一定相等);`expect(parse(serialize(rows))).toEqual(rows.map(r => r))`(往返測試:被測呼叫裡還有呼叫);`expect(clone(input)).toEqual(input.map(x => x))`(只把參數原樣回傳、或把參數淺複製的回呼(如 `u => ({ ...u })`)、或把解構參數原樣組回同一形狀的回呼(如 `([k, v]) => [k, v]`),是複製而不是邏輯;`filter(x => x)` 依真假值篩選,是有邏輯的,但光看文字分不出它和複製的差別,所以一併放過);`expect(sortUsers(users).length).toBe(users.filter(u => u.name).length)`(被測的值是結果的屬性,哪一側才對光看文字判不出)。`const before = items.map(i => i.price); freezeCart(items); expect(pricesOf(items)).toEqual(before)`(前面幾行設定的名稱存的是較早時刻的值,中間發生的事正是這支測試要問的;「同一呼叫」也是這樣讀的)。原則是:拿不準寧可漏抓,不可誤報。
106
+
107
+ **兩個已接受、不隱瞞的代價。**
108
+
109
+ 1. **差分測試會被點名。** 拿參考實作當預期值的測試,`expect(fastTotal(items)).toBe(items.reduce((s, i) => s + i.price, 0))`,文字上和教科書例一模一樣,所以掃描腳本會點名它。這種測試是正當的(見上表「預言是另一份獨立寫成的實作」);處理方式有二:在同一支測試裡另外加一個對手算字面值的斷言(只有在測試的所有斷言都不是真斷言時才回報),或把該檔列進 `.standards/test-policy.json` 的 `ignore`(這會讓整個檔案不再被這支腳本的任何檢查看到,且 `ignore` 不收理由,請在註解寫明)。測試名稱寫「與參考實作一致」**不能**豁免,`exempt` 清單也不適用於這支腳本(它屬於「改了程式碼卻沒有測試」的檢查)。
110
+ 2. **這條規則很容易被繞過。** 把**被測值**包進 `Number(...)`、在它後面接 `.valueOf()` 或 `[0]`、把引數改成 `items.slice()`,掃描腳本就看不到了。(對**預期值**做同樣的事沒有用:照樣會被點名。)它是提醒審查者的線索,不是擋得住刻意規避的閘門,寫測試的是 AI 代理時尤其如此:掃描乾淨不能當成預期值獨立的證據。下面審查者的問題才是控制手段,腳本只指出最容易判的情形。
111
+
112
+ 與 `expect(true).toBe(true)` 相同,只有在測試的**所有**斷言都不是真斷言時才回報;自我比較旁邊還有一個對字面值的斷言,就留給審查者。文字判不了的,掃描腳本保持沉默——會亂叫的掃描腳本遲早被關掉。
113
+
114
+ 其餘一律是**審查者的判斷題**,在程式碼審查時問(見[程式碼審查檢查清單](code-review-checklist.md)):這個預期值從哪裡來?能不能靠執行被測程式碼得到?如果實作錯得跟測試自己的算式一樣,這支測試還會過嗎?掃描腳本不判的典型情形:手寫迴圈重新推導答案、包著實作的輔助函式、拿實作第一次的輸出當快照,以及 JavaScript/TypeScript 以外的所有語言。
115
+
76
116
  ### 禁止:Mock 核心業務邏輯
77
117
 
78
118
  Mock 自己的程式碼,意味著業務邏輯從未真正執行。
@@ -233,6 +273,60 @@ legacy 降級模式(外部服務失敗時的 fallback、重試、部分結果
233
273
 
234
274
  ---
235
275
 
276
+ ## UDS 隨附的提交前警告與閘門腳本(XSPEC-444 R2、R5)
277
+
278
+ 上面的規則過去要靠標準叫你自己寫的腳本來執行。現在 `uds init` 會直接把掃描腳本寫進你的專案,而 `uds check`——UDS 的 pre-commit hook 執行的指令——會印出這些腳本和另一項檢查找到的東西。**預設一律只警告、不擋任何東西**;要收緊是選擇性的(見「先警告,之後再收緊」)。
279
+
280
+ ### 兩支掃描腳本(`uds init` 寫到 `scripts/`)
281
+
282
+ | 腳本 | 找什麼 |
283
+ |------|--------|
284
+ | `scripts/check-anti-fake-tests.mjs` | **沒有斷言**的測試;唯一的斷言是**恆真式**的測試(`expect(true).toBe(true)`、`assert 200 == 200`;JavaScript/TypeScript 另含「預期值就是被測的同一個呼叫」或「以同一個輸入經 `reduce`/`map`/`filter` 重算而得」,見〈禁止:恆真斷言〉);**每一支測試都被跳過或標為 todo** 的測試檔 |
285
+ | `scripts/check-stubs.mjs` | `// WARNING: STUB` 標記;宣稱**尚未實作**的函式本體(`raise NotImplementedError`、`todo!()`、`TODO()` 等)而旁邊沒有標記;本體**為空**的具名函式而旁邊沒有標記 |
286
+
287
+ - 純 Node、零相依、不預設任何測試框架。它們是**你的檔案**:可以改、可以接進 CI。單獨執行時,找到東西就以非 0 結束——`node scripts/check-stubs.mjs` 就是本標準部署閘門所說的 pre-push/部署閘門。
288
+ - `uds init` 不會覆寫已存在的檔案,`uds update` 也不會;較早初始化的專案,`uds update` 會詢問是否寫入(提示的預設為否;`uds update -y` 會直接回答是)。
289
+ - 有暫存檔案時只讀那些檔案;沒有暫存任何東西時(CI 執行、手動 `uds check`)每支都會走訪整個專案——走訪最多 200,000 個檔案,`uds check` 給每支 120 秒(超過就回報「無法判定」,絕不算通過)——所以在很大的儲存庫裡,請在 CI 執行,不要期待立刻完成。
290
+ - 同一行或上面三行內出現 `STUB` 或 `COVERAGE_EXEMPT`,該暫時實作就算已**宣告**;已宣告的只以標記回報一次。
291
+ - **語言範圍。**測試檔規則涵蓋 JavaScript/TypeScript、Python、Java/Kotlin/Scala/C#、Go、Rust、Ruby、Elixir、PHP、Swift、Dart、Lua 與 C/C++。其他語言的測試檔會被列為「未掃描」——絕不當成乾淨。空函式規則涵蓋 JavaScript/TypeScript、Python、Go、Rust、Ruby 與 PHP;其他語言仍會找標記與「尚未實作」的本體,輸出也會寫出哪些語言沒有空函式規則。
292
+ - 它們讀的是文字,不執行你的測試。若某個輔助函式用掃描器認不得的名稱做斷言,會被報為「no-assertion」:把它命名為 `assert*`/`verify*`/`expect*`,或把它的樣式列在政策檔的 `assertionPatterns`。
293
+ - 每次執行都先拿已知的假測試與已知的好測試檢驗自己;檢驗失敗就以 `2`(「無法判定」)結束,這絕不算通過。
294
+
295
+ ### 改了程式碼卻沒動測試(`uds check`,針對已暫存的變更)
296
+
297
+ 有檔案暫存準備提交時,`uds check` 會比對變更內容:
298
+
299
+ - 改了程式檔,**同一次提交沒有任何測試檔變動** → 警告,並列出程式檔;
300
+ - 變更中有 UDS 不認得的檔案類型 → 警告,列出它並說明如何分類(絕不當成沒事,也絕不擋);
301
+ - 刪除不算需要測試的變更;**純重新命名**(git 的 `R100`)與符合 `exempt` 條目的路徑可免,輸出會記下理由。
302
+
303
+ 沒有暫存任何東西時(CI 執行、手動 `uds check`),差異檢查不出聲;兩支掃描腳本則改為掃整個專案。
304
+
305
+ ### 政策檔 `.standards/test-policy.json`(選用)
306
+
307
+ 哪些路徑是測試、哪些是程式,是附有常見生態預設值的資料,不是一份框架清單。每個清單都是**加進**預設值:
308
+
309
+ ```json
310
+ {
311
+ "mode": "warn",
312
+ "testDirs": ["integration"],
313
+ "testPatterns": ["*.itest.*"],
314
+ "sourceExtensions": ["zig"],
315
+ "nonCodeExtensions": ["gradle"],
316
+ "ignore": ["generated/**"],
317
+ "exempt": [{ "pattern": "src/gen/**", "reason": "generated by protoc" }],
318
+ "assertionPatterns": ["\\bmustMatch\\w*\\s*\\("]
319
+ }
320
+ ```
321
+
322
+ 沒有 `reason` 的 `exempt` 條目不會生效,並會被回報:豁免必須說明原因。
323
+
324
+ ### 先警告,之後再收緊
325
+
326
+ `"mode": "warn"`(預設)只印出警告、放行提交。`"mode": "block"` 會讓 `uds check` 在以下情況以非 0 結束,因此擋下提交:掃描腳本找到東西、掃描腳本無法判定、或改了程式碼卻沒動測試。UDS 不認得的檔案類型永遠不會擋。**尚未實作**(規格沒有定義基線放在哪裡、以什麼計數):未配測試的變更數棘輪,以及逐次提交的豁免理由(pre-commit hook 讀不到提交訊息)。
327
+
328
+ ---
329
+
236
330
  ## 從金字塔模型遷移
237
331
 
238
332
  若你的專案先前使用金字塔門檻:
@@ -240,8 +334,8 @@ legacy 降級模式(外部服務失敗時的 fallback、重試、部分結果
240
334
  1. **刪除** `jest.config.js` / `vitest.config.ts` 中任何硬編碼的覆蓋率門檻(`coverageThreshold` 選項)
241
335
  2. **安裝** `.coverage-baseline.json`,以目前的覆蓋率作為棘輪起點
242
336
  3. **新增** `scripts/check-coverage-ratchet.sh` 到 CI
243
- 4. **新增** `scripts/check-stubs.sh` 到 deploy.sh 與 pre-push hook
244
- 5. **新增** `scripts/check-anti-fake-tests.sh` 到 pre-commit 或 CI
337
+ 4. **新增** `scripts/check-stubs.mjs` 到 deploy.sh 與 pre-push hook(由 `uds init` 寫入;既有專案由 `uds update` 提供)
338
+ 5. **新增** `scripts/check-anti-fake-tests.mjs` 到 pre-commit 或 CI(由 `uds init` 寫入;`uds check` 已會執行並警告)
245
339
 
246
340
  棘輪從你目前的覆蓋率開始。從那一刻起,它只能上升。
247
341
 
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/git-workflow.md
3
3
  source_version: 1.4.0
4
4
  translation_version: 1.4.0
5
- last_synced: 2026-04-22
5
+ last_synced: 2026-10-11
6
+ source_hash: dbbce0815e5e
6
7
  status: current
7
8
  ---
8
9
 
@@ -11,81 +12,240 @@ status: current
11
12
  > **語言**: [English](../../../core/git-workflow.md) | 繁體中文
12
13
 
13
14
  **版本**: 1.4.0
14
- **最後更新**: 2026-02-10
15
- **適用性**: 所有軟體專案
16
- **範圍**: 通用 (Universal)
15
+ **最後更新**: 2026-01-29
16
+ **適用性**: 所有使用 Git 進行版本控制的專案
17
+ **範圍**: universal(通用)
18
+ **業界標準**: 無(業界通行實踐)
19
+ **參考資料**: [atlassian.com](https://www.atlassian.com/git/tutorials)
20
+
21
+ > **詳細說明與教學請參閱 [Git 工作流程指南](guides/git-workflow-guide.md)**
17
22
 
18
23
  ---
19
24
 
20
25
  ## 目的
21
26
 
22
- 本標準定義 Git 分支策略、合併規則和 PR 工作流程的強制性規則。關於詳細的教學、決策樹和不同工作流程的比較(如 GitFlow vs Trunk-Based),請參閱 **[Git 工作流程指南](guides/git-workflow-guide.md)**。
27
+ 本標準定義 Git 分支策略與工作流程,確保跨團隊、跨專案擁有一致且可預期的協作模式。
28
+
29
+ ---
30
+
31
+ ## 工作流程策略選擇
32
+
33
+ **專案必須擇一**採用工作流程策略,並清楚記錄。
34
+
35
+ | 因素 | GitFlow | GitHub Flow | Trunk-Based |
36
+ |--------|---------|-------------|-------------|
37
+ | **發布頻率** | 每月以上 | 每週 | 每天多次 |
38
+ | **團隊規模** | 大型(10+) | 中型(5-15) | 小至中型(3-10) |
39
+ | **CI/CD 成熟度** | 基礎 | 中等 | 進階 |
40
+ | **Feature flags** | 選用 | 選用 | 必要 |
41
+ | **複雜度** | 高 | 低 | 中 |
42
+
43
+ ---
44
+
45
+ ## 分支類型
46
+
47
+ ### GitFlow 分支類型
48
+
49
+ | 分支類型 | 目的 | 基底分支 | 合併目標 | 生命週期 |
50
+ |-------------|---------|-------------|--------------|----------|
51
+ | `main` | 正式環境程式碼 | - | - | 永久 |
52
+ | `develop` | 整合分支 | - | - | 永久 |
53
+ | `feature/*` | 新功能 | `develop` | `develop` | 暫時 |
54
+ | `release/*` | 發布準備 | `develop` | `main` + `develop` | 暫時 |
55
+ | `hotfix/*` | 緊急修復 | `main` | `main` + `develop` | 暫時 |
56
+
57
+ ### GitHub Flow 分支類型
58
+
59
+ | 分支類型 | 目的 | 基底分支 | 合併目標 | 生命週期 |
60
+ |-------------|---------|-------------|--------------|----------|
61
+ | `main` | 正式環境程式碼 | - | - | 永久 |
62
+ | `feature/*` | 新功能 | `main` | `main` | 暫時 |
63
+ | `bugfix/*` | Bug 修復 | `main` | `main` | 暫時 |
64
+ | `hotfix/*` | 緊急修復 | `main` | `main` | 暫時 |
65
+
66
+ ### Trunk-Based 分支類型
67
+
68
+ | 分支類型 | 目的 | 基底分支 | 合併目標 | 生命週期 |
69
+ |-------------|---------|-------------|--------------|----------|
70
+ | `main` | 主幹 | - | - | 永久 |
71
+ | `feature/*` | 小型變更 | `main` | `main` | ≤2 天 |
23
72
 
24
73
  ---
25
74
 
26
75
  ## 分支命名慣例
27
76
 
28
- | 分支類型 | 前綴 | 範例 | 目的 |
29
- |----------|------|------|------|
30
- | **Feature** | `feature/` | `feature/user-login` | 新功能開發 |
31
- | **Fix** | `fix/` | `fix/login-error` | Bug 修復 |
32
- | **Documentation** | `docs/` | `docs/api-update` | 文件變更 |
33
- | **Chore** | `chore/` | `chore/dep-update` | 維護任務 |
34
- | **Refactor** | `refactor/` | `refactor/auth-module` | 程式碼重構 |
35
- | **Test** | `test/` | `test/e2e-suite` | 新增或修復測試 |
77
+ ### 標準格式
78
+
79
+ ```
80
+ <type>/<short-description>
81
+ ```
82
+
83
+ ### 類型
84
+
85
+ | 類型 | 用途 | 範例 |
86
+ |------|-------|---------|
87
+ | `feature/` | 新功能 | `feature/oauth-login` |
88
+ | `fix/` 或 `bugfix/` | Bug 修復 | `fix/memory-leak` |
89
+ | `hotfix/` | 正式環境緊急修復 | `hotfix/security-patch` |
90
+ | `refactor/` | 程式碼重構 | `refactor/extract-service` |
91
+ | `docs/` | 僅文件變更 | `docs/api-reference` |
92
+ | `test/` | 新增測試 | `test/integration-tests` |
93
+ | `chore/` | 維護任務 | `chore/update-dependencies` |
94
+ | `release/` | 發布準備(GitFlow) | `release/v1.2.0` |
95
+
96
+ ### 命名規則
97
+
98
+ 1. **使用小寫**
99
+ 2. **以連字號取代空格**
100
+ 3. **具描述性但保持精簡**
101
+ 4. **避免僅以 issue 編號作為識別**
102
+
103
+ ---
104
+
105
+ ## 合併策略
36
106
 
37
- **規則**:
38
- 1. 使用小寫和 kebab-case
39
- 2. 包含票號 (如果適用): `feature/JIRA-123-user-login`
40
- 3. 嚴禁使用通用名稱如 `dev`, `wip`, `temp`
107
+ **專案必須**針對每種分支類型**擇一**採用。
108
+
109
+ | 策略 | 指令 | 最適用於 | 優點 | 缺點 |
110
+ |----------|---------|----------|------|------|
111
+ | **Merge Commit** | `git merge --no-ff` | GitFlow、長期存在的功能分支 | 完整歷史、易於還原 | 日誌雜亂 |
112
+ | **Squash Merge** | `git merge --squash` | GitHub Flow、功能分支 | 歷史乾淨、每個功能一個提交 | 遺失細節 |
113
+ | **Rebase + FF** | `git rebase && git merge --ff-only` | Trunk-Based、短期分支 | 線性歷史、保留提交 | 改寫歷史 |
41
114
 
42
115
  ---
43
116
 
44
- ## 合併策略 (Merge Strategy)
117
+ ## 建立分支前檢查清單
118
+
119
+ 建立新分支前,請完成以下檢查:
120
+
121
+ ### 適用於 GitFlow 與 GitHub Flow
45
122
 
46
- | 策略 | 命令 | 使用時機 | 結果 |
47
- |------|------|----------|------|
48
- | **Squash Merge** | `git merge --squash` | Feature/Fix 分支合併回主幹 | 保持主幹歷史乾淨,單一提交代表一個功能 |
49
- | **Rebase Merge** | `git rebase` + `merge` | 本地同步上游變更 | 線性歷史,無額外合併提交 |
50
- | **Merge Commit** | `git merge --no-ff` | 發布分支 (Release) | 保留發布歷史節點 |
123
+ - [ ] 檢查未合併的分支:`git branch --no-merged main`
124
+ - [ ] 同步最新程式碼:`git checkout main && git pull origin main`
125
+ - [ ] 確認測試通過:執行專案測試套件
126
+ - [ ] 建立分支:`git checkout -b feature/description`
51
127
 
52
- **預設規則**: 對於 PR/MR,預設使用 **Squash Merge**,除非專案另有規定。
128
+ ### 適用於 Trunk-Based 開發
129
+
130
+ - [ ] 同步最新程式碼:`git checkout main && git pull origin main`(關鍵)
131
+ - [ ] 確認測試通過(關鍵)
132
+ - [ ] 建立短期分支:`git checkout -b feature/description`
53
133
 
54
134
  ---
55
135
 
56
- ## Commit 訊息規範
136
+ ## 衝突解決
137
+
138
+ ### 預防檢查清單
57
139
 
58
- 遵循 [Commit 訊息指南](commit-message-guide.md)。
140
+ - [ ] 經常與基底分支同步
141
+ - [ ] 保持分支精簡(避免長期存在的功能分支)
142
+ - [ ] 重大重構事先告知團隊
59
143
 
60
- 格式: `<type>(<scope>): <subject>`
144
+ ### 解決步驟
61
145
 
62
- 範例: `feat(auth): implement jwt validation`
146
+ ```bash
147
+ git checkout main && git pull origin main
148
+ git checkout feature/my-feature && git merge main
149
+ # Resolve conflicts in marked files
150
+ git add resolved-file.js
151
+ git commit -m "chore: resolve merge conflicts with main"
152
+ npm test # Verify
153
+ git push origin feature/my-feature
154
+ ```
63
155
 
64
156
  ---
65
157
 
66
- ## 核心工作流程規則
158
+ ## 標籤與發布
159
+
160
+ ### 語意化版本
161
+
162
+ ```
163
+ MAJOR.MINOR.PATCH
164
+ ```
165
+
166
+ | 組成 | 何時遞增 | 範例 |
167
+ |-----------|-------------------|---------|
168
+ | **MAJOR** | 破壞性變更 | v2.0.0 |
169
+ | **MINOR** | 新功能(向下相容) | v1.2.0 |
170
+ | **PATCH** | Bug 修復(向下相容) | v1.2.1 |
171
+
172
+ ### 預發布版本
173
+
174
+ | 類型 | 格式 | 範例 |
175
+ |------|--------|---------|
176
+ | Alpha | `X.Y.Z-alpha.N` | v1.2.0-alpha.1 |
177
+ | Beta | `X.Y.Z-beta.N` | v1.2.0-beta.2 |
178
+ | RC | `X.Y.Z-rc.N` | v1.2.0-rc.1 |
179
+
180
+ ### 建立標籤
181
+
182
+ ```bash
183
+ git tag -a v1.2.0 -m "Release version 1.2.0: Add OAuth2 support"
184
+ git push origin v1.2.0
185
+ ```
186
+
187
+ ---
188
+
189
+ ## 受保護分支
190
+
191
+ ### `main`/`develop` 建議保護設定
192
+
193
+ | 設定 | 是否需要 |
194
+ |---------|----------|
195
+ | 要求 pull request 審查 | ✅(1-2 位審查者) |
196
+ | 要求狀態檢查通過 | ✅(CI 測試、linting) |
197
+ | 要求分支保持最新 | ✅ |
198
+ | 包含管理員 | ✅ |
199
+ | 允許強制推送 | ❌ |
200
+ | 允許刪除 | ❌ |
201
+
202
+ ---
203
+
204
+ ## Pull Request 工作流程
205
+
206
+ ### PR 建立檢查清單
207
+
208
+ - [ ] **標題遵循 commit 慣例**(例如 `feat(auth): add OAuth2`)
209
+ - [ ] **描述說明原因**(而不只是做了什麼)
210
+ - [ ] **連結到 issue**(例如「Closes #123」)
211
+ - [ ] **新功能附帶測試**
212
+ - [ ] **視需要更新文件**
213
+ - [ ] **在描述中標明破壞性變更**
214
+ - [ ] **UI 變更附上截圖/GIF**
215
+
216
+ ### PR 類型參考
67
217
 
68
- 1. **永遠不要直接提交到 `main` 或 `master`** (除非是單人專案且有把握)。
69
- 2. **提交前執行測試**: `npm test` 或對應指令。
70
- 3. **保持分支生命週期短**: Feature 分支不應存活超過 2-3 天。
71
- 4. **同步更新**: 在合併前,先 rebase 或 merge `main` 的最新變更。
218
+ | 類型 | 目的 | 範例 |
219
+ |------|---------|---------|
220
+ | `feat` | 新功能 | `feat(auth): add OAuth2 login` |
221
+ | `fix` | Bug 修復 | `fix(api): handle null response` |
222
+ | `docs` | 文件 | `docs(readme): update install steps` |
223
+ | `refactor` | 程式碼重構 | `refactor(utils): extract validation` |
224
+ | `test` | 新增測試 | `test(auth): add login unit tests` |
225
+ | `chore` | 維護 | `chore(deps): update lodash` |
226
+ | `perf` | 效能 | `perf(query): optimize user lookup` |
72
227
 
73
228
  ---
74
229
 
75
230
  ## 相關標準
76
231
 
77
- - [Git 工作流程指南](guides/git-workflow-guide.md) - 詳細教學與比較
78
232
  - [Commit 訊息指南](commit-message-guide.md)
79
233
  - [程式碼簽入標準](checkin-standards.md)
234
+ - [版本控制標準](versioning.md)
235
+ - [變更日誌標準](changelog-standards.md)
80
236
 
81
237
  ---
82
238
 
83
239
  ## 版本歷史
84
240
 
85
241
  | 版本 | 日期 | 變更 |
86
- |------|------|------|
87
- | 1.3.0 | 2026-01-29 | **重大重構**:拆分為規則(本文件)和指南(git-workflow-guide.md)。 |
88
- | 1.2.0 | 2025-12-20 | 更新合併策略說明 |
242
+ |---------|------|---------|
243
+ | 1.4.0 | 2026-01-29 | 重構:拆分為規則 + 指南,教學內容移至指南 |
244
+ | 1.3.0 | 2026-01-24 | 新增:Trunk-Based + Feature Flags 整合、Ship/Show/Ask 決策模型、Stacked PRs 工作流程 |
245
+ | 1.2.1 | 2025-12-24 | 新增:相關標準章節 |
246
+ | 1.2.0 | 2025-12-16 | 新增:決策樹、選擇矩陣 |
247
+ | 1.1.0 | 2025-12-08 | 新增建立分支前檢查清單章節 |
248
+ | 1.0.0 | 2025-11-12 | 初始 Git 工作流程標準 |
89
249
 
90
250
  ---
91
251
 
@@ -1,19 +1,20 @@
1
1
  ---
2
2
  source: ../../../core/git-worktree.md
3
- source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-03-24
6
- status: stale
3
+ source_version: 1.1.0
4
+ translation_version: 1.1.0
5
+ last_synced: 2026-10-11
6
+ source_hash: 12acb15a4884
7
+ status: current
7
8
  ---
8
9
 
9
10
  # Git Worktree 隔離
10
11
 
11
12
  > **語言**: [English](../../../core/git-worktree.md) | 繁體中文
12
13
 
13
- **版本**: 1.0.0
14
- **最後更新**: 2026-03-20
14
+ **版本**: 1.1.0
15
+ **最後更新**: 2026-06-18
15
16
  **適用性**: 所有使用 Git 進行版本控制的專案
16
- **範圍**: 通用 (Universal)
17
+ **範圍**: universal(通用)
17
18
  **靈感來源**: [Superpowers](https://github.com/obra/superpowers) — using-git-worktrees (MIT)
18
19
 
19
20
  ---
@@ -27,10 +28,10 @@ status: stale
27
28
  ## 術語表
28
29
 
29
30
  | 術語 | 定義 |
30
- |------|------|
31
- | Worktree | Git 儲存庫在不同分支上的鏈接工作副本 |
32
- | 基準測試 (Baseline Test) | 在新建 worktree 上執行的測試,用於驗證環境是乾淨的 |
33
- | Worktree 目錄 | worktree 被建立的檔案系統路徑 |
31
+ |------|-----------|
32
+ | Worktree | Git 儲存庫在不同分支上的連結工作副本 |
33
+ | 基準測試(Baseline Test) | 在新建 worktree 上執行的測試,用於驗證環境是乾淨的 |
34
+ | Worktree 目錄 | 建立 worktree 的檔案系統路徑 |
34
35
 
35
36
  ---
36
37
 
@@ -42,63 +43,92 @@ status: stale
42
43
 
43
44
  ## 生命週期階段
44
45
 
45
- ### 階段 1:建立
46
+ ### 階段 1:Setup(建立)
47
+
48
+ 1. **選擇 worktree 位置** — 優先順序:
49
+ - 既有的設定路徑
50
+ - `.uds/worktrees/` 或類似的專案內目錄
51
+ - 詢問使用者
52
+ 2. **驗證 `.gitignore`** — 執行 `git check-ignore` 確認 worktree 目錄已被忽略
53
+ 3. **建立 worktree** — `git worktree add <path> -b <branch-name>`
54
+ 4. **安裝依賴** — 視需要執行套件管理器的安裝指令
46
55
 
47
56
  ```bash
48
- # 建立新的 worktree
49
- git worktree add ../project-feature-name feature/feature-name
57
+ # Example setup
58
+ git worktree add .worktrees/feature-auth -b feature/auth
59
+ cd .worktrees/feature-auth
60
+ pnpm install # or npm install, pip install, etc.
50
61
  ```
51
62
 
52
- | 步驟 | 說明 |
53
- |------|------|
54
- | 1. 建立 worktree | 指定路徑和分支名稱 |
55
- | 2. 安裝依賴 | 在新 worktree 中執行 `npm install` 等 |
56
- | 3. 基準測試 | 執行測試確認環境乾淨 |
63
+ ### 階段 2:Baseline(基準驗證)
64
+
65
+ 1. 在新建的 worktree 中**執行測試套件**
66
+ 2. **確認所有測試通過** — 藉此驗證環境乾淨
67
+ 3. **若測試失敗** — 以退避方式最多重試 2 次,排除暫時性的不穩定/逾時;若仍失敗,則中止並報告環境問題(不得繼續)
68
+
69
+ ```bash
70
+ # Baseline verification
71
+ pnpm test # Must pass before any work begins
72
+ ```
57
73
 
58
- ### 階段 2:工作
74
+ 基準測試失敗代表環境有問題,必須中止並報告。
59
75
 
60
- - 在 worktree 中正常開發
61
- - 各 worktree 之間完全隔離
62
- - 不影響主工作目錄
76
+ ### 階段 3:Execute(執行)
63
77
 
64
- ### 階段 3:完成
78
+ 1. 將隔離的 worktree 當作一般開發環境進行工作
79
+ 2. 照常提交
80
+ 3. 變更後執行測試
65
81
 
66
- | 選項 | 指令 |
67
- |------|------|
68
- | 合併 | 在主目錄中執行 `git merge feature/name` |
69
- | 丟棄 | 執行清理流程 |
82
+ ### 階段 4:Merge(合併)
70
83
 
71
- ### 階段 4:清理
84
+ 1. 在 worktree 中**確認所有測試通過**
85
+ 2. **合併回主線** — 使用 `--no-ff` 保留分支歷史
86
+ 3. 若發生衝突,**處理衝突**
72
87
 
73
88
  ```bash
74
- # 移除 worktree
75
- git worktree remove ../project-feature-name
89
+ git checkout main
90
+ git merge --no-ff feature/auth
91
+ ```
76
92
 
77
- # 列出所有 worktree
78
- git worktree list
93
+ ### 階段 5:Cleanup(清理)
79
94
 
80
- # 清理過時的 worktree 參考
95
+ 1. **移除 worktree** — `git worktree remove <path>`
96
+ 2. **刪除分支** — `git branch -d <branch-name>`
97
+ 3. **清除過時的 worktree** — `git worktree prune`
98
+
99
+ ```bash
100
+ git worktree remove .worktrees/feature-auth
101
+ git branch -d feature/auth
81
102
  git worktree prune
82
103
  ```
83
104
 
84
- ## 命名慣例
105
+ **重要**:清理必須在異常退出時也執行,使用 try/finally 模式或清理 hook。
85
106
 
86
- | 元素 | 格式 | 範例 |
87
- |------|------|------|
88
- | Worktree 目錄 | `../project-feature-name` | `../myapp-login-fix` |
89
- | 分支名稱 | `feature/name` 或 `fix/name` | `feature/user-auth` |
107
+ ---
108
+
109
+ ## 規則
110
+
111
+ | ID | 觸發條件 | 動作 | 優先級 |
112
+ |----|---------|--------|----------|
113
+ | GW-001 | Worktree 目錄不在 `.gitignore` 中 | 自動加入 `.gitignore` | Critical |
114
+ | GW-002 | 基準測試失敗 | 對暫時性失敗最多重試 2 次(指數退避);若持續失敗,中止任務並報告環境問題 | High |
115
+ | GW-003 | Worktree 操作期間異常退出 | 確保執行清理 | High |
116
+ | GW-004 | 分支合併/刪除後 worktree 仍存在 | 清除過時的 worktree 參照 | Medium |
117
+
118
+ ---
90
119
 
91
120
  ## 最佳實踐
92
121
 
93
- | 實踐 | 原因 |
94
- |------|------|
95
- | 建立後立即執行基準測試 | 確認環境乾淨 |
96
- | 完成後立即清理 | 避免 worktree 累積 |
97
- | 不要在 worktree 之間共享未提交的變更 | 防止衝突 |
98
- | 定期執行 `git worktree prune` | 清理過時參考 |
122
+ | 實踐 | 理由 |
123
+ |----------|-----------|
124
+ | 使用一致的 worktree 目錄(例如 `.worktrees/`) | 易於加入 `.gitignore` 與定位 |
125
+ | 一律執行基準測試 | 避免環境問題造成的假性失敗 |
126
+ | 合併時使用 `--no-ff` | 在歷史中保留分支拓樸 |
127
+ | 合併後立即清理 | 避免過時 worktree 累積 |
128
+
129
+ ---
99
130
 
100
- ## 相關標準
131
+ ## 參考資料
101
132
 
102
- - [分支完成工作流程](branch-completion.md)
103
- - [代理派遣與並行協調](agent-dispatch.md)
104
- - [Git 工作流](git-workflow.md)
133
+ - **Superpowers**:[using-git-worktrees](https://github.com/obra/superpowers) (MIT)
134
+ - **Git 文件**:[git-worktree](https://git-scm.com/docs/git-worktree)