Bonfire 用于在 AI 编程过程中持久化会话上下文，核心是文件约定：在 Git 仓库根目录创建 .bonfire/index.md，其中包含两个受管理的围栏代码块。它分为三层：文件约定本身；原生宿主适配器（首选），以即插即用插件形式在工作时自动更新该文件，目前提供 Pi 和 Claude Code 版本；以及本技能作为回退方案，供没有原生适配器的智能体（如 Codex、OpenCode 等）手动调用 /skill:bonfire end。若使用 Pi 或 Claude Code，应从 ~/dev/bonfire/{pi,claude}/ 安装适配器，适配器无需额外仪式且能力比本技能更丰富。
使用前需按仓库选择启用：创建 <repo>/.bonfire 目录。若 .bonfire/ 不存在，本技能会静默退出，避免污染无关仓库。
路由方面，输入 end 时读取并执行 commands/end.md；输入 migrate 时读取并执行 commands/migrate.md，用于一次性迁移缺少 v1 围栏标记的旧版 index.md，在不破坏手工整理内容的前提下为文件加上围栏。
7.0 版本移除了早期的 start 和 handoff 命令：start 已冗余，现代智能体会自动读取当前工作目录中的文件，.bonfire/index.md 已在上下文中；handoff 方面 Pi 有更丰富的一手交接扩展，非 Pi 智能体可使用 Linear、通过 @file 注入的笔记文件或草稿 PR 描述。
限制：本技能仅为回退方案，功能弱于原生适配器；需要仓库显式启用；具体命令细节需查阅对应 commands 文件。