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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (711) hide show
  1. package/bin/uds.js +12 -1
  2. package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
  3. package/bundled/ai/standards/commit-message.ai.yaml +12 -2
  4. package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
  5. package/bundled/core/commit-message-guide.md +22 -19
  6. package/bundled/core/secret-management-standards.md +13 -1
  7. package/bundled/extensions/locales/zh-tw.md +19 -19
  8. package/bundled/hooks/validate-commit-msg.mjs +52 -9
  9. package/bundled/locales/zh-CN/CHANGELOG.md +2309 -1110
  10. package/bundled/locales/zh-CN/CLAUDE.md +987 -101
  11. package/bundled/locales/zh-CN/README.md +3 -3
  12. package/bundled/locales/zh-CN/SECURITY.md +3 -3
  13. package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
  14. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
  15. package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  16. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
  17. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
  18. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
  19. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
  20. package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
  21. package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
  22. package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
  23. package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
  24. package/bundled/locales/zh-CN/core/accessibility-standards.md +871 -62
  25. package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
  26. package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
  27. package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
  28. package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
  29. package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
  30. package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +311 -72
  31. package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
  32. package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
  33. package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
  34. package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
  35. package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
  36. package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
  37. package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
  38. package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
  39. package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
  40. package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
  41. package/bundled/locales/zh-CN/core/changelog-standards.md +485 -63
  42. package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
  43. package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
  44. package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
  45. package/bundled/locales/zh-CN/core/code-review-checklist.md +37 -23
  46. package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
  47. package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
  48. package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
  49. package/bundled/locales/zh-CN/core/database-standards.md +115 -114
  50. package/bundled/locales/zh-CN/core/deprecation-standards.md +155 -40
  51. package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
  52. package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
  53. package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
  54. package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
  55. package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
  56. package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
  57. package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
  58. package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
  59. package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
  60. package/bundled/locales/zh-CN/core/execution-history.md +2 -1
  61. package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
  62. package/bundled/locales/zh-CN/core/feature-flag-standards.md +202 -57
  63. package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
  64. package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
  65. package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
  66. package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
  67. package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
  68. package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
  69. package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
  70. package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
  71. package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
  72. package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
  73. package/bundled/locales/zh-CN/core/mutation-testing.md +45 -6
  74. package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
  75. package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
  76. package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
  77. package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
  78. package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
  79. package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
  80. package/bundled/locales/zh-CN/core/project-structure.md +550 -170
  81. package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
  82. package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
  83. package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
  84. package/bundled/locales/zh-CN/core/retrospective-standards.md +215 -22
  85. package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
  86. package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
  87. package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
  88. package/bundled/locales/zh-CN/core/security-decision.md +45 -70
  89. package/bundled/locales/zh-CN/core/security-standards.md +169 -16
  90. package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
  91. package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
  92. package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
  93. package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
  94. package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
  95. package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
  96. package/bundled/locales/zh-CN/core/supply-chain-security-standards.md +159 -32
  97. package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
  98. package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
  99. package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
  100. package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
  101. package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
  102. package/bundled/locales/zh-CN/core/test-governance.md +94 -43
  103. package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
  104. package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
  105. package/bundled/locales/zh-CN/core/token-budget.md +44 -80
  106. package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
  107. package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
  108. package/bundled/locales/zh-CN/core/versioning.md +737 -73
  109. package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
  110. package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
  111. package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
  112. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +2 -1
  113. package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
  114. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
  115. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
  116. package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
  117. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
  118. package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
  119. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
  120. package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
  121. package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
  122. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +2 -0
  123. package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
  124. package/bundled/locales/zh-CN/docs/user/README.md +4 -2
  125. package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
  126. package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
  127. package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
  128. package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
  129. package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
  130. package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  131. package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
  132. package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
  133. package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
  134. package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
  135. package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
  136. package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
  137. package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
  138. package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
  139. package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
  140. package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
  141. package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
  142. package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
  143. package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
  144. package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
  145. package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
  146. package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
  147. package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
  148. package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
  149. package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
  150. package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
  151. package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
  152. package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
  153. package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
  154. package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
  155. package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
  156. package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
  157. package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
  158. package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
  159. package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
  160. package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
  161. package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
  162. package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
  163. package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
  164. package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
  165. package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
  166. package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
  167. package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
  168. package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
  169. package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
  170. package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
  171. package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
  172. package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
  173. package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
  174. package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
  175. package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
  176. package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
  177. package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
  178. package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
  179. package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
  180. package/bundled/locales/zh-CN/skills/README.md +2 -1
  181. package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
  182. package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
  183. package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
  184. package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
  185. package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
  186. package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
  187. package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
  188. package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
  189. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
  190. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
  191. package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
  192. package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
  193. package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +217 -137
  194. package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
  195. package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
  196. package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  197. package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
  198. package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +148 -132
  199. package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
  200. package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
  201. package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
  202. package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
  203. package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +122 -121
  204. package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
  205. package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
  206. package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
  207. package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
  208. package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
  209. package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
  210. package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
  211. package/bundled/locales/zh-CN/skills/code-review-assistant/guide.md +119 -45
  212. package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
  213. package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
  214. package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
  215. package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
  216. package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
  217. package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
  218. package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
  219. package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
  220. package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
  221. package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
  222. package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
  223. package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
  224. package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
  225. package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
  226. package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
  227. package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
  228. package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
  229. package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
  230. package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
  231. package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
  232. package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
  233. package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
  234. package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
  235. package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
  236. package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
  237. package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
  238. package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
  239. package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
  240. package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
  241. package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
  242. package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
  243. package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
  244. package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
  245. package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
  246. package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
  247. package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
  248. package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
  249. package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
  250. package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
  251. package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
  252. package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
  253. package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
  254. package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
  255. package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
  256. package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
  257. package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
  258. package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
  259. package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
  260. package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
  261. package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +4 -4
  262. package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
  263. package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
  264. package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
  265. package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
  266. package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
  267. package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
  268. package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +4 -2
  269. package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
  270. package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
  271. package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
  272. package/bundled/locales/zh-CN/skills/docs-generator/guide.md +8 -7
  273. package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
  274. package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
  275. package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
  276. package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
  277. package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
  278. package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
  279. package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
  280. package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
  281. package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
  282. package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
  283. package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
  284. package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
  285. package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
  286. package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
  287. package/bundled/locales/zh-CN/skills/project-discovery/guide.md +158 -157
  288. package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
  289. package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
  290. package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
  291. package/bundled/locales/zh-CN/skills/refactoring-assistant/guide.md +172 -171
  292. package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
  293. package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
  294. package/bundled/locales/zh-CN/skills/release-standards/guide.md +51 -43
  295. package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
  296. package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
  297. package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
  298. package/bundled/locales/zh-CN/skills/requirement-assistant/guide.md +88 -79
  299. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
  300. package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
  301. package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
  302. package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +2 -2
  303. package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
  304. package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
  305. package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
  306. package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
  307. package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
  308. package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
  309. package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
  310. package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
  311. package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +2 -2
  312. package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
  313. package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
  314. package/bundled/locales/zh-CN/skills/tdd-assistant/guide.md +217 -156
  315. package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
  316. package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
  317. package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
  318. package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +25 -12
  319. package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
  320. package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
  321. package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
  322. package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
  323. package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
  324. package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
  325. package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
  326. package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
  327. package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
  328. package/bundled/locales/zh-TW/CHANGELOG.md +2282 -1112
  329. package/bundled/locales/zh-TW/CLAUDE.md +962 -76
  330. package/bundled/locales/zh-TW/README.md +3 -3
  331. package/bundled/locales/zh-TW/SECURITY.md +3 -3
  332. package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
  333. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
  334. package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
  335. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
  336. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
  337. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
  338. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
  339. package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
  340. package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
  341. package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
  342. package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
  343. package/bundled/locales/zh-TW/core/accessibility-standards.md +895 -46
  344. package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
  345. package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
  346. package/bundled/locales/zh-TW/core/agent-dispatch.md +102 -33
  347. package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
  348. package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
  349. package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
  350. package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
  351. package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
  352. package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
  353. package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
  354. package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
  355. package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
  356. package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
  357. package/bundled/locales/zh-TW/core/branch-completion.md +130 -34
  358. package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
  359. package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
  360. package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
  361. package/bundled/locales/zh-TW/core/chaos-engineering-standards.md +138 -36
  362. package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
  363. package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
  364. package/bundled/locales/zh-TW/core/code-review-checklist.md +19 -7
  365. package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
  366. package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
  367. package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
  368. package/bundled/locales/zh-TW/core/database-standards.md +2 -1
  369. package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
  370. package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
  371. package/bundled/locales/zh-TW/core/developer-memory.md +102 -12
  372. package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
  373. package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
  374. package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
  375. package/bundled/locales/zh-TW/core/environment-standards.md +250 -72
  376. package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
  377. package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
  378. package/bundled/locales/zh-TW/core/execution-history.md +2 -1
  379. package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
  380. package/bundled/locales/zh-TW/core/feature-flag-standards.md +202 -57
  381. package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
  382. package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
  383. package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
  384. package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
  385. package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +234 -487
  386. package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
  387. package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
  388. package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
  389. package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
  390. package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
  391. package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
  392. package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
  393. package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
  394. package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
  395. package/bundled/locales/zh-TW/core/observability-standards.md +284 -40
  396. package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
  397. package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
  398. package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
  399. package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
  400. package/bundled/locales/zh-TW/core/project-context-memory.md +210 -31
  401. package/bundled/locales/zh-TW/core/project-structure.md +240 -19
  402. package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
  403. package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
  404. package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
  405. package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
  406. package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
  407. package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
  408. package/bundled/locales/zh-TW/core/runbook-standards.md +296 -23
  409. package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
  410. package/bundled/locales/zh-TW/core/security-decision.md +43 -84
  411. package/bundled/locales/zh-TW/core/security-standards.md +204 -25
  412. package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
  413. package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
  414. package/bundled/locales/zh-TW/core/slo-standards.md +301 -49
  415. package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
  416. package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
  417. package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
  418. package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
  419. package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
  420. package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
  421. package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
  422. package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
  423. package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
  424. package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
  425. package/bundled/locales/zh-TW/core/test-governance.md +92 -32
  426. package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
  427. package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
  428. package/bundled/locales/zh-TW/core/token-budget.md +41 -112
  429. package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
  430. package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
  431. package/bundled/locales/zh-TW/core/versioning.md +6 -2
  432. package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
  433. package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
  434. package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
  435. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +2 -1
  436. package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
  437. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
  438. package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
  439. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
  440. package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
  441. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
  442. package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
  443. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
  444. package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
  445. package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
  446. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +2 -0
  447. package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
  448. package/bundled/locales/zh-TW/docs/user/README.md +2 -0
  449. package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
  450. package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
  451. package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
  452. package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
  453. package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
  454. package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
  455. package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
  456. package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
  457. package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
  458. package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
  459. package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
  460. package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
  461. package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
  462. package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
  463. package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
  464. package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
  465. package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
  466. package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
  467. package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
  468. package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +584 -475
  469. package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
  470. package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
  471. package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
  472. package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
  473. package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
  474. package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
  475. package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
  476. package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
  477. package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
  478. package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
  479. package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
  480. package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
  481. package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
  482. package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
  483. package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
  484. package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
  485. package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
  486. package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
  487. package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
  488. package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
  489. package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
  490. package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
  491. package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
  492. package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
  493. package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
  494. package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
  495. package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
  496. package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
  497. package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
  498. package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
  499. package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
  500. package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
  501. package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
  502. package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
  503. package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
  504. package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
  505. package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
  506. package/bundled/locales/zh-TW/skills/README.md +2 -1
  507. package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
  508. package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
  509. package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
  510. package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
  511. package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
  512. package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
  513. package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
  514. package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
  515. package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
  516. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
  517. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
  518. package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
  519. package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
  520. package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
  521. package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
  522. package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
  523. package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
  524. package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
  525. package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
  526. package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
  527. package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
  528. package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
  529. package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
  530. package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
  531. package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
  532. package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
  533. package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
  534. package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
  535. package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
  536. package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
  537. package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
  538. package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
  539. package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
  540. package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
  541. package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
  542. package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
  543. package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
  544. package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
  545. package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
  546. package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
  547. package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
  548. package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
  549. package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
  550. package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
  551. package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
  552. package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
  553. package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
  554. package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
  555. package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
  556. package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
  557. package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
  558. package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
  559. package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
  560. package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
  561. package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
  562. package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
  563. package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
  564. package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
  565. package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
  566. package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
  567. package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
  568. package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
  569. package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
  570. package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
  571. package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
  572. package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
  573. package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
  574. package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
  575. package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
  576. package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
  577. package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
  578. package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
  579. package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
  580. package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
  581. package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
  582. package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
  583. package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
  584. package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
  585. package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
  586. package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
  587. package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
  588. package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
  589. package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
  590. package/bundled/locales/zh-TW/skills/commit-standards/guide.md +137 -17
  591. package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
  592. package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
  593. package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
  594. package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
  595. package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
  596. package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
  597. package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
  598. package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
  599. package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
  600. package/bundled/locales/zh-TW/skills/docs-generator/guide.md +4 -3
  601. package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
  602. package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
  603. package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
  604. package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
  605. package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
  606. package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
  607. package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
  608. package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
  609. package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
  610. package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
  611. package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
  612. package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
  613. package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
  614. package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +85 -18
  615. package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
  616. package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
  617. package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
  618. package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
  619. package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
  620. package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
  621. package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
  622. package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
  623. package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +91 -45
  624. package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
  625. package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
  626. package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
  627. package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
  628. package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
  629. package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
  630. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
  631. package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
  632. package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
  633. package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
  634. package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
  635. package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
  636. package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
  637. package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
  638. package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
  639. package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
  640. package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
  641. package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
  642. package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
  643. package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
  644. package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
  645. package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
  646. package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
  647. package/bundled/locales/zh-TW/skills/tdd-assistant/language-examples.md +693 -47
  648. package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
  649. package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
  650. package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
  651. package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
  652. package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
  653. package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
  654. package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
  655. package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
  656. package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
  657. package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
  658. package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
  659. package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
  660. package/bundled/skills/.claude-plugin/plugin.json +71 -0
  661. package/bundled/skills/commit-standards/SKILL.md +2 -2
  662. package/bundled/skills/commit-standards/guide.md +3 -2
  663. package/bundled/skills/commit-standards/language-options.md +19 -17
  664. package/package.json +2 -2
  665. package/src/commands/audit.js +28 -1
  666. package/src/commands/check.js +72 -3
  667. package/src/commands/compile.js +37 -4
  668. package/src/commands/config.js +49 -24
  669. package/src/commands/init.js +78 -30
  670. package/src/commands/open-work.js +6 -2
  671. package/src/commands/release-messages.js +228 -0
  672. package/src/commands/release.js +127 -68
  673. package/src/commands/run-intent.js +11 -0
  674. package/src/commands/spec.js +4 -2
  675. package/src/commands/update.js +173 -20
  676. package/src/compilers/claude-code-compiler.js +9 -1
  677. package/src/config/ai-agent-paths.js +14 -1
  678. package/src/core/installed-formats.js +15 -0
  679. package/src/core/open-work-config.js +20 -1
  680. package/src/core/project-config.js +55 -0
  681. package/src/i18n/messages.js +106 -2
  682. package/src/installers/hooks-installer.js +1 -1
  683. package/src/installers/manifest-installer.js +1 -1
  684. package/src/installers/skills-installer.js +1 -1
  685. package/src/installers/standards-installer.js +3 -1
  686. package/src/mcp/server.js +9 -3
  687. package/src/prompts/init.js +26 -22
  688. package/src/reconciler/actual-state-scanner.js +2 -8
  689. package/src/reconciler/backup-locations.js +5 -0
  690. package/src/reconciler/backup-manager.js +19 -11
  691. package/src/reconciler/desired-state-calculator.js +89 -57
  692. package/src/reconciler/plan-executor.js +101 -8
  693. package/src/reconciler/recorded-versions.js +49 -0
  694. package/src/reconciler/relative-path.js +23 -0
  695. package/src/uninstallers/hook-uninstaller.js +9 -1
  696. package/src/uninstallers/skills-uninstaller.js +22 -3
  697. package/src/utils/available-standards-report.js +25 -4
  698. package/src/utils/available-standards.js +13 -3
  699. package/src/utils/build-manifest.js +1 -1
  700. package/src/utils/commit-message-judge.js +60 -13
  701. package/src/utils/friction-detector.js +23 -11
  702. package/src/utils/git-hooks.js +106 -4
  703. package/src/utils/integration-generator.js +95 -67
  704. package/src/utils/legacy-hook-migration.js +121 -2
  705. package/src/utils/open-work-tracking.mjs +105 -16
  706. package/src/utils/sdd-header.js +16 -4
  707. package/src/utils/skills-installer.js +2 -1
  708. package/src/utils/spinner.js +14 -4
  709. package/src/utils/standard-validator.js +3 -2
  710. package/standards-registry.json +10 -8
  711. package/bundled/locales/zh-TW/core/guides/testing-guide.md +0 -2280
