mirror of
https://github.com/catlog22/Claude-Code-Workflow.git
synced 2026-02-14 02:42:04 +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.
101 lines
5.4 KiB
Markdown
101 lines
5.4 KiB
Markdown
# 常见工作流模式
|
||
|
||
Gemini CLI 不仅提供单个命令，更能通过智能编排将一系列命令组合成强大的工作流，帮助您高效完成复杂任务。本指南将介绍几种常见的工作流模式。
|
||
|
||
## 1. 工作流核心概念
|
||
|
||
在深入了解具体模式之前，理解工作流的架构至关重要。Gemini CLI 的工作流管理系统旨在提供一个灵活、可扩展的框架，用于定义、执行和协调复杂的开发任务。
|
||
|
||
- **工作流 (Workflows)**：一系列任务的组合，旨在实现特定的开发目标。
|
||
- **任务 (Tasks)**：工作流中的独立工作单元，可以简单也可以复杂，有状态、输入和输出。
|
||
- **智能体 (Agents)**：通常由大型语言模型驱动，负责执行任务或在工作流中做出决策。
|
||
- **上下文 (Context)**：当前工作流的相关动态信息，包括项目状态、代码片段、文档、用户输入等，是智能决策的关键。
|
||
- **记忆 (Memory)**：持久存储上下文、工作流历史和学习模式，支持工作流的恢复、适应和改进。
|
||
|
||
详情可参考 `../../workflows/workflow-architecture.md`。
|
||
|
||
## 2. 规划 -> 执行 (Plan -> Execute) 模式
|
||
|
||
这是最基础也是最常用的工作流模式，它将一个大的目标分解为可执行的步骤，并逐步实现。
|
||
|
||
**场景**: 您有一个需要从头开始实现的新功能或模块。
|
||
|
||
**主要命令**:
|
||
- `plan`: 启动高级规划过程，分解目标。
|
||
- `breakdown`: 进一步细化和分解 `plan` 生成的任务。
|
||
- `create`: 创建具体的实施任务。
|
||
- `execute`: 执行创建好的任务以实现代码或解决方案。
|
||
|
||
**工作流示例**:
|
||
1. **启动规划**: `gemini plan "开发一个用户认证服务"`
|
||
- CLI 会与您互动，明确需求，并生成一个初步的规划（可能包含多个子任务）。
|
||
2. **任务分解** (可选，如果规划足够细致可跳过):
|
||
- 假设 `plan` 产生了一个任务 ID `task-auth-service`。
|
||
- `gemini breakdown task-auth-service`
|
||
- 可能进一步分解为 `task-register`, `task-login`, `task-password-reset`等。
|
||
3. **创建具体实现任务**:
|
||
- `gemini create "实现用户注册 API 接口"`
|
||
- 这会生成一个专门针对此任务的 ID，例如 `task-id-register-api`。
|
||
4. **执行实现任务**:
|
||
- `gemini execute task-id-register-api`
|
||
- CLI 将调用智能体自动编写和集成代码。
|
||
|
||
## 3. 测试驱动开发 (TDD) 模式
|
||
|
||
TDD 模式强调先编写测试，再编写满足测试的代码，然后重构。Gemini CLI 通过自动化 TDD 流程来支持这一模式。
|
||
|
||
**场景**: 您正在开发一个新功能，并希望通过 TDD 确保代码质量和正确性。
|
||
|
||
**主要命令**:
|
||
- `tdd-plan`: 规划 TDD 工作流，生成红-绿-重构任务链。
|
||
- `test-gen`: 根据功能描述生成测试用例。
|
||
- `execute`: 执行代码生成和测试。
|
||
- `tdd-verify`: 验证 TDD 工作流的合规性并生成质量报告。
|
||
|
||
**工作流示例**:
|
||
1. **TDD 规划**: `gemini tdd-plan "实现一个购物车功能"`
|
||
- CLI 将为您创建一个 TDD 任务链，包括测试生成、代码实现和验证。
|
||
2. **生成测试**: (通常包含在 `tdd-plan` 的早期阶段，或可以单独调用)
|
||
- `gemini test-gen source-session-id` (如果已有一个实现会话)
|
||
- 这会产生失败的测试（红）。
|
||
3. **执行代码实现和测试**:
|
||
- `gemini execute task-id-for-code-implementation`
|
||
- 智能体会编写代码以通过测试，并将执行测试（变为绿）。
|
||
4. **TDD 验证**: `gemini tdd-verify`
|
||
- 验证整个 TDD 周期是否规范执行，以及生成测试覆盖率等报告。
|
||
|
||
## 4. UI 设计与实现工作流
|
||
|
||
Gemini CLI 可以辅助您进行 UI 的设计、提取和代码生成，加速前端开发。
|
||
|
||
**场景**: 您需要基于一些设计稿或现有网站来快速构建 UI 原型或实现页面。
|
||
|
||
**主要命令**:
|
||
- `ui-designer`: 启动 UI 设计分析。
|
||
- `layout-extract`: 从参考图像或 URL 提取布局信息。
|
||
- `style-extract`: 从参考图像或 URL 提取设计风格。
|
||
- `generate`: 组合布局和设计令牌生成 UI 原型。
|
||
- `update`: 使用最终设计系统参考更新设计产物。
|
||
|
||
**工作流示例**:
|
||
1. **启动 UI 设计分析**: `gemini ui-designer`
|
||
- 开始一个引导式的流程，定义您的 UI 设计目标。
|
||
2. **提取布局**: `gemini layout-extract --urls "https://example.com/some-page"`
|
||
- 从给定 URL 提取页面布局结构。
|
||
3. **提取样式**: `gemini style-extract --images "./design-mockup.png"`
|
||
- 从设计图中提取颜色、字体等视觉风格。
|
||
4. **生成 UI 原型**: `gemini generate --base-path ./my-ui-project`
|
||
- 结合提取的布局和样式，生成可工作的 UI 代码或原型。
|
||
5. **更新与迭代**: `gemini update --session ui-design-session-id --selected-prototypes "proto-01,proto-03"`
|
||
- 根据反馈和最终设计系统，迭代并更新生成的 UI 产物。
|
||
|
||
## 5. 上下文搜索策略
|
||
|
||
所有这些工作流都依赖于高效的上下文管理。Gemini CLI 采用多层次的上下文搜索策略，以确保智能代理获得最相关的信息。
|
||
|
||
- **相关性优先**: 优先收集与当前任务直接相关的上下文，而非大量数据。
|
||
- **分层搜索**: 从最直接的来源（如当前打开文件）开始，逐步扩展到项目文件、记忆库和外部资源。
|
||
- **语义理解**: 利用智能搜索理解查询的意图，而非仅仅是关键词匹配。
|
||
|
||
更多细节请查阅 `../../workflows/context-search-strategy.md`。
|