用途:当需要让整套集成测试通过、修复红掉的测试套件、反复循环直到集成测试全绿,或诊断不稳定的集成测试时使用。它针对的是已存在的测试套件;若要依据规格编写新测试,应改用 $workflow-write-integration-test。
主要能力:默认把验证范围定为整个系统(通过 testProjectPattern > testProjects 解析全部集成测试项目),也可按提示中指定的套件、模块或功能收窄。核心是收敛循环:验证 → 诊断 → 修复 → 复核 → 重新验证,直到连续两次完整运行零失败且未做数据库重置。每个失败在修改前必须形成一份书面 Fault Verdict,类别包括 TEST-WRONG、TEST-NOT-OPTIMAL、SOURCE-WRONG、ENVIRONMENT-BLOCKED、AMBIGUOUS,并附 file:line 证据。修复须落在最低的所有权层(Entity > Service > Handler),而非崩溃点。每轮落地的修复都要跑一次内联的 $changes-review(仅报告),并在同一轮解决其已验证的问题。
使用方式:运行 $start-workflow workflow-integration-test-green,并按顺序执行 $scout → $integration-test-verify-loop → $debug-investigate[失败时] → $fix[失败时] → $spec[mode=sync] → $scan --target=integration-tests → $docs-update → $workflow-end → $watzup。开始前须先建立完整任务列表,设置 Goal Contract 与轮次上限(默认 3),记录范围字符串和基线通过/跳过计数;每轮后把各项目计数、Fault Verdict 和修复追加到迭代日志。
限制:不得通过削弱断言、加跳过标记、放宽超时、包裹重试或收窄范围来强行变绿;执行测试数减少、跳过数增加或范围收窄都视为回归并要停止升级。所有通过/失败结论须有真实测试运行器输出支撑。$integration-test-verify-loop 及其驱动的技能须内联运行,不得作为子代理。若所需步骤或工具在当前环境无法运行,应先停下询问用户。文档同步属于完成条件的一部分。具体命令、项目配置路径与测试命令细节请以仓库实际文档为准,本资料未逐项提供。