用途
bonfire-review 是 bonfire 技能集中的代码审查技能,用于对已完成的工作进行战略性审查,识别盲点、缺口与改进点。其核心设计是通过子代理(subagent)在隔离上下文中执行分析,从而保留主上下文用于后续行动决策。
主要能力
- 多范围审查:支持三种审查范围。无参数时审查当前分支与基线的差异;使用
--session审查当前会话捕获的工作;指定主题/领域时聚焦特定方面。 - 上下文收集:读取
<git-root>/.bonfire/index.md中的会话上下文,获取分支 diff(git diff main...HEAD或适当基线),阅读.bonfire/中的相关规格文档,理解工作意图。 - 子代理审查:通过 Task 工具调用 work-reviewer 代理,在隔离上下文(sonnet 模型)中运行,返回按严重程度和预估工作量分类的发现。
- 结果验证:验证子代理返回的响应是否包含摘要与发现计数,以及至少一个分类(立即修复、需要规格、创建议题)。对部分响应、无效/空响应或子代理失败均有相应处理策略,可回退到上下文内审查。
- 可恢复审查:对于大型变更集,Task 工具返回 agentId,可用于恢复审查。当审查覆盖多个文件且用户希望深入分析特定区域、发现提及“省略了额外项目”或用户希望聚焦特定方面时,可提供恢复选项。最多进行 3 轮。
- 发现呈现与行动:将发现按建议行动分组呈现:立即修复(琐碎工作量)、需要规格(重要,需要规划)、创建议题(大工作量或锦上添花)。用户可选择立即修复、创建实现规格或创建议题。
- 议题创建:读取
<git-root>/.bonfire/config.json检查linearEnabled。始终提供创建 GitHub 议题的选项;若linearEnabled为 true,也提供创建 Linear 议题的选项。GitHub 使用gh issue create,Linear 使用linear issue create。 - 会话上下文更新:将审查结果(关键发现、创建的议题及链接、推迟到未来会话的工作)添加到
<git-root>/.bonfire/index.md。
使用方式
该技能通过命令调用,支持以下参数形式:
- 无参数:审查当前分支与基线
--session:审查当前会话上下文捕获的工作- 主题/领域:聚焦审查特定方面
执行流程分为六个步骤:确定范围、收集上下文、运行审查(子代理)、呈现发现、执行选定行动、更新会话上下文。
适用场景
- 完成一段工作后,需要系统性检查盲点与缺口
- 大型变更集需要多轮深入审查
- 需要将审查发现转化为可执行的后续行动(修复、规格、议题)
- 团队使用 GitHub 或 Linear 进行议题跟踪
限制
- 子代理审查可能返回部分结果、空结果或失败,此时会回退到上下文内审查。
- 恢复审查最多进行 3 轮。
- Linear 议题创建需要配置
linearEnabled为 true 且使用 linear-cli。 - 该技能依赖 bonfire 技能集的其他组件(如
/bonfire-spec)和.bonfire/目录结构。