universal-dev-standards 6.14.0-beta.1 → 6.14.0-beta.11

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 +11 -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 +113 -38
  638. package/src/flows/init-flow.js +10 -0
  639. package/src/hitl/manager.js +4 -2
  640. package/src/i18n/messages.js +413 -78
  641. package/src/installers/hooks-installer.js +236 -27
  642. package/src/installers/integration-installer.js +5 -1
  643. package/src/installers/skills-installer.js +3 -1
  644. package/src/installers/standards-installer.js +16 -23
  645. package/src/mcp/__tests__/server.test.js +0 -1
  646. package/src/mcp/server.js +16 -4
  647. package/src/prompts/init.js +148 -13
  648. package/src/reconciler/backup-locations.js +80 -0
  649. package/src/reconciler/backup-manager.js +451 -123
  650. package/src/reconciler/index.js +86 -10
  651. package/src/reconciler/install-roots.js +90 -0
  652. package/src/reconciler/plan-executor.js +37 -15
  653. package/src/uninstallers/hook-uninstaller.js +220 -33
  654. package/src/uninstallers/integration-uninstaller.js +35 -5
  655. package/src/uninstallers/skills-uninstaller.js +95 -16
  656. package/src/uninstallers/standards-uninstaller.js +56 -7
  657. package/src/utils/agents-installer.js +10 -17
  658. package/src/utils/available-standards-report.js +144 -0
  659. package/src/utils/available-standards.js +216 -0
  660. package/src/utils/command-hash-ownership.js +103 -0
  661. package/src/utils/commit-message-judge.js +155 -0
  662. package/src/utils/copier.js +80 -2
  663. package/src/utils/deps-applicability.js +25 -0
  664. package/src/utils/detector.js +46 -1
  665. package/src/utils/friction-detector.js +27 -0
  666. package/src/utils/gate-scripts.js +141 -0
  667. package/src/utils/git-hooks.js +139 -7
  668. package/src/utils/hasher.js +36 -0
  669. package/src/utils/health-scorer.js +10 -7
  670. package/src/utils/installed-names-ownership.js +114 -0
  671. package/src/utils/integration-generator.js +36 -24
  672. package/src/utils/legacy-hook-migration.js +112 -0
  673. package/src/utils/locale.js +19 -0
  674. package/src/utils/open-work-tracking.mjs +1754 -0
  675. package/src/utils/prompt-closed.js +18 -0
  676. package/src/utils/sdd-header.js +66 -0
  677. package/src/utils/skill-frontmatter.js +102 -0
  678. package/src/utils/skill-hash-ownership.js +64 -0
  679. package/src/utils/skill-name-collision.js +169 -0
  680. package/src/utils/skills-install-paths.js +114 -0
  681. package/src/utils/skills-installer.js +75 -106
  682. package/src/utils/standard-validator.js +98 -27
  683. package/src/utils/test-change-check.js +160 -0
  684. package/src/utils/test-policy.js +214 -0
  685. package/src/utils/transient-fs.js +113 -0
  686. package/src/utils/update-summary.js +29 -0
  687. package/src/vibe/micro-spec.js +15 -0
  688. package/standards-registry.json +48 -9
@@ -2,13 +2,14 @@
2
2
  source: ../../../../options/git-workflow/rebase-ff.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2025-12-30
5
+ last_synced: 2026-10-11
6
+ source_hash: b0c321db93d1
6
7
  status: current
7
8
  ---
8
9
 
9
10
  # Rebase and Fast-Forward 策略
10
11
 
11
- > **语言**: [English](../../../../options/git-workflow/rebase-ff.md) | 繁体中文
12
+ > **语言**: [English](../../../../options/git-workflow/rebase-ff.md) | 简体中文
12
13
 
13
14
  **上层标准**: [Git 工作流程](../../../../core/git-workflow.md)
14
15
 
@@ -16,145 +17,259 @@ status: current
16
17
 
17
18
  ## 概述
18
19
 
