用途
Gemini Tools 面向需要以脚本化、可重复方式调用 Gemini CLI 内置工具的用户。它把文件操作、网页搜索、Shell 执行和记忆四类工具组织成可复用的执行模式，用于自动化工作流、批量处理与项目维护。
主要能力
文件系统工具
- 列出目录内容：
gemini -p "List all Python files in ./src" - 读取文件：
gemini -p "Read and explain @./config.json" - 写入文件：
gemini --yolo -p "Create a README.md for this project" - 修改文件：
gemini --sandbox -p "Add error handling to @./main.py"
网页工具
- Google 搜索：
gemini --yolo -p "Search for React performance optimization best practices" - 抓取网页内容：
gemini -p "Analyze the API documentation at @https://api.example.com/docs" - 研究流程：
gemini --yolo -p "Research and summarize the latest Python 3.12 features"
Shell 执行
- 带确认的安全执行：
gemini -p "Run the test suite and fix any failing tests" - 自动批准：
gemini --yolo -p "Set up a new Next.js project with TypeScript" - 沙箱模式：
gemini --sandbox -p "Install dependencies and run the build"
记忆工具
- 保存信息：
gemini -p "Remember that the API endpoint is https://api.prod.example.com" - 回忆信息：
gemini -p "What API endpoint did I tell you about?" - 项目级记忆：
cd project && gemini -p "Save project configuration: Node 20, PostgreSQL 15, Redis 7"
使用方式
执行模式
- 手动审批（默认）：每次工具调用都需要确认。
- YOLO 模式（自动批准）：所有工具自动执行，聊天中可用 Ctrl+Y 切换。
- 沙箱模式：创建隔离环境，限制系统修改、文件访问和生产网络请求。
YOLO 自动化模式
适合可信、可重复的低风险操作，例如整理项目文件、为函数添加 JSDoc 注释、生成测试套件、从代码注释生成文档、配置 ESLint/Prettier/pre-commit、从 JavaScript 生成 TypeScript 定义。较高风险操作（重构认证系统、迁移数据库结构、更新生产部署配置、删除未使用文件）建议先审查再执行。可结合 --checkpointing 或 git stash 备份使用。
工具工作流示例
- 项目初始化：
setup_project函数按类型创建目录结构、配置文件、Git 初始化、README、CI/CD、Docker、环境变量模板和初始测试。 - 代码生成流水线：从规格文件生成数据模型、API 端点、数据库迁移、单元测试、集成测试和 API 文档。
- 文件整理：分析目录、创建结构、移动文件、更新导入路径、生成索引和变更日志。
- 批量处理：对匹配模式的文件执行添加类型提示、转换为 TypeScript、修复格式等操作。
安全模式
- 执行前验证：先分析风险、依赖、破坏性变更和安全问题，再决定是否执行。
- 回滚能力：执行前备份，失败时恢复。
- 工具限制：通过
~/.gemini/tool-policy.json配置 Shell、文件系统、网页和记忆工具的启用状态、确认要求、允许/阻止的命令、路径和域名。
高级模式
- 工具链：搜索、阅读、总结、生成代码、保存文档、创建测试、运行测试、修复问题。
- 条件执行：根据 package.json 是否存在执行不同分支。
- 并行执行：同时进行代码质量、安全和性能分析并合并报告。
监控与日志
- 工具使用跟踪：记录每次调用的耗时、参数和工具调用次数。
- 审计轨迹：执行前后生成文件 MD5 清单并对比差异。
错误处理
- 优雅失败：最多重试 3 次。
- 恢复策略：失败后识别问题、修复并安全完成操作。
适用场景
- 自动化项目初始化与脚手架搭建
- 从规格生成代码、测试和文档
- 批量文件处理与代码现代化
- 代码审查、安全扫描与性能分析
- 需要审计和回滚能力的受控自动化
限制
- 沙箱模式不支持系统修改、文件访问受限、禁止对生产环境的网络请求。
- YOLO 模式自动执行所有工具，存在风险，需谨慎使用。
- 工具策略文件的具体字段和默认值以实际版本为准，资料未提供完整默认配置说明。
- 相关技能包括 gemini-cli、gemini-auth、gemini-chat、gemini-mcp，资料未提供其详细内容。