终端 Gemini 仓库分析编辑与命令循环

解决的问题

很多仓库分析流程依赖带 GUI 的客户端或浏览器，任务一开始就被上下文切换打断：代码在本地，工具在网页上，结论又得手动抄回终端。另一种常见做法是让模型只看静态快照，文件改完不知道命令是否真的能跑，改一轮就要重新截图对齐。这类割裂在重复性仓库排查里尤其消耗时间。

这个技能把 Gemini 拉进终端，让仓库分析、文件编辑和命令循环在同一个 CLI 工作流里完成，所有动作都发生在你正工作的目录上下文中。

它如何工作

核心是让代理在本地终端里调用 gemini-cli，围绕当前仓库执行一组紧密衔接的动作：

• 仓库检查：读取项目结构与相关文件，把仓库内容当作本地上下文来理解，而不是上传一份脱敏后的摘要。
• 文件编辑：直接修改工作区中的目标文件，改动落盘后立即生效。
• 命令循环：运行 shell 命令验证行为，根据输出决定是否继续编辑或回退，形成「观察—修改—再验证」的闭环。
• 本地上下文锚定：借助内置搜索能力把当前仓库的代码与本地上下文带入会话，让分析和修改有据可依。

这样的组合让代理不止于「读代码」，还能在有边界的 CLI 工作流里完成一轮带验证的修改，而不是产出一份无法确认是否可用的补丁建议。

适用边界

• 它运行在终端环境中，工作流的边界由 CLI 会话本身约束，不适合需要多窗口并行或重型可视化调试的场景。
• 仓库检查、编辑和命令执行的可信度取决于当前目录状态与命令权限；涉及破坏性命令时仍需要人工确认。
• 接入前需要准备好 Node.js 或 npm 环境、gemini-cli，以及可用的 Gemini 账户或 API 凭据；凭据缺失时流程会停在真正开始之前。
• 官方文档见 https://geminicli.com，上游文档是理解各项行为细节的主要来源。