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,8 +2,14 @@
2
2
  source: ../../../../skills/adr-assistant/guide.md
3
3
  source_version: 1.0.0
4
4
  translation_version: 1.0.0
5
- last_synced: 2026-03-26
5
+ last_synced: 2026-10-11
6
+ source_hash: 77b62e5cf96f
6
7
  status: current
8
+ scope: universal
9
+ description: |
10
+ 创建与管理架构决策记录(ADR)的指南。
11
+ 使用时机:架构决策、技术选型、设计取舍。
12
+ Keywords: ADR, architecture decision, decision record, trade-off, 架构决策, 决策记录.
7
13
  ---
8
14
 
9
15
  # 架构决策记录助手指南
@@ -14,22 +20,252 @@ status: current
14
20
  **最后更新**: 2026-03-26
15
21
  **适用范围**: 所有软件项目
16
22
  **范畴**: universal
23
+ **类型**: 有核心标准支撑的技能(core: adr-standards.md)
17
24
 
18
25
  ---
19
26
 
20
27
  ## 目的
21
28
 
22
- 开发过程中的技术决策常常遗失。架构决策记录通过建立轻量级、版本控制的决策日志来解决这个问题。
29
+ 开发过程中的技术决策常常遗失——埋没在 Slack 讨论串、会议记录中,或被彻底遗忘。当新成员加入,或几个月后重新审视系统时,「为什么要这样做?」这个问题找不到明确答案。
30
+
31
+ 架构决策记录通过为重要决策建立轻量级、受版本控制的日志来解决这个问题:
32
+
33
+ ```
34
+ Decision Made → ADR Written → Stored in Repo → Available Forever
35
+ ```
36
+
37
+ 本技能将 ADR 整合进 UDS 工作流程:
38
+
39
+ ```
40
+ /brainstorm → /sdd → /adr → Implementation
41
+ ▲ ▲
42
+ Existing (NEW)
43
+ ```
44
+
45
+ ---
46
+
47
+ ## 详细工作流程
48
+
49
+ ### 阶段 1:CAPTURE——定义决策背景
50
+
51
+ 在分析选项之前,先清楚说明需要决定什么,以及为什么。
52
+
53
+ **步骤:**
54
+
55
+ 1. **识别触发因素**——是什么事件或需求促成了这项决策?
56
+ - 新功能需求
57
+ - 性能瓶颈
58
+ - 技术生命周期终止(end-of-life)
59
+ - 扩展挑战
60
+
61
+ 2. **定义约束**——哪些因素限制了解决方案的范围?
62
+ - 预算/时程
63
+ - 团队技能与产能
64
+ - 与既有系统的兼容性
65
+ - 法规要求
66
+
67
+ 3. **列出决策驱动因素**——哪些准则最重要?
68
+ - 性能 vs. 开发速度
69
+ - 一致性 vs. 灵活性
70
+ - 成本 vs. 能力
71
+
72
+ **示例:**
73
+
74
+ ```markdown
75
+ ## Context
76
+
77
+ Our API response times have degraded to 2s p95 as the user base grew
78
+ from 10K to 100K. The current monolithic architecture processes all
79
+ requests synchronously. We need to decide how to address this before
80
+ the next growth milestone (500K users, Q3 2026).
81
+
82
+ ## Decision Drivers
83
+
84
+ - Must reduce p95 latency to < 500ms
85
+ - Team has strong experience in Python, limited in Go
86
+ - Budget for infrastructure is capped at $5K/month
87
+ - Must be implementable within 6 weeks
88
+ ```
89
+
90
+ ---
91
+
92
+ ### 阶段 2:ANALYZE——评估选项
93
+
94
+ 至少探索 2 个选项。针对每个选项,记录:
95
+
96
+ | 方面 | 要记录的内容 |
97
+ |--------|----------------|
98
+ | **描述** | 此选项包含哪些内容? |
99
+ | **优点** | 好处与优势 |
100
+ | **缺点** | 缺陷与风险 |
101
+ | **成本** | 实现工作量与持续成本 |
102
+ | **风险** | 可能出什么问题? |
103
+
104
+ **比较矩阵模板:**
105
+
106
+ ```markdown
107
+ | Criteria | Option 1: Cache | Option 2: CQRS | Option 3: Microservices |
108
+ |----------|-----------------|----------------|------------------------|
109
+ | Latency improvement | Moderate | High | High |
110
+ | Implementation effort | Low (2 weeks) | Medium (4 weeks) | High (8+ weeks) |
111
+ | Team familiarity | High | Medium | Low |
112
+ | Operational complexity | Low | Medium | High |
113
+ | Future scalability | Limited | Good | Excellent |
114
+ ```
115
+
116
+ ---
117
+
118
+ ### 阶段 3:DECIDE——选择并说明理由
119
+
120
+ 选择最能满足决策驱动因素的选项。理由说明应当:
121
+
122
+ 1. **引用驱动因素**——说明所选选项如何满足各项准则
123
+ 2. **承认权衡取舍**——坦白说明你放弃了什么
124
+ 3. **解释为何否决其他方案**——帮助未来的读者理解推理过程
125
+
126
+ **示例:**
127
+
128
+ ```markdown
129
+ ## Decision Outcome
130
+
131
+ Chosen option: **Option 2: CQRS**, because it provides the best
132
+ balance of latency improvement and implementation feasibility.
133
+
134
+ - Meets the < 500ms p95 target (estimated 200ms with read replicas)
135
+ - Implementable within 4 weeks by the existing team
136
+ - Option 1 (caching) was rejected: insufficient for 500K users
137
+ - Option 3 (microservices) was rejected: exceeds 6-week timeline
138
+ ```
139
+
140
+ ---
141
+
142
+ ### 阶段 4:RECORD——撰写 ADR 文件
143
+
144
+ 依照 `core/adr-standards.md` 的标准模板生成 ADR。
145
+
146
+ **文件命名:** `ADR-NNN-short-description.md`
147
+
148
+ **决定下一个编号:**
149
+ 1. 检查 `docs/adr/` 中既有的 ADR
150
+ 2. 使用下一个连续编号
151
+ 3. 若尚无任何 ADR,从 `ADR-001` 开始
152
+
153
+ ---
154
+
155
+ ### 阶段 5:LINK——交叉引用
156
+
157
+ 在 ADR 与相关产物之间建立双向链接:
158
+
159
+ | 从 | 到 | 方式 |
160
+ |------|----|-----|
161
+ | ADR | SPEC | 在 ADR 的 `Technical Story` 字段加入 SPEC-ID |
162
+ | SPEC | ADR | 在 SPEC 的 Technical Design 章节加入 ADR 引用 |
163
+ | ADR | Code | 在代码注释中加入 ADR 引用:`// See ADR-003` |
164
+ | Code | ADR | 在 ADR 的 Links 章节加入代码文件路径 |
165
+ | ADR | PR | 在 PR 描述中引用 ADR |
166
+ | ADR | ADR | 链接相关或取代它的 ADR |
167
+
168
+ ---
169
+
170
+ ## 示例
171
+
172
+ ### 示例 1:数据库选型
173
+
174
+ ```markdown
175
+ # ADR-001: Use PostgreSQL for Primary Database
176
+
177
+ - **Status**: Accepted
178
+ - **Date**: 2026-03-15
179
+ - **Deciders**: Backend team
180
+ - **Technical Story**: SPEC-CORE-001
181
+
182
+ ## Context
183
+
184
+ We are starting a new e-commerce platform and need to select a primary
185
+ database. The system will handle product catalog, user accounts, orders,
186
+ and inventory with an expected initial load of 10K concurrent users.
187
+
188
+ ## Decision Drivers
189
+
190
+ - ACID compliance for financial transactions
191
+ - JSON support for flexible product attributes
192
+ - Team experience and hiring pool
193
+ - Managed service availability on AWS
194
+
195
+ ## Considered Options
196
+
197
+ 1. PostgreSQL
198
+ 2. MySQL 8.0
199
+ 3. MongoDB
200
+
201
+ ## Decision Outcome
202
+
203
+ Chosen option: **PostgreSQL**, because it provides the best combination
204
+ of ACID compliance, JSON support (JSONB), and team familiarity.
205
+
206
+ ### Consequences
207
+
208
+ **Good:**
209
+ - Native JSONB support eliminates need for separate document store
210
+ - Strong ecosystem (PostGIS, full-text search, extensions)
211
+ - Available as managed service (RDS, Aurora)
212
+
213
+ **Bad:**
214
+ - Slightly higher memory usage than MySQL for simple queries
215
+ - Team needs training on PostgreSQL-specific features (CTEs, window functions)
216
+
217
+ ## Links
218
+
219
+ - [SPEC-CORE-001](../specs/SPEC-CORE-001-platform-architecture.md)
220
+ ```
221
+
222
+ ### 示例 2:取代既有决策
223
+
224
+ ```markdown
225
+ # ADR-005: Migrate from REST to GraphQL for Mobile API
226
+
227
+ - **Status**: Accepted
228
+ - **Date**: 2026-06-01
229
+ - **Deciders**: Mobile team, Backend team
230
+ - **Technical Story**: SPEC-MOBILE-003
231
+ - **Supersedes**: [ADR-002](ADR-002-rest-api-design.md)
232
+
233
+ ## Context
234
+
235
+ ADR-002 established REST as our API standard. After 6 months of mobile
236
+ development, we're experiencing significant over-fetching and
237
+ under-fetching issues, requiring multiple round-trips per screen.
238
+
239
+ [... rest of ADR ...]
240
+ ```
241
+
242
+ ---
243
+
244
+ ## 常见错误
245
+
246
+ | 错误 | 影响 | 修正 |
247
+ |---------|--------|-----|
248
+ | 决策几周后才写 ADR | 背景与替代方案已被遗忘 | 在决策当下或决策后立即撰写 |
249
+ | 只列出所选选项 | 没有记录否决了什么及原因 | 始终包含至少 2 个替代方案 |
250
+ | 修改已接受的 ADR | 历史背景遗失 | 建立新的 ADR 来取代旧的 |
251
+ | ADR 写得过于详细 | 没人会读 | 控制在 1-2 页;链接到详细文档 |
252
+ | 未链接到代码 | ADR 与实现脱节 | 在 Links 章节加入代码引用 |
23
253
 
