FirstMate：助手工作组、持久证据与交付授权
FirstMate 是什么：用明确交付约定组织多个编码助手
理解代理发行目录、ship 与 scout 任务，以及可见终端、持久状态和合并权限之间的区别。
你将学会
- 让现有助手承担协调工作的目录
- 先确定交付物，再选择任务类型
- 可见、可恢复与获授权并不相同
开始前需要
- 理解 Git 工作树与拉取请求
- 理解终端助手和凭据权限范围
定义交付约定，检查状态与授权证据，并避免宣称未经验证的运行保证。
先看结论
- FirstMate 组织现有助手，而非提供模型。
- 调查报告与项目修改拥有不同授权范围。
- 可见、被接受与真正完成是不同状态。
让现有助手承担协调工作的目录
FirstMate 把指令、辅助脚本、技能和状态约定放在终端编码助手周围。固定提交 b182d0f 的 README 将它称为 agent distro，而不是模型、运行宿主、MCP 服务或独立命令行产品。主助手负责协调工作组，仓库提供运行环境，并不提供新的推理引擎。
例如，一个成员调查偶发失败的测试，另一个实现互不相关的界面改动。独立工作树把检出目录分开，可见的后端会话方便操作者检查。但这不能消除集成冲突：两项修改合并时仍可能对同一个接口形成不一致的假设。
先确定交付物，再选择任务类型
ship 任务交付获得授权的项目修改，scout 任务则在私有 data 目录留下独立调查报告，不应推送项目改动。因此，选择 scout 是有意义的范围限制，并非执行较慢的 ship。调查结论可以支持后续实施决策，却不会提前授予实施权限。
交付模式是另一个维度。架构文档区分 no-mistakes 验证流程、direct-PR 交付，以及通过获批快进合并完成的 local-only 流程。这些名称描述流程而非确定性：no-mistakes 不保证绝无错误，local-only 也不意味着成员可以自行合并。
可见、可恢复与获授权并不相同
终端存在时，里面的助手仍可能失去响应；唤醒事件已写入时，也可能尚无人消费；合并请求被平台接受后，还可能没有真正落地。FirstMate 对这些情况保留不同观察，操作者的进度报告也应保留区别，而不是一律写成“已完成”。
本系列审阅固定版本文档和一个合并授权源码文件，并提供可执行的 JavaScript 身份匹配教学模型。它不是完整 Shell 系统的移植。本次没有启动真实工作组，也没有执行代码托管平台合并、SSH 二副部署或助手恢复测试。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
选择任务类型前写明交付物。
- 2
明确交付模式和合并授权姿态。
- 3
定义宣布完成所需的证据。
可复制示例
{
"示例": true,
"任务类型": "scout",
"交付物": "调查报告",
"授权项目写入": false,
"已测试真实工作组": false
}常见问题
FirstMate 是 MCP 服务吗？
不是。README 将其定义为由现有终端助手使用的代理发行目录。
独立工作树能避免所有冲突吗？
不能。它隔离检出目录，集成和共享资源冲突仍需审查。
资料来源
- FirstMate / README.md来源核查 2026-09-14
- FirstMate / docs/architecture.md来源核查 2026-09-14
- FirstMate / docs/configuration.md来源核查 2026-09-14