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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (688) hide show
  1. package/README.md +13 -3
  2. package/bin/uds.js +75 -3
  3. package/bundled/ai/options/code-review/pr-review.ai.yaml +20 -1
  4. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  5. package/bundled/ai/standards/ai-response-navigation.ai.yaml +43 -3
  6. package/bundled/ai/standards/checkin-standards.ai.yaml +25 -6
  7. package/bundled/ai/standards/code-review.ai.yaml +15 -2
  8. package/bundled/ai/standards/commit-message.ai.yaml +18 -4
  9. package/bundled/ai/standards/developer-memory.ai.yaml +12 -2
  10. package/bundled/ai/standards/full-coverage-testing.ai.yaml +86 -7
  11. package/bundled/ai/standards/open-work-tracking.ai.yaml +196 -11
  12. package/bundled/ai/standards/pipeline-security-gates.ai.yaml +53 -4
  13. package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
  14. package/bundled/core/ai-response-navigation.md +128 -12
  15. package/bundled/core/code-review-checklist.md +20 -2
  16. package/bundled/core/commit-message-guide.md +22 -19
  17. package/bundled/core/developer-memory.md +12 -2
  18. package/bundled/core/full-coverage-testing.md +99 -5
  19. package/bundled/core/open-work-tracking.md +157 -17
  20. package/bundled/core/pipeline-security-gates.md +63 -0
  21. package/bundled/core/project-context-memory.md +10 -2
  22. package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
  23. package/bundled/extensions/languages/csharp-style.md +464 -0
  24. package/bundled/extensions/languages/php-style.md +700 -0
  25. package/bundled/extensions/locales/zh-cn.md +717 -0
  26. package/bundled/extensions/locales/zh-tw.md +717 -0
  27. package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
  28. package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
  29. package/bundled/locales/COVERAGE.md +5 -4
  30. package/bundled/locales/zh-CN/CHANGELOG.md +199 -3
  31. package/bundled/locales/zh-CN/README.md +3 -3
  32. package/bundled/locales/zh-CN/SECURITY.md +3 -2
  33. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  34. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
  35. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  36. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
  37. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
  38. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
  39. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
  40. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  41. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  42. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  43. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  44. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  45. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  46. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  47. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  48. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  49. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  50. package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
  51. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  52. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  53. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  54. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  55. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  56. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  57. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  58. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  59. package/bundled/locales/zh-CN/core/code-review-checklist.md +54 -23
  60. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  61. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  62. package/bundled/locales/zh-CN/core/developer-memory.md +159 -60
  63. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  64. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  65. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  66. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  67. package/bundled/locales/zh-CN/core/full-coverage-testing.md +103 -9
  68. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  69. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  70. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  71. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  72. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  73. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  74. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  75. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  76. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  77. package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
  78. package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
  79. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  80. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  81. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  82. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  83. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  84. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  85. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  86. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  87. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  88. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  89. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  90. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  91. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  92. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  93. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  94. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  95. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  96. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  97. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  98. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  99. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  100. package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
  101. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +9 -3
  102. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  103. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +68 -33
  104. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +29 -15
  105. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  106. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
  107. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  108. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
  109. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  110. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  111. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +46 -0
  112. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  113. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  114. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  115. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  116. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  117. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  118. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  119. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  120. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  121. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  122. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  123. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  124. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  125. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  126. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  127. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  128. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  129. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  130. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  131. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  132. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  133. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  134. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  135. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  136. package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
  137. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  138. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  139. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  140. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  141. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  142. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  143. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  144. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  145. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  146. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  147. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  148. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  149. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  150. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  151. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  152. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  153. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  154. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  155. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  156. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  157. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  158. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  159. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  160. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  161. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  162. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  163. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  164. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  165. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  166. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  167. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  168. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  169. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  170. package/bundled/locales/zh-CN/skills/README.md +3 -1
  171. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  172. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  173. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  174. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  175. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  176. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  177. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  178. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  179. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  180. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  181. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  182. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  183. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  184. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  185. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  186. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  187. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  188. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  189. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  190. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  191. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  192. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  193. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  194. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  195. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  196. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  197. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  198. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  199. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  200. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  201. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  202. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  203. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  204. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  205. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  206. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  207. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  208. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  209. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  210. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  211. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  212. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  213. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  214. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  215. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  216. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  217. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  218. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  219. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  220. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  221. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  222. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  223. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  224. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  225. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  226. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  227. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  228. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  229. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  230. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  231. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  232. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  233. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  234. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  235. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  236. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  237. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  238. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  239. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  240. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  241. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  242. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  243. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  244. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  245. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -2
  246. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  247. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  248. package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
  249. package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
  250. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  251. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  252. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  253. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  254. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  255. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  256. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  257. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  258. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  259. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  260. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  261. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  262. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  263. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  264. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  265. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  266. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  267. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  268. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  269. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  270. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  271. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  272. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  273. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  274. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  275. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  276. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  277. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  278. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  279. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  280. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  281. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  282. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  283. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  284. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  285. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  286. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  287. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  288. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  289. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  290. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  291. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  292. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  293. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  294. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  295. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  296. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  297. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  298. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  299. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  300. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  301. package/bundled/locales/zh-TW/CHANGELOG.md +199 -3
  302. package/bundled/locales/zh-TW/README.md +3 -3
  303. package/bundled/locales/zh-TW/SECURITY.md +3 -2
  304. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  305. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
  306. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  307. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
  308. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
  309. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
  310. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
  311. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  312. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  313. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  314. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  315. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  316. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  317. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  318. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  319. package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
  320. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  321. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  322. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  323. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  324. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  325. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  326. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  327. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  328. package/bundled/locales/zh-TW/core/code-review-checklist.md +36 -7
  329. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  330. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  331. package/bundled/locales/zh-TW/core/developer-memory.md +111 -12
  332. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  333. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  334. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  335. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  336. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  337. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  338. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  339. package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
  340. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  341. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  342. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  343. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  344. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  345. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  346. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  347. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  348. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  349. package/bundled/locales/zh-TW/core/open-work-tracking.md +92 -16
  350. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  351. package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
  352. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  353. package/bundled/locales/zh-TW/core/project-context-memory.md +215 -31
  354. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  355. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  356. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  357. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  358. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  359. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  360. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  361. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  362. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  363. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  364. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  365. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  366. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  367. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  368. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  369. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  370. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  371. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  372. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  373. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  374. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  375. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  376. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  377. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  378. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  379. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  380. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  381. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  382. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  383. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  384. package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
  385. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +9 -3
  386. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  387. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +61 -26
  388. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  389. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +29 -15
  390. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  391. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
  392. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  393. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
  394. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  395. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  396. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +46 -0
  397. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  398. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  399. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  400. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  401. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  402. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  403. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  404. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  405. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  406. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  407. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  408. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  409. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  410. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  411. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  412. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  413. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  414. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  415. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  416. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  417. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  418. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  419. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  420. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  421. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  422. package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
  423. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  424. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  425. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  426. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  427. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  428. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  429. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  430. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  431. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  432. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  433. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  434. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  435. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  436. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  437. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  438. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  439. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  440. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  441. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  442. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  443. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  444. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  445. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  446. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  447. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  448. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  449. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  450. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  451. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  452. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  453. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  454. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  455. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  456. package/bundled/locales/zh-TW/skills/README.md +3 -1
  457. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  458. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  459. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  460. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  461. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  462. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  463. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  464. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  465. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  466. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  467. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  468. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  469. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  470. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  471. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  472. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  473. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  474. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  475. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  476. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  477. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  478. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  479. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  480. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  481. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  482. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  483. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  484. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  485. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  486. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  487. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  488. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  489. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  490. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  491. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  492. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  493. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  494. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  495. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  496. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  497. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  498. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  499. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  500. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  501. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  502. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  503. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  504. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  505. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  506. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  507. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  508. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  509. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  510. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  511. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  512. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  513. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  514. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  515. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  516. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  517. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  518. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  519. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  520. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  521. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  522. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  523. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  524. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  525. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  526. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  527. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  528. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  529. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  530. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  531. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  532. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  533. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  534. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  535. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  536. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  537. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  538. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  539. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  540. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  541. package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
  542. package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
  543. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  544. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  545. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  546. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  547. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  548. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  549. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  550. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  551. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  552. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  553. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  554. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  555. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  556. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  557. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  558. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  559. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  560. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  561. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  562. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  563. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  564. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  565. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  566. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  567. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  568. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  569. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  570. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  571. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  572. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  573. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  574. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  575. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  576. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  577. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  578. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  579. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  580. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  581. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  582. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  583. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  584. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  585. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  586. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  587. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  588. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  589. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  590. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  591. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  592. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  593. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  594. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  595. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  596. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  597. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  598. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  599. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  600. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  601. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  602. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  603. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  604. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  605. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  606. package/bundled/skills/README.md +1 -0
  607. package/bundled/skills/SKILL_NAMING.md +9 -0
  608. package/bundled/skills/commit-standards/SKILL.md +2 -2
  609. package/bundled/skills/commit-standards/guide.md +3 -2
  610. package/bundled/skills/commit-standards/language-options.md +19 -17
  611. package/bundled/skills/comprehension-ladder/SKILL.md +283 -0
  612. package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
  613. package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
  614. package/bundled/templates/gates/check-stubs.mjs +644 -0
  615. package/package.json +5 -3
  616. package/src/commands/audit.js +20 -2
  617. package/src/commands/check.js +155 -28
  618. package/src/commands/deps.js +31 -1
  619. package/src/commands/hitl.js +3 -0
  620. package/src/commands/init.js +159 -48
  621. package/src/commands/list.js +12 -3
  622. package/src/commands/mcp.js +2 -3
  623. package/src/commands/open-work.js +123 -0
  624. package/src/commands/quickstart.js +29 -13
  625. package/src/commands/release.js +102 -19
  626. package/src/commands/run-intent.js +10 -0
  627. package/src/commands/simulate.js +20 -8
  628. package/src/commands/skills.js +59 -33
  629. package/src/commands/spec-split.js +30 -17
  630. package/src/commands/spec.js +55 -21
  631. package/src/commands/uninstall.js +146 -32
  632. package/src/commands/update.js +471 -93
  633. package/src/core/install-records.js +192 -0
  634. package/src/core/manifest.js +12 -10
  635. package/src/core/marketplace-sentinel.js +5 -0
  636. package/src/core/open-work-config.js +122 -0
  637. package/src/core/project-config.js +92 -38
  638. package/src/flows/init-flow.js +10 -0
  639. package/src/hitl/manager.js +4 -2
  640. package/src/i18n/messages.js +413 -78
  641. package/src/installers/hooks-installer.js +236 -27
  642. package/src/installers/integration-installer.js +5 -1
  643. package/src/installers/skills-installer.js +3 -1
  644. package/src/installers/standards-installer.js +16 -23
  645. package/src/mcp/__tests__/server.test.js +0 -1
  646. package/src/mcp/server.js +16 -4
  647. package/src/prompts/init.js +148 -13
  648. package/src/reconciler/backup-locations.js +80 -0
  649. package/src/reconciler/backup-manager.js +451 -123
  650. package/src/reconciler/index.js +86 -10
  651. package/src/reconciler/install-roots.js +90 -0
  652. package/src/reconciler/plan-executor.js +37 -15
  653. package/src/uninstallers/hook-uninstaller.js +220 -33
  654. package/src/uninstallers/integration-uninstaller.js +35 -5
  655. package/src/uninstallers/skills-uninstaller.js +95 -16
  656. package/src/uninstallers/standards-uninstaller.js +56 -7
  657. package/src/utils/agents-installer.js +10 -17
  658. package/src/utils/available-standards-report.js +144 -0
  659. package/src/utils/available-standards.js +216 -0
  660. package/src/utils/command-hash-ownership.js +103 -0
  661. package/src/utils/commit-message-judge.js +155 -0
  662. package/src/utils/copier.js +80 -2
  663. package/src/utils/deps-applicability.js +25 -0
  664. package/src/utils/detector.js +46 -1
  665. package/src/utils/friction-detector.js +27 -0
  666. package/src/utils/gate-scripts.js +141 -0
  667. package/src/utils/git-hooks.js +139 -7
  668. package/src/utils/hasher.js +36 -0
  669. package/src/utils/health-scorer.js +10 -7
  670. package/src/utils/installed-names-ownership.js +114 -0
  671. package/src/utils/integration-generator.js +36 -24
  672. package/src/utils/legacy-hook-migration.js +112 -0
  673. package/src/utils/locale.js +19 -0
  674. package/src/utils/open-work-tracking.mjs +1754 -0
  675. package/src/utils/prompt-closed.js +18 -0
  676. package/src/utils/sdd-header.js +66 -0
  677. package/src/utils/skill-frontmatter.js +102 -0
  678. package/src/utils/skill-hash-ownership.js +64 -0
  679. package/src/utils/skill-name-collision.js +169 -0
  680. package/src/utils/skills-install-paths.js +114 -0
  681. package/src/utils/skills-installer.js +75 -106
  682. package/src/utils/standard-validator.js +98 -27
  683. package/src/utils/test-change-check.js +160 -0
  684. package/src/utils/test-policy.js +214 -0
  685. package/src/utils/transient-fs.js +113 -0
  686. package/src/utils/update-summary.js +29 -0
  687. package/src/vibe/micro-spec.js +15 -0
  688. package/standards-registry.json +48 -9
