firstmate Skill：跟一个 agent 说话，调遣整个 crew 并行干活

Skill超级捕获手 技术创作者 2026-09-13 1582 阅读

firstmate 把你从「多 tab 切换管理」变成真正的船长：只跟大副（first mate）说话，它来调度整个 crew——每个船员跑在独立 tmux 窗口 + 干净 git worktree 里，并行开工，最终把 PR 或调研报告交到你手上。这是一个 agent distro，不装 App，clone 下来扔给任意终端 coding agent（Claude Code / Codex / Grok / OpenCode / Pi）就能用。没有额外安装步骤，没有插件体系，没有 MCP server——纯靠 AGENTS.md 把通用 agent 变成专司团队协作的智能体。当前 5,637 stars（截至 2026-09-13），GitHub Trending 当周新晋，正处于增长窗口。

功能与设计原则

firstmate 解决的核心问题是：当你想并行做三件事（修 bug、做调研、出方案）时，多 agent 管理会变成噩梦——你要在多个终端之间来回切换、复制粘贴上下文、记哪个 tab 在干什么。

它的设计哲学是把人类从 agent 调度层抽离出来：

  • 单一联络点：你只对 first mate 下达指令，它负责分发、监控、汇总、汇报
  • 可见 crew：每个船员跑在自己独立的 tmux 窗口里，你可以随时 watching，也可以直接打字介入
  • 无碰撞并行：每个任务在干净的 git worktree 里跑，不会因为并行操作同一个 repo 产生冲突
  • 重启-proof：所有状态存在磁盘 + tmux session，kill 掉再恢复，下一秒就能从断点继续
  • 事件驱动零 token 监控：bash watcher 蹲在 fleet 上，不消耗 token，只在真正需要船长决策时才唤醒 first mate

认可度

  • GitHub stars：5,637（截至 2026-09-13）
  • Forks：1,763——fork 比例极高，说明大量用户在分支上进行定制化实验
  • Trending：当周新晋，GitHub 趋势榜直接上榜，未经过滤直接爆发
  • Hacker News / Twitter：发布后开发者社区讨论度高，被多个 agent 技术社区转发推荐
  • 支持的 agent harnesses：Claude Code、Grok、Pi、Codex、OpenCode——覆盖主流 coding agent 用户群

链接

GitHub：https://github.com/kunchenguid/firstmate

原作者

kunchenguid（GitHub @kunchenguid）——长期深耕 agent 工具链的独立开发者，作品一贯强调「零安装负担」和「可见性」，前序项目有 treehouse（git worktree 管理）、secondmate 等，共同构成一套 agent 原生开发工具矩阵。

介绍

传统上，当你需要让 AI coding agent 帮你并行处理多个任务时，流程是：开多个 terminal tab，分别启动 agent，一个个喂上下文，然后盯着每个 tab 里的进度条发呆。如果其中一个卡住了，你要在 tab 之间切来切去定位问题；如果要合并结果，你得自己 copy-paste。

firstmate 翻转了这个模型。你跟一个叫「first mate」的大副说话，告诉它你的目标（「修掉 login test、加暗色模式、再调研一下支付模块」），大副内部维护一个 backlog，根据任务类型分配给不同的 crewmate：

  • Ship 任务：需要代码改动的，crewmate 在干净的 git worktree 里执行，完成后提 PR 或走本地 merge，完事自动 teardown
  • Scout 任务：调研、复现、审计类任务，crewmate 把结果写成报告放在 data//report.md，不碰代码库

两种任务都跑在独立 tmux 窗口，你随时能看到每个船员在干什么，也可以直接打字进窗口干预——first mate 负责协调所有窗口之间的状态，确保 captain（你）永远只需要跟一个人对话。

对于更大规模的团队协作，firstmate 还支持可选的 Secondmates：领域长期驻守 agent，跑在独立 FM_HOME 目录里，有自己的状态、项目和 session 锁，仍然向 first mate 汇报，但各自对某个领域（比如「支付」「Auth」）有持续上下文。

特点

  • 无安装门槛：clone 即用，AGENTS.md 驱动，不依赖额外二进制或 npm 包
  • 任何 agent 都能变 first mate：Claude Code / Codex / Grok / OpenCode / Pi，只要能跑 tmux 的终端 agent 都行
  • 零 token 浪费：fleet 监控用 bash watcher，不走 LLM，只在真实决策点才唤醒 agent
  • 并行安全：treehouse git worktree 隔离，彻底消除多任务同时操作同一 repo 的 merge 冲突
  • 船长主权：项目边界硬编码保护——first mate 默认只读项目，只在船长明确授权时才能写
  • 可选 X/Discord Relay：用一对 token 让 first mate 响应你的公开 @mention，完成后自动 post 回复
  • restart-proof：kill 掉 tmux session 重新 attach，所有状态从磁盘恢复，任务继续

使用方法

第一步：装好前置依赖

  • 一个支持的 agent harness（Claude Code 推荐）
  • git + GitHub CLI（gh auth login 完成认证）
  • tmux（first mate 自动检测，缺了会提示安装）

第二步：clone 并启动

git clone https://github.com/kunchenguid/firstmate
cd firstmate
claude  # 用 claude 或其他支持的 agent 启动，AGENTS.md 自动接管

第三步：下达指令

> ahoy! 看看我的 github 项目 xyz，然后把 flaky login test 修掉，再加个暗色模式

first mate 会：
1. 检查工具链（经你同意后安装缺的东西）
2. 把项目 clone 到 projects/ 下
3. 在 tmux 里 spawn 两个船员：fm-fix-login-k3 和 fm-dark-mode-p7
4. 几分钟后，PR 就绪，等你审阅

> alright merge it

进阶：Scout 任务

> ahoy! 调研一下 payment 模块的当前状态，出了份报告放 data/ 里

crewmate 在隔离环境里跑完，把 Markdown 报告留在 data/payment-research/report.md，不碰任何代码。

使用场景与人群

适用场景：

  • 多需求并行处理（同时修 bug + 做功能 + 调研技术选型）
  • 需要跨 repo 工作流（比如 monorepo 里同时改多个包的依赖）
  • 技术负责人角色：做决策 + 审 PR，不再亲自动手写每一行
  • 需要在 agent 工作时保持可见性（法律合规、代码所有权要求）的团队

目标用户：

  • 高频使用 Claude Code / Grok 等 coding agent 的独立开发者
  • 小团队技术负责人（想用 agent 做并行 worker，但不想当 tab juggler）
  • 对 agent 安全边界有要求的企业（first mate 硬编码只读保护，防止 agent 乱动代码）

输入与输出案例

案例 1：Ship 任务

Input（船长）：

ahoy! 看下 myproject，修复 issue #42（登录超时），同时调研一下 Redis session 替换方案

Output（first mate 报告）：

PR 就绪：https://github.com/you/myproject/pull/99
– fix-issue-42：修复登录超时，风险低，CI green ✅
– scout-redis-sessions：调研报告已在 data/scouts/redis-sessions/report.md，结论是建议切到 ioredis

船长只需说「merge it」，first mate 执行授权合并。

案例 2：并行 Ship × 3

Input：

ahoy! 我的项目 dashboard 同时需要：修导航栏响应式 bug、加深主题对比度、把 about 页翻译成西班牙语

Output（并行执行）：

三个船员已在 tmux 窗口启动：fm-nav-fix、fm-contrast-deepen、fm-about-es
完成后逐一通知，或等我全部确认后一起 merge

GitHub: https://github.com/kunchenguid/firstmate

评论区

0 条评论

登录后可评论。

Skill超级捕获手 1582 阅读