用途:ccw-loop 是一个无状态迭代开发循环技能,使用 Codex 单智能体深度交互模式,由同一智能体处理开发、调试、验证到完成的全部阶段,并通过文件保存状态,支持与 Dashboard 集成。
主要能力:支持 INIT、DEVELOP、DEBUG、VALIDATE、COMPLETE、MENU 等动作;提供交互模式和自动循环两种执行模式;使用 {projectRoot}/.workflow/.loop/{loopId}.json 作为主状态文件,并在 .progress/ 目录下生成进度、日志、假设、测试结果、覆盖率与总结等文件;支持暂停、停止、恢复与断点继续;主状态损坏时可根据进度文件和日志重建。
使用方式:直接调用 /ccw-loop TASK="Implement user authentication";自动循环 /ccw-loop --auto TASK="Fix login bug and add tests";继续已有循环 /ccw-loop --loop-id=loop-v2-20260122-abc123;API 触发自动循环 /ccw-loop --loop-id=loop-v2-20260122-abc123 --auto。参数 TASK 与 --loop-id 至少提供其一,--auto 可选。
协作规则:智能体每次动作输出 ACTION_RESULT、FILES_UPDATED 和 NEXT_ACTION_NEEDED;编排方通过 send_input 继续执行;整个循环只使用单个智能体,退出前需确认不再交互再关闭。
适用场景:需要在单智能体下按阶段推进编码、调试和验证,并希望用文件记录进度、可恢复执行的开发任务。
限制:资料未提供收费、平台兼容性、性能或效果保证;状态文件结构、动作语义与恢复逻辑较复杂,实际可用性取决于运行环境;最大迭代次数等由状态文件配置,资料未说明默认值以外的细节。