bmad-loop-sweep 是 bmad-loop 编排器中的一个清账分诊工作流,目标是将 {implementation_artifacts}/deferred-work.md 中每个被选定的 open 条目分类为机器可读的分诊计划,供编排器校验和执行。该技能为只读且面向自动化运行:它只在 bmad-loop sweep 会话内工作,不编辑账本、不编辑代码、不提问,唯一输出是结果文件;迁移模式是唯一例外,只编辑账本这一个文件。
使用方式:激活后先执行自动化检查,仅当 BMAD_LOOP_MODE 为 1 时继续;随后读取 automation-mode.md 作为本次运行的规则和结果 schema 依据;若调用带有 --migrate <manifest-path>,则转为迁移会话,读取 migration-mode.md。接着通过 BMAD_LOOP_LEDGER 定位账本,若为空则从 _bmad/bmm/config.yaml 解析 implementation_artifacts 并读取 deferred-work.md;对带 archived: 或 archived-body: 的条目,从 deferred-work-archive.md 读取完整正文。若调用带 --only DW-1,DW-2,则这些 id 构成本次完整分诊范围,只核验并归类这些具名 open 条目。若带 --feedback <path>,先读取该文件以修正上次结果的确定性校验错误。
核验阶段:账本状态不可靠,需对每个条目读取其位置,检查问题是否仍存在,读取代码、grep 症状、查看相关 git log,记录具体证据(file:line 或 commit hash),可用子代理并行核验。分区阶段要求每个条目恰好归入一个类别:already_resolved(问题已不存在,需具体证据,由编排器确定性关闭账本条目)、bundles(现在即可构建,按共享触点分组为单一目标 bundle,name 需符合 kebab-case 且不超过 40 字符,intent 为 2–6 句描述)、blocked(需等待具名未来故事/史诗落地)、skip(被取代、无意义或项目明确排除)、decisions(需人工选择,每个给出 2–4 个具体选项及建议)。对于交付物严格位于代码仓库内 implementation_artifacts 目录中被忽略内容的 bundle,需在 intent 中描述交付物及位置;不添加分诊回执字段;执行会话仅在自身实际交付物符合条件时,可在最后真实的 ## Auto Run Result 中于 Status: 旁单独一行写 Artifact only: true,该标记须在当前会话撰写、不在围栏块内、无编排器修复说明,值须为严格的布尔 true。
限制:只读且不提问;只在 bmad-loop sweep 会话内运行;不编辑账本或代码(迁移模式除外);结果按 automation-mode.md 的 schema 写入 result.json;禁止目录、通配符、绝对路径、路径穿越、符号链接以及编排器拥有的账本和冲刺板;未声明文件不会被复制。适用场景为 bmad-loop 编排器对延迟工作账本进行自动化清账分诊。