CCW Loop 是一个无状态迭代开发循环工作流,面向开发任务的持续推进与记录。它把流程划分为 develop(开发)、debug(调试)、validate(验证)三个阶段,每个阶段都有独立文件记录进展。参数包括:task(任务描述,新建循环,与 --loop-id 互斥)、--loop-id(继续已有循环,值来自 API 或上次会话)、--auto(自动循环,依次 develop → debug → validate → complete)。
主要能力:统一状态由 API 与 Skill 共享 .loop/{loopId}.json,任务列表写入 .loop/{loopId}.tasks.jsonl,进度写入 .loop/{loopId}.progress/ 下的 develop.md、debug.md、validate.md、changes.log、debug.log。Skill 在每个动作前检查 status 字段,paused 时优雅退出,failed 时终止,running 时继续。动作目录包括 action-init、action-develop-with-file、action-debug-with-file、action-validate-with-file、action-complete、action-menu,分别产出 meta.json/state.json、progress.md/tasks.json、understanding.md/hypotheses.json、validation.md/test-results.json、summary.md 等。
使用方式:可用 /ccw-loop "任务描述" 启动新循环,用 /ccw-loop --loop-id loop-v2-... 继续或由 API 触发,用 /ccw-loop --auto "任务" 进入自动循环。CLI 集成调用示例:ccw cli -p "..." --tool gemini --mode write/analysis --rule 相应规则。
适用场景:需要按阶段推进并留痕的开发、调试与验证任务,以及由 CCW Dashboard 的 Loop Monitor 通过 HTTP 接口创建、启动、暂停、恢复、停止循环的控制平面/执行平面协作场景。
限制:循环 ID 直接调用时生成 loop-v2-{timestamp}-{random};超过约 10 次迭代会提示用户并建议中断;会话不存在时新建,状态文件损坏时按文件内容重建,CLI 工具失败时回退手动分析,测试失败时回退到 develop/debug;完成后会询问是否扩展为 issue。其他未提供细节暂未提供。