mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-13 02:41:50 +08:00
6993677ed9
- Introduced command-relationships.json to define relationships between various commands. - Created essential-commands.json to provide detailed descriptions and usage scenarios for key commands. - Implemented update-index.sh script for maintaining command index files, including backup and validation processes. - Added templates for bug reports, feature requests, and questions to streamline issue reporting and feature suggestions.
65 lines
4.3 KiB
Markdown
65 lines
4.3 KiB
Markdown
# CLI 智能工具指南
|
||
|
||
Gemini CLI 能够集成多种智能工具（如大型语言模型 LLM），以增强您的开发工作流。本指南将帮助您理解这些智能工具如何工作，以及如何有效地利用它们。
|
||
|
||
## 1. 什么是智能工具？
|
||
|
||
智能工具是集成到 Gemini CLI 中的高级 AI 模型，它们能够理解自然语言、分析代码、生成文本和代码，并协助完成复杂的开发任务。它们就像您的智能助手，可以自动化重复性工作，提供洞察，并帮助您做出更好的决策。
|
||
|
||
## 2. 核心工作原理
|
||
|
||
Gemini CLI 中的智能工具遵循以下核心原则：
|
||
|
||
- **上下文感知**: 工具会理解您当前的项目状态、代码内容和开发意图，从而提供更相关的建议和操作。这意味着它们不会“凭空”回答问题，而是基于您的实际工作环境提供帮助。
|
||
- **模块化**: 智能工具被设计为可互换的后端。您可以根据任务需求选择或组合不同的 LLM。例如，某些模型可能擅长代码生成，而另一些则擅长复杂推理。
|
||
- **自动化与增强**: 智能工具可以自动化重复或复杂的任务（如生成样板代码、基础重构、测试脚手架），并通过提供智能建议、解释和问题解决协助来增强您的开发能力。
|
||
- **用户控制与透明**: 您始终对工具的操作拥有最终控制权。工具会清晰地解释其建议的更改，并允许您轻松审查和修改。工具的选择和执行过程也是透明的。
|
||
|
||
详情可参考 `../../workflows/intelligent-tools-strategy.md`。
|
||
|
||
## 3. 智能工具的应用场景
|
||
|
||
智能工具被集成到 CLI 工作流的多个关键点，以提供全面的帮助：
|
||
|
||
- **提示增强**: 优化您的输入提示，使智能工具更好地理解您的需求。
|
||
- **命令**: `enhance-prompt`
|
||
- **代码分析与审查**: 快速洞察代码，识别潜在问题，并提出改进建议。
|
||
- **命令**: `analyze`, `chat`, `code-analysis`, `bug-diagnosis`
|
||
- **规划与任务分解**: 协助将复杂问题分解为可管理的小任务，并生成实施计划。
|
||
- **命令**: `plan`, `discuss-plan`, `breakdown`
|
||
- **代码生成与实现**: 根据您的规范生成代码片段、函数、测试甚至整个模块。
|
||
- **命令**: `execute`, `create`, `codex-execute`
|
||
- **测试与调试**: 生成测试用例，诊断错误，并建议修复方案。
|
||
- **命令**: `test-gen`, `test-fix-gen`, `tdd-plan`, `tdd-verify`
|
||
- **文档生成**: 自动化代码、API 和项目模块的文档创建。
|
||
- **命令**: `docs`, `skill-memory`, `update-full`, `update-related`
|
||
- **工作流编排**: 智能选择和协调工具与代理来执行复杂的工作流。
|
||
- **命令**: `workflow:status`, `resume`, `plan`, `execute` (工作流级别)
|
||
|
||
## 4. 如何选择和使用工具
|
||
|
||
Gemini CLI 允许您使用 `--tool` 标志来指定用于特定操作的智能工具。这为您提供了灵活性，可以根据任务的性质选择最合适的模型。
|
||
|
||
- `--tool codex`: 优先使用 Codex（或兼容的专注于代码的 LLM）。非常适合精确的代码生成、重构和类似 linting 的任务。
|
||
- **何时使用**: 当您需要生成高质量代码、进行代码审查或修复代码错误时。
|
||
- `--tool gemini`: 优先使用 Gemini（或兼容的通用 LLM）。擅长复杂的推理、更广泛的分析、规划和自然语言理解任务。
|
||
- **何时使用**: 当您需要进行高层次的规划、理解复杂概念或进行广泛的代码库分析时。
|
||
- `--tool qwen`: 优先使用 Qwen（或兼容的特定领域/语言 LLM）。适用于需要专业知识或特定语言支持的任务。
|
||
- **何时使用**: 当您的项目涉及特定技术栈或需要特定语言的专业知识时。
|
||
- **(默认/自动)**: 如果未指定工具，CLI 会根据任务上下文和可用配置智能地选择最合适的工具。
|
||
|
||
**示例**:
|
||
|
||
```bash
|
||
# 使用 Gemini 进行项目规划
|
||
gemini plan --tool gemini "设计一个新的微服务架构"
|
||
|
||
# 使用 Codex 生成代码
|
||
gemini execute --tool codex "task-id-for-code-generation"
|
||
|
||
# 使用 Qwen 分析特定领域的代码
|
||
gemini analyze --tool qwen "分析医疗数据处理模块"
|
||
```
|
||
|
||
通过理解这些智能工具及其用法，您可以更有效地利用 Gemini CLI，加速您的开发过程。
|