SuperAPI AI 工具集

code-testing

编程与开发

查看项目

更新于 10-20 03:14

技能介绍

用途

该技能是代码测试工作的隐式入口,专门处理需要修改测试的请求:为现有代码编写、添加、生成、修复或增强测试,覆盖 xUnit、MSTest、NUnit、pytest 等测试框架。它不用于运行或执行现有测试、跨框架迁移、仅回答 MSTest API/模式问题,或仅分析失败测试而不要求修改代码的场景。

主要能力

  • 根据用户请求分类意图(生成/扩展、修复、审计后修复)和范围(聚焦或广泛)。
  • 对广泛范围请求执行 Research → Plan → Implement 流水线,协调多个专用智能体(研究者、规划者、实现者、构建器、测试器、修复器、代码检查器)。
  • 对聚焦范围请求直接内联处理,不创建中间状态文件,不派发子智能体。
  • 生成符合项目约定的测试文件,确保测试能编译并通过。
  • 修复测试错误,区分测试缺陷与生产行为缺陷,进行最小授权修复。
  • 审计测试质量并修复差距,在可用时调用 test-gap-analysis 和 assertion-quality。
  • 支持 MSTest 套件生成或扩展(在确定范围和项目约定后加载 writing-mstest-tests 作为辅助指导)。

使用方式

  1. 确定用户请求的意图和范围。若用户未指定测试风格、覆盖目标或约定,则从 unit-test-generation.prompt.md 获取指南。
  2. 在调用任何智能体前评估请求规模:聚焦范围(单一函数、类、文件或缺失方法)直接内联处理;广泛范围(项目、包、多模块)执行完整流水线。
  3. 广泛范围时,先调用名为 test-engineer 的自定义智能体(非通用子智能体),由其作为流水线唯一所有者。若不可用,则内联执行相同流程。
  4. 在创建中间状态文件前,解析一个绝对路径 <TESTAGENT_DIR>,确保其不可被版本控制、不出现在 git status 中、不可暂存。
  5. 执行时保持有界上下文:仅研究请求的模块或项目,复用清单、符号引用和确定性配对工具,按阶段顺序实现,每个清单项映射到至少一个具体测试或明确阻塞原因。
  6. 完成后满足完成契约:广泛范围需有 research.md、plan.md 及最终响应中的需求-证据矩阵和精确测试名称;所有范围需测试编译通过、每个显式需求有具体测试和断言、最终交接引用成功命令和测试名称。

适用场景

  • 为整个项目或特定文件生成单元测试。
  • 提高现有代码库的测试覆盖率。
  • 创建遵循项目约定的测试文件。
  • 编写能实际编译并通过的测试。
  • 为新功能或未测试代码添加测试。
  • 生成或扩展 MSTest 套件。
  • 修复测试缺陷或增强测试断言。

限制

  • 不用于运行或执行现有测试(应使用 run-tests 技能)。
  • 不用于测试框架或平台之间的迁移;若仓库未安装迁移工作流,应报告而非委托给已移除的技能。
  • 不用于仅回答 MSTest API/模式或现代化问题而不要求生成测试的场景。
  • 不用于仅分析失败测试而不要求修改代码或测试的场景。
  • 仅使用当前运行时可用能力;不通过别名重试缺失技能,不用其他智能体重试策略拒绝的操作。若临时存储被拒绝,保留研究计划在上下文中,继续允许的测试编辑并报告缺失状态工件;若执行被拒绝,继续允许的静态审查并报告测试未运行,绝不报告为通过。