摘要本文记录一个已上线生产环境的Vibe Coding项目VS Code Claude Code开发的完整复盘过程导出62个JSONL会话文件用WorkBuddy完成对话梳理、数据清洗与经验分析人工复检后生成项目复盘报告并总结项目启动、开发、部署三个阶段的实践经验。适合正在使用AI编程工具做项目的开发者参考。文章目录项目背景与环境说明第一步把对话记录导出来第二步交给WorkBuddy做体检第三步人工复检删掉水分第四步生成完整复盘报告复盘总结出的Vibe Coding经验项目启动阶段开发阶段部署阶段结语方法、边界与结论项目背景与环境说明开发环境VS Code Claude Code 插件项目类型前后端分离的部门内部内容管理与发布系统复盘工具腾讯 WorkBuddy数据来源VS Code 导出的 JSONL 格式会话文件共62个我在VS Code里装了Claude Code插件用纯自然语言对话的方式开发了一个前后端分离的项目。项目是一个部门内部使用的内容管理和发布系统因为没有专职时间开发前后零零散散花了个把月。小白科普这种通过自然语言对话完成编程的方法就是现在很火的Vibe Coding。说白了就是请了个24小时在线的程序员搭子你说需求他写代码你提意见他改实现。你不用一行行敲键盘但得一句句把需求说清楚。AI写的代码已经跑在生产环境上了项目复盘该怎么做我的思路是复盘的对象不是代码而是过程对话记录就是过程的全部证据。项目上线后活还没结束一方面是想通过复盘汲取经验另外一方面是应领导要求做内部交流所以有了这次内容。图VS Code里和Claude Code对话开发第一步把对话记录导出来Claude Code的每一次会话VS Code都会存成一个JSONL格式的文件一个会话对应一个文件。我这个项目一共62个会话文件摞在一起密密麻麻全是原始数据。刚看到这堆数据的时候我也头大打开文件分析了一下里面都是Json格式的数据。这种结构化数据的处理正是Agent擅长的所以我请出了WorkBuddy。图从VS Code导出的会话记录文件第二步交给WorkBuddy做体检我干的头一件事就是把这批文件丢给WorkBuddy让他把原始记录梳理成一问一答的清单我提了什么AI回了什么按时间顺序排好。格式很简单但这一步特别关键。原始数据不梳理成可读的对话后面的分析根本无从下手。这个是我从vscode的claude code插件导出的项目对话记录请你帮我进行分析我要将项目对话原文内容梳理出来形成对话格式 Claude Codexxxxxxxxxxxxxx 我xxxxxxxxxxxxxx 类似这种一问一答的清单作为我后续分析对话的原始数据这个就像翻微信群聊天记录整成对话清单才方便下一步分析。为什么坚持一字不改地搬因为原始数据是后面核对的基准梳理稿一旦掺入改写核对就失去意义了。经验分享原始数据很重要用于后面的核对所以原始数据和梳理数据得分成独立的两份。图WorkBuddy梳理出的一问一答清单第三步人工复检删掉水分梳理清单出来后不能直接用。里面混着不少没用的东西比如模型调不通报400、401的寒暄打招呼的还有一些任务停止后的继续任务等。我让WorkBuddy把这些剔除掉然后自己又人工过了一遍62个会话最后剩下57个有效会话。会话里面有一些是因为模型调不通而出现的会话如 我继续任务。 Agent400、401等模型不通的反馈。 还有一些无用对话如你好、你能做什么等会话。这些类型的会话从梳理的会话清单和分会话中去掉。经验分享AI的判断不一定全对人工复检这步省不掉。有些会话看着像报错其实是开发过程中的正常调试机器容易误删。清洗规则让AI定但删了什么你得自己进行一轮审核。图清洗后剩余57个有效会话第四步生成完整复盘报告拿清洗完的数据我让WorkBuddy做整体分析。从项目过程梳理到经验和教训最后汇总成一份完整的分析报告。图WorkBuddy生成的项目分析报告结构AI生成的分析报告也可能出现遗漏像接口对接、模型限流这些结论我核对了原始对话发现确实也漏了一些内容。聪明的模型也可能会出现这个问题图调整补漏后的项目复盘报告复盘总结出的Vibe Coding经验项目启动阶段1、先写 CLAUDE.md 再写代码开工前先定好规则把项目要求、技术栈等写进CLAUDE.mdAI干活前先读规则。如果团队已有明确的代码编写规范一起放进项目中。2、明确技术栈和行为边界特别约束临时文件清理、不做无关修改、注释要求等。在项目过程中持续补充新规则。技术选型匹配业务复杂度不需要选择多新的开发语言也不需要选择多新的框架。合适的才是关键。3、UI设计、数据库设计高保真UI原型先行先确认UI设计再让Agent进行代码改造避免边开发边设计导致的反复返工。数据库设计审查前置在后端开发前完成数据库设计与前端类型的对齐避免接口对接阶段才发现字段不匹配。开发阶段1、使用任务清单驱动维护task/todo.md每个任务有编号和状态每次开发前让Agent检查任务清单确认下一步任务发现的问题及时记录到任务清单。这样做的好处是不会遗漏任务也便于后面核对。2、大需求拆解小任务控制单次会话规模一个会话完成一个明确任务大任务拆分为多个小会话避免上下文丢失避免单次会话超过50轮对话。别太相信网上那些一句话干完一个项目的说法。3、接口对接和垃圾清理接口对接的规范化前后端接口契约文档先行前端API封装与后端路由保持同步每个请求添加用途注释。及时清理临时文件在CLAUDE.md中明确规则每次会话结束后检查工作区是否有意外文件。部署阶段部署文档要面向小白每一步都有具体命令和预期输出包含常见问题的排查方法。Docker部署的注意事项.env文件不入Git数据存储优先使用宿主机目录挂载非Docker卷。上线立即做的三件事1安装备份cron任务恢复演练、2安装监控cron任务配置告警通知、3打版本tag如v1.0.0结语方法、边界与结论先说结论Vibe Coding能不能用好不取决于模型多聪明而取决于过程有没有被管理。对话记录就是最好的管理素材——62个会话摆在面前哪个阶段返工多、哪类问题重复出现一目了然。这套复盘方法不挑工具用Claude Code、Codex或其他Agent都能照搬核心是五步导出记录、梳理对话、清洗水分、生成报告、人工核对。其中人工核对这步不能省AI的分析有遗漏是常态不是意外。需要说明的边界本文经验来自一个部门内部系统的复盘项目规模不大、业务复杂度中等更大的项目场景下未必全部适用请结合自己的实际情况取舍。如果觉得有帮助欢迎点赞收藏。有问题也欢迎在评论区交流。版权声明本文为原创文章遵循 CC 4.0 BY-SA 版权协议转载请附上原文出处链接及本声明。