对于复杂的开发任务，直接让 AI 生成代码往往会导致需求遗漏、实现不完整或代码质量不佳等问题。Visual Studio Code 引入的Plan Agent（计划代理）和Todo List（任务列表）功能，为这一问题提供了系统化的解决方案。
本文将深入探讨这两项功能的工作原理、使用场景以及最佳实践，帮助开发者更高效地利用 AI 完成复杂编码任务。
传统的 AI 编程助手通常采用"即问即答"的模式：开发者提出需求，AI 立即生成代码。这种模式在处理简单任务时表现良好，但在面对复杂的多步骤任务时存在明显局限：
VS Code 的 Plan Agent 正是为解决这些痛点而设计的。它在代码实现之前引入了一个规划阶段，通过系统化的任务分解和需求确认，确保 AI 和开发者在同一认知层面上，从而显著提升生成代码的质量和可靠性。
Plan Agent 的工作流程遵循"先规划、后执行"的理念，主要包含三个核心阶段：
在这个阶段，Plan Agent 像一位经验丰富的架构师一样，利用只读工具对代码库进行全面分析：
这个阶段的关键在于不做任何代码修改，纯粹聚焦于信息收集和需求理解。通过只读操作，Plan Agent 能够安全地探索代码库，避免意外破坏现有功能。
基于研究结果，Plan Agent 将复杂任务拆解为可管理的小步骤：
Plan Agent 采用标准化的计划格式输出，包含以下关键内容：
这种结构化的规划输出，为后续的实现提供了清晰的路线图。
Plan Agent 生成的计划草案并非最终版本，而是一个可以反复迭代的工作文档：
只有当开发者明确批准计划后，才会进入代码实现阶段。这种"人在回路"的设计，确保了 AI 始终在开发者的掌控之下。
目前，Plan Agent 功能仅在VS Code Insiders[1]版本中提供。以下是详细的使用步骤：
Ctrl+Alt+I（Windows/Linux）或Cmd+Alt+I（macOS）打开聊天视图输入一个清晰的任务描述，可以是功能开发、重构、Bug 修复等。任务描述应该包含目标，但不需要过于详细。
示例任务描述：
实现一个支持OAuth2和JWT的用户认证系统
为所有API端点添加单元测试
修复保存按钮在提交后不重置表单字段的问题
Plan Agent 将返回一份包含以下内容的计划草案：
此时，你可以继续在 Plan 模式下与 AI 对话，进行多轮迭代：
"第3步应该在第2步之前完成"
"需要考虑支持多租户场景"
"添加一个关于性能测试的步骤"
最佳实践：在计划阶段充分迭代，确保所有需求和约束都被考虑周全，这将为后续实现奠定坚实基础。
当计划满足预期后，你有两种选择：
在复杂任务执行过程中，VS Code 的代理会自动创建一个Todo List，将任务分解为多个子任务，并实时更新完成状态。这一机制带来了几个关键优势：
Todo List 提供了直观的进度反馈，开发者可以清楚地看到：
这种可见性对于长时间运行的任务尤为重要，避免了"黑盒"般的等待焦虑。
对于 AI 代理而言，Todo List 起到了"工作清单"的作用，帮助代理在处理多步骤任务时保持专注，避免偏离主线或遗漏关键步骤。
开发者可以使用自然语言与 Todo List 交互：
"将步骤1修改为执行X"
"添加一个新任务：优化数据库查询"
"清除任务列表"
AI 代理会根据开发者的反馈和任务执行过程中收集的信息，自动更新 Todo List。
| 工作模式 | ||
| 需求理解 | ||
| 错误成本 | ||
| 任务复杂度 | ||
| 可控性 | ||
| 进度追踪 |
这种对比并不意味着 Plan Agent 完全替代传统模式。对于简单的代码生成任务（如"写一个排序函数"），传统模式更高效。而对于复杂任务（如"重构整个认证系统"），Plan Agent 才是更优选择。
让我们通过一个实际场景，看看 Plan Agent 如何提升重构任务的质量。
假设你需要将一个使用传统 Session 认证的 ASP.NET Core 应用迁移到 JWT 认证。这个任务涉及：
如果直接让 AI 生成代码，可能会遇到：
步骤 1：提交任务
将应用从Session认证迁移到JWT认证，确保向后兼容
步骤 2：审查生成的计划
Plan Agent 可能输出如下计划：
### 摘要
将认证机制从基于 Session 的方式迁移到基于 JWT 的无状态认证，
同时保留对旧版 API 客户端的兼容性支持。
### 实现步骤
1.安装并配置 JWT 相关 NuGet 包
2.修改 Startup.cs/Program.cs 的认证配置
3.更新所有控制器的 [Authorize] 特性
4.实现 Token 生成和验证服务
5.添加 Token 刷新机制
6.更新数据库 Schema（添加 RefreshToken 表）
7.修改登录端点以返回 JWT
8.更新单元测试和集成测试
9.更新 API 文档
### 开放问题
-是否需要支持 Token 过期时间的动态配置？
-旧版 Session 认证的过渡期是多久？
-是否需要实现 Token 黑名单机制？步骤 3：迭代优化
"添加一个步骤：实现平滑迁移策略，支持同时接受Session和JWT"
步骤 4：批准并执行
"从步骤1到5开始实现，其他步骤稍后处理"
通过这种方式，Plan Agent 确保了迁移任务的每个方面都被考虑到，显著降低了遗漏关键步骤的风险。
尽管 Plan Agent 在处理复杂任务时表现出色，但也有一些局限需要注意：
目前，Plan Agent 功能尚未发布到稳定版 VS Code，只能在VS Code Insiders[1]中使用。这意味着：
Plan Agent 通过分析代码库来理解需求和约束。如果代码库存在以下问题，计划质量会受影响：
建议：在使用 Plan Agent 之前，确保代码库具有基本的可读性和结构清晰性。
Plan Agent 最适合以下类型的任务：
对于以下任务，直接使用传统 AI 助手可能更高效：
Plan Agent 生成的计划并非完美无缺，仍然需要开发者的专业判断：
切勿盲目信任 AI 生成的计划，始终保持批判性思维。
Plan Agent 并非孤立存在，它与 VS Code Copilot 的其他功能形成了完整的 AI 辅助开发生态：
Chat Sessions 允许你保存和恢复对话上下文。结合 Plan Agent，你可以：
Checkpoints 功能允许你在关键步骤保存代码状态。在执行 Plan Agent 的计划时：
通过配置自定义指令，你可以让 Plan Agent 更符合团队的编码规范：
{
"github.copilot.chat.codeGeneration.instructions":[
"所有计划必须包含单元测试步骤",
"优先考虑性能和安全性",
"遵循公司的架构设计原则"
]
}这样，Plan Agent 生成的计划将自动融入团队的最佳实践。
虽然 Plan Agent 仍处于早期阶段，但从其设计理念可以预见未来的发展方向：
未来的 Plan Agent 可能会集成更多数据源：
支持团队成员共同参与计划的制定和审查：
根据执行过程中的实际情况动态调整计划：
针对特定领域和技术栈，提供预定义的计划模板：
Plan Agent 和 Todo List 代表了 AI 辅助编程的一个重要演进方向：从"即时响应"转向"系统规划"。通过引入规划阶段，这两项功能显著提升了 AI 在复杂任务中的可靠性和可控性。
随着 AI 技术的不断发展，像 Plan Agent 这样的工具将越来越多地改变我们的开发方式。拥抱这些变化，但始终保持批判性思维，才能真正发挥 AI 的价值。
| 欢迎光临 链载Ai (https://www.lianzai.com/) | Powered by Discuz! X3.5 |