用途:确保智能体定义在技术上可靠、符合项目规范,并与当前环境及其他智能体兼容。
适用时机:新建智能体后;修改已有智能体 frontmatter(模型、工具、handoff)后;排查“死胡同”交接或工具执行失败时。
工作流:
- 运行自动校验脚本 ./scripts/validate-agents.py,检查模型是否存在于 docs/ai-model-reference.md、交接目标是否存在、必需章节是否齐全,并对疑似非法的工具名(Snake Case)发出警告。
- 手动校验工具存在性:以工作区可用工具为准,逐一核对智能体 tools: 数组中的每个工具是否存在;若使用通配符(如 github/*),确认自己拥有该前缀的工具;工具 ID 须大小写完全匹配,VS Code 工具通常采用 category/toolName 或 publisher.extension/toolName 格式。
- 校验边界一致性:检查 ✅ Always Do、⚠️ Ask First、🚫 Never Do 是否具体(使用明确命令与文件路径)、可执行(工具确实能完成 Always Do 动作)、且不与 .github/copilot-instructions.md 中的项目级指令冲突。
- 检查交接逻辑:handoffs: 的提示是否为下一智能体提供足够上下文;如需用户确认后再继续,是否使用 send: false(本项目标准做法)。
输出:校验结果摘要、已识别问题的修复、以及智能体可用的确认。
限制:资料未说明具体支持的平台版本、依赖安装方式、错误码明细或与其它校验工具的集成方式,这些暂未提供。