universal-dev-standards 6.14.0-beta.8 → 6.14.0

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 (712) hide show
  1. package/bin/uds.js +12 -1
  2. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  3. package/bundled/ai/standards/commit-message.ai.yaml +12 -2
  4. package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
  5. package/bundled/core/commit-message-guide.md +22 -19
  6. package/bundled/core/secret-management-standards.md +13 -1
  7. package/bundled/extensions/locales/zh-tw.md +19 -19
  8. package/bundled/hooks/validate-commit-msg.mjs +52 -9
  9. package/bundled/locales/zh-CN/CHANGELOG.md +2312 -1102
  10. package/bundled/locales/zh-CN/CLAUDE.md +987 -101
  11. package/bundled/locales/zh-CN/README.md +3 -3
  12. package/bundled/locales/zh-CN/SECURITY.md +3 -3
  13. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  14. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
  15. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  16. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
  17. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
  18. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
  19. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
  20. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  21. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  22. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  23. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  24. package/bundled/locales/zh-CN/core/accessibility-standards.md +871 -62
  25. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  26. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  27. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  28. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  29. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  30. package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +311 -72
  31. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  32. package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
  33. package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
  34. package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
  35. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  36. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  37. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  38. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  39. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  40. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  41. package/bundled/locales/zh-CN/core/changelog-standards.md +485 -63
  42. package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
  43. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  44. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  45. package/bundled/locales/zh-CN/core/code-review-checklist.md +37 -23
  46. package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
  47. package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
  48. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  49. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  50. package/bundled/locales/zh-CN/core/deprecation-standards.md +155 -40
  51. package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
  52. package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
  53. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  54. package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
  55. package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
  56. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  57. package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
  58. package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
  59. package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
  60. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  61. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  62. package/bundled/locales/zh-CN/core/feature-flag-standards.md +202 -57
  63. package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
  64. package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
  65. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  66. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  67. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  68. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  69. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  70. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  71. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  72. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  73. package/bundled/locales/zh-CN/core/mutation-testing.md +45 -6
  74. package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
  75. package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
  76. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  77. package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
  78. package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
  79. package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
  80. package/bundled/locales/zh-CN/core/project-structure.md +550 -170
  81. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  82. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  83. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  84. package/bundled/locales/zh-CN/core/retrospective-standards.md +215 -22
  85. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  86. package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
  87. package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
  88. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  89. package/bundled/locales/zh-CN/core/security-standards.md +169 -16
  90. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  91. package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
  92. package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
  93. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  94. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  95. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  96. package/bundled/locales/zh-CN/core/supply-chain-security-standards.md +159 -32
  97. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  98. package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
  99. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  100. package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
  101. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  102. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  103. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  104. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  105. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  106. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  107. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  108. package/bundled/locales/zh-CN/core/versioning.md +737 -73
  109. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  110. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  111. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  112. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +2 -1
  113. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  114. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
  115. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
  116. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  117. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
  118. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  119. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
  120. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  121. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  122. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +2 -0
  123. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  124. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  125. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  126. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  127. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  128. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  129. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  130. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  131. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  132. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  133. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  134. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  135. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  136. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  137. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  138. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  139. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  140. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  141. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  142. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  143. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  144. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  145. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  146. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  147. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  148. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  149. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  150. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  151. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  152. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  153. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  154. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  155. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  156. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  157. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  158. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  159. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  160. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  161. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  162. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  163. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  164. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  165. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  166. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  167. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  168. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  169. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  170. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  171. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  172. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  173. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  174. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  175. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  176. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  177. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  178. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  179. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  180. package/bundled/locales/zh-CN/skills/README.md +2 -1
  181. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  182. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  183. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  184. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  185. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  186. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  187. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  188. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  189. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  190. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  191. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  192. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  193. package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +217 -137
  194. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  195. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  196. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  197. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  198. package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +148 -132
  199. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  200. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  201. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  202. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  203. package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +122 -121
  204. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  205. package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
  206. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  207. package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
  208. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  209. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  210. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  211. package/bundled/locales/zh-CN/skills/code-review-assistant/guide.md +119 -45
  212. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  213. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  214. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  215. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  216. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  217. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  218. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  219. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  220. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  221. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  222. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  223. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  224. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  225. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  226. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  227. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  228. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  229. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  230. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  231. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  232. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  233. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  234. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  235. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  236. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  237. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  238. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  239. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  240. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  241. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  242. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  243. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  244. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  245. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  246. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  247. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  248. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  249. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  250. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  251. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  252. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  253. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  254. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  255. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  256. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  257. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  258. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  259. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  260. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  261. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +4 -4
  262. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  263. package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
  264. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  265. package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
  266. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  267. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  268. package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +4 -2
  269. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  270. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  271. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  272. package/bundled/locales/zh-CN/skills/docs-generator/guide.md +8 -7
  273. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  274. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  275. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  276. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  277. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  278. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  279. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  280. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  281. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  282. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  283. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  284. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  285. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  286. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  287. package/bundled/locales/zh-CN/skills/project-discovery/guide.md +158 -157
  288. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  289. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  290. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  291. package/bundled/locales/zh-CN/skills/refactoring-assistant/guide.md +172 -171
  292. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  293. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  294. package/bundled/locales/zh-CN/skills/release-standards/guide.md +51 -43
  295. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  296. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  297. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  298. package/bundled/locales/zh-CN/skills/requirement-assistant/guide.md +88 -79
  299. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  300. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  301. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  302. package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +2 -2
  303. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  304. package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
  305. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  306. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  307. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  308. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  309. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  310. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  311. package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +2 -2
  312. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  313. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  314. package/bundled/locales/zh-CN/skills/tdd-assistant/guide.md +217 -156
  315. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  316. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  317. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  318. package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +25 -12
  319. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  320. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  321. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  322. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  323. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  324. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  325. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  326. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  327. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  328. package/bundled/locales/zh-TW/CHANGELOG.md +2291 -1110
  329. package/bundled/locales/zh-TW/CLAUDE.md +962 -76
  330. package/bundled/locales/zh-TW/README.md +3 -3
  331. package/bundled/locales/zh-TW/SECURITY.md +3 -3
  332. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  333. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
  334. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  335. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
  336. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
  337. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
  338. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
  339. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  340. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  341. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  342. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  343. package/bundled/locales/zh-TW/core/accessibility-standards.md +895 -46
  344. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  345. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  346. package/bundled/locales/zh-TW/core/agent-dispatch.md +102 -33
  347. package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
  348. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  349. package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
  350. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  351. package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
  352. package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
  353. package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
  354. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  355. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  356. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  357. package/bundled/locales/zh-TW/core/branch-completion.md +130 -34
  358. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  359. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  360. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  361. package/bundled/locales/zh-TW/core/chaos-engineering-standards.md +138 -36
  362. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  363. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  364. package/bundled/locales/zh-TW/core/code-review-checklist.md +19 -7
  365. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  366. package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
  367. package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
  368. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  369. package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
  370. package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
  371. package/bundled/locales/zh-TW/core/developer-memory.md +102 -12
  372. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  373. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  374. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  375. package/bundled/locales/zh-TW/core/environment-standards.md +250 -72
  376. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  377. package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
  378. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  379. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  380. package/bundled/locales/zh-TW/core/feature-flag-standards.md +202 -57
  381. package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
  382. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  383. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  384. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  385. package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +234 -487
  386. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  387. package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
  388. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  389. package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
  390. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  391. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  392. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  393. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  394. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  395. package/bundled/locales/zh-TW/core/observability-standards.md +284 -40
  396. package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
  397. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  398. package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
  399. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  400. package/bundled/locales/zh-TW/core/project-context-memory.md +210 -31
  401. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  402. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  403. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  404. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  405. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  406. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  407. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  408. package/bundled/locales/zh-TW/core/runbook-standards.md +296 -23
  409. package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
  410. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  411. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  412. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  413. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  414. package/bundled/locales/zh-TW/core/slo-standards.md +301 -49
  415. package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
  416. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  417. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  418. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  419. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  420. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  421. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  422. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  423. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  424. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  425. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  426. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  427. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  428. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  429. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  430. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  431. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  432. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  433. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  434. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  435. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +2 -1
  436. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  437. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
  438. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  439. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
  440. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  441. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
  442. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  443. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
  444. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  445. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  446. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +2 -0
  447. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  448. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  449. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  450. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  451. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  452. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  453. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  454. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  455. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  456. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  457. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  458. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  459. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  460. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  461. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  462. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  463. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  464. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  465. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  466. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  467. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  468. package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +584 -475
  469. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  470. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  471. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  472. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  473. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  474. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  475. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  476. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  477. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  478. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  479. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  480. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  481. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  482. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  483. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  484. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  485. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  486. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  487. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  488. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  489. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  490. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  491. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  492. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  493. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  494. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  495. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  496. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  497. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  498. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  499. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  500. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  501. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  502. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  503. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  504. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  505. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  506. package/bundled/locales/zh-TW/skills/README.md +2 -1
  507. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  508. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  509. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  510. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  511. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  512. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  513. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  514. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  515. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  516. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  517. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  518. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  519. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  520. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  521. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  522. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  523. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  524. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  525. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  526. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  527. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  528. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  529. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  530. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  531. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  532. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  533. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  534. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  535. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  536. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  537. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  538. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  539. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  540. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  541. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  542. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  543. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  544. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  545. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  546. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  547. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  548. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  549. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  550. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  551. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  552. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  553. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  554. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  555. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  556. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  557. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  558. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  559. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  560. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  561. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  562. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  563. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  564. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  565. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  566. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  567. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  568. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  569. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  570. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  571. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  572. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  573. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  574. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  575. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  576. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  577. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  578. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  579. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  580. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  581. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  582. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  583. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  584. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  585. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  586. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  587. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  588. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  589. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  590. package/bundled/locales/zh-TW/skills/commit-standards/guide.md +137 -17
  591. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  592. package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
  593. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  594. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  595. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  596. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  597. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  598. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  599. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  600. package/bundled/locales/zh-TW/skills/docs-generator/guide.md +4 -3
  601. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  602. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  603. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  604. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  605. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  606. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  607. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  608. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  609. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  610. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  611. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  612. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  613. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  614. package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +85 -18
  615. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  616. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  617. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  618. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  619. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  620. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  621. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  622. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  623. package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +91 -45
  624. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  625. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  626. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  627. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  628. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  629. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  630. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  631. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  632. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  633. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  634. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  635. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  636. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  637. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  638. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  639. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  640. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  641. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  642. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  643. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  644. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  645. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  646. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  647. package/bundled/locales/zh-TW/skills/tdd-assistant/language-examples.md +693 -47
  648. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  649. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  650. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  651. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  652. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  653. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  654. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  655. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  656. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  657. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  658. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  659. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  660. package/bundled/skills/.claude-plugin/plugin.json +71 -0
  661. package/bundled/skills/commit-standards/SKILL.md +2 -2
  662. package/bundled/skills/commit-standards/guide.md +3 -2
  663. package/bundled/skills/commit-standards/language-options.md +19 -17
  664. package/package.json +2 -2
  665. package/src/commands/audit.js +28 -1
  666. package/src/commands/check.js +77 -7
  667. package/src/commands/compile.js +37 -4
  668. package/src/commands/config.js +49 -24
  669. package/src/commands/init.js +78 -30
  670. package/src/commands/open-work.js +6 -2
  671. package/src/commands/release-messages.js +228 -0
  672. package/src/commands/release.js +127 -68
  673. package/src/commands/run-intent.js +11 -0
  674. package/src/commands/spec-split.js +2 -1
  675. package/src/commands/spec.js +11 -2
  676. package/src/commands/update.js +184 -30
  677. package/src/compilers/claude-code-compiler.js +9 -1
  678. package/src/config/ai-agent-paths.js +14 -1
  679. package/src/core/installed-formats.js +15 -0
  680. package/src/core/open-work-config.js +20 -1
  681. package/src/core/project-config.js +55 -0
  682. package/src/i18n/messages.js +160 -2
  683. package/src/installers/hooks-installer.js +1 -1
  684. package/src/installers/manifest-installer.js +1 -1
  685. package/src/installers/skills-installer.js +1 -1
  686. package/src/installers/standards-installer.js +3 -1
  687. package/src/mcp/server.js +9 -3
  688. package/src/prompts/init.js +26 -22
  689. package/src/reconciler/actual-state-scanner.js +2 -8
  690. package/src/reconciler/backup-locations.js +5 -0
  691. package/src/reconciler/backup-manager.js +19 -11
  692. package/src/reconciler/desired-state-calculator.js +89 -57
  693. package/src/reconciler/plan-executor.js +101 -8
  694. package/src/reconciler/recorded-versions.js +49 -0
  695. package/src/reconciler/relative-path.js +23 -0
  696. package/src/uninstallers/hook-uninstaller.js +9 -1
  697. package/src/uninstallers/skills-uninstaller.js +22 -3
  698. package/src/utils/available-standards-report.js +25 -4
  699. package/src/utils/available-standards.js +13 -3
  700. package/src/utils/build-manifest.js +1 -1
  701. package/src/utils/commit-message-judge.js +60 -13
  702. package/src/utils/friction-detector.js +23 -11
  703. package/src/utils/git-hooks.js +106 -4
  704. package/src/utils/integration-generator.js +95 -67
  705. package/src/utils/legacy-hook-migration.js +121 -2
  706. package/src/utils/open-work-tracking.mjs +105 -16
  707. package/src/utils/sdd-header.js +16 -4
  708. package/src/utils/skills-installer.js +2 -1
  709. package/src/utils/spinner.js +14 -4
  710. package/src/utils/standard-validator.js +3 -2
  711. package/standards-registry.json +10 -8
  712. package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
