关于 bonfire
bonfire 是用于 AI 编码 Agent 的会话上下文持久化技能，面向希望在仓库中保留工作上下文的开发者。它使用 `.bonfire/index.md` 文件约定，并为 Pi 和 Claude Code 提供原生适配器；此技能则供没有适配器的 Agent 手动执行。
主要功能
- 01通过 `.bonfire/index.md` 保存会话上下文
- 02按仓库选择启用
- 03提供 Pi 和 Claude Code 原生适配器
- 04以手动 `end` 命令作为备用方式
- 05支持旧版文件的一次性迁移
适用场景
- 01在编码会话结束时保存上下文
- 02让后续会话读取仓库内的工作记录
- 03在没有原生适配器的 Agent 中手动运行
- 04迁移缺少标记的旧版索引文件
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/bonfire确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
commands/end.mdmigrate.mdtemplates/index.md详细介绍
Bonfire（备用技能）
AI 编码的会话上下文持久化。
Bonfire 分为三个层：
- 文件约定 —
<git-root>/.bonfire/index.md，包含两个受管理的围栏块。 - 原生宿主适配器（首选）— 即插即用插件，可在工作时自动更新文件。适用于 Pi 和 Claude Code。
- 此技能（备用）— 对于没有原生适配器的 Agent（Codex、OpenCode 等），手动运行
/skill:bonfire end。
如果你使用 Pi 或 Claude Code，请改为从 ~/dev/bonfire/{pi,claude}/ 安装适配器。这些适配器无需额外操作，功能也比此技能更丰富。
Git 根目录：!git rev-parse --show-toplevel 2>/dev/null || echo ""
选择启用
此技能（以及适配器）遵循每个仓库的选择启用机制：
mkdir <repo>/.bonfire
如果不存在 .bonfire/，此技能会静默退出。这样可以避免它干扰无关仓库。
路由
| 输入 | 操作 |
|---|---|
end | 读取 commands/end.md 并执行 |
migrate | 读取 commands/migrate.md 并执行。用于一次性迁移不含 v1 围栏标记的 v7 之前版本 index.md — 在不破坏手工整理内容的前提下为文件添加围栏。 |
Bonfire 的早期版本包含 start 和 handoff 命令。两者均已在 7.0 中移除：
start：多余。现代 Agent 会自动读取cwd中的文件，因此.bonfire/index.md已在上下文中。无需额外操作。handoff：Pi 提供了功能更丰富的第一方handoff扩展。对于非 Pi Agent，可使用 Linear、通过@file注入的笔记文件，或 PR 草稿说明。
评论
支持 Markdown