markdown-link-check 链接预检

要解决的具体问题

文档合入、README 更新或内容发布前，链接通常散落在仓库说明、docs/ 目录和草稿里。人工点开几条链接很容易漏掉失效引用；一旦发布，用户就会遇到 404、跳转错误或指向旧版本的页面。这个技能把发布前检查变成一次可重复的预检：用 markdown-link-check 处理 Markdown 文件或目标地址，先发现死链，再修复问题。

核心能力与关键步骤

• 输入范围：README、文档文件夹、内容草稿，以及需要校验的 Markdown 文件或 URL。
• 运行前提：准备 Node.js、markdown-link-check 包或容器镜像，并允许链接校验所需的网络访问。
• 校验方式：解析 Markdown 中的链接目标，逐个完成可达性检查；失效或无法访问的引用会出现在结果中，方便开发者先修复再发布。
• 关键步骤：在 CI 或发布脚本里接入该检查；保留可复现的输出；把报告当作发布门禁，而不是等用户报错。

适用边界与注意点

• 它适合发布前、合入前或文档站点构建前的链接门禁，不适合替代人工撰写与内容审校。
• 外部站点限流、内网地址、权限受限资源或临时网络抖动都可能导致校验失败，需要区分“链接确实失效”和“暂时不可访问”。
• 校验结果只覆盖链接可达性；文案、样式、SEO、图片压缩和站点性能仍需要其他流程。
• 上游说明来自 tcort/markdown-link-check 的 README，技能仓库见 https://github.com/1991513ccie-png/skills。