SuperAPI AI 工具集

repair-broken-references

通用与其它

查看项目

更新于 10-16 08:06

技能介绍

用途:当项目引用逐渐过期时使用,例如文档中的内部链接失效、外部 URL 返回 404、导入语句指向已移动或删除的模块、文件间交叉引用不同步,或存在从未被引用的文件。不适用于重构模块依赖或重新设计信息架构,本技能只修复现有引用。

主要能力:扫描损坏的内部 Markdown 链接;检查外部 URL 是否可访问;检查 JavaScript/TypeScript、Python、R 的导入或 package 引用是否指向存在的模块;识别长期未被引用的孤立文件;按三种策略修复内部链接(找到移动后的文件、创建重定向占位、删除死链);修复失效导入;记录孤立文件处置建议;生成 REFERENCE_REPAIR_REPORT.md 修复报告。

输入参数:project_path(必填,项目根绝对路径)、check_external(可选,默认 true,检查外链较慢)、fix_mode(可选,auto/report/interactive)、orphan_threshold(可选,默认 180 天)。

使用方式:按步骤使用命令行扫描链接、外链、导入和孤立文件,再结合编辑工具更新引用。示例命令包括 find . -name ".md" -type f、grep -oP '[.?](\K[^)]+' *.md、curl -o /dev/null -s -w "%{http_code}",以及针对 JS/TS、Python、R 的 grep/sed 检查。R 环境可用 which Rscript && Rscript --version 确认原生二进制。

适用场景:文档维护、重构后引用清理、仓库健康检查、发布前链接审计。

限制与注意:部分外链对 curl 返回 403 但浏览器可访问,需人工复核;孤立文件可能是入口脚本或模板,不应直接删除;循环引用需同时修复;片段标识符需检查锚点是否存在;自动 URL 替换可能破坏原意。资料未提供具体收费、平台兼容范围或效果数据。