# 5分钟快速上手指南

欢迎来到 Gemini CLI！本指南将帮助您快速了解核心命令，并通过一个简单的工作流示例，让您在5分钟内开始使用。

## 1. Gemini CLI 简介

Gemini CLI 是一个强大的命令行工具，旨在通过智能代理和自动化工作流，提升您的开发效率。它能够帮助您进行代码分析、任务规划、代码生成、测试以及文档编写等。

## 2. 核心命令速览

以下是一些您将频繁使用的核心命令：

### `version` - 查看版本信息
- **用途**: 检查当前 CLI 版本并获取更新信息。
- **示例**:
  ```bash
  gemini version
  ```

### `enhance-prompt` - 智能提示增强
- **用途**: 根据当前会话记忆和代码库分析，智能地优化您的输入提示，让代理更好地理解您的意图。
- **示例**:
  ```bash
  gemini enhance-prompt "如何修复这个bug？"
  ```

### `analyze` - 快速代码分析
- **用途**: 使用 CLI 工具（如 Codex, Gemini, Qwen）对代码库进行快速分析，获取洞察。
- **示例**:
  ```bash
  gemini analyze "分析 src/main.py 中的性能瓶颈"
  ```

### `chat` - 交互式对话
- **用途**: 与 CLI 进行简单的交互式对话，直接进行代码分析或提问。
- **示例**:
  ```bash
  gemini chat "解释一下 UserService.java 的主要功能"
  ```

### `plan` - 项目规划与架构分析
- **用途**: 启动项目规划和架构分析工作流，帮助您将复杂问题分解为可执行的任务。
- **示例**:
  ```bash
  gemini plan "实现用户认证模块"
  ```

### `create` - 创建实现任务
- **用途**: 根据上下文创建具体的实现任务。
- **示例**:
  ```bash
  gemini create "编写用户注册接口"
  ```

### `execute` - 自动执行任务
- **用途**: 自动执行实现任务，智能地推断上下文并协调代理完成工作。
- **示例**:
  ```bash
  gemini execute "task-id-123"
  ```

## 3. 第一个工作流示例：规划与执行一个简单任务

让我们通过一个简单的例子来体验 Gemini CLI 的工作流：**规划并实现一个“Hello World”函数**。

1.  **规划任务**:
    首先，我们使用 `plan` 命令来规划我们的“Hello World”功能。
    ```bash
    gemini plan "实现一个打印 'Hello World!' 的 Python 函数"
    ```
    CLI 将会启动一个规划工作流，可能会询问您一些问题，并最终生成一个或多个任务。

2.  **创建具体任务**:
    假设 `plan` 命令为您生成了一个任务 ID，或者您想手动创建一个任务。
    ```bash
    gemini create "编写 Python 函数 `say_hello` 打印 'Hello World!'"
    ```
    这个命令会创建一个新的任务，并返回一个任务 ID。

3.  **执行任务**:
    现在，我们使用 `execute` 命令来让 CLI 自动完成这个任务。请将 `your-task-id` 替换为上一步中获得的实际任务 ID。
    ```bash
    gemini execute "your-task-id"
    ```
    CLI 将会调用智能代理，根据任务描述生成代码，并尝试将其写入文件。

通过这三个简单的步骤，您就完成了一个从规划到执行的完整工作流。

## 4. 接下来做什么？

- 探索更多命令：使用 `gemini help` 查看所有可用命令。
- 查阅其他指南：深入了解工作流模式、CLI 工具使用和故障排除。
- 尝试更复杂的任务：挑战自己，使用 Gemini CLI 解决实际项目中的问题。

祝您使用愉快！