24
254
  ---
25
255
 
26
256
  ## 常见问题
27
257
 
28
258
  **Q:ADR 和 SDD 规格有什么不同?**
29
- A:SDD 规格定义*要建什么*和*怎么建*。ADR 记录*为什么*选择了某个方案而非其他。
259
+ A:SDD 规格定义*要建什么*和*怎么建*。ADR 记录*为什么*选择了某个方案而非其他。两者相辅相成——一份 SDD 可能引用多份 ADR。
30
260
 
31
261
  **Q:每个技术决策都需要 ADR 吗?**
32
- A:不需要。使用「6 个月法则」:如果 6 个月后有人可能问「为什么?」,就写一份 ADR。
262
+ A:不需要。只有具长期影响的重要决策才需要。使用「6 个月法则」:如果 6 个月后有人可能问「为什么?」,就写一份 ADR。
263
+
264
+ **Q:ADR 可以被否决吗?**
265
+ A:可以。如果提议的 ADR 未被接受,直接删除即可。只有已接受的决策需要保留。
266
+
267
+ **Q:谁应该写 ADR?**
268
+ A:任何参与决策的人。实务上通常由技术负责人或架构师起草,再由团队审查。
33
269
 
34
270
  ---
35
271
 
@@ -1,8 +1,9 @@
1
1
  ---
