SuperAPI AI 工具集

alterlab-link-health

通用与其它

查看项目

更新于 10-15 19:56

技能介绍

用途:面向文档密集的仓库,把失败的链接检查器(如 lychee、markdown-link-check)修到通过。资料称其源自一次真实审计,将 1966 条链接中的 1208 个错误降至 1912 条链接 0 错误,历时 8 次提交。

主要能力:四层流水线,每层为一个可审查提交,需按顺序执行。Tier 1 配置:引入 .lychee.toml 显式 accept 集合(会替换 lychee 默认值,需列出 200..=299)、.lycheeignore 与加固的 CI 工作流,通常可减少 70%–90% 错误。Tier 2 仓库内引用:修复 file:// 条目,如单复数目录拼写、缺失路径前缀、YAML frontmatter 问题,教学占位路径改为行内代码。Tier 3 URL 替换:用验证可用的替代地址替换 MOVED 外部 URL,替换 DEAD_INFRA 资源。Tier 4 排除:处理无法修复的机器人不友好主机、教学占位、过期上游基础设施与不稳定学术站点。

使用方式:提供三个可直接派发的 playbook。全新审计用 playbooks/full-audit.md(10 个并行子代理加综合);残余错误用 playbooks/followup-pass.md(3 个定向子代理);合并后清理用 playbooks/post-merge.md(4 个并行子代理)。触发关键词包括 link audit、dead links、lychee、broken links、404 audit、check-links failing 等。

关键规则:替换前必须验证,GitHub 仓库用 gh api repos/owner/name 确认状态 200 且未归档,HTTP 用 curl -sSI -L --max-time 15 '<new>' 确认重定向后为 200,包则查注册表 API;验证失败应通过 .lycheeignore 排除并注明原因,而非猜测替代。Tier 3 护栏:替换后重跑检查器并与基线成功集对比,基线中 200 而替换后非 200 即为回归,需回滚。

限制:仅修复链接健康,不校验被引作品是否存在(应使用 alterlab-citation-verifier),不统一 SKILL.md 模式,不重构内容或示例,不通过放宽 accept 列表掩盖真实断链。单文件单个断链直接编辑即可,无需流水线。具体安装命令与价格资料未提供。