03 · 高效添加新功能
02-安装与项目理解 ｜ 下一篇 → 04-测试调试与重构
课程项目：一个 RAG 聊天机器人
本节起用一个真实项目练手：FastAPI 后端 + React 前端的 RAG 聊天机器人。任务是给它加功能，体会「智能体加功能」的标准流程。
标准流程：计划 → 确认 → 执行
⭐ 这是全课最重要的工作流。不要直接让它写代码，先让它出计划。
1. 描述目标（清楚、具体、指明文件）
2. 让它先「制定计划」（Plan）
3. 你审计划、纠偏
4. 批准后让它执行
5. 验证结果（跑起来 / 跑测试）
示例提示词
我想给聊天机器人加「对话历史」功能：
- 后端：在 @app/api/chat.py 加一个 /sessions 接口，返回历史会话列表
- 前端：在 @frontend/src/Sidebar.tsx 左侧加会话列表
先别写代码，先给我一个分步计划和你要改的文件清单。
确认计划后：
计划没问题，按这个执行。每改完一个文件停一下让我看。
给「清晰上下文」的 4 个要点
- 指相关文件：
@app/api/chat.py，别让它全库搜。 - 说清要什么 + 不要什么：「用现有的
db.session，不要新建数据库连接」。 - 拆小：一次加一个小功能，能验证再继续。
- 给验收标准：「加完后
pytest tests/test_chat.py要通过」。
Plan Mode（计划模式）
- 可以让它只读不写地先把方案想清楚，避免它一上来就乱改。
- 复杂功能尤其要先 Plan：它会列出受影响文件、步骤、风险点。
- 你在计划阶段纠偏的成本，远低于它写完一堆错代码再返工。
边做边验证
- 加完后让它自己跑起来验证：
帮我启动后端，调一下 /sessions 看返回对不对。 - 出错就把报错贴回去，让它自我纠错（下一节专门讲调试）。
反模式（避免）
- ❌ 一句话「帮我做个完整的用户系统」→ 太大、没上下文、必跑偏
- ❌ 不指文件，让它满项目猜
- ❌ 不看计划直接让它狂改一堆文件
- ❌ 一个会话里堆十个无关任务（该
/clear就 clear）
本节实操
- 选你 第 1 节 记下的那个任务
- 用「先出计划」的方式让 Claude 做
- 审计划 → 批准 → 执行 → 跑起来验证
下一篇 → 04-测试调试与重构