用途：校验 agent、skill、prompt、instruction 等 AI 编程助手自定义文件是否符合正确的格式与结构，适用于提交新文件前、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。
主要检查：agent 需有 YAML frontmatter 与 --- 分隔符、非空 name、description（建议 50 字符以上并含示例）、正文内容，子 agent 需 user-invokable: false 且命名规范；skill 的 name 必须与父目录名一致、小写连字符、description 1–1024 字符；prompt 需 .prompt.md 扩展名、mode 取值合法、变量用 {{variableName}}；instruction 需 .instructions.md 扩展名与 applyTo glob 模式。
输出格式为按文件列出类型、状态（有效/警告/无效）、问题与建议；批量校验时给出按类型统计的汇总表及需关注文件列表。
限制：资料未提供安装命令、收费方式、平台支持范围或实际效果说明。