universal-dev-standards 6.14.0-beta.9 → 6.14.1-beta.1

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 (721) 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/mock-boundary.ai.yaml +138 -2
  5. package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
  6. package/bundled/ai/standards/turn-completion-integrity.ai.yaml +6 -2
  7. package/bundled/core/commit-message-guide.md +22 -19
  8. package/bundled/core/mock-boundary.md +70 -2
  9. package/bundled/core/secret-management-standards.md +13 -1
  10. package/bundled/core/turn-completion-integrity.md +8 -2
  11. package/bundled/extensions/locales/zh-tw.md +19 -19
  12. package/bundled/hooks/check-dangerous-cmd.mjs +161 -26
  13. package/bundled/hooks/check-logging-standard.mjs +35 -6
  14. package/bundled/hooks/validate-commit-msg.mjs +317 -28
  15. package/bundled/locales/zh-CN/CHANGELOG.md +2323 -1099
  16. package/bundled/locales/zh-CN/CLAUDE.md +987 -101
  17. package/bundled/locales/zh-CN/README.md +3 -3
  18. package/bundled/locales/zh-CN/SECURITY.md +4 -3
  19. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  20. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
  21. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  22. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
  23. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
  24. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
  25. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
  26. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  27. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  28. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  29. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  30. package/bundled/locales/zh-CN/core/accessibility-standards.md +871 -62
  31. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  32. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  33. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  34. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  35. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  36. package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +311 -72
  37. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  38. package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
  39. package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
  40. package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
  41. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  42. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  43. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  44. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  45. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  46. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  47. package/bundled/locales/zh-CN/core/changelog-standards.md +485 -63
  48. package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
  49. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  50. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  51. package/bundled/locales/zh-CN/core/code-review-checklist.md +37 -23
  52. package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
  53. package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
  54. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  55. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  56. package/bundled/locales/zh-CN/core/deprecation-standards.md +155 -40
  57. package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
  58. package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
  59. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  60. package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
  61. package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
  62. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  63. package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
  64. package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
  65. package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
  66. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  67. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  68. package/bundled/locales/zh-CN/core/feature-flag-standards.md +202 -57
  69. package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
  70. package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
  71. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  72. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  73. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  74. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  75. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  76. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  77. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  78. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  79. package/bundled/locales/zh-CN/core/mock-boundary.md +74 -6
  80. package/bundled/locales/zh-CN/core/mutation-testing.md +45 -6
  81. package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
  82. package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
  83. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  84. package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
  85. package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
  86. package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
  87. package/bundled/locales/zh-CN/core/project-structure.md +550 -170
  88. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  89. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  90. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  91. package/bundled/locales/zh-CN/core/retrospective-standards.md +215 -22
  92. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  93. package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
  94. package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
  95. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  96. package/bundled/locales/zh-CN/core/security-standards.md +169 -16
  97. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  98. package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
  99. package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
  100. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  101. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  102. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  103. package/bundled/locales/zh-CN/core/supply-chain-security-standards.md +159 -32
  104. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  105. package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
  106. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  107. package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
  108. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  109. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  110. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  111. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  112. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  113. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  114. package/bundled/locales/zh-CN/core/turn-completion-integrity.md +8 -6
  115. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  116. package/bundled/locales/zh-CN/core/versioning.md +737 -73
  117. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  118. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  119. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  120. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +2 -1
  121. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  122. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
  123. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
  124. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  125. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
  126. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  127. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
  128. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  129. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  130. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +2 -0
  131. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  132. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  133. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  134. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  135. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  136. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  137. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  138. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  139. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  140. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  141. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  142. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  143. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  144. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  145. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  146. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  147. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  148. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  149. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  150. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  151. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  152. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  153. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  154. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  155. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  156. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  157. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  158. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  159. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  160. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  161. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  162. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  163. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  164. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  165. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  166. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  167. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  168. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  169. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  170. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  171. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  172. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  173. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  174. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  175. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  176. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  177. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  178. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  179. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  180. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  181. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  182. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  183. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  184. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  185. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  186. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  187. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  188. package/bundled/locales/zh-CN/skills/README.md +2 -1
  189. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  190. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  191. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  192. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  193. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  194. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  195. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  196. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  197. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  198. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  199. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  200. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  201. package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +217 -137
  202. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  203. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  204. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  205. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  206. package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +148 -132
  207. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  208. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  209. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  210. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  211. package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +122 -121
  212. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  213. package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
  214. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  215. package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
  216. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  217. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  218. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  219. package/bundled/locales/zh-CN/skills/code-review-assistant/guide.md +119 -45
  220. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  221. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  222. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  223. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  224. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  225. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  226. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  227. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  228. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  229. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  230. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  231. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  232. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  233. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  234. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  235. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  236. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  237. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  238. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  239. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  240. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  241. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  242. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  243. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  244. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  245. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  246. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  247. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  248. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  249. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  250. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  251. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  252. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  253. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  254. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  255. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  256. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  257. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  258. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  259. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  260. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  261. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  262. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  263. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  264. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  265. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  266. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  267. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  268. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  269. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +4 -4
  270. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  271. package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
  272. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  273. package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
  274. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  275. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  276. package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +4 -2
  277. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  278. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  279. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  280. package/bundled/locales/zh-CN/skills/docs-generator/guide.md +8 -7
  281. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  282. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  283. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  284. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  285. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  286. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  287. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  288. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  289. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  290. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  291. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  292. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  293. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  294. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  295. package/bundled/locales/zh-CN/skills/project-discovery/guide.md +158 -157
  296. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  297. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  298. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  299. package/bundled/locales/zh-CN/skills/refactoring-assistant/guide.md +172 -171
  300. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  301. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  302. package/bundled/locales/zh-CN/skills/release-standards/guide.md +51 -43
  303. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  304. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  305. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  306. package/bundled/locales/zh-CN/skills/requirement-assistant/guide.md +88 -79
  307. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  308. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  309. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  310. package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +2 -2
  311. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  312. package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
  313. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  314. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  315. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  316. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  317. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  318. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  319. package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +2 -2
  320. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  321. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  322. package/bundled/locales/zh-CN/skills/tdd-assistant/guide.md +217 -156
  323. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  324. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  325. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  326. package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +25 -12
  327. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  328. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  329. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  330. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  331. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  332. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  333. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  334. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  335. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  336. package/bundled/locales/zh-TW/CHANGELOG.md +2323 -1128
  337. package/bundled/locales/zh-TW/CLAUDE.md +962 -76
  338. package/bundled/locales/zh-TW/README.md +3 -3
  339. package/bundled/locales/zh-TW/SECURITY.md +4 -3
  340. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  341. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
  342. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  343. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
  344. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
  345. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
  346. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
  347. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  348. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  349. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  350. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  351. package/bundled/locales/zh-TW/core/accessibility-standards.md +895 -46
  352. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  353. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  354. package/bundled/locales/zh-TW/core/agent-dispatch.md +102 -33
  355. package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
  356. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  357. package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
  358. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  359. package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
  360. package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
  361. package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
  362. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  363. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  364. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  365. package/bundled/locales/zh-TW/core/branch-completion.md +130 -34
  366. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  367. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  368. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  369. package/bundled/locales/zh-TW/core/chaos-engineering-standards.md +138 -36
  370. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  371. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  372. package/bundled/locales/zh-TW/core/code-review-checklist.md +19 -7
  373. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  374. package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
  375. package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
  376. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  377. package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
  378. package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
  379. package/bundled/locales/zh-TW/core/developer-memory.md +102 -12
  380. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  381. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  382. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  383. package/bundled/locales/zh-TW/core/environment-standards.md +250 -72
  384. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  385. package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
  386. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  387. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  388. package/bundled/locales/zh-TW/core/feature-flag-standards.md +202 -57
  389. package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
  390. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  391. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  392. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  393. package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +234 -487
  394. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  395. package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
  396. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  397. package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
  398. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  399. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  400. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  401. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  402. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  403. package/bundled/locales/zh-TW/core/mock-boundary.md +74 -6
  404. package/bundled/locales/zh-TW/core/observability-standards.md +284 -40
  405. package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
  406. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  407. package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
  408. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  409. package/bundled/locales/zh-TW/core/project-context-memory.md +210 -31
  410. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  411. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  412. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  413. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  414. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  415. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  416. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  417. package/bundled/locales/zh-TW/core/runbook-standards.md +296 -23
  418. package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
  419. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  420. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  421. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  422. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  423. package/bundled/locales/zh-TW/core/slo-standards.md +301 -49
  424. package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
  425. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  426. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  427. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  428. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  429. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  430. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  431. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  432. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  433. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  434. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  435. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  436. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  437. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  438. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  439. package/bundled/locales/zh-TW/core/turn-completion-integrity.md +8 -6
  440. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  441. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  442. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  443. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  444. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  445. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +2 -1
  446. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  447. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
  448. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  449. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
  450. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  451. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
  452. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  453. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
  454. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  455. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  456. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +2 -0
  457. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  458. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  459. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  460. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  461. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  462. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  463. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  464. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  465. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  466. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  467. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  468. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  469. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  470. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  471. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  472. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  473. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  474. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  475. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  476. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  477. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  478. package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +584 -475
  479. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  480. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  481. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  482. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  483. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  484. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  485. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  486. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  487. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  488. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  489. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  490. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  491. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  492. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  493. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  494. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  495. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  496. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  497. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  498. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  499. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  500. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  501. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  502. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  503. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  504. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  505. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  506. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  507. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  508. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  509. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  510. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  511. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  512. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  513. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  514. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  515. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  516. package/bundled/locales/zh-TW/skills/README.md +2 -1
  517. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  518. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  519. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  520. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  521. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  522. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  523. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  524. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  525. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  526. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  527. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  528. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  529. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  530. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  531. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  532. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  533. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  534. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  535. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  536. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  537. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  538. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  539. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  540. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  541. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  542. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  543. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  544. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  545. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  546. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  547. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  548. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  549. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  550. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  551. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  552. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  553. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  554. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  555. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  556. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  557. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  558. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  559. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  560. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  561. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  562. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  563. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  564. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  565. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  566. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  567. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  568. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  569. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  570. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  571. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  572. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  573. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  574. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  575. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  576. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  577. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  578. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  579. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  580. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  581. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  582. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  583. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  584. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  585. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  586. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  587. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  588. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  589. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  590. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  591. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  592. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  593. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  594. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  595. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  596. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  597. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  598. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  599. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  600. package/bundled/locales/zh-TW/skills/commit-standards/guide.md +137 -17
  601. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  602. package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
  603. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  604. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  605. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  606. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  607. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  608. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  609. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  610. package/bundled/locales/zh-TW/skills/docs-generator/guide.md +4 -3
  611. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  612. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  613. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  614. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  615. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  616. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  617. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  618. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  619. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  620. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  621. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  622. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  623. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  624. package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +85 -18
  625. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  626. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  627. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  628. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  629. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  630. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  631. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  632. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  633. package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +91 -45
  634. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  635. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  636. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  637. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  638. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  639. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  640. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  641. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  642. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  643. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  644. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  645. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  646. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  647. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  648. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  649. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  650. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  651. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  652. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  653. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  654. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  655. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  656. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  657. package/bundled/locales/zh-TW/skills/tdd-assistant/language-examples.md +693 -47
  658. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  659. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  660. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  661. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  662. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  663. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  664. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  665. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  666. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  667. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  668. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  669. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  670. package/bundled/skills/.claude-plugin/plugin.json +71 -0
  671. package/bundled/skills/commit-standards/SKILL.md +2 -2
  672. package/bundled/skills/commit-standards/guide.md +3 -2
  673. package/bundled/skills/commit-standards/language-options.md +19 -17
  674. package/package.json +2 -2
  675. package/src/commands/audit.js +28 -1
  676. package/src/commands/check.js +72 -3
  677. package/src/commands/compile.js +37 -4
  678. package/src/commands/config.js +49 -24
  679. package/src/commands/init.js +78 -30
  680. package/src/commands/open-work.js +6 -2
  681. package/src/commands/release-messages.js +228 -0
  682. package/src/commands/release.js +127 -68
  683. package/src/commands/run-intent.js +11 -0
  684. package/src/commands/spec.js +4 -2
  685. package/src/commands/update.js +227 -47
  686. package/src/compilers/claude-code-compiler.js +9 -1
  687. package/src/config/ai-agent-paths.js +14 -1
  688. package/src/core/installed-formats.js +15 -0
  689. package/src/core/open-work-config.js +20 -1
  690. package/src/core/project-config.js +55 -0
  691. package/src/i18n/messages.js +106 -2
  692. package/src/installers/hooks-installer.js +1 -1
  693. package/src/installers/manifest-installer.js +1 -1
  694. package/src/installers/skills-installer.js +1 -1
  695. package/src/installers/standards-installer.js +3 -1
  696. package/src/mcp/server.js +9 -3
  697. package/src/prompts/init.js +26 -22
  698. package/src/reconciler/actual-state-scanner.js +2 -8
  699. package/src/reconciler/backup-locations.js +5 -0
  700. package/src/reconciler/backup-manager.js +19 -11
  701. package/src/reconciler/desired-state-calculator.js +89 -57
  702. package/src/reconciler/plan-executor.js +101 -8
  703. package/src/reconciler/recorded-versions.js +49 -0
  704. package/src/reconciler/relative-path.js +23 -0
  705. package/src/uninstallers/hook-uninstaller.js +9 -1
  706. package/src/uninstallers/skills-uninstaller.js +22 -3
  707. package/src/utils/available-standards-report.js +25 -4
  708. package/src/utils/available-standards.js +13 -3
  709. package/src/utils/build-manifest.js +1 -1
  710. package/src/utils/commit-message-judge.js +60 -13
  711. package/src/utils/friction-detector.js +23 -11
  712. package/src/utils/git-hooks.js +106 -4
  713. package/src/utils/integration-generator.js +95 -67
  714. package/src/utils/legacy-hook-migration.js +121 -2
  715. package/src/utils/open-work-tracking.mjs +105 -16
  716. package/src/utils/sdd-header.js +16 -4
  717. package/src/utils/skills-installer.js +2 -1
  718. package/src/utils/spinner.js +14 -4
  719. package/src/utils/standard-validator.js +3 -2
  720. package/standards-registry.json +10 -8
  721. package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
