SuperAPI AI 工具集

link-validation

通用与其它

查看项目

更新于 10-15 23:57

技能介绍

用途:在 Claude Code 会话中校验工作区 Markdown 链接,检测失效链接和路径策略违规,适合提交文档前检查链接、排查断链。

主要能力:发现工作区内所有 Markdown 文件;调用 lychee 检查失效链接;对路径做策略检查(NO_ABSOLUTE_PATHS 为错误级,禁止文件系统绝对路径;NO_PARENT_ESCAPES 为警告级,过多 ../ 可能逃出仓库;MARKETPLACE_RELATIVE 为警告级,插件应使用 ./ 相对路径);结果以 JSON 输出供程序消费,并写入工作区 .link-check-results.md,含 Correlation ID、Lychee 校验结果与路径违规结果。

使用方式:需先安装 lychee(brew install lychee),并具备 Python 3.11+ 与 uv。可在工作区根目录放置 .lycheerc.toml 覆盖默认 lychee 配置,默认配置见 config/lychee.toml。建议从仓库根目录运行以避免相对路径基准错误。

限制与排错:lychee 未安装时运行 mise install lychee;403 过多可加限速;误报可加排除规则;超时可增大配置超时;缓存问题可用 --no-cache。该技能为自演进型,仅在问题真实可复现时更新自身说明。具体安装与调用命令、完整参数表暂未提供。