universal-dev-standards 6.13.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 (693) 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 +254 -4
  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/ai/standards/turn-completion-integrity.ai.yaml +14 -7
  15. package/bundled/core/ai-response-navigation.md +128 -12
  16. package/bundled/core/code-review-checklist.md +20 -2
  17. package/bundled/core/commit-message-guide.md +22 -19
  18. package/bundled/core/developer-memory.md +12 -2
  19. package/bundled/core/full-coverage-testing.md +99 -5
  20. package/bundled/core/open-work-tracking.md +251 -8
  21. package/bundled/core/pipeline-security-gates.md +63 -0
  22. package/bundled/core/project-context-memory.md +10 -2
  23. package/bundled/core/turn-completion-integrity.md +58 -11
  24. package/bundled/extensions/frameworks/fat-free-patterns.md +937 -0
  25. package/bundled/extensions/languages/csharp-style.md +464 -0
  26. package/bundled/extensions/languages/php-style.md +700 -0
  27. package/bundled/extensions/locales/zh-cn.md +717 -0
  28. package/bundled/extensions/locales/zh-tw.md +717 -0
  29. package/bundled/hooks/check-turn-completion-agy.mjs +147 -0
  30. package/bundled/hooks/turn-completion/locales/en.mjs +54 -5
  31. package/bundled/hooks/turn-completion/locales/zh-TW.mjs +37 -6
  32. package/bundled/locales/COVERAGE.md +5 -4
  33. package/bundled/locales/zh-CN/CHANGELOG.md +211 -3
  34. package/bundled/locales/zh-CN/README.md +3 -3
  35. package/bundled/locales/zh-CN/SECURITY.md +3 -1
  36. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  37. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +81 -101
  38. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  39. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +14 -9
  40. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +88 -81
  41. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +31 -17
  42. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +56 -47
  43. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  44. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  45. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  46. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  47. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  48. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  49. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  50. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  51. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  52. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  53. package/bundled/locales/zh-CN/core/ai-response-navigation.md +111 -12
  54. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  55. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  56. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  57. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  58. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  59. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  60. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  61. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  62. package/bundled/locales/zh-CN/core/code-review-checklist.md +54 -23
  63. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  64. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  65. package/bundled/locales/zh-CN/core/developer-memory.md +159 -60
  66. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  67. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  68. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  69. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  70. package/bundled/locales/zh-CN/core/full-coverage-testing.md +103 -9
  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/pipeline-integration-standards.md +2 -1
  80. package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
  81. package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
  82. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  83. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  84. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  85. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  86. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  87. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  88. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  89. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  90. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  91. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  92. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  93. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  94. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  95. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  96. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  97. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  98. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  99. package/bundled/locales/zh-CN/core/turn-completion-integrity.md +46 -13
  100. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  101. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  102. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  103. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  104. package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
  105. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +11 -2
  106. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  107. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +76 -40
  108. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +32 -15
  109. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  110. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +139 -138
  111. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  112. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +12 -3
  113. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  114. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  115. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +46 -0
  116. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  117. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  118. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  119. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  120. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  121. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  122. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  123. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  124. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  125. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  126. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  127. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  128. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  129. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  130. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  131. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  132. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  133. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  134. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  135. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  136. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  137. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  138. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  139. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  140. package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
  141. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  142. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  143. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  144. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  145. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  146. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  147. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  148. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  149. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  150. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  151. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  152. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  153. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  154. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  155. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  156. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  157. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  158. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  159. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  160. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  161. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  162. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  163. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  164. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  165. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  166. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  167. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  168. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  169. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  170. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  171. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  172. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  173. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  174. package/bundled/locales/zh-CN/skills/README.md +3 -1
  175. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  176. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  177. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  178. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  179. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  180. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  181. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  182. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  183. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  184. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  185. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  186. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  187. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  188. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  189. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  190. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  191. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  192. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  193. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  194. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  195. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  196. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  197. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  198. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  199. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  200. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  201. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  202. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  203. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  204. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  205. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  206. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  207. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  208. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  209. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  210. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  211. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  212. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  213. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  214. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  215. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  216. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  217. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  218. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  219. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  220. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  221. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  222. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  223. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  224. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  225. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  226. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  227. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  228. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  229. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  230. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  231. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  232. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  233. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  234. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  235. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  236. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  237. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  238. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  239. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  240. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  241. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  242. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  243. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  244. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  245. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  246. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  247. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  248. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  249. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +2 -2
  250. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  251. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  252. package/bundled/locales/zh-CN/skills/comprehension-ladder/SKILL.md +289 -0
  253. package/bundled/locales/zh-CN/skills/comprehension-ladder/eval-cases.md +261 -0
  254. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  255. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  256. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  257. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  258. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  259. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  260. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  261. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  262. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  263. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  264. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  265. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  266. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  267. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  268. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  269. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  270. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  271. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  272. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  273. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  274. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  275. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  276. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  277. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  278. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  279. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  280. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  281. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  282. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  283. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  284. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  285. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  286. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  287. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  288. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  289. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  290. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  291. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  292. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  293. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  294. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  295. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  296. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  297. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  298. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  299. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  300. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  301. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  302. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  303. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  304. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  305. package/bundled/locales/zh-TW/CHANGELOG.md +211 -3
  306. package/bundled/locales/zh-TW/README.md +3 -3
  307. package/bundled/locales/zh-TW/SECURITY.md +3 -1
  308. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  309. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +59 -97
  310. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  311. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +10 -2
  312. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +17 -10
  313. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +19 -5
  314. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +14 -5
  315. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  316. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  317. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  318. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  319. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  320. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  321. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  322. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  323. package/bundled/locales/zh-TW/core/ai-response-navigation.md +111 -13
  324. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  325. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  326. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  327. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  328. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  329. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  330. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  331. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  332. package/bundled/locales/zh-TW/core/code-review-checklist.md +36 -7
  333. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  334. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  335. package/bundled/locales/zh-TW/core/developer-memory.md +111 -12
  336. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  337. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  338. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  339. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  340. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  341. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  342. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  343. package/bundled/locales/zh-TW/core/full-coverage-testing.md +103 -9
  344. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  345. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  346. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  347. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  348. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  349. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  350. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  351. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  352. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  353. package/bundled/locales/zh-TW/core/open-work-tracking.md +164 -9
  354. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  355. package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
  356. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  357. package/bundled/locales/zh-TW/core/project-context-memory.md +215 -31
  358. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  359. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  360. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  361. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  362. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  363. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  364. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  365. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  366. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  367. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  368. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  369. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  370. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  371. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  372. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  373. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  374. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  375. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  376. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  377. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  378. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  379. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  380. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  381. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  382. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  383. package/bundled/locales/zh-TW/core/turn-completion-integrity.md +46 -13
  384. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  385. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  386. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  387. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  388. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  389. package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
  390. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +11 -2
  391. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  392. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +69 -33
  393. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  394. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +32 -15
  395. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  396. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +8 -7
  397. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  398. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +11 -2
  399. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  400. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  401. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +46 -0
  402. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  403. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  404. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  405. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  406. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  407. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  408. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  409. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  410. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  411. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  412. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  413. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  414. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  415. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  416. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  417. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  418. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  419. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  420. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  421. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  422. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  423. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  424. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  425. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  426. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  427. package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
  428. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  429. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  430. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  431. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  432. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  433. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  434. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  435. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  436. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  437. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  438. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  439. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  440. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  441. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  442. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  443. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  444. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  445. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  446. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  447. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  448. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  449. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  450. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  451. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  452. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  453. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  454. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  455. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  456. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  457. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  458. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  459. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  460. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  461. package/bundled/locales/zh-TW/skills/README.md +3 -1
  462. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  463. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  464. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  465. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  466. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  467. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  468. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  469. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  470. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  471. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  472. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  473. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  474. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  475. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  476. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  477. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  478. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  479. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  480. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  481. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  482. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  483. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  484. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  485. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  486. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  487. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  488. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  489. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  490. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  491. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  492. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  493. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  494. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  495. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  496. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  497. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  498. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  499. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  500. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  501. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  502. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  503. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  504. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  505. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  506. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  507. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  508. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  509. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  510. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  511. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  512. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  513. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  514. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  515. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  516. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  517. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  518. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  519. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  520. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  521. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  522. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  523. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  524. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  525. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  526. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  527. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  528. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  529. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  530. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  531. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  532. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  533. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  534. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  535. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  536. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  537. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  538. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  539. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  540. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  541. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  542. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  543. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  544. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  545. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  546. package/bundled/locales/zh-TW/skills/comprehension-ladder/SKILL.md +289 -0
  547. package/bundled/locales/zh-TW/skills/comprehension-ladder/eval-cases.md +261 -0
  548. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  549. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  550. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  551. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  552. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  553. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  554. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  555. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  556. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  557. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  558. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  559. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  560. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  561. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  562. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  563. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  564. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  565. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  566. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  567. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  568. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  569. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  570. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  571. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  572. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  573. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  574. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  575. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  576. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  577. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  578. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  579. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  580. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  581. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  582. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  583. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  584. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  585. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  586. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  587. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  588. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  589. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  590. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  591. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  592. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  593. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  594. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  595. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  596. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  597. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  598. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  599. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  600. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  601. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  602. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  603. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  604. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  605. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  606. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  607. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  608. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  609. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  610. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  611. package/bundled/skills/README.md +1 -0
  612. package/bundled/skills/SKILL_NAMING.md +9 -0
  613. package/bundled/skills/commit-standards/SKILL.md +2 -2
  614. package/bundled/skills/commit-standards/guide.md +3 -2
  615. package/bundled/skills/commit-standards/language-options.md +19 -17
  616. package/bundled/skills/comprehension-ladder/SKILL.md +283 -0
  617. package/bundled/skills/comprehension-ladder/eval-cases.md +255 -0
  618. package/bundled/templates/gates/check-anti-fake-tests.mjs +1291 -0
  619. package/bundled/templates/gates/check-stubs.mjs +644 -0
  620. package/package.json +5 -3
  621. package/src/commands/audit.js +20 -2
  622. package/src/commands/check.js +155 -28
  623. package/src/commands/deps.js +31 -1
  624. package/src/commands/hitl.js +3 -0
  625. package/src/commands/init.js +173 -49
  626. package/src/commands/list.js +12 -3
  627. package/src/commands/mcp.js +2 -3
  628. package/src/commands/open-work.js +123 -0
  629. package/src/commands/quickstart.js +29 -13
  630. package/src/commands/release.js +102 -19
  631. package/src/commands/run-intent.js +10 -0
  632. package/src/commands/simulate.js +20 -8
  633. package/src/commands/skills.js +59 -33
  634. package/src/commands/spec-split.js +30 -17
  635. package/src/commands/spec.js +55 -21
  636. package/src/commands/uninstall.js +146 -32
  637. package/src/commands/update.js +471 -93
  638. package/src/core/install-records.js +192 -0
  639. package/src/core/manifest.js +12 -10
  640. package/src/core/marketplace-sentinel.js +5 -0
  641. package/src/core/open-work-config.js +122 -0
  642. package/src/core/project-config.js +92 -38
  643. package/src/flows/init-flow.js +10 -0
  644. package/src/hitl/manager.js +4 -2
  645. package/src/i18n/messages.js +413 -78
  646. package/src/installers/hooks-installer.js +320 -24
  647. package/src/installers/integration-installer.js +5 -1
  648. package/src/installers/skills-installer.js +3 -1
  649. package/src/installers/standards-installer.js +16 -23
  650. package/src/mcp/__tests__/server.test.js +0 -1
  651. package/src/mcp/server.js +16 -4
  652. package/src/prompts/init.js +148 -13
  653. package/src/reconciler/backup-locations.js +80 -0
  654. package/src/reconciler/backup-manager.js +451 -123
  655. package/src/reconciler/index.js +86 -10
  656. package/src/reconciler/install-roots.js +90 -0
  657. package/src/reconciler/plan-executor.js +37 -15
  658. package/src/uninstallers/hook-uninstaller.js +323 -33
  659. package/src/uninstallers/integration-uninstaller.js +35 -5
  660. package/src/uninstallers/skills-uninstaller.js +95 -16
  661. package/src/uninstallers/standards-uninstaller.js +56 -7
  662. package/src/utils/agents-installer.js +10 -17
  663. package/src/utils/available-standards-report.js +144 -0
  664. package/src/utils/available-standards.js +216 -0
  665. package/src/utils/command-hash-ownership.js +103 -0
  666. package/src/utils/commit-message-judge.js +155 -0
  667. package/src/utils/copier.js +80 -2
  668. package/src/utils/deps-applicability.js +25 -0
  669. package/src/utils/detector.js +46 -1
  670. package/src/utils/friction-detector.js +27 -0
  671. package/src/utils/gate-scripts.js +141 -0
  672. package/src/utils/git-hooks.js +139 -7
  673. package/src/utils/hasher.js +36 -0
  674. package/src/utils/health-scorer.js +10 -7
  675. package/src/utils/installed-names-ownership.js +114 -0
  676. package/src/utils/integration-generator.js +36 -24
  677. package/src/utils/legacy-hook-migration.js +112 -0
  678. package/src/utils/locale.js +19 -0
  679. package/src/utils/open-work-tracking.mjs +1754 -0
  680. package/src/utils/prompt-closed.js +18 -0
  681. package/src/utils/sdd-header.js +66 -0
  682. package/src/utils/skill-frontmatter.js +102 -0
  683. package/src/utils/skill-hash-ownership.js +64 -0
  684. package/src/utils/skill-name-collision.js +169 -0
  685. package/src/utils/skills-install-paths.js +114 -0
  686. package/src/utils/skills-installer.js +75 -106
  687. package/src/utils/standard-validator.js +98 -27
  688. package/src/utils/test-change-check.js +160 -0
  689. package/src/utils/test-policy.js +214 -0
  690. package/src/utils/transient-fs.js +113 -0
  691. package/src/utils/update-summary.js +29 -0
  692. package/src/vibe/micro-spec.js +15 -0
  693. package/standards-registry.json +48 -9
