---
title: 多步骤任务示例
description: 使用 Verdent 处理复杂的多步骤任务
---

Verdent for VS Code 擅长自主拆解复杂的多步骤任务。本指南为常见的多步骤场景提供分步工作流，准确展示 Verdent 如何处理任务分解、依赖管理和渐进式执行。

---

## 使用 Plan Mode 处理复杂实现

假设你希望在 Verdent 对代码库做任何更改之前先审查一份详细的计划。

<Steps>
  <Step title="切换到 Plan Mode">
    点击界面中的“切换模式”按钮，选择“Plan Mode”。

    Plan Mode 是只读的：Verdent 可以分析代码、开展调研并创建计划，而不会修改文件或执行命令。
  </Step>

  <Step title="提交你的复杂请求">
    ```
    Refactor this codebase to replace our custom authentication with OAuth 2.0
    ```

    Verdent 会全面分析你当前的实现。
  </Step>

  <Step title="回答澄清性问题">
    Verdent 可能会提出问题以消除不确定性：
    - 我们应该使用哪个 OAuth 提供商？
    - 令牌应存储在 localStorage 还是 cookies 中？
    - 我们是否需要支持多个 OAuth 提供商？

    回答这些问题以完善计划。
  </Step>

  <Step title="审查详细计划">
    Verdent 会呈现一份完整的计划，展示：
    - 将要创建的文件
    - 需要修改的现有文件
    - 按逻辑顺序排列的实现步骤
    - 各步骤之间的依赖关系

    在继续之前仔细审查这份计划。
  </Step>

  <Step title="选择你的下一步操作">
    审查完计划后，Verdent 会提供两个选项：
    - 选择 **Edit** 以请求修改或提出澄清性问题
    - 选择 **Start Building** 以切换到 Agent Mode 并开始执行

    在构建之前，你可以根据需要多次迭代该计划。
  </Step>
</Steps>

<Tip>
  **提示：**
  - 对于涉及多个文件的功能，使用 Plan Mode
  - 进行多轮计划审查以完善方案
  - 在执行前将计划保存到文件中，供团队讨论
  - Plan Mode 有助于确保你的预期与 Verdent 提出的方案保持一致
  - **自定义计划格式：** 进入 **Settings → Rules → Plan Rules** 以控制计划结构、详细程度和格式偏好
</Tip>

***

## 拆解大型功能请求

假设你正在构建一个包含多个集成组件的复杂电商结账系统。

<Steps>
  <Step title="提供高层目标">
    ```
    Build a complete checkout system with cart management, payment processing, order confirmation, and inventory updates
    ```

    Verdent 会分析需要完成哪些工作。
  </Step>

  <Step title="Verdent 创建逻辑子任务">
    系统会自主将其拆解为：
    1. 创建购物车数据模型和 API
    2. 构建带有添加/删除/更新商品功能的购物车 UI
    3. 实现带有收货地址表单的结账页面
    4. 集成支付网关（Stripe 或所配置的提供商）
    5. 创建订单确认页面
    6. 添加库存更新逻辑
    7. 实现邮件确认系统
    8. 编写集成测试

    每个子任务都会在待办列表中以清晰的描述显示。
  </Step>

  <Step title="Verdent 自动处理依赖关系">
    Verdent 会按正确的顺序执行子任务：
    - 在使用数据模型的 API 端点之前先创建数据模型
    - 在调用后端端点的前端组件之前先构建后端端点
    - 在添加测试之前先实现核心功能

    依赖关系会自动管理，无需手动干预。
  </Step>

  <Step title="实时监控进度">
    在 Verdent 处理每个子任务时，观察待办列表实时更新。待办项会从待处理 → 进行中 → 已完成进行流转。
  </Step>
</Steps>

<Tip>
  **提示：**
  - 对于大多数任务，让 Verdent 自主进行拆解
  - 如果你想在执行前审查拆解结果，可使用 Plan Mode
  - 当 Verdent 遇到边缘情况或新需求时，它会调整其方法
  - 可见的待办列表为多步骤执行提供了透明度
</Tip>

***

## 多阶段重构项目

假设你正在重构一个大型代码库，并希望以可管理的阶段来推进。

<Steps>
  <Step title="定义多阶段方案">
    ```
    In Plan Mode: Refactor this codebase to replace our custom authentication with OAuth 2.0. I want this done in phases so we can test incrementally.
    ```
  </Step>

  <Step title="Verdent 提出阶段拆解">
    Verdent 会建议一份多阶段计划：
    - **阶段 1**：添加 OAuth 库并配置端点
    - **阶段 2**：更新用户模型和数据库 schema
    - **阶段 3**：迁移现有的认证逻辑
    - **阶段 4**：移除已弃用的认证代码
    - **阶段 5**：更新测试和文档

    每个阶段都可独立测试。
  </Step>

  <Step title="逐阶段执行">
    批准阶段 1，让 Verdent 执行它，然后进行测试：

    ```
    npm test
    ```

    一旦验证阶段 1 正常工作，再进入阶段 2。
  </Step>

  <Step title="按需调整后续阶段">
    根据你在阶段 1 中的发现，你可以为剩余阶段调整方案：

    ```
    For Phase 2, let's also add user role migration to the database schema changes
    ```
  </Step>

  <Step title="逐步完成所有阶段">
    在每个阶段之间进行测试和验证，逐一完成所有阶段，确保安全并允许及时纠偏。
  </Step>
