kunchenguid/firstmate
# 学习卡：firstmate
一、一句话定位
firstmate 是一个代理发行版（Agent Distro），让你只与一个领航员（firstmate）对话，它自动调度和监督多个子代理（crew）并行完成开发任务，并交付 PR、报告等成果。
二、核心技术/架构亮点（3-5 点）
1. 一人舰队：你只与 firstmate 沟通，它负责分发任务、协调多个 crewmate agent 并行执行，每个 agent 有独立的 tmux 窗口和 git worktree（treehouse），避免冲突。
2. 事件驱动零令牌监督：bash watcher 在后台低功耗监听 fleet，仅在需要你决策时才唤醒 firstmate，大幅减少 Token 消耗。
3. 跨 Harness 兼容：原生支持 Claude Code、Grok、Pi、Oh My Pi、Codex、OpenCode 等多种 AI CLI，通过 AGENTS.md 统一接管。
4. 重启无忧：所有状态持久化到磁盘，session 崩溃后自动恢复，包括已死亡的 secondmate 代理。
三、适用场景与目标用户
- 场景：并行处理多个开发任务（修复、调查、审计、文档）；需要自动化批量 PR 生成；希望减少多终端切换痛苦。
- 用户：使用 AI 编码助手（Claude Code、Grok 等）的开发者；追求高效 agent 编排的团队；喜欢实验性基础设施的极客。
四、可动手动作（clone / 接入 / 借鉴思路）
```bash
gh auth login
git clone https://github.com/kunchenguid/firstmate
cd firstmate
# 启动任一支持的 harness，AGENTS.md 自动接管
claude
```
- 借鉴思路：在自己的项目中实现“单入口 + 多 agent worktree 并行 + 结果汇总”模式，或用其 treehouse git worktree 隔离逻辑。
五、学习优先级：P0（本周动手）
理由：无需额外模型或硬件，只要已有任一支持 harness（如 Claude Code）即可体验完整的 agent crew 编排，适合快速验证理念并提升并行开发效率。⌂