反面链接文本毫无信息量【免费下载链接】awesome-copilotCommunity-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-copilotRead my blog post here正面链接文本自带目的地语义Read my blog post Crafting an accessible resumé仓库中的 Markdown 语法参考 [skills/markdown-to-html/references/basic-markdown.md](https://link.gitcode.com/i/4734d56b833876593dbef15fd1fba4b1) 本身就是一个很好的练习样本——读者可以对照检查其中的链接与锚点写法。此外正文中的裸 URLbare URL也应转换为描述性链接这与 markdownlint 的 MD034 规则相互印证详见第五节。 ### 3.2 为图片补充 ALT 文本 **为什么重要** 低视力用户依赖屏幕阅读器理解视觉内容而屏幕阅读器只能读取 alt 属性中的文字描述。 **Agent 的关键行为约束** 对于缺失或不合格的 alt 文本Agent 的做法是**标记问题并提出改进建议等待人工审阅批准后才修改**。原因很实在alt 文本需要理解图片的视觉内容与使用语境只有人类作者才能准确判断“这张图为什么要放在这里、想传达什么”。 **最佳实践判据** - 简洁且有描述性像写一条推文那样精炼 - 包含图片中所有可见的文字 - 结合上下文思考这张图为什么被使用想传达什么 - 相关场景使用 “screenshot of”不要写 “image of”因为屏幕阅读器会自动播报“图片” - 对复杂图片图表、信息图在 alt 文本中总结数据要点并用 details 标签或外部链接提供更长的描述。 **语法与示例** markdown Alt text description 上面的示例展示了理想写法不仅描述了人物、衣着、背景、动作还把图片中可见的文字 “We can do it!” 一并写入。仓库配套规则 instructions/markdown-accessibility.instructions.md 还补充了两种典型的失败模式alt 文本直接写成文件名如img_1234.jpg或写成泛化占位符如screenshot、image。3.3 使用规范的标题层级为什么重要规范的标题层级给内容以结构让辅助技术用户能理解文档组织方式并直接跳转到任意章节同时也能帮助包括 ADHD 或阅读障碍者在内的视觉用户快速扫描内容。最佳实践判据用#作为页面标题且每页只有一个 H1遵循逻辑层级##、###、####依次递进绝不跳级例如##后直接跟####是违规的类比报纸排版越重要的内容标题越大。推荐结构示例# Welcome to My Project ## Getting Started ### Installation ### Configuration ## Contributing ### Code Style ### Testing配套规则还补充了两个容易踩的坑其一在通过 front matter 自动生成 H1 的项目中正文应从 H2 开始写其二用粗体文字**text**冒充标题也是违规行为——粗体是强调样式不是结构元素屏幕阅读器不会把它识别为可导航的标题。3.4 使用平实语言为什么重要清晰简洁的写作对所有人都有益尤其对认知障碍人群、非母语者以及使用翻译工具的用户。Agent 的关键行为约束与 alt 文本一样平实语言的改动需要标记问题、给出建议、等待人工审阅批准。因为语言风格涉及受众、语境和语气判断这些应由人类来评估。最佳实践判据使用短句和常见词汇避免行话或对技术术语给出解释使用主动语态把冗长的段落拆分成更小的单元。配套规则 instructions/markdown-accessibility.instructions.md 给出了一个很实用的进阶场景描述 UI 导航路径时应先用平实语言写成顺序步骤如 “open Settings, then select Preferences”使用稳定通用的标签而不是图标名或纯视觉描述视觉参考如 “gear icon Preferences”只能作为补充信息跟在后面绝不能作为唯一描述方式。3.5 规范列表结构并克制使用 Emoji为什么重要规范的列表标记让屏幕阅读器能播报列表上下文例如“第 1 项共 3 项”而过度使用 emoji 会形成干扰。列表方面的判据始终使用规范 Markdown 语法无序用*、-或有序用1.、2.绝不使用特殊字符或 emoji 充当项目符号正确组织嵌套列表。Emoji 方面的判据有节制、有思考地使用 emoji记住屏幕阅读器会完整朗读 emoji 名称例如 “face with stuck-out tongue and squinting eyes”避免连续使用多个 emoji部分浏览器/设备并不支持所有 emoji 变体。配套规则进一步补充连续多个 emoji 对屏幕阅读器用户是灾难每个名称都会被完整读出用 emoji 传达的文字中没有体现的含义也是违规行为。四、双轨工作流哪些可以直接改哪些必须等人批准这是本 Agent 设计上最值得借鉴的地方——它没有把所有改动权都交给模型而是按“修改风险”把问题分成两类需要人工审批的两类问题ALT 文本问题涉及对图片视觉内容和语境的判断平实语言问题涉及受众、语境和语气的判断。处理方式都是标记具体位置和细节 → 给出明确改进建议 → 等待人工审阅批准 → 解释该改动为何能提升无障碍。可直接改进的三类问题链接、标题、列表先用 Linter 结果定位结构问题再结合无障碍语境判断正确解法直接用编辑工具修改。完整工作流如下阅读文件理解其内容与结构运行 markdownlint识别结构问题命令见下节并审阅其输出标题层级、空行、裸 URL 等综合 Linter 发现按五大原则识别全部无障碍问题对 alt 文本与平实语言问题标记 建议 等待批准对链接、标题、列表问题直接改进每批改动或建议完成后给出详细解释包括改了什么/标记了什么关键改动展示 before/after、对应哪条原则、如何改善哪些用户的体验。五、markdownlint 自动化集成机器抓结构人类判语义Agent 的杀手锏是把markdownlint作为无障碍评估的“第一道雷达”用命令npx --yes markdownlint-cli2 filepath直接跑在当前文件上--yes自动确认安装无需先全局安装 markdownlint-cli2。Linter 能抓到的结构问题规则问题示例MD001标题层级跳级h1 直接跳 h4MD022标题周围缺少空行标题紧贴正文MD034裸 URL 未格式化为链接正文中直接粘贴网址Linter 抓不到、必须由无障碍专业判断解决的问题标题层级是否符合内容逻辑链接是否有描述性、是否有意义alt 文本是否充分描述图片emoji 是否被当作项目符号或过度装饰性使用平实语言与可读性问题。两者结合的正确姿势先通读文档理解内容运行npx --yes markdownlint-cli2 filepath抓结构问题用 Linter 结果支撑无障碍评估用无障碍专业知识判断正确解法。关键点在于Linter 只报“事实”不报“语义”。例如 Linter 报告 h1 → h4 跳级但该改成 h2 还是 h3必须结合内容层级由 Agent 判断——这正是 agents/markdown-accessibility-assistant.agent.md 第 186-206 行所描述的协作分工。值得注意本仓库自身的文档维护也在践行这一思路README 与多个 Agent 文件都在用!-- markdownlint-disable --/!-- markdownlint-restore --注释按需关闭规则见 README.md 附近说明 markdownlint 已被用作仓库级质量门禁的一部分。六、工具使用模式与本地操作Agent 明确了三类工具使用习惯这既是给模型的行为约束也是给使用者的操作指南Linting读完文档后先运行markdownlint-cli2支撑评估本地编辑同一文件的多处修改使用multi_replace_string_in_file批量完成减少编辑次数与出错风险大文件先分段策略性阅读以理解上下文再动手修改。对使用者来说这意味着你只需要在 VS Code Chat 中唤出 “Markdown Accessibility Assistant”指定一个 Markdown 文件路径Agent 就会自动完成“读 → lint → 评估 → 改/标记 → 汇报”的全流程无需手写任何复杂提示词。Agent 的安装方式与仓库其他自定义 Agent 一致参考 docs/README.agents.md 的说明下载*.agent.md文件加入仓库即可在 VS Code Chat 界面中使用。七、汇报与解释每处改动都要讲清“为什么”Agent 的汇报模板是本文最值得直接复用的实战素材。汇报自身也必须遵循无障碍最佳实践使用规范标题层级从 h2 开始、逻辑递增、描述性标题、用列表组织内容、不用 emoji 传达含义、用平实语言写作。## Accessibility Improvements Made ### Descriptive Links Made 3 changes to improve link context: **Line 15:** Changed click here to view the installation guide **Why:** Screen reader users navigating by links will now hear the destination context instead of the generic click here, making navigation more efficient. **Lines 28-29:** Updated multiple README links to have unique descriptions **Why:** When screen readers list all links, having multiple identical link texts creates confusion about which README each refers to. ### Impact Summary These changes make the documentation more navigable for screen reader users, clearer for people using translation tools, and easier to scan for visual users with cognitive disabilities.【免费下载链接】awesome-copilotCommunity-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot.项目地址: https://gitcode.com/GitHub_Trending/aw/awesome-copilot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考