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
@@ -1,84 +1,933 @@
1
1
  ---
2
2
  source: ../../../core/accessibility-standards.md
3
- source_version: 1.0.0
4
- translation_version: 1.0.0
5
- last_synced: 2026-03-24
6
- status: stale
3
+ source_version: 1.1.0
4
+ translation_version: 1.1.0
5
+ last_synced: 2026-10-16
6
+ source_hash: 31c9a2ac18c2
7
+ status: current
7
8
  ---
8
9
 
9
10
  # 無障礙標準
10
11
 
11
12
  > **語言**: [English](../../../core/accessibility-standards.md) | 繁體中文
12
13
 
13
- **版本**: 1.0.0
14
- **最後更新**: 2026-01-29
14
+ **版本**: 1.1.0
15
+ **最後更新**: 2026-06-18
15
16
  **適用性**: 所有具有使用者介面的軟體專案
16
- **範圍**: 通用 (Universal)
17
- **業界標準**: WCAG 2.1/2.2、WAI-ARIA 1.2、Section 508
17
+ **範圍**: 通用 (universal)
18
+ **業界標準**: WCAG 2.1/2.2, WAI-ARIA 1.2, Section 508
18
19
  **參考**: [w3.org](https://www.w3.org/WAI/WCAG21/quickref/)
19
20
 
20
21
  ---
21
22
 
22
23
  ## 目的
23
24
 
24
- 本標準定義建立無障礙軟體的完整指南,確保軟體能被各種能力的人使用。本標準符合國際標準(包括 WCAG 2.1),並支持全球各地的無障礙法規合規。
25
+ 本標準定義建立無障礙軟體的完整指南,確保軟體能被具備不同能力的人士使用。本標準與包含 WCAG 2.1 在內的國際標準一致,並支援符合全球各地的無障礙法規。
25
26
 
26
27
  **參考標準**:
27
- - [WCAG 2.1](https://www.w3.org/WAI/WCAG21/quickref/) - 網頁內容無障礙指南
28
- - [WCAG 2.2](https://www.w3.org/TR/WCAG22/) - 最新 WCAG 版本(2023)
29
- - [WAI-ARIA 1.2](https://www.w3.org/TR/wai-aria-1.2/) - 無障礙富網際網路應用程式
28
+ - [WCAG 2.1](https://www.w3.org/WAI/WCAG21/quickref/) - 網頁內容無障礙指南 (Web Content Accessibility Guidelines)
29
+ - [WCAG 2.2](https://www.w3.org/TR/WCAG22/) - 最新 WCAG 版本 (2023)
30
+ - [WAI-ARIA 1.2](https://www.w3.org/TR/wai-aria-1.2/) - 可延伸無障礙網際網路應用程式 (Accessible Rich Internet Applications)
31
+ - [ISO/IEC 25010:2011](https://www.iso.org/standard/35733.html) - 易用性 > 無障礙性 (Usability > Accessibility)
30
32
  - [Section 508](https://www.section508.gov/) - 美國聯邦無障礙需求
31
33
  - [EN 301 549](https://www.etsi.org/deliver/etsi_en/301500_301599/301549/) - 歐洲無障礙標準
32
34
 
33
35
  ---
34
36
 
35
- ## 無障礙原則(POUR)
37
+ ## 目錄
36
38
 
37
- | 原則 | 說明 | 範例 |
38
- |------|------|------|
39
- | **可感知 (Perceivable)** | 資訊和使用者介面元件必須以使用者可感知的方式呈現 | 替代文字、字幕、對比度 |
40
- | **可操作 (Operable)** | 使用者介面元件和導航必須可操作 | 鍵盤導航、充足時間、防癲癇 |
41
- | **可理解 (Understandable)** | 資訊和使用者介面的操作必須可理解 | 可讀性、可預測、輸入協助 |
42
- | **穩健 (Robust)** | 內容必須足夠穩健,能被各種使用者代理正確解讀 | 相容性、解析、名稱/角色/值 |
39
+ 1. [無障礙原則 (POUR)](#accessibility-principles-pour)
40
+ 2. [WCAG 合規等級](#wcag-conformance-levels)
41
+ 3. [可感知 (Perceivable)](#perceivable)
42
+ 4. [可操作 (Operable)](#operable)
43
+ 5. [可理解 (Understandable)](#understandable)
44
+ 6. [穩健 (Robust)](#robust)
45
+ 7. [ARIA 指南](#aria-guidelines)
46
+ 8. [鍵盤導航](#keyboard-navigation)
47
+ 9. [色彩與對比](#color-and-contrast)
48
+ 10. [表單與輸入](#forms-and-inputs)
49
+ 11. [媒體無障礙](#media-accessibility)
50
+ 12. [測試與驗證](#testing-and-validation)
51
+ 13. [無障礙檢查清單](#accessibility-checklist)
52
+
53
+ ---
54
+
55
+ ## 無障礙原則 (POUR)
56
+
57
+ ```
58
+ ┌─────────────────────────────────────────────────────────────────┐
59
+ │ WCAG 2.1 POUR Principles │
60
+ ├─────────────────────────────────────────────────────────────────┤
61
+ │ │
62
+ │ P - PERCEIVABLE │
63
+ │ ├── Users must be able to perceive the information │
64
+ │ ├── Text alternatives for non-text content │
65
+ │ ├── Captions and alternatives for multimedia │
66
+ │ └── Content adaptable and distinguishable │
67
+ │ │
68
+ │ O - OPERABLE │
69
+ │ ├── All functionality available via keyboard │
70
+ │ ├── Users have enough time to read and use content │
71
+ │ ├── Content doesn't cause seizures │
72
+ │ └── Users can navigate and find content │
73
+ │ │
74
+ │ U - UNDERSTANDABLE │
75
+ │ ├── Text is readable and understandable │
76
+ │ ├── Content appears and operates predictably │
77
+ │ └── Users are helped to avoid and correct mistakes │
78
+ │ │
79
+ │ R - ROBUST │
80
+ │ ├── Content compatible with current and future tools │
81
+ │ ├── Works with assistive technologies │
82
+ │ └── Valid, well-formed markup │
83
+ │ │
84
+ └─────────────────────────────────────────────────────────────────┘
85
+ ```
86
+
87
+ ---
43
88
 
44
89
  ## WCAG 合規等級
45
90
 
46
- | 等級 | 說明 | 建議 |
47
- |------|------|------|
48
- | **A** | 最低要求 — 所有專案必須達成 | 基礎無障礙需求 |
49
- | **AA** | 建議等級 — 大多數法規要求此等級 | 涵蓋大多數使用者需求 |
50
- | **AAA** | 最高等級 — 特定情境的最佳實踐 | 政府、醫療、教育 |
91
+ ### 等級概觀
51
92
 
52
- ## 鍵盤導航
93
+ | 等級 | 說明 | 適用對象 |
94
+ |-------|-------------|--------------|
95
+ | **A** | 最低無障礙程度 | 所有專案 |
96
+ | **AA** | 解決主要障礙 | 法規合規(大多數法律) |
97
+ | **AAA** | 最高無障礙程度 | 特殊情境 |
98
+
99
+ ### 各區域合規要求
100
+
101
+ | 地區 | 法律/標準 | 最低等級 |
102
+ |--------|--------------|---------------|
103
+ | **美國** | Section 508, ADA | WCAG 2.0 AA |
104
+ | **歐盟** | EN 301 549 | WCAG 2.1 AA |
105
+ | **英國** | Equality Act 2010 | WCAG 2.1 AA |
106
+ | **加拿大** | AODA | WCAG 2.0 AA |
107
+ | **澳洲** | DDA | WCAG 2.0 AA |
108
+
109
+ ### 目標:WCAG 2.1 等級 AA
110
+
111
+ **建議**:所有專案應以 **WCAG 2.1 等級 AA** 為基準目標,涵蓋:
112
+ - 30 項等級 A 準則(必須具備)
113
+ - 20 項等級 AA 準則(應具備)
114
+
115
+ ---
116
+
117
+ ## 可感知 (Perceivable)
118
+
119
+ ### 1.1 替代文字
120
+
121
+ **要求**:為非文字內容提供替代文字。
122
+
123
+ ```html
124
+ <!-- ✅ Good: Meaningful alt text -->
125
+ <img src="chart.png" alt="Sales increased 25% from Q1 to Q2 2025">
126
+
127
+ <!-- ✅ Good: Decorative image (empty alt) -->
128
+ <img src="decorative-border.png" alt="" role="presentation">
129
+
130
+ <!-- ❌ Bad: Missing or generic alt -->
131
+ <img src="chart.png">
132
+ <img src="chart.png" alt="image">
133
+ <img src="chart.png" alt="chart.png">
134
+ ```
135
+
136
+ **替代文字指南**:
137
+
138
+ | 圖片類型 | 替代文字處理方式 |
139
+ |------------|-------------------|
140
+ | **資訊型 (Informative)** | 描述所傳達的資訊 |
141
+ | **功能型 (Functional)** | 描述其動作(例如:「提交表單」) |
142
+ | **裝飾型 (Decorative)** | 使用空的 alt (`alt=""`) |
143
+ | **複雜型 (Complex)** | 提供長描述(透過 `aria-describedby`) |
144
+ | **圖片中包含文字** | 將所有文字包含在 alt 中 |
145
+
146
+ ### 1.2 時基媒體
147
+
148
+ | 媒體類型 | 要求 |
149
+ |------------|--------------|
150
+ | **預錄音訊** | 文字稿 (Transcript) |
151
+ | **預錄影片** | 字幕 + 語音旁白描述 (audio description) |
152
+ | **即時音訊** | 即時字幕 |
153
+ | **即時影片** | 即時字幕 |
154
+
155
+ ### 1.3 可適應內容
156
+
157
+ ```html
158
+ <!-- ✅ Good: Semantic HTML -->
159
+ <nav aria-label="Main navigation">
160
+ <ul>
161
+ <li><a href="/">Home</a></li>
162
+ <li><a href="/about">About</a></li>
163
+ </ul>
164
+ </nav>
165
+
166
+ <main>
167
+ <article>
168
+ <h1>Article Title</h1>
169
+ <p>Content...</p>
170
+ </article>
171
+ </main>
172
+
173
+ <!-- ❌ Bad: Non-semantic markup -->
174
+ <div class="nav">
175
+ <div class="nav-item">Home</div>
176
+ <div class="nav-item">About</div>
177
+ </div>
178
+ ```
179
+
180
+ ### 1.4 可辨別 (Distinguishable)
181
+
182
+ **色彩對比要求**:
183
+
184
+ | 元素 | 最低比率 (AA) | 增強比率 (AAA) |
185
+ |---------|-------------------|----------------------|
186
+ | **一般文字** | 4.5:1 | 7:1 |
187
+ | **大型文字(18px+ 或 14px+ 粗體)** | 3:1 | 4.5:1 |
188
+ | **UI 元件與圖形** | 3:1 | 不適用 |
189
+
190
+ ---
191
+
192
+ ## 可操作
193
+
194
+ ### 2.1 鍵盤可存取
195
+
196
+ **所有功能都必須能透過鍵盤操作。**
197
+
198
+ ```html
199
+ <!-- ✅ Good: Focusable and keyboard operable -->
200
+ <button onclick="submitForm()">Submit</button>
201
+
202
+ <!-- ❌ Bad: Not keyboard accessible -->
203
+ <div onclick="submitForm()">Submit</div>
204
+
205
+ <!-- ✅ Good: Making div keyboard accessible (if button not possible) -->
206
+ <div
207
+ role="button"
208
+ tabindex="0"
209
+ onclick="submitForm()"
210
+ onkeydown="if(event.key === 'Enter' || event.key === ' ') submitForm()">
211
+ Submit
212
+ </div>
213
+ ```
214
+
215
+ ### 2.2 充足時間
216
+
217
+ | 需求 | 實作方式 |
218
+ |------|----------|
219
+ | **時間可調整** | 允許使用者關閉、調整或延長時間限制 |
220
+ | **自動更新內容** | 提供暫停、停止或隱藏控制項 |
221
+ | **工作階段逾時** | 在逾時前發出警告,並允許延長 |
222
+
223
+ ```javascript
224
+ // ✅ Good: Session timeout warning
225
+ // A warning + a way to extend the session is REQUIRED by WCAG 2.2.1 (Timing
226
+ // Adjustable). The specific durations are UDS defaults and are configurable:
227
+ // 30 min idle aligns with NIST SP 800-63B AAL2 reauthentication guidance.
228
+ const TIMEOUT_WARNING = 5 * 60 * 1000; // 5 min warning before timeout
229
+ const SESSION_TIMEOUT = 30 * 60 * 1000; // 30 min idle (UDS default; configurable)
230
+
231
+ setTimeout(() => {
232
+ const extend = confirm('Your session will expire in 5 minutes. Extend?');
233
+ if (extend) {
234
+ extendSession();
235
+ }
236
+ }, SESSION_TIMEOUT - TIMEOUT_WARNING);
237
+ ```
238
+
239
+ ### 2.3 癲癇與身體反應
240
+
241
+ | 需求 | 限制 |
242
+ |------|------|
243
+ | **閃爍內容** | 每秒閃爍不超過 3 次 |
244
+ | **動畫** | 提供減少動態效果的選項 |
245
+
246
+ ```css
247
+ /* ✅ Good: Respect user's motion preference */
248
+ @media (prefers-reduced-motion: reduce) {
249
+ *,
250
+ *::before,
251
+ *::after {
252
+ animation-duration: 0.01ms !important;
253
+ animation-iteration-count: 1 !important;
254
+ transition-duration: 0.01ms !important;
255
+ }
256
+ }
257
+ ```
258
+
259
+ ### 2.4 可導航
260
+
261
+ **焦點管理**:
262
+
263
+ ```css
264
+ /* ✅ Good: Visible focus indicator */
265
+ :focus {
266
+ outline: 2px solid #005fcc;
267
+ outline-offset: 2px;
268
+ }
269
+
270
+ /* ❌ Bad: Removing focus indicator */
271
+ :focus {
272
+ outline: none;
273
+ }
274
+ ```
275
+
276
+ **略過連結**:
277
+
278
+ ```html
279
+ <!-- ✅ Good: Skip to main content link -->
280
+ <a href="#main-content" class="skip-link">Skip to main content</a>
281
+
282
+ <nav><!-- navigation --></nav>
283
+
284
+ <main id="main-content">
285
+ <!-- main content -->
286
+ </main>
287
+
288
+ <style>
289
+ .skip-link {
290
+ position: absolute;
291
+ top: -40px;
292
+ left: 0;
293
+ padding: 8px;
294
+ background: #000;
295
+ color: #fff;
296
+ }
297
+ .skip-link:focus {
298
+ top: 0;
299
+ }
300
+ </style>
301
+ ```
302
+
303
+ ### 2.5 輸入方式
53
304
 
54
305
  | 需求 | 說明 |
55
306
  |------|------|
56
- | 所有互動元素可透過鍵盤存取 | Tab、Shift+Tab、Enter、Space、方向鍵 |
57
- | 焦點指示器可見 | 使用者能清楚看到目前焦點位置 |
58
- | 無鍵盤陷阱 | 使用者可以用鍵盤離開所有元件 |
59
- | 焦點順序合邏輯 | Tab 順序遵循視覺佈局 |
307
+ | **指標手勢** | 複雜手勢具有簡單的替代方式 |
308
+ | **指標取消** | 放開事件(Up-event)觸發、具備中止能力 |
309
+ | **目標尺寸** | 觸控目標至少為 44x44 CSS 像素 |
310
+ | **動作觸發** | 可被停用、具有替代方案 |
311
+
312
+ ---
313
+
314
+ ## 可理解
315
+
316
+ ### 3.1 可讀性
317
+
318
+ ```html
319
+ <!-- ✅ Good: Declare page language -->
320
+ <html lang="en">
321
+
322
+ <!-- ✅ Good: Mark language changes -->
323
+ <p>The French phrase <span lang="fr">c'est la vie</span> means "that's life".</p>
324
+ ```
325
+
326
+ ### 3.2 可預測
327
+
328
+ | 原則 | 實作方式 |
329
+ |------|----------|
330
+ | **獲得焦點時** | 僅獲得焦點時不改變情境脈絡 |
331
+ | **輸入時** | 在自動送出或改變情境脈絡前發出警告 |
332
+ | **一致的導航** | 跨頁面保持相同的導航順序 |
333
+ | **一致的識別** | 相同功能使用相同的標籤 |
334
+
335
+ ### 3.3 輸入協助
336
+
337
+ **錯誤識別**:
338
+
339
+ ```html
340
+ <!-- ✅ Good: Clear error message with instructions -->
341
+ <label for="email">Email</label>
342
+ <input
343
+ type="email"
344
+ id="email"
345
+ aria-describedby="email-error"
346
+ aria-invalid="true">
347
+ <span id="email-error" class="error" role="alert">
348
+ Please enter a valid email address (e.g., user@example.com)
349
+ </span>
350
+
351
+ <!-- ❌ Bad: Generic or missing error message -->
352
+ <input type="email" class="invalid">
353
+ ```
354
+
355
+ **錯誤預防**:
356
+
357
+ | 操作類型 | 必要預防措施 |
358
+ |----------|--------------|
359
+ | **法律/財務** | 可回復、可檢查或可確認 |
360
+ | **資料修改** | 可復原(undo)或可確認 |
361
+ | **測驗/考試送出** | 送出前可檢查 |
362
+
363
+ ---
364
+
365
+ ## 穩健
366
+
367
+ ### 4.1 相容性
368
+
369
+ **有效的 HTML**:
370
+
371
+ ```html
372
+ <!-- ✅ Good: Valid, unique IDs -->
373
+ <label for="username">Username</label>
374
+ <input type="text" id="username" name="username">
375
+
376
+ <!-- ❌ Bad: Duplicate IDs -->
377
+ <input type="text" id="field">
378
+ <input type="text" id="field"> <!-- Duplicate! -->
379
+ ```
380
+
381
+ **ARIA 使用**:
382
+
383
+ ```html
384
+ <!-- ✅ Good: Valid ARIA attributes -->
385
+ <button aria-expanded="false" aria-controls="menu">
386
+ Menu
387
+ </button>
388
+ <ul id="menu" hidden>
389
+ <li>Item 1</li>
390
+ </ul>
391
+
392
+ <!-- ❌ Bad: Invalid ARIA values -->
393
+ <button aria-expanded="yes"> <!-- Should be "true" or "false" -->
394
+ ```
395
+
396
+ ---
397
+
398
+ ## ARIA 指南
399
+
400
+ ### ARIA 規則
401
+
402
+ ```
403
+ ┌─────────────────────────────────────────────────────────────────┐
404
+ │ Five Rules of ARIA │
405
+ ├─────────────────────────────────────────────────────────────────┤
406
+ │ │
407
+ │ 1. Don't use ARIA if native HTML works │
408
+ │ <button> is better than <div role="button"> │
409
+ │ │
410
+ │ 2. Don't change native semantics │
411
+ │ Don't: <h1 role="button"> │
412
+ │ Do: <h1><button>Click</button></h1> │
413
+ │ │
414
+ │ 3. All interactive ARIA controls must be keyboard usable │
415
+ │ role="button" needs Enter/Space key handling │
416
+ │ │
417
+ │ 4. Don't use role="presentation" or aria-hidden="true" │
418
+ │ on focusable elements │
419
+ │ │
420
+ │ 5. All interactive elements must have accessible names │
421
+ │ Use aria-label, aria-labelledby, or visible label │
422
+ │ │
423
+ └─────────────────────────────────────────────────────────────────┘
424
+ ```
425
+
426
+ ### 常見 ARIA 模式
427
+
428
+ **即時區域(Live Regions)**:
429
+
430
+ ```html
431
+ <!-- Announce dynamic content changes -->
432
+ <div aria-live="polite" aria-atomic="true">
433
+ <!-- Content updates announced to screen readers -->
434
+ </div>
435
+
436
+ <!-- For urgent announcements -->
437
+ <div role="alert">
438
+ Error: Please correct the form fields.
439
+ </div>
440
+ ```
441
+
442
+ **對話方塊/互動視窗(Dialogs/Modals)**:
443
+
444
+ ```html
445
+ <div
446
+ role="dialog"
447
+ aria-modal="true"
448
+ aria-labelledby="dialog-title"
449
+ aria-describedby="dialog-desc">
450
+ <h2 id="dialog-title">Confirm Action</h2>
451
+ <p id="dialog-desc">Are you sure you want to delete this item?</p>
452
+ <button>Cancel</button>
453
+ <button>Delete</button>
454
+ </div>
455
+ ```
456
+
457
+ **分頁標籤(Tabs)**:
458
+
459
+ ```html
460
+ <div role="tablist" aria-label="Product tabs">
461
+ <button role="tab" aria-selected="true" aria-controls="panel-1" id="tab-1">
462
+ Description
463
+ </button>
464
+ <button role="tab" aria-selected="false" aria-controls="panel-2" id="tab-2">
465
+ Reviews
466
+ </button>
467
+ </div>
468
+ <div role="tabpanel" id="panel-1" aria-labelledby="tab-1">
469
+ Description content...
470
+ </div>
471
+ <div role="tabpanel" id="panel-2" aria-labelledby="tab-2" hidden>
472
+ Reviews content...
473
+ </div>
474
+ ```
475
+
476
+ ---
477
+
478
+ ## 鍵盤導航
479
+
480
+ ### 標準鍵盤互動
481
+
482
+ | 按鍵 | 操作 |
483
+ |-----|--------|
484
+ | **Tab** | 移至下一個可取得焦點的元素 |
485
+ | **Shift + Tab** | 移至上一個可取得焦點的元素 |
486
+ | **Enter** | 啟動連結或按鈕 |
487
+ | **Space** | 啟動按鈕、切換核取方塊 |
488
+ | **方向鍵** | 在元件內導覽(分頁標籤、選單等) |
489
+ | **Escape** | 關閉互動視窗、取消操作 |
490
+ | **Home/End** | 跳至清單中的第一個/最後一個項目 |
491
+
492
+ ### 焦點順序
493
+
494
+ ```html
495
+ <!-- ✅ Good: Logical focus order follows visual order -->
496
+ <header>
497
+ <nav><!-- Focus 1, 2, 3 --></nav>
498
+ </header>
499
+ <main><!-- Focus 4, 5, 6 --></main>
500
+ <footer><!-- Focus 7, 8 --></footer>
501
+
502
+ <!-- ❌ Bad: Tabindex disrupting natural order -->
503
+ <button tabindex="3">Third</button>
504
+ <button tabindex="1">First</button>
505
+ <button tabindex="2">Second</button>
506
+ ```
507
+
508
+ ### SPA 的焦點管理
509
+
510
+ ```javascript
511
+ // ✅ Good: Move focus after route change
512
+ function navigateToPage(pageId) {
513
+ // Change page content
514
+ updateContent(pageId);
515
+
516
+ // Move focus to main content heading
517
+ const heading = document.querySelector(`#${pageId} h1`);
518
+ heading.setAttribute('tabindex', '-1');
519
+ heading.focus();
520
+
521
+ // Announce to screen readers
522
+ announcePageChange(heading.textContent);
523
+ }
524
+ ```
525
+
526
+ ---
60
527
 
61
528
  ## 色彩與對比
62
529
 
63
- | 元素 | AA 等級 | AAA 等級 |
64
- |------|---------|----------|
65
- | 一般文字 | 4.5:1 | 7:1 |
66
- | 大型文字(18pt+) | 3:1 | 4.5:1 |
67
- | UI 元件 | 3:1 | — |
68
- | 非文字內容 | 3:1 | — |
530
+ ### 對比度需求
531
+
532
+ | 元素 | WCAG AA | WCAG AAA |
533
+ |---------|---------|----------|
534
+ | **一般文字** | 4.5:1 | 7:1 |
535
+ | **大型文字** | 3:1 | 4.5:1 |
536
+ | **UI 元件** | 3:1 | 3:1 |
537
+ | **非文字圖形** | 3:1 | 3:1 |
538
+
539
+ ### 色盲考量事項
540
+
541
+ ```
542
+ ┌─────────────────────────────────────────────────────────────────┐
543
+ │ Color Vision Deficiency Types │
544
+ ├─────────────────────────────────────────────────────────────────┤
545
+ │ │
546
+ │ Type Affects Prevalence │
547
+ │ ───────────────────────────────────────────────────── │
548
+ │ Deuteranomaly Green ~6% of males │
549
+ │ Protanomaly Red ~1% of males │
550
+ │ Tritanomaly Blue <1% of population │
551
+ │ Achromatopsia All colors Very rare │
552
+ │ │
553
+ │ Guidelines: │
554
+ │ ├── Don't rely on color alone to convey information │
555
+ │ ├── Use patterns, icons, or text in addition to color │
556
+ │ ├── Test with color blindness simulators │
557
+ │ └── Avoid red/green combinations for critical info │
558
+ │ │
559
+ └─────────────────────────────────────────────────────────────────┘
560
+ ```
561
+
562
+ **範例**:
563
+
564
+ ```html
565
+ <!-- ❌ Bad: Color alone indicates status -->
566
+ <span class="status-green">Available</span>
567
+ <span class="status-red">Sold Out</span>
568
+
569
+ <!-- ✅ Good: Color + icon + text -->
570
+ <span class="status-green">
571
+ <span aria-hidden="true">✓</span> Available
572
+ </span>
573
+ <span class="status-red">
574
+ <span aria-hidden="true">✗</span> Sold Out
575
+ </span>
576
+ ```
577
+
578
+ ---
579
+
580
+ ## 表單與輸入
581
+
582
+ ### 表單標籤
583
+
584
+ ```html
585
+ <!-- ✅ Good: Explicit label association -->
586
+ <label for="email">Email address</label>
587
+ <input type="email" id="email" name="email">
588
+
589
+ <!-- ✅ Good: Using aria-label for icon-only buttons -->
590
+ <button aria-label="Search">
591
+ <svg aria-hidden="true"><!-- search icon --></svg>
592
+ </button>
593
+
594
+ <!-- ✅ Good: Using aria-labelledby for complex labels -->
595
+ <span id="label">Quantity</span>
596
+ <span id="desc">Maximum 10 items</span>
597
+ <input type="number" aria-labelledby="label" aria-describedby="desc">
598
+
599
+ <!-- ❌ Bad: Placeholder as only label -->
600
+ <input type="email" placeholder="Email">
601
+ ```
602
+
603
+ ### 表單驗證
604
+
605
+ ```html
606
+ <!-- ✅ Good: Accessible error handling -->
607
+ <form novalidate>
608
+ <div>
609
+ <label for="email">Email *</label>
610
+ <input
611
+ type="email"
612
+ id="email"
613
+ required
614
+ aria-required="true"
615
+ aria-invalid="false"
616
+ aria-describedby="email-hint email-error">
617
+ <span id="email-hint" class="hint">We'll never share your email</span>
618
+ <span id="email-error" class="error" hidden></span>
619
+ </div>
620
+ </form>
621
+
622
+ <script>
623
+ function validateEmail(input) {
624
+ const error = document.getElementById('email-error');
625
+ if (!input.validity.valid) {
626
+ input.setAttribute('aria-invalid', 'true');
627
+ error.textContent = 'Please enter a valid email address';
628
+ error.hidden = false;
629
+ } else {
630
+ input.setAttribute('aria-invalid', 'false');
631
+ error.hidden = true;
632
+ }
633
+ }
634
+ </script>
635
+ ```
636
+
637
+ ### 必填欄位
638
+
639
+ ```html
640
+ <!-- ✅ Good: Multiple indicators for required fields -->
641
+ <label for="name">
642
+ Full Name
643
+ <span aria-hidden="true">*</span>
644
+ <span class="sr-only">(required)</span>
645
+ </label>
646
+ <input type="text" id="name" required aria-required="true">
647
+
648
+ <p class="form-note" aria-hidden="true">* Required fields</p>
649
+ ```
650
+
651
+ ---
652
+
653
+ ## 媒體無障礙
654
+
655
+ ### 圖片
656
+
657
+ | 類型 | 實作 |
658
+ |------|------|
659
+ | **資訊性** | `alt="Description of information"` |
660
+ | **裝飾性** | `alt="" role="presentation"` |
661
+ | **功能性** | `alt="Action description"` |
662
+ | **複雜** | `alt="Summary" + aria-describedby` |
663
+
664
+ ### 影片
665
+
666
+ ```html
667
+ <!-- ✅ Good: Accessible video -->
668
+ <figure>
669
+ <video
670
+ controls
671
+ aria-describedby="video-desc">
672
+ <source src="video.mp4" type="video/mp4">
673
+ <track kind="captions" src="captions.vtt" srclang="en" label="English">
674
+ <track kind="descriptions" src="descriptions.vtt" srclang="en" label="Audio Descriptions">
675
+ </video>
676
+ <figcaption id="video-desc">
677
+ Product demonstration showing key features.
678
+ </figcaption>
679
+ </figure>
680
+ ```
681
+
682
+ ### 音訊
683
+
684
+ ```html
685
+ <!-- ✅ Good: Audio with transcript -->
686
+ <audio controls aria-describedby="audio-desc">
687
+ <source src="podcast.mp3" type="audio/mpeg">
688
+ </audio>
689
+ <details id="audio-desc">
690
+ <summary>View transcript</summary>
691
+ <p>Full transcript of the podcast episode...</p>
692
+ </details>
693
+ ```
694
+
695
+ ---
696
+
697
+ ## 測試與驗證
698
+
699
+ ### 自動化測試工具
700
+
701
+ | 工具 | 類型 | 涵蓋範圍 |
702
+ |------|------|----------|
703
+ | **axe-core** | 瀏覽器擴充功能、CI | ~57% 的 WCAG 問題 |
704
+ | **WAVE** | 瀏覽器擴充功能 | 視覺回饋 |
705
+ | **Lighthouse** | 瀏覽器 DevTools | 效能 + a11y |
706
+ | **Pa11y** | CI/CD 整合 | 自動化測試 |
707
+ | **jest-axe** | 單元測試 | 元件測試 |
708
+
709
+ ### 手動測試檢查清單
710
+
711
+ ```
712
+ Keyboard Testing:
713
+ □ Can reach all interactive elements with Tab
714
+ □ Focus indicator visible on all elements
715
+ □ Can activate all controls with Enter/Space
716
+ □ Can dismiss modals with Escape
717
+ □ Focus returns to trigger after modal closes
718
+ □ No keyboard traps
719
+
720
+ Screen Reader Testing:
721
+ □ All images have appropriate alt text
722
+ □ Form fields have labels
723
+ □ Headings structure is logical
724
+ □ Live regions announce updates
725
+ □ Links have descriptive text
726
+ □ Tables have headers
727
+
728
+ Visual Testing:
729
+ □ Text meets contrast requirements
730
+ □ Content readable at 200% zoom
731
+ □ No horizontal scrolling at 320px width
732
+ □ Focus indicators visible
733
+ □ Color not sole means of information
734
+ □ Content works in high contrast mode
735
+ ```
736
+
737
+ ### 螢幕閱讀器測試
738
+
739
+ | 平台 | 螢幕閱讀器 |
740
+ |----------|---------------|
741
+ | **Windows** | NVDA(免費)、JAWS |
742
+ | **macOS** | VoiceOver |
743
+ | **iOS** | VoiceOver |
744
+ | **Android** | TalkBack |
745
+
746
+ ### CI/CD 整合
747
+
748
+ ```yaml
749
+ # Example: GitHub Actions accessibility testing
750
+ name: Accessibility
751
+
752
+ on: [push, pull_request]
753
+
754
+ jobs:
755
+ a11y:
756
+ runs-on: ubuntu-latest
757
+ steps:
758
+ - uses: actions/checkout@v4
69
759
 
70
- ## 測試清單
760
+ - name: Install dependencies
761
+ run: npm ci
71
762
 
72
- | 測試項目 | 工具 |
73
- |----------|------|
74
- | 自動化無障礙掃描 | axe-core、Lighthouse |
75
- | 鍵盤導航測試 | 手動測試 |
76
- | 螢幕閱讀器測試 | NVDA、VoiceOver、JAWS |
77
- | 色彩對比驗證 | Colour Contrast Analyser |
78
- | 表單標籤驗證 | axe-core、WAVE |
763
+ - name: Build
764
+ run: npm run build
765
+
766
+ - name: Run accessibility tests
767
+ run: npm run test:a11y
768
+
769
+ - name: Run Pa11y
770
+ uses: pa11y/pa11y-ci-action@v1
771
+ with:
772
+ sitemap: https://example.com/sitemap.xml
773
+ ```
774
+
775
+ ---
776
+
777
+ ## 無障礙檢查清單
778
+
779
+ ### 開發檢查清單
780
+
781
+ ```
782
+ Structure:
783
+ □ Semantic HTML elements used (header, nav, main, etc.)
784
+ □ Heading hierarchy is logical (h1 → h2 → h3)
785
+ □ Page has descriptive title
786
+ □ Language attribute set on html element
787
+
788
+ Images:
789
+ □ All images have alt attributes
790
+ □ Decorative images have empty alt
791
+ □ Complex images have extended descriptions
792
+
793
+ Keyboard:
794
+ □ All interactive elements keyboard accessible
795
+ □ Visible focus indicators
796
+ □ No keyboard traps
797
+ □ Skip links provided
798
+
799
+ Forms:
800
+ □ All inputs have associated labels
801
+ □ Required fields indicated
802
+ □ Error messages clear and specific
803
+ □ Form validation accessible
804
+
805
+ Color:
806
+ □ Text meets contrast requirements
807
+ □ Information not conveyed by color alone
808
+ □ Links distinguishable from text
809
+
810
+ Multimedia:
811
+ □ Videos have captions
812
+ □ Audio has transcripts
813
+ □ Media controls accessible
814
+ ```
815
+
816
+ ### 審查檢查清單
817
+
818
+ ```
819
+ Before Release:
820
+ □ Automated accessibility scan completed (axe, Lighthouse)
821
+ □ Keyboard navigation tested
822
+ □ Screen reader tested (at least one)
823
+ □ Color contrast verified
824
+ □ Zoom to 200% tested
825
+ □ Mobile accessibility tested
826
+ □ Form accessibility verified
827
+ □ Error handling tested
828
+ ```
829
+
830
+ ---
831
+
832
+ ## 發布阻擋門檻
833
+
834
+ 本節定義在正式發布前必須通過的**最低 a11y 關卡**(`release-readiness-gate.md` 中的維度 3,Tier-2)。
835
+
836
+ ### 自動化關卡 (CI — axe-core / Pa11y)
837
+
838
+ | 嚴重程度 | 硬性最低要求 | 警告區間 |
839
+ |----------|-------------|-----------|
840
+ | critical | 0(阻擋發布) | — |
841
+ | serious | ≤ 專案設定門檻(預設:0) | +1–2 → WARN |
842
+ | moderate | 建議性質,不阻擋 | — |
843
+ | minor | 建議性質,不阻擋 | — |
844
+
845
+ 在發布前針對每個關鍵使用者流程畫面執行 axe-core:
846
+
847
+ ```bash
848
+ npx axe-cli <url> --tags wcag2a,wcag2aa --exit # non-zero exit if critical/serious
849
+ ```
850
+
851
+ 若 `critical > 0` 或 `serious > configured-threshold`,CI 必須判定組建失敗。
852
+
853
+ ### 依專案類型的合規等級
854
+
855
+ | 專案類型 | 最低合規等級 | 備註 |
856
+ |-------------|-------------------|-------|
857
+ | 一般 Web / SaaS | WCAG 2.1 Level AA | 預設 |
858
+ | 金融、醫療保健、政府 | WCAG 2.1 Level AA + Section 508 | 法定強制 |
859
+ | 標竿 / 高階品牌 | WCAG 2.2 Level AA | 建議 |
860
+
861
+ ### 鍵盤導航關卡(手動,UAT 前)
862
+
863
+ 所有關鍵使用者流程(如 requirement-template §2.4 所定義)必須能完全僅透過鍵盤操作:
864
+ - Tab / Shift+Tab:導航所有互動元素
865
+ - Enter / Space:啟動控制項
866
+ - Escape:關閉強制回應視窗 / 覆蓋層(modals / overlays)
867
+ - 方向鍵:導航選單、分頁標籤、樹狀檢視
868
+
869
+ 關卡標準:關鍵流程步驟 100% 可透過鍵盤到達;無鍵盤陷阱。
870
+
871
+ ### 螢幕閱讀器抽檢(手動,UAT 前)
872
+
873
+ 最低要求:在以下各環境中各測試 1 個關鍵使用者流程:
874
+ - **Windows**:NVDA + Chrome
875
+ - **macOS**:VoiceOver + Safari
876
+
877
+ 通過標準:所有步驟皆可在不依賴視覺參考的情況下完成;播報所有表單錯誤;播報所有動態內容變更。
878
+
879
+ ### 發布簽核佐證
880
+
881
+ a11y 關卡納入發布就緒簽核(Release Readiness Sign-off)的形式如下:
882
+
883
+ ```
884
+ | 3 | Accessibility | PASS | axe report: 0 critical / 0 serious; keyboard pass; SR spot-check VoiceOver OK | QA Lead |
885
+ ```
886
+
887
+ ---
79
888
 
80
889
  ## 相關標準
81
890
 
82
- - [效能標準](performance-standards.md)
83
- - [安全標準](security-standards.md)
84
- - [測試標準](testing-standards.md)
891
+ - [文件撰寫標準](documentation-writing-standards.md) - 無障礙文件
892
+ - [程式碼審查檢查清單](code-review-checklist.md) - 無障礙審查
893
+ - [測試標準](testing-standards.md) - 無障礙測試
894
+ - [安全標準](security-standards.md) - 身分驗證無障礙
895
+ - [發布就緒關卡](release-readiness-gate.md) - 維度 3:a11y 發布關卡
896
+
897
+ ---
898
+
899
+ ## 參考資料
900
+
901
+ ### 標準
902
+ - [WCAG 2.1](https://www.w3.org/WAI/WCAG21/quickref/) - 快速參考指南
903
+ - [WCAG 2.2](https://www.w3.org/TR/WCAG22/) - 最新版本
904
+ - [WAI-ARIA 1.2](https://www.w3.org/TR/wai-aria-1.2/) - ARIA 規格
905
+ - [WAI-ARIA Authoring Practices](https://www.w3.org/WAI/ARIA/apg/) - 設計模式
906
+
907
+ ### 工具
908
+ - [axe DevTools](https://www.deque.com/axe/) - 瀏覽器擴充功能
909
+ - [WAVE](https://wave.webaim.org/) - 網頁無障礙評估工具
910
+ - [Contrast Checker](https://webaim.org/resources/contrastchecker/) - 色彩對比工具
911
+ - [NVDA](https://www.nvaccess.org/) - Windows 免費螢幕閱讀器
912
+
913
+ ### 學習資源
914
+ - [WebAIM](https://webaim.org/) - 網頁無障礙資源
915
+ - [A11Y Project](https://www.a11yproject.com/) - 社群驅動資源
916
+ - [MDN Accessibility](https://developer.mozilla.org/en-US/docs/Web/Accessibility) - 開發者指南
917
+
918
+ ---
919
+
920
+ ## 版本歷史
921
+
922
+ | 版本 | 日期 | 變更 |
923
+ |---------|------|---------|
924
+ | 1.1.0 | 2026-06-18 | 新增:工作階段逾時時間(session-timeout durations)的來源與可設定性說明(WCAG 2.2.1 Timing Adjustable;NIST SP 800-63B AAL2)(XSPEC-292 T8) |
925
+ | 1.0.0 | 2026-01-29 | 初始發布:涵蓋 WCAG 2.1、POUR 原則、ARIA 指南、鍵盤導航、表單、測試 |
926
+
927
+ ---
928
+
929
+ ## 授權條款
930
+
931
+ 本標準採用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權釋出。
932
+
933
+ **來源**:[universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)