SuperAPI AI 工具集

ecosystem-integrity-scanner

智能体与模型

查看项目

更新于 10-16 09:47

技能介绍

用途:对 Agent Studio 框架做结构性完整性扫描,把框架结构问题当作上线前缺陷处理,捕获运行时才会暴露的隐藏错误。

主要能力:通过 node scripts/validation/validate-ecosystem-integrity.cjs 执行六类检查——[PHANTOM_REQUIRE] 解析不存在的 require()/import 路径;[PHANTOM_SKILL] 智能体 frontmatter 中列出但磁盘无对应目录的技能;[EMPTY_DIR] .claude/tools/ 或 .claude/skills/ 下的空目录;[ENCODING] 带 UTF-16 BOM 导致解析器静默失败的文件;[ARCHIVED_REF] 生产代码仍引用 _archive/ 或 .claude/archive/;[STALE_CATALOG] agent-registry.json 条目数与实际智能体 .md 文件数不一致。

使用方式:在项目根目录运行扫描,脚本按 process.cwd() 解析路径,切勿在子目录调用。批量创建或归档技能、智能体、钩子后,重构模块路径或目录结构后,执行大规模审计或清理后,怀疑存在幻影引用或 require() 链断裂时,以及在任何 CI 检查门禁定稿前主动触发。建议先调用 task-management-protocol、ripgrep、code-semantic-search、context-compressor、verification-before-completion、memory-search 等配套技能,并将分类结果写入 .claude/context/reports/qa/ecosystem-integrity-report-{ISO-date}.md,按 HIGH、MEDIUM、LOW 分级;HIGH 错误应分别交由 developer 或 qa 智能体修复,修复后重新扫描直至错误为零。

限制:错误未清零前不得标记扫描完成,警告仅为提示;不得忽略 PHANTOM_REQUIRE 错误;不要对 _archive/ 子树运行扫描以免误报;未经审查不要向 DYNAMIC_SCRIPT_GENERATORS 添加条目。资料未提供安装命令、收费、价格与平台支持信息。