ds-swarm

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

ds-swarm

ds-swarm

Split work that is wide but shallow across parallel workers, then merge their proven results into one report.
将范围广但深度浅的工作拆分给并行 worker,再将它们经过验证的结果合并为一份报告。

Steps

步骤

  1. State the done condition and the report the swarm must return.
  2. Pick the shape. Partition the job into non-overlapping slices, or race N workers on the same brief, or both. For a race, decide up front how you will choose: first pass, rank all, or best one.
  3. Write one brief per worker that stands alone: goal, exact slice, how to verify, what to report. When workers test specific commits, name the exact commit hashes and the measurement method.
  4. Give every worker that writes files its own output location.
  5. Spawn all workers at once. If the harness cannot run subagents, run the briefs one by one in fresh contexts.
  6. Each worker reports PASS, ISSUES or BLOCKED with evidence: commands run and their output. ISSUES lists every provable issue, not just the first.
  7. Collect results. Reject any result with no evidence or the wrong commit and respawn that worker once. A second miss is a recorded gap, not a pass.
  8. Merge into one report: the verdict, each slice or arm with its evidence, gaps, and duplicates merged by root cause.
  1. 明确完成条件,以及 swarm 必须返回的报告。
  2. 选择组织方式。将任务划分为互不重叠的切片,或让 N 个 worker 针对同一任务说明进行竞速,也可两者结合。对于竞速,预先决定选择方式:首个通过者、对所有结果排名,或选出最佳者。
  3. 为每个 worker 编写一份可独立理解的任务说明:目标、具体切片、验证方式、报告内容。如果 worker 测试特定 commit,请注明准确的 commit hash 和测量方法。
  4. 为每个需要写入文件的 worker 分配独立的输出位置。
  5. 同时启动所有 worker。如果 harness 无法运行 subagents,则在全新上下文中逐一运行这些任务说明。
  6. 每个 worker 报告 PASS、ISSUES 或 BLOCKED,并附上证据:运行的命令及其输出。ISSUES 必须列出所有可证实的问题,而不只是第一个。
  7. 收集结果。拒绝任何没有证据或使用了错误 commit 的结果,并重新启动该 worker 一次。第二次遗漏应记录为缺口,不能算作通过。
  8. 合并为一份报告:结论、每个切片或竞速方案及其证据、缺口,以及按根因合并后的重复项。

Stop when

停止条件

  • Every slice has a result or a recorded gap and the report is written.
  • Or a race has a winner under the rule from step 2.
  • Never respawn a worker more than once.
  • 每个切片都有结果或已记录的缺口,且报告已写完。
  • 或竞速已按照步骤 2 中的规则产生胜者。
  • 任何 worker 都不得重新启动超过一次。

Rules

规则

  • Workers do not share writable state.
  • A missing slice is never counted as passing.
  • Report what workers proved, not what they claimed.
  • Worker 之间不共享可写状态。
  • 缺失的切片绝不能计为通过。
  • 报告 worker 已证明的内容,而不是它们的声称。