bonfire
为AI编程会话提供跨会话、跨机器的持久化上下文管理
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：bonfire。 它的用途是：为AI编程会话提供跨会话、跨机器的持久化上下文管理 完整的 Skill 内容见：https://321skill.com/skills/bonfire/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请帮我回顾一下我们昨天在用户认证模块上做到了哪一步，接下来该做什么？” AI会读取`.bonfire/index.md`文件，然后回答：“根据记录，昨天的会话目标是‘实现JWT令牌刷新逻辑’，下一步是‘编写刷新令牌的API端点测试’。我们今天可以从这里继续。” 在会话结束时，AI或适配器会自动将本次关于“编写测试”的进展更新到文件中。
介绍
Bonfire 解决了AI代理（如Claude、Pi）在编程对话中缺乏记忆的问题。由于AI代理本质上是无状态的，每次新对话都从头开始，开发者需要反复复述项目背景、当前进展和待办事项。Bonfire通过在代码仓库根目录创建一个.bonfire文件夹，并在其中的index.md文件中维护一个结构化的上下文文档，自动记录每次会话的目标、进展和关键笔记，确保下次会话能无缝衔接。
使用Bonfire，你需要先在目标代码仓库中创建.bonfire目录来启用它。然后，根据你使用的AI代理（如Pi、Claude Code或其他），安装对应的适配器或技能。这些适配器会在会话结束时自动更新index.md文件，将本次会话的摘要和目标添加到文档中。当下次在同一仓库中启动会话时，AI代理可以读取这个文件，快速了解项目全貌。
这个技能非常适合需要长期、多会话协作开发项目的开发者，尤其是全栈开发、后端开发和智能体开发者。他们经常需要中断编码，并在不同时间、甚至不同机器上继续工作。Bonfire确保了项目上下文不丢失，减少了重复沟通的成本。
使用建议是，对于个人项目或小型团队，可以将.bonfire/index.md提交到Git以实现跨机器同步；如果希望每台机器保留独立的记忆（例如不同开发者关注点不同），则将其加入.gitignore。注意，Bonfire不会自动在任意仓库创建该目录，需要你手动启用，这避免了污染不相关的项目。
核心特点
Bonfire的核心区别在于其“文件约定优先”的设计哲学和轻量级实现。它不依赖任何中心化服务或复杂的数据库，仅使用项目内的Markdown文件作为上下文载体，确保了极致的可移植性和可读性。同时，它通过为不同AI代理（Pi, Claude Code）提供原生适配器，实现了无缝、自动化的上下文捕获，而非依赖用户手动触发。
注意事项
不适合用于管理大量非结构化、非项目相关的零散笔记或知识库，其设计核心是围绕具体代码仓库的会话上下文。
常见问题
Bonfire会把我所有的对话历史都存下来吗？
不会。它只结构化地保存会话摘要（如目标、下一步行动）和最新几次会话的链接，详细的会话内容不会堆积在主文件中，避免文件臃肿。
我可以在多个AI代理（如Claude和Pi）之间共享同一个Bonfire上下文吗？
可以。只要它们都指向同一个代码仓库下的`.bonfire`目录，并且你配置了相应的适配器，不同代理生成的会话记录都会更新到同一个`index.md`文件中。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/bonfire/raw/index.md 读取 bonfire 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/bonfire/raw/index.md（查看排版版本）