用途:agentic-tdd 把测试驱动开发提升到整应用层面,用于单元测试无法触及的行为,例如“点击 Deploy 会向 /api/deploy 发请求、把 store 切到 deploying 并显示横幅”。这类结果只有在应用真正运行时才存在。
主要能力:通过 Reticle 驱动真实应用,用 reticle_act_and_wait({ ref, action, until }) 把期望作为动作的参数,先声明后果再执行动作,使红-绿循环难以造假。断言按强度排序:应用自身发出的 signal 最强;其次是 state(reticle_look { action: "state" });再次是网络请求的方法与状态;元素出现是必要但不充分;控制台无错误应始终包含但不能单独依赖。
使用方式:先写期望并观察其失败(RED),verified 应为 "no";verified 为 "unknown" 不算红,需先修正。再写最小实现使同一调用通过(GREEN),不要修改断言。随后自由重构并重跑(REFACTOR)。可用 reticle_run 调用 reticle_flow_save 保存流程,再用 reticle_verify 的 flows 动作重跑全部已保存流程,形成回归套件。若判定为 unknown/unsettled,优先用 reticle_assert({ predicate, since, timeout_ms: 8000 }) 重新断言而非重新驱动。
限制与前提:未安装 Reticle 时需先执行 RETICLE_INSTALL_SOURCE=npx_skill npx @reticlehq/server@latest init,再使用安装并验证技能。不得为让结果变绿而削弱检查。谓词参考见 curl https://docs.reticle.sh/predicates.md,其他文档见 curl https://docs.reticle.sh/llms.txt。