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,32 @@
1
1
  ---
2
2
  source: ../../../core/commit-message-guide.md
3
- source_version: 1.3.0
4
- translation_version: 1.3.0
5
- last_synced: 2026-03-16
3
+ source_version: 1.4.0
4
+ translation_version: 1.4.0
5
+ last_synced: 2026-10-16
6
+ source_hash: 8bf9a79dc6d1
6
7
  status: current
7
8
  ---
8
9
 
9
- > **语言**: [English](../../../core/commit-message-guide.md) | [简体中文](../../zh-TW/core/commit-message-guide.md) | 简体中文
10
-
11
10
  # 提交消息指南
12
11
 
13
- **版本**: 1.0.0
14
- **最后更新**: 2025-12-30
15
- **适用范围**: 所有使用 Git 进行版本控制的项目
12
+ > **语言**: [English](../../../core/commit-message-guide.md) | [繁體中文](../../zh-TW/core/commit-message-guide.md) | 简体中文
13
+
14
+ **版本**: 1.4.0
15
+ **最后更新**: 2026-10-12
16
+ **适用范围**: 所有使用 Git 版本控制的项目
17
+ **范畴**: 通用
18
+ **行业标准**: Conventional Commits 1.0.0
19
+ **参考资料**: [conventionalcommits.org](https://www.conventionalcommits.org/)
16
20
 
17
21
  ---
18
22
 
19
23
  ## 目的
20
24
 
21
- 本标准定义如何撰写清晰、有意义的 Git 提交消息,以提升项目历史的可读性和可追溯性。
25
+ 标准化的提交消息可提高代码审查效率,促进自动化变更日志生成,并使项目历史易于搜索与理解。
22
26
 
23
27
  ---
24
28
 
25
- ## 格式
26
-
27
- ### 标准格式
29
+ ## 基本格式
28
30
 
29
31
  ```
30
32
  <type>(<scope>): <subject>
@@ -34,115 +36,936 @@ status: current
34
36
  <footer>
35
37
  ```
36
38
 
37
- ### 组成说明
39
+ ### 组成部分
38
40
 
39
- | 组成 | 必要性 | 说明 |
40
- |------|-------|------|
41
- | type | 必要 | 变更类型 |
42
- | scope | 可选 | 影响范围 |
43
- | subject | 必要 | 简短描述 |
44
- | body | 可选 | 详细说明 |
45
- | footer | 可选 | 引用、破坏性变更 |
41
+ | 组成部分 | 必要性 | 说明 |
42
+ | ----------- | ----------- | ---------------------------------- |
43
+ | `type` | ✅ 是 | 变更类型 |
44
+ | `scope` | 可选 | 受影响的模块/组件 |
45
+ | `subject` | ✅ 是 | 简短描述(≤72 字符) |
46
+ | `body` | 建议提供 | 详细说明 |
47
+ | `footer` | 可选 | Issue 引用、破坏性变更 |
46
48
 
47
49
  ---
48
50
 
49
- ## 变更类型 (Type)
51
+ ## 类型分类
50
52
 
51
- | 类型 | 说明 | 示例 |
52
- |------|------|------|
53
- | feat | 新功能 | 添加用户登录功能 |
54
- | fix | 错误修复 | 修复支付金额计算错误 |
55
- | docs | 文档变更 | 更新 API 文档 |
56
- | style | 格式调整(不影响代码逻辑) | 调整代码缩进 |
57
- | refactor | 重构(非新功能、非错误修复) | 重构用户认证模块 |
58
- | perf | 性能优化 | 优化数据库查询 |
59
- | test | 测试相关 | 添加单元测试 |
60
- | build | 构建系统变更 | 更新 webpack 配置 |
61
- | ci | CI 配置变更 | 更新 GitHub Actions |
62
- | chore | 其他变更 | 更新依赖版本 |
63
- | revert | 回滚提交 | 回滚上一次提交 |
53
+ **项目必须选择一种语言**作为类型并在整个项目中保持一致。
64
54
 
65
- ---
55
+ ### 选项 A:英文(国际化)
56
+
57
+ 适用于国际化团队以及需要最大工具兼容性的场景。
58
+
59
+ | 类型 | 使用时机 |
60
+ | ------------ | --------------------------------------------- |
61
+ | `feat` | 新功能 |
62
+ | `fix` | 错误修复 |
63
+ | `refactor` | 代码重构(无功能变更) |
64
+ | `docs` | 仅文档变更 |
65
+ | `style` | 格式调整、空白符(无代码逻辑变更) |
66
+ | `test` | 添加或更新测试 |
67
+ | `perf` | 性能改进 |
68
+ | `build` | 构建系统或外部依赖变更 |
69
+ | `ci` | CI/CD 流水线变更 |
70
+ | `chore` | 日常维护任务 |
71
+ | `revert` | 回滚先前的提交 |
72
+ | `security` | 安全漏洞修复 |
66
73
 
67
- ## 示例
74
+ ### 选项 B:繁体中文(中国台湾团队)
68
75
 
69
- ### 简单提交
76
+ 使用**选项 A 的英文类型**,搭配繁体中文的主题(subject)与正文(body),适用于偏好母语提交的本地团队。类型保持英文是因为工具需要读取它(commitlint 的 `type-enum`、变更日志生成器、`uds simulate`);只有主题和正文使用中文。**不允许**使用类似 `新增` 的中文类型。
77
+
78
+ | 类型 | 使用时机 | 示例 |
79
+ | ---------- | --------------------- | --------------------------------- |
80
+ | `feat` | 新功能 | `feat(auth): 加入 OAuth2 登入` |
81
+ | `fix` | 错误修复 | `fix(api): 處理空值回應` |
82
+ | `refactor` | 代码重构 | `refactor(core): 簡化驗證邏輯` |
83
+ | `docs` | 仅文档变更 | `docs(readme): 更新安裝指南` |
84
+ | `style` | 仅格式调整 | `style(lint): 修正縮排` |
85
+ | `test` | 添加/更新测试 | `test(auth): 新增登入單元測試` |
86
+ | `perf` | 性能改进 | `perf(query): 最佳化資料庫查詢` |
87
+ | `build` | 构建系统 | `build(deps): 升級 lodash` |
88
+ | `ci` | CI/CD 变更 | `ci(github): 新增覆蓋率工作流程` |
89
+ | `chore` | 日常维护 | `chore(deps): 更新開發相依套件` |
90
+ | `revert` | 回滚提交 | `revert: feat(auth): 加入 OAuth2 登入` |
91
+ | `security` | 安全修复 | `security(auth): 修正 XSS 漏洞` |
92
+
93
+ > **1.4.0 变更** (XSPEC-475):此选项的早期版本列出了中文类型(`新增`、`修正` 等)。它们已不再被允许;曾使用这些类型的项目应通过将其替换为英文等效项来进行迁移(`新增` → `feat`、`修正` → `fix`、`重構` → `refactor`、`文件` → `docs`、`樣式` → `style`、`測試` → `test`、`效能` → `perf`、`建置` → `build`、`整合` → `ci`、`維護` → `chore`、`回退` → `revert`、`安全` → `security`)。
94
+
95
+ ### 选项 C:双语模式(推荐)
96
+
97
+ 使用英文的 `type` 和 `scope` 以保证工具兼容性,主题/正文/页脚则采用双语。
98
+
99
+ **格式**:
70
100
 
71
101
  ```
72
- feat(auth): add user login functionality
102
+ <type>(<scope>): <English subject>. <Chinese subject>.
103
+
104
+ <English body>
105
+
106
+ <Chinese body>
107
+
108
+ <footer>
73
109
  ```
74
110
 
75
- ### 带正文的提交
111
+ **示例**:
76
112
 
77
113
  ```
78
- fix(payment): correct amount calculation
114
+ feat(auth): Add OAuth2 Google login support. 新增 OAuth2 Google 登入支援。
115
+
116
+ Implement Google OAuth2 authentication flow for user login.
117
+
118
+ - Add Google OAuth2 SDK integration
119
+ - Create callback endpoint for OAuth flow
120
+ - Store refresh tokens securely
121
+
122
+ 實作 Google OAuth2 認證流程供使用者登入。
79
123
 
80
- The payment amount was being rounded incorrectly
81
- when processing international transactions.
124
+ - 整合 Google OAuth2 SDK
125
+ - 建立 OAuth 流程回呼端點
126
+ - 安全儲存更新權杖
82
127
 
83
128
  Closes #123
84
129
  ```
85
130
 
86
- ### 破坏性变更
131
+ > **注意**: 此配置项在项目清单中名为 `output_language`。它同时控制提交消息语言与文档语言。关于此配置项如何影响文档的详细信息,请参阅 [documentation-writing-standards.md](documentation-writing-standards.md#documentation-language-configuration)。
132
+
133
+ ### 语言选择指南
134
+
135
+ 使用本指南为您的项目选择合适的提交消息语言:
136
+
137
+ | 考量因素 | 英文 | 繁体中文 | 双语 |
138
+ |--------|---------|---------------------|-----------|
139
+ | **团队构成** | 国际化/混合团队 | 本地团队(中国台湾) | 混合团队且以本地为主 |
140
+ | **工具兼容性** | ✅ 最佳 | ⚠️ 受限 | ✅ 良好 |
141
+ | **变更日志自动化** | ✅ 完全支持 | ⚠️ 需自定义配置 | ✅ 支持 |
142
+ | **新人入职培训** | 中立 | 本地成员更容易上手 | 双双获益 |
143
+ | **开源项目** | ✅ 推荐 | ❌ 不推荐 | ✅ 良好选择 |
144
+
145
+ **快速选择**:
146
+ - **开源项目** → 英文(选项 A)
147
+ - **本地团队、内部项目** → 繁体中文(选项 B)
148
+ - **有国际协作的本地团队** → 双语(选项 C)
149
+
150
+ **重要说明**: 一旦选定,必须在整个项目中**一致使用**。请勿混用多种语言配置。
151
+
152
+ ---
153
+
154
+ **项目决策点**: 在 `CONTRIBUTING.md` 中记录您的选择(单选):
155
+
156
+ ```markdown
157
+ ## Output Language
158
+
159
+ <!-- Choose ONE of the following options: -->
160
+
161
+ <!-- Option A: English -->
162
+ This project uses **English** commit types (feat, fix, refactor, etc.)
163
+
164
+ <!-- Option B: Traditional Chinese -->
165
+ This project uses **English** commit types (feat, fix, refactor, etc.) with **Traditional Chinese** subjects and bodies
166
+
167
+ <!-- Option C: Bilingual Mode -->
168
+ This project uses **Bilingual Mode** with English types/scopes and bilingual subject/body.
169
+ ```
170
+
171
+ ---
172
+
173
+ ## 作用域(Scope)指南
174
+
175
+ 作用域用于指明代码库中受影响的部分。请使用简短且辨识度高的名称。
176
+
177
+ ### 命名规则
178
+
179
+ 1. **使用小写**: 所有作用域应使用小写字母(例如 `auth`,而非 `Auth`)
180
+ 2. **多词使用连字符**: 词之间使用连字符分隔(例如 `user-profile`,而非 `userProfile`)
181
+ 3. **保持简短**: 最多 1-2 个词
182
+
183
+ ### 常用作用域
184
+
185
+ **按架构层/模块划分**:
186
+
187
+ - `api`: API 层
188
+ - `ui`: 用户界面
189
+ - `auth`: 认证/授权
190
+ - `database`: 数据库层
191
+ - `config`: 配置
192
+ - `middleware`: 中间件层
193
+
194
+ **按功能划分**:
195
+
196
+ - `login`: 登录功能
197
+ - `payment`: 支付处理
198
+ - `notification`: 通知
199
+ - `search`: 搜索功能
200
+
201
+ **按文件类型划分**:
202
+
203
+ - `tests`: 测试文件
204
+ - `docs`: 文档文件
205
+ - `build`: 构建脚本
206
+ - `deps`: 依赖项
207
+
208
+ **特殊作用域**:
209
+
210
+ - `*`: 涉及多个作用域
211
+ - (无 scope): 全局变更
212
+
213
+ **Web API 项目示例作用域**:
87
214
 
88
215
  ```
89
- feat(api)!: change user endpoint response format
216
+ auth, user, product, order, payment, notification,
217
+ database, config, middleware, api, tests, docs
218
+ ```
219
+
220
+ ---
90
221
 
91
- BREAKING CHANGE: The /api/users endpoint now returns
92
- a different JSON structure. See migration guide.
222
+ ## 主题行
223
+
224
+ ### 规则
225
+
226
+ 1. **长度**:≤72 个字符(推荐 50 个字符)
227
+ 2. **时态**:使用祈使语气("Add feature" 而非 "Added feature")
228
+ 3. **大小写**:首字母大写
229
+ 4. **无句号**:结尾不加句号(例外:双语模式使用句号作为分隔符)
230
+ 5. **语言**:遵循项目规范(英文或母语)
231
+
232
+ ### 良好示例
233
+
234
+ ```
235
+ feat(auth): Add OAuth2 Google login support
236
+ fix(api): Resolve memory leak in user session cache
237
+ refactor(database): Extract query builder to separate class
238
+ docs(readme): Update installation instructions for Node 20
239
+ test(payment): Add unit tests for refund flow
240
+ perf(search): Implement index for full-text search
241
+ build(deps): Upgrade Express to 4.18.2
242
+ ```
243
+
244
+ ### 不良示例
245
+
246
+ ```
247
+ ❌ "fixed bug" - Too vague, no scope
248
+ ❌ "feat(auth): added google login and fixed a bug and refactored code" - Too long, multiple concerns
249
+ ❌ "Update stuff." - Has period, too vague
250
+ ❌ "Added OAuth2 login feature" - Past tense instead of imperative
251
+ ❌ "WIP" - Not descriptive
93
252
  ```
94
253
 
95
254
  ---
96
255
 
97
- ## 快速参考卡
256
+ ## 正文
257
+
258
+ 使用正文解释**为什么**进行此变更,而不是变更了**什么**(代码本身已体现了改动内容)。
259
+
260
+ ### 结构
261
+
262
+ - 针对多项变更使用项目符号列表
263
+ - 在 72 个字符处折行
264
+ - 与主题行之间用空行隔开
265
+ - 提供背景上下文与合理性理由
266
+
267
+ ### 正文模板
268
+
269
+ 根据变更类型使用符合上下文的标题。常见模式:
270
+
271
+ **针对新功能**:
272
+
273
+ ```
274
+ Why this feature is needed:
275
+ What this implements:
276
+ Technical notes:
277
+ ```
278
+
279
+ **针对错误修复**:
280
+
281
+ ```
282
+ Why this occurred:
283
+ What this fix does:
284
+ Testing:
285
+ ```
286
+
287
+ **针对重构**:
98
288
 
99
- ### 提交类型速查
289
+ ```
290
+ Why this refactoring:
291
+ What this changes:
292
+ Migration:
293
+ ```
294
+
295
+ **通用模板**:
100
296
 
101
- | 我做了什么? | 使用类型 |
102
- |-------------|---------|
103
- | 添加新功能 | feat |
104
- | 修复错误 | fix |
105
- | 更新文档 | docs |
106
- | 重构代码 | refactor |
107
- | 优化性能 | perf |
108
- | 添加测试 | test |
297
+ ```
298
+ <Subject line>
299
+
300
+ <Blank line>
109
301
 
110
- ### 检查清单
302
+ Why:
303
+ - Reason 1
304
+ - Reason 2
111
305
 
112
- - [ ] 类型正确
113
- - [ ] 主题简洁(50 字符内)
114
- - [ ] 使用祈使句
115
- - [ ] 正文说明"为什么"
116
- - [ ] 引用相关 issue
306
+ What:
307
+ - Change 1
308
+ - Change 2
309
+
310
+ Notes:
311
+ - Context or considerations
312
+ ```
313
+
314
+ ### 示例
315
+
316
+ #### 示例 1:带背景的新功能
317
+
318
+ ```
319
+ feat(payment): Add support for PayPal payment method
320
+
321
+ Why this change is needed:
322
+ - Customer survey shows 40% prefer PayPal
323
+ - Competitor analysis indicates missing payment option
324
+ - Q4 goal to increase payment method diversity
325
+
326
+ What this change does:
327
+ - Integrate PayPal SDK v2.0
328
+ - Add PayPal button to checkout page
329
+ - Implement webhook for payment confirmation
330
+ - Update payment history to show PayPal transactions
331
+
332
+ Technical notes:
333
+ - Used sandbox environment for testing
334
+ - Webhook signature validation implemented for security
335
+ ```
336
+
337
+ #### 示例 2:带根本原因的错误修复
338
+
339
+ ```
340
+ fix(api): Resolve race condition in concurrent user updates
341
+
342
+ Why this occurred:
343
+ - Two simultaneous PUT requests to /users/:id could overwrite each other
344
+ - No optimistic locking or transaction isolation implemented
345
+ - Last write wins, causing data loss
346
+
347
+ What this fix does:
348
+ - Add version field to User model
349
+ - Implement optimistic locking check
350
+ - Return 409 Conflict if version mismatch
351
+ - Update API documentation with retry guidance
352
+
353
+ Testing:
354
+ - Added concurrent update test scenarios
355
+ - Verified with load test (100 concurrent updates)
356
+ ```
117
357
 
118
358
  ---
119
359
 
120
- ## 自定义引用 Footer
360
+ ## Footer
361
+
362
+ ### Issue 引用
121
363
 
122
- 当 commit 关联到规格文档或外部追踪系统时,在 footer 使用一致的前缀:
364
+ 将提交关联到 Issue 追踪系统:
365
+
366
+ ```
367
+ Closes #123
368
+ Fixes #456
369
+ Resolves #789
370
+ Refs #101, #102
371
+ See also #999
372
+ ```
373
+
374
+ **支持的关键字**(GitHub、GitLab、Bitbucket):
375
+
376
+ - `Closes`、`Fixes`、`Resolves`:自动关闭 Issue
377
+ - `Refs`、`References`、`See also`:仅建立关联而不关闭
378
+
379
+ ### 自定义引用 Footer
380
+
381
+ 当提交关联到规格、设计文档或外部追踪系统时,在页脚中使用一致的前缀进行引用:
123
382
 
124
383
  ```
125
384
  Refs: <PREFIX>-<ID>
126
385
  ```
127
386
 
387
+ **按项目类型的常见前缀**:
388
+
128
389
  | 前缀 | 使用场景 | 示例 |
129
- |------|---------|------|
390
+ |--------|----------|---------|
130
391
  | `SPEC-` | 规格驱动开发 | `Refs: SPEC-042` |
131
392
  | `JIRA-` | Jira 工单 | `Refs: JIRA-1234` |
132
393
  | `FEATURE-` | 内部功能追踪 | `Refs: FEATURE-001` |
133
394
  | `RFC-` | 提案文档 | `Refs: RFC-012` |
134
395
 
135
- 选择符合项目追踪系统的前缀并一致使用。
396
+ **示例**:
397
+
398
+ ```
399
+ feat(auth): Add OAuth2 login support
400
+
401
+ Implement OAuth2 authentication flow.
402
+
403
+ Refs: SPEC-042
404
+ Closes #123
405
+ ```
406
+
407
+ 选择与您项目追踪系统相符的前缀并保持一致使用。
408
+
409
+ ---
410
+
411
+ ### 破坏性变更
412
+
413
+ **关键要求**:务必在页脚中记录破坏性变更并提供迁移指引。
414
+
415
+ **要求**:
416
+ 1. 在页脚中使用 `BREAKING CHANGE:` 前缀
417
+ 2. 描述变更了什么以及为什么变更
418
+ 3. **必须**包含带有可操作步骤的迁移指南
419
+ 4. 尽可能包含变更前/变更后示例
420
+
421
+ **格式**:
422
+
423
+ ```
424
+ BREAKING CHANGE: <description>
425
+
426
+ Migration guide:
427
+ - Step 1: <specific action>
428
+ - Step 2: <specific action>
429
+ ```
430
+
431
+ > **为什么必须提供迁移指南**:没有迁移路径的破坏性变更会令用户受挫并延缓采用。每个破坏性变更都必须明确告知用户该怎么做。
432
+
433
+ **示例**:
434
+
435
+ ```
436
+ feat(api): Change user endpoint response format
437
+
438
+ - Flatten nested user object structure
439
+ - Remove deprecated `legacy_id` field
440
+ - Add `created_at` and `updated_at` timestamps
441
+
442
+ BREAKING CHANGE: User API response format changed
443
+
444
+ Old format:
445
+ ```json
446
+ {
447
+ "data": {
448
+ "user": {
449
+ "id": 123,
450
+ "name": "John",
451
+ "legacy_id": 456
452
+ }
453
+ }
454
+ }
455
+ ```
456
+
457
+ New format:
458
+
459
+ ```json
460
+ {
461
+ "id": 123,
462
+ "name": "John",
463
+ "created_at": "2025-11-12T10:00:00Z",
464
+ "updated_at": "2025-11-12T10:00:00Z"
465
+ }
466
+ ```
467
+
468
+ Migration guide:
469
+
470
+ - Update API clients to remove `.data` wrapper
471
+ - Remove references to `legacy_id` field
472
+ - Use `created_at` instead of `createdAt` (snake_case)
473
+
474
+ Closes #234
475
+
476
+ ```
477
+
478
+ ---
479
+
480
+ ## 完整示例
481
+
482
+ ### 示例 1:简单修复(英文)
483
+
484
+ ```
485
+
486
+ fix(auth): Correct JWT expiration time calculation
487
+
488
+ The token was expiring 1 hour early due to timezone offset not being accounted for. Now using UTC time consistently.
489
+
490
+ Fixes #445
491
+
492
+ ```
493
+
494
+ ---
495
+
496
+ ### 示例 2:包含多个部分的功能(英文)
497
+
498
+ ```
499
+
500
+ feat(export): Add CSV export functionality for user data
501
+
502
+ Why this feature is needed:
503
+
504
+ - Admins need to export user lists for compliance audits
505
+ - Manual copy-paste from UI is error-prone
506
+ - Requested by legal and compliance teams
507
+
508
+ What this implements:
509
+
510
+ - New `/api/users/export` endpoint
511
+ - CSV generation using csv-writer library
512
+ - Streaming response to handle large datasets
513
+ - Date range filtering options
514
+ - Column selection (PII vs non-PII fields)
515
+
516
+ Technical notes:
517
+
518
+ - Streaming prevents memory issues with 100k+ users
519
+ - Export limited to admin role only
520
+ - PII fields require additional permission flag
521
+ - Rate limited to prevent abuse
522
+
523
+ Closes #567
524
+ Refs #234 (related compliance requirement)
525
+
526
+ ```
527
+
528
+ ---
529
+
530
+ ### 示例 3:双语模式 - 简单修复
531
+
532
+ ```
533
+
534
+ fix(auth): Correct JWT expiration time calculation. 修正 JWT 過期時間計算。
535
+
536
+ The token was expiring 1 hour early due to timezone offset not being accounted for. Now using UTC time consistently.
537
+
538
+ 權杖因未考慮時區偏移而提早 1 小時過期。現已統一使用 UTC 時間。
539
+
540
+ Fixes #445
541
+
542
+ ```
543
+
544
+ ---
545
+
546
+ ### 示例 4:双语模式 - 功能
547
+
548
+ ```
549
+
550
+ feat(export): Add CSV export functionality for user data. 新增使用者資料 CSV 匯出功能。
551
+
552
+ Why this feature is needed:
553
+
554
+ - Admins need to export user lists for compliance audits
555
+ - Manual copy-paste from UI is error-prone
556
+ - Requested by legal and compliance teams
557
+
558
+ What this implements:
559
+
560
+ - New `/api/users/export` endpoint
561
+ - CSV generation using csv-writer library
562
+ - Streaming response to handle large datasets
563
+ - Date range filtering options
564
+
565
+ Technical notes:
566
+
567
+ - Streaming prevents memory issues with 100k+ users
568
+ - Export limited to admin role only
569
+
570
+ 為何需要此功能:
571
+
572
+ - 管理員需匯出使用者清單以進行合規稽核
573
+ - 從 UI 手動複製貼上容易出錯
574
+ - 法務與合規團隊要求此功能
575
+
576
+ 此變更實作內容:
577
+
578
+ - 新增 `/api/users/export` 端點
579
+ - 使用 csv-writer 函式庫生成 CSV
580
+ - 串流回應以處理大型資料集
581
+ - 日期範圍篩選選項
582
+
583
+ 技術備註:
584
+
585
+ - 串流處理可避免 10 萬筆以上使用者的記憶體問題
586
+ - 匯出功能僅限管理員角色使用
587
+
588
+ Closes #567
589
+ Refs #234
590
+
591
+ ```
592
+
593
+ ---
594
+
595
+ ### 示例 5:双语模式 - 包含根本原因的错误修复
596
+
597
+ ```
598
+
599
+ fix(api): Resolve race condition in concurrent user updates. 解決並發使用者更新的競爭條件。
600
+
601
+ Why this occurred:
602
+
603
+ - Two simultaneous PUT requests to /users/:id could overwrite each other
604
+ - No optimistic locking implemented
605
+
606
+ What this fix does:
607
+
608
+ - Add version field to User model
609
+ - Implement optimistic locking check
610
+ - Return 409 Conflict if version mismatch
611
+
612
+ Testing:
613
+
614
+ - Added concurrent update test scenarios
615
+ - Verified with load test (100 concurrent updates)
616
+
617
+ 問題發生原因:
618
+
619
+ - 兩個同時發送至 /users/:id 的 PUT 請求可能互相覆蓋
620
+ - 未實作樂觀鎖定機制
621
+
622
+ 修正內容:
623
+
624
+ - 新增版本欄位至 User 模型
625
+ - 實作樂觀鎖定檢查
626
+ - 版本不符時回傳 409 Conflict
627
+
628
+ 測試:
629
+
630
+ - 新增並發更新測試情境
631
+ - 以負載測試驗證(100 個並發更新)
632
+
633
+ Fixes #789
634
+
635
+ ```
636
+
637
+ ---
638
+
639
+ ### 示例 6:包含破坏性变更的重构(英文)
640
+
641
+ ```
642
+
643
+ refactor(database): Migrate from MySQL to PostgreSQL
644
+
645
+ Why this refactoring:
646
+
647
+ - PostgreSQL offers better JSON support for our use case
648
+ - Need advanced indexing features for full-text search
649
+ - Licensing considerations for cloud deployment
650
+
651
+ What this changes:
652
+
653
+ - Update database driver from mysql2 to pg
654
+ - Convert MySQL-specific queries to PostgreSQL syntax
655
+ - Update connection pooling configuration
656
+ - Migrate schema using migration scripts
657
+ - Update ORM configurations
658
+
659
+ Migration:
660
+
661
+ - Run `npm run db:backup` before upgrading
662
+ - Run `npm run db:migrate` to apply schema changes
663
+ - Update environment variables (see .env.example)
664
+
665
+ BREAKING CHANGE: Database engine changed from MySQL to PostgreSQL
666
+
667
+ Migration guide:
668
+
669
+ 1. Backup existing MySQL database
670
+ 2. Install PostgreSQL 15+
671
+ 3. Update .env:
672
+ - DATABASE_URL=postgresql://... (was mysql://...)
673
+ - Remove MYSQL_* variables
674
+ 4. Run migration: npm run db:migrate
675
+ 5. Verify data integrity: npm run db:verify
676
+
677
+ Estimated downtime: 2-4 hours for production migration
678
+
679
+ Closes #890
680
+
681
+ ```
682
+
683
+ ---
684
+
685
+ ### 示例 7:双语模式 - 破坏性变更
686
+
687
+ ```
688
+
689
+ refactor(database): Migrate from MySQL to PostgreSQL. 從 MySQL 遷移至 PostgreSQL。
690
+
691
+ Why this refactoring:
692
+
693
+ - PostgreSQL offers better JSON support for our use case
694
+ - Need advanced indexing features for full-text search
695
+
696
+ What this changes:
697
+
698
+ - Update database driver from mysql2 to pg
699
+ - Convert MySQL-specific queries to PostgreSQL syntax
700
+ - Update connection pooling configuration
701
+
702
+ BREAKING CHANGE: Database engine changed from MySQL to PostgreSQL
703
+
704
+ Migration guide:
705
+
706
+ 1. Backup existing MySQL database
707
+ 2. Install PostgreSQL 15+
708
+ 3. Update .env: DATABASE_URL=postgresql://...
709
+ 4. Run migration: npm run db:migrate
710
+ 5. Verify data integrity: npm run db:verify
711
+
712
+ Estimated downtime: 2-4 hours
713
+
714
+ 重構原因:
715
+
716
+ - PostgreSQL 提供更佳的 JSON 支援以符合我們的使用情境
717
+ - 需要進階索引功能支援全文檢索
718
+
719
+ 變更內容:
720
+
721
+ - 更新資料庫驅動從 mysql2 至 pg
722
+ - 將 MySQL 專用查詢轉換為 PostgreSQL 語法
723
+ - 更新連線池設定
724
+
725
+ 破壞性變更: 資料庫引擎從 MySQL 變更為 PostgreSQL
726
+
727
+ 遷移指南:
728
+
729
+ 1. 備份現有 MySQL 資料庫
730
+ 2. 安裝 PostgreSQL 15+
731
+ 3. 更新 .env 設定: DATABASE_URL=postgresql://...
732
+ 4. 執行遷移腳本: npm run db:migrate
733
+ 5. 驗證資料完整性: npm run db:verify
734
+
735
+ 預估停機時間: 2-4 小時
736
+
737
+ Closes #890
738
+
739
+ ```
740
+
741
+ ---
742
+
743
+ ## 反模式
744
+
745
+ ### ❌ 反模式 1:模糊不清的消息
746
+
747
+ ```
748
+
749
+ fix: bug fix
750
+ refactor: code improvements
751
+ update: changes
752
+
753
+ ```
754
+
755
+ **问题**:缺乏上下文,不阅读代码就无法理解。
756
+
757
+ **✅ 修复**:
758
+ ```
759
+
760
+ fix(login): Prevent duplicate session creation on rapid clicks
761
+ refactor(utils): Extract email validation regex to constants
762
+ feat(profile): Add avatar upload with image compression
763
+
764
+ ```
765
+
766
+ ---
767
+
768
+ ### ❌ 反模式 2:混合多个关注点
769
+
770
+ ```
771
+
772
+ feat: add login, fix bugs, refactor database, update docs
773
+
774
+ ```
775
+
776
+ **问题**:为了便于审查与回滚,应拆分为独立的提交。
777
+
778
+ **✅ 修复**:拆分为独立的提交:
779
+ ```
780
+
781
+ feat(auth): Add OAuth2 login support
782
+ fix(api): Resolve null pointer in user lookup
783
+ refactor(database): Extract connection pool to separate module
784
+ docs(api): Update authentication endpoint documentation
785
+
786
+ ```
787
+
788
+ ---
789
+
790
+ ### ❌ 反模式 3:将提交消息当作代码注释
791
+
792
+ ```
793
+
794
+ fix: change line 45 from getUserById to getUserByEmail because the function was renamed
795
+
796
+ ```
797
+
798
+ **问题**:过于关注实现细节而非意图。
799
+
800
+ **✅ 修复**:
801
+ ```
802
+
803
+ fix(api): Use correct user lookup method in password reset
804
+
805
+ The password reset flow was calling getUserById with an email parameter,
806
+ causing lookups to fail. Now correctly calls getUserByEmail.
807
+
808
+ Fixes #789
809
+
810
+ ```
811
+
812
+ ---
813
+
814
+ ### ❌ 反模式 4:复杂变更未提供正文
815
+
816
+ ```
817
+
818
+ refactor(database): migrate to PostgreSQL
819
+
820
+ ```
821
+
822
+ **问题**:破坏性变更未提供迁移指南或上下文。
823
+
824
+ **✅ 修复**:添加包含上下文和迁移指南的正文(参见上文示例 6)。
825
+
826
+ ---
827
+
828
+ ## 自动化与工具链
829
+
830
+ ### 提交消息检查工具(Linters)
831
+
832
+ **commitlint** (Node.js):
833
+ ```bash
834
+ npm install --save-dev @commitlint/{cli,config-conventional}
835
+
836
+ # .commitlintrc.js
837
+ module.exports = {
838
+ extends: ['@commitlint/config-conventional']
839
+ };
840
+ ```
841
+
842
+ **Git Hook**(在提交时强制执行):
843
+
844
+ ```bash
845
+ # .git/hooks/commit-msg
846
+ #!/bin/sh
847
+ npx commitlint --edit $1
848
+ ```
849
+
850
+ ---
851
+
852
+ ### 变更日志生成
853
+
854
+ **standard-version** (Node.js):
855
+
856
+ ```bash
857
+ npm install --save-dev standard-version
858
+
859
+ # package.json
860
+ {
861
+ "scripts": {
862
+ "release": "standard-version"
863
+ }
864
+ }
865
+
866
+ # Generates CHANGELOG.md from commits
867
+ npm run release
868
+ ```
869
+
870
+ **git-chglog** (Go):
871
+
872
+ ```bash
873
+ git-chglog --output CHANGELOG.md
874
+ ```
875
+
876
+ ---
877
+
878
+ ## 项目配置模板
879
+
880
+ 添加到 `CONTRIBUTING.md`:
881
+
882
+ ```markdown
883
+ ## Commit Message Format
884
+
885
+ ### Type Language
886
+ This project uses **[English / Traditional Chinese / Bilingual]** commit types.
887
+
888
+ ### Allowed Types
889
+ - feat: New features
890
+ - fix: Bug fixes
891
+ - refactor: Code refactoring
892
+ - docs: Documentation
893
+ - test: Tests
894
+ - perf: Performance improvements
895
+ - build: Build system
896
+ - ci: CI/CD changes
897
+ - chore: Maintenance
898
+ - security: Security fixes
899
+
900
+ ### Allowed Scopes
901
+ - auth: Authentication module
902
+ - api: API layer
903
+ - ui: User interface
904
+ - database: Database layer
905
+ - [add your project-specific scopes]
906
+
907
+ ### Subject Language
908
+ Commit subject lines should be in **[English/繁體中文/Bilingual]**.
909
+
910
+ ### Examples
911
+
912
+ **English**:
913
+ ```
914
+
915
+ feat(auth): Add OAuth2 support
916
+ fix(api): Resolve memory leak
917
+
918
+ ```
919
+
920
+ **Bilingual Mode** (English first, Chinese follows):
921
+ ```
922
+
923
+ feat(auth): Add OAuth2 support. 新增 OAuth2 支援。
924
+
925
+ Implement OAuth2 authentication flow.
926
+
927
+ 實作 OAuth2 認證流程。
928
+
929
+ Closes #123
930
+
931
+ ```
932
+
933
+ ```
136
934
 
137
935
  ---
138
936
 
139
937
  ## 相关标准
140
938
 
141
- - [Git 工作流程](git-workflow.md)
142
- - [代码审查指南](code-review-checklist.md)
939
+ - [Git 工作流程标准](git-workflow.md)
940
+ - [代码签入标准](checkin-standards.md)
941
+ - [变更日志标准](changelog-standards.md)
942
+ - [版本控制标准](versioning.md)
943
+
944
+ ---
945
+
946
+ ## 版本历史
947
+
948
+ | 版本 | 日期 | 变更 |
949
+ | ------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
950
+ | 1.4.0 | 2026-10-12 | 变更:选项 B(繁体中文)采用英文类型配合繁体中文主题与正文;不再允许使用中文类型(新增、修正……)(XSPEC-475 OQ1)。新增迁移对照表 |
951
+ | 1.3.0 | 2026-03-16 | 新增:规格引用页脚规范(Refs: SPEC-XXX) |
952
+ | 1.2.3 | 2025-12-24 | 新增:相关标准章节 |
953
+ | 1.2.2 | 2025-12-16 | 新增:语言选择指南,包含决策矩阵与快速选择建议 |
954
+ | 1.2.1 | 2025-12-09 | 改进选项 A/B/C 的格式一致性:统一标题样式,补充说明文本 |
955
+ | 1.2.0 | 2025-12-05 | 修复选项 B 的类型映射(chore→维护);新增 security 类型;新增 scope 命名规则;阐明双语末尾句号例外规则;改进模板 |
956
+ | 1.1.0 | 2025-12-05 | 新增双语模式(选项 C)及示例 |
957
+ | 1.0.0 | 2025-11-12 | 初始指南发布 |
958
+
959
+ ---
960
+
961
+ ## 参考资料
962
+
963
+ - [Conventional Commits](https://www.conventionalcommits.org/)
964
+ - [Angular Commit Guidelines](https://github.com/angular/angular/blob/main/CONTRIBUTING.md#commit)
965
+ - [Semantic Versioning](https://semver.org/)
143
966
 
144
967
  ---
145
968
 
146
969
  ## 许可证
147
970
 
148
- 本标准采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 发布。
971
+ 本指南采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 发布。