SuperAPI AI 工具集

validate-agent-files

智能体与模型

查看项目

更新于 10-15 22:41

技能介绍

用途:校验 agent、skill、prompt、instruction 文件是否符合正确格式与结构,适用于提交前检查、agent 行为异常排查、审计现有自定义文件,以及修改 .github 等配置后验证。

提供方基础目录:GitHub Copilot 为 .github/,Claude Code 为 .claude/,Codex 为 .codex/,OpenCode 为 .config/opencode/。

校验流程:先按位置与扩展名识别文件类型,再套用对应规则。agent 文件位于 <provider>/agents/.md,子 agent 为 .subagent.agent.md;skill 为 <provider>/skills//SKILL.md;prompt 为 <provider>/prompts/.prompt.md;instruction 为 <provider>/instructions/*.instructions.md。

主要能力:检查 YAML frontmatter 与 --- 分隔符、必填字段(如 agent 的 name/description、skill 的 name/description、instruction 的 applyTo)、命名规范(skill 名须与父目录一致、小写连字符)、描述长度与触发词、变量语法 {{variableName}}、mode 取值、glob 模式有效性,以及子 agent 是否设置 user-invokable: false。

输出:按文件给出类型、状态(有效/警告/无效)、问题与建议;批量校验时输出汇总表并列出需关注文件。

限制:资料未提供安装命令、价格、平台支持范围或实际效果说明。