journey-loop 是一个用于编排持续自我改进构建循环的技能,其目标是通过反复迭代,让 journey-builder 技能不断产出并优化用户旅程测试,同时借助 refine-journey 技能对每轮结果进行评估并改进构建技能本身。
用途 该技能充当自我改进构建循环的编排者。每一轮迭代包含两个顺序阶段:Builder 阶段运行 journey-builder 技能,构建并测试下一个用户旅程;Refiner 阶段运行 refine-journey 技能,评估输出并改进技能。编排者的职责是保持循环运行,读取两个阶段的输出,并决定何时重启、继续或停止。
主要能力
- 管理两个顺序阶段:Builder 与 Refiner。
- 维护共享状态文件,包括 journeys/*/、journey-refinement-log.md、SKILL.md 以及 journey-loop-state.md。
- 创建或恢复 journey-loop-state.md,记录规格路径、启动时间、当前迭代次数、状态以及迭代历史表格(包含迭代编号、构建的旅程、评分、SKILL.md 变更和决策)。
- 按循环协议执行:每轮迭代前重新读取根目录下的 SKILL.md;启动 Builder Agent,等待其完成(完成标志是出现新的旅程文件夹并包含 journey.md 和 review 文件);随后启动 Refiner Agent,等待其完成评估、写入评分到 journey-refinement-log.md 并编辑 SKILL.md;读取评分并提取 Score、Failures Found、Changes Made to SKILL.md;根据评分决定下一步行动;更新循环状态并递增迭代计数。
- 决策逻辑:若评分大于等于 95% 且规格中所有需求均有对应旅程,则停止;若评分较上一轮提升,则继续下一个旅程;若评分连续两轮未提升,仍继续下一个旅程但记录警告;若相同失败模式出现三次,则升级处理,认为修复不足,需要对 SKILL.md 进行更深层的结构性修改。
使用方式 技能输入为规格文件,通过 $ARGUMENTS 传入;若未提供参数,则使用当前目录下的 spec.md。启动后,技能会创建或恢复 journey-loop-state.md。若该文件已存在,则读取并从正确的迭代继续。每轮迭代开始时,需重新读取根目录的 SKILL.md,因为 Refiner 可能已修改它。然后启动 Builder Agent,将 SKILL.md 的完整内容作为任务提示;Builder 会读取规格、选择下一个未覆盖的旅程、编写测试、运行 3 轮打磨并提交。Builder 完成后,启动 Refiner Agent,将 .claude/skills/refine-journey/SKILL.md 的完整内容作为任务提示,并替换规格路径。Refiner 完成后,读取 journey-refinement-log.md 的最新条目,提取评分、失败列表和 SKILL.md 变更,据此决定继续或停止。最后将本轮结果追加到 journey-loop-state.md 并递增迭代计数。
适用场景 适用于需要自动化地、持续地构建和优化用户旅程测试的软件开发流程。当项目希望借助自我改进循环,让测试覆盖逐步逼近规格要求,并在每轮迭代中通过评估改进构建技能时,可使用该技能。
限制
- 停止条件要求同时满足:总体评分大于等于 95%、构建通过、所有旅程测试通过、规格中每个需求都有旅程覆盖。
- 安全限制:最大迭代次数为 10 次;若 10 次后仍未达到 95%,则停止并报告当前状态及剩余的主要失败项。
- 停滞检测:若 Builder 未产出新的旅程文件夹,则记录停滞并继续交给 Refiner,由 Refiner 诊断 Builder 停滞的原因。
- 规格文件不可修改,规格为只读;只有 SKILL.md 会被改进。
- 当所有条件满足停止时,输出内容包括:完成迭代次数、最终评分、已构建的旅程列表、规格覆盖率(X / N 需求已覆盖)以及运行所有测试的准确命令。
关于该技能的收费、价格、平台支持、具体效果等事实,资料中暂未提供。