19
- Rebase and fast-forward 是一种合并策略,透过将功能分支的 commit 重新播放到目标分支上方,建立完全线性的历史。结果是干净、直线的历史,所有 commit 看起来像是在单一分支上依序完成的。
20
+ Rebase and fast-forward 是一种合并策略,它将功能分支的 commit 重放到目标分支之上,从而形成完全线性的历史。结果是一条干净、笔直的历史线,所有 commit 看起来就像是在同一个分支上依次提交的。
20
21
 
21
- ## 适用情境
22
+ ## 适用场景
22
23
 
23
24
  - 偏好线性历史的团队
24
- - 大量依赖 `git bisect` 的专案
25
- - 想要干净、可读日志的开发者
26
- - 有高程式码品质标准的开源专案
25
+ - 高度依赖 `git bisect` 的项目
26
+ - 希望日志干净、易读的开发者
27
+ - 代码质量标准较高的开源项目
27
28
 
28
- ## 运作方式
29
+ ## 工作原理
29
30
 
30
31
  ```
31
- rebase 前: rebase + fast-forward 后:
32
- main: A---B---C A---B---C---D'---E'---F'
33
- \ (rebased commits)
32
+ Before rebase: After rebase + fast-forward:
33
+ main: A---B---C A---B---C---D'---E'---F'
34
+ \ (rebased commits)
34
35
  feature: D---E---F
35
36
  ```
36
37
 
37
- Commit D、E、F 被「重新播放」为 D'、E'、F' 在 C 之上。
38
+ commit D、E、F 被“重放”为 C 之上的 D'、E'、F'。
38
39
 
39
40
  ## 工作流程
40
41
 
41
- ### 合并前的互动式 Rebase
42
+ ### 合并前的交互式 Rebase
42
43
 
43
44
  ```bash
44
- # 在功能分支上开始
45
+ # Start on feature branch
45
46
  git checkout feature/user-profile
46
47
 
47
- # 取得最新变更
48
+ # Fetch latest changes
48
49
  git fetch origin
49
50
 
50
- # Rebase 到 main 上
51
+ # Rebase onto main
51
52
  git rebase origin/main
52
53
 
53
- # 如有冲突,解决后继续
54
+ # If conflicts occur, resolve and continue
54
55
  git add <resolved-files>
55
56
  git rebase --continue
56
57
 
57
- # 或需要时中止
58
+ # Or abort if needed
58
59
  git rebase --abort
59
60
  ```
60
61
 
61
62
  ### Fast-Forward 合并
62
63
 
63
64
  ```bash
64
- # 切换到 main
65
+ # Switch to main
65
66
  git checkout main
66
67
  git pull origin main
67
68
 
68
- # Fast-forward 合并(只在 feature 领先时有效)
69
+ # Fast-forward merge (only works if feature is ahead)
69
70
  git merge --ff-only feature/user-profile
70
71
 
71
- # 推送
72
+ # Push
72
73
  git push origin main
73
74
 
74
- # 清理
75
+ # Clean up
75
76
  git branch -d feature/user-profile
76
77
  ```
77
78
 
78
- ### Rebase 后的 Force Push
79
+ ### Rebase 后强制推送
79
80
 
80
- 当你 rebase 了已推送的分支:
81
+ 当你对一个已经推送过的分支执行 rebase 时:
81
82
 
82
83
  ```bash
83
- # rebase 后
84
+ # After rebasing
84
85
  git push --force-with-lease origin feature/user-profile
85
86
 
86
- # --force-with-lease 比 --force 安全
87
- # 如果其他人推送到该分支会失败
87
+ # --force-with-lease is safer than --force
88
+ # It fails if someone else pushed to the branch
88
89
  ```
89
90
 
90
- ## 互动式 Rebase
91
+ ## 交互式 Rebase
91
92
 
92
- 合并前清理 commit:
93
+ 在合并前整理 commit:
93
94
 
94
95
  ```bash
95
- # 互动式 rebase 最近 4 个 commit
96
+ # Rebase last 4 commits interactively
96
97
  git rebase -i HEAD~4
97
98
 
98
- # 或从分支点 rebase
99
+ # Or rebase from branch point
99
100
  git rebase -i main
100
101
  ```