2
2
  source: ../../../../skills/agents/README.md
3
3
  source_version: 1.1.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-02-05
4
+ translation_version: 1.1.0
5
+ last_synced: 2026-10-11
6
+ source_hash: 3783bc43d9d6
6
7
  status: current
7
8
  ---
8
9
 
@@ -26,58 +27,58 @@ UDS 代理是专门的 AI 子代理,可以协调处理复杂的开发工作流
26
27
 
27
28
  ```yaml
28
29
  ---
29
- # === 必填字段 ===
30
- name: agent-name # 唯一标识符(kebab-case)
31
- version: 1.0.0 # 语义版本
32
- description: | # 用于 AI 匹配的多行描述
33
- 代理目的的简要描述。
34
- 关键字: keyword1, keyword2, keyword3.
35
-
36
- # === 角色配置 ===
30
+ # === REQUIRED FIELDS ===
31
+ name: agent-name # Unique identifier (kebab-case)
32
+ version: 1.0.0 # Semantic version
33
+ description: | # Multi-line description for AI matching
34
+ Brief description of the agent's purpose.
35
+ Keywords: keyword1, keyword2, keyword3.
36
+
37
+ # === ROLE CONFIGURATION ===
37
38
  role: specialist # orchestrator | specialist | reviewer
38
- expertise: # 领域专长
39
+ expertise: # Domain expertise areas
39
40
  - system-design
40
41
  - api-design
41
42
  - database-modeling
42
43
 
43
- # === 工具权限(Claude Code Task 工具)===
44
- # 指定此代理可以使用哪些工具
44
+ # === TOOL PERMISSIONS (Claude Code Task tool) ===
45
+ # Specify which tools this agent can use
45
46
  allowed-tools:
46
- - Read # 文件读取
47
- - Glob # 模式匹配
48
- - Grep # 内容搜索
49
- - Bash(git:*) # 仅 Git 命令
50
- - WebFetch # 网页抓取
51
- - WebSearch # 网页搜索
52
- disallowed-tools: # 明确封锁的工具
53
- - Write # 不可写入文件
54
- - Edit # 不可编辑文件
55
-
56
- # === 技能依赖 ===
57
- # 为此代理提供上下文/知识的技能
47
+ - Read # File reading
48
+ - Glob # Pattern matching
49
+ - Grep # Content search
50
+ - Bash(git:*) # Git commands only
51
+ - WebFetch # Web fetching
52
+ - WebSearch # Web search
53
+ disallowed-tools: # Explicitly blocked tools
54
+ - Write # No file writing
55
+ - Edit # No file editing
56
+
57
+ # === SKILL DEPENDENCIES ===
58
+ # Skills that provide context/knowledge to this agent
58
59
  skills:
59
- - spec-driven-dev # 技能名称引用
60
+ - spec-driven-dev # Skill name reference
60
61
  - testing-guide
61
62
 
62
- # === 模型偏好(仅 Claude Code)===
63
- model: claude-sonnet-4-20250514 # 偏好模型
64
- temperature: 0.3 # 响应创造性(0.0-1.0)
63
+ # === MODEL PREFERENCES (Claude Code only) ===
64
+ model: claude-sonnet-4-20250514 # Preferred model
65
+ temperature: 0.3 # Response creativity (0.0-1.0)
65
66
 
66
- # === 上下文策略(RLM 启发)===
67
- # 处理大型代码库和长上下文的配置
67
+ # === CONTEXT STRATEGY (RLM-inspired) ===
68
+ # Configuration for handling large codebases and long contexts
68
69
  context-strategy:
69
70
  mode: adaptive # full | chunked | adaptive
70
- max-chunk-size: 50000 # 每个区块的最大 token 数
71
- overlap: 500 # 区块间的 token 重叠
71
+ max-chunk-size: 50000 # Maximum tokens per chunk
72
+ overlap: 500 # Token overlap between chunks
72
73
  analysis-pattern: hierarchical # hierarchical | parallel | sequential
73
74
 
74
- # === 触发条件 ===
75
+ # === TRIGGER CONDITIONS ===
75
76
  triggers:
76
- keywords: # 这些关键字自动启动
77
+ keywords: # Auto-activate on these keywords
77
78
  - architecture
78
79
  - system design
79
- - 架构设计
80
- commands: # 调用此代理的斜线命令
80
+ - 架構設計
81
+ commands: # Slash commands that invoke this agent
81
82
  - /architect
82
83
  ---
83
84
  ```
