FirstMate：助手工作组、持久证据与交付授权
FirstMate 首次试用：先检查固定版本，再发起受限调查
准备隔离试用，区分检出源码与加载可信钩子，并在允许项目修改之前定义只读调查。
你将学会
- 第一次信任并启动助手之前先检查
- 让第一个任务只回答一个调查问题
- 用可检查的证据验收报告
开始前需要
- 理解 Git 工作树与拉取请求
- 理解终端助手和凭据权限范围
定义交付约定，检查状态与授权证据，并避免宣称未经验证的运行保证。
先看结论
- 启动宿主可能加载仓库钩子与扩展。
- 首次 scout 应只有受限问题，不授予项目写权限。
- 报告必须可访问，并能追溯到源码路径。
第一次信任并启动助手之前先检查
上游快速开始先克隆仓库，再在其中启动支持的助手。后一步具有实际影响：仓库指令、扩展或钩子可能按照宿主规则被加载。应先在助手会话之外检查固定版本，理解哪些代码会运行，以及所选宿主能够访问哪些凭据。
示例命令把固定提交检出到一个新命名目录并打印版本。它不会认证 GitHub CLI、安装依赖、启动助手或信任项目钩子。请选择不存在同名目录的临时试用位置。本次审阅没有执行这套安装命令，不能把命令展示当作安装验证。
让第一个任务只回答一个调查问题
独立准备好支持的 macOS 或 Linux 环境后，可以对一次性示例仓库发起 scout。写清一个问题、报告形式及禁止的修改。例如，要求找出测试夹具的加载入口，给出源码路径和未解决疑问；不要同时附加“发现问题就全部修复”。
记录任务标识、有效 home、后端端点和报告位置，启动前确认调查约定。如果成员建议修改项目，应暂停并判断是否另开 ship 任务。首次试用的价值是验证范围边界，而不是比较一次启动了多少助手。
用可检查的证据验收报告
对照示例仓库阅读报告，检查引用路径是否存在、结论是否回答问题，以及不确定性是否明确保留。再查看仓库状态，确认没有意外修改。只有口头宣称调查成功却无法取得报告，不能算完成 scout 的交付。
第一次运行不要同时测试重启恢复、远程二副和公开 Relay。先让基础流程可用，再逐项增加能力。我们的源码审阅没有认证你正在使用的宿主版本或钩子安装；上游关于支持情况的说明，在复现之前仍只是上游证据。
如何选择
| 比较维度 | 方案 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
在一次性项目中请求一个 scout。
- 4
核对报告与项目工作区状态。
可复制示例
git clone --no-checkout https://github.com/kunchenguid/firstmate firstmate-review-b182d0f
git -C firstmate-review-b182d0f checkout --detach b182d0f908b78d08c7ccb8dce3775bdca8c5d657
git -C firstmate-review-b182d0f rev-parse HEAD常见问题
克隆仓库就会启动工作组吗？
不会。启动及信任所选宿主是另一步操作。
首次试用就应开启远程助手吗？
建议先验证本地基础流程及边界，再增加远程操作。
资料来源
- FirstMate / README.md来源核查 2026-09-14
- FirstMate / docs/architecture.md来源核查 2026-09-14