@@ -2,16 +2,17 @@
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-23
5
+ last_synced: 2026-10-11
6
+ source_hash: b21566b7d853
6
7
  status: current
7
8
  ---
8
9
 
9
10
  # 数据库标准
10
11
 
11
- > **语言**: [English](../../../core/database-standards.md) | 简体中文
12
-
13
- > 版本: 1.0.0 | 最后更新: 2026-03-18
12
+ > **语言**: [English](../../../core/database-standards.md) | [繁體中文](../../zh-TW/core/database-standards.md) | 简体中文
14
13
 
14
+ **版本**: 1.0.0
15
+ **最后更新**: 2026-03-18
15
16
  **适用性**: 所有软件项目
16
17
  **范围**: universal
17
18
  **产业标准**: ISO/IEC 9075 (SQL)、ACID 特性、BASE 定理
@@ -21,11 +22,11 @@ status: current
21
22
 
22
23
  ## 目的
23
24
 
24
- 本标准定义数据库设计、查询、迁移与运维的指导方针,涵盖关系型与非关系型数据库。包含 Schema 设计原则、索引策略、迁移工作流程、查询最优化、事务管理与数据完整性 — 确保数据库具备高性能、可维护且安全的特性。
25
+ 本标准定义数据库设计、查询、迁移与运维的指导方针,涵盖关系型与非关系型数据库。包含 Schema 设计原则、索引策略、迁移工作流程、查询优化、事务管理与数据完整性 — 确保数据库具备高性能、可维护且安全的特性。
25
26
 
