用途:sweep 把一堆小修复聚合成一批可由 /fleet 派发的工单。小修复单独运行成本高,sweep 一次性完成整批的探查与审查;它归档的标签对 /fleet 而言就是功能标签,因此派发、集成与单一 PR 进入 main 都适用。
主要流程与能力:
-
收集:用 gh issue list --state open --label inbox --json number,title,body 获取 inbox issue,外加用户消息中按每个独立修复拆分的条目。两个来源都为空时说明 inbox 为空并停止。
-
一次探查:单次遍历定位全部条目,而不是每项一次。有 .codegraph/ 索引时用一次 codegraph_explore,命名每个条目的符号与文件;否则用一个 Explore 子代理,模型为 "haiku",给出整份列表,按条目返回涉及的文件与符号,以及大致规模(行数、文件数)。
-
拒绝不够小的条目:仅当同时满足以下条件才留在 sweep 中——修改现有行为或代码而非新功能;约 80 行以内、1–3 个文件;无 schema、公共 API 或依赖变更;原因已知。原因仍待查找的 bug 属于 triage。拒绝项列出其去向:无法解释的 bug 去 triage-issue,功能去 capture-idea 或 to-prd,无已知修复方案的设计或重构问题去 needs-design(如 LEARN later: 标记)。needs-design 不指定技能,因为决定修复方案本身就是待办工作。被拒的 inbox issue 保持 open,但在第 6 步移出 inbox,否则后续 sweep 会反复探查和拒绝它。
-
按文件聚类:触碰同一文件的条目并入一个 ticket,且可传递(A 与 B 共享文件、B 与 C 共享,则三者同属一个 ticket)。互不相关的条目保持独立 ticket,以便并行运行不冲突。若一个簇超过约 3 个文件或 150 行,则拆回 ticket 并按条目顺序用 ## Blocked by 串联,让 /fleet 逐波运行而非冲突。规模标注:触碰一个文件且至多需要一个新测试用例为 size:xs,否则 size:s。
-
确认批次:展示一张表格并等待确认。聚类本身就是决策,这是唯一确认环节: Label: sweep-2026-10-07 | Ticket | Items (inbox #) | Files | Size | Rejected: <item> (inbox #) → <route>
-
归档:标签为 sweep-YYYY-MM-DD(当天日期)。若该标签已有 open issue,则追加 -2、-3 等,避免已派发的批次中途新增 ticket。用 gh label create "<label>" -d "Sweep of small fixes" 创建标签,缺失时也创建 size:xs / size:s。每个 ticket 使用 file-issue 的正文(## Context、## Where to look、## Acceptance criteria),以第 2 步发现作为 "Where to look",另加 ## Items 与 ## Blocked by 段落,验收标准每个条目一到两条。创建命令:gh issue create --title "<title>" --body-file <tmpfile> --label "<sweep label>" --label "status:ready" --label "size:<xs|s>"。第 4 步串联的 ticket 改用 status:backlog 并加 - Blocked by #<N> 行。随后关闭每个被吸收的 inbox issue:gh issue close <N> --comment "Swept into #<ticket>"。把来自 inbox issue 的拒绝项移出 inbox:gh issue edit <N> --remove-label inbox;needs-design 的拒绝项还要 --add-label needs-design,缺失时先用 gh label create needs-design -d "Needs a design decision before it can be fixed" 创建。
-
报告:逐行列出 ticket 的 #<N> <title> (size),再列拒绝项及其去向,最后单独一行给出命令:/fleet dispatch <sweep label>
适用场景:适合把小规模、原因已知且范围受限的修复批量整理并派发。
限制:不处理新功能、原因未知的 bug、涉及 schema、公共 API 或依赖变更的改动;超出约 80 行、1–3 文件的条目会被拒绝或拆分。资料未提供关于收费、价格、平台支持范围与效果的数据。