@@ -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
 
@@ -1,19 +1,21 @@
1
1
  ---
2
2
  source: ../../../core/developer-memory.md
3
- source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-02-07
6
- status: stale
3
+ source_version: 1.2.1
4
+ translation_version: 1.2.1
5
+ last_synced: 2026-10-11
6
+ source_hash: 4f480ae3038e
7
+ status: current
7
8
  ---
8
9
 
9
10
  # 開發者持久記憶標準
10
11
 
11
12
  > [English](../../../core/developer-memory.md) | **繁體中文**
12
13
 
13
- **版本**: 1.0.0
14
- **最後更新**: 2026-02-07
14
+ **版本**: 1.2.1
15
+ **最後更新**: 2026-10-07
15
16
  **適用範圍**: 所有使用 AI 助手的軟體專案
16
17
  **範圍**: 通用 (Universal)
18
+ **負責規格**: XSPEC-291(developer-memory 沒有專屬的功能 XSPEC;由 XSPEC-291 負責)
17
19
  **產業標準**: 無 (UDS 原創)
18
20
 
19
21
  ---
@@ -241,11 +243,13 @@ AI 掃描記憶庫並產生審查報告,涵蓋:
241
243
 
242
244
  #### 退役建議
243
245
 
244
- | 觸發條件 | 動作 |
245
- |---------|------|
246
- | `confidence < 0.2` | 建議退役 |
247
- | 超過 180 天未浮現且 `confidence < 0.5` | 建議退役 |
248
- | 5+ 筆 `invalid` 回饋 | 建議退役 |
246
+ 以下閾值為 UDS 預設值(可依專案設定);每個值都記錄了理由,使其可供稽核而非任意設定。
247
+
248
+ | 觸發條件 | 動作 | 理由 |
249
+ |---------|------|------|
250
+ | `confidence < 0.2` | 建議退役 | 一再被判定無效的知識,雜訊多於訊號 |
251
+ | 超過 180 天未浮現且 `confidence < 0.5` | 建議退役 | 半年未被使用再加上低信心度,代表此記憶已與當前工作無關;180 天的時間窗與下方「過時偵測」的過時/衰減模型一致 |
252
+ | 5+ 筆 `invalid` 回饋 | 建議退役 | 持續的負面回饋表示此記憶有誤或已過時 |
249
253
 