@@ -85,7 +86,7 @@ triggers:
85
86
  ### 角色类型
86
87
 
87
88
  | 角色 | 描述 | 使用案例 |
88
- |------|------|---------|
89
+ |------|-------------|----------|
89
90
  | `orchestrator` | 协调多个代理 | 复杂工作流程、功能开发 |
90
91
  | `specialist` | 特定领域的深度专业 | 架构、测试、文档 |
91
92
  | `reviewer` | 评估并提供反馈 | 代码审查、规格审查、PR 审查 |
@@ -93,22 +94,22 @@ triggers:
93
94
  ### 工具权限模式
94
95
 
95
96
  ```yaml
96
- # 完全工具访问(未指定时的默认)
97
+ # Full tool access (default if not specified)
97
98
  allowed-tools: [*]
98
99
 
99
- # 只读代理
100
+ # Read-only agent
100
101
  allowed-tools: [Read, Glob, Grep]
101
102
  disallowed-tools: [Write, Edit, Bash]
102
103
 
103
- # 仅限 Git 的 bash 访问
104
+ # Git-only bash access
104
105
  allowed-tools:
105
- - Bash(git:*) # 仅 git 命令
106
- - Bash(npm:test) # 仅 npm test
106
+ - Bash(git:*) # Only git commands
107
+ - Bash(npm:test) # Only npm test
107
108
 
108
- # 特定文件模式
109
+ # Specific file patterns
109
110
  allowed-tools:
110
- - Write(*.md) # 仅 markdown 文件
111
- - Edit(src/**) # 仅 src 目录
111
+ - Write(*.md) # Only markdown files
112
+ - Edit(src/**) # Only src directory
112
113
  ```
