SuperAPI AI 工具集

bonfire-end

办公与效率

查看项目

更新于 10-16 06:10

技能介绍

用途

bonfire-end 是 bonfire 技能集中的会话结束技能,用于在一次开发会话结束时收尾:更新会话上下文、运行上下文健康检查、同步任务,并在满足条件时归档已完成的工作。它面向使用 bonfire 进行跨会话上下文管理的开发者。

主要能力

技能按九个步骤执行:

  1. 回顾会话工作:通过最近的 git 提交、变更文件和对话上下文,回顾本次会话完成了什么。
  2. 更新会话上下文:更新 <git-root>/.bonfire/index.md,在会话条目中记录已完成事项(Accomplished)、关键决策及理由(Decisions)、重要修改文件(Files Modified)、遇到的阻塞(Blockers),并更新“Next Session Priorities”和“Current State”。
  3. 更新 Codemap:在 index.md 的 Codemap 部分记录本次会话引用的关键文件,列出最多 10 个最相关文件并附简要说明,格式为 - \path/to/file.ts - Brief description`。保留用户维护的“Entry Points”和“Core Components”部分不变,移除上一会话的过时条目。
  4. 同步到 Tasks:将“Next Session Priorities”转换为任务,保留描述与上下文,标记已完成项,避免重复,实现跨会话持久化。index.md 提供“为什么”,Tasks 提供“做什么”。
  5. 提交变更(如被跟踪):读取 <git-root>/.bonfire/config.json 中的 gitStrategy。若为 ignore-all 则跳过提交;若为 hybrid 或 commit-all,则执行 git add .bonfire/,检查暂存内容后以 docs: update session context 提交。
  6. 上下文健康检查:扫描 .bonfire/ 中的失效文件引用、超过 30 天关闭的过期外链、超过 7 天未被引用的孤立规格、归档完整性(指向已归档会话的失效链接)。为每个问题提取上下文并分配置信度(HIGH/MEDIUM/LOW),按类别提示用户选择清理。
  7. 智能归档检测:检查会话上下文引用的 PR 状态(通过 gh pr view [NUMBER] --json state,mergedAt,title)、任务完成情况、对话中的完成信号(如 done、shipped、merged、ready to archive)。若所有引用的 PR 已合并、用户明确表示完成、或所有任务标记完成,则自动归档;混合状态或无明确信号时提示确认;无会话内容或明确进行中(WIP)时跳过归档。
  8. 归档(如触发):创建 .bonfire/archive/YYYY-MM-DD-<topic>.md,包含日期、Issue、PR、状态、摘要、已完成事项、决策、影响、相关链接;从 Recent Sessions 移除已归档会话并加入 Archived Sessions;删除已完全实现并归档的规格;若配置启用 Linear 且会话引用 Linear issue,则执行 linear issue update ENG-123 --state "Done"(失败时警告并继续);若 gitStrategy 为 hybrid 或 commit-all,则提交归档。
  9. 确认:汇总已记录内容、已同步任务、下次优先级、已归档内容,输出会话结束摘要,并提示运行 /bonfire-start 继续。

使用方式

该技能以斜杠命令形式使用(结束时会提示运行 /bonfire-start 继续),依赖 git 仓库中的 .bonfire/ 目录结构,包括 index.md、config.json、archive/ 等。归档检测依赖 gh CLI 查询 PR 状态,Linear 集成需在配置中启用。

适用场景

适用于使用 bonfire 管理跨会话开发上下文的项目,在每次开发会话结束时运行,以保持上下文、任务和归档的一致性。

限制

具体安装方式、依赖版本、配置字段的完整说明以及 Linear 集成的详细要求,资料中暂未提供。