每次在终端里敲 claude 然后看着它自动读代码、改文件、提交 commit——这种感觉很上瘾。
但用了快两个月我发现:同样的工具,不同的人用出来的效果差好几倍。区别在哪?——prompt 怎么写。
这篇文章给你 6 个我实战验证过的 Claude Code 工作流模板,直接复制粘贴就能用。
🤖 Claude Code 是什么?
Claude Code 是 Anthropic 推出的 AI 编程助手,跟 Cursor、Copilot 最大的区别在于——它是命令行原生的。
不嵌在编辑器里,不绑 IDE。终端里直接对话,Claude 帮你读代码、改代码、提交代码。我用了一个多月,最大的感受是:它像你雇了一个实习生,不是自动补全工具。
核心能力:
- 🧠 理解整个代码仓库的上下文,不是单个文件
- 🔧 直接执行 shell 命令、读写文件、跑测试
- 📝 自动生成 commit message,一键 git 提交
- 🔄 迭代修改——改错了就让它回滚重来
💡 为什么提示词比你想的重要
很多人以为 Claude Code 就是"告诉它做什么就行"。错。
你给它"给我写个登录功能",它能做。但给上下文 + 约束 + 验收标准,产出质量差 3 倍。这不是夸张——我对比过同一需求的两种 prompt,代码量、错误率、需要修改的轮次都有明显差距。
📋 6 个 Claude Code 工作流模板
模板 1:新功能开发
## 任务:实现用户收藏功能 ### 背景 - 项目: React 19 + TypeScript + Node.js 后端 - 已有用户系统(JWT 认证),PostgreSQL 数据库 - 风格:函数组件 + Hooks,Tailwind CSS ### 需求 1. 用户可收藏/取消收藏文章 2. 收藏列表页面(分页,每页20条) 3. 文章详情页显示收藏状态 ### 约束 - API 遵循 RESTful 规范 - 数据库用 Prisma ORM - 不要引入新的状态管理库 - 错误处理要完整 ### 验收标准 - 未登录用户看到"登录后收藏" - 收藏/取消动画过渡自然 - 网络错误时显示 toast 提示 - 重复点击不产生重复请求 ### 输出要求 先列出将创建/修改的所有文件,让我确认后再动手。
模板 2:Bug 修复
## Bug:搜索结果排序错误 ### 现象 搜索"Python教程",第一页返回的是 2023 年的旧文章, 2026 年的新文章在第 3 页。按相关性排序应该优先权重高的。 ### 复现步骤 1. 访问 /search?q=Python教程 2. 查看第1页结果,全是老文章 3. 翻到第3页才有新文章 ### 排查方向 - 怀疑 search_controller.ts 的排序逻辑 - 可能相关度算法权重有问题(时间衰减系数?) - 数据库索引确认:search_index 表 ### 要求 1. 先分析 search_controller.ts 的排序逻辑 2. 定位问题后给出修复方案 3. 确认修复后不要引入性能退化 4. 修复完跑一下搜索相关的测试
模板 3:代码重构
## 重构:支付模块 ### 现状问题 src/services/payment/ 下 pay_service.ts 有 800+ 行, 包含支付宝、微信、银行卡三种支付通道混在一起。 每次改一个通道都要担心中断其他通道。 ### 目标架构 - 抽象 PaymentChannel 接口 - AlipayChannel / WechatChannel / BankCardChannel 独立实现 - 工厂模式创建对应通道 - 公共逻辑(签名验证、回调处理)抽到 base ### 约束 - 保持现有 API 接口不变(前端不需要改) - 所有现有测试必须继续通过 - 不要一次性全改,分步重构,每步验证 ### 第一步 先提取 PaymentChannel 接口,然后重构支付宝通道, 其他两个通道先不动。确认这一步正确后再继续。
模板 4:代码审查
## Code Review:PR #342 用户权限重构 ### 审查重点 请从以下角度审查这次提交的代码: 1. **安全性**:权限检查有没有遗漏?SQL 注入风险? 2. **性能**:N+1 查询?不必要的数据库查询?缓存是否合理? 3. **可维护性**:新代码是否清晰?命名是否合理? 4. **边界情况**:空列表、超大分页、并发请求等 5. **向后兼容**:是否破坏了现有 API? ### 输出格式 - 🔴 必须修改(安全问题/业务逻辑错误) - 🟡 建议修改(性能/可读性优化) - 🟢 好的做法(值得保留) 每个问题附带具体代码位置和修复建议。
模板 5:测试编写
## 任务:为 src/services/user_service.ts 补全测试 ### 背景 已有测试框架:Vitest + Testing Library 目前覆盖率:62%,目标:85%+ ### 未覆盖的场景 1. 用户注册——邮箱已存在(目前只测了注册成功) 2. 用户登录——密码连续错误5次锁定账户 3. 获取用户列表——空列表返回(目前只测了有数据的情况) 4. 更新用户信息——无权限修改他人信息 5. 删除用户——软删除验证(is_deleted flag) ### 要求 - 用 describe/it 组织,描述清晰 - Mock 数据库调用(别连真实数据库) - 覆盖成功路径和错误路径 - 测试命名:should + 场景描述
模板 6:项目初始化
## 任务:从零初始化一个管理后台项目 ### 技术栈 - 前端:React 19 + TypeScript + Vite + Ant Design 5 - 后端:Node.js + Express + TypeScript - 数据库:PostgreSQL,用 Prisma ORM - 部署:Docker Compose ### 项目结构要求 - monorepo 结构(packages/frontend, packages/backend) - pnpm workspace - ESLint + Prettier 统一配置 - 前后端共享类型定义(packages/shared) ### 初始功能 1. 用户登录/注册(JWT) 2. 基础 Dashboard 页面(卡片统计) 3. 用户管理 CRUD(表格 + 搜索 + 分页) 4. 基于角色的权限控制(admin/user) ### 要求 1. 先给出项目结构规划,让我确认 2. 再逐步生成代码,每步验证 3. 包含 Docker 部署配置 4. README.md 写清楚如何启动
🎯 用好 Claude Code 的 3 个原则
原则 1:给上下文,别只给任务。告诉它项目技术栈、代码风格、现有架构。这些信息占 prompt 的前 30%,但决定了输出质量的 70%。
原则 2:分步执行,确认再继续。别让它一口气干完。代码量越大,出错的概率指数级增长。每步确认,错了马上纠正。
原则 3:写清楚"不要什么"。告诉它不引入新依赖、不改 API 接口、不破坏现有测试。约束比指令更有效。
这些模板你可以直接复制,替换里面的具体需求。我用这套模板完成了一个完整项目的前端重构——比我手写快了至少 5 倍,而且代码质量更高。
你觉得哪种场景下的 prompt 最难写?评论区聊聊,我帮你优化。