AgentSkillsCN

gemini-cli

将 Google 的 Gemini CLI 作为强大的辅助工具，用于代码生成、代码审查、代码分析以及网络研究。当任务需要第二重 AI 视角、借助 Google 搜索获取最新网络信息、分析代码库架构，或同时进行代码生成时，可使用此技能。此外，当用户明确请求 Gemini 的相关操作时，也可使用此技能。

SKILL.md
--- frontmatter
name: gemini-cli
description: Wield Google's Gemini CLI as a powerful auxiliary tool for code generation, review, analysis, and web research. Use when tasks benefit from a second AI perspective, current web information via Google Search, codebase architecture analysis, or parallel code generation. Also use when user explicitly requests Gemini operations.
allowed-tools:
  - Bash
  - Read
  - Write
  - Grep
  - Glob

Gemini CLI Skill Guide

When to Use Gemini

Use CaseWhy Gemini
Current web informationgoogle_web_search - real-time Google Search
Codebase architecture analysiscodebase_investigator - deep analysis tool
Second opinion / code reviewDifferent AI perspective catches different bugs
Parallel code generationOffload tasks while continuing other work

When NOT to use: Simple quick tasks (overhead not worth it), interactive refinement, context already understood.

Running a Task

  1. •Verify installation: command -v gemini
  2. •Select the mode required for the task; default to read-only (no --yolo) unless edits are necessary.
  3. •Always use AskUserQuestion before using --yolo or -s flags. These modes allow file writes or sandboxed execution - get explicit user approval first.
  4. •Assemble the command with appropriate options:
    • •-m, --model <MODEL> - Model selection
    • •-y, --yolo - Auto-approve all tool calls (enables writes)
    • •-s, --sandbox - Run in Docker isolation
    • •-o, --output-format <text|json> - Output format
  5. •Important: gemini "prompt" -o json 2>/dev/null | jq -r '.response' to suppress stderr noise and extract the json response, unless specified by the user.

Critical Note

YOLO mode does NOT prevent planning prompts. Use forceful language: "Apply now", "Start immediately", "Do this without asking for confirmation".

Quick Reference

Use caseModeCommand pattern
Read-only analysisread-onlygemini "..." -o json 2>/dev/null | jq -r '.response'
Apply local editswritegemini "..." --yolo -o json 2>/dev/null | jq -r '.response'
Sandboxed writesandboxgemini "..." --yolo --sandbox -o json 2>/dev/null | jq -r '.response'

Example Commands

bash
# Read-only
gemini "Review src/ for bugs" -o json 2>/dev/null | jq -r '.response'

# Write mode
gemini "Fix bug in file.py. Apply now." --yolo -o json 2>/dev/null | jq -r '.response'

# If redirection fails, wrap in bash -lc
bash -lc 'gemini "prompt" -o json 2>/dev/null | jq -r ".response"'

Following Up

  • •Resume: echo "follow-up" | gemini -r latest -o json 2>/dev/null | jq -r '.response'
  • •List sessions: gemini --list-sessions

Error Handling

  • •Rate limit: CLI auto-retries with backoff. Use -m gemini-2.5-flash for lower priority tasks.
  • •Command failure: Check with gemini --version, use --debug for details.
  • •Always validate Gemini's output for security vulnerabilities (XSS, injection) before using.