catlog22/Claude-Code-Workflow
1
0
Fork 0
mirror of https://github.com/catlog22/Claude-Code-Workflow.git synced 2026-02-13 02:41:50 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
958567e35a833d761ac94eb67b27c7c97ceac4a7
Claude-Code-Workflow/.claude/skills/command-guide/guides/workflow-patterns.md
catlog22 6993677ed9 feat: Add command relationships and essential commands JSON files 
- 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.
2025-11-06 12:59:14 +08:00

5.4 KiB
Raw Blame History

常见工作流模式

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。

Reference in New Issue View Git Blame Copy Permalink