SuperAPI AI 工具集

skill-manifest-generator

智能体与模型

查看项目

更新于 10-16 08:10

技能介绍

用途:为任意 Agent Skill 目录生成 MANIFEST.json,用于发布前检查、验证技能是否被修改、审计外部依赖以及校验结构合规。

主要能力:生成文件完整性哈希(SHA256,含整体 integrity hash);输出完整文件清单(含大小与类型);检测代码中引用外部资源的 URL;分析目录结构(文件夹深度、文件数量与组织方式)。生成的 MANIFEST.json 位于技能根目录,字段包括 $schema、manifestVersion、generatedAt、generator、skill、integrity、files、externalReferences、structure。

使用方式:对技能目录运行清单生成器,例如“为 /path/to/my-skill 生成清单”,或校验已有清单“校验 /path/to/my-skill 的清单”。生成会运行 generate_manifest.py,校验则运行 generate_manifest.py --verify,输出各文件哈希匹配、是否存在未跟踪新文件以及整体哈希校验结果。

适用场景:把技能发布到目录之前;确认技能未被改动;审计技能中的外部依赖;验证技能结构与规范。

限制:二进制文件会被哈希但不会扫描其中的 URL;URL 检测基于正则,注释中可能出现误报;技能总量上限 50MB、单文件 10MB;文件数上限 1000;目录深度上限 6 层。依赖 Python 3.9+ 与 PyYAML(用于解析 SKILL.md frontmatter),其余仅用 Python 标准库。