用途:Agent Tests 用于编写和运行端到端测试,让智能体或人工通过真实 CLI 调用验证工作流,观察真实结果并断言预期状态,全程不使用 mock。
主要能力:测试以目录为单位自包含,位于 .agents/tests/<test-name>/,其中 TEST.md 为必需且是事实来源,test-*.sh 为可选可执行脚本,fixtures/ 为可选测试数据。TEST.md 包含 Context(验证内容与原因)、Workflow(带真实命令的步骤)、Assertions(检查项、检查内容与验证命令)、Commands(可选运行完整测试的脚本或内联命令)、Cleanup(如何撤销副作用,支持 --no-cleanup 标志以便检查)。
使用方式:按上述结构创建测试目录并编写 TEST.md;需要自动化时添加脚本;运行真实工具命令(如 gh、kubectl、curl 等);对异步流程使用带超时的轮询;脚本化时打印逐步进度;测试可接受参数(目标仓库、环境、标志)。
适用场景:需要以真实命令验证工作流、希望测试可被智能体直接执行、或需要可检查副作用的端到端验证时。
限制:资料未提供具体安装命令、依赖版本、支持平台、收费与价格信息;测试依赖真实工具与环境,副作用需自行清理或使用 --no-cleanup 保留现场。