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
@@ -1,20 +1,21 @@
1
1
  ---
2
2
  source: ../../../core/frontend-design-standards.md
3
- source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-04-20
6
- status: stale
3
+ source_version: 1.1.0
4
+ translation_version: 1.1.0
5
+ last_synced: 2026-10-11
6
+ source_hash: c9dc85d8ce95
7
+ status: current
7
8
  ---
8
9
 
9
10
  # 前端設計標準
10
11
 
11
12
  > **語言**: [English](../../../core/frontend-design-standards.md) | 繁體中文
12
13
 
13
- **版本**: 1.0.0
14
- **最後更新**: 2026-04-13
15
- **狀態**: Active
14
+ **版本**: 1.1.0
15
+ **最後更新**: 2026-07-10
16
16
  **適用範圍**: 所有具備前端使用者介面的專案
17
- **參考**: DEC-029(awesome-design-md, MIT)、DEC-030(OpenAI Frontend Guide)
17
+ **範圍**: 通用 (Universal)
18
+ **參考**: [DEC-029](https://github.com/VoltAgent/awesome-design-md)(awesome-design-md, MIT)、DEC-030(OpenAI Frontend Guide)
18
19
 
19
20
  ---
20
21
 
@@ -32,6 +33,29 @@ status: stale
32
33
 
33
34
  ---
34
35
 
36
+ ## 目錄
37
+
38
+ 1. [DESIGN.md 結構](#designmd-結構)
39
+ 2. [第 1 段:視覺主題與氛圍](#第-1-段視覺主題與氛圍)
40
+ 3. [第 2 段:色彩系統](#第-2-段色彩系統)
41
+ 4. [第 3 段:字型系統](#第-3-段字型系統)
42
+ 5. [第 4 段:元件樣式](#第-4-段元件樣式)
43
+ 6. [第 5 段:版面與間距](#第-5-段版面與間距)
44
+ 7. [第 6 段:層次感與陰影系統](#第-6-段層次感與陰影系統)
45
+ 8. [第 7 段:設計準則與反模式](#第-7-段設計準則與反模式)
46
+ 9. [第 8 段:響應式行為](#第-8-段響應式行為)
47
+ 10. [第 9 段:Agent 提示參考](#第-9-段agent-提示參考)
48
+ 11. [語意色彩 Token](#語意色彩-token)
49
+ 12. [字型角色](#字型角色)
50
+ 13. [間距尺度](#間距尺度)
51
+ 14. [UI 硬性約束](#ui-硬性約束)
52
+ 15. [反模式](#反模式)
53
+ 16. [選用擴充:Token 插值與結構化元件](#選用擴充token-插值與結構化元件)
54
+ 17. [DESIGN.md 檔案位置](#designmd-檔案位置)
55
+ 18. [驗證清單](#驗證清單)
56
+
57
+ ---
58
+
35
59
  ## DESIGN.md 結構
36
60
 
37
61
  DESIGN.md 是放在專案根目錄的 Markdown 檔案,作為機器可讀的設計規格書。使用結構化 Markdown,人類與 AI Agent 皆可讀取。
@@ -403,6 +427,88 @@ DESIGN.md = 給 AI 讀的設計規格書
403
427
 
404
428
  ---
405
429
 
430
+ ## 選用擴充:Token 插值與結構化元件
431
+
432
+ > **狀態**:選用,試行中(v1.1.0 新增,2026-07-10)。**不會**取代上述強制的 9 段式結構,也不會取代經治理收斂後的 5 token/4 角色/7 步驟尺度——這是一層附加的、機器可解析的結構,供希望 DESIGN.md 本身就承載結構化 token 參照(而不只是敘述文字)的專案使用。省略此擴充的 DESIGN.md 仍完全合規。
433
+ >
434
+ > **緣起**:2026-07-10 針對 [DEC-029](https://github.com/VoltAgent/awesome-design-md) 上游(已從 4,385★ 成長到 99,219★,現已正式成為 Google Stitch 的 DESIGN.md 格式)的重新對齊審查發現:上游格式已演進出 YAML frontmatter 的 token 字典與 `{category.token}` 插值語法,外加結構化的 `components:` 綁定區塊——這些都是本標準原本只有敘述文字的段落所不具備的能力。本標準以選用擴充而非破壞性變更的方式採納,與本標準刻意採取的 5 token 治理收斂一致(目標**不是**增加 token,而是讓這 5 個 token *可被參照*)。
435
+
436
+ ### Token 註冊表(YAML Frontmatter)
437
+
438
+ DESIGN.md 可選擇以一個 YAML frontmatter 區塊開頭,以機器可解析的鍵值形式宣告第 2/3/5 段的語意 token(以及第 4 段的圓角尺度),讓工具無須重新解析敘述文字就能解析 `{category.token}` 參照。
439
+
440
+ ```yaml
441
+ ---
442
+ colors:
443
+ background: "#0A0A0A"
444
+ surface: "#1A1A1A"
445
+ primary-text: "#F5F5F5"
446
+ muted-text: "#888888"
447
+ accent: "#6366F1"
448
+ typography:
449
+ display: { size: "48px", weight: 700, line-height: 1.1 }
450
+ headline: { size: "24px", weight: 600, line-height: 1.3 }
451
+ body: { size: "16px", weight: 400, line-height: 1.6 }
452
+ caption: { size: "13px", weight: 400, line-height: 1.4 }
453
+ rounded:
454
+ sm: "4px"
455
+ md: "8px"
456
+ lg: "12px"
457
+ pill: "9999px"
458
+ spacing:
459
+ sm: "8px"
460
+ md: "24px"
461
+ lg: "48px"
462
+ ---
463
+ ```
464
+
465
+ **規則**:
466
+ - frontmatter 的鍵(`colors`、`typography`、`rounded`、`spacing`)與第 2/3/5 段已定義的 token 詞彙一對一對應——此區塊是以可解析形式**重述**那些 token,不會引入新的 token。`colors` 的值必須與 5 個強制語意 token 相符(外加任何已在使用中的選填延伸 token)。
467
+ - frontmatter 為選用。沒有它的 DESIGN.md 仍然有效;需要插值支援的工具則要求必須有它。
468
+
469
+ ### 插值語法
470
+
471
+ 在敘述段落中(特別是第 4 段:元件樣式),以 `{category.token}` 參照 frontmatter 註冊表,而不是重述原始值:
472
+
473
+ ```markdown
474
+ ### Buttons
475
+ - **Primary**: `{colors.accent}` background, `{colors.background}` text, `{rounded.md}` radius, `{spacing.sm}` padding
476
+ ```
477
+
478
+ **規則**:
479
+ - 語法為 `{category.token}`——category 對應 frontmatter 的頂層鍵,token 對應其下的鍵。
480
+ - 參照 frontmatter 中不存在的 category/token 屬於驗證錯誤,而不是靜默退回預設值。
481
+ - 插值是為了**文件/工具的清晰度**,不是執行期的樣板引擎——DESIGN.md 仍是靜態的規格檔。
482
+
483
+ ### 結構化元件區塊(選用)
484
+
485
+ 第 4 段(元件樣式)可選擇加入一個 `components:` 區塊,明確地把元件綁定到其 token 參照,以取代(或並列於)第 4 段範例中既有的敘述格式:
486
+
487
+ ```yaml
488
+ components:
489
+ button-primary:
490
+ backgroundColor: "{colors.accent}"
491
+ textColor: "{colors.background}"
492
+ rounded: "{rounded.md}"
493
+ padding: "{spacing.sm}"
494
+ card:
495
+ backgroundColor: "{colors.surface}"
496
+ rounded: "{rounded.lg}"
497
+ padding: "{spacing.md}"
498
+ ```
499
+
500
+ **規則**:
501
+ - 每個值都必須是 `{category.token}` 參照——在 `components:` 內使用原始 hex/px 值屬反模式(違背集中管理 token 的目的)。
502
+ - 此區塊是對第 4 段敘述描述的補充,而非取代——採用此擴充的專案仍應為人類讀者填寫第 4 段的敘述欄位。
503
+
504
+ ### 非目標(明確不從上游採納)
505
+
506
+ - **本標準不附帶 lint CLI**——上游生態系另有獨立的 `@google/design.md` npm 套件用於驗證;本標準不強制也不附帶特定的驗證器。專案可自行採用。
507
+ - **不提供框架特定的匯出格式**(React/Vue/CSS-in-JS 產生器)——依本標準的核心原則(語意化 token 命名、框架無關)維持框架無關。
508
+ - **不擴充 5/4/7 的 token 數量**——插值語法讓既有 token 可被參照,並不代表可以增加 token。治理收斂(token 越少 = AI 輸出越一致)的優先順序仍高於細緻度。
509
+
510
+ ---
511
+
406
512
  ## DESIGN.md 檔案位置
407
513
 
408
514
  DESIGN.md 必須放在**專案根目錄**,與 README.md 同層。
@@ -458,3 +564,9 @@ my-project/
458
564
  - [ ] 風格摘要存在(1–2 句)
459
565
  - [ ] 關鍵約束條列清單存在
460
566
  - [ ] 氛圍(tone)已定義
567
+
568
+ ### Token 插值擴充(選用——v1.1.0)
569
+ - [ ] 若使用 frontmatter token 註冊表,所有 `colors` 鍵皆與 5 個強制語意 token 相符
570
+ - [ ] 若使用 `{category.token}` 插值,每個參照都能解析到 frontmatter 條目(無懸空參照)
571
+ - [ ] 若使用 `components:` 區塊,每個值都是 `{category.token}` 參照(無原始 hex/px 值)
572
+ - [ ] 未採用此擴充**不算**合規失敗——它是選用的
@@ -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