101
102
 
102
- ### 常用清理模式
103
+ ### 交互式 Rebase 命令
103
104
 
104
105
  ```
106
+ pick abc1234 feat: add user model
107
+ squash def5678 fix typo
108
+ reword ghi9012 add user service
109
+ drop jkl3456 wip - remove this
110
+
111
+ # Commands:
112
+ # p, pick = use commit
113
+ # r, reword = use commit, but edit message
114
+ # e, edit = use commit, but stop for amending
115
+ # s, squash = meld into previous commit
116
+ # f, fixup = like squash, but discard message
117
+ # d, drop = remove commit
118
+ ```
119
+
120
+ ### 常用整理模式
121
+
122
+ ```bash
123
+ # Combine fixup commits
105
124
  pick abc1234 feat: add user model
106
125
  fixup def5678 fix typo in user model
107
126
  fixup ghi9012 another fix
108
127
 
109
- # 结果:单一干净的 commit
128
+ # Result: single clean commit
129
+
130
+ # Reorder and edit
131
+ pick abc1234 feat: add user model
132
+ reword def5678 feat: add user validation
133
+ pick ghi9012 test: add user tests
110
134
  ```
111
135
 
112
136
  ## 优点
113
137
 
114
138
  | 优点 | 说明 |
115
139
  |------|------|
116
- | 线性历史 | 容易阅读和理解 |
117
- | 干净日志 | `git log` 显示直线 |
118
- | 有效的 bisect | 清楚的变更进程 |
119
- | 原子 commit | 每个 commit 独立完整 |
120
- | 无合并 commit | 更干净的储存库 |
140
+ | 线性历史 | 易于阅读和理解 |
141
+ | 干净的日志 | `git log` 呈现一条直线 |
142
+ | 高效的 bisect | 变更的演进清晰明了 |
143
+ | 原子化 commit | 每个 commit 都是自包含的 |
144
+ | 没有合并 commit | 仓库更整洁 |
121
145
 
122
146
  ## 缺点
123
147
 
124
148
  | 缺点 | 说明 |
125
149
  |------|------|
126
- | 重写历史 | Commit SHA 在 rebase 后改变 |
127
- | 需要 force push | rebase 已推送的分支后 |
150
+ | 改写历史 | rebase 后 commit SHA 会改变 |
151
+ | 需要强制推送 | 对已推送的分支执行 rebase 后 |
128
152
  | 冲突解决 | 可能需要多次解决冲突 |
129
- | 失去合并脉络 | 无分支合并时间记录 |
130
- | 共享时危险 | 可能对协作者造成问题 |
153
+ | 丢失合并上下文 | 没有记录分支何时合并 |
154
+ | 共享时有风险 | 可能给协作者带来问题 |
131
155
 
132
- ## Rebase 的黄金法则
156
+ ## 安全规则
133
157
 
134
- **永远不要 rebase 已推送到共享分支的 commit。**
158
+ ### Rebase 的黄金法则
159
+
160
+ **永远不要对已推送到共享分支的 commit 执行 rebase。**
135
161
 
