任务类型

开发

任务目标（What）

构建链接看护 skill：lychee 双模式——仓内链接离线检查进 PR 门禁（确定性 bug 当次拦截），外链在线检查进周常扫描（出报告自动建单、不阻塞 PR）；markdownlint + codespell pre-commit 加固。

背景与上下文（Why）

链接可达性直接影响文档的可读性与专业度，而链接又是文档中最易碎的部分——文件移动、版本升级、外部站点变化都会让链接悄悄失效，且这类问题发现即修、闭环最快，是投入产出比最高的一类看护。关键设计约束：外链会因网络/对方站抖动产生假阳性，为保证门禁信号始终可信，必须按链接类型拆分策略。

详细步骤（How）

1. 全量摸底（首跑驱动）：lychee 全仓跑一遍 → 修复全部失效链接 → 确属正常失败的外链入
   白名单留档。
2. 仓内链接门禁：lychee --offline 纯本地检查相对路径/文件链接，每次 PR 跑，必须绿。
3. 外链周常：lychee 在线模式 + 缓存 + 重试 + 白名单（24h 复核），周常扫描出报告并自动建 issue。
4. pre-commit 加固：markdownlint（格式 + 裸 URL 检查）、codespell（拼写），加入 .pre-commit-config.yaml。
5. 验收标准：PR 引入指向不存在资源的链接被当次拦截；外链失效一周内被周常扫描发现并自动建单；
   全仓链接检查通过、白名单留档可查。