universal-dev-standards 6.14.0-beta.9 → 6.14.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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 +2309 -1110
- 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 +2282 -1112
- 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 +72 -3
- 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.js +4 -2
- package/src/commands/update.js +173 -20
- 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 +106 -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,17 +1,18 @@
|
|
|
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
|
-
> **语言**: [English](../../../core/accessibility-standards.md) | 简体中文
|
|
10
|
-
|
|
11
10
|
# 无障碍标准
|
|
12
11
|
|
|
13
|
-
|
|
14
|
-
|
|
12
|
+
> **语言**: [English](../../../core/accessibility-standards.md) | [繁體中文](../../zh-TW/core/accessibility-standards.md) | 简体中文
|
|
13
|
+
|
|
14
|
+
**版本**: 1.1.0
|
|
15
|
+
**最后更新**: 2026-06-18
|
|
15
16
|
**适用范围**: 所有包含用户界面的软件项目
|
|
16
17
|
**范围**: universal
|
|
17
18
|
**行业标准**: WCAG 2.1/2.2, WAI-ARIA 1.2, Section 508
|
|
@@ -21,13 +22,33 @@ status: stale
|
|
|
21
22
|
|
|
22
23
|
## 目的
|
|
23
24
|
|
|
24
|
-
|
|
25
|
+
本标准定义创建无障碍软件的综合指南,使具有不同能力的人都能使用。标准与国际标准(包括 WCAG 2.1)保持对齐,并支持全球无障碍法规的合规性。
|
|
25
26
|
|
|
26
27
|
**参考标准**:
|
|
27
28
|
- [WCAG 2.1](https://www.w3.org/WAI/WCAG21/quickref/) - 网页内容无障碍指南
|
|
28
29
|
- [WCAG 2.2](https://www.w3.org/TR/WCAG22/) - 最新 WCAG 版本(2023)
|
|
29
30
|
- [WAI-ARIA 1.2](https://www.w3.org/TR/wai-aria-1.2/) - 无障碍富互联网应用
|
|
31
|
+
- [ISO/IEC 25010:2011](https://www.iso.org/standard/35733.html) - 可用性 > 无障碍
|
|
30
32
|
- [Section 508](https://www.section508.gov/) - 美国联邦无障碍要求
|
|
33
|
+
- [EN 301 549](https://www.etsi.org/deliver/etsi_en/301500_301599/301549/) - 欧洲无障碍标准
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
## 目录
|
|
38
|
+
|
|
39
|
+
1. [无障碍原则(POUR)](#accessibility-principles-pour)
|
|
40
|
+
2. [WCAG 合规级别](#wcag-conformance-levels)
|
|
41
|
+
3. [可感知](#perceivable)
|
|
42
|
+
4. [可操作](#operable)
|
|
43
|
+
5. [可理解](#understandable)
|
|
44
|
+
6. [健壮](#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)
|
|
31
52
|
|
|
32
53
|
---
|
|
33
54
|
|
|
@@ -35,90 +56,878 @@ status: stale
|
|
|
35
56
|
|
|
36
57
|
```
|
|
37
58
|
┌─────────────────────────────────────────────────────────────────┐
|
|
38
|
-
│ WCAG 2.1 POUR
|
|
59
|
+
│ WCAG 2.1 POUR Principles │
|
|
39
60
|
├─────────────────────────────────────────────────────────────────┤
|
|
40
61
|
│ │
|
|
41
|
-
│ P -
|
|
42
|
-
│ ├──
|
|
43
|
-
│ ├──
|
|
44
|
-
│ ├──
|
|
45
|
-
│ └──
|
|
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 │
|
|
46
67
|
│ │
|
|
47
|
-
│ O -
|
|
48
|
-
│ ├──
|
|
49
|
-
│ ├──
|
|
50
|
-
│ ├──
|
|
51
|
-
│ └──
|
|
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 │
|
|
52
73
|
│ │
|
|
53
|
-
│ U -
|
|
54
|
-
│ ├──
|
|
55
|
-
│ ├──
|
|
56
|
-
│ └──
|
|
74
|
+
│ U - UNDERSTANDABLE │
|
|
75
|
+
│ ├── Text is readable and understandable │
|
|
76
|
+
│ ├── Content appears and operates predictably │
|
|
77
|
+
│ └── Users are helped to avoid and correct mistakes │
|
|
57
78
|
│ │
|
|
58
|
-
│ R -
|
|
59
|
-
│ ├──
|
|
60
|
-
│
|
|
79
|
+
│ R - ROBUST │
|
|
80
|
+
│ ├── Content compatible with current and future tools │
|
|
81
|
+
│ ├── Works with assistive technologies │
|
|
82
|
+
│ └── Valid, well-formed markup │
|
|
61
83
|
│ │
|
|
62
84
|
└─────────────────────────────────────────────────────────────────┘
|
|
63
85
|
```
|
|
64
86
|
|
|
87
|
+
---
|
|
88
|
+
|
|
65
89
|
## WCAG 合规级别
|
|
66
90
|
|
|
67
|
-
|
|
68
|
-
|------|------|------|
|
|
69
|
-
| **A** | 最低级别 — 基本无障碍 | 所有项目的最低要求 |
|
|
70
|
-
| **AA** | 中级 — 解决最常见的障碍 | **推荐目标**(大多数法规要求) |
|
|
71
|
-
| **AAA** | 最高级别 — 最全面的无障碍 | 针对特定需求的增强 |
|
|
91
|
+
### 级别概述
|
|
72
92
|
|
|
73
|
-
|
|
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 Level AA
|
|
110
|
+
|
|
111
|
+
**建议**: 所有项目应将 **WCAG 2.1 Level AA** 作为基准,涵盖:
|
|
112
|
+
- 30 项 A 级准则(必须具备)
|
|
113
|
+
- 20 项 AA 级准则(应当具备)
|
|
114
|
+
|
|
115
|
+
---
|
|
116
|
+
|
|
117
|
+
## 可感知
|
|
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
|
+
**Alt 文本指南**:
|
|
137
|
+
|
|
138
|
+
| 图片类型 | Alt 文本处理方式 |
|
|
139
|
+
|------------|-------------------|
|
|
140
|
+
| **信息性** | 描述所传达的信息 |
|
|
141
|
+
| **功能性** | 描述操作(例如,“提交表单”) |
|
|
142
|
+
| **装饰性** | 使用空 alt(`alt=""`) |
|
|
143
|
+
| **复杂** | 提供长描述(通过 `aria-describedby`) |
|
|
144
|
+
| **图片中的文本** | 在 alt 中包含所有文本 |
|
|
145
|
+
|
|
146
|
+
### 1.2 基于时间的媒体
|
|
147
|
+
|
|
148
|
+
| 媒体类型 | 要求 |
|
|
149
|
+
|------------|--------------|
|
|
150
|
+
| **预录音频** | 文字记录 |
|
|
151
|
+
| **预录视频** | 字幕 + 音频描述 |
|
|
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 可区分
|
|
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 输入方式
|
|
74
304
|
|
|
75
305
|
| 要求 | 说明 |
|
|
76
306
|
|------|------|
|
|
77
|
-
|
|
|
78
|
-
|
|
|
79
|
-
|
|
|
80
|
-
|
|
|
81
|
-
|
|
307
|
+
| **指针手势** | 复杂手势具备简易替代方案 |
|
|
308
|
+
| **指针取消** | 抬起事件激活,具备中止能力 |
|
|
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
|
+
| **数据修改** | 可恢复(撤销)或可确认 |
|
|
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
|
+
**实时区域**:
|
|
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
|
+
**对话框/模态框**:
|
|
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
|
+
**标签页**:
|
|
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
|
+
---
|
|
82
527
|
|
|
83
528
|
## 颜色与对比度
|
|
84
529
|
|
|
85
|
-
|
|
86
|
-
|------|---------|----------|
|
|
87
|
-
| 普通文本 | 4.5:1 | 7:1 |
|
|
88
|
-
| 大文本(18px+) | 3:1 | 4.5:1 |
|
|
89
|
-
| UI 组件和图标 | 3:1 | 不适用 |
|
|
530
|
+
### 对比度要求
|
|
90
531
|
|
|
91
|
-
|
|
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
|
+
### 表单标签
|
|
92
583
|
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
-
|
|
99
|
-
-
|
|
100
|
-
-
|
|
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
|
+
---
|
|
101
696
|
|
|
102
697
|
## 测试与验证
|
|
103
698
|
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
|
107
|
-
|
|
108
|
-
|
|
|
109
|
-
|
|
|
110
|
-
|
|
|
699
|
+
### 自动化测试工具
|
|
700
|
+
|
|
701
|
+
| 工具 | 类型 | 覆盖范围 |
|
|
702
|
+
|------|------|----------|
|
|
703
|
+
| **axe-core** | 浏览器扩展、CI | ~57% 的 WCAG 问题 |
|
|
704
|
+
| **WAVE** | 浏览器扩展 | 可视化反馈 |
|
|
705
|
+
| **Lighthouse** | 浏览器 DevTools | 性能 + 无障碍 |
|
|
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
|
|
759
|
+
|
|
760
|
+
- name: Install dependencies
|
|
761
|
+
run: npm ci
|
|
762
|
+
|
|
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
|
+
本节定义了在生产发布前必须通过的**最低无障碍质量门禁**(`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:关闭模态框 / 遮罩层
|
|
867
|
+
- 方向键:导航菜单、选项卡、树形视图
|
|
868
|
+
|
|
869
|
+
门禁:100% 的关键流程步骤可通过键盘到达;无焦点陷阱。
|
|
870
|
+
|
|
871
|
+
### 屏幕阅读器抽检(手动,UAT 前)
|
|
872
|
+
|
|
873
|
+
最低要求:在以下每个环境中测试 1 个关键用户流程:
|
|
874
|
+
- **Windows**:NVDA + Chrome
|
|
875
|
+
- **macOS**:VoiceOver + Safari
|
|
876
|
+
|
|
877
|
+
通过标准:所有步骤在无需视觉参考的情况下均可完成;所有表单错误均有读屏朗读;所有动态内容变更均有读屏朗读。
|
|
878
|
+
|
|
879
|
+
### 发布签核凭证
|
|
880
|
+
|
|
881
|
+
无障碍门禁计入发布就绪签核的形式为:
|
|
882
|
+
|
|
883
|
+
```
|
|
884
|
+
| 3 | Accessibility | PASS | axe report: 0 critical / 0 serious; keyboard pass; SR spot-check VoiceOver OK | QA Lead |
|
|
885
|
+
```
|
|
111
886
|
|
|
112
887
|
---
|
|
113
888
|
|
|
114
889
|
## 相关标准
|
|
115
890
|
|
|
116
|
-
- [
|
|
117
|
-
- [
|
|
118
|
-
- [测试标准](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:无障碍发布门禁
|
|
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 创作实践](https://www.w3.org/WAI/ARIA/apg/) - 设计模式
|
|
906
|
+
|
|
907
|
+
### 工具
|
|
908
|
+
- [axe DevTools](https://www.deque.com/axe/) - 浏览器扩展
|
|
909
|
+
- [WAVE](https://wave.webaim.org/) - Web 无障碍评估
|
|
910
|
+
- [Contrast Checker](https://webaim.org/resources/contrastchecker/) - 颜色对比度工具
|
|
911
|
+
- [NVDA](https://www.nvaccess.org/) - Windows 免费屏幕阅读器
|
|
912
|
+
|
|
913
|
+
### 学习资源
|
|
914
|
+
- [WebAIM](https://webaim.org/) - Web 无障碍资源
|
|
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 | 新增:会话超时时长的来源 + 可配置说明(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 指南、键盘导航、表单、测试 |
|
|
119
926
|
|
|
120
927
|
---
|
|
121
928
|
|
|
122
929
|
## 许可证
|
|
123
930
|
|
|
124
931
|
本标准采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 发布。
|
|
932
|
+
|
|
933
|
+
**来源**:[universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
|