@@ -1,18 +1,22 @@
1
1
  ---
2
2
  source: ../../../core/code-review-checklist.md
3
- source_version: 1.3.0
4
- translation_version: 1.3.0
5
- last_synced: 2026-01-12
6
- status: stale
3
+ source_version: 1.6.0
4
+ translation_version: 1.6.0
5
+ last_synced: 2026-10-11
6
+ source_hash: 405318729fc5
7
+ status: current
7
8
  ---
8
9
 
9
10
  # 程式碼審查檢查清單
10
11
 
11
12
  > **語言**: [English](../../../core/code-review-checklist.md) | 繁體中文
12
13
 
13
- **版本**: 1.3.0
14
- **最後更新**: 2026-01-12
14
+ **版本**: 1.6.0
15
+ **最後更新**: 2026-10-08
15
16
  **適用範圍**: 所有進行程式碼審查的軟體專案
17
+ **範圍**: universal
18
+ **業界標準**: SWEBOK v4.0 第 10 章
19
+ **參考資料**: [google.github.io](https://google.github.io/eng-practices/review/)
16
20
 
17
21
  ---
18
22
 
@@ -146,6 +150,7 @@ status: stale
146
150
  - Test names describe scenarios
147
151
  - Assertions are clear
148
152
  - No flaky tests
153
+ - 預期值獨立於被測程式碼:字面值、手算例或規格——不是同一個呼叫再寫一次,也不是同一套算式再打一遍(見[禁止:恆真斷言](full-coverage-testing.md))
149
154
 
150
155
  - [ ] **測試覆蓋率維持**
151
156
  - Coverage not decreased
@@ -252,6 +257,19 @@ status: stale
252
257
 
253
258
  ---
254
259
 
260
+ ### 11. 合併風險(可逆性)
261
+
262
+ - [ ] **變更寫明了它的門與影響範圍**
263
+ - **雙向門**:合併後能輕鬆退回
264
+ - **單向門**:無法退回或很難退回——資料遷移、刪除、預設行為改變、結束碼改變、對外介面改名
265
+ - **影響範圍**:用一個詞說明波及多遠(例如 `docs`、`cli`、`adopters`)
266
+
267
+ - [ ] **單向門在合併前已讓決策者知情**
268
+ - 決定要不要合併的人,已在 PR 描述或交件報告中被告知這個變更無法輕易退回
269
+ - 欄位缺漏時,請對方補上;不要只憑差異內容推測是哪一種門
270
+
271
+ ---
272
+
255
273
  ## 審查評論類型
256
274
 
257
275
  Use these prefixes to clarify comment intent:
@@ -325,6 +343,7 @@ Is there a specific reason for this approach?
325
343
  1. Read PR description and linked issues
326
344
  2. Understand WHY the change is needed
327
345
  3. Review design/spec documents if linked
346
+ 4. 閱讀「合併風險」欄(門與影響範圍);若是單向門,確認決策者在合併前已知情
328
347
 
329
348
  #### Step 2: 高層級審查
330
349
 
@@ -362,6 +381,7 @@ Is there a specific reason for this approach?
362
381
  2. **本地執行測試**
363
382
  3. **檢查 CI 狀態**
364
383
  4. **撰寫清楚的 PR 描述**
384
+ 5. **寫明合併風險**——門(雙向或單向)與影響範圍,一個詞
365
385
 
366
386
  #### 審查期間
367
387
 
@@ -483,6 +503,12 @@ jobs:
483
503
  | 200-500 lines | 1 day | 2 days |
484
504
  | > 500 lines | 🚨 Consider splitting | 3+ days |
485
505
 
506
+ > **來源與可設定性**:PR 大小分級反映實證觀察到的現象——變更超過約 200–400 行後,
507
+ > 審查成效明顯下降(SmartBear/Cisco 程式碼審查研究;
508
+ > [Google engineering practices](https://google.github.io/eng-practices/review/))。
509
+ > 回應時間目標為 UDS 預設值——請替換為團隊自己的審查 SLA。
510
+ > **例外**:產生的或 vendored 的大量變更(lockfile、migration、snapshot)以抽查方式審查,不以行數計。
511
+
486
512
  ### 審查者可用性
487
513
 
488
514
  - Set "review hours" in team calendar
@@ -648,6 +674,7 @@ All PRs must pass:
648
674
  │ ✓ Errors - Properly handled? │
649
675
  │ ✓ Docs - Updated? │
650
676
  │ ✓ Dependencies - Necessary? │
677
+ │ ✓ Merge danger - One-way door told? │
651
678
  └─────────────────────────────────────────┘
652
679
 
653
680
  Comment Prefixes:
@@ -664,6 +691,9 @@ Comment Prefixes:
664
691
 
665
692
  | Version | Date | Changes |
666
693
  |---------|------|---------|
694
+ | 1.6.0 | 2026-10-08 | 新增:合併風險(門與影響範圍)作為檢查項 11,並加入審查者/作者步驟——單向門須在合併前讓決策者知情;於「測試品質良好」新增預期值須獨立於被測程式碼(XSPEC-470 R1、R2) |
695
+ | 1.5.0 | 2026-08-24 | 新增:指向 `deferred-item-exit`,適用於本次未改而被接受的非阻斷留言(XSPEC-391 R5) |
696
+ | 1.4.0 | 2026-06-18 | 新增:PR 大小/回應時間門檻的來源與可設定性說明(SmartBear/Cisco 研究、Google 實務)及大量變更例外(XSPEC-292 T8) |
667
697
  | 1.3.0 | 2026-01-12 | 新增:完整重構 PR 段落,包含審查前檢查清單、審查重點、大型重構指南、警示信號及最佳實踐 |
668
698
  | 1.2.0 | 2026-01-05 | 新增:SWEBOK v4.0 第 10 章(軟體品質)至參考資料 |
669
699
  | 1.1.0 | 2025-12-22 | Added: Alternative text labels section for review comments (中文標籤支援) |
@@ -676,7 +706,6 @@ Comment Prefixes:
676
706
 
677
707
  ## 相關標準
678
708
 
679
- - [Refactoring Standards](refactoring-standards.md) - 重構標準(遺留程式碼策略、大規模模式、度量指標)
680
709
  - [Testing Standards](testing-standards.md) - 測試標準 (UT/IT/ST/E2E)(或使用 `/testing-guide` 技能)
681
710
  - [Code Check-in Standards](checkin-standards.md) - 程式碼簽入標準
682
711
  - [Commit Message Guide](commit-message-guide.md) - Commit 訊息規範
@@ -1,8 +1,9 @@
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-12
6
+ source_hash: 8bf9a79dc6d1
6
7
  status: current
7
8
  ---
8
9
 
@@ -10,9 +11,12 @@ status: current
10
11
 
11
12
  > **語言**: [English](../../../core/commit-message-guide.md) | 繁體中文
12
13
 
13
- **版本**: 1.2.3
14
- **最後更新**: 2025-12-24
14
+ **版本**: 1.4.0
15
+ **最後更新**: 2026-10-12
15
16
  **適用範圍**: 所有使用 Git 版本控制的專案
17
+ **範圍**: universal
18
+ **業界標準**: Conventional Commits 1.0.0
19
+ **參考資料**: [conventionalcommits.org](https://www.conventionalcommits.org/)
16
20
 
17
21
  ---
18
22
 
@@ -69,22 +73,24 @@ status: current
69
73
 
70
74
  ### 選項 B: 繁體中文(台灣團隊適用)
71
75
 
72
- 使用繁體中文類型,適合偏好母語提交的本地團隊。
73
-
74
- | 類型 | 使用時機 |
75
- | ------ | -------------------- |
76
- | `新增` | 新功能 |
77
- | `修正` | Bug 修復 |
78
- | `重構` | 重構(無功能變更) |
79
- | `文件` | 僅文件更新 |
80
- | `樣式` | 格式化(無邏輯變更) |
81
- | `測試` | 新增或更新測試 |
82
- | `效能` | 效能改進 |
83
- | `建置` | 建置系統或依賴 |
84
- | `整合` | CI/CD 管道變更 |
85
- | `維護` | 維護任務 |
86
- | `回退` | 回退先前提交 |
87
- | `安全` | 安全漏洞修復 |
76
+ 使用**選項 A 的英文類型**,主旨與本文使用繁體中文,適合偏好母語提交的本地團隊。類型維持英文,因為工具會讀它(commitlint `type-enum`、changelog 產生器、`uds simulate`);只有主旨與本文是中文。**不可**使用 `新增` 這類中文類型。
77
+
78
+ | 類型 | 使用時機 | 範例 |
79
+ | ---------- | -------------- | -------------------------------------- |
80
+ | `feat` | 新功能 | `feat(auth): 加入 OAuth2 登入` |
81
+ | `fix` | Bug 修復 | `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`)。
88
94
 
89
95
  ### 選項 C: 雙語對照模式(推薦)
90
96
 
@@ -122,6 +128,8 @@ Implement Google OAuth2 authentication flow for user login.
122
128
  Closes #123
123
129
  ```
124
130
 
131
+ > **注意**: 此設定在專案 manifest 中名為 `output_language`,同時控制 commit 訊息語言與文件語言。關於此設定如何影響文件,詳見 [documentation-writing-standards.md](documentation-writing-standards.md#documentation-language-configuration)。
132
+
125
133
  ### 語言選擇指南
126
134
 
127
135
  使用此指南為您的專案選擇適當的 commit 訊息語言:
@@ -154,7 +162,7 @@ Closes #123
154
162
  本專案使用**英文** commit 類型(feat, fix, refactor 等)
155
163
 
156
164
  <!-- 選項 B: 繁體中文 -->
157
- 本專案使用**繁體中文** commit 類型(新增、修正、重構等)
165
+ 本專案使用**英文** commit 類型(feat, fix, refactor 等),主旨與本文使用**繁體中文**
158
166
 
159
167
  <!-- 選項 C: 雙語對照模式 -->
160
168
  本專案使用**雙語對照模式**,type/scope 使用英文,subject/body 採用雙語對照。
@@ -221,16 +229,16 @@ database, config, middleware, api, tests, docs
221
229
  4. **無句點**: 結尾不加句點(例外:雙語模式使用句點作為分隔符)
222
230
  5. **語言**: 遵循專案政策(英文或母語)
223
231
 
224
- ### 繁體中文範例
232
+ ### 良好範例
225
233
 
226
234
  ```
227
- 新增(認證): 實作 OAuth2 Google 登入支援
228
- 修正(API): 解決使用者 session 快取記憶體洩漏
229
- 重構(資料庫): 提取查詢建構器為獨立類別
230
- 文件(README): 更新 Node 20 安裝說明
231
- 測試(付款): 新增退款流程單元測試
232
- 效能(搜尋): 實作全文檢索索引
233
- 建置(依賴): 升級 Express 至 4.18.2
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
234
242
  ```
235
243
 
236
244
  ### 不良範例
@@ -308,23 +316,43 @@ database, config, middleware, api, tests, docs
308
316
  #### 範例 1: 含上下文的功能
309
317
 
310
318
  ```
311
- 新增(通知): 實作電子郵件通知功能
319
+ feat(payment): Add support for PayPal payment method
312
320
 
313
- 為何需要此變更:
314
- - 使用者反饋希望收到訂單狀態更新通知
315
- - 減少客服查詢訂單狀態的工作量
316
- - 提升使用者體驗與滿意度
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
317
325
 
318
- 此變更做了什麼:
319
- - 整合 SendGrid API 發送電子郵件
320
- - 新增 EmailTemplate 模組管理郵件範本
321
- - 實作訂單狀態變更時觸發通知
322
- - 新增使用者偏好設定以控制通知開關
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
323
331
 
324
- 技術備註:
325
- - 使用佇列機制避免阻塞主流程
326
- - 郵件發送失敗會重試 3 次
327
- - 範本支援多語言(繁中、英文)
332
+ Technical notes:
333
+ - Used sandbox environment for testing
334
+ - Webhook signature validation implemented for security
335
+ ```
336
+
337
+ #### 範例 2: 含根因分析的 Bug 修正
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)
328
356
  ```
329
357
 
330
358
  ---
@@ -382,7 +410,13 @@ Closes #123
382
410
 
383
411
  ### 破壞性變更
384
412
 
385
- **重要**: 永遠在頁尾記錄破壞性變更。
413
+ **關鍵**: 永遠在頁尾記錄破壞性變更,並附上遷移指引。
414
+
415
+ **要求**:
416
+ 1. 在頁尾使用 `BREAKING CHANGE:` 前綴
417
+ 2. 描述變更了什麼以及原因
418
+ 3. **必須**包含具可執行步驟的遷移指南
419
+ 4. 盡可能提供變更前/後的範例
386
420
 
387
421
  **格式**:
388
422
 
@@ -390,22 +424,24 @@ Closes #123
390
424
  BREAKING CHANGE: <描述>
391
425
 
392
426
  遷移指南:
393
- - 步驟 1
394
- - 步驟 2
427
+ - 步驟 1: <具體動作>
428
+ - 步驟 2: <具體動作>
395
429
  ```
396
430
 
431
+ > **為何必須提供遷移指南**: 沒有遷移路徑的破壞性變更會讓使用者受挫並拖慢採用速度。每個破壞性變更都**必須**明確告訴使用者該怎麼做。
432
+
397
433
  **範例**:
398
434
 
399
435
  ```
400
- feat(api): 變更使用者端點回應格式
436
+ feat(api): Change user endpoint response format
401
437
 
402
- - 扁平化巢狀使用者物件結構
403
- - 移除已棄用的 `legacy_id` 欄位
404
- - 新增 `created_at` 和 `updated_at` 時間戳記
438
+ - Flatten nested user object structure
439
+ - Remove deprecated `legacy_id` field
440
+ - Add `created_at` and `updated_at` timestamps
405
441
 
406
- BREAKING CHANGE: 使用者 API 回應格式已變更
442
+ BREAKING CHANGE: User API response format changed
407
443
 
408
- 舊格式:
444
+ Old format:
409
445
  ```json
410
446
  {
411
447
  "data": {
@@ -418,7 +454,7 @@ BREAKING CHANGE: 使用者 API 回應格式已變更
418
454
  }
419
455
  ```
420
456
 
421
- 新格式:
457
+ New format:
422
458
 
423
459
  ```json
424
460
  {
@@ -429,11 +465,11 @@ BREAKING CHANGE: 使用者 API 回應格式已變更
429
465
  }
430
466
  ```
431
467
 
432
- 遷移指南:
468
+ Migration guide:
433
469
 
434
- - 更新 API 客戶端以移除 `.data` 包裝
435
- - 移除對 `legacy_id` 欄位的引用
436
- - 使用 `created_at` 而非 `createdAt`(snake_case)
470
+ - Update API clients to remove `.data` wrapper
471
+ - Remove references to `legacy_id` field
472
+ - Use `created_at` instead of `createdAt` (snake_case)
437
473
 
438
474
  Closes #234
439
475
 
@@ -443,7 +479,55 @@ Closes #234
443
479
 
444
480
  ## 完整範例
445
481
 
446
- ### 範例 1: 簡單修正(雙語對照)
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: 雙語對照模式 - 簡單修正
447
531
 
448
532
  ```
449
533
 
@@ -459,7 +543,7 @@ Fixes #445
459
543
 
460
544
  ---
461
545
 
462
- ### 範例 2: 功能(雙語對照)
546
+ ### 範例 4: 雙語對照模式 - 功能
463
547
 
464
548
  ```
465
549
 
@@ -508,7 +592,7 @@ Refs #234
508
592
 
509
593
  ---
510
594
 
511
- ### 範例 3: 含根因分析的 Bug 修正(雙語對照)
595
+ ### 範例 5: 雙語對照模式 - 含根因分析的 Bug 修正
512
596
 
513
597
  ```
514
598
 
@@ -552,7 +636,53 @@ Fixes #789
552
636
 
553
637
  ---
554
638
 
555
- ### 範例 4: 破壞性變更(雙語對照)
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: 雙語對照模式 - 破壞性變更
556
686
 
557
687
  ```
558
688
 
@@ -589,7 +719,7 @@ Estimated downtime: 2-4 hours
589
719
  變更內容:
590
720
 
591
721
  - 更新資料庫驅動從 mysql2 至 pg
592
- - 將 MySQL 專用查詢轉換為 PostgreSQL syntax
722
+ - 將 MySQL 專用查詢轉換為 PostgreSQL 語法
593
723
  - 更新連線池設定
594
724
 
595
725
  破壞性變更: 資料庫引擎從 MySQL 變更為 PostgreSQL
@@ -627,9 +757,9 @@ update: changes
627
757
  **✅ 修正**:
628
758
  ```
629
759
 
630
- fix(login): 防止快速點擊時重複建立 session
631
- refactor(utils): 提取電子郵件驗證正規表示式至常數
632
- feat(profile): 新增含圖片壓縮的頭像上傳功能
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
633
763
 
634
764
  ```
635
765
 
@@ -648,10 +778,10 @@ feat: add login, fix bugs, refactor database, update docs
648
778
  **✅ 修正**: 拆分為多個 commit:
649
779
  ```
650
780
 
651
- feat(auth): 新增 OAuth2 登入支援
652
- fix(api): 解決使用者查詢空指標問題
653
- refactor(database): 提取連線池至獨立模組
654
- docs(api): 更新認證端點文件
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
655
785
 
656
786
  ```
657
787
 
@@ -670,10 +800,10 @@ fix: change line 45 from getUserById to getUserByEmail because the function was
670
800
  **✅ 修正**:
671
801
  ```
672
802
 
673
- fix(api): 在密碼重設中使用正確的使用者查詢方法
803
+ fix(api): Use correct user lookup method in password reset
674
804
 
675
- 密碼重設流程使用電子郵件參數呼叫 getUserById,
676
- 導致查詢失敗。現已正確呼叫 getUserByEmail。
805
+ The password reset flow was calling getUserById with an email parameter,
806
+ causing lookups to fail. Now correctly calls getUserByEmail.
677
807
 
678
808
  Fixes #789
679
809
 
@@ -691,7 +821,7 @@ refactor(database): migrate to PostgreSQL
691
821
 
692
822
  **問題**: 破壞性變更卻無遷移指南或上下文。
693
823
 
694
- **✅ 修正**: 加入含上下文和遷移指南的主體(參見上方範例 4)。
824
+ **✅ 修正**: 加入含上下文和遷移指南的主體(參見上方範例 6)。
695
825
 
696
826
  ---
697
827
 
@@ -756,16 +886,16 @@ git-chglog --output CHANGELOG.md
756
886
  本專案使用**[英文 / 繁體中文 / 雙語對照]** commit 類型。
757
887
 
758
888
  ### 允許的類型
759
- - feat / 新增: 新功能
760
- - fix / 修正: Bug 修復
761
- - refactor / 重構: 程式碼重構
762
- - docs / 文件: 文件
763
- - test / 測試: 測試
764
- - perf / 效能: 效能改進
765
- - build / 建置: 建置系統
766
- - ci / 整合: CI/CD 變更
767
- - chore / 維護: 維護
768
- - security / 安全: 安全修復
889
+ - feat: 新功能
890
+ - fix: Bug 修復
891
+ - refactor: 程式碼重構
892
+ - docs: 文件
893
+ - test: 測試
894
+ - perf: 效能改進
895
+ - build: 建置系統
896
+ - ci: CI/CD 變更
897
+ - chore: 維護
898
+ - security: 安全修復
769
899
 
770
900
  ### 允許的範圍
771
901
  - auth: 認證模組
@@ -779,11 +909,11 @@ Commit 主旨行應使用**[英文/繁體中文/雙語]**。
779
909
 
780
910
  ### 範例
781
911
 
782
- **繁體中文**:
912
+ **英文**:
783
913
  ```
784
914
 
785
- 新增(認證): 實作 OAuth2 支援
786
- 修正(API): 解決記憶體洩漏
915
+ feat(auth): Add OAuth2 support
916
+ fix(api): Resolve memory leak
787
917
 
788
918
  ```
789
919
 
@@ -817,6 +947,7 @@ Closes #123
817
947
 
818
948
  | 版本 | 日期 | 變更 |
819
949
  | ----- | ---------- | -------------------------------------------------------------------------- |
950
+ | 1.4.0 | 2026-10-12 | 變更:選項 B(繁體中文)改用英文類型加繁體中文主旨;不再允許中文類型(新增、修正……),並附遷移對照表(XSPEC-475) |
820
951
  | 1.3.0 | 2026-03-16 | 新增自訂參考 Footer 慣例(Refs: PREFIX-ID) |
821
952
  | 1.2.3 | 2025-12-24 | 新增相關標準區段 |
822
953
  | 1.2.2 | 2025-12-16 | 新增語言選擇指南,含決策矩陣和快速選擇提示 |
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/database-standards.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-03-18
5
+ last_synced: 2026-10-11
6
+ source_hash: b21566b7d853
6
7
  status: current
7
8
  ---
8
9