FirstMate 的中文入门教程，每章配一个动手练习。
FirstMate 是一个「agent 发行版」（agent distro）：一个目录，里面装着指令、技能、脚本、规则和状态约定，能把一个通用的编码 agent 变成专门带队干活的 agent。你只跟一个 agent 说话，它就是大副 / firstmate。大副替你派出和监督一队船员 / crewmate，最后交给你可以合并的 PR、你批准过的本地合并，或者一份调研报告。
这个仓库不是 FirstMate 本身，是学它用的。每章讲一项功能：它解决什么问题、有哪些规矩，然后给一个你可以在自己的 FirstMate 上跑一遍的练习。读完做完，你就能在自己的项目上照着用。
教程里关于 FirstMate 的每一条说法，都能在 FirstMate 仓库里找到出处：AGENTS.md（大副的工作守则）、README.md、docs/ 下的文档，以及 bin/ 下脚本开头的注释。每章开头会说明这一章依据的是哪些文件。
每章两步：
- 读。 一章一个主题，一次能读完。哪里拿不准，就去翻这一章列出的原文。
- 练。 每章最后有「动手练习」，给出你（船长 / captain）可以直接对大副说的话，以及应该看到什么、怎么检查。练习都是只读或可以撤回的，不会改别人的仓库，也不会做收不回的操作。
最好按顺序读，后面的章节会用到前面讲过的概念。全书的术语译法统一收在 术语译法表 里。
第 1 章先讲全貌。第 2 到 5 章跟着一件活往下走，每章讲其中一步。第 6 到 8 章讲活多了以后的事：调研报告、待办队列、监督。第 9 到 11 章讲进阶话题：二副、离席、用什么工具跑船员。第 12 章讲 Relay，它默认关着，不打开就不影响你。
| # | 章节 | 讲什么 |
|---|---|---|
| 1 | FirstMate 是什么 | 船长、大副、船员各管什么，四条硬规矩，一件活从提出到合并要经过哪几步。 |
| 2 | 怎么提出一件活 | 一句话的要求怎么变成项目、任务类型、交付方式和验收标准都明确的任务。 |
| 3 | 船员与工作树 | 为什么每个船员有自己的工作树，几件活同时做为什么不打架，出事时怎么查。 |
| 4 | no-mistakes 质检流水线 | 流水线查什么、自己修什么，什么时候停下来问人，问到时大副怎么答。 |
| 5 | PR 与合并权限 | 为什么默认要你同意才合并，yolo 开关放开了什么，CI 没通过为什么不能合。 |
| 6 | 调研任务与报告 | 什么时候该先调研，报告放在哪里，为什么报告本身不等于同意动手改。 |
| 7 | 待办队列与船长决策 | 待办队列怎么记活，等你拍板的问题为什么也是一张工单，你的回答怎么关掉它。 |
| 8 | 监督与唤醒 | 大副怎么在不耗 token 的情况下盯住队伍，什么事会叫醒它，什么事才来找你。 |
| 9 | 二副与分派 | 队伍大了以后怎么按领域设常驻的二副，一件活怎么分派（routing）给谁，哪些活留在大副这边。 |
| 10 | 离席模式（afk） | 你走开时谁来监督，大副能自己做什么、必须等你什么，你回来时怎么交接。 |
| 11 | harness 与运行时后端 | 船员是用什么工具、在什么终端里跑的，默认怎么选，什么时候值得单独指定。 |
| 12 | Relay | 默认关着的公开提及功能，打开它等于同意了什么，哪些事它永远不会自己做。 |
参考资料不是章节，是某一天的调研快照，不配练习。里面的行号和数据只对应它当时读的版本。
- agent-skills 对 FirstMate 有没有用（2026-09-28）：
addyosmani/agent-skills的九个命令、六个阶段和 25 个 skill，按编排、交付验证、工程纪律、产品定义四层看它和 FirstMate 哪里重叠、互补、冲突，船员怎样在项目里挑着装这些 skill，和 Superpowers、Spec Kit、OpenSpec、Kiro、BMAD 等方案的对比，以及推荐做法。 - 先做哪个 AI 工具小网站（2026-09-29）：拿核实过的收入数据检验 2026 年「小工具赚钱」的说法，定选题标准和打分，约 27 个候选方向的淘汰理由，6 个入围方向的对比，以及推荐方向 AI 扒谱网站的关键词、竞品、MVP 范围、技术路线、单位经济、获客、风险和下一步。
- 命令与技能使用说明（2026-10-15）：
/afk、/quiet、/ahoy、/bearings（含file、lavish）、/stow、/updatefirstmate、/calm、/supervision-model各自做什么、什么时候用、有什么例子、自己绝不会做什么；你能调用的技能和大副专用技能各有哪些；以及把日常需求对应到命令的场景对照表。