113
114
 
114
115
  ### 上下文策略配置(RLM 启发)
@@ -118,7 +119,7 @@ allowed-tools:
118
119
  #### 模式选项
119
120
 
120
121
  | 模式 | 描述 | 使用案例 |
121
- |------|------|---------|
122
+ |------|-------------|----------|
122
123
  | `full` | 一次加载完整上下文 | 小项目、文档任务 |
123
124
  | `chunked` | 将上下文分成固定大小的区块 | 顺序代码审查、大型文件分析 |
124
125
  | `adaptive` | 根据内容结构动态调整 | 复杂分析、架构探索 |
@@ -126,49 +127,145 @@ allowed-tools:
126
127
  #### 分析模式
127
128
 
128
129
  | 模式 | 描述 | 最适合 |
129
- |------|------|--------|
130
+ |---------|-------------|----------|
130
131
  | `hierarchical` | 先分析高层结构,然后深入细节 | 架构分析、系统设计 |
131
132
  | `parallel` | 同时处理多个区段 | 独立模块分析、规格审查 |
132
133
  | `sequential` | 依序处理区段,保留上下文 | 代码审查、逐步分析 |
133
134
 
135
+ #### 配置示例
136
+
137
+ ```yaml
138
+ # For architecture analysis (need overview first)
139
+ context-strategy:
140
+ mode: adaptive
141
+ max-chunk-size: 50000
142
+ overlap: 500
143
+ analysis-pattern: hierarchical
144
+
145
+ # For code review (sequential processing)
146
+ context-strategy:
147
+ mode: chunked
148
+ max-chunk-size: 30000
149
+ overlap: 200
150
+ analysis-pattern: sequential
151
+
152
+ # For documentation (need full context)
153
+ context-strategy:
154
+ mode: full
155
+ analysis-pattern: hierarchical
156
+ ```
157
+
158
+ ### 代理签名(v1.2.0,DSPy 启发)
159
+
160
+ 可选的 `signatures` 字段为代理操作定义结构化的输入/输出契约,从而能够验证代理输出,并让工作流程中的组合更清晰。
161
+
162
+ ```yaml
163
+ ---
164
+ name: spec-analyst
165
+ # ... other fields ...
166
+
167
+ signatures:
168
+ forward-analysis:
169
+ description: Transform requirements into a specification document
170
+ inputs:
171
+ - name: feature_request
172
+ type: text
173
+ required: true
174
+ description: User's feature request or requirement description
175
+ - name: codebase_context
176
+ type: file_list
177
+ required: false
178
+ description: Relevant source files for context
179
+ outputs:
180
+ - name: spec_document
181
+ type: markdown
182
+ validation: "Contains Summary, Motivation, Acceptance Criteria sections"
183
+ - name: read_first_list
184
+ type: yaml_list
185
+ validation: "Each entry has path and reason fields"
186
+
187
+ reverse-analysis:
188
+ description: Extract specification from existing code
189
+ inputs:
190
+ - name: source_files
191
+ type: file_list
192
+ required: true
193
+ outputs:
194
+ - name: reverse_spec
195
+ type: markdown
196
+ validation: "Contains Discovered Behaviors, Business Rules, Gaps sections"
197
+ - name: certainty_report
198
+ type: table
199
+ validation: "Each item tagged [Confirmed], [Inferred], [Assumption], or [Unknown]"
200
+ ---
201
+ ```
202
+
203
+ #### 签名字段
204
+
205
+ | 字段 | 类型 | 描述 |
206
+ |-------|------|-------------|
207
+ | `inputs[].name` | string | 输入参数名称 |
208
+ | `inputs[].type` | string | `text`、`markdown`、`file_list`、`yaml_list`、`json` |
209
+ | `inputs[].required` | boolean | 此输入是否为必填 |
210
+ | `outputs[].name` | string | 输出产物名称 |
211
+ | `outputs[].type` | string | 输出格式类型 |
212
+ | `outputs[].validation` | string | 人类可读的验证标准 |
213
+
214
+ #### 好处
215
+
216
+ - **可组合性**:工作流程可验证某一步骤的输出是否符合下一步骤预期的输入
217
+ - **文档化**:签名可作为代理能力的 API 契约
218
+ - **验证**:输出验证标准使确定性的质量检查成为可能
219
+
220
+ ---
221
+
222
+ ### 跨工具执行模式
223
+
224
+ | AI 工具 | 执行模式 | 运作方式 |
225
+ |---------|---------------|--------------|
226
+ | Claude Code | `task` | 使用 Task 工具生成独立的子代理 |
227
+ | OpenCode | `task` | 类似的 Task 工具支持 |
228
+ | Cursor / Windsurf | `inline` | 将 AGENT.md 作为上下文前缀注入 |
229
+ | Copilot / Gemini | `inline` | 转换为提示词片段 |
230
+
134
231
  ## 内建代理