@@ -1,30 +1,44 @@
1
1
  ---
2
- source: ../../core/git-workflow.md
3
- source_version: 1.3.0
4
- translation_version: 1.3.0
5
- last_synced: 2026-01-24
2
+ source: ../../../../core/guides/git-workflow-guide.md
3
+ source_version: 1.0.0
4
+ translation_version: 1.0.0
5
+ last_synced: 2026-10-16
6
+ source_hash: f27182c48509
6
7
  status: current
7
8
  ---
8
9
 
9
- # Git 工作流程標準
10
+ # Git 工作流程指南
10
11
 
11
- > **語言**: [English](../../../../core/git-workflow.md) | 繁體中文
12
+ > **語言**: [English](../../../../core/guides/git-workflow-guide.md) | 繁體中文
12
13
 
13
- **版本**: 1.3.0
14
- **最後更新**: 2026-01-24
15
- **適用範圍**: 所有使用 Git 版本控制的專案
14
+ **版本**: 1.0.0
15
+ **最後更新**: 2026-01-29
16
+ **相關標準**: [Git 工作流程標準](../git-workflow.md)
16
17
 
17
18
  ---
18
19
 
19
20
  ## 目的
20
21
 
21
- 本標準定義 Git 分支策略與工作流程,確保團隊與專案間的一致、可預測的協作模式。
22
+ 本指南提供 Git 工作流程策略的詳細說明、教學與範例。有關可執行的規則與檢查清單,請參閱 [Git 工作流程標準](../git-workflow.md)。
22
23
 
