用途:为智能体提供纪律化的 CI/CD 交互模式,让流水线产生的信号被正确接收、分类与处理,防止在未弄清上次失败原因前反复推送,使流水线沦为噪声。
主要能力: 推送并等待:同一时间只允许一个待处理 CI 运行;推送提交后轮询等待运行完成,读取完整结果后才可再次推送;不得在上次运行待处理时推送“修复”,不得假设会通过而推送后续提交,也不得为推送新提交而取消运行(除非运行明显过期)。 失败分类:任何修复前先分类,依据完整日志而非状态推断。五类为 test-failure(测试断言失败,走调试协议)、lint-failure(格式或 lint 错误,自动修复后重新推送)、build-failure(编译或依赖错误,检查锁文件与构建配置)、flaky-test(无代码改动重试即通过,标记跟踪)、infra-failure(网络、运行器或服务错误,最多重试 2 次后升级)。 自愈:lint/格式失败运行自动修复并提交重推,仅一次;infra 失败最多重试 2 次;测试失败绝不自动重试;构建失败不盲目重试。 不稳定测试检测:记录名称、文件与失败输出,写入项目记忆(启用 factory 模式时为 .factory/audit-trail/flaky-tests.json,否则为项目笔记),并向用户报告;在不稳定解决前,重试通过不算真实通过。 结构化输出:每次交互生成 CI_RESULT 证据包,含 run_id、status、duration、failure_type、failure_details、fixes_applied、retry_count,即使通过也要生成,供流水线编排与审计使用。
使用方式与限制:可独立用于任何有 CI/CD 流水线的项目。流水线模式下为门禁,通过与否机械门控合并;独立模式为建议性,由智能体自我约束。硬约束包括推送等待与不稳定测试通过不计为真实通过。依赖 debugging-protocol、tdd、pipeline;缺少依赖可用 npx skills add jwilger/agent-skills --skill debugging-protocol 安装。分类须在修复前完成,不能倒推;非代码改动导致的重试通过应视为环境依赖测试而非不稳定。
适用场景:需要可靠 CI 信号的开发流程、多智能体协作与质量门禁。具体收费、价格与平台支持暂未提供。