250
254
  #### 過時偵測
251
255
 
@@ -254,6 +258,26 @@ AI 掃描記憶庫並產生審查報告,涵蓋:
254
258
  | `validity.type == "versioned"` 且版本已過時 | 標記為過時 |
255
259
  | `validity.type == "temporal"` 且 `expires_at` 已過 | 標記為已過期 |
256
260
  | `validity.type == "evergreen"` | 跳過版本檢查 |
261
+ | 被召回的記憶引用的檔案路徑或符號(函式/類別)已不存在於該位置,或已移動 | 標記為 `code-reference` 過時——見下方 |
262
+
263
+ #### 程式碼參照過時(`code-reference`)
264
+
265
+ 程式碼會移動;針對舊位置記錄的記憶不會自行更新。此檢查用於捕捉以下情況:記憶的洞察仍然成立,但其引用(檔案路徑或函式/類別名稱)已不成立。
266
+
267
+ 此檢查沿用 **[Knowledge Graph Memory](knowledge-graph-memory.md) §2 已定義的兩種運作模式**,而不另創第三種:
268
+
269
+ | 模式 | 時機 | 方式 |
270
+ |------|------|------|
271
+ | 降級模式(無圖引擎) | 任何工具皆可、無需額外設定——預設模式 | 使用記憶前,助手自行確認所引用的路徑/符號仍存在(`Glob`/`Grep`/`Read`)——與 §5 記憶驗證原則既有要求的機制相同 |
272
+ | 引擎模式(已建立圖引擎索引,例如 [EngramGraph](https://github.com/AsiaOstrich/EngramGraph) 的 `egr refs check`) | 可用時 | 引擎回報每個引用的狀態:`present`/`moved`(附新位置)/`missing`/`unresolvable` |
273
+
274
+ > 正確實作在兩種模式下產生相同形狀的答案(Knowledge Graph Memory §2.2)——引擎模式只是更快更完整,並非本質不同。
275
+
276
+ **`unresolvable` 不得(MUST NOT)被視為 `present` 或 `missing`。** 它表示檢查器無法對該引用得出答案(例如超出索引範圍的跨 repo 參照,見 Knowledge Graph Memory §2.2 的跨域注意事項)——這種不確定性必須以獨立狀態傳達給助手,而不是悄悄變成偽陽性(視為仍有效)或偽陰性(視為已消失)。
277
+
278
+ **時機**:此檢查作為 `proactive-surfacing`(§4.1)的一部分執行——在記憶顯示之前,而非之後。引用解析為 `missing` 的記憶,不會被當作沒有任何變化般悄悄浮現。
279
+
280
+ **範圍(第一批)**:僅限檔案路徑與符號名稱(函式/類別名稱)。`file:line` 參照明確**不在範圍內**——行號會隨該檔案任何無關的編輯而漂移,這與「此檔案/符號已不存在」屬於不同種類的過時(見 DEC-115 OQ-1;預定於 2027-01-31 前重新檢視)。
257
281
 
258
282
  #### 修訂建議
259
283
 
@@ -284,6 +308,7 @@ AI 掃描記憶庫並產生審查報告,涵蓋:
284
308
  | 冷卻期 | 每條目 7 天 | 防止重複建議 |
285
309
  | 每次觸發上限 | 3–5 條 | 防止資訊過載 |
286
310
  | 溢出處理 | AI 歸納為分組洞察 | 當 > 5 個匹配時 |
311
+ | 程式碼參照檢查 | 浮現前執行(§3.4 `code-reference` 過時檢查,降級或引擎模式) | 檔案/符號引用已無法解析的記憶,不得未加標記就浮現 |
287
312
 
288
313
  #### 浮現格式
289
314
 
@@ -337,7 +362,35 @@ AI 應偵測這些開發者信號並建議記錄:
337
362
 
338
363
  ---
339
364
 
340
- ## 5. 雜訊控制
365
+ ## 5. Memory Verification Principle(記憶是線索,非結論)
366
+
367
+ > 借鑑 lintsinghua/claude-code-book 記憶驗證原則。
368
+
369
+ 記憶提供方向,但**不能直接作為事實使用**。使用記憶前須獨立驗證:
370
+
371
+ | 記憶內容 | 驗證方法 | 衝突時處理 |
372
+ |---------|---------|-----------|
373
+ | 檔案路徑 | 確認檔案仍存在(Glob/Read) | 標記記憶為 `needs-revision` |
374
+ | 函式名稱/API flag | 確認仍存在(Grep/文件) | 標記記憶為 `needs-revision` |
375
+ | 架構快照/Repo 狀態 | 優先信任 `git log`/原始碼 | 更新記憶為當前狀態 |
376
+ | 套件版本/相依 | 確認 package.json/lockfile | 以實際版本為準 |
377
+
378
+ ### 禁止行為
379
+
380
+ - 直接引用記憶中的具體 API/路徑/函式名稱推薦給使用者,未先驗證
381
+ - 宣稱「根據記憶,X 存在」而未執行獨立確認
382
+ - 因記憶內容與現況衝突時,選擇信任記憶而非當前觀察
383
+
384
+ ### 記憶用途場景
385
+
386
+ 記憶適合提供:
387
+ - **搜尋方向**:「這類問題上次在 X 模組找到答案」
388
+ - **模式線索**:「這個錯誤模式對應已知 pitfall MEM-2026-0042」
389
+ - **決策背景**:「此設計決策的歷史背景是...」
390
+
391
+ ---
392
+
393
+ ## 6. 雜訊控制
341
394
 
342
395
  ### 推送層級
343
396
 
@@ -517,6 +570,7 @@ by_category:
517
570
  - [AI 指令標準](ai-instruction-standards.md) — Token 效率優化的記憶系統指令格式
518
571
  - [AI 友善架構](ai-friendly-architecture.md) — 支援記憶整合的專案結構
519
572
  - [文件撰寫標準](documentation-writing-standards.md) — 記憶條目的撰寫品質
573
+ - [知識圖記憶](knowledge-graph-memory.md) — `code-reference` 過時檢查(§3.4)所沿用的降級/引擎雙模式來源
520
574
 
521
575
  ---
522
576
 
@@ -563,10 +617,55 @@ AI 載入 developer-memory.ai.yaml
563
617
 
564
618
  ---
565
619
 
620
+ ## 11. 工具採用範例:程式碼參照檢查(非規範性)
621
+
622
+ 本節示範一種將 `code-reference` 過時檢查(§3.4)接入工具自身自動化的方式。這僅是說明文件——UDS 不提供此 hook,`uds init`/`uds update` 也不會安裝它。
623
+
624
+ ### Claude Code
625
+
626
+ Claude Code 的自動記憶位於 repo 之外的 `~/.claude/projects/<project-path>/memory/`。`SessionStart` hook 可在該 session 第一次浮現記憶前,對該目錄執行檢查;沒有圖引擎時則退回降級模式:
627
+
628
+ ```bash
629
+ #!/usr/bin/env bash
630
+ # Illustrative only — not installed by any UDS command.
631
+ MEMORY_DIR="$HOME/.claude/projects/$(pwd | tr '/' '-')/memory"
632
+
633
+ if command -v egr >/dev/null 2>&1 && [ -f .engram/graph.db ]; then
634
+ # Engine mode (§3.4): egr resolves each cited path/symbol.
635
+ egr refs check "$MEMORY_DIR"
636
+ else
637
+ # Degraded mode (§3.4): no engine configured — nothing to run up
638
+ # front; the assistant verifies each citation itself before use (§5).
639
+ echo "[developer-memory] no graph engine detected; degraded mode applies"
640
+ fi
641
+ ```
642
+
643
+ ### 其他工具
644
+
645
+ 沒有 session 啟動 hook 的工具,仍可透過以下任一方式符合本標準:
646
+
647
+ - 在 repo 自身的指令檔(`CLAUDE.md`、`AGENTS.md`、`.cursorrules`、`.clinerules`、`.windsurfrules`、`copilot-instructions.md`、`GEMINI.md`、`.roo/rules/` 等)中加入規則,指示助手在依賴某筆記憶前先驗證其引用的路徑/符號;或
648
+ - 以 pre-commit 檢查掃描 repo 自身的指令檔,找出已無法解析的引用。
649
+
650
+ ---
651
+
652
+ ## 邊界:本標準不放什麼
653
+
654
+ 下面兩種資訊不在本標準的範圍內,寫進這裡是錯的:
655
+
656
+ - **個人、跨專案、可識別的資訊**(誰負責什麼、怎麼連到某個環境)。去識別化(見上方的 schema)會把這些剝掉,所以它們不能是一筆記憶條目。它們屬於使用者自己的 AI 工具的記憶——那種記憶綁定該使用者與該機器,不被分享。
657
+ - **專案之間的協調**(哪件工作在等哪件工作)。那是開放工作,不是記憶:見 [Open Work Tracking](open-work-tracking.md)(OWT-027–OWT-029)。
658
+
659
+ ---
660
+
566
661
  ## 版本歷史
567
662
 
568
663
  | 版本 | 日期 | 變更 |
569
664
  |------|------|------|
665
+ | 1.2.1 | 2026-10-07 | 新增:邊界章節——個人、跨專案、可識別的資訊,以及專案之間的協調,都不是記憶條目(XSPEC-460 R5;patch,無行為變更) |
666
+ | 1.2.0 | 2026-09-25 | 新增:審查(§3.4)的 `code-reference` 過時檢查——引用已移動/遺失之檔案路徑或符號的記憶會在浮現前被標記;沿用 Knowledge Graph Memory 的降級/引擎雙模式而非另創第三種;`unresolvable` 不得被解讀為 present 或 missing;範圍僅限檔案路徑與符號名稱(`file:line` 明確排除,DEC-115 OQ-1);§11 新增非規範性的 Claude Code 採用範例(DEC-115-L1) |
667
+ | 1.1.1 | 2026-06-18 | 新增:指向 XSPEC-291 的 `Owning Spec` 標頭(patch,無行為變更;XSPEC-291 §11 處置) |
668
+ | 1.1.0 | 2026-06-18 | 新增:退役建議閾值加上理由欄與可設定說明(XSPEC-292 T8) |
570
669
  | 1.0.0 | 2026-02-07 | 初始標準:schema、4 項操作、主動協議、雜訊控制、架構決策(Always-On Protocol) |
571
670
 
572
671
  ---
@@ -2,7 +2,8 @@
2
2
  source: ../../../core/documentation-lifecycle.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-03-27
5
+ last_synced: 2026-10-11
6
+ source_hash: 3b074ed1b0bb
6
7
  status: current
7
8
  ---
8
9