agent-check 用于校验自定义智能体文件的格式与结构是否正确。
校验目标：带参数时校验指定文件；不带参数时校验 .claude/agents/*.md 全部文件。
所需 frontmatter 字段包括：name（必填，小写、连字符，3-50 字符）、description（必填，10-5000 字符，建议 200-1000 并含 <example> 块）、color（必填，可选 yellow、red、green、blue、magenta、cyan）、model（必填，可选 inherit、haiku、sonnet、opus、best、sonnet[1m]、opus[1m]、opusplan）。
可选字段包括：tools（YAML 列表，省略即全部工具可用）、skills、forkContext（字符串 "true"/"false"）、maxTurns（正整数）、memory（user/project/local 数组）、mcpServers、hooks、permissionMode、disallowedTools。
有效工具名：Read、Write、Edit、Bash、Grep、Glob、Task、WebFetch、WebSearch、TodoWrite、NotebookEdit。
内容结构建议包含 # Agent Name 标题、## Activation 小节、流程描述与输出格式定义。格式规则要求 tools 使用 YAML 列表（非 [Read, Write] 括号数组）、无重复工具、工具名均有效。
输出为 Agent Validation Report，含 Files Checked（文件/状态/问题）与 Summary（总数/有效/需修复）。自动修复可把括号数组转 YAML 列表、把字符串 skills 转 YAML 数组、补齐 color（默认 cyan）与 model（默认 inherit）、把布尔 forkContext 转字符串、把标量 memory 转数组、移除无效工具并补充推荐小节。
限制：资料未提供安装命令、收费与运行环境等信息。