136
162
  ```bash
137
- # 安全:rebase 本地 commit
138
- git rebase main # 如果功能分支未推送
163
+ # SAFE: Rebase local-only commits
164
+ git rebase main # If feature branch is not pushed
139
165
 
140
- # 注意:rebase 已推送的功能分支
166
+ # CAUTION: Rebase pushed feature branch
141
167
  git rebase main
142
- git push --force-with-lease # 只有在你是唯一工作者时
168
+ git push --force-with-lease # Only if you're the only one working on it
143
169
 
144
- # 危险:永远不要这样做
170
+ # DANGEROUS: Never do this
145
171
  git checkout main
146
- git rebase feature # 永远不要 rebase main/master!
172
+ git rebase feature # Never rebase main/master!
173
+ ```
174
+
175
+ ### 使用 `--force-with-lease`
176
+
177
+ ```bash
178
+ # Safer than --force
179
+ git push --force-with-lease origin feature-branch
180
+
181
+ # Fails if remote has commits you don't have locally
182
+ # Prevents overwriting others' work
183
+ ```
184
+
185
+ ## 配置
186
+
187
+ ### 仓库设置(GitHub)
188
+
189
+ ```yaml
190
+ # In repository settings > Pull Requests
191
+ Allow rebase merging: ✓
192
+ Allow merge commits: ✗ (for enforcement)
193
+ Allow squash merging: ✗ (for enforcement)
194
+ ```
195
+
196
+ ### Git 配置
197
+
198
+ ```bash
199
+ # Default to rebase when pulling
200
+ git config --global pull.rebase true
201
+
202
+ # Auto-stash before rebase
203
+ git config --global rebase.autoStash true
204
+
205
+ # Auto-squash fixup commits
206
+ git config --global rebase.autoSquash true
207
+ ```
208
+
209
+ ### Git 别名
210
+
211
+ ```bash
212
+ # Add to ~/.gitconfig
213
+ [alias]
214
+ rb = rebase
215
+ rbi = rebase -i
216
+ rbc = rebase --continue
217
+ rba = rebase --abort
218
+ fpush = push --force-with-lease
219
+ ```
220
+
221
+ ## Rebase 过程中处理冲突
222
+
223
+ ```bash
224
+ # Start rebase
225
+ git rebase main
226
+
227
+ # When conflict occurs:
228
+ # 1. Edit conflicted files
229
+ # 2. Stage resolved files
230
+ git add <resolved-files>
231
+
232
+ # 3. Continue rebase
233
+ git rebase --continue
234
+
235
+ # Repeat for each conflicting commit
236
+
237
+ # If you want to skip a commit
238
+ git rebase --skip
239
+
240
+ # If you want to abort entirely
241
+ git rebase --abort
242
+ ```
243
+
244
+ ## Autosquash 工作流程
245
+
246
+ 使用 commit 信息前缀实现自动压缩:
247
+
248
+ ```bash
249
+ # Original commit
250
+ git commit -m "feat: add user model"
251
+
252
+ # Later fixup (will auto-squash)
253
+ git commit --fixup=<original-sha>
254
+ # Creates: "fixup! feat: add user model"
255
+
256
+ # Or squash with custom message
257
+ git commit --squash=<original-sha>
258
+ # Creates: "squash! feat: add user model"
259
+
260
+ # Auto-squash during rebase
261
+ git rebase -i --autosquash main
147
262
  ```
148
263
 
149
264
  ## 相关选项
150
265
 
151
- - [Squash Merge](./squash-merge.md) - 单一 commit,更简单的工作流程
266
+ - [Squash Merge](./squash-merge.md) - 单一 commit,工作流程更简单
152
267
  - [Merge Commit](./merge-commit.md) - 保留分支历史
153
268
 
154
269
  ---
155
270
 
156
- ## 授权条款
271
+ ## 许可
157
272
 
158
- 本文件采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权条款。
273
+ 本文档采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 许可发布。
159
274
 
