多个编码 Agent 共用一个仓库时，Agent Board Kit 把任务范围、进度、阻塞、留言和交接写进本地文件；运行时不需要常驻服务。
它解决什么
一个 Agent 正在改路由，另一个准备调整同一份配置，两边都需要先知道对方的任务范围。Agent Board Kit 让开工登记、冲突查看和完工交接使用同一组本地记录；接手时可以查到进度与留言，再决定怎样继续。
适合的场景
- 多个编码 Agent 共用一个 Git checkout。
- 同一 clone 下的 linked worktree 需要共享任务状态。
- 希望协作记录留在本地，又不想部署数据库、Web UI 或另一套任务调度平台。
工作方式
state.json 保存当前状态，messages.jsonl 和 events.jsonl 保存追加记录。写入经过跨进程文件锁；状态损坏时会停止写入，并可从上一份有效备份恢复。
冲突只做预警，不会强制锁住文件。它也不创建 Agent、不调度模型，不替代 Git diff、测试、评审和提交记录。
安装
需要 Python 3.8+，目标目录必须是 Git 项目根目录。
npx skills add Evilom/agent-board-kit --skill agent-board
也可以克隆仓库后运行安装器：
git clone https://github.com/Evilom/agent-board-kit.git
python .\agent-board-kit\install.py D:\your-project
使用流程
python scripts/agent_board.py status --active
python scripts/agent_board.py conflicts
python scripts/agent_board.py start --agent codex-ui --task "重做作品页" --scope components/works
python scripts/agent_board.py done --agent codex-ui --note "测试通过"
项目地址
- GitHub 仓库
- v1.1.1 Release
- 许可证：MIT