Agent集成测试编写规范
分析 Agent 核心逻辑变更,按照项目测试规范规划用例,输出优先采用端到端集成测试的代码编写与单元测试隔离方案。
功能与用途
该规范针对开源 Agent 项目的代码修改场景,确立了优先集成测试而非单元测试的质量保障机制。规范要求所有涉及 Agent 交互逻辑与用户行为的改动必须在 `core/suite` 目录下通过 `test_codex` 编写集成测试,单测必须严格隔离在独立的 `*_tests.rs` 文件中且严禁污染主逻辑代码,同时推荐复用已有测试辅助方法提升用例可维护性。
适用场景
- Agent核心行为集成测试规划:在改动智能体交互逻辑或用户可见行为时,指引在测试套件目录下使用专用测试实例编写端到端集成用例。
- 单测隔离与主干代码防污染:规范单元测试编写位置至独立测试文件,禁止在核心业务实现中引入仅用于测试的侵入性代码并复用辅助函数。
适用人群
- Rust 后端工程师
- Agent 核心库代码贡献者
- 自动化测试架构师
使用步骤
- 整理本次 Agent 代码改动中影响到的核心逻辑与用户感知行为清单
- 检查 core/suite 目录下现有的测试辅助函数(Helper),确认是否有可复用的 setup 逻辑
- 使用 test_codex 初始化测试实例,编写覆盖核心链路的端到端集成测试
- 若存在纯内部计算逻辑,在独立的 *_tests.rs 文件中编写单元测试,移除主代码中的测试专用函数
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-09-23
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Test authoring guidance
依赖与权限
- 读取用户主动提供的内容