SuperAPI AI 工具集

bonfire-review

编程与开发

查看项目

更新于 10-16 06:10

技能介绍

用途

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/ 目录结构。