135
232
 
136
233
  | 代理 | 角色 | 描述 |
137
- |------|------|------|
138
- | [code-architect](../../../../skills/agents/code-architect.md) | specialist | 软件架构和系统设计 |
139
- | [test-specialist](../../../../skills/agents/test-specialist.md) | specialist | 测试策略和测试实现 |
140
- | [reviewer](../../../../skills/agents/reviewer.md) | reviewer | 代码审查和质量评估 |
141
- | [doc-writer](../../../../skills/agents/doc-writer.md) | specialist | 文档和技术写作 |
142
- | [spec-analyst](../../../../skills/agents/spec-analyst.md) | specialist | 规格分析和需求萃取 |
234
+ |-------|------|-------------|
235
+ | [code-architect](./code-architect.md) | specialist | 软件架构和系统设计 |
236
+ | [test-specialist](./test-specialist.md) | specialist | 测试策略和测试实现 |
237
+ | [reviewer](./reviewer.md) | reviewer | 代码审查和质量评估 |
238
+ | [doc-writer](./doc-writer.md) | specialist | 文档和技术写作 |
239
+ | [spec-analyst](./spec-analyst.md) | specialist | 规格分析和需求萃取 |
143
240
 
144
241
  ## 使用方式
145
242
 
146
243
  ### CLI 安装
147
244
 
148
245
  ```bash
149
- # 列出可用的代理
246
+ # List available agents
150
247
  uds agent list
151
248
 
152
- # 将特定代理安装到项目
249
+ # Install specific agent to project
153
250
  uds agent install code-architect
154
251
 
155
- # 安装所有代理
252
+ # Install all agents
156
253
  uds agent install all
157
254
 
158
- # 安装到用户目录(全局)
255
+ # Install to user directory (global)
159
256
  uds agent install code-architect --global
160
257
  ```
161
258
 
162
259
  ### 在 Claude Code 中直接调用
163
260
 
164
261
  ```
165
- /architect [任务描述]
262
+ /architect [task description]
166
263
  ```
167
264
 
168
265
  或通过自然语言触发:
169
266
 
170
267
  ```
171
- 请帮我设计新认证系统的架构。
268
+ Please help me design the architecture for a new authentication system.
172
269
  ```
173
270
 
174
271
  ## 创建自定义代理
@@ -176,7 +273,7 @@ uds agent install code-architect --global
176
273
  ### 1. 创建 AGENT.md 文件
