SuperAPI AI 工具集

next

智能体与模型

查看项目

更新于 10-26 18:53

技能介绍

用途 /next 是自主待办队列循环,用于把已经存在的待办(beads)按顺序推进到完成。所有机制位于 bro CLI 中,本技能只承担策略:决定取什么、不取什么、如何循环以及何时报告停止。

主要能力

  • 使用 bro flow next 从 bd ready 计算队列,原子认领顶部条目并打印工单。
  • 按“实现 → 提 PR → 审查合并 → 关闭 bead → 再取下一个”的循环推进,直到输出“backlog empty”。
  • 明确展示被有意跳过的条目:人类闸门显示为 gate: 行,史诗显示为 epic: 行,外部范围条目显示为 foreign: N。
  • 不认领人类闸门、史诗、分子步骤、外部范围 bead、全局 bead 和 gt:slot 协调信号量;其中史诗可分解为子 bead,分子步骤属于 bro flow convoy。
  • 支持通过 bro plan run next.toml 驱动同一选择流程,可配置 limit(批量大小)、order(priority|oldest|newest)、[filters](types、max_priority、title match、labels)、claim = false 干跑、gates = "allow" 预授权认领 HUMAN GATE bead、scope = "all" 解除项目范围、scope = "global" 或 --global 从用户级存储调度。
  • 批量认领用于并行执行(每个工作树/代理一个已认领 bead),但被认领的闸门仍由人决定结果。

使用方式 前置条件:bro 在 PATH 中,或使用 npx -y @broject/bro@0;已执行 bd init。 基本循环:

  1. bro flow next → 认领顶部就绪 bead,打印工单。
  2. 实现:建分支、写代码、写测试,像 CI 一样验证。
  3. 提 PR:gh pr create → bro review act status → bro review act merge。
  4. bd close <id>,原因写为落地它的 PR。
  5. 再次 bro flow next,重复直到“backlog empty”。 若待办存在即视为已确认,条目之间不要询问“是否继续”。

策略要点

  • 一个 bead 一个 PR,除非多个条目本质上是同一改动;债务批量是例外而非规则。
  • 闸门决定完成:合并前 bro review act status 为绿色,bro review act merge 落地,之后删除分支。
  • 卡住不等于跳过:若条目无法推进,说明原因(阻塞、缺少权限、歧义),保持打开,用 bd update <id> --notes "<why>" 记录,并继续下一个 bead,绝不静默丢弃。
  • 区分 idle 与 gated:state: idle 表示待办确实为空,报告并停止;state: gated 表示仍有未关闭条目但均不可认领(闸门/史诗/分子步骤),报告阻塞内容并停下等待人工,不要当作完成,也不要制造工作。

适用场景 适合已有 beads 待办、希望以固定策略自动连续推进到 PR 合并与关闭的场景;也适合用计划文件做批量、过滤、干跑或跨项目/全局调度的场景。

限制

  • 不认领人类闸门、史诗、分子步骤、外部范围 bead、全局 bead 与协调信号量。
  • 人类闸门每个需询问一次用户,其裁决即结果。
  • 全局 bead 需显式使用 --global 或 scope = "global",项目输出不会混合它们。
  • 计划中的 batching 仅用于并行执行,被认领的闸门仍由人裁决。
  • 资料未提供收费、价格、平台支持范围或效果指标等信息。