@@ -1,20 +1,21 @@
1
1
  ---
2
2
  source: ../../../core/frontend-design-standards.md
3
- source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-04-20
6
- status: stale
3
+ source_version: 1.1.0
4
+ translation_version: 1.1.0
5
+ last_synced: 2026-10-16
6
+ source_hash: c9dc85d8ce95
7
+ status: current
7
8
  ---
8
9
 
9
10
  # 前端设计标准
10
11
 
11
- > **语言**: [English](../../../core/frontend-design-standards.md) | 简体中文
12
+ > **语言**: [English](../../../core/frontend-design-standards.md) | [繁體中文](../../zh-TW/core/frontend-design-standards.md) | 简体中文
12
13
 
13
- **版本**: 1.0.0
14
- **最后更新**: 2026-04-13
15
- **状态**: Active
14
+ **版本**: 1.1.0
15
+ **最后更新**: 2026-07-10
16
16
  **适用范围**: 所有具备前端用户界面的项目
17
- **参考**: DEC-029(awesome-design-md, MIT)、DEC-030(OpenAI Frontend Guide)
17
+ **范围**: universal
18
+ **参考**: [DEC-029](https://github.com/VoltAgent/awesome-design-md) (awesome-design-md, MIT), DEC-030 (OpenAI Frontend Guide)
18
19
 
19
20
  ---
20
21
 
@@ -22,19 +23,42 @@ status: stale
22
23
 
23
24
  本标准定义一套机器可读的前端设计规格格式(DESIGN.md),用于 AI 辅助开发。建立 9 段式 DESIGN.md 结构、强制设计 token 词汇、UI 硬性约束,以及反模式拒绝规则。
24
25
 
25
- 目标是通过结构化设计约束(而非自由形式的风格描述)确保 AI Agent 在不同执行情境下产生一致、高质量的 UI。
26
+ 目标是通过提供结构化设计约束——而非自由形式的风格描述——来确保 AI Agent 在不同运行中产生一致、高质量的 UI。
26
27
 
27
28
  **核心原则**:
28
- - DESIGN.md 是设计规格的唯一真实来源
29
+ - DESIGN.md 作为设计规格的唯一真实来源
29
30
  - 语义化 token 命名(框架无关)
30
- - 约束式提示:自由度越少 = UI 质量越高
31
- - 与源代码同步进行版本控制
31
+ - 基于约束的提示:自由度越少 = UI 质量越高
32
+ - 与源代码一同进行版本控制
33
+
34
+ ---
35
+
36
+ ## 目录
37
+
38
+ 1. [DESIGN.md 结构](#designmd-structure)
39
+ 2. [第 1 段:视觉主题与氛围](#section-1-visual-theme--mood)
40
+ 3. [第 2 段:色彩系统](#section-2-color-palette)
41
+ 4. [第 3 段:字体系统](#section-3-typography)
42
+ 5. [第 4 段:组件样式](#section-4-component-styling)
43
+ 6. [第 5 段:版面与间距](#section-5-layout--spacing)
44
+ 7. [第 6 段:层次感与阴影系统](#section-6-depth--shadow-system)
45
+ 8. [第 7 段:设计准则与反模式](#section-7-design-guidelines--anti-patterns)
46
+ 9. [第 8 段:响应式行为](#section-8-responsive-behavior)
47
+ 10. [第 9 段:Agent 提示参考](#section-9-agent-prompt-references)
48
+ 11. [语义色彩 Token](#semantic-color-tokens)
49
+ 12. [字体角色](#typography-roles)
50
+ 13. [间距尺度](#spacing-scale)
51
+ 14. [UI 硬性约束](#ui-hard-constraints)
52
+ 15. [反模式](#anti-patterns)
53
+ 16. [可选扩展:Token 插值与结构化组件](#optional-extension-token-interpolation--structured-components)
54
+ 17. [DESIGN.md 文件位置](#designmd-file-placement)
55
+ 18. [验证清单](#validation-checklist)
32
56
 
33
57
  ---
34
58
 
35
59
  ## DESIGN.md 结构
36
60
 
37
- DESIGN.md 是放在项目根目录的 Markdown 文件,作为机器可读的设计规格书。使用结构化 Markdown,人类与 AI Agent 皆可读取。
61
+ DESIGN.md 是放在项目根目录的 Markdown 文件,作为机器可读的设计规格书。使用人类与 AI Agent 皆可读取的结构化 Markdown。
38
62
 
39
63
  ```
40
64
  传统方式:Figma 设计稿 → 人类开发者 → 代码
@@ -70,30 +94,73 @@ DESIGN.md = 给 AI 读的设计规格书
70
94
  **目的**:定义产品的整体美学意图。AI Agent 在生成 UI 时以此作为高层次约束。
71
95
 
72
96
  **必填字段**:
73
- - `theme`: 单行风格描述(如「极简、专业、数据密集」)
74
- - `mood`: 情感品质(如「沉稳、专注、可信赖」)
75
- - `inspiration`: 参考产品或设计流派(如「Linear、Stripe dashboard」)
97
+ - `theme`: 单行风格描述(例如“极简、专业、数据密集”)
98
+ - `mood`: 情感品质(例如“沉稳、专注、可信赖”)
99
+ - `inspiration`: 参考产品或设计流派(例如“Linear、Stripe dashboard”)
76
100
  - `dark-mode`: 深色模式是 primary / secondary / 不支持
77
101
 
102
+ **示例**:
103
+ ```markdown
104
+ ## Visual Theme & Mood
105
+
106
+ - **Theme**: Minimal, professional, data-dense
107
+ - **Mood**: Calm, focused, trustworthy
108
+ - **Inspiration**: Linear app, Stripe dashboard
109
+ - **Dark Mode**: Primary (dark-first design)
110
+ ```
111
+
78
112
  ---
79
113
 
80
114
  ## 第 2 段:色彩系统
81
115
 
82
- **目的**:定义完整的语义色彩系统。所有颜色以语义 token 表示,不直接在代码中使用原始 hex 值。
116
+ **目的**:定义完整的语义色彩系统。所有颜色均表示为具名的语义 token——不直接在代码中使用原始 hex 值。
83
117
 
84
- **必填**:全部 5 个语义 token(见[语义色彩 Token](#语义色彩-token))
118
+ **必填**:全部 5 个语义 token(参见[语义色彩 Token](#semantic-color-tokens))
85
119
 
86
120
  **选填**:状态扩展 token(error、warning、success、info)、border、overlay。
87
121
 
122
+ **示例**:
123
+ ```markdown
124
+ ## Color Palette
125
+
126
+ ### Semantic Tokens (Required)
127
+ - **background**: `#0A0A0A` — Page background
128
+ - **surface**: `#1A1A1A` — Cards, panels, modals
129
+ - **primary-text**: `#F5F5F5` — Main body text
130
+ - **muted-text**: `#888888` — Secondary text, placeholders
131
+ - **accent**: `#6366F1` — CTA buttons, links, highlights
132
+
133
+ ### Extended Tokens (Optional)
134
+ - **error**: `#EF4444`
135
+ - **warning**: `#F59E0B`
136
+ - **success**: `#10B981`
137
+ - **border**: `#2A2A2A`
138
+ ```
139
+
88
140
  ---
89
141
 
90
142
  ## 第 3 段:字体系统
91
143
 
92
144
  **目的**:定义字体家族与字体层级角色。约束 AI 最多使用 2 个字体家族。
93
145
 
94
- **必填**:全部 4 个字体角色定义(见[字体角色](#字体角色))
146
+ **必填**:全部 4 个字体角色定义(参见[字体角色](#typography-roles))
95
147
 
96
- **约束**:最多 2 个字体家族(display + body)。使用 3 个以上属反模式。
148
+ **约束**:最多 2 个字体家族(display + body)。使用 3 个以上属于反模式。
149
+
150
+ **示例**:
151
+ ```markdown
152
+ ## Typography
153
+
154
+ ### Font Families (max 2)
155
+ - **Display font**: Inter (headings, display text)
156
+ - **Body font**: Inter (same family, different weights acceptable)
157
+
158
+ ### Typographic Scale
159
+ - **display**: 48px+, weight 700, line-height 1.1 — Hero titles
160
+ - **headline**: 24–32px, weight 600, line-height 1.3 — Section headings
161
+ - **body**: 16px, weight 400, line-height 1.6 — Main content
162
+ - **caption**: 12–14px, weight 400, line-height 1.4 — Labels, metadata
163
+ ```
97
164
 
98
165
  ---
99
166
 
@@ -107,122 +174,237 @@ DESIGN.md = 给 AI 读的设计规格书
107
174
  - 输入框样式
108
175
  - 卡片 / surface 样式
109
176
 
177
+ **示例**:
178
+ ```markdown
179
+ ## Component Styling
180
+
181
+ ### Border Radius
182
+ - **sm**: 4px (small elements, badges)
183
+ - **md**: 8px (buttons, inputs)
184
+ - **lg**: 12px (cards, modals)
185
+ - **full**: 9999px (pill badges, avatars)
186
+
187
+ ### Buttons
188
+ - **Primary**: `accent` background, `#FFFFFF` text, `md` radius
189
+ - **Secondary**: `surface` background, `primary-text` text, `md` radius, 1px border
190
+ - **Ghost**: Transparent background, `accent` text, no border
191
+
192
+ ### Inputs
193
+ - Background: `surface`
194
+ - Border: 1px solid `border`
195
+ - Focus: 2px ring in `accent`
196
+ - Radius: `md`
197
+ ```
198
+
110
199
  ---
111
200
 
112
201
  ## 第 5 段:版面与间距
113
202
 
114
- **目的**:定义间距尺度与网格系统。以 8px 基础网格,定义 7 个间距步骤。
203
+ **目的**:定义间距尺度与网格系统。基于 8px 基础网格,定义 7 个间距步骤。
204
+
205
+ **必填**:标准尺度的全部 7 个间距步骤(参见[间距尺度](#spacing-scale))
206
+
207
+ **示例**:
208
+ ```markdown
209
+ ## Layout & Spacing
115
210
 
116
- **必填**:标准尺度的全部 7 个间距步骤(见[间距尺度](#间距尺度))
211
+ ### Spacing Scale (8px base)
212
+ - **space-1**: 4px
213
+ - **space-2**: 8px
214
+ - **space-3**: 16px
215
+ - **space-4**: 24px
216
+ - **space-5**: 32px
217
+ - **space-6**: 48px
218
+ - **space-8**: 64px
219
+
220
+ ### Grid
221
+ - **Columns**: 12-column grid
222
+ - **Gutter**: space-4 (24px)
223
+ - **Max content width**: 1280px
224
+ - **Page padding**: space-4 (24px) on mobile, space-6 (48px) on desktop
225
+ ```
117
226
 
118
227
  ---
119
228
 
120
229
  ## 第 6 段:层次感与阴影系统
121
230
 
122
- **目的**:以阴影定义高度层次感,不依赖颜色建立视觉层级。
231
+ **目的**:以阴影定义高度层级。在不依赖颜色的情况下建立视觉层级。
232
+
233
+ **必填字段**:至少 3 个高度层级。
234
+
235
+ **示例**:
236
+ ```markdown
237
+ ## Depth & Shadow System
123
238
 
124
- **必填**:至少 3 个高度层级。
239
+ - **elevation-0**: No shadow (flat, on-surface elements)
240
+ - **elevation-1**: `0 1px 2px rgba(0,0,0,0.4)` (subtle, cards at rest)
241
+ - **elevation-2**: `0 4px 8px rgba(0,0,0,0.3)` (dropdowns, tooltips)
242
+ - **elevation-3**: `0 8px 24px rgba(0,0,0,0.5)` (modals, dialogs)
243
+ - **elevation-4**: `0 16px 48px rgba(0,0,0,0.6)` (full-screen overlays)
244
+ ```
125
245
 
126
246
  ---
127
247
 
128
248
  ## 第 7 段:设计准则与反模式
129
249
 
130
- **目的**:对 AI Agent 明确列出规则和禁止的 UI 模式。此段落是约束式提示的主要机制。
250
+ **目的**:为 AI Agent 制定明确的规则和禁止的 UI 模式。此段落是约束式提示的主要机制。
131
251
 
132
252
  **必填子段落**:
133
253
  1. UI 硬性约束(≥4 条规则)
134
254
  2. 反模式清单(≥5 个禁止模式)
135
255
 
256
+ 标准清单参见 [UI 硬性约束](#ui-hard-constraints) 与 [反模式](#anti-patterns)。
257
+
258
+ **示例**:
259
+ ```markdown
260
+ ## Design Guidelines & Anti-patterns
261
+
262
+ ### UI Hard Constraints
263
+ - Maximum 1 H1 per page
264
+ - Maximum 6 sections per page
265
+ - Maximum 2 font families
266
+ - Maximum 1 accent color (never mix multiple accent colors)
267
+ - Information hierarchy: Hero → Support → Detail → CTA
268
+
269
+ ### Anti-patterns (Forbidden)
270
+ - No floating badges (浮動徽章)
271
+ - No generic card layout as primary content structure
272
+ - No dashboard grid as homepage
273
+ - No more than 3 levels of visual nesting
274
+ - No color-only differentiation (always pair with icon or label)
275
+ - No decorative illustrations that don't serve information
276
+ - No competing CTAs of equal visual weight on the same screen
277
+ ```
278
+
136
279
  ---
137
280
 
138
281
  ## 第 8 段:响应式行为
139
282
 
140
- **目的**:定义断点与响应式规则。必须采用 Mobile-first 做法。
283
+ **目的**:定义断点与响应式规则。必须采用 Mobile-first 方法。
284
+
285
+ **必填字段**:至少 3 个断点(移动端、平板、桌面端)。
141
286
 
142
- **必填**:至少 3 个断点(mobile、tablet、desktop)。
287
+ **示例**:
288
+ ```markdown
289
+ ## Responsive Behavior
290
+
291
+ ### Breakpoints (Mobile-first)
292
+ - **xs**: < 480px (small phones)
293
+ - **sm**: ≥ 768px (tablets)
294
+ - **md**: ≥ 1024px (laptops)
295
+ - **lg**: ≥ 1280px (desktops)
296
+ - **xl**: ≥ 1536px (wide screens)
297
+
298
+ ### Rules
299
+ - Mobile-first CSS (min-width media queries)
300
+ - Single column on xs/sm, multi-column on md+
301
+ - Touch targets ≥ 44×44px on mobile
302
+ - Navigation collapses to hamburger/bottom bar on sm and below
303
+ ```
143
304
 
144
305
  ---
145
306
 
146
307
  ## 第 9 段:Agent 提示参考
147
308
 
148
- **目的**:设计意图的精简 AI 最优化摘要。AI Agent 应先读此段作快速定向,再查阅其他段落。
309
+ **目的**:设计意图的精炼、AI 优化摘要。AI Agent 在查阅其他段落之前,应先阅读此段落作为快速定向。
149
310
 
150
311
  **必填字段**:
151
- - `style-summary`: 1–2 句设计意图
152
- - `key-constraints`: 最关键规则的列表
153
- - `tone`: 设计带给用户的「感受」
312
+ - `style-summary`:1–2 句设计意图
313
+ - `key-constraints`:最关键规则的项目符号列表
314
+ - `tone`:设计带给用户的“感受”
315
+
316
+ **示例**:
317
+ ```markdown
318
+ ## Agent Prompt References
319
+
320
+ ### Style Summary
321
+ Dark, minimal, data-focused interface. Professional aesthetic prioritizing clarity over decoration.
322
+
323
+ ### Key Constraints for AI Generation
324
+ - Always use semantic token names (background, surface, accent) — never raw hex in components
325
+ - Every page has exactly 1 H1; sections ≤ 6
326
+ - accent (#6366F1) is the only allowed emphasis color
327
+ - Prefer text over decorative components; restraint over complexity
328
+
329
+ ### Tone
330
+ Calm, confident, technical. Similar to Linear or Vercel's dashboard aesthetic.
331
+ ```
154
332
 
155
333
  ---
156
334
 
157
335
  ## 语义色彩 Token
158
336
 
159
- 每个 DESIGN.md **必须**定义以下 5 个语义色彩 token。它们与框架无关,必须使用这些精确名称。
337
+ 以下 5 个语义色彩 token 在每个 DESIGN.md 中都是**必填**的。它们与框架无关,且必须使用这些完全相同的名称。
160
338
 
161
- | Token | 角色 | 对应示例 |
162
- |-------|------|---------|
163
- | `background` | 页面 / App 背景 | `#0A0A0A`(深色)/ `#FFFFFF`(浅色)|
164
- | `surface` | 卡片、面板、Modal | `#1A1A1A`(深色)/ `#F9FAFB`(浅色)|
165
- | `primary-text` | 主要正文 | `#F5F5F5`(深色)/ `#111827`(浅色)|
166
- | `muted-text` | 次要文字、placeholder | `#888888`(深色)/ `#6B7280`(浅色)|
167
- | `accent` | CTA 按钮、链接、强调 | `#6366F1`(靛蓝示例)|
339
+ | Token | 角色 | 映射至(示例) |
340
+ |-------|------|-------------------|
341
+ | `background` | 页面/应用背景 | `#0A0A0A`(深色)/ `#FFFFFF`(浅色) |
342
+ | `surface` | 卡片、面板、模态框 | `#1A1A1A`(深色)/ `#F9FAFB`(浅色) |
343
+ | `primary-text` | 主要正文文本 | `#F5F5F5`(深色)/ `#111827`(浅色) |
344
+ | `muted-text` | 次要文本、占位符 | `#888888`(深色)/ `#6B7280`(浅色) |
345
+ | `accent` | CTA 按钮、链接、高亮 | `#6366F1`(靛蓝示例) |
168
346
 
169
347
  **规则**:
170
- - Token 名称为 kebab-case,必须完全相符
348
+ - Token 名称为 kebab-case,且必须完全匹配
171
349
  - 每个 token 必须定义 hex 值
172
- - `accent` 必须是单一颜色,禁止多个强调色
173
- - 扩展 token(error、warning、success)为选填,但必须遵循相同命名模式
350
+ - `accent` 必须是单一颜色——严禁使用多个强调色
351
+ - 扩展 token(error、warning、success)为选填,但必须遵循相同的命名模式
174
352
 
175
353
  ---
176
354
 
177
355
  ## 字体角色
178
356
 
179
- 每个 DESIGN.md **必须**定义以下 4 个字体角色:
357
+ 以下 4 个字体层级角色在每个 DESIGN.md 中都是**必填**的:
180
358
 
181
359
  | 角色 | 大小 | 字重 | 行高 | 用途 |
182
- |------|------|------|------|------|
183
- | `display` | 48px+ | 700 | 1.1 | 英雄标题、展示文字 |
184
- | `headline` | 24–32px | 600 | 1.3 | 段落标题、卡片标题 |
185
- | `body` | 16px | 400 | 1.6 | 段落、主要内文 |
186
- | `caption` | 12–14px | 400 | 1.4 | 标签、Metadata、辅助文字 |
360
+ |------|------|--------|-------------|-------|
361
+ | `display` | 48px+ | 700 | 1.1 | Hero 标题、展示文字 |
362
+ | `headline` | 24–32px | 600 | 1.3 | 小节标题、卡片标题 |
363
+ | `body` | 16px | 400 | 1.6 | 段落、主要内容 |
364
+ | `caption` | 12–14px | 400 | 1.4 | 标签、元数据、辅助文本 |
187
365
 
188
366
  **规则**:
189
- - 角色名称为小写,必须完全相符
190
- - 4 个角色最多使用 2 个字体家族
191
- - 字体大小为最小值,响应式缩放可接受
367
+ - 角色名称为小写,且必须完全匹配
368
+ - 全部 4 个角色中最多使用 2 个字体家族
369
+ - 字体大小为最小值;允许响应式缩放
370
+ - `display` 和 `headline` 可共用一个字体家族;`body` 和 `caption` 共用另一个(或相同)
192
371
 
193
372
  ---
194
373
 
195
374
  ## 间距尺度
196
375
 
197
- 标准间距尺度以 8px 基础网格,定义 7 个命名步骤:
376
+ 标准间距尺度采用 8px 基础网格,包含 7 个命名步骤:
198
377
 
199
378
  | Token | 值 | 用途 |
200
- |-------|-----|------|
201
- | `space-1` | 4px | 图标内距、紧凑元素 |
202
- | `space-2` | 8px | 默认元素内距 |
379
+ |-------|-------|-------|
380
+ | `space-1` | 4px | 图标内边距、紧凑元素 |
381
+ | `space-2` | 8px | 默认元素内边距 |
203
382
  | `space-3` | 16px | 组件内部间距 |
204
- | `space-4` | 24px | 段落内距、Gutter |
383
+ | `space-4` | 24px | 小节内边距、槽道(gutters) |
205
384
  | `space-5` | 32px | 组件之间 |
206
- | `space-6` | 48px | 主要段落之间 |
207
- | `space-8` | 64px | 页面级别分隔 |
385
+ | `space-6` | 48px | 主要小节之间 |
386
+ | `space-8` | 64px | 页面级分隔 |
208
387
 
209
388
  **规则**:
210
- - 所有代码中的间距必须使用这些步骤 token,不得使用任意 px 值
211
- - `space-7` 刻意跳过(直接跳到 space-8=64px 维持视觉节奏)
389
+ - 代码中的所有间距必须使用这些步骤 token,不得使用任意像素值
390
+ - `space-7` 为刻意跳过(直接跳至 space-8 = 64px 以保持视觉节奏)
391
+ - 响应式调整仍必须使用尺度步骤(例如移动端使用 space-4,桌面端使用 space-6)
212
392
 
213
393
  ---
214
394
 
215
395
  ## UI 硬性约束
216
396
 
397
+ 这些约束适用于本标准下生成的每个 UI。它们践行了约束式提示:限制自由度可产生质量更高、更一致的 UI。
398
+
217
399
  | 约束 | 规则 | 理由 |
218
- |------|------|------|
219
- | H1 数量 | 每页最多 1 个 H1 | 清晰内容层级 |
220
- | 段落数量 | 每页最多 6 个段落 | 防止认知过载 |
221
- | 字体家族 | 最多 2 个字体家族 | 视觉一致性 |
222
- | 强调色 | 最多 1 个强调色 | 防止视觉噪音 |
400
+ |-----------|------|-----------|
401
+ | H1 数量 | 每页最多 1 个 H1 | 清晰的内容层级 |
402
+ | 小节数量 | 每页最多 6 个小节 | 防止认知过载 |
403
+ | 字体家族 | 最多 2 个字体家族 | 视觉连贯性 |
404
+ | 强调色 | 最多 1 个强调色 | 防止视觉噪点 |
223
405
  | 嵌套深度 | 最多 3 层视觉嵌套 | 可读性 |
224
406
  | 信息层级 | Hero → Support → Detail → CTA | 叙事结构 |
225
- | 触控目标 | 移动端最小 44×44px | 无障碍设计 |
407
+ | 触摸目标 | 移动端最小 44×44px | 无障碍设计 |
226
408
 
227
409
  ---
228
410
 
@@ -230,18 +412,100 @@ DESIGN.md = 给 AI 读的设计规格书
230
412
 
231
413
  以下 UI 模式为**禁止**。AI Agent 在生成前端代码或设计规格时必须拒绝这些模式。
232
414
 
233
- | 反模式 | 说明 | 建议替代方案 |
234
- |--------|------|------------|
235
- | `floating-badge` | 与内容脱离的浮动徽章 | 行内标签或状态指示器 |
236
- | `generic-card-layout` | 以完全相同的卡片堆叠作为主要内容 | 有清晰层级的多元内容结构 |
237
- | `dashboard-grid-as-homepage` | 营销首页看起来像数据 dashboard | Hero → Support → CTA 叙事首页 |
238
- | `competing-ctas` | 同一画面出现视觉权重相同的多个 CTA | 一个 primary CTA,零或一个 secondary CTA |
239
- | `color-only-differentiation` | 仅用颜色传达状态或类别 | 搭配图标、图案或文字标签 |
240
- | `decorative-overload` | 不传递信息的插图或动画 | 移除装饰性元素;偏好功能性视觉 |
241
- | `triple-nesting` | 视觉层级超过 3 层 | 扁平化结构;以留白作分隔 |
242
- | `rainbow-accents` | 多个强调/高亮色 | 单一强调色系统 |
415
+ | 反模式 | 说明 | 推荐替代方案 |
416
+ |-------------|-------------|----------------------|
417
+ | `floating-badge` | 脱离内容独立浮动的徽章 | 行内标签或状态指示器 |
418
+ | `generic-card-layout` | 以完全相同且无差异化的卡片堆叠作为主要内容 | 具有清晰层级的多样化内容结构 |
419
+ | `dashboard-grid-as-homepage` | 营销首页看起来像数据仪表盘 | 采用 Hero → Support → CTA 结构的叙事型首页 |
420
+ | `competing-ctas` | 同一屏幕上出现视觉权重相同的多个 CTA | 一个主要 CTA,零个或一个次要 CTA |
421
+ | `color-only-differentiation` | 仅使用颜色来传达状态或类别 | 将颜色与图标、图案或文本标签搭配使用 |
422
+ | `decorative-overload` | 不传达信息的插图或动画 | 移除装饰性元素;优先采用功能性视觉元素 |
423
+ | `triple-nesting` | 视觉层级超过 3 层 | 扁平化结构;使用留白进行分隔 |
424
+ | `rainbow-accents` | 多种强调/高亮颜色(紫色 CTA、橙色徽章、绿色标签) | 单一强调色系统 |
425
+
426
+ 最低要求:每个 DESIGN.md 的第 7 段中必须明确列出至少 5 个反模式。
427
+
428
+ ---
429
+
430
+ ## 可选扩展:Token 插值与结构化组件
431
+
432
+ > **状态**:可选、试验性(新增于 v1.1.0,2026-07-10)。**不**替代上述必填的 9 段式结构或经治理收敛的 5-token / 4-角色 / 7-步骤尺度——这是针对希望 DESIGN.md 本身承载结构化 token 引用而不仅是散文叙述的项目所提供的附加机器可解析层。省略此扩展的 DESIGN.md 依然完全合规。
433
+ >
434
+ > **来源**:2026-07-10 对 [DEC-029](https://github.com/VoltAgent/awesome-design-md) 上游(从 4,385★ 增长到 99,219★,现已正式成为 Google Stitch DESIGN.md 格式)的重新对齐审查发现,上游格式发展出了 YAML frontmatter token 字典和 `{category.token}` 插值语法,以及结构化的 `components:` 绑定块——这些是本标准原有的仅散文段落所不具备的功能。作为选用扩展而非破坏性变更被采纳,与本标准深思熟虑的 5-token 治理收敛保持一致(增加更多 token *不是*目标;让这 5 个 token *可被引用*才是)。
435
+
436
+ ### Token 注册表(YAML Frontmatter)
437
+
438
+ DESIGN.md 可以选择以一个 YAML frontmatter 块开头,以机器可解析的键值形式声明来自第 2/3/5 段的语义 token(以及第 4 段的圆角尺度),以便工具能够在无需重新解析散文叙述的情况下解析 `{category.token}` 引用。
439
+
440
+ ```yaml
441
+ ---
442
+ colors:
443
+ background: "#0A0A0A"
444
+ surface: "#1A1A1A"
445
+ primary-text: "#F5F5F5"
446
+ muted-text: "#888888"
447
+ accent: "#6366F1"
448
+ typography:
449
+ display: { size: "48px", weight: 700, line-height: 1.1 }
450
+ headline: { size: "24px", weight: 600, line-height: 1.3 }
451
+ body: { size: "16px", weight: 400, line-height: 1.6 }
452
+ caption: { size: "13px", weight: 400, line-height: 1.4 }
453
+ rounded:
454
+ sm: "4px"
455
+ md: "8px"
456
+ lg: "12px"
457
+ pill: "9999px"
458
+ spacing:
459
+ sm: "8px"
460
+ md: "24px"
461
+ lg: "48px"
462
+ ---
463
+ ```
464
+
465
+ **规则**:
466
+ - frontmatter 键(`colors`、`typography`、`rounded`、`spacing`)与第 2/3/5 段中已定义的 token 词汇 1:1 映射——此区块以可解析的形式**重申**这些 token,它不会引入新的 token。`colors` 的值必须匹配 5 个必填的语义 token(加上已在使用的任何可选扩展 token)。
467
+ - Frontmatter 是可选的。没有它的 DESIGN.md 依然有效;需要插值支持的工具则需要它。
468
+
469
+ ### 插值语法
470
+
471
+ 在散文叙述段落中(特别是第 4 段:组件样式),`{category.token}` 引用 frontmatter 注册表,而不是重申原始值:
472
+
473
+ ```markdown
474
+ ### Buttons
475
+ - **Primary**: `{colors.accent}` background, `{colors.background}` text, `{rounded.md}` radius, `{spacing.sm}` padding
476
+ ```
477
+
478
+ **规则**:
479
+ - 语法为 `{category.token}`——category 匹配 frontmatter 的顶层键,token 匹配其内部的键。
480
+ - 引用 frontmatter 中不存在的 category/token 属于验证错误,而不是静默回退。
481
+ - 插值是为了**文档/工具清晰度**,而非运行时模板引擎——DESIGN.md 依然是静态规格文件。
482
+
483
+ ### 结构化组件块(可选)
484
+
485
+ 第 4 段(组件样式)可以选择包含一个 `components:` 块,显式地将组件绑定到其 token 引用,以替代(或并存于)第 4 段示例中已有的散文叙述格式:
486
+
487
+ ```yaml
488
+ components:
489
+ button-primary:
490
+ backgroundColor: "{colors.accent}"
491
+ textColor: "{colors.background}"
492
+ rounded: "{rounded.md}"
493
+ padding: "{spacing.sm}"
494
+ card:
495
+ backgroundColor: "{colors.surface}"
496
+ rounded: "{rounded.lg}"
497
+ padding: "{spacing.md}"
498
+ ```
243
499
 
244
- 每个 DESIGN.md 的第 7 段必须明确列出至少 5 个反模式。
500
+ **规则**:
501
+ - 每个值都必须是 `{category.token}` 引用——`components:` 内部的原始 hex/px 值属于反模式(违背了集中管理 token 的初衷)。
502
+ - 此区块是对第 4 段散文描述的补充,而非替代——使用此扩展的项目仍应为人类读者填写第 4 段的散文叙述字段。
503
+
504
+ ### 非目标(明确未从上游采纳)
505
+
506
+ - **本标准不捆绑 lint CLI**——上游生态系统有一个独立的 `@google/design.md` npm 包用于验证;本标准不强制或捆绑特定的验证器。项目可独立采纳。
507
+ - **无特定于框架的导出格式**(React/Vue/CSS-in-JS 生成器)——根据本标准的核心原则(语义化 token 命名,框架无关)保持框架无关。
508
+ - **不扩展 5/4/7 token 数量**——插值语法使现有 token 可被引用;它不是添加更多 token 的许可。治理收敛(更少的 token = 更一致的 AI 输出)始终优先于粒度。
245
509
 
246
510
  ---
247
511
 
@@ -249,6 +513,16 @@ DESIGN.md = 给 AI 读的设计规格书
249
513
 
250
514
  DESIGN.md 必须放在**项目根目录**,与 README.md 同层。
251
515
 
516
+ ```
517
+ my-project/
518
+ ├── README.md ← project overview (for humans)
519
+ ├── DESIGN.md ← design specification (for humans + AI agents)
520
+ ├── CLAUDE.md ← AI assistant config (if applicable)
521
+ ├── src/
522
+ │ └── ...
523
+ └── package.json
524
+ ```
525
+
252
526
  **规则**:
253
527
  - 文件名:`DESIGN.md`(大小写必须完全相符)
254
528
  - 位置:仅在项目根目录(不在 `docs/`、`src/` 或子目录)
@@ -260,6 +534,8 @@ DESIGN.md 必须放在**项目根目录**,与 README.md 同层。
260
534
 
261
535
  ## 验证清单
262
536
 
537
+ 使用此清单验证 DESIGN.md 是否符合本标准:
538
+
263
539
  ### 结构
264
540
  - [ ] 全部 9 个段落依序存在
265
541
  - [ ] 文件位于项目根目录(与 README.md 同层)
@@ -273,6 +549,7 @@ DESIGN.md 必须放在**项目根目录**,与 README.md 同层。
273
549
  ### 字体系统(第 3 段)
274
550
  - [ ] 定义了全部 4 个角色:`display`、`headline`、`body`、`caption`
275
551
  - [ ] 最多使用 2 个字体家族
552
+ - [ ] 字体大小在指定范围内
276
553
 
277
554
  ### 间距(第 5 段)
278
555
  - [ ] 定义了全部 7 个间距步骤:space-1 到 space-8(无 space-7)
@@ -287,3 +564,9 @@ DESIGN.md 必须放在**项目根目录**,与 README.md 同层。
287
564
  - [ ] 风格摘要存在(1–2 句)
288
565
  - [ ] 关键约束列表存在
289
566
  - [ ] 氛围(tone)已定义
567
+
568
+ ### Token 插值扩展(可选——v1.1.0)
569
+ - [ ] 如果使用了 frontmatter token 注册表,所有 `colors` 键均匹配 5 个必填语义 token
570
+ - [ ] 如果使用了 `{category.token}` 插值,每个引用都能解析到一个 frontmatter 条目(无悬空引用)
571
+ - [ ] 如果使用了 `components:` 块,每个值都为 `{category.token}` 引用(无原始 hex/px 值)
572
+ - [ ] 缺少此扩展**不**属于合规失败——它是可选的