用途:把跨仓库的 backlog 定期审查固化为可重复的五阶段工作流,替代人工逐个扫描仓库、阅读简报、检查代码状态并决定关闭哪些事项的过程。适用于月度或双周审查、多仓库集中工作后的清理、bon 事项数量增长需裁剪,以及开启新专注期前先卸掉陈旧承诺。单仓库分诊、活跃会话内工作、首次接触某仓库事项时不宜使用。
前提:需已加载 bon 技能,闭项使用 bon done;需 uv 在 PATH 中,audit_survey.py 通过 uv run --script 运行。
流程:阶段一调查,运行 uv run --script ${CLAUDE_SKILL_DIR}/scripts/audit_survey.py 获取所有开放事项的结构化数据,也可用 --repos 限定仓库,输出含完整简报、创建时间和 age 标记(old=30天以上,very_old=60天以上),展示概览后停下等用户确认范围。阶段二核实,按仓库派发只读子代理(Task 工具),并行策略为少于5项时每子代理最多批3个仓库、5项及以上每仓库一个、最多5个并发;按文件路径存在性、代码 grep、Git 日志、完成条件依次验证,把每项分类为 DONE、STALE、ACTIVE、BLOCKED 或 UNCLEAR,子代理只读,不得改文件或运行 bon 命令。阶段三汇总,以纯文本表格呈现各类别,停下等用户批准关闭哪些项。阶段四执行,对批准项在对应仓库运行 bon done {id},完成后提交 git add .bon/items.jsonl 并提交,除非用户明确要求否则不推送;陈旧项仅记录待后续处理。阶段五快照,重跑调查脚本并报告前后差值。
限制与反模式:不得未经核实就关闭,不得凭简报表面判断,不得自动关闭陈旧项(陈旧简报不等于陈旧意图),审查不与活跃工作混做,审查期间不编辑简报,不跳过快照,不要用 Bash 输出汇总以免被折叠。bon 技能需已加载,是否收费、支持平台及其他细节资料暂未提供。