23
24
  ---
24
25
 
25
- ## 工作流程策略選擇
26
+ ## 目錄
26
27
 
27
- **專案必須選擇一種**工作流程策略並明確記錄。
28
+ 1. [工作流程選擇指南](#workflow-selection-guide)
29
+ 2. [GitFlow 詳細教學](#gitflow-detailed-tutorial)
30
+ 3. [GitHub Flow 詳細教學](#github-flow-detailed-tutorial)
31
+ 4. [Trunk-Based Development 教學](#trunk-based-development-tutorial)
32
+ 5. [功能開關實作](#feature-flags-implementation)
33
+ 6. [Ship/Show/Ask 決策模型](#shipshowask-decision-model)
34
+ 7. [堆疊式 PR 工作流程](#stacked-prs-workflow)
35
+ 8. [傳統式 PR 標題指南](#conventional-pr-titles-guide)
36
+ 9. [Git 指令參考](#git-commands-reference)
37
+ 10. [疑難排解指南](#troubleshooting-guide)
38
+
39
+ ---
40
+
41
+ ## 工作流程選擇指南
28
42
 
29
43
  ### 決策樹
30
44
 
@@ -34,7 +48,6 @@ status: current
34
48
  ┌─────────────────────────────────────┐
35
49
  │ How often do you deploy to │
36
50
  │ production? │
37
- │ 您多常部署到正式環境? │
38
51
  └───────────────┬─────────────────────┘
39
52
  │
40
53
  ┌───────────────────────┼───────────────────────┐
@@ -42,7 +55,6 @@ status: current
42
55
  ┌────────────────┐ ┌────────────────┐ ┌────────────────┐
43
56
  │ Multiple times │ │ Weekly to │ │ Monthly or │
44
57
  │ per day │ │ bi-weekly │ │ longer │
45
- │ 每天多次 │ │ 每週或雙週 │ │ 每月或更久 │
46
58
  └───────┬────────┘ └───────┬────────┘ └───────┬────────┘
47
59
  │ │ │
48
60
  ▼ ▼ ▼
@@ -97,11 +109,11 @@ status: current
97
109
 
98
110
  1. **記錄在專案 README** 或 CONTRIBUTING.md 中:
99
111
  ```markdown
100
- ## Git 工作流程
101
- 本專案使用 **GitHub Flow**。
102
- - 決定日期:2025-01-15
103
- - 決定者:@techlead
104
- - 理由:每週部署,單一正式版本
112
+ ## Git Workflow
113
+ This project uses **GitHub Flow**.
114
+ - Decision date: 2025-01-15
115
+ - Decision maker: @techlead
116
+ - Rationale: Weekly deployments, single production version
105
117
  ```
106
118
 
107
119
  2. **設定分支保護**規則以強制執行所選的工作流程。
@@ -112,10 +124,13 @@ status: current
112
124
 
113
125
  ---
114
126
 
115
- ## 策略 A: GitFlow
127
+ ## GitFlow 詳細教學
116
128
 
117
129
  **最適合**:
118
- 定期發布(每月、每季)、同時維護多個正式版本、開發與正式環境明確分離、大型團隊與正式發布流程
130
+ - 定期發布(每月、每季)
131
+ - 同時維護多個正式版本
132
+ - 開發與正式環境明確分離
133
+ - 擁有正式發布流程的大型團隊
119
134
 
120
135
  ### 分支結構
121
136
 
@@ -131,16 +146,6 @@ release/* ●───● (Release preparation)
131
146
  hotfix/* ────● (Emergency fixes)
132
147
  ```
133
148
 
134
- ### 分支類型
135
-
136
- | 分支類型 | 目的 | 基礎分支 | 合併目標 | 生命週期 |
137
- |---------|------|---------|----------|---------|
138
- | `main` | 正式環境程式碼 | - | - | 永久 |
139
- | `develop` | 整合分支 | - | - | 永久 |
140
- | `feature/*` | 新功能 | `develop` | `develop` | 暫時 |
141
- | `release/*` | 發布準備 | `develop` | `main` + `develop` | 暫時 |
142
- | `hotfix/*` | 緊急修復 | `main` | `main` + `develop` | 暫時 |
143
-
144
149
  ### 工作流程步驟
145
150
 
146
151
  #### 1. 功能開發
@@ -171,7 +176,7 @@ git push origin --delete feature/oauth-login
171
176
 
172
177
  #### 2. 發布準備
173
178
 
174
- > **變更日誌更新**:將 `[Unreleased]` 的條目移至新版本區段並加上發布日期。詳細指南請參閱 [changelog-standards.md](../../../../core/changelog-standards.md)。
179
+ > **CHANGELOG 更新**:將條目從 `[Unreleased]` 移至新版本區段並加上發布日期。詳細指南請參閱 [changelog-standards.md](../changelog-standards.md)。
175
180
 
176
181
  ```bash
177
182
  # Create release branch from develop
@@ -232,10 +237,13 @@ git push origin --delete hotfix/critical-security-fix
232
237
 
233
238
  ---
234
239
 
235
- ## 策略 B: GitHub Flow
240
+ ## GitHub Flow 詳細教學
236
241
 
237
242
  **最適合**:
238
- 持續部署、Web 應用程式、中小型團隊、快速迭代週期
243
+ - 持續部署
244
+ - Web 應用程式
245
+ - 中小型團隊
246
+ - 快速迭代週期
239
247
 
240
248
  ### 分支結構
241
249
 
@@ -247,15 +255,6 @@ feature/* ●───●───● ╱ (Feature + PR)
247
255
  bugfix/* ────● (Bug fixes)
248
256
  ```
249
257
 
250
- ### 分支類型
251
-
252
- | 分支類型 | 目的 | 基礎分支 | 合併目標 | 生命週期 |
253
- |---------|------|---------|----------|---------|
254
- | `main` | 正式環境程式碼 | - | - | 永久 |
255
- | `feature/*` | 新功能 | `main` | `main` | 暫時 |
256
- | `bugfix/*` | Bug 修復 | `main` | `main` | 暫時 |
257
- | `hotfix/*` | 緊急修復 | `main` | `main` | 暫時 |
258
-
259
258
  ### 工作流程步驟
260
259
 
261
260
  ```bash
@@ -292,10 +291,13 @@ git pull origin main
292
291
 
293
292
  ---
294
293
 
295
- ## 策略 C: Trunk-Based Development
294
+ ## Trunk-Based Development 教學
296
295
 
297
296
  **最適合**:
298
- 成熟的 CI/CD 管道、高信任度且經驗豐富的團隊、頻繁整合(每天多次)、使用功能開關控制未完成功能
297
+ - 成熟的 CI/CD 管線
298
+ - 高信任度且經驗豐富的團隊
299
+ - 頻繁整合(每天多次)
300
+ - 使用功能開關控制未完成功能
299
301
 
300
302
  ### 分支結構
301
303
 
@@ -305,13 +307,6 @@ main ────●─●─●─●─●─●─●──► (Single long-
305
307
  feature/* ● ● ● (Very short-lived, ≤2 days)
306
308
  ```
307
309
 
308
- ### 分支類型
309
-
310
- | 分支類型 | 目的 | 基礎分支 | 合併目標 | 生命週期 |
311
- |---------|------|---------|----------|---------|
312
- | `main` | 主幹 | - | - | 永久 |
313
- | `feature/*` | 小型變更 | `main` | `main` | ≤2 天 |
314
-
315
310
  ### 工作流程步驟
316
311
 
317
312
  ```bash
@@ -350,7 +345,7 @@ git push origin --delete feature/add-validation
350
345
 
351
346
  ---
352
347
 
353
- ## Trunk-Based Development 與功能開關
348
+ ## 功能開關實作
354
349
 
355
350
  ### 為何功能開關不可或缺
356
351
 
@@ -358,20 +353,61 @@ git push origin --delete feature/add-validation
358
353
 
359
354
  ```
360
355
  ┌─────────────────────────────────────────────────────────────────┐
361
- │ 程式碼生命週期 │
356
+ │ Code Lifecycle │
362
357
  ├─────────────────────────────────────────────────────────────────┤
363
- │ 合併到 main 部署到正式環境 對使用者啟用 │
364
- │ │ │ │ │
365
- │ ▼ ▼ ▼ │
358
+ │ │
359
+ │ Merge to main Deploy to Prod Enable for Users │
360
+ │ │ │ │ │
361
+ │ ▼ ▼ ▼ │
366
362
  │ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
367
- │ │ 提交 │─────►│ 部署 │───────►│ 發布 │ │
368
- │ │ (程式碼) │ │ (二進位) │ │ (使用者) │ │
363
+ │ │ Commit │─────►│ Deploy │───────►│ Release │ │
364
+ │ │ (Code) │ │ (Binary)│ │ (Users) │ │
369
365
  │ └─────────┘ └─────────┘ └─────────┘ │
370
- │ └────── 功能開關 ──────┘ │
371
- │ (解耦) │
366
+ │ │ │ │
367
+ │ │ Feature Flag │ │
368
+ │ └───────────────────┘ │
369
+ │ (Decoupled) │
372
370
  └─────────────────────────────────────────────────────────────────┘
373
371
  ```
374
372
 
373
+ ### 實作模式
374
+
375
+ **基本切換**:
376
+
377
+ ```javascript
378
+ // Simple on/off flag
379
+ if (featureFlags.isEnabled('new-checkout-flow')) {
380
+ return newCheckoutFlow(cart);
381
+ } else {
382
+ return legacyCheckoutFlow(cart);
383
+ }
384
+ ```
385
+
386
+ **逐步推出**:
387
+
388
+ ```javascript
389
+ // Percentage-based rollout
390
+ const flag = featureFlags.get('new-checkout-flow');
391
+ if (flag.isEnabledForPercentage(user.id, 10)) {
392
+ // 10% of users see new flow
393
+ return newCheckoutFlow(cart);
394
+ }
395
+ ```
396
+
397
+ **使用者分群鎖定**:
398
+
399
+ ```javascript
400
+ // Target specific user segments
401
+ if (featureFlags.isEnabledFor('new-checkout-flow', {
402
+ userId: user.id,
403
+ plan: user.plan, // e.g., 'enterprise'
404
+ region: user.region, // e.g., 'asia-pacific'
405
+ betaTester: user.isBetaTester
406
+ })) {
407
+ return newCheckoutFlow(cart);
408
+ }
409
+ ```
410
+
375
411
  ### 功能開關生命週期
376
412
 
377
413
  | 階段 | 開關狀態 | 動作 |
@@ -383,6 +419,25 @@ git push origin --delete feature/add-validation
383
419
  | 完整發布 | 對所有人開啟 | 預設行為 |
384
420
  | 清理 | 移除開關 | 技術債清理 |
385
421
 
422
+ ### 開關衛生最佳實踐
423
+
424
+ 1. **具描述性地命名開關**:`enable-new-checkout-v2` 而非 `flag-123`
425
+ 2. **設定到期日**:審查並移除陳舊開關
426
+ 3. **限制使用中開關數量**:過多開關 = 複雜度
427
+ 4. **記錄開關用途**:內容、原因以及何時移除
428
+
429
+ ```javascript
430
+ // Flag metadata example
431
+ {
432
+ "name": "enable-new-checkout-v2",
433
+ "description": "New checkout flow with improved UX",
434
+ "owner": "checkout-team",
435
+ "createdAt": "2026-01-15",
436
+ "targetRemovalDate": "2026-03-15",
437
+ "status": "gradual-rollout"
438
+ }
439
+ ```
440
+
386
441
  ---
387
442
 
388
443
  ## Ship/Show/Ask 決策模型
@@ -391,25 +446,131 @@ git push origin --delete feature/add-validation
391
446
 
392
447
  並非所有變更都需要相同的審查流程。Ship/Show/Ask 模型幫助團隊決定:
393
448
 
394
- | 模式 | 說明 | 適用時機 |
395
- |------|------|---------|
396
- | **SHIP** | 直接推送到 main | 低風險、高信心 |
397
- | **SHOW** | 合併後通知團隊 | 中等風險、需要知會 |
398
- | **ASK** | 開 PR,等待審批 | 高風險、需要討論 |
449
+ ```
450
+ ┌─────────────────────────────────────────────────────────────────┐
451
+ │ Ship / Show / Ask │
452
+ ├─────────────────────────────────────────────────────────────────┤
453
+ │ │
454
+ │ SHIP SHOW ASK │
455
+ │ ──── ──── ─── │
456
+ │ Push directly Merge, then Open PR, wait │
457
+ │ to main notify team for approval │
458
+ │ │
459
+ │ Low risk Medium risk High risk │
460
+ │ High confidence Need awareness Need discussion │
461
+ │ │
462
+ └─────────────────────────────────────────────────────────────────┘
463
+ ```
399
464
 
400
465
  ### 何時 Ship(直接推送)
401
466
 
467
+ **準則**:
468
+ - 小型、低風險變更
469
+ - 對正確性具有高度信心
470
+ - 若出錯容易還原
471
+ - 健全的測試覆蓋率
472
+
473
+ **範例**:
402
474
  - 文件中的錯字修正
403
475
  - 新增除錯日誌
404
476
  - 更新依賴(CI 通過時)
477
+ - 設定變更(非破壞性)
405
478
  - 明顯的 bug 修復(有測試)
406
479
 
480
+ ```bash
481
+ # Ship: Direct push to main
482
+ git checkout main
483
+ git pull origin main
484
+ # Make small change
485
+ git add .
486
+ git commit -m "fix: correct typo in error message"
487
+ git push origin main
488
+ ```
489
+
490
+ ### 何時 Show(合併後通知)
491
+
492
+ **準則**:
493
+ - 團隊應該知悉
494
+ - 程式碼審查是可有可無(錦上添花),不具阻塞性
495
+ - 變更單純直接
496
+ - 希望獲得回饋但非阻塞式核准
497
+
498
+ **範例**:
499
+ - 改善程式碼品質的重構
500
+ - 為既有功能新增測試
501
+ - 非關鍵的功能增強
502
+ - 更新內部文件
503
+
504
+ ```bash
505
+ # Show: Merge and notify
506
+ git checkout -b refactor/extract-validation
507
+ # Make changes
508
+ git add .
509
+ git commit -m "refactor: extract validation logic"
510
+ git push origin refactor/extract-validation
511
+
512
+ # Create PR and immediately merge (no blocking review)
513
+ gh pr create --title "refactor: extract validation logic" --body "FYI: Extracting validation for reuse"
514
+ gh pr merge --auto --squash
515
+
516
+ # Notify team in Slack/Teams
517
+ ```
518
+
407
519
  ### 何時 Ask(PR 加阻塞審查)
408
520
 
521
+ **準則**:
409
522
  - 架構決策
410
523
  - 重大變更
411
524
  - 安全敏感程式碼
525
+ - 新模式或慣例
526
+ - 您不確定的變更
527
+
528
+ **範例**:
529
+ - 新 API 端點
530
+ - 資料庫 schema 變更
531
+ - 身分驗證/授權變更
412
532
  - 共用函式庫的變更
533
+ - 效能關鍵程式碼
534
+
535
+ ```bash
536
+ # Ask: Full PR process
537
+ git checkout -b feature/new-auth-flow
538
+ # Make changes
539
+ git push origin feature/new-auth-flow
540
+
541
+ # Create PR and request review
542
+ gh pr create --title "feat(auth): implement OAuth2 PKCE flow" \
543
+ --body "## What\nNew authentication flow\n\n## Why\nImproved security" \
544
+ --reviewer security-team,backend-team
545
+ ```
546
+
547
+ ### 決策流程圖
548
+
549
+ ```
550
+ ┌────────────────────────────────────────┐
551
+ │ Is this change risky or complex? │
552
+ └────────────────────┬───────────────────┘
553
+ │
554
+ ┌───────────┴───────────┐
555
+ ▼ ▼
556
+ YES NO
557
+ │ │
558
+ ▼ ▼
559
+ ┌─────────────────┐ ┌────────────────────────┐
560
+ │ Does it need │ │ Should team be aware? │
561
+ │ discussion? │ └───────────┬────────────┘
562
+ └────────┬────────┘ │
563
+ │ ┌────────┴────────┐
564
+ ┌────┴────┐ ▼ ▼
565
+ ▼ ▼ YES NO
566
+ YES NO │ │
567
+ │ │ ▼ ▼
568
+ ▼ ▼ ┌──────────┐ ┌──────────┐
569
+ ┌───────┐ ┌───────┐ │ SHOW │ │ SHIP │
570
+ │ ASK │ │ ASK │ │ (notify) │ │ (direct) │
571
+ │(review)│ │(review)│ └──────────┘ └──────────┘
572
+ └───────┘ └───────┘
573
+ ```
413
574
 
414
575
  ---
415
576
 
@@ -420,402 +581,209 @@ git push origin --delete feature/add-validation
420
581
  堆疊式 PR 將大型功能拆分為可漸進審查的較小、相依的 pull request:
421
582
 
422
583
  ```
423
- main ────●─────────────────────────────────────────►
424
- ╲
425
- PR #1 (資料庫 schema) ────●
426
- ╲
427
- PR #2 (API) ────●
428
- ╲
429
- PR #3 (UI) ●
584
+ ┌─────────────────────────────────────────────────────────────────┐
585
+ │ Stacked PRs Structure │
586
+ ├─────────────────────────────────────────────────────────────────┤
587
+ │ │
588
+ │ main ────●─────────────────────────────────────────► │
589
+ │ ╲ │
590
+ │ PR #1 (Database schema) ────● │
591
+ │ ╲ │
592
+ │ PR #2 (API) ────● │
593
+ │ ╲ │
594
+ │ PR #3 (UI) ●│
595
+ │ │
596
+ │ Review: PR #1 first, then #2, then #3 │
597
+ │ Merge: PR #1 → PR #2 → PR #3 │
598
+ └─────────────────────────────────────────────────────────────────┘
430
599
  ```
431
600
 
432
601
  ### 何時使用堆疊式 PR
433
602
 
434
603
  | 情境 | 推薦使用堆疊式 PR |
435
604
  |------|-----------------|
436
- | 功能 > 500 行 | ✅ 是 |
437
- | 多個邏輯元件 | ✅ 是 |
438
- | 需要早期回饋 | ✅ 是 |
439
- | 簡單 bug 修復 | ❌ 否,使用單一 PR |
440
-
441
- ---
442
-
443
- ## 傳統式 PR 標題
444
-
445
- ### 格式
446
-
447
- PR 標題應遵循與 commit 訊息相同的格式:
448
-
449
- ```
450
- <type>(<scope>): <subject>
451
- ```
452
-
453
- ### 類型參考
605
+ | 功能 > 500 行 | 是 |
606
+ | 多個邏輯元件 | 是 |
607
+ | 需要早期回饋 | 是 |
608
+ | 簡單 bug 修復 | 否,使用單一 PR |
609
+ | 獨立變更 | 否,使用平行 PR |
454
610
 
455
- | 類型 | 用途 | 範例 |
456
- |------|------|------|
457
- | `feat` | 新功能 | `feat(auth): 新增 OAuth2 登入` |
458
- | `fix` | Bug 修復 | `fix(api): 處理空值回應` |
459
- | `docs` | 文件 | `docs(readme): 更新安裝步驟` |
460
- | `refactor` | 重構 | `refactor(utils): 抽取驗證邏輯` |
461
- | `test` | 新增測試 | `test(auth): 新增登入單元測試` |
462
- | `chore` | 維護 | `chore(deps): 更新 lodash 到 4.17.21` |
611
+ ### 建立堆疊式 PR
463
612
 
464
- ### 重大變更
465
-
466
- 用 `!` 在類型後面表示重大變更:
613
+ **步驟 1:規劃堆疊**
467
614
 
468
615
  ```
469
- feat(api)!: 變更使用者端點的回應格式
616
+ Feature: User Authentication
617
+ ├── PR #1: Database schema for users table
618
+ ├── PR #2: User service and repository
619
+ ├── PR #3: REST API endpoints
620
+ └── PR #4: Frontend login form
470
621
  ```
471
622
 
472
- ---
473
-
474
- ## 開新分支前檢查清單
475
-
476
- 開始新功能開發前,完成以下檢查以避免常見問題。
477
-
478
- ### 適用於 GitFlow 和 GitHub Flow
479
-
480
- #### 1. 確認無未合併分支
623
+ **步驟 2:建立基礎分支**
481
624
 
482
625
  ```bash
483
- git branch --no-merged main
484
- # For GitFlow, also check:
485
- git branch --no-merged develop
486
- ```
487
-
488
- - **如有未合併分支,必須先處理**(合併或關閉)
489
- - **禁止在有未合併分支的情況下開新功能分支**
490
-
491
- #### 2. 同步最新程式碼
492
-
493
- ```bash
494
- git checkout main # or develop for GitFlow
626
+ # Start from main
627
+ git checkout main
495
628
  git pull origin main
496
- ```
497
-
498
- #### 3. 確認測試通過
499
629
 
500
- ```bash
501
- # Run your project's test suite
502
- npm test # Node.js
503
- pytest # Python
504
- ./gradlew test # Java/Kotlin
630
+ # Create first PR branch
631
+ git checkout -b feature/auth-1-schema
632
+ # Make database changes
633
+ git add .
634
+ git commit -m "feat(db): add users table schema"
635
+ git push origin feature/auth-1-schema
505
636
  ```
506
637
 
507
- #### 4. 建立分支
638
+ **步驟 3:堆疊下一個分支**
508
639
 
509
640
  ```bash
510
- git checkout -b feature/description
511
- ```
512
-
513
- ### 為什麼重要
514
-
515
- | 跳過檢查的後果 | 影響 |
516
- |--------------|------|
517
- | 修復散落各處 | `main` 仍有 bug |
518
- | 功能互相依賴 | 新分支缺少前一個功能的程式碼 |
519
- | 合併順序混亂 | 衝突變多、歷史難追蹤 |
520
- | 測試不完整 | 每個分支只測自己的部分 |
521
-
522
- ### 適用於 Trunk-Based Development
523
-
524
- Trunk-Based Development 因其短命分支特性(≤2 天)有**不同的要求**:
525
-
526
- | 檢查項目 | 適用性 | 說明 |
527
- |---------|-------|------|
528
- | 確認無未合併分支 | ⚠️ **較不適用** | 設計上分支不應存在超過 2 天 |
529
- | 同步最新程式碼 | ✅ **關鍵** | 因頻繁整合,更為重要 |
530
- | 確認測試通過 | ✅ **關鍵** | 自動化是此工作流程的核心 |
531
-
532
- **關鍵差異**:若在 Trunk-Based Development 中有超過 2 天的未合併分支,這本身就違反了工作流程原則。重點應放在**頻繁整合**而非檢查未合併分支。
533
-
534
- ---
535
-
536
- ## 分支命名慣例
537
-
538
- ### 標準格式
539
-
540
- ```
541
- <type>/<short-description>
542
- ```
543
-
544
- ### 類型
545
-
546
- | 類型 | 用途 | 範例 |
547
- |------|------|------|
548
- | `feature/` | 新功能 | `feature/oauth-login` |
549
- | `fix/` 或 `bugfix/` | Bug 修復 | `fix/memory-leak` |
550
- | `hotfix/` | 緊急正式環境修復 | `hotfix/security-patch` |
551
- | `refactor/` | 程式碼重構 | `refactor/extract-service` |
552
- | `docs/` | 僅文件更新 | `docs/api-reference` |
553
- | `test/` | 測試新增 | `test/integration-tests` |
554
- | `chore/` | 維護任務 | `chore/update-dependencies` |
555
- | `release/` | 發布準備 (僅 GitFlow) | `release/v1.2.0` |
556
-
557
- ### 命名規則
558
-
559
- 1. **使用小寫**
560
- 2. **使用連字號分隔單詞**
561
- 3. **具描述性但簡潔**
562
- 4. **避免僅用 issue 編號**
563
-
564
- **良好範例**:
565
- ```
566
- feature/user-authentication
567
- fix/null-pointer-in-payment
568
- hotfix/critical-data-loss
569
- refactor/database-connection-pool
570
- docs/update-installation-guide
571
- ```
572
-
573
- **不良範例**:
574
- ```
575
- feature/123 # ❌ 沒有描述性
576
- Fix-Bug # ❌ 非小寫,過於籠統
577
- feature/add_new_feature # ❌ 使用底線,過於籠統
578
- myFeature # ❌ 駝峰式命名,無類型前綴
641
+ # Branch from previous, NOT from main
642
+ git checkout -b feature/auth-2-service feature/auth-1-schema
643
+ # Make service changes
644
+ git add .
645
+ git commit -m "feat(auth): add user service"
646
+ git push origin feature/auth-2-service
579
647
  ```
580
648
 
581
- ---
582
-
583
- ## 合併策略
584
-
585
- **專案必須為每種分支類型選擇一種**。
586
-
587
- ### 選項 1: 合併提交 (--no-ff)
588
-
589
- **保留分支歷史**
649
+ **步驟 4:建立連結的 PR**
590
650
 
591
651
  ```bash
592
- git merge --no-ff feature/user-auth
593
- ```
594
-
595
- **優點**:
596
- - ✅ 完整保留歷史
597
- - ✅ 易於還原整個功能
598
- - ✅ 清楚的功能邊界
599
-
600
- **缺點**:
601
- - ❌ Git 日誌雜亂
602
- - ❌ 複雜的圖形視覺化
603
-
604
- **最適合**: GitFlow、長期功能分支
605
-
606
- ---
607
-
608
- ### 選項 2: 壓縮合併
652
+ # PR #1: Against main
653
+ gh pr create --base main --head feature/auth-1-schema \
654
+ --title "feat(db): add users table schema" \
655
+ --body "Part 1/4 of user authentication feature"
609
656
 
610
- **將所有提交合併為一個**
611
-
612
- ```bash
613
- git merge --squash feature/user-auth
614
- git commit -m "feat(auth): add user authentication"
657
+ # PR #2: Against PR #1's branch
658
+ gh pr create --base feature/auth-1-schema --head feature/auth-2-service \
659
+ --title "feat(auth): add user service" \
660
+ --body "Part 2/4 - depends on #1"
615
661
  ```
616
662
 
617
- **優點**:
618
- - ✅ 乾淨、線性的歷史
619
- - ✅ 每個功能一個提交
620
- - ✅ 易於閱讀的 git 日誌
621
-
622
- **缺點**:
623
- - ❌ 失去詳細歷史
624
- - ❌ 無法精選個別提交
625
-
626
- **最適合**: GitHub Flow、功能分支
663
+ ### 處理基礎 PR 的更新
627
664
 
628
- ---
629
-
630
- ### 選項 3: 變基與快轉
631
-
632
- **在目標分支上重播提交**
665
+ 當 PR #1 在 PR #2 建立後發生變更時:
633
666
 
634
667
  ```bash
635
- git rebase main feature/user-auth
636
- git checkout main
637
- git merge --ff-only feature/user-auth
668
+ # Rebase PR #2 on updated PR #1
669
+ git checkout feature/auth-2-service
670
+ git fetch origin
671
+ git rebase origin/feature/auth-1-schema
672
+ git push --force-with-lease origin feature/auth-2-service
638
673
  ```
639
674
 
640
- **優點**:
641
- - ✅ 線性、乾淨的歷史
642
- - ✅ 保留個別提交
643
- - ✅ 無合併提交
644
-
645
- **缺點**:
646
- - ❌ 改寫歷史(不要用於共享分支)
647
- - ❌ 解決衝突可能繁瑣
648
-
649
- **最適合**: Trunk-Based Development、短期分支
650
-
651
- ---
652
-
653
- ## 衝突解決
654
-
655
- ### 預防
656
-
657
- 1. **頻繁同步**
658
- ```bash
659
- git checkout main
660
- git pull origin main
661
- git checkout feature/my-feature
662
- git merge main # or git rebase main
663
- ```
664
-
665
- 2. **保持分支小型化**
666
- - 避免長期功能分支
667
- - 將大型功能拆分為小型 PR
668
-
669
- 3. **溝通**
670
- - 宣告重大重構
671
- - 協調共享檔案的修改
672
-
673
- ### 解決步驟
675
+ ### 合併堆疊式 PR
674
676
 
675
677
  ```bash
676
- # 1. Attempt merge
677
- git checkout main
678
- git pull origin main
679
- git checkout feature/my-feature
680
- git merge main
678
+ # Merge in order
679
+ # 1. Merge PR #1 to main (squash or merge commit)
680
+ gh pr merge 1 --squash
681
681
 
682
- # 2. Conflicts occur - Git marks them in files
683
- # Open files and resolve conflicts:
684
- # <<<<<<< HEAD
685
- # Current branch changes
686
- # =======
687
- # Incoming changes
688
- # >>>>>>> main
682
+ # 2. Update PR #2 base to main (GitHub auto-updates)
683
+ # 3. Merge PR #2 to main
684
+ gh pr merge 2 --squash
689
685
 
690
- # 3. After resolving, stage files
691
- git add resolved-file.js
686
+ # Continue for remaining PRs...
687
+ ```
692
688
 
693
- # 4. Complete the merge
694
- git commit -m "chore: resolve merge conflicts with main"
689
+ ### 堆疊式 PR 的工具
695
690
 
696
- # 5. Test thoroughly
697
- npm test
698
-
699
- # 6. Push
700
- git push origin feature/my-feature
701
- ```
691
+ | 工具 | 說明 |
692
+ |------|------|
693
+ | [Graphite](https://graphite.dev/) | 專為堆疊式 PR 打造 |
694
+ | [ghstack](https://github.com/ezyang/ghstack) | 用於堆疊 PR 的 CLI |
695
+ | [git-branchless](https://github.com/arxanas/git-branchless) | 進階 Git 工作流程 |
696
+ | 手動 | 使用 git rebase 和 gh CLI |
702
697
 
703
698
  ---
704
699
 
705
- ## 標籤與發布
700
+ ## 傳統式 PR 標題指南
706
701
 
707
- ### 語義化版本
702
+ ### 格式
708
703
 
709
- 遵循 [Semantic Versioning 2.0.0](https://semver.org/):
704
+ PR 標題應遵循與 commit 訊息相同的格式:
710
705
 
711
706
  ```
712
- MAJOR.MINOR.PATCH
713
-
714
- 例如: v2.3.1
707
+ <type>(<scope>): <subject>
715
708
  ```
716
709
 
717
- - **MAJOR**: 重大變更(不相容的 API 變更)
718
- - **MINOR**: 新功能(向後相容)
719
- - **PATCH**: Bug 修復(向後相容)
720
-
721
- ### 建立標籤
710
+ ### 類型參考
722
711
 
723
- ```bash
724
- # Annotated tag (recommended)
725
- git tag -a v1.2.0 -m "Release version 1.2.0: Add OAuth2 support"
712
+ | 類型 | 用途 | 範例 |
713
+ |------|------|------|
714
+ | `feat` | 新功能 | `feat(auth): add OAuth2 login` |
715
+ | `fix` | Bug 修復 | `fix(api): handle null response` |
716
+ | `docs` | 文件 | `docs(readme): update install steps` |
717
+ | `refactor` | 程式碼重構 | `refactor(utils): extract validation` |
718
+ | `test` | 新增測試 | `test(auth): add login unit tests` |
719
+ | `chore` | 維護 | `chore(deps): update lodash to 4.17.21` |
720
+ | `perf` | 效能 | `perf(query): optimize user lookup` |
721
+ | `style` | 程式碼風格 | `style(lint): fix eslint warnings` |
722
+ | `ci` | CI/CD 變更 | `ci(actions): add caching step` |
723
+ | `build` | 建置系統 | `build(webpack): upgrade to v5` |
726
724
 
727
- # Push tag to remote
728
- git push origin v1.2.0
725
+ ### 重大變更
729
726
 
730
- # Push all tags
731
- git push origin --tags
727
+ 在類型後加上 `!` 表示重大變更:
732
728
 
733
- # List tags
734
- git tag -l
729
+ ```
730
+ feat(api)!: change response format for users endpoint
735
731
  ```
736
732
 
737
- ### 預發布版本
733
+ ### PR 標題最佳實踐
738
734
 
735
+ **良好範例**:
739
736
  ```
740
- v1.2.0-alpha.1 # Alpha release
741
- v1.2.0-beta.2 # Beta release
742
- v1.2.0-rc.1 # Release candidate
737
+ feat(checkout): add Apple Pay support
738
+ fix(auth): prevent session fixation attack
739
+ refactor(orders): extract shipping calculator
740
+ docs(api): document rate limiting headers
741
+ chore(deps): update security patches
743
742
  ```
744
743
 
745
- ---
746
-
747
- ## 保護分支
748
-
749
- 設定分支保護規則:
750
-
751
- ### 建議的 `main`/`develop` 保護:
752
-
753
- - ✅ **需要 pull request 審查** (1-2 位審查者)
754
- - ✅ **需要狀態檢查通過** (CI 測試、linting)
755
- - ✅ **需要分支保持最新** 才能合併
756
- - ✅ **管理員也受限制**
757
- - ❌ **不允許強制推送**
758
- - ❌ **不允許刪除**
759
-
760
- **設定範例 (GitHub)**:
744
+ **不良範例**:
761
745
  ```
762
- Settings → Branches → Branch protection rules
763
-
764
- Rule: main
765
- ☑ Require pull request before merging
766
- ☑ Require approvals: 1
767
- ☑ Require status checks before merging
768
- ☑ Require branches to be up to date
769
- ☑ Status checks: CI/Build, Lint, Tests
770
- ☑ Do not allow bypassing the above settings
771
- ☐ Allow force pushes
772
- ☐ Allow deletions
746
+ ❌ Update code (too vague)
747
+ ❌ fix bug (not descriptive)
748
+ ❌ WIP: working on auth (WIP shouldn't be in title)
749
+ ❌ JIRA-1234 (no description)
750
+ ❌ Final fixes (meaningless)
773
751
  ```
774
752
 
775
- ---
776
-
777
- ## Pull Request 工作流程
778
-
779
- ### PR 建立檢查清單
780
-
781
- - [ ] **標題遵循提交慣例** (例如 `feat(auth): add OAuth2`)
782
- - [ ] **描述說明原因** (不只是做了什麼)
783
- - [ ] **連結到 issue** (例如 "Closes #123")
784
- - [ ] **新功能包含測試**
785
- - [ ] **必要時更新文件**
786
- - [ ] **在描述中標示重大變更**
787
- - [ ] **UI 變更包含截圖/GIF**
788
-
789
- ### PR 描述範本
790
-
791
- ```markdown
792
- ## What
793
-
794
- [簡短描述此 PR 做了什麼]
795
-
796
- ## Why
797
-
798
- [說明為什麼需要此變更]
799
-
800
- ## Changes
801
-
802
- - [主要變更的條列清單]
803
- - [用 ⚠️ 標記重大變更]
753
+ ### 自動化強制執行
804
754
 
805
- ## Testing
755
+ 設定 GitHub Actions 來驗證 PR 標題:
806
756
 
807
- - [ ] 已新增/更新單元測試
808
- - [ ] 整合測試通過
809
- - [ ] 已執行手動測試
757
+ ```yaml
758
+ # .github/workflows/pr-title.yml
759
+ name: PR Title Check
760
+ on:
761
+ pull_request:
762
+ types: [opened, edited, synchronize]
810
763
 
811
- ## Screenshots (if applicable)
812
-
813
- [為 UI 變更新增截圖]
814
-
815
- ## Related Issues
816
-
817
- Closes #123
818
- Refs #456
764
+ jobs:
765
+ validate:
766
+ runs-on: ubuntu-latest
767
+ steps:
768
+ - uses: amannn/action-semantic-pull-request@v5
769
+ env:
770
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
771
+ with:
772
+ types: |
773
+ feat
774
+ fix
775
+ docs
776
+ refactor
777
+ test
778
+ chore
779
+ perf
780
+ style
781
+ ci
782
+ build
783
+ requireScope: false
784
+ subjectPattern: ^[A-Z].+$
785
+ subjectPatternError: |
786
+ Subject must start with uppercase letter
819
787
  ```
820
788
 
821
789
  ---
@@ -896,50 +864,9 @@ git rebase -i HEAD~3
896
864
 
897
865
  ---
898
866
 
899
- ## 專案設定範本
900
-
901
- 在 `CONTRIBUTING.md` 中記錄您的工作流程:
902
-
903
- ```markdown
904
- ## Git Workflow
867
+ ## 疑難排解指南
905
868
 
906
- ### Branching Strategy
907
- This project uses **[GitFlow / GitHub Flow / Trunk-Based Development]**.
908
-
909
- ### Branch Types
910
- - `main`: Production code
911
- - `develop`: Development mainline (GitFlow only)
912
- - `feature/*`: New features
913
- - `fix/*`: Bug fixes
914
- - `hotfix/*`: Urgent production fixes
915
-
916
- ### Branch Naming
917
- Format: `<type>/<description>`
918
- Example: `feature/oauth-login`, `fix/memory-leak`
919
-
920
- ### Merge Strategy
921
- - Feature branches: **[Squash / Merge commit / Rebase]**
922
- - Release branches: Merge commit (--no-ff)
923
- - Hotfix branches: Merge commit (--no-ff)
924
-
925
- ### Protected Branches
926
- - `main`: Requires 1 review, CI must pass
927
- - `develop`: Requires 1 review (if using GitFlow)
928
-
929
- ### Pull Request Process
930
- 1. Create branch from `[main/develop]`
931
- 2. Make changes and push
932
- 3. Open PR with description
933
- 4. Wait for review approval
934
- 5. Ensure CI passes
935
- 6. Merge using **[strategy]**
936
- ```
937
-
938
- ---
939
-
940
- ## 疑難排解
941
-
942
- ### 不小心提交到錯誤的分支
869
+ ### 不小心提交到錯誤分支
943
870
 
944
871
  ```bash
945
872
  # Undo last commit but keep changes
@@ -965,7 +892,7 @@ git checkout feature/my-feature
965
892
  git rebase main
966
893
  ```
967
894
 
968
- ### 不小心強制推送到保護分支
895
+ ### 不小心強制推送到受保護分支
969
896
 
970
897
  ```bash
971
898
  # ⚠️ Contact team immediately
@@ -977,40 +904,60 @@ git reset --hard <previous-commit-hash>
977
904
 
978
905
  ---
979
906
 
980
- ## 相關標準
907
+ ## 專案設定範本
981
908
 
982
- - [Commit Message Guide](../../../../core/commit-message-guide.md) - Commit 訊息規範
983
- - [Code Check-in Standards](../../../../core/checkin-standards.md) - 程式碼簽入標準
984
- - [Versioning Standard](../../../../core/versioning.md) - 語義化版本標準
985
- - [Changelog Standards](../../../../core/changelog-standards.md) - 變更日誌標準
909
+ 在 `CONTRIBUTING.md` 中記錄您的工作流程:
986
910
 
987
- ---
911
+ ```markdown
912
+ ## Git Workflow
988
913
 
989
- ## 版本歷史
914
+ ### Branching Strategy
915
+ This project uses **[GitFlow / GitHub Flow / Trunk-Based Development]**.
990
916
 
991
- | 版本 | 日期 | 變更 |
992
- |------|------|------|
993
- | 1.3.0 | 2026-01-24 | 新增:Trunk-Based + 功能開關整合、Ship/Show/Ask 決策模型、堆疊式 PR、傳統式 PR 標題 |
994
- | 1.2.1 | 2025-12-24 | 新增:相關標準區段 |
995
- | 1.2.0 | 2025-12-16 | 新增:工作流程策略決策樹、選擇矩陣和快速選擇指南 |
996
- | 1.1.0 | 2025-12-08 | 新增:開分支前檢查清單區段,含工作流程特定指引 |
997
- | 1.0.0 | 2025-11-12 | 初始 Git 工作流程標準 |
917
+ ### Branch Types
918
+ - `main`: Production code
919
+ - `develop`: Development mainline (GitFlow only)
920
+ - `feature/*`: New features
921
+ - `fix/*`: Bug fixes
922
+ - `hotfix/*`: Urgent production fixes
923
+
924
+ ### Branch Naming
925
+ Format: `<type>/<description>`
926
+ Example: `feature/oauth-login`, `fix/memory-leak`
927
+
928
+ ### Merge Strategy
929
+ - Feature branches: **[Squash / Merge commit / Rebase]**
930
+ - Release branches: Merge commit (--no-ff)
931
+ - Hotfix branches: Merge commit (--no-ff)
932
+
933
+ ### Protected Branches
934
+ - `main`: Requires 1 review, CI must pass
935
+ - `develop`: Requires 1 review (if using GitFlow)
936
+
937
+ ### Pull Request Process
938
+ 1. Create branch from `[main/develop]`
939
+ 2. Make changes and push
940
+ 3. Open PR with description
941
+ 4. Wait for review approval
942
+ 5. Ensure CI passes
943
+ 6. Merge using **[strategy]**
944
+ ```
998
945
 
999
946
  ---
1000
947
 
1001
948
  ## 參考資料
1002
949
 
1003
- - [GitFlow Original Article](https://nvie.com/posts/a-successful-git-branching-model/)
1004
- - [GitHub Flow Guide](https://guides.github.com/introduction/flow/)
950
+ - [GitFlow 原始文章](https://nvie.com/posts/a-successful-git-branching-model/)
951
+ - [GitHub Flow 指南](https://guides.github.com/introduction/flow/)
1005
952
  - [Trunk-Based Development](https://trunkbaseddevelopment.com/)
1006
953
  - [Semantic Versioning](https://semver.org/)
1007
954
  - [Ship/Show/Ask](https://martinfowler.com/articles/ship-show-ask.html) - Rouan Wilsenach 的程式碼變更決策模型
1008
- - [功能開關最佳實踐](https://launchdarkly.com/blog/best-practices-feature-flags/) - LaunchDarkly 的全面指南
1009
- - [堆疊式 Diffs](https://graphite.dev/guides/stacked-diffs) - Graphite 的堆疊式 PR 工作流程指南
1010
- - [傳統式 Commits](https://www.conventionalcommits.org/) - Commit 訊息規範
955
+ - [Feature Flags 最佳實踐](https://launchdarkly.com/blog/best-practices-feature-flags/) - LaunchDarkly 的完整指南
956
+ - [Stacked Diffs](https://graphite.dev/guides/stacked-diffs) - Graphite 的堆疊式 PR 工作流程指南
957
+ - [Conventional Commits](https://www.conventionalcommits.org/) - commit 訊息規範
1011
958
 
1012
959
  ---
1013
960
 
1014
- ## 授權
961
+ ## 授權條款
1015
962
 
1016
- 本標準以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權發布。
963
+ 本指南採用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 釋出。