</Steps>

<Tip>
  **提示：**
  - 多阶段重构通过支持增量测试来降低风险
  - 每个阶段都应让代码库保持可运行状态
  - 每个阶段后提交一次，以便在需要时轻松回滚
  - 根据早期阶段的经验调整后续阶段
</Tip>

***

## 协调后端和前端的更改

假设你正在添加一个需要同步更新后端 API 和前端组件的功能。

<Steps>
  <Step title="描述全栈功能">
    ```
    Add a commenting system where users can add comments to blog posts. Include backend API, database schema, and frontend UI
    ```
  </Step>

  <Step title="Verdent 协调后端优先的方案">
    对于全栈功能，Verdent 通常采用后端优先的方式：
    1. 为评论表创建数据库迁移
    2. 添加创建评论的 API 端点
    3. 添加获取评论的 API 端点
    4. 为评论数据定义 TypeScript 接口
    5. 构建前端评论表单组件
    6. 创建评论展示组件
    7. 将前端连接到 API 端点
  </Step>

  <Step title="Verdent 确保一致性">
    Verdent 会确保：
    - 前端 TypeScript 接口与后端数据结构匹配
    - API 端点 URL 在前端代码中被正确引用
    - 请求/响应格式在后端和前端之间保持一致
    - 整个技术栈的错误处理保持一致
  </Step>

  <Step title="集成测试">
    ```
    Write integration tests for the commenting system covering the full stack
    ```

    Verdent 会创建测试，验证后端和前端能够正确协同工作。
  </Step>
</Steps>

<Tip>
  **提示：**
  - 后端优先的方式确保前端有可用的 API 可供集成
  - Verdent 会自动保持后端和前端代码之间的一致性
  - TypeScript 接口有助于在编译时捕获集成问题
  - 集成测试验证完整功能端到端正常工作
</Tip>

***

## 使用子智能体进行并行执行

假设你有多个可同时完成的独立任务。

<Steps>
  <Step title="识别可并行的任务">
    ```
    Generate unit tests for all service classes in the src/services directory
    ```

    这些测试文件相互独立，可以并行创建。
  </Step>

  <Step title="Verdent 委派给多个子智能体">
    Verdent 会自动使用多个子智能体并发处理独立任务：
    - 子智能体 1：为 UserService 创建测试
    - 子智能体 2：为 PaymentService 创建测试
    - 子智能体 3：为 NotificationService 创建测试
    - 子智能体 4：为 AuthService 创建测试

    所有工作并行进行，节省时间。
  </Step>

  <Step title="整合结果">
    每个子智能体都会返回其结果。Verdent 会将所有测试文件以适当的命名和结构整合到项目中。
  </Step>

  <Step title="顺序验证">
    并行创建完成后，顺序运行测试以验证它们都正常工作：

    ```
    npm test
    ```
  </Step>
</Steps>

<Tip>
  **提示：**
  - Verdent 会使用子智能体自动并行处理独立任务
  - 松耦合的工作（独立的测试文件、互不依赖的组件）能从并行化中受益
  - 紧耦合的工作（存在依赖关系的文件）会顺序执行以保证正确性
  - 并行执行能显著加快大规模更改的速度
</Tip>

***

## 常见问题

<Accordion title="我可以在多步骤任务进行到一半时停止 Verdent 吗？">
可以。你可以随时中断执行。Verdent 会完成它当前正在处理的步骤，然后停止。到那一刻为止的进度都会被保留。你可以审查已完成的工作、进行调整，然后选择继续或采用不同的方案。
</Accordion>

<Accordion title="在长任务中，我如何知道 Verdent 当前正在做什么？">
观察待办列表。它会显示实时状态，任意时刻都有一项被标记为“进行中”。当前活动项准确显示 Verdent 正在处理的内容。已完成的项目被标记为完成，待处理的项目则显示尚未完成的工作。
</Accordion>

<Accordion title="如果我不认同 Verdent 拆解任务的方式怎么办？">
使用 Plan Mode 在执行前审查并调整拆解结果。在 Plan Mode 中，你可以提供反馈，例如“将前端工作拆分为独立组件”或“合并这两个步骤”。Verdent 会在编写任何代码之前根据你的输入修订计划。
</Accordion>

<Accordion title="我应该为每个多步骤任务都使用 Plan Mode 吗？">
不一定。对于影响许多文件的复杂功能、大型重构，或当你想先审查方案时，使用 Plan Mode。对于熟悉、直接的任务，Verdent 可以借助实时待办列表的可见性直接执行。Plan Mode 为风险较高的更改增加了一个审查环节。
</Accordion>

<Accordion title="执行开始后，我还能修改 Verdent 的计划吗？">
你可以在 Verdent 工作时提供纠正性指导。比如说“其实，API 集成请用另一种方法”，Verdent 就会调整剩余的步骤。对于重大的计划变更，更好的做法是停止、提交已完成的工作，然后用修订后的方案开启一个新会话。
</Accordion>

***

## 另请参阅

<CardGroup cols={2}>
  <Card title="编写新代码" icon="code" href="/docs/verdent-for-vscode/task-based-guides/writing-code">
    使用 Verdent 创建新功能和组件
  </Card>

  <Card title="最佳实践" icon="star" href="/docs/verdent-for-vscode/best-practices/prompts">
    高效的提示词与工作流策略
  </Card>
</CardGroup>