用途:project-test-loop 用于驱动 RED→GREEN→REFACTOR 的 TDD 循环,直到测试全部通过。当你在反复处理失败测试、需要自动“修复并重试”,或想用 --max-cycles 限定 TDD 迭代次数时适用;若瓶颈不在测试,可改用 project-continue;若测试命令未知,可改用 project-discovery。
主要能力与机制:每轮迭代先运行确定性驱动脚本完成机械工作,然后根据其输出的 VERDICT 决定下一步。驱动脚本可从项目标记自动检测测试命令:package.json 的 test 脚本、pytest/pyproject.toml、cargo test、go test,或 Makefile 的 test: 目标。
VERDICT 分支:GREEN 表示测试命令退出 0、测试通过,进入重构后停止;CONTINUE 表示测试失败且未达上限,需做最小修复后重跑;STUCK 表示同一失败签名连续 3 轮出现、无进展,应停止并请求输入;CAP_REACHED 表示达到 --max-cycles,应停止并报告剩余失败;SETUP_ERROR 表示未检测到或无法运行测试命令,应停止并询问如何运行测试,或用 --test-cmd 覆盖。
参数与用法:支持可选位置参数 test-pattern,传递给检测到的测试命令以聚焦运行;--max-cycles <N>(默认 10)作为上限;可用 --test-cmd "<command>" 覆盖自动检测。常用命令示例:bash "${CLAUDE_SKILL_DIR}/scripts/run-test-cycle.sh" --max-cycles 10;加 --pattern "$0" 聚焦;加 --test-cmd "pytest -x -q" 覆盖;加 --reset 重置循环状态;用 grep -E '^VERDICT=' 读取裁决。
限制与完整性:修复应为满足失败测试的最小改动,不要通过修改测试使其通过,否则独立裁判会变成自评循环;停止条件包括成功(GREEN 且无可重构)、STUCK、CAP_REACHED、SETUP_ERROR 或修复不明确需用户输入。资料未提供安装方式、收费与平台信息。