SuperAPI AI 工具集

skill-graph-audit

通用与其它

查看项目

更新于 10-15 17:20

技能介绍

用途:构建 marketplace 中 Skill(plugin:name) 调用的有向图,揭示技能组合模式,包括高被引的枢纽(hubs)、调用大量其他技能的编排者(orchestrators)、零入零出的孤立技能(isolates),以及指向不存在技能的悬空引用(dangling references)。联邦图由此可从源码推导,无需手工维护。

主要能力:输出枢纽、编排者、孤立、悬空 bugs、悬空 external、悬空 placeholders 等分类;以表格形式给出含义与处理建议。支持文本或机器可读 JSON 输出,并可限制 top-n。

使用方式:先跑正向对照测试,再运行脚本。示例命令:uv run pytest -o addopts= -q plugins/abstract/tests/scripts/test_skill_graph.py -k Planted;python3 plugins/abstract/scripts/skill_graph.py --plugins-root plugins --top-n 10;机器可读输出:python3 plugins/abstract/scripts/skill_graph.py --plugins-root plugins --format json --output reports/skill-graph.json。完整 CLI 参考见 modules/usage.md。

验证:可运行 pytest -o addopts= plugins/abstract/tests/scripts/test_skill_graph.py 检查提取、构图、排序、孤立检测与悬空分类;做往返冒烟检查,修复若干引用后重跑,确认悬空计数至少下降修复数量。

适用场景:文档整理前、重命名或退役后检查失效引用、季度审计发现孤儿技能、评估合并候选、检查新技能外发引用。

限制与边界:不适用于单技能质量评分(用 Skill(abstract:skills-eval))、frontmatter/结构校验(用 Skill(abstract:plugin-review))、hook 专项审计(用 Skill(abstract:hooks-eval))。资料未提供其他平台支持或收费信息。