mcpField
C
crank

crank

github.com/boshu2Agent 工作流4501.2k 次安装今天更新
代码仓库

关于 crank

Crank 执行调用方定义的一轮工作,为每条任务线调用一次 `rpi`,并返回执行证据。它面向已确定范围和验收条件的编排器,不负责选择后续工作或重试任务线。

主要功能

  1. 01执行给定的一轮工作,不重新规划
  2. 02每条任务线调用一次 `rpi`
  3. 03仅并行执行写入范围和生成范围不重叠的任务
  4. 04所有任务线完成后执行一次整轮验收
  5. 05返回各任务线状态与证据

适用场景

  1. 01执行预先定义的多条实现任务线
  2. 02并行运行相互独立的任务线
  3. 03任务线完成后评估整轮验收
  4. 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 不会自行补全缺失部分。

契约

  1. 按调用方提供的内容读取波次。不要选择、扩展、删除或重新排序通道;波次到达时已完成决策。
  2. 对通道进行分组。只有在写入范围不重叠且再生成面不重叠(生成的输出、镜像、清单)时,两个通道才可以并行运行。任何共享面都会使它们串行运行;重叠情况未知时也视为重叠。
  3. 每个通道调用一次 rpi,传入该通道的意图、范围、验收以及调用方的 repair_rounds。每个通道的执行流程负责自己的修复循环。Crank 绝不自行修复通道、重新调用已返回的通道或重新规划通道。
  4. 所有通道返回后,运行一次波次验收。返回 FAIL 或 NOT_PROVEN 的通道不会阻止验收;两项结果都会并列报告。
  5. 返回波次证据并停止——包括每个通道的状态(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