universal-dev-standards 6.14.0-beta.8 → 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.
- package/bin/uds.js +12 -1
- package/bundled/ai/options/commit-message/traditional-chinese.ai.yaml +69 -67
- package/bundled/ai/standards/commit-message.ai.yaml +12 -2
- package/bundled/ai/standards/secret-management-standards.ai.yaml +12 -1
- package/bundled/core/commit-message-guide.md +22 -19
- package/bundled/core/secret-management-standards.md +13 -1
- package/bundled/extensions/locales/zh-tw.md +19 -19
- package/bundled/hooks/validate-commit-msg.mjs +52 -9
- package/bundled/locales/zh-CN/CHANGELOG.md +2312 -1102
- package/bundled/locales/zh-CN/CLAUDE.md +987 -101
- package/bundled/locales/zh-CN/README.md +3 -3
- package/bundled/locales/zh-CN/SECURITY.md +3 -3
- package/bundled/locales/zh-CN/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +68 -97
- package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +8 -9
- package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +81 -80
- package/bundled/locales/zh-CN/adoption/checklists/minimal.md +18 -14
- package/bundled/locales/zh-CN/adoption/checklists/recommended.md +49 -46
- package/bundled/locales/zh-CN/ai/MAINTENANCE.md +44 -9
- package/bundled/locales/zh-CN/ai/options/commit-message/traditional-chinese.ai.yaml +63 -55
- package/bundled/locales/zh-CN/core/acceptance-criteria-traceability.md +61 -14
- package/bundled/locales/zh-CN/core/acceptance-test-driven-development.md +2 -1
- package/bundled/locales/zh-CN/core/accessibility-standards.md +871 -62
- package/bundled/locales/zh-CN/core/adr-standards.md +155 -32
- package/bundled/locales/zh-CN/core/agent-communication-protocol.md +2 -1
- package/bundled/locales/zh-CN/core/agent-dispatch.md +68 -33
- package/bundled/locales/zh-CN/core/ai-agreement-standards.md +23 -22
- package/bundled/locales/zh-CN/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-CN/core/ai-friendly-architecture.md +311 -72
- package/bundled/locales/zh-CN/core/ai-instruction-standards.md +71 -49
- package/bundled/locales/zh-CN/core/ai-response-navigation.md +2 -1
- package/bundled/locales/zh-CN/core/alerting-standards.md +231 -36
- package/bundled/locales/zh-CN/core/anti-hallucination.md +116 -697
- package/bundled/locales/zh-CN/core/anti-sycophancy-prompting.md +34 -33
- package/bundled/locales/zh-CN/core/api-design-standards.md +144 -58
- package/bundled/locales/zh-CN/core/behavior-driven-development.md +2 -1
- package/bundled/locales/zh-CN/core/branch-completion.md +75 -20
- package/bundled/locales/zh-CN/core/capability-declaration.md +44 -94
- package/bundled/locales/zh-CN/core/change-batching-standards.md +2 -1
- package/bundled/locales/zh-CN/core/changelog-standards.md +485 -63
- package/bundled/locales/zh-CN/core/chaos-engineering-standards.md +141 -39
- package/bundled/locales/zh-CN/core/checkin-standards.md +176 -116
- package/bundled/locales/zh-CN/core/circuit-breaker.md +43 -77
- package/bundled/locales/zh-CN/core/code-review-checklist.md +37 -23
- package/bundled/locales/zh-CN/core/commit-message-guide.md +892 -69
- package/bundled/locales/zh-CN/core/containerization-standards.md +259 -57
- package/bundled/locales/zh-CN/core/context-aware-loading.md +103 -29
- package/bundled/locales/zh-CN/core/database-standards.md +115 -114
- package/bundled/locales/zh-CN/core/deprecation-standards.md +155 -40
- package/bundled/locales/zh-CN/core/design-document-standards.md +265 -55
- package/bundled/locales/zh-CN/core/developer-memory.md +150 -60
- package/bundled/locales/zh-CN/core/documentation-lifecycle.md +20 -16
- package/bundled/locales/zh-CN/core/documentation-structure.md +1284 -127
- package/bundled/locales/zh-CN/core/documentation-writing-standards.md +649 -259
- package/bundled/locales/zh-CN/core/dual-phase-output.md +37 -70
- package/bundled/locales/zh-CN/core/environment-standards.md +251 -73
- package/bundled/locales/zh-CN/core/error-code-standards.md +501 -60
- package/bundled/locales/zh-CN/core/estimation-standards.md +174 -41
- package/bundled/locales/zh-CN/core/execution-history.md +2 -1
- package/bundled/locales/zh-CN/core/failure-source-taxonomy.md +71 -84
- package/bundled/locales/zh-CN/core/feature-flag-standards.md +202 -57
- package/bundled/locales/zh-CN/core/forward-derivation-standards.md +613 -154
- package/bundled/locales/zh-CN/core/frontend-design-standards.md +361 -78
- package/bundled/locales/zh-CN/core/git-workflow.md +148 -262
- package/bundled/locales/zh-CN/core/git-worktree.md +59 -26
- package/bundled/locales/zh-CN/core/guides/file-placement-guide.md +132 -48
- package/bundled/locales/zh-CN/core/guides/performance-guide.md +61 -59
- package/bundled/locales/zh-CN/core/guides/security-guide.md +2 -0
- package/bundled/locales/zh-CN/core/health-check-standards.md +46 -104
- package/bundled/locales/zh-CN/core/immutability-first.md +83 -60
- package/bundled/locales/zh-CN/core/knowledge-transfer-standards.md +94 -31
- package/bundled/locales/zh-CN/core/mutation-testing.md +45 -6
- package/bundled/locales/zh-CN/core/observability-standards.md +281 -37
- package/bundled/locales/zh-CN/core/performance-standards.md +402 -42
- package/bundled/locales/zh-CN/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-CN/core/postmortem-standards.md +358 -53
- package/bundled/locales/zh-CN/core/privacy-standards.md +148 -40
- package/bundled/locales/zh-CN/core/project-context-memory.md +182 -48
- package/bundled/locales/zh-CN/core/project-structure.md +550 -170
- package/bundled/locales/zh-CN/core/recovery-recipe-registry.md +54 -114
- package/bundled/locales/zh-CN/core/refactoring-standards.md +141 -556
- package/bundled/locales/zh-CN/core/requirement-engineering.md +7 -6
- package/bundled/locales/zh-CN/core/retrospective-standards.md +215 -22
- package/bundled/locales/zh-CN/core/retry-standards.md +46 -101
- package/bundled/locales/zh-CN/core/reverse-engineering-standards.md +370 -120
- package/bundled/locales/zh-CN/core/runbook-standards.md +294 -48
- package/bundled/locales/zh-CN/core/security-decision.md +45 -70
- package/bundled/locales/zh-CN/core/security-standards.md +169 -16
- package/bundled/locales/zh-CN/core/skill-standard-alignment-check.md +105 -71
- package/bundled/locales/zh-CN/core/slo-standards.md +296 -44
- package/bundled/locales/zh-CN/core/spec-driven-development.md +37 -6
- package/bundled/locales/zh-CN/core/standard-admission-criteria.md +25 -31
- package/bundled/locales/zh-CN/core/standard-lifecycle-management.md +49 -57
- package/bundled/locales/zh-CN/core/structured-task-definition.md +2 -1
- package/bundled/locales/zh-CN/core/supply-chain-security-standards.md +159 -32
- package/bundled/locales/zh-CN/core/systematic-debugging.md +87 -42
- package/bundled/locales/zh-CN/core/tech-debt-standards.md +202 -86
- package/bundled/locales/zh-CN/core/test-completeness-dimensions.md +262 -190
- package/bundled/locales/zh-CN/core/test-data-standards.md +252 -30
- package/bundled/locales/zh-CN/core/test-driven-development.md +21 -1022
- package/bundled/locales/zh-CN/core/test-governance.md +94 -43
- package/bundled/locales/zh-CN/core/testing-standards.md +83 -37
- package/bundled/locales/zh-CN/core/timeout-standards.md +45 -85
- package/bundled/locales/zh-CN/core/token-budget.md +44 -80
- package/bundled/locales/zh-CN/core/translation-lifecycle-standards.md +48 -36
- package/bundled/locales/zh-CN/core/verification-evidence.md +44 -22
- package/bundled/locales/zh-CN/core/versioning.md +737 -73
- package/bundled/locales/zh-CN/core/virtual-organization-standards.md +30 -29
- package/bundled/locales/zh-CN/core/workflow-enforcement.md +9 -8
- package/bundled/locales/zh-CN/core/workflow-state-protocol.md +9 -8
- package/bundled/locales/zh-CN/docs/CHEATSHEET.md +2 -1
- package/bundled/locales/zh-CN/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +19 -10
- package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +8 -6
- package/bundled/locales/zh-CN/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +133 -132
- package/bundled/locales/zh-CN/docs/USER-MANUAL.md +11 -3
- package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +5 -2
- package/bundled/locales/zh-CN/docs/specs/system/memory-adoption-strategy.md +2 -0
- package/bundled/locales/zh-CN/docs/user/FAQ.md +2 -0
- package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +2 -0
- package/bundled/locales/zh-CN/docs/user/GLOSSARY.md +2 -0
- package/bundled/locales/zh-CN/docs/user/README.md +4 -2
- package/bundled/locales/zh-CN/docs/user/TROUBLESHOOTING.md +2 -0
- package/bundled/locales/zh-CN/integrations/codex/AGENTS.md +136 -2
- package/bundled/locales/zh-CN/integrations/codex/README.md +62 -10
- package/bundled/locales/zh-CN/integrations/gemini-cli/GEMINI.md +59 -1
- package/bundled/locales/zh-CN/integrations/gemini-cli/README.md +9 -2
- package/bundled/locales/zh-CN/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
- package/bundled/locales/zh-CN/integrations/github-copilot/README.md +8 -2
- package/bundled/locales/zh-CN/integrations/github-copilot/copilot-instructions.md +146 -12
- package/bundled/locales/zh-CN/integrations/github-copilot/skills-mapping.md +7 -1
- package/bundled/locales/zh-CN/integrations/google-antigravity/AGENTS.md +110 -3
- package/bundled/locales/zh-CN/integrations/google-antigravity/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/opencode/AGENTS.md +140 -2
- package/bundled/locales/zh-CN/integrations/opencode/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/opencode/skills-mapping.md +8 -2
- package/bundled/locales/zh-CN/integrations/openspec/AGENTS.md +46 -1
- package/bundled/locales/zh-CN/integrations/openspec/README.md +7 -1
- package/bundled/locales/zh-CN/integrations/spec-kit/AGENTS.md +20 -2
- package/bundled/locales/zh-CN/integrations/spec-kit/README.md +7 -1
- package/bundled/locales/zh-CN/options/changelog/auto-generated.md +2 -0
- package/bundled/locales/zh-CN/options/changelog/keep-a-changelog.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/automated-review.md +2 -0
- package/bundled/locales/zh-CN/options/code-review/pair-programming.md +2 -0
- package/bundled/locales/zh-CN/options/commit-message/bilingual.md +139 -50
- package/bundled/locales/zh-CN/options/commit-message/english.md +159 -42
- package/bundled/locales/zh-CN/options/commit-message/traditional-chinese.md +156 -75
- package/bundled/locales/zh-CN/options/documentation/api-docs.md +3 -1
- package/bundled/locales/zh-CN/options/documentation/markdown-docs.md +2 -0
- package/bundled/locales/zh-CN/options/documentation/wiki-style.md +2 -0
- package/bundled/locales/zh-CN/options/git-workflow/gitflow.md +105 -77
- package/bundled/locales/zh-CN/options/git-workflow/github-flow.md +75 -57
- package/bundled/locales/zh-CN/options/git-workflow/merge-commit.md +155 -44
- package/bundled/locales/zh-CN/options/git-workflow/rebase-ff.md +168 -53
- package/bundled/locales/zh-CN/options/git-workflow/squash-merge.md +122 -37
- package/bundled/locales/zh-CN/options/git-workflow/trunk-based.md +108 -61
- package/bundled/locales/zh-CN/options/project-structure/dotnet.md +266 -47
- package/bundled/locales/zh-CN/options/project-structure/go.md +301 -43
- package/bundled/locales/zh-CN/options/project-structure/java.md +268 -48
- package/bundled/locales/zh-CN/options/project-structure/kotlin.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/nodejs.md +168 -51
- package/bundled/locales/zh-CN/options/project-structure/php.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/python.md +210 -52
- package/bundled/locales/zh-CN/options/project-structure/ruby.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/rust.md +2 -0
- package/bundled/locales/zh-CN/options/project-structure/swift.md +2 -0
- package/bundled/locales/zh-CN/options/testing/contract-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/e2e-testing.md +227 -66
- package/bundled/locales/zh-CN/options/testing/industry-pyramid.md +2 -0
- package/bundled/locales/zh-CN/options/testing/integration-testing.md +185 -73
- package/bundled/locales/zh-CN/options/testing/istqb-framework.md +2 -0
- package/bundled/locales/zh-CN/options/testing/performance-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/security-testing.md +2 -0
- package/bundled/locales/zh-CN/options/testing/system-testing.md +270 -96
- package/bundled/locales/zh-CN/options/testing/unit-testing.md +185 -71
- package/bundled/locales/zh-CN/skills/CONTRIBUTING.template.md +43 -42
- package/bundled/locales/zh-CN/skills/INTEGRATION-GUIDE.md +2 -1
- package/bundled/locales/zh-CN/skills/README.md +2 -1
- package/bundled/locales/zh-CN/skills/_shared/README.md +2 -1
- package/bundled/locales/zh-CN/skills/adr-assistant/guide.md +240 -4
- package/bundled/locales/zh-CN/skills/agents/README.md +180 -82
- package/bundled/locales/zh-CN/skills/agents/code-architect.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/doc-writer.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/reviewer.md +4 -2
- package/bundled/locales/zh-CN/skills/agents/spec-analyst.md +3 -1
- package/bundled/locales/zh-CN/skills/agents/test-specialist.md +3 -1
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md +91 -81
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/anti-hallucination.md +79 -59
- package/bundled/locales/zh-CN/skills/ai-collaboration-standards/certainty-labels.md +66 -40
- package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md +23 -36
- package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md +217 -137
- package/bundled/locales/zh-CN/skills/api-design-assistant/SKILL.md +13 -2
- package/bundled/locales/zh-CN/skills/atdd-assistant/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
- package/bundled/locales/zh-CN/skills/atdd-assistant/atdd-workflow.md +98 -1
- package/bundled/locales/zh-CN/skills/atdd-assistant/guide.md +148 -132
- package/bundled/locales/zh-CN/skills/audit-assistant/SKILL.md +5 -2
- package/bundled/locales/zh-CN/skills/bdd-assistant/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/bdd-assistant/bdd-workflow.md +2 -1
- package/bundled/locales/zh-CN/skills/bdd-assistant/gherkin-guide.md +2 -1
- package/bundled/locales/zh-CN/skills/bdd-assistant/guide.md +122 -121
- package/bundled/locales/zh-CN/skills/changelog-guide/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/changelog-guide/guide.md +91 -88
- package/bundled/locales/zh-CN/skills/checkin-assistant/SKILL.md +12 -2
- package/bundled/locales/zh-CN/skills/checkin-assistant/guide.md +211 -210
- package/bundled/locales/zh-CN/skills/ci-cd-assistant/SKILL.md +14 -2
- package/bundled/locales/zh-CN/skills/code-review-assistant/SKILL.md +12 -2
- package/bundled/locales/zh-CN/skills/code-review-assistant/checkin-checklist.md +79 -78
- package/bundled/locales/zh-CN/skills/code-review-assistant/guide.md +119 -45
- package/bundled/locales/zh-CN/skills/code-review-assistant/review-checklist.md +89 -88
- package/bundled/locales/zh-CN/skills/commands/ac-coverage.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/api-design.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/atdd.md +71 -1
- package/bundled/locales/zh-CN/skills/commands/audit.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/bdd.md +160 -62
- package/bundled/locales/zh-CN/skills/commands/changelog.md +36 -1
- package/bundled/locales/zh-CN/skills/commands/check.md +53 -1
- package/bundled/locales/zh-CN/skills/commands/checkin.md +45 -1
- package/bundled/locales/zh-CN/skills/commands/ci-cd.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/code-review.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/commit.md +56 -1
- package/bundled/locales/zh-CN/skills/commands/config.md +50 -1
- package/bundled/locales/zh-CN/skills/commands/coverage.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/database.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/derive-all.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/derive-atdd.md +35 -1
- package/bundled/locales/zh-CN/skills/commands/derive-bdd.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/derive-tdd.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/derive.md +60 -4
- package/bundled/locales/zh-CN/skills/commands/dev-workflow.md +58 -8
- package/bundled/locales/zh-CN/skills/commands/discover.md +41 -1
- package/bundled/locales/zh-CN/skills/commands/docgen.md +37 -1
- package/bundled/locales/zh-CN/skills/commands/docs.md +136 -5
- package/bundled/locales/zh-CN/skills/commands/durable.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/e2e.md +85 -1
- package/bundled/locales/zh-CN/skills/commands/guide.md +2 -1
- package/bundled/locales/zh-CN/skills/commands/incident.md +5 -4
- package/bundled/locales/zh-CN/skills/commands/init.md +57 -1
- package/bundled/locales/zh-CN/skills/commands/methodology.md +166 -77
- package/bundled/locales/zh-CN/skills/commands/metrics.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/migrate.md +5 -4
- package/bundled/locales/zh-CN/skills/commands/observability.md +48 -3
- package/bundled/locales/zh-CN/skills/commands/pr.md +4 -3
- package/bundled/locales/zh-CN/skills/commands/refactor.md +76 -38
- package/bundled/locales/zh-CN/skills/commands/release.md +82 -1
- package/bundled/locales/zh-CN/skills/commands/requirement.md +40 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-bdd.md +36 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md +44 -1
- package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md +42 -1
- package/bundled/locales/zh-CN/skills/commands/reverse.md +43 -1
- package/bundled/locales/zh-CN/skills/commands/runbook.md +50 -3
- package/bundled/locales/zh-CN/skills/commands/scan.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/sdd-retro.md +50 -1
- package/bundled/locales/zh-CN/skills/commands/sdd.md +182 -1
- package/bundled/locales/zh-CN/skills/commands/security.md +3 -2
- package/bundled/locales/zh-CN/skills/commands/slo.md +51 -3
- package/bundled/locales/zh-CN/skills/commands/tdd.md +74 -5
- package/bundled/locales/zh-CN/skills/commands/update.md +70 -8
- package/bundled/locales/zh-CN/skills/commit-standards/SKILL.md +4 -4
- package/bundled/locales/zh-CN/skills/commit-standards/conventional-commits.md +45 -44
- package/bundled/locales/zh-CN/skills/commit-standards/guide.md +172 -52
- package/bundled/locales/zh-CN/skills/commit-standards/language-options.md +50 -47
- package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/contract-test-assistant/guide.md +76 -1
- package/bundled/locales/zh-CN/skills/database-assistant/SKILL.md +18 -5
- package/bundled/locales/zh-CN/skills/dev-methodology/SKILL.md +4 -2
- package/bundled/locales/zh-CN/skills/dev-methodology/create-methodology.md +2 -0
- package/bundled/locales/zh-CN/skills/dev-methodology/runtime.md +2 -0
- package/bundled/locales/zh-CN/skills/docs-generator/SKILL.md +16 -2
- package/bundled/locales/zh-CN/skills/docs-generator/guide.md +8 -7
- package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md +209 -184
- package/bundled/locales/zh-CN/skills/documentation-guide/documentation-structure.md +73 -72
- package/bundled/locales/zh-CN/skills/documentation-guide/readme-template.md +37 -36
- package/bundled/locales/zh-CN/skills/durable-execution-assistant/SKILL.md +28 -2
- package/bundled/locales/zh-CN/skills/e2e-assistant/SKILL.md +21 -6
- package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md +76 -95
- package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md +80 -87
- package/bundled/locales/zh-CN/skills/git-workflow-guide/branch-naming.md +44 -43
- package/bundled/locales/zh-CN/skills/git-workflow-guide/git-workflow.md +66 -65
- package/bundled/locales/zh-CN/skills/incident-response-assistant/SKILL.md +31 -13
- package/bundled/locales/zh-CN/skills/metrics-dashboard-assistant/SKILL.md +38 -2
- package/bundled/locales/zh-CN/skills/observability-assistant/SKILL.md +75 -1
- package/bundled/locales/zh-CN/skills/pr-automation-assistant/SKILL.md +32 -6
- package/bundled/locales/zh-CN/skills/project-discovery/SKILL.md +8 -2
- package/bundled/locales/zh-CN/skills/project-discovery/guide.md +158 -157
- package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md +49 -46
- package/bundled/locales/zh-CN/skills/project-structure-guide/language-patterns.md +8 -7
- package/bundled/locales/zh-CN/skills/refactoring-assistant/SKILL.md +22 -2
- package/bundled/locales/zh-CN/skills/refactoring-assistant/guide.md +172 -171
- package/bundled/locales/zh-CN/skills/release-standards/SKILL.md +66 -23
- package/bundled/locales/zh-CN/skills/release-standards/changelog-format.md +42 -41
- package/bundled/locales/zh-CN/skills/release-standards/guide.md +51 -43
- package/bundled/locales/zh-CN/skills/release-standards/release-workflow.md +131 -95
- package/bundled/locales/zh-CN/skills/release-standards/semantic-versioning.md +62 -61
- package/bundled/locales/zh-CN/skills/requirement-assistant/SKILL.md +24 -15
- package/bundled/locales/zh-CN/skills/requirement-assistant/guide.md +88 -79
- package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-checklist.md +128 -127
- package/bundled/locales/zh-CN/skills/requirement-assistant/requirement-writing.md +121 -120
- package/bundled/locales/zh-CN/skills/retrospective-assistant/guide.md +206 -2
- package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/reverse-engineer/bdd-extraction.md +2 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/guide.md +297 -173
- package/bundled/locales/zh-CN/skills/reverse-engineer/tdd-analysis.md +2 -1
- package/bundled/locales/zh-CN/skills/reverse-engineer/workflow.md +2 -1
- package/bundled/locales/zh-CN/skills/runbook-assistant/SKILL.md +9 -2
- package/bundled/locales/zh-CN/skills/security-assistant/SKILL.md +24 -6
- package/bundled/locales/zh-CN/skills/security-scan-assistant/SKILL.md +34 -10
- package/bundled/locales/zh-CN/skills/slo-assistant/SKILL.md +2 -1
- package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md +2 -2
- package/bundled/locales/zh-CN/skills/spec-driven-dev/guide.md +38 -6
- package/bundled/locales/zh-CN/skills/tdd-assistant/SKILL.md +16 -3
- package/bundled/locales/zh-CN/skills/tdd-assistant/guide.md +217 -156
- package/bundled/locales/zh-CN/skills/tdd-assistant/language-examples.md +727 -82
- package/bundled/locales/zh-CN/skills/tdd-assistant/tdd-workflow.md +396 -214
- package/bundled/locales/zh-CN/skills/test-coverage-assistant/SKILL.md +14 -5
- package/bundled/locales/zh-CN/skills/test-coverage-assistant/guide.md +25 -12
- package/bundled/locales/zh-CN/skills/testing-guide/testing-pyramid.md +99 -98
- package/bundled/locales/zh-CN/skills/testing-guide/testing-theory.md +3 -1
- package/bundled/locales/zh-CN/skills/tools/cline/README.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/copilot/README.md +65 -18
- package/bundled/locales/zh-CN/skills/tools/copilot/copilot-instructions.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/cursor/README.md +2 -1
- package/bundled/locales/zh-CN/skills/tools/windsurf/README.md +2 -1
- package/bundled/locales/zh-CN/skills/workflows/README.md +4 -2
- package/bundled/locales/zh-CN/templates/reverse-spec-template.md +50 -1
- package/bundled/locales/zh-TW/CHANGELOG.md +2291 -1110
- package/bundled/locales/zh-TW/CLAUDE.md +962 -76
- package/bundled/locales/zh-TW/README.md +3 -3
- package/bundled/locales/zh-TW/SECURITY.md +3 -3
- package/bundled/locales/zh-TW/STANDARDS-MAPPING.md +103 -6
- package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +46 -93
- package/bundled/locales/zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +3 -1
- package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +10 -9
- package/bundled/locales/zh-TW/adoption/checklists/minimal.md +6 -2
- package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -4
- package/bundled/locales/zh-TW/ai/MAINTENANCE.md +34 -14
- package/bundled/locales/zh-TW/ai/options/commit-message/traditional-chinese.ai.yaml +48 -40
- package/bundled/locales/zh-TW/core/acceptance-criteria-traceability.md +56 -10
- package/bundled/locales/zh-TW/core/acceptance-test-driven-development.md +2 -1
- package/bundled/locales/zh-TW/core/accessibility-standards.md +895 -46
- package/bundled/locales/zh-TW/core/adr-standards.md +2 -1
- package/bundled/locales/zh-TW/core/agent-communication-protocol.md +2 -1
- package/bundled/locales/zh-TW/core/agent-dispatch.md +102 -33
- package/bundled/locales/zh-TW/core/ai-agreement-standards.md +58 -41
- package/bundled/locales/zh-TW/core/ai-command-behavior.md +2 -1
- package/bundled/locales/zh-TW/core/ai-friendly-architecture.md +306 -67
- package/bundled/locales/zh-TW/core/ai-instruction-standards.md +16 -13
- package/bundled/locales/zh-TW/core/ai-response-navigation.md +3 -3
- package/bundled/locales/zh-TW/core/alerting-standards.md +257 -35
- package/bundled/locales/zh-TW/core/anti-hallucination.md +169 -40
- package/bundled/locales/zh-TW/core/anti-sycophancy-prompting.md +2 -1
- package/bundled/locales/zh-TW/core/api-design-standards.md +2 -1
- package/bundled/locales/zh-TW/core/behavior-driven-development.md +3 -17
- package/bundled/locales/zh-TW/core/branch-completion.md +130 -34
- package/bundled/locales/zh-TW/core/capability-declaration.md +41 -79
- package/bundled/locales/zh-TW/core/change-batching-standards.md +2 -1
- package/bundled/locales/zh-TW/core/changelog-standards.md +14 -9
- package/bundled/locales/zh-TW/core/chaos-engineering-standards.md +138 -36
- package/bundled/locales/zh-TW/core/checkin-standards.md +84 -26
- package/bundled/locales/zh-TW/core/circuit-breaker.md +48 -87
- package/bundled/locales/zh-TW/core/code-review-checklist.md +19 -7
- package/bundled/locales/zh-TW/core/commit-message-guide.md +218 -87
- package/bundled/locales/zh-TW/core/containerization-standards.md +259 -57
- package/bundled/locales/zh-TW/core/context-aware-loading.md +121 -27
- package/bundled/locales/zh-TW/core/database-standards.md +2 -1
- package/bundled/locales/zh-TW/core/deprecation-standards.md +139 -37
- package/bundled/locales/zh-TW/core/design-document-standards.md +265 -55
- package/bundled/locales/zh-TW/core/developer-memory.md +102 -12
- package/bundled/locales/zh-TW/core/documentation-lifecycle.md +2 -1
- package/bundled/locales/zh-TW/core/documentation-structure.md +17 -8
- package/bundled/locales/zh-TW/core/dual-phase-output.md +28 -90
- package/bundled/locales/zh-TW/core/environment-standards.md +250 -72
- package/bundled/locales/zh-TW/core/error-code-standards.md +17 -6
- package/bundled/locales/zh-TW/core/estimation-standards.md +177 -44
- package/bundled/locales/zh-TW/core/execution-history.md +2 -1
- package/bundled/locales/zh-TW/core/failure-source-taxonomy.md +59 -117
- package/bundled/locales/zh-TW/core/feature-flag-standards.md +202 -57
- package/bundled/locales/zh-TW/core/forward-derivation-standards.md +592 -133
- package/bundled/locales/zh-TW/core/frontend-design-standards.md +120 -8
- package/bundled/locales/zh-TW/core/git-workflow.md +197 -37
- package/bundled/locales/zh-TW/core/git-worktree.md +79 -49
- package/bundled/locales/zh-TW/core/guides/anti-hallucination-guide.md +234 -487
- package/bundled/locales/zh-TW/core/guides/file-placement-guide.md +86 -2
- package/bundled/locales/zh-TW/core/guides/git-workflow-guide.md +411 -464
- package/bundled/locales/zh-TW/core/guides/performance-guide.md +2 -0
- package/bundled/locales/zh-TW/core/guides/refactoring-guide.md +237 -484
- package/bundled/locales/zh-TW/core/guides/security-guide.md +2 -0
- package/bundled/locales/zh-TW/core/health-check-standards.md +46 -104
- package/bundled/locales/zh-TW/core/immutability-first.md +45 -85
- package/bundled/locales/zh-TW/core/knowledge-graph-memory.md +2 -1
- package/bundled/locales/zh-TW/core/knowledge-transfer-standards.md +103 -40
- package/bundled/locales/zh-TW/core/observability-standards.md +284 -40
- package/bundled/locales/zh-TW/core/performance-standards.md +387 -86
- package/bundled/locales/zh-TW/core/pipeline-integration-standards.md +2 -1
- package/bundled/locales/zh-TW/core/postmortem-standards.md +367 -36
- package/bundled/locales/zh-TW/core/privacy-standards.md +153 -46
- package/bundled/locales/zh-TW/core/project-context-memory.md +210 -31
- package/bundled/locales/zh-TW/core/project-structure.md +240 -19
- package/bundled/locales/zh-TW/core/recovery-recipe-registry.md +54 -114
- package/bundled/locales/zh-TW/core/refactoring-standards.md +153 -48
- package/bundled/locales/zh-TW/core/requirement-engineering.md +8 -37
- package/bundled/locales/zh-TW/core/retrospective-standards.md +127 -7
- package/bundled/locales/zh-TW/core/retry-standards.md +41 -105
- package/bundled/locales/zh-TW/core/reverse-engineering-standards.md +5 -1
- package/bundled/locales/zh-TW/core/runbook-standards.md +296 -23
- package/bundled/locales/zh-TW/core/secret-management-standards.md +12 -4
- package/bundled/locales/zh-TW/core/security-decision.md +43 -84
- package/bundled/locales/zh-TW/core/security-standards.md +204 -25
- package/bundled/locales/zh-TW/core/self-review-protocol.md +2 -1
- package/bundled/locales/zh-TW/core/skill-standard-alignment-check.md +103 -69
- package/bundled/locales/zh-TW/core/slo-standards.md +301 -49
- package/bundled/locales/zh-TW/core/spec-driven-development.md +36 -7
- package/bundled/locales/zh-TW/core/standard-admission-criteria.md +22 -28
- package/bundled/locales/zh-TW/core/standard-lifecycle-management.md +40 -48
- package/bundled/locales/zh-TW/core/structured-task-definition.md +2 -1
- package/bundled/locales/zh-TW/core/supply-chain-security-standards.md +137 -10
- package/bundled/locales/zh-TW/core/systematic-debugging.md +94 -38
- package/bundled/locales/zh-TW/core/tech-debt-standards.md +170 -54
- package/bundled/locales/zh-TW/core/test-completeness-dimensions.md +101 -12
- package/bundled/locales/zh-TW/core/test-data-standards.md +245 -23
- package/bundled/locales/zh-TW/core/test-driven-development.md +4 -1
- package/bundled/locales/zh-TW/core/test-governance.md +92 -32
- package/bundled/locales/zh-TW/core/testing-standards.md +61 -14
- package/bundled/locales/zh-TW/core/timeout-standards.md +45 -85
- package/bundled/locales/zh-TW/core/token-budget.md +41 -112
- package/bundled/locales/zh-TW/core/translation-lifecycle-standards.md +28 -16
- package/bundled/locales/zh-TW/core/verification-evidence.md +2 -1
- package/bundled/locales/zh-TW/core/versioning.md +6 -2
- package/bundled/locales/zh-TW/core/virtual-organization-standards.md +42 -36
- package/bundled/locales/zh-TW/core/workflow-enforcement.md +2 -1
- package/bundled/locales/zh-TW/core/workflow-state-protocol.md +2 -1
- package/bundled/locales/zh-TW/docs/CHEATSHEET.md +2 -1
- package/bundled/locales/zh-TW/docs/CLI-FLOW.md +2 -1
- package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +12 -3
- package/bundled/locales/zh-TW/docs/DEV-WORKFLOW-MAPPING.md +2 -1
- package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +8 -6
- package/bundled/locales/zh-TW/docs/STANDARDS-REFERENCE.md +2 -1
- package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +2 -1
- package/bundled/locales/zh-TW/docs/USER-MANUAL.md +9 -1
- package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +4 -1
- package/bundled/locales/zh-TW/docs/specs/system/memory-adoption-strategy.md +2 -0
- package/bundled/locales/zh-TW/docs/user/FAQ.md +2 -0
- package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +2 -0
- package/bundled/locales/zh-TW/docs/user/GLOSSARY.md +2 -0
- package/bundled/locales/zh-TW/docs/user/README.md +2 -0
- package/bundled/locales/zh-TW/docs/user/TROUBLESHOOTING.md +2 -0
- package/bundled/locales/zh-TW/integrations/claude-code/README.md +2 -1
- package/bundled/locales/zh-TW/integrations/codex/AGENTS.md +136 -2
- package/bundled/locales/zh-TW/integrations/codex/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/gemini-cli/GEMINI.md +59 -1
- package/bundled/locales/zh-TW/integrations/gemini-cli/README.md +8 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/COPILOT-CHAT-REFERENCE.md +7 -1
- package/bundled/locales/zh-TW/integrations/github-copilot/README.md +9 -3
- package/bundled/locales/zh-TW/integrations/github-copilot/copilot-instructions.md +146 -12
- package/bundled/locales/zh-TW/integrations/github-copilot/skills-mapping.md +7 -1
- package/bundled/locales/zh-TW/integrations/google-antigravity/AGENTS.md +110 -3
- package/bundled/locales/zh-TW/integrations/google-antigravity/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/opencode/AGENTS.md +140 -2
- package/bundled/locales/zh-TW/integrations/opencode/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/opencode/skills-mapping.md +8 -2
- package/bundled/locales/zh-TW/integrations/openspec/AGENTS.md +46 -1
- package/bundled/locales/zh-TW/integrations/openspec/README.md +7 -1
- package/bundled/locales/zh-TW/integrations/spec-kit/AGENTS.md +20 -2
- package/bundled/locales/zh-TW/integrations/spec-kit/README.md +7 -1
- package/bundled/locales/zh-TW/methodologies/guides/tdd-guide.md +584 -475
- package/bundled/locales/zh-TW/options/changelog/auto-generated.md +2 -0
- package/bundled/locales/zh-TW/options/changelog/keep-a-changelog.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/automated-review.md +2 -0
- package/bundled/locales/zh-TW/options/code-review/pair-programming.md +2 -0
- package/bundled/locales/zh-TW/options/commit-message/bilingual.md +93 -5
- package/bundled/locales/zh-TW/options/commit-message/english.md +118 -1
- package/bundled/locales/zh-TW/options/commit-message/traditional-chinese.md +82 -1
- package/bundled/locales/zh-TW/options/documentation/api-docs.md +2 -0
- package/bundled/locales/zh-TW/options/documentation/markdown-docs.md +2 -0
- package/bundled/locales/zh-TW/options/documentation/wiki-style.md +2 -0
- package/bundled/locales/zh-TW/options/git-workflow/gitflow.md +99 -71
- package/bundled/locales/zh-TW/options/git-workflow/github-flow.md +68 -50
- package/bundled/locales/zh-TW/options/git-workflow/merge-commit.md +131 -20
- package/bundled/locales/zh-TW/options/git-workflow/rebase-ff.md +142 -27
- package/bundled/locales/zh-TW/options/git-workflow/squash-merge.md +100 -15
- package/bundled/locales/zh-TW/options/git-workflow/trunk-based.md +103 -56
- package/bundled/locales/zh-TW/options/project-structure/dotnet.md +233 -14
- package/bundled/locales/zh-TW/options/project-structure/go.md +270 -12
- package/bundled/locales/zh-TW/options/project-structure/java.md +235 -15
- package/bundled/locales/zh-TW/options/project-structure/kotlin.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/nodejs.md +136 -19
- package/bundled/locales/zh-TW/options/project-structure/php.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/python.md +177 -19
- package/bundled/locales/zh-TW/options/project-structure/ruby.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/rust.md +2 -0
- package/bundled/locales/zh-TW/options/project-structure/swift.md +2 -0
- package/bundled/locales/zh-TW/options/testing/contract-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/e2e-testing.md +182 -21
- package/bundled/locales/zh-TW/options/testing/industry-pyramid.md +2 -0
- package/bundled/locales/zh-TW/options/testing/integration-testing.md +134 -22
- package/bundled/locales/zh-TW/options/testing/istqb-framework.md +2 -0
- package/bundled/locales/zh-TW/options/testing/performance-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/security-testing.md +2 -0
- package/bundled/locales/zh-TW/options/testing/system-testing.md +175 -1
- package/bundled/locales/zh-TW/options/testing/unit-testing.md +123 -9
- package/bundled/locales/zh-TW/skills/CONTRIBUTING.template.md +3 -2
- package/bundled/locales/zh-TW/skills/INTEGRATION-GUIDE.md +2 -1
- package/bundled/locales/zh-TW/skills/README.md +2 -1
- package/bundled/locales/zh-TW/skills/_shared/README.md +2 -1
- package/bundled/locales/zh-TW/skills/ac-coverage/SKILL.md +15 -4
- package/bundled/locales/zh-TW/skills/adr-assistant/guide.md +123 -3
- package/bundled/locales/zh-TW/skills/agents/README.md +99 -1
- package/bundled/locales/zh-TW/skills/agents/code-architect.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/doc-writer.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/reviewer.md +3 -1
- package/bundled/locales/zh-TW/skills/agents/spec-analyst.md +2 -0
- package/bundled/locales/zh-TW/skills/agents/test-specialist.md +2 -0
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/SKILL.md +48 -37
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/anti-hallucination.md +22 -2
- package/bundled/locales/zh-TW/skills/ai-collaboration-standards/certainty-labels.md +29 -3
- package/bundled/locales/zh-TW/skills/ai-friendly-architecture/SKILL.md +23 -36
- package/bundled/locales/zh-TW/skills/ai-instruction-standards/SKILL.md +12 -36
- package/bundled/locales/zh-TW/skills/api-design-assistant/SKILL.md +21 -5
- package/bundled/locales/zh-TW/skills/atdd-assistant/SKILL.md +40 -15
- package/bundled/locales/zh-TW/skills/atdd-assistant/acceptance-criteria-guide.md +2 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/atdd-workflow.md +98 -1
- package/bundled/locales/zh-TW/skills/atdd-assistant/guide.md +24 -8
- package/bundled/locales/zh-TW/skills/audit-assistant/SKILL.md +8 -2
- package/bundled/locales/zh-TW/skills/bdd-assistant/SKILL.md +29 -6
- package/bundled/locales/zh-TW/skills/bdd-assistant/bdd-workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/bdd-assistant/gherkin-guide.md +2 -1
- package/bundled/locales/zh-TW/skills/bdd-assistant/guide.md +9 -8
- package/bundled/locales/zh-TW/skills/changelog-guide/SKILL.md +12 -3
- package/bundled/locales/zh-TW/skills/changelog-guide/guide.md +11 -7
- package/bundled/locales/zh-TW/skills/checkin-assistant/SKILL.md +19 -3
- package/bundled/locales/zh-TW/skills/checkin-assistant/guide.md +5 -3
- package/bundled/locales/zh-TW/skills/ci-cd-assistant/SKILL.md +35 -16
- package/bundled/locales/zh-TW/skills/code-review-assistant/SKILL.md +19 -2
- package/bundled/locales/zh-TW/skills/code-review-assistant/checkin-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/code-review-assistant/guide.md +81 -6
- package/bundled/locales/zh-TW/skills/code-review-assistant/review-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/ac-coverage.md +47 -2
- package/bundled/locales/zh-TW/skills/commands/api-design.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/atdd.md +80 -10
- package/bundled/locales/zh-TW/skills/commands/audit.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/bdd.md +114 -16
- package/bundled/locales/zh-TW/skills/commands/changelog.md +45 -9
- package/bundled/locales/zh-TW/skills/commands/check.md +74 -21
- package/bundled/locales/zh-TW/skills/commands/checkin.md +56 -11
- package/bundled/locales/zh-TW/skills/commands/ci-cd.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/code-review.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/commit.md +58 -4
- package/bundled/locales/zh-TW/skills/commands/config.md +52 -4
- package/bundled/locales/zh-TW/skills/commands/coverage.md +45 -4
- package/bundled/locales/zh-TW/skills/commands/database.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/derive-all.md +44 -2
- package/bundled/locales/zh-TW/skills/commands/derive-atdd.md +37 -2
- package/bundled/locales/zh-TW/skills/commands/derive-bdd.md +44 -3
- package/bundled/locales/zh-TW/skills/commands/derive-tdd.md +45 -3
- package/bundled/locales/zh-TW/skills/commands/derive.md +62 -5
- package/bundled/locales/zh-TW/skills/commands/dev-workflow.md +60 -9
- package/bundled/locales/zh-TW/skills/commands/discover.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/docgen.md +39 -2
- package/bundled/locales/zh-TW/skills/commands/docs.md +139 -7
- package/bundled/locales/zh-TW/skills/commands/durable.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/e2e.md +86 -3
- package/bundled/locales/zh-TW/skills/commands/guide.md +4 -2
- package/bundled/locales/zh-TW/skills/commands/incident.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/init.md +72 -15
- package/bundled/locales/zh-TW/skills/commands/methodology.md +117 -28
- package/bundled/locales/zh-TW/skills/commands/metrics.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/migrate.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/observability.md +45 -2
- package/bundled/locales/zh-TW/skills/commands/pr.md +2 -1
- package/bundled/locales/zh-TW/skills/commands/refactor.md +54 -13
- package/bundled/locales/zh-TW/skills/commands/release.md +83 -2
- package/bundled/locales/zh-TW/skills/commands/requirement.md +41 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-bdd.md +37 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-sdd.md +45 -2
- package/bundled/locales/zh-TW/skills/commands/reverse-tdd.md +43 -2
- package/bundled/locales/zh-TW/skills/commands/reverse.md +44 -2
- package/bundled/locales/zh-TW/skills/commands/runbook.md +47 -2
- package/bundled/locales/zh-TW/skills/commands/scan.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/sdd-retro.md +52 -3
- package/bundled/locales/zh-TW/skills/commands/sdd.md +209 -28
- package/bundled/locales/zh-TW/skills/commands/security.md +3 -2
- package/bundled/locales/zh-TW/skills/commands/slo.md +48 -2
- package/bundled/locales/zh-TW/skills/commands/tdd.md +71 -2
- package/bundled/locales/zh-TW/skills/commands/update.md +64 -2
- package/bundled/locales/zh-TW/skills/commit-standards/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/commit-standards/conventional-commits.md +2 -1
- package/bundled/locales/zh-TW/skills/commit-standards/guide.md +137 -17
- package/bundled/locales/zh-TW/skills/commit-standards/language-options.md +21 -18
- package/bundled/locales/zh-TW/skills/contract-test-assistant/SKILL.md +2 -2
- package/bundled/locales/zh-TW/skills/contract-test-assistant/guide.md +81 -1
- package/bundled/locales/zh-TW/skills/database-assistant/SKILL.md +21 -5
- package/bundled/locales/zh-TW/skills/deploy-assistant/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/dev-methodology/SKILL.md +4 -1
- package/bundled/locales/zh-TW/skills/dev-methodology/create-methodology.md +2 -0
- package/bundled/locales/zh-TW/skills/dev-methodology/runtime.md +2 -0
- package/bundled/locales/zh-TW/skills/docs-generator/SKILL.md +19 -2
- package/bundled/locales/zh-TW/skills/docs-generator/guide.md +4 -3
- package/bundled/locales/zh-TW/skills/documentation-guide/SKILL.md +67 -42
- package/bundled/locales/zh-TW/skills/documentation-guide/documentation-structure.md +2 -1
- package/bundled/locales/zh-TW/skills/documentation-guide/readme-template.md +2 -1
- package/bundled/locales/zh-TW/skills/durable-execution-assistant/SKILL.md +32 -3
- package/bundled/locales/zh-TW/skills/e2e-assistant/SKILL.md +25 -7
- package/bundled/locales/zh-TW/skills/error-code-guide/SKILL.md +17 -34
- package/bundled/locales/zh-TW/skills/git-workflow-guide/SKILL.md +33 -38
- package/bundled/locales/zh-TW/skills/git-workflow-guide/branch-naming.md +2 -1
- package/bundled/locales/zh-TW/skills/git-workflow-guide/git-workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/incident-response-assistant/SKILL.md +35 -14
- package/bundled/locales/zh-TW/skills/journey-test-assistant/SKILL.md +2 -14
- package/bundled/locales/zh-TW/skills/knowledge-graph/SKILL.md +6 -2
- package/bundled/locales/zh-TW/skills/metrics-dashboard-assistant/SKILL.md +42 -3
- package/bundled/locales/zh-TW/skills/observability-assistant/SKILL.md +85 -18
- package/bundled/locales/zh-TW/skills/pr-automation-assistant/SKILL.md +27 -3
- package/bundled/locales/zh-TW/skills/project-discovery/SKILL.md +11 -3
- package/bundled/locales/zh-TW/skills/project-discovery/guide.md +5 -3
- package/bundled/locales/zh-TW/skills/project-discovery/workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/project-structure-guide/SKILL.md +19 -16
- package/bundled/locales/zh-TW/skills/project-structure-guide/language-patterns.md +2 -1
- package/bundled/locales/zh-TW/skills/refactoring-assistant/SKILL.md +26 -3
- package/bundled/locales/zh-TW/skills/refactoring-assistant/guide.md +4 -2
- package/bundled/locales/zh-TW/skills/release-standards/SKILL.md +91 -45
- package/bundled/locales/zh-TW/skills/release-standards/changelog-format.md +4 -3
- package/bundled/locales/zh-TW/skills/release-standards/guide.md +14 -5
- package/bundled/locales/zh-TW/skills/release-standards/release-workflow.md +5 -1
- package/bundled/locales/zh-TW/skills/release-standards/semantic-versioning.md +2 -1
- package/bundled/locales/zh-TW/skills/requirement-assistant/SKILL.md +15 -6
- package/bundled/locales/zh-TW/skills/requirement-assistant/guide.md +18 -8
- package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-checklist.md +2 -1
- package/bundled/locales/zh-TW/skills/requirement-assistant/requirement-writing.md +2 -1
- package/bundled/locales/zh-TW/skills/retrospective-assistant/guide.md +200 -6
- package/bundled/locales/zh-TW/skills/reverse-engineer/bdd-extraction.md +2 -1
- package/bundled/locales/zh-TW/skills/reverse-engineer/guide.md +161 -36
- package/bundled/locales/zh-TW/skills/reverse-engineer/tdd-analysis.md +2 -1
- package/bundled/locales/zh-TW/skills/reverse-engineer/workflow.md +2 -1
- package/bundled/locales/zh-TW/skills/runbook-assistant/SKILL.md +9 -1
- package/bundled/locales/zh-TW/skills/security-assistant/SKILL.md +25 -5
- package/bundled/locales/zh-TW/skills/security-scan-assistant/SKILL.md +34 -8
- package/bundled/locales/zh-TW/skills/skill-builder/SKILL.md +3 -21
- package/bundled/locales/zh-TW/skills/slo-assistant/SKILL.md +3 -1
- package/bundled/locales/zh-TW/skills/spec-derivation/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/spec-driven-dev/guide.md +35 -2
- package/bundled/locales/zh-TW/skills/sweep/SKILL.md +2 -1
- package/bundled/locales/zh-TW/skills/tdd-assistant/SKILL.md +10 -2
- package/bundled/locales/zh-TW/skills/tdd-assistant/guide.md +68 -9
- package/bundled/locales/zh-TW/skills/tdd-assistant/language-examples.md +693 -47
- package/bundled/locales/zh-TW/skills/tdd-assistant/tdd-workflow.md +183 -1
- package/bundled/locales/zh-TW/skills/test-coverage-assistant/SKILL.md +15 -5
- package/bundled/locales/zh-TW/skills/test-coverage-assistant/guide.md +26 -13
- package/bundled/locales/zh-TW/skills/testing-guide/testing-pyramid.md +2 -1
- package/bundled/locales/zh-TW/skills/testing-guide/testing-theory.md +3 -1
- package/bundled/locales/zh-TW/skills/tools/cline/README.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/copilot/README.md +65 -18
- package/bundled/locales/zh-TW/skills/tools/copilot/copilot-instructions.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/cursor/README.md +2 -1
- package/bundled/locales/zh-TW/skills/tools/windsurf/README.md +2 -1
- package/bundled/locales/zh-TW/skills/workflows/README.md +11 -9
- package/bundled/locales/zh-TW/templates/reverse-spec-template.md +50 -1
- package/bundled/skills/.claude-plugin/plugin.json +71 -0
- package/bundled/skills/commit-standards/SKILL.md +2 -2
- package/bundled/skills/commit-standards/guide.md +3 -2
- package/bundled/skills/commit-standards/language-options.md +19 -17
- package/package.json +2 -2
- package/src/commands/audit.js +28 -1
- package/src/commands/check.js +77 -7
- package/src/commands/compile.js +37 -4
- package/src/commands/config.js +49 -24
- package/src/commands/init.js +78 -30
- package/src/commands/open-work.js +6 -2
- package/src/commands/release-messages.js +228 -0
- package/src/commands/release.js +127 -68
- package/src/commands/run-intent.js +11 -0
- package/src/commands/spec-split.js +2 -1
- package/src/commands/spec.js +11 -2
- package/src/commands/update.js +184 -30
- package/src/compilers/claude-code-compiler.js +9 -1
- package/src/config/ai-agent-paths.js +14 -1
- package/src/core/installed-formats.js +15 -0
- package/src/core/open-work-config.js +20 -1
- package/src/core/project-config.js +55 -0
- package/src/i18n/messages.js +160 -2
- package/src/installers/hooks-installer.js +1 -1
- package/src/installers/manifest-installer.js +1 -1
- package/src/installers/skills-installer.js +1 -1
- package/src/installers/standards-installer.js +3 -1
- package/src/mcp/server.js +9 -3
- package/src/prompts/init.js +26 -22
- package/src/reconciler/actual-state-scanner.js +2 -8
- package/src/reconciler/backup-locations.js +5 -0
- package/src/reconciler/backup-manager.js +19 -11
- package/src/reconciler/desired-state-calculator.js +89 -57
- package/src/reconciler/plan-executor.js +101 -8
- package/src/reconciler/recorded-versions.js +49 -0
- package/src/reconciler/relative-path.js +23 -0
- package/src/uninstallers/hook-uninstaller.js +9 -1
- package/src/uninstallers/skills-uninstaller.js +22 -3
- package/src/utils/available-standards-report.js +25 -4
- package/src/utils/available-standards.js +13 -3
- package/src/utils/build-manifest.js +1 -1
- package/src/utils/commit-message-judge.js +60 -13
- package/src/utils/friction-detector.js +23 -11
- package/src/utils/git-hooks.js +106 -4
- package/src/utils/integration-generator.js +95 -67
- package/src/utils/legacy-hook-migration.js +121 -2
- package/src/utils/open-work-tracking.mjs +105 -16
- package/src/utils/sdd-header.js +16 -4
- package/src/utils/skills-installer.js +2 -1
- package/src/utils/spinner.js +14 -4
- package/src/utils/standard-validator.js +3 -2
- package/standards-registry.json +10 -8
- 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.
|
|
4
|
-
translation_version: 1.
|
|
5
|
-
last_synced: 2026-
|
|
6
|
-
|
|
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.
|
|
14
|
-
**最後更新**: 2026-
|
|
14
|
+
**版本**: 1.1.0
|
|
15
|
+
**最後更新**: 2026-06-18
|
|
15
16
|
**適用性**: 所有具有使用者介面的軟體專案
|
|
16
|
-
**範圍**: 通用 (
|
|
17
|
-
**業界標準**: WCAG 2.1/2.2
|
|
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
|
-
|
|
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
|
|
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
|
-
##
|
|
37
|
+
## 目錄
|
|
36
38
|
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
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
|
-
|
|
|
57
|
-
|
|
|
58
|
-
|
|
|
59
|
-
|
|
|
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
|
-
|
|
64
|
-
|
|
65
|
-
|
|
|
66
|
-
|
|
67
|
-
|
|
|
68
|
-
|
|
|
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
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
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
|
-
- [
|
|
83
|
-
- [
|
|
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)
|