SuperAPI AI 工具集

bmad-loop-sweep

通用与其它

查看项目

更新于 10-15 17:27

技能介绍

用途:该技能用于处理 bmad-loop 编排器的延后工作台账(deferred-work.md),把选定的 open 条目分类成编排器可校验、可执行的机器可读分诊计划。它只读运行、面向自动化,仅在 bmad-loop sweep 会话中执行:不修改台账、不修改代码、不向用户提问,唯一产物是结果文件;唯一例外是迁移模式,仅编辑台账这一个文件。

主要能力:先做自动化检查与模式分派,通过 echo "${BMAD_LOOP_MODE:-}" 判断是否处于 sweep 会话,若不是则直接结束;随后定位台账并完整读取。open 条目指状态行为 open 的 ### DW-<n>: 块。带 archived: 行的条目正文存放在 deferred-work-archive.md 中,需按同一 DW- id 读取后再分类;带 archived-body: 行的条目表示已归档后又重新打开,是活的工作,但此前正文仍在归档文件中。支持 --only DW-1,DW-2,... 限定本次分诊范围,支持 --feedback <path> 读取上次失败校验的确定性错误来修正输出,--migrate <manifest-path> 则转为迁移会话。

核心流程:对分诊范围内每个条目,按 location:(文件/组件)在当前代码树中验证问题是否仍存在,可读代码、grep 症状、查看 origin: 日期之后触及该区域的 git 提交;证据必须具体到 file:line 或 commit hash,不接受“大概已修复”。可用子代理并行验证。

分类:already_resolved(问题已不存在,需具体证据)、bundles(现在即可构建,按共享触点分组为单一目标、适合一次开发会话的捆绑,name 需匹配 ^[a-z0-9][a-z0-9-]{1,39}\Z,intent 为 2–6 句)、blocked(需等待具名未来故事/史诗落地,需原样指明阻塞项)、skip(已被取代、无意义或属于项目明确排除的场景,需给出原因)、decisions(必须由人来决定,如重新协商 spec 的 <frozen-after-approval> 块、推翻人工批准的范围决定、影响未构建消费方的 API 形状变更、以 "auto-mode: needs human decision" 延后的条目;每项给 2–4 个具体选项与建议)。每个条目必须恰好归入一个类别,否则整体结果校验失败。

限制:仅能在 bmad-loop sweep 会话内运行;不编辑台账或代码,也不提问;无法在非 sweep 环境使用。台账缺失或不可读时按 automation-mode.md 上报 CRITICAL(type: missing-ledger)并结束。分发与仓库内忽略内容的交付规则细节需参照 automation-mode.md;官方文本暂未提供。