SuperAPI AI 工具集

link-validator

通用与其它

查看项目

更新于 10-16 00:20

技能介绍

Link Validator 用于校验 Claude Code 技能中 Markdown 链接的可移植性,重点解决技能使用绝对仓库路径(如 /skills/foo/SKILL.md)安装到其他位置后失效的问题。

用途:在分发技能或插件前、创建新的 Markdown 链接后、CI 报链接校验失败时,或审计现有技能的可移植性时使用。

主要能力:检查技能内的 Markdown 链接。绝对仓库路径(如 /skills/foo/SKILL.md、/docs/guide.md)被标记为违规;相对同目录路径(./references/guide.md)、相对父级路径(../sibling/SKILL.md)、外部 URL(https://example.com)和锚点(#section)视为通过。

使用方式:通过脚本运行校验。示例命令:uv run scripts/validate_links.py ~/.claude/skills/my-skill/(单个技能);uv run scripts/validate_links.py ~/.claude/plugins/my-plugin/(含多个技能的插件);uv run scripts/validate_links.py .(当前目录试运行)。退出码:0 表示全部为有效相对路径;1 表示发现绝对仓库路径违规;2 表示路径无效或无 Markdown 文件。流程上先运行校验、查看违规报告,再按建议修改为相对路径并重新校验。

适用场景:单个技能或整个插件的链接审计与批量修复。

限制:资料未提供安装方法、具体依赖版本与更多配置选项;无法自动修复复杂路径结构,需参考 link-patterns.md 制定修复策略;URL 误报时以 http 开头的链接应被忽略,锚点链接按设计允许;若本地通过但 CI 失败,需确保 CI 从正确仓库根目录运行。