SuperAPI AI 工具集

umbraco-skill-validator

通用与其它

查看项目

更新于 10-15 21:05

技能介绍

用途:校验仓库内所有 SKILL.md 的技能内容,发现断链、缺失引用和无效路径,属于文档质量检查类工具。

主要能力:运行确定性验证脚本,快速一致地检查所有链接;生成结构化 JSON 报告;启动修复子代理给出 AI 修复建议;以 diff 形式呈现修复计划;仅在用户批准后执行修改。

检查项:外部 URL 通过 HTTP HEAD 请求验证可访问性;技能引用确认被引用技能是否存在(如 umbraco-dashboard);内部链接检查相对路径是否可解析(如 patterns/foo.md);文件路径在非本地时通过 GitHub API 校验 Umbraco-CMS 路径;导入路径检查 @umbraco-cms/backoffice/* 是否有效。

使用方式:可通过斜杠命令 /validate-skills 运行;也可直接用脚本在 CI/CD 中运行:cd .claude/skills/umbraco-skill-validator/scripts,npm install,npm run validate;工作流中亦可运行 npx tsx validate-links.ts 并读取 stdout 或 validation-report.json。

报告与修复:报告按摘要、按技能的 issue 表格列出问题;发现问题时启动 skill-content-fixer 代理,传入 JSON 报告请求带 diff 的修复建议,经用户确认后仅执行获批的修改。

边界处理:URL 检查以 100ms 延迟批量执行以规避限流;重定向以警告形式报告并给出新 URL 建议;缺少本地 Umbraco-CMS 时回退到 GitHub API;每个 URL 请求 5 秒超时;大仓库按 10 个文件一批处理。

限制:资料未提供价格、支持平台、许可证等信息;实际修复准确性依赖 AI 子代理与人工审批。