Gemini CLI:规则与边界
规则分层
- GEMINI.md 或等价 context files 是它进入 repo 的主要长期资产。
- 这些 context files 应该只写 repo 级规则,不要把一次性任务说明也长期固化进去。
- 如果仓库里同时存在多种指令文件,必须定义它们的职责边界。
状态与记忆边界
- 更偏向 repo context files 和当前任务上下文,而不是复杂的长期个体记忆。
- 适合把稳定规则版本化,而不是让用户每次重述。
规则与边界矩阵
| 边界层 | 应该放什么 | 不要放什么 |
|---|---|---|
| 入口规则 | GEMINI.md 或等价 context files 是它进入 repo 的主要长期资产。 | 这些 context files 应该只写 repo 级规则,不要把一次性任务说明也长期固化进去。 |
| 状态与记忆 | 更偏向 repo context files 和当前任务上下文,而不是复杂的长期个体记忆。 | 适合把稳定规则版本化,而不是让用户每次重述。 |
| 执行边界 | 终端命令、仓库上下文文件和脚本化任务。 | 更适合与 GitHub/CI 组合,而不是单独承担全部工作流。 |
| 仓库合同 | 先写一版最小 GEMINI.md,只保留目录边界、验证命令和禁止事项。 | 保持 context files 简洁,否则很快变成无人维护的大块说明。 |
写进 repo
- 先写一版最小 GEMINI.md,只保留目录边界、验证命令和禁止事项。
- 保持 context files 简洁,否则很快变成无人维护的大块说明。
- 把验证命令写成脚本,减少不同终端入口之间的语义漂移。
团队检查
- 先定义哪些规则必须版本化留在 repo,哪些只属于 Gemini CLI 的入口习惯。
- 任何长期状态都必须能解释 owner、刷新时机和失效条件。
- 执行边界要能回到真实命令、diff 和 PR 证据,而不是只剩界面内的一句“完成了”。
- 先写一版最小 GEMINI.md,只保留目录边界、验证命令和禁止事项。
下一步
- GitHub Copilot:Gemini CLI 做本地终端入口,GitHub 负责 PR 与 review。
- Spec Kit:Spec 定稿后可用 Gemini CLI 接手执行与验证。
- Superpowers:需要更重的日常操作方法时可以叠加。
- Gemini CLI:集成、review 与治理:如果你已经进入真实工作系统,需要把 review、PR、CI 和责任边界收口,就继续看这页。