bonfire

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Bonfire

Session context persistence for AI coding - save your progress at the bonfire.

Git root: !

git rev-parse --show-toplevel

面向AI编码的会话上下文持久化工具——在Bonfire中保存你的工作进度。

Git根目录: !

git rev-parse --show-toplevel

Commands

命令

Command	Purpose	Details
`/bonfire start`	Begin session, load context	commands/start.md
`/bonfire end`	Save context, health check	commands/end.md
`/bonfire config`	Change settings	commands/config.md
`/bonfire spec <topic>`	Create implementation spec	commands/spec.md
`/bonfire doc <topic>`	Create documentation	commands/doc.md
`/bonfire review`	Review current work	commands/review.md

命令	用途	详情
`/bonfire start`	开始会话，加载上下文	commands/start.md
`/bonfire end`	保存上下文，运行健康检查	commands/end.md
`/bonfire config`	修改设置	commands/config.md
`/bonfire spec <topic>`	创建实现规格文档	commands/spec.md
`/bonfire doc <topic>`	创建说明文档	commands/doc.md
`/bonfire review`	评审当前工作	commands/review.md

Command Routing

命令路由

Parse

$ARGUMENTS

to determine which command to run:

Input	Action
`start`	Read commands/start.md and execute
`end`	Read commands/end.md and execute
`config` or `configure`	Read commands/config.md and execute
`spec <topic>`	Read commands/spec.md and execute
`doc <topic>` or `document <topic>`	Read commands/doc.md and execute
`review`	Read commands/review.md and execute
Empty or context question	Read session context and answer

解析

$ARGUMENTS

以确定要执行的命令：

输入内容	操作
`start`	读取commands/start.md并执行
`end`	读取commands/end.md并执行
`config` 或 `configure`	读取commands/config.md并执行
`spec <topic>`	读取commands/spec.md并执行
`doc <topic>` 或 `document <topic>`	读取commands/doc.md并执行
`review`	读取commands/review.md并执行
空输入或上下文相关问题	读取会话上下文并回答

Quick Reference

快速参考

Start Session

启动会话

Check/create
```
.bonfire/
```
directory
Read
```
index.md
```
for session context
Ask what to work on

检查/创建
```
.bonfire/
```
目录
读取
```
index.md
```
获取会话上下文
询问要开展的工作内容

End Session

结束会话

Update
```
index.md
```
with accomplishments
Run health check (garbage detection)

更新
```
index.md
```
记录工作成果
运行健康检查（垃圾内容检测）

Config

配置

Set specs/docs locations
Choose git strategy (ignore-all, hybrid, commit-all)
Enable/disable Linear integration

设置规格文档与说明文档的存储位置
选择Git策略（ignore-all、hybrid、commit-all）
启用/禁用Linear集成

Spec

生成规格文档

Research codebase (subagent)
Interview user for decisions
Write spec (subagent)
Verify required sections

调研代码库（子Agent）
与用户沟通确认决策
编写规格文档（子Agent）
验证必填章节

Doc

生成说明文档

Research codebase (subagent)
Write documentation (subagent)
Verify required sections

调研代码库（子Agent）
编写说明文档（子Agent）
验证必填章节

Review

代码评审

Gather context (branch diff, session notes)
Analyze for blindspots (subagent)
Present findings by severity
Offer to fix, spec, or create issues

收集上下文信息（分支差异、会话笔记）
分析潜在盲区（子Agent）
按严重程度呈现发现的问题
提供修复、制定规格或创建Issue的选项

Passive Context

被动上下文处理

When user asks about previous work, decisions, blockers, or references "last time", "previously", "what we decided":

Read
```
<git-root>/.bonfire/index.md
```
Summarize relevant context
Answer the user's question

当用户询问过往工作、决策、障碍，或提及「上次」「之前」「我们之前的决定」时：

读取
```
<git-root>/.bonfire/index.md
```
总结相关上下文内容
回答用户的问题

Bootstrap

初始化流程

.bonfire/index.md

doesn't exist when any command runs, create defaults:

Create
```
.bonfire/
```
with
```
specs/
```
and
```
docs/
```
subdirectories
Create
```
index.md
```
with frontmatter config (see templates/)
Create
```
.gitignore
```

See templates/ for default content.

当运行任意命令时若

.bonfire/index.md

不存在，则创建默认内容：

创建
```
.bonfire/
```
目录及其子目录
```
specs/
```
和
```
docs/
```
创建带有前置配置的
```
index.md
```
（参考[templates/]）
创建
```
.gitignore
```
文件

默认内容可参考[templates/]。

File Structure

文件结构

.bonfire/
├── index.md          # Session context with config in frontmatter
├── specs/            # Implementation specs
├── docs/             # Documentation
└── .gitignore        # Git strategy

.bonfire/
├── index.md          # 包含前置配置的会话上下文文件
├── specs/            # 实现规格文档目录
├── docs/             # 说明文档目录
└── .gitignore        # Git策略配置文件