write-testing 用于把测试本身当作交付物的测试编写任务,适合需要补齐或强化测试覆盖、并希望避免“形式化绿灯测试”的场景。
用途与主要能力:围绕行为而非行覆盖率识别覆盖缺口,先说明哪个模块、哪种行为、调用方依赖什么条件,再写测试。测试应通过公共接口断言调用方可观察的结果,不触碰私有方法或模块私有状态。每个测试只保留一个失败原因,命名与断言信息需指出被破坏的行为。对高风险需求或不变量,建议使用属性测试、蜕变测试或变异测试增强检查并记录覆盖内容。
使用方式:编辑前打开 references/task-template.md 并实例化为运行笔记;将文件放到 ~/.agents/artifacts/<workspace>/ 下,保持仓库外存放并携带绝对路径。工作区名称或目标路径冲突时停下请求人工选择,不得覆盖。根目录不可写时提供授权重试、改用其他代理中立的用户目录或取消。命令从 AGENTS.md 解析;未定义时询问。完成前运行整个测试套件并粘贴真实输出。
限制与约束:不修改生产代码来方便写测试,除非任务范围允许;测试暴露的缺陷记录为发现项,不就地修复。测试必须确定,避免顺序依赖、时序假设、共享可变状态、未沙箱网络或未播种随机。不得自行对自己的工作出具评审结论。并行运行时隔离到独立工作树或分支。已非确定失败的测试属于稳定化工作,不适用本指引。