160
275
  **来源**:[universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
@@ -2,13 +2,14 @@
2
2
  source: ../../../../options/git-workflow/squash-merge.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2025-12-30
5
+ last_synced: 2026-10-11
6
+ source_hash: 9a4b55eed66f
6
7
  status: current
7
8
  ---
8
9
 
9
10
  # Squash Merge 合并策略
10
11
 
11
- > **语言**: [English](../../../../options/git-workflow/squash-merge.md) | 繁体中文
12
+ > **语言**: [English](../../../../options/git-workflow/squash-merge.md) | 简体中文
12
13
 
13
14
  **上层标准**: [Git 工作流程](../../../../core/git-workflow.md)
14
15
 
@@ -16,38 +17,57 @@ status: current
16
17
 
17
18
  ## 概述
18
19
 
19
- Squash merge 在合并时将功能分支的所有 commit 压缩成单一 commit。这在主分支上建立干净、线性的历史,每个合并代表一个完整的功能或变更。
20
+ Squash merge 在合并时将功能分支的所有 commit 合并为单个 commit。这会在主分支上形成干净、线性的历史,其中每次合并代表一个完整的功能或变更。
20
21
 
21
- ## 适用情境
22
+ ## 适用场景
22
23
 
23
24
  - 重视主分支历史整洁的团队
24
- - 开发过程中有许多小型 commit 的专案
25
- - 程式码审查流程中最终结果比过程重要
26
- - 接受外部贡献的开源专案
25
+ - 开发过程中有大量小型 commit 的项目
26
+ - 更看重最终结果而非过程的代码审查工作流程
27
+ - 接受外部贡献的开源项目
27
28
 
28
- ## 运作方式
29
+ ## 工作原理
29
30
 
30
31
  ```
31
- 功能分支: 合并后的 main 分支:
32
- A---B---C---D X---Y---Z(单一压缩 commit)
32
+ Feature branch: Main branch after squash merge:
33
+ A---B---C---D X---Y---Z (single squashed commit)
33
34
  \ |
34
- E---F---G---H → S(包含 E+F+G+H)
35
- (功能 commits)
35
+ E---F---G---H → S (contains E+F+G+H)
36
+ (feature commits)
36
37
  ```
37
38
 
38
39
  ## 工作流程
39
40
 
40
- ### 透过 CLI 进行 Squash Merge
41
+ ### 创建 Pull Request
41
42
 
42
43
  ```bash
43
- # 切到 main 分支
44
+ # Create feature branch
45
+ git checkout -b feature/user-profile
46
+ git checkout main
47
+ git pull origin main
48
+
49
+ # Make multiple commits during development
50
+ git commit -m "wip: start user profile"
51
+ git commit -m "add avatar upload"
52
+ git commit -m "fix styling"
53
+ git commit -m "add tests"
54
+ git commit -m "fix test failure"
55
+
56
+ # Push and create PR
57
+ git push origin feature/user-profile
58
+ ```
59
+
60
+ ### Squash 合并(通过 CLI)
61
+
62
+ ```bash
63
+ # On main branch
44
64
  git checkout main
45
65
  git pull origin main
46
66
 
47
67
  # Squash merge
48
68
  git merge --squash feature/user-profile
49
69
 
50
- # 建立有意义的单一 commit
70
+ # Create single commit with meaningful message
51
71
  git commit -m "feat(users): add user profile with avatar upload
52
72
 
53
73
  - Add profile page component
@@ -56,62 +76,127 @@ git commit -m "feat(users): add user profile with avatar upload
56
76
 
57
77
  Closes #123"
58
78
 
59
- # 推送并清理
79
+ # Push and clean up
60
80
  git push origin main
61
81
  git branch -d feature/user-profile
62
82
  git push origin --delete feature/user-profile
63
83
  ```
64
84
 
65
- ### 透过 GitHub 进行
85
+ ### Squash 合并(通过 GitHub)
66
86
 
67
- 1. 开启 Pull Request
68
- 2. 点击「Squash and merge」按钮
69
- 3. 编辑 commit 讯息使其有意义
87
+ 1. 打开 Pull Request
88
+ 2. 点击“Squash and merge”按钮
89
+ 3. 将 commit 信息编辑为有意义的内容
70
90
  4. 确认合并
71
91
  5. 删除功能分支
72
92
 
73
- ## Commit 讯息最佳实践
93
+ ## Commit 信息最佳实践
74
94
 
75
- 进行 squash merge 时,撰写完整的 commit 讯息:
95
+ 进行 squash 合并时,请编写完整的 commit 信息:
76
96
 
77
97
  ```
78
- feat(scope): 简洁描述
98
+ feat(scope): concise description
79
99
 
80
- - 主要变更 1
81
- - 主要变更 2
82
- - 主要变更 3
100
+ - Key change 1
101
+ - Key change 2
102
+ - Key change 3
83
103
 
84
104
  Closes #issue-number
85
105
  Co-authored-by: Name <email@example.com>
86
106
  ```
87
107
 
108
+ ### 好的示例
109
+
110
+ ```
111
+ feat(auth): implement OAuth2 login flow
112
+
113
+ - Add Google and GitHub OAuth providers
114
+ - Create secure token storage
115
+ - Implement automatic token refresh
116
+ - Add logout functionality
117
+
118
+ Closes #456
119
+ Reviewed-by: @teammate
120
+ ```
121
+
122
+ ### 不好的示例
123
+
124
+ ```
125
+ Squashed commit of the following:
126
+ - wip
127
+ - more wip
128
+ - fix stuff
129
+ - actually fix stuff
130
+ ```
131
+
88
132
  ## 优点
89
133
 
90
134
  | 优点 | 说明 |
91
135
  |------|------|
92
- | 干净的历史 | 主分支每个功能一个 commit |
93
- | 容易还原 | 单一 commit 还原整个功能 |
94
- | 简化 bisect | 较少 commit 需要搜寻 |
95
- | 自由提交 | 开发者可频繁提交不会杂乱 |
136
+ | 干净的历史 | 主分支上每个功能只显示一个 commit |
137
+ | 易于回滚 | 回滚单个 commit 即可撤销整个功能 |
138
+ | 简化 bisect | 需要搜索的 commit 更少 |
139
+ | 自由提交 | 开发者可以频繁提交而不会弄乱历史 |
96
140
 
97
141
  ## 缺点
98
142
 
99
143
  | 缺点 | 说明 |
100
144
  |------|------|
101
- | 失去细节 | 个别 commit 历史遗失 |
102
- | 难以追踪 | 无法追溯特定行到原始 commit |
103
- | 大型 diff | 单一 commit 可能有大量变更 |
104
- | 失去脉络 | 开发过程不被保留 |
145
+ | 丢失粒度 | 单个 commit 的历史会丢失 |
146
+ | blame 更困难 | 无法将特定代码行追溯到原始 commit |
147
+ | diff 较大 | 单个 commit 可能包含大量变更 |
148
+ | 丢失上下文 | 开发过程不会被保留 |
149
+
150
+ ## 何时不应使用
151
+
152
+ - 单个 commit 的历史很重要时
153
+ - 对于带有有价值 commit 信息的长期分支
154
+ - 之后需要 cherry-pick 特定变更时
155
+ - 对于有多位作者且需要署名的分支
156
+
157
+ ## 配置
158
+
159
+ ### GitHub 仓库设置
160
+
161
+ ```yaml
162
+ # In repository settings > Pull Requests
163
+ Allow squash merging: ✓
164
+ Allow merge commits: ✗ (optional, for enforcement)
165
+ Allow rebase merging: ✗ (optional, for enforcement)
166
+
167
+ # Default commit message
168
+ Default to pull request title and description
169
+ ```
170
+
171
+ ### Git 别名
172
+
173
+ ```bash
174
+ # Add to ~/.gitconfig
175
+ [alias]
176
+ squash = merge --squash
177
+ sm = "!f() { git merge --squash $1 && git commit; }; f"
178
+ ```
179
+
180
+ ## 保留共同作者
181
+
182
+ 当多人为同一分支做出贡献时:
183
+
184
+ ```bash
185
+ git commit -m "feat: implement feature
186
+
187
+ Co-authored-by: Alice <alice@example.com>
188
+ Co-authored-by: Bob <bob@example.com>"
189
+ ```
105
190
 
106
191
  ## 相关选项
107
192
 
108
193
  - [Merge Commit](./merge-commit.md) - 保留所有 commit 历史
109
- - [Rebase and Fast-Forward](./rebase-ff.md) - 线性历史保留所有 commit
194
+ - [Rebase and Fast-Forward](./rebase-ff.md) - 保留所有 commit 的线性历史
110
195
 
111
196
  ---
112
197
 
113
- ## 授权条款
198
+ ## 许可
114
199
 
115
- 本文件采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权条款。
200
+ 本文档采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 许可发布。
116
201
 
117
202
  **来源**:[universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)