26
27
  **参考标准**:
27
28
  - [ISO/IEC 9075 — SQL 标准](https://www.iso.org/standard/76583.html)
28
- - [Use The Index, Luke — SQL 索引与调校](https://use-the-index-luke.com/)
29
+ - [Use The Index, Luke — SQL 索引与调优](https://use-the-index-luke.com/)
29
30
  - [Martin Fowler — 演进式数据库设计](https://martinfowler.com/articles/evodb.html)
30
31
  - [Designing Data-Intensive Applications (Martin Kleppmann)](https://dataintensive.net/)
31
32
 
@@ -38,7 +39,7 @@ status: current
38
39
  | **数据完整性优先** | 约束、验证与引用完整性在数据库层级强制执行,而非仅在应用代码 |
39
40
  | **Schema 即代码** | 数据库 Schema 通过迁移脚本进行版本控制且可重现 |
40
41
  | **最小权限** | 数据库账号使用其功能所需的最低权限 |
41
- | **先量测再调校** | 使用 EXPLAIN 计划与指标后再进行最优化;避免过早最优化 |
42
+ | **先测量再调优** | 使用 EXPLAIN 计划与指标后再进行优化;避免过早优化 |
42
43
  | **纵深防御** | 在多个层级使用加密、遮蔽与访问控制来保护敏感数据 |
43
44
  | **向后兼容** | Schema 变更必须在部署窗口期间维持向后兼容 |
44
45
 
@@ -48,7 +49,7 @@ status: current
48
49
 
49
50
  ### 正规化
50
51
 
51
- 套用正规化以消除冗余并确保数据完整性。以第三正规形式(3NF)作为事务系统的基准。
52
+ 应用正规化以消除冗余并确保数据完整性。以第三正规形式(3NF)作为事务系统的基准。
52
53
 
53
54
  | 正规形式 | 规则 | 违反范例 |
54
55
  |----------|------|----------|
@@ -71,7 +72,7 @@ status: current
71
72
  **进行反正规化时:**
72
73
  - 记录数据来源(source of truth)与同步机制
73
74
  - 加入注释说明选择反正规化的原因
74
- - 实现一致性检查或校正排程
75
+ - 实现一致性检查或对账作业
75
76
 
76
77
  ### 命名惯例
77
78
 
@@ -118,7 +119,7 @@ status: current
118
119
  | 分布式生成 | 需要协调 | 无需协调 |
119
120
  | 安全性 | 可预测(可枚举) | 不可猜测 |
120
121
  | URL 暴露 | 揭露记录数量 | 可安全用于公开 URL |
121
- | 合并/复写 | 容易冲突 | 无冲突 |
122
+ | 合并/复制 | 容易冲突 | 无冲突 |
122
123
 
123
124
  **建议:**
124
125
  - 单一数据库系统的内部 ID 使用**自动递增**
@@ -126,14 +127,14 @@ status: current
126
127
  - 新项目考虑以 **UUIDv7** 为默认 — 兼具可排序性与唯一性
127
128
 
128
129
  ```sql
129
- -- PostgreSQL:UUIDv7 作为主键
130
+ -- PostgreSQL: UUIDv7 as primary key
130
131
  CREATE TABLE user_account (
131
132
  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
132
133
  email VARCHAR(255) NOT NULL,
133
134
  created_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
134
135
  );
135
136
 
136
- -- 自动递增替代方案
137
+ -- Auto-increment alternative
137
138
  CREATE TABLE user_account (
138
139
  id BIGSERIAL PRIMARY KEY,
139
140
  public_id UUID NOT NULL DEFAULT gen_random_uuid(),
@@ -161,13 +162,13 @@ CREATE TABLE user_account (
161
162
  复合索引的字段顺序影响重大。遵循**等值优先、范围最后**规则:
162
163
 
163
164
  ```sql
164
- -- 查询模式:
165
+ -- Query pattern:
165
166
  -- WHERE status = 'active' AND created_at > '2026-01-01' ORDER BY created_at
166
167
 
167
- -- 正确:等值字段在前,范围/排序字段在后
168
+ -- GOOD: equality columns first, range/sort columns last
168
169
  CREATE INDEX idx_order_status_created ON order_record (status, created_at);
169
170
 
170
- -- 错误:范围字段在前,削弱等值筛选效果
171
+ -- BAD: range column first eliminates effectiveness for equality filter
171
172
  CREATE INDEX idx_order_created_status ON order_record (created_at, status);
172
173
  ```
173
174
 
@@ -182,9 +183,9 @@ CREATE INDEX idx_order_created_status ON order_record (created_at, status);
182
183
  覆盖索引包含查询所需的所有字段,实现仅索引扫描:
183
184
 
184
185
  ```sql
185
- -- 查询:SELECT email, first_name FROM user_account WHERE status = 'active';
186
+ -- Query: SELECT email, first_name FROM user_account WHERE status = 'active';
186
187
 
187
- -- 覆盖索引 — 无需回表查询
188
+ -- Covering index — no table lookup needed
188
189
  CREATE INDEX idx_user_account_status_covering
189
190
  ON user_account (status) INCLUDE (email, first_name);
190
191
  ```
@@ -194,12 +195,12 @@ CREATE INDEX idx_user_account_status_covering
194
195
  对数据行的子集创建索引,以减少索引大小并改善写入性能:
195
196
 
196
197
  ```sql
197
- -- 仅索引活跃记录(90% 的查询筛选 active)
198
+ -- Only index active records (90% of queries filter on active)
198
199
  CREATE INDEX idx_order_active
199
200
  ON order_record (created_at)
200
201
  WHERE status = 'active';
201
202
 
202
- -- 仅索引非 NULL 值
203
+ -- Only index non-null values
203
204
  CREATE INDEX idx_user_account_phone
204
205
  ON user_account (phone_number)
205
206
  WHERE phone_number IS NOT NULL;
@@ -217,10 +218,10 @@ CREATE INDEX idx_user_account_phone
217
218
  | **索引字段上使用函数** | 索引被绕过 | 创建函数/表达式索引 |
218
219
 
219
220
  ```sql
220
- -- 反模式:函数阻止索引使用
221
+ -- Anti-pattern: function prevents index usage
221
222
  SELECT * FROM user_account WHERE LOWER(email) = 'test@example.com';
222
223
 
223
- -- 解决方案:表达式索引
224
+ -- Solution: expression index
224
225
  CREATE INDEX idx_user_account_email_lower ON user_account (LOWER(email));
225
226
  ```
226
227
 
@@ -243,7 +244,7 @@ CREATE INDEX idx_user_account_email_lower ON user_account (LOWER(email));
243
244
  ```
244
245
  YYYYMMDDHHMMSS_description.sql
245
246
 
246
- 范例:
247
+ Examples:
247
248
  20260318120000_create_user_account_table.sql
248
249
  20260318120100_add_email_index_to_user_account.sql
249
250
  20260318120200_add_phone_column_to_user_account.sql
@@ -264,21 +265,21 @@ YYYYMMDDHHMMSS_description.sql
264
265
 
265
266
  **第一阶段 — Expand(向后兼容)**
266
267
  ```sql
267
- -- 新增字段(可为 NULL,尚无约束)
268
+ -- Add new column (nullable, no constraint yet)
268
269
  ALTER TABLE user_account ADD COLUMN phone VARCHAR(20);
269
270
  ```
270
271
 
271
272
  **第二阶段 — Migrate(双写)**
272
273
  ```sql
273
- -- 回填现有数据
274
+ -- Backfill existing data
274
275
  UPDATE user_account SET phone = legacy_phone WHERE phone IS NULL;
275
276
  ```
276
277
 
277
278
  **第三阶段 — Contract(所有消费者更新后)**
278
279
  ```sql
279
- -- 所有数据已填入后加入约束
280
+ -- Add constraint now that all data is populated
280
281
  ALTER TABLE user_account ALTER COLUMN phone SET NOT NULL;
281
- -- 移除旧字段(仅在确认无消费者使用后)
282
+ -- Drop old column (only after verifying no consumers use it)
282
283
  ALTER TABLE user_account DROP COLUMN legacy_phone;
283
284
  ```
284
285
 
@@ -304,17 +305,17 @@ ALTER TABLE user_account DROP COLUMN legacy_phone;
304
305
  N+1 问题发生在代码执行一个查询获取清单,再对每个项目额外执行 N 个查询。
305
306
 
306
307
  ```sql
307
- -- N+1 问题(应用程序发出 N 个查询)
308
- -- 查询 1:SELECT * FROM order_record WHERE user_id = 42;
309
- -- 查询 2..N:SELECT * FROM order_item WHERE order_id = ?; (对每笔订单)
308
+ -- N+1 PROBLEM (application issues N queries)
309
+ -- Query 1: SELECT * FROM order_record WHERE user_id = 42;
310
+ -- Query 2..N: SELECT * FROM order_item WHERE order_id = ?; (for each order)
310
311
 
311
- -- 解决方案:JOIN 或子查询
312
+ -- SOLUTION: JOIN or subquery
312
313
  SELECT o.*, oi.*
313
314
  FROM order_record o
314
315
  JOIN order_item oi ON oi.order_id = o.id
315
316
  WHERE o.user_id = 42;
316
317
 
317
- -- 或批次加载
318
+ -- Or batch loading
318
319
  SELECT * FROM order_item
319
320
  WHERE order_id IN (SELECT id FROM order_record WHERE user_id = 42);
320
321
  ```
@@ -332,11 +333,11 @@ WHERE order_id IN (SELECT id FROM order_record WHERE user_id = 42);
332
333
  EXPLAIN (ANALYZE, BUFFERS, FORMAT TEXT)
333
334
  SELECT * FROM order_record WHERE status = 'pending' AND created_at > '2026-01-01';
334
335
 
335
- -- 需关注的指标:
336
- -- 大型数据表的 Seq Scan → 缺少索引
337
- -- 高行数的 Nested Loop → 考虑 Hash Join
338
- -- 高成本的 Sort → 加入符合 ORDER BY 的索引
339
- -- 行数(估计 vs 实际) → 统计数据过时,执行 ANALYZE
336
+ -- Key indicators to watch:
337
+ -- Seq Scan on large tables → missing index
338
+ -- Nested Loop with high rows → consider Hash Join
339
+ -- Sort with high cost → add index matching ORDER BY
340
+ -- Rows (estimated vs actual) → stale statistics, run ANALYZE
340
341
  ```
341
342
 
342
343
  ### 分页
@@ -347,16 +348,16 @@ SELECT * FROM order_record WHERE status = 'pending' AND created_at > '2026-01-01
347
348
  | **Keyset(游标)分页** | 性能一致、结果稳定 | 无法随机跳页、多字段排序时较复杂 | API、无限滚动、大型数据集 |
348
349
 
349
350
  ```sql
350
- -- Offset 分页(大型数据表应避免)
351
+ -- Offset-based (avoid for large tables)
351
352
  SELECT * FROM order_record ORDER BY id LIMIT 20 OFFSET 10000;
352
- -- 性能劣化:数据库须扫描并丢弃 10,000 行
353
+ -- Performance degrades: DB must scan and discard 10,000 rows
353
354
 
354
- -- Keyset 分页(建议使用)
355
+ -- Keyset-based (preferred)
355
356
  SELECT * FROM order_record
356
357
  WHERE id > :last_seen_id
357
358
  ORDER BY id
358
359
  LIMIT 20;
359
- -- 无论页面深度,性能一致
360
+ -- Consistent performance regardless of page depth
360
361
  ```
361
362
 
362
363
  ### 查询反模式
@@ -371,10 +372,10 @@ LIMIT 20;
371
372
  | `LIKE '%prefix'` | 前导通配符阻止索引使用 | 使用全文搜索或反向索引 |
372
373
 
373
374
  ```sql
374
- -- 反模式:SQL 注入风险
375
+ -- ANTI-PATTERN: SQL injection risk
375
376
  query = "SELECT * FROM user_account WHERE email = '" + email + "'";
376
377
 
377
- -- 正确:参数化查询
378
+ -- CORRECT: Parameterized query
378
379
  query = "SELECT * FROM user_account WHERE email = $1";
379
380
  params = [email];
380
381
  ```
@@ -409,15 +410,15 @@ params = [email];
409
410
  |------|----------|
410
411
  | **一致的锁定顺序** | 在所有事务中以相同顺序获取数据表/行的锁定 |
411
412
  | **短事务** | 尽可能保持事务简短;将非数据库工作移出事务外 |
412
- | **锁定超时** | 设定 `lock_timeout` 以快速失败而非无限等待 |
413
+ | **锁定超时** | 设置 `lock_timeout` 以快速失败而非无限等待 |
413
414
  | **重试逻辑** | 对死锁错误(SQLSTATE 40P01)实现指数退避重试 |
414
415
  | **避免用户交互** | 绝不在等待用户输入时保持事务开启 |
415
416
 
416
417
  ```sql
417
- -- 设定锁定超时以防止无限等待
418
+ -- Set lock timeout to prevent indefinite waiting
418
419
  SET lock_timeout = '5s';
419
420
 
420
- -- 保持事务简短
421
+ -- Keep transactions short
421
422
  BEGIN;
422
423
  UPDATE account SET balance = balance - 100 WHERE id = 1;
423
424
  UPDATE account SET balance = balance + 100 WHERE id = 2;
@@ -435,16 +436,16 @@ COMMIT;
435
436
  | 死锁风险 | 无 | 可能 |
436
437
 
437
438
  ```sql
438
- -- 乐观锁定
439
+ -- Optimistic locking
439
440
  UPDATE order_record
440
441
  SET status = 'shipped', version = version + 1
441
442
  WHERE id = 42 AND version = 3;
442
- -- 若受影响行数 = 0,表示另一个事务已修改 → 重试或错误
443
+ -- If affected rows = 0, another transaction modified it → retry or error
443
444
 
444
- -- 悲观锁定
445
+ -- Pessimistic locking
445
446
  BEGIN;
446
447
  SELECT * FROM order_record WHERE id = 42 FOR UPDATE;
447
- -- 行已锁定;其他事务等待
448
+ -- Row is locked; other transactions wait
448
449
  UPDATE order_record SET status = 'shipped' WHERE id = 42;
449
450
  COMMIT;
450
451
  ```
@@ -455,7 +456,7 @@ COMMIT;
455
456
 
456
457
  | 判断条件 | 关系型 (SQL) | 文档型 (NoSQL) | 键值型 | 图形型 |
457
458
  |----------|-------------|---------------|--------|--------|
458
- | **数据结构** | 结构化、明确定义的 Schema | 半结构化、弹性 Schema | 简单的 key→value 配对 | 高度连结的实体 |
459
+ | **数据结构** | 结构化、明确定义的 Schema | 半结构化、弹性 Schema | 简单的 key→value 配对 | 高度关联的实体 |
459
460
  | **一致性** | 强一致(ACID) | 最终一致(BASE),部分支持 ACID | 最终一致 | 依实现而异 |
460
461
  | **查询复杂度** | 复杂 JOIN、聚合 | 简单查询、嵌套文档 | 单键查询 | 关系遍历 |
461
462
  | **扩展模式** | 垂直扩展(scale-up) | 水平扩展(scale-out) | 水平扩展 | 依实现而异 |
@@ -466,13 +467,13 @@ COMMIT;
466
467
  ### 决策指南
467
468
 
468
469
  ```
469
- 你的数据是否高度关联且需要复杂查询?
470
- ├── 是 → 关系型 (SQL)
471
- └── 否 → 你的数据是否为简单的键值配对?
472
- ├── 是 → 键值型存储
473
- └── 否 → 关系是否为主要的查询模式?
474
- ├── 是 → 图形数据库
475
- └── 否 → 文档型数据库
470
+ Is your data highly relational with complex queries?
471
+ ├── Yes → Relational (SQL)
472
+ └── No → Is your data simple key-value pairs?
473
+ ├── Yes → Key-Value store
474
+ └── No → Are relationships the primary query pattern?
475
+ ├── Yes → Graph database
476
+ └── No → Document database
476
477
  ```
477
478
 
478
479
  **Polyglot Persistence(多语言持久化):** 许多系统受益于使用多种数据库类型。范例:
@@ -505,10 +506,10 @@ COMMIT;
505
506
  ```
506
507
  pool_size = (core_count * 2) + effective_spindle_count
507
508
 
508
- 范例:
509
- - 4 核心服务器,SSD: (4 * 2) + 1 = 9-10 个连接
510
- - 8 核心服务器,SSD: (8 * 2) + 1 = 17 个连接
511
- - 4 核心服务器,4 HDD: (4 * 2) + 4 = 12 个连接
509
+ Examples:
510
+ - 4-core server, SSD: (4 * 2) + 1 = 9-10 connections
511
+ - 8-core server, SSD: (8 * 2) + 1 = 17 connections
512
+ - 4-core server, 4 HDDs: (4 * 2) + 4 = 12 connections
512
513
  ```
513
514
 
514
515
  **重要:** 更多连接不一定更好。过多连接会导致:
@@ -519,13 +520,13 @@ pool_size = (core_count * 2) + effective_spindle_count
519
520
  ### 健康检查
520
521
 
521
522
  ```sql
522
- -- 基本健康检查
523
+ -- Basic health check
523
524
  SELECT 1;
524
525
 
525
- -- 进阶健康检查(验证读写能力)
526
+ -- Advanced health check (verify read/write capability)
526
527
  SELECT NOW();
527
528
 
528
- -- 使用前的连接验证
529
+ -- Connection validation before use
529
530
  SET statement_timeout = '2s';
530
531
  SELECT 1;
531
532
  ```
@@ -576,20 +577,20 @@ CREATE TABLE order_record (
576
577
  | 因素 | 软删除 | 硬删除 |
577
578
  |------|--------|--------|
578
579
  | 实现方式 | `deleted_at TIMESTAMPTZ` 字段 | `DELETE FROM table` |
579
- | 数据恢复 | 简单 — 设定 `deleted_at = NULL` | 需从备份还原 |
580
+ | 数据恢复 | 简单 — 设置 `deleted_at = NULL` | 需从备份还原 |
580
581
  | 查询复杂度 | 每处都须加 `WHERE deleted_at IS NULL` | 查询较简单 |
581
582
  | 存储 | 随时间增长 | 回收空间 |
582
583
  | 合规性 | 保留审计轨迹 | 可能违反保留要求 |
583
584
  | 性能 | 大量软删除行的大型数据表 | 更干净的表统计数据 |
584
585
 
585
586
  ```sql
586
- -- 软删除实现
587
+ -- Soft delete implementation
587
588
  ALTER TABLE user_account ADD COLUMN deleted_at TIMESTAMPTZ;
588
589
 
589
- -- 为活跃记录创建部分索引
590
+ -- Create partial index for active records
590
591
  CREATE INDEX idx_user_account_active ON user_account (email) WHERE deleted_at IS NULL;
591
592
 
592
- -- 应用程序查询模式
593
+ -- Application query pattern
593
594
  SELECT * FROM user_account WHERE deleted_at IS NULL AND email = $1;
594
595
  ```
595
596
 
@@ -611,17 +612,17 @@ SELECT * FROM user_account WHERE deleted_at IS NULL AND email = $1;
611
612
 
612
613
  | 指标 | 定义 | 目标范例 |
613
614
  |------|------|----------|
614
- | **RPO**(恢复点目标) | 可接受的最大数据损失(时间) | 1 小时:每小时备份;0:持续复写 |
615
+ | **RPO**(恢复点目标) | 可接受的最大数据损失(时间) | 1 小时:每小时备份;0:持续复制 |
615
616
  | **RTO**(恢复时间目标) | 可接受的最大停机时间 | 15 分钟:自动容错切换;4 小时:手动还原 |
616
617
 
617
- ### 备份排程建议
618
+ ### 备份调度建议
618
619
 
619
620
  | 层级 | RPO | RTO | 策略 |
620
621
  |------|-----|-----|------|
621
- | **关键**(财务、医疗) | < 1 分钟 | < 15 分钟 | 同步复写 + 持续 WAL 归档 |
622
- | **重要**(电子商务、SaaS) | < 1 小时 | < 1 小时 | 流式复写 + 每小时 WAL 归档 |
622
+ | **关键**(财务、医疗) | < 1 分钟 | < 15 分钟 | 同步复制 + 持续 WAL 归档 |
623
+ | **重要**(电子商务、SaaS) | < 1 小时 | < 1 小时 | 流式复制 + 每小时 WAL 归档 |
623
624
  | **标准**(内部工具) | < 24 小时 | < 4 小时 | 每日完整 + 每小时增量 |
624
- | **低**(开发、预备环境) | < 1 周 | < 1 天 | 每周完整备份 |
625
+ | **低**(开发、预发布环境) | < 1 周 | < 1 天 | 每周完整备份 |
625
626
 
626
627
  ### 备份测试
627
628
 
@@ -629,7 +630,7 @@ SELECT * FROM user_account WHERE deleted_at IS NULL AND email = $1;
629
630
  |------|------|
630
631
  | 还原测试至独立环境 | 每月 |
631
632
  | 还原后验证数据完整性 | 每次还原测试 |
632
- | 量测实际 RTO vs 目标 | 每季 |
633
+ | 测量实际 RTO vs 目标 | 每季 |
633
634
  | 测试时间点恢复 | 每半年 |
634
635
  | 更新文档与执行手册 | 每次测试后 |
635
636
 
@@ -640,11 +641,11 @@ SELECT * FROM user_account WHERE deleted_at IS NULL AND email = $1;
640
641
  ### 字段层级加密
641
642
 
642
643
  ```sql
643
- -- 写入时加密
644
+ -- Encrypt at write time
644
645
  INSERT INTO user_account (email, ssn_encrypted)
645
646
  VALUES ($1, pgp_sym_encrypt($2, $encryption_key));
646
647
 
647
- -- 读取时解密(仅授权角色可执行)
648
+ -- Decrypt at read time (only by authorized roles)
648
649
  SELECT email, pgp_sym_decrypt(ssn_encrypted, $encryption_key) AS ssn
649
650
  FROM user_account WHERE id = $1;
650
651
  ```
@@ -661,7 +662,7 @@ FROM user_account WHERE id = $1;
661
662
  ### 数据遮蔽
662
663
 
663
664
  ```sql
664
- -- 基于 View 的遮蔽,供客服人员使用
665
+ -- View-based masking for support staff
665
666
  CREATE VIEW user_account_masked AS
666
667
  SELECT
667
668
  id,
@@ -671,7 +672,7 @@ SELECT
671
672
  created_at
672
673
  FROM user_account;
673
674
 
674
- -- 仅授予客服团队访问遮蔽 View 的权限
675
+ -- Grant support team access to masked view only
675
676
  GRANT SELECT ON user_account_masked TO support_role;
676
677
  ```
677
678
 
@@ -684,12 +685,12 @@ GRANT SELECT ON user_account_masked TO support_role;
684
685
  - [ ] 定义并执行保留策略
685
686
  - [ ] 支持数据主体请求(GDPR 删除权、访问权)
686
687
  - [ ] 记录所有对 PII 字段的访问
687
- - [ ] 在开发与预备环境中匿名化数据
688
+ - [ ] 在开发与预发布环境中匿名化数据
688
689
 
689
690
  ### 审计日志
690
691
 
691
692
  ```sql
692
- -- 审计日志数据表
693
+ -- Audit log table
693
694
  CREATE TABLE audit_log (
694
695
  id BIGSERIAL PRIMARY KEY,
695
696
  table_name VARCHAR(100) NOT NULL,
@@ -701,7 +702,7 @@ CREATE TABLE audit_log (
701
702
  changed_at TIMESTAMPTZ NOT NULL DEFAULT NOW()
702
703
  );
703
704
 
704
- -- 基于触发器的审计(PostgreSQL 范例)
705
+ -- Trigger-based audit (PostgreSQL example)
705
706
  CREATE OR REPLACE FUNCTION audit_trigger_fn()
706
707
  RETURNS TRIGGER AS $$
707
708
  BEGIN
@@ -737,7 +738,7 @@ $$ LANGUAGE plpgsql;
737
738
  |------|----------|----------|------|
738
739
  | **活跃连接数** | > 最大值的 70% | > 最大值的 90% | 数据库仪表板 |
739
740
  | **缓存/缓冲命中率** | < 95% | < 90% | `pg_stat_bgwriter`、InnoDB buffer pool |
740
- | **复写延迟** | > 1 秒 | > 10 秒 | 复写监控 |
741
+ | **复制延迟** | > 1 秒 | > 10 秒 | 复制监控 |
741
742
  | **事务速率** | 偏离基线 > 20% | 偏离 > 50% | 应用程序指标 |
742
743
  | **锁定等待时间** | 平均 > 1 秒 | > 5 秒 | 锁定监控查询 |
743
744
  | **每分钟死锁数** | > 1 | > 5 | 数据库日志 |
@@ -747,21 +748,21 @@ $$ LANGUAGE plpgsql;
747
748
  ### 查询计划分析工作流程
748
749
 
749
750
  ```
750
- 1. 识别慢查询(慢查询日志或 APM)
751
+ 1. Identify slow query (slow query log or APM)
751
752
  ↓
752
- 2. 在预备环境以类生产数据执行 EXPLAIN ANALYZE
753
+ 2. Run EXPLAIN ANALYZE on staging with production-like data
753
754
  ↓
754
- 3. 查找:
755
- - 大型数据表的顺序扫描 → 加入索引
756
- - 实际与估计行数差距大 → 执行 ANALYZE(更新统计数据)
757
- - 大量迭代的 Nested Loop → 重构查询或加入索引
758
- - 高成本的排序操作 → 加入符合排序顺序的索引
755
+ 3. Look for:
756
+ - Sequential scans on large tables → add index
757
+ - High actual vs estimated rows → run ANALYZE (update statistics)
758
+ - Nested loops with many iterations → restructure query or add index
759
+ - Sort operations with high cost → add index matching sort order
759
760
  ↓
760
- 4. 套用修正(加入索引、改写查询、更新统计数据)
761
+ 4. Apply fix (add index, rewrite query, update statistics)
761
762
  ↓
762
- 5. 重新执行 EXPLAIN ANALYZE 验证改善
763
+ 5. Re-run EXPLAIN ANALYZE to verify improvement
763
764
  ↓
764
- 6. 部署并在生产环境监控执行时间
765
+ 6. Deploy and monitor execution time in production
765
766
  ```
766
767
 
767
768
  ---
@@ -771,34 +772,34 @@ $$ LANGUAGE plpgsql;
771
772
  ### Schema 设计
772
773
 
773
774
  ```
774
- ✅ 所有标识符使用 snake_case
775
- ✅ 单数数据表名称(user_account,非 user_accounts)
776
- ✅ 外键使用 _id 后缀
777
- ✅ 必有 id、created_at、updated_at 字段
778
- ✅ 在数据库层级强制约束
779
- ✅ 正规化至 3NF,反正规化须有文档记载的理由
775
+ ✅ Use snake_case for all identifiers
776
+ ✅ Singular table names (user_account, not user_accounts)
777
+ ✅ Use _id suffix for foreign keys
778
+ ✅ Always have id, created_at, updated_at columns
779
+ ✅ Enforce constraints at database level
780
+ ✅ Normalize to 3NF, denormalize with documented reasoning
780
781
  ```
781
782
 
782
783
  ### 查询
783
784
 
784
785
  ```
785
- ✅ 务必使用参数化查询
786
- ✅ 明确列出所需字段,而非 SELECT *
787
- ✅ 使用 EXPLAIN ANALYZE 进行查询最优化
788
- ✅ 大型数据集优先使用 Keyset 分页而非 Offset
789
- ✅ 批次操作以预防 N+1 查询
790
- ✅ 设定 statement_timeout 以防止失控查询
786
+ ✅ Always use parameterized queries
787
+ ✅ List specific columns instead of SELECT *
788
+ ✅ Use EXPLAIN ANALYZE for query optimization
789
+ ✅ Prefer keyset pagination over offset for large datasets
790
+ ✅ Batch operations to prevent N+1 queries
791
+ ✅ Set statement_timeout to prevent runaway queries
791
792
  ```
792
793
 
793
794
  ### 运维
794
795
 
795
796
  ```
796
- ✅ 使用连接池(绝不创建每次请求的连接)
797
- ✅ 版本控制所有迁移
798
- ✅ 以类生产数据测试迁移
799
- ✅ 使用 Expand-Contract 模式进行零停机 Schema 变更
800
- ✅ 监控慢查询、连接数、缓存命中率
801
- ✅ 定期测试备份还原
797
+ ✅ Use connection pooling (never open per-request connections)
798
+ ✅ Version-control all migrations
799
+ ✅ Test migrations with production-like data
800
+ ✅ Use expand-contract for zero-downtime schema changes
801
+ ✅ Monitor slow queries, connections, cache hit ratio
802
+ ✅ Test backup restoration regularly
802
803
  ```
803
804
 
804
805
  ---
@@ -806,7 +807,7 @@ $$ LANGUAGE plpgsql;
806
807
  ## 相关标准
807
808
 
808
809
  - [安全标准](../../../core/security-standards.md) — 数据加密、访问控制、PII 处理
809
- - [性能标准](../../../core/performance-standards.md) — 应用程序层级的性能最优化
810
+ - [性能标准](../../../core/performance-standards.md) — 应用程序层级的性能优化
810
811
  - [日志标准](../../../core/logging-standards.md) — 数据库操作的结构化日志
811
812
  - [部署标准](../../../core/deployment-standards.md) — 数据库迁移作为部署管线的一部分
812
813
 
@@ -823,7 +824,7 @@ $$ LANGUAGE plpgsql;
823
824
  ## 参考资源
824
825
 
825
826
  - [ISO/IEC 9075 — SQL 标准](https://www.iso.org/standard/76583.html)
826
- - [Use The Index, Luke](https://use-the-index-luke.com/) — SQL 索引与调校
827
+ - [Use The Index, Luke](https://use-the-index-luke.com/) — SQL 索引与调优
827
828
  - [SQL Style Guide](https://www.sqlstyle.guide/) — 一致的 SQL 格式
828
829
  - [Martin Fowler — 演进式数据库设计](https://martinfowler.com/articles/evodb.html)
829
830
  - [Designing Data-Intensive Applications](https://dataintensive.net/) — Martin Kleppmann
@@ -831,6 +832,6 @@ $$ LANGUAGE plpgsql;
831
832
 
832
833
  ---
833
834
 
834
- ## 授权
835
+ ## 许可
835
836
 
836
- 本标准以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权发布。
837
+ 本标准以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 许可发布。