177
274
 
178
275
  ```bash
179
- # 在你的项目中
276
+ # In your project
180
277
  mkdir -p .claude/agents
181
278
  touch .claude/agents/my-agent.md
182
279
  ```
@@ -188,8 +285,8 @@ touch .claude/agents/my-agent.md
188
285
  name: my-custom-agent
189
286
  version: 1.0.0
190
287
  description: |
191
- 针对特定项目需求的自定义代理。
192
- 关键字: custom, specific, project.
288
+ Custom agent for specific project needs.
289
+ Keywords: custom, specific, project.
193
290
 
194
291
  role: specialist
195
292
  expertise: [domain-specific]
@@ -205,28 +302,28 @@ triggers:
205
302
  ### 3. 撰写代理指令
206
303
 
207
304
  ```markdown
208
- # 我的自定义代理
305
+ # My Custom Agent
209
306
 
210
- ## 目的
307
+ ## Purpose
211
308
 
212
- 描述此代理的功能。
309
+ Describe what this agent does.
213
310
 
214
- ## 工作流程
311
+ ## Workflow
215
312
 
216
- 1. 步骤一
217
- 2. 步骤二
218
- 3. 步骤三
313
+ 1. Step one
314
+ 2. Step two
315
+ 3. Step three
219
316
 
220
- ## 指南
317
+ ## Guidelines
221
318
 
222
- - 指南 1
223
- - 指南 2
319
+ - Guideline 1
320
+ - Guideline 2
224
321
  ```
225
322
 
226
323
  ## 代理 vs 技能比较
227
324
 
228
325
  | 方面 | 技能 | 代理 |
229
- |------|------|------|
326
+ |--------|-------|-------|
230
327
  | **目的** | 提供知识/上下文 | 执行自主任务 |
231
328
  | **执行** | 作为上下文加载 | 作为子代理生成(或内嵌) |
232
329
  | **状态** | 无状态 | 可维护任务状态 |
@@ -243,24 +340,24 @@ triggers:
243
340
  name: feature-development
244
341
  steps:
245
342
  - agent: spec-analyst
246
- task: 分析需求
343
+ task: Analyze requirements
247
344
  - agent: code-architect
248
- task: 设计解决方案
345
+ task: Design solution
249
346
  - agent: test-specialist
250
- task: 定义测试策略
251
- - manual: 实现
347
+ task: Define test strategy
348
+ - manual: Implementation
252
349
  - agent: reviewer
253
- task: 代码审查
350
+ task: Code review
254
351
  ```
255
352
 
256
- 请参阅 [workflows/README.md](../../../../skills/workflows/README.md) 获取工作流程文档。
353
+ 请参阅 [workflows/README.md](../workflows/README.md) 获取工作流程文档。
257
354
 
258
355
  ---
259
356
 
260
357
  ## 相关资源
261
358
 
262
359
  - [技能文档](../README.md)
263
- - [工作流程文档](../../../../skills/workflows/README.md)
360
+ - [工作流程文档](../workflows/README.md)
264
361
  - [AI 代理路径配置](../../../../cli/src/config/ai-agent-paths.js)
265
362
 
266
363
  ---
@@ -268,7 +365,8 @@ steps:
268
365
  ## 版本历史
269
366
 
270
367
  | 版本 | 日期 | 变更 |
271
- |------|------|------|
368
+ |---------|------|---------|
369
+ | 1.2.0 | 2026-03-17 | 添加代理签名(DSPy 启发的结构化输入/输出契约) |
272
370
  | 1.1.0 | 2026-01-21 | 添加 RLM 启发的 context-strategy 配置 |
273
371
  | 1.0.0 | 2026-01-20 | 初始发布 |
274
372
 
@@ -3,7 +3,9 @@ name: code-architect
3
3
  version: 1.1.0
4
4
  source: skills/agents/code-architect.md
5
5
  source_version: 1.1.0
6
- translation_version: 1.0.0
6
+ translation_version: 1.1.0
7
+ source_hash: 7c8d78dc5b73
8
+ last_synced: 2026-10-11
7
9
  status: current
8
10
  description: |
9
11
  系统设计与技术规划的 software architecture 专家。