Appearance
Everything Claude Code Planner Agent 是一款专注于复杂功能开发与重构任务的 AI 规划专家代理。它能自动分析需求、拆解实现步骤、识别依赖与风险，并输出结构化、可执行的多阶段实施计划，极大提升 AI 辅助编程的系统性和落地效率。相比直接向 Claude 提问，使用 Planner Agent 能获得更细致、可追踪、易于协作的工程级方案，是生产级 AI 编程插件体系中不可或缺的核心组件。
Everything Claude Code Planner Agent：复杂功能与重构任务的多步骤实施计划生成
在 AI 辅助编程逐渐成为主流的今天，如何让 AI 不仅能“写代码”，更能“规划工程”，成为开发团队关注的核心问题。Everything Claude Code Planner Agent（以下简称 Planner Agent）正是为此而生——它是 Everything Claude Code 完全指南：38 Agent + 156 Skill 的生产级 AI 编程插件 体系中，专门负责“复杂功能实施计划生成”的专家代理。本文将详细介绍 Planner Agent 的核心用途、能力边界、触发方式、与其他 Agent 的协作模式，并通过完整示例解答“为什么要用专门的代理而不是直接问 Claude”。
1. Planner Agent 是什么？解决什么问题？
Planner Agent 是 Everything Claude Code 的 38 个专业 Agent 之一，专注于为复杂功能开发、架构调整和大规模重构生成可落地的多步骤实施计划。它的核心价值在于：
- 需求分析：自动理解和澄清用户需求，识别成功标准、约束和假设。
- 任务拆解：将复杂目标分解为可执行的小步骤，明确每步的文件路径、依赖关系、风险等级。
- 阶段划分：按依赖和价值优先级分阶段输出，支持增量交付和持续集成。
- 测试与风险管理：为每个阶段和关键步骤指定测试策略，主动识别潜在风险及缓解措施。
- 工程协作：输出结构化 Markdown 计划，便于团队沟通、代码审查和自动化流程集成。
为什么不能直接问 Claude？
直接让 Claude 生成开发计划，往往只会得到泛泛而谈的 Todo List 或遗漏细节的建议。而 Planner Agent 内置了领域知识、项目惯例和上下文感知能力，能输出具体到文件、函数、依赖、测试的工程级计划，并能自动适应现有代码结构，极大提升计划的可执行性和团队协作效率。
2. Planner Agent 的具体能力与边界
能做什么？
- 复杂功能实现规划：如“新增多端订阅系统”、“重构权限体系”、“批量替换数据存储方案”等。
- 大规模重构/技术债梳理：自动识别代码异味、技术债，规划渐进式重构步骤。
- 架构调整与依赖分析：分析现有代码架构，定位受影响模块，建议复用模式。
- 测试策略制定：区分单元、集成、端到端测试，明确测试覆盖目标。
- 风险与缓解措施输出：主动标记高风险步骤，并给出可操作的缓解建议。
- 输出标准化计划文档：严格遵循结构化 Markdown 模板，便于审查、追踪和自动化集成。
不能做什么？
- 不直接写实现代码：Planner Agent 只负责“怎么做”，不会输出具体代码实现（需配合实现类 Agent）。
- 不替代架构决策：如需系统级架构设计，建议配合 Architect Agent。
- 不处理简单/单文件小改动：对简单 Bug 修复或单文件小功能，直接用实现 Agent 更高效。
- 不自动执行计划：Planner Agent 只生成计划，实际执行需开发者或其他自动化 Agent 配合。
3. 触发方式：自动激活与手动调用
Planner Agent 的触发方式分为两种：
- 自动激活：当用户在 Claude Code、Codex、Cursor 等 AI 编程助手中输入“新增复杂功能”、“大规模重构”、“架构调整”等需求时，系统会自动派发 Planner Agent生成实施计划，无需用户手动指定。
- 手动调用：对于明确需要详细计划的任务，用户也可通过命令或菜单手动选择 Planner Agent，如“为 XX 功能生成详细开发计划”。
在 Claude Code 快速上手指南：Skills、Hooks、Subagents、MCP 实战配置 中，Planner Agent 是“Plan Before Execute”原则的核心执行者，确保所有复杂开发都先有计划、再有实现。
4. 与其他 Agent 的协作模式
Planner Agent 通常与以下 Agent 形成高效协作闭环：
- Architect Agent：负责高层架构决策，Planner Agent 细化为可执行步骤。
- TDD Guide Agent：根据计划生成测试用例和开发顺序，保障测试先行。
- Code Reviewer Agent：在每个阶段实现后自动审查，确保质量与规范。
- Build Error Resolver Agent：在计划执行过程中遇到构建/类型错误时介入，保障进度。
- Refactor Cleaner Agent：在重构计划中自动检测并清理死代码。
这种多 Agent 流程可通过 Everything Claude Code Hooks 实战：PreToolUse / PostToolUse / Stop 事件驱动自动化完全配置 实现自动化编排，提升开发效率和一致性。
5. 实际使用示例：从需求到落地的完整对话
场景：产品经理提出“为 SaaS 应用增加 Stripe 订阅计费，支持 Free/Pro/Enterprise 三档，需保证安全、可测试、可扩展”。
用户输入：
请为我们的 Next.js SaaS 项目设计一套 Stripe 订阅计费功能，要求支持三档套餐，用户可升级/降级，计费状态需与 Stripe 实时同步，并能针对不同套餐做权限控制。请给出详细的开发计划和测试策略。Planner Agent 输出（部分节选）：
markdown
# Implementation Plan: Stripe Subscription Billing
## Overview
为 Next.js SaaS 应用集成 Stripe 订阅计费，支持 Free/Pro/Enterprise 三档套餐。实现安全的计费流程、Webhook 实时同步与套餐权限控制。
## Requirements
- Free/Pro/Enterprise 三档套餐
- Stripe Checkout 支付流程
- Webhook 实时同步订阅状态
- 基于套餐的权限控制
## Architecture Changes
- 新增 `subscriptions` 表（user_id, stripe_customer_id, ...）
- 新增 API 路由：`app/api/checkout/route.ts`、`app/api/webhooks/stripe/route.ts`
- 新增中间件：套餐权限校验
- 新增组件：`PricingTable`
## Implementation Steps
### Phase 1: 数据库与后端
1. **创建订阅表迁移**（File: supabase/migrations/004_subscriptions.sql）
- Action: 创建 subscriptions 表，配置 RLS 策略
- Why: 服务器端安全存储计费状态
- Dependencies: 无
- Risk: 低
2. **开发 Stripe Webhook 处理器**（File: src/app/api/webhooks/stripe/route.ts）
- Action: 处理 checkout.session.completed、customer.subscription.updated 等事件
- Why: 实时同步订阅状态
- Dependencies: 步骤 1
- Risk: 高（需验证 Webhook 签名）
...
## Testing Strategy
- 单元测试：Webhook 事件解析、套餐校验逻辑
- 集成测试：Checkout 会话创建、Webhook 处理流程
- E2E 测试：完整升级流程（Stripe 测试模式）
## Risks & Mitigations
- **Risk**: Webhook 顺序错乱
- Mitigation: 事件时间戳、幂等处理
- **Risk**: Webhook 失败导致状态不同步
- Mitigation: 定时轮询 Stripe，前端提示“处理中”状态
## Success Criteria
- [ ] 用户可通过 Stripe Checkout 升级套餐
- [ ] Webhook 能正确同步状态
- [ ] Free 用户无法访问 Pro 功能
- [ ] 降级/取消流程正常
- [ ] 测试覆盖率 80%+后续：开发者可根据计划逐步实现，每完成一个阶段，自动触发 TDD Guide Agent 生成测试、Code Reviewer Agent 代码审查，最终保障高质量交付。
6. 常见问题与注意事项
Q: Planner Agent 会自动分析现有代码结构吗？ A: 会。它会读取项目目录和相关文件，结合已有架构自动定位受影响模块，确保计划贴合实际项目。
Q: 计划输出能细致到文件和函数级别吗？ A: 能。Planner Agent 会明确列出每一步涉及的文件路径、函数名和依赖关系，便于团队协作与代码审查。
Q: 如果需求变更，Planner Agent 能快速调整计划吗？ A: 可以。只需补充或修改需求描述，Agent 会重新分析并输出最新的分阶段计划，支持敏捷迭代。
通过引入 Planner Agent，AI 辅助编程不再是“写代码的工具”，而是“工程协作的伙伴”。它让复杂开发变得可控、可追踪、可持续，是现代开发团队提升 AI 生产力的必备核心组件。欲了解更多高级用法与自动化集成，建议参考 Everything Claude Code 高级技巧：Token 优化、记忆持久化、并行化与验证循环。