关于 crank
Crank 执行调用方定义的一轮工作,为每条任务线调用一次 `rpi`,并返回执行证据。它面向已确定范围和验收条件的编排器,不负责选择后续工作或重试任务线。
主要功能
- 01执行给定的一轮工作,不重新规划
- 02每条任务线调用一次 `rpi`
- 03仅并行执行写入范围和生成范围不重叠的任务
- 04所有任务线完成后执行一次整轮验收
- 05返回各任务线状态与证据
适用场景
- 01执行预先定义的多条实现任务线
- 02并行运行相互独立的任务线
- 03任务线完成后评估整轮验收
- 04向编排器提供后续决策所需证据
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ boshu2/ agentops --skill crank安装后在 Claude Code 中输入/crank确认已加载。
详细介绍
Crank
Crank 只执行一个波次。调用方选择波次和修复上限;Crank 运行该波次并返回执行结果。
caller's wave + repair_rounds -> RPI per lane -> wave acceptance once -> evidence -> stop
输入
调用方提供以下全部三项:
- 波次 — 一个通道列表,每个通道都有写入
scope、brief和自己的可执行acceptance。 repair_rounds— 调用方设定的修复上限,不作更改地转发给每个通道。Crank 既不选择该值,也不消耗它。- 波次验收 — 用于整体评判波次的一组命令。
如果某个通道缺少范围、简报或可执行验收,则报告该波次无法运行并停止。Crank 不会自行补全缺失部分。
契约
- 按调用方提供的内容读取波次。不要选择、扩展、删除或重新排序通道;波次到达时已完成决策。
- 对通道进行分组。只有在写入范围不重叠且再生成面不重叠(生成的输出、镜像、清单)时,两个通道才可以并行运行。任何共享面都会使它们串行运行;重叠情况未知时也视为重叠。
- 每个通道调用一次
rpi,传入该通道的意图、范围、验收以及调用方的repair_rounds。每个通道的执行流程负责自己的修复循环。Crank 绝不自行修复通道、重新调用已返回的通道或重新规划通道。 - 所有通道返回后,运行一次波次验收。返回
FAIL或NOT_PROVEN的通道不会阻止验收;两项结果都会并列报告。 - 返回波次证据并停止——包括每个通道的状态(
PASS | FAIL | NOT_PROVEN | NOT_PLANNED | NOT_BUILT)、每个通道的验证器留下的待解决发现(以其findings[].id为键)、每个通道的主题清单摘要,以及波次验收结果。
不要附加下一步行动。调用方读取证据后决定是否启动下一个波次。
边界
Crank 不负责波次选择、重试、预算、队列、认领、租约、Git、关闭、交付或后续工作,也不会自行生成判定。波次证据中的每项语义结果都来自该通道新运行的验证器,并保持原样引用;波次验收通过是一项事实,不是 PASS。
传送管道
在 Claude 中,workflows/implement-wave.js 是步骤 3 并行环节的一条传送管道:它会针对调用方提供的通道,运行所有权互不重叠的实现器。它只负责传输,绝不能替代通道自身的新鲜验证;Crank 即使不使用它也能运行。
提示词
Crank this wave, repair_rounds=2.
Lane A - scope cli/internal/gates/**, brief "add the probe-coverage gate row",
acceptance: cd cli && go test ./internal/gates/...
Lane B - scope docs/CI-CD.md, brief "document that gate row",
acceptance: bash scripts/docs-build.sh --check
Wave acceptance: bash tests/run-all.sh. Report per-lane evidence and stop.
验收标准
无需阅读说明文字,即可在执行记录中观察到以下情况——这也是独立的新评审者为此技能打分时使用的标准:
- 记录显示,调用方波次中的每个通道恰好调用一次
rpi,且没有通道重复出现。 - 共享再生成面的两个通道(例如都触及
skills-codex/)会先后运行,绝不会并发。 - 波次验收命令恰好运行一次,且在最后一个通道返回后运行。
- 返回的证据包含调用方提供的每个通道的状态和主题清单摘要,且不包含 Crank 自行创建的通道。
- 响应以证据结尾:没有下一个波次、没有
git操作,也没有建议的后续工作。
评论
支持 Markdown