借助Claude Code开发翻译Agent的分版本迭代经验
怎么借助 Claude Code 开发一个 AI Agent
在开发这个翻译 Agent 的时候，我是用的 Claude Code 来开发的，几乎没有手动写代码就完成了这个翻译智能体的开发。但我在这里还是要说明一下，Vibe Coding 并没有那么神奇，没有谁能不懂代码就做出成熟的产品。我之所以能这么快借助 Claude Code 开发出来，只是因为我用 Claude Code 开发之前，我已经半手工的写了好几个版本了，反复完成了几个试验品后，把需求理清楚了，把技术栈确定了，把一些坑踩完了，再让 AI 写就没那么复杂了。
当然这个过程肯定还是有可以学习和借鉴的地方，所以我把所有和 AI 交互的记录都一起放在 GitHub 上了 https://t.co/WMBjU4FTg1 ，如果你有兴趣可以看我是怎么从头构建这个项目的。
要让每个版本都独立可以运行
新手使用 AI 编程容易犯的一个错误就是一次憋一个大版本，期望一个版本内把所有功能都实现了，让 AI 写了一堆代码，最后合并在一起无法正常运行，跑起来到处都是 Bug。
所以借助 AI 编程的最佳实践，一定是要小版本迭代，并确保每个版本都能正常运行，充分测试后再下一个版本。就像你要造汽车，第一步先造个滑板车，然后自行车、再摩托车、最后再汽车。（参考图1）
就像我这个翻译 Agent，我分成了几个版本迭代：
- v0： 初始化项目说明，设定好 CLAUDE Code 的规则，比如要求 Claude Code 每次生成完要自己测试，有错误自己修复
- v0.1：一个只有 UI 的程序，没有任何后台功能
- v0.2: 接上豆包 1.6 模型，让它可以实现简单的聊天对话
- v0.3: 添加了网页抓取和文件读取工具，并且让 LLM 可以接上工具
- v0.4: 把工具调用的状态和工具返回结果显示在 UI 中
这里面每一个版本都是可以独立运行的。
怎么写好 AI 编程的提示词
很多人觉得写提示词似乎要个模板才能写好，但实际上写提示词没你想的那么复杂，我把每个版本的提示词都放在 GitHub 上了，你完全可以照着复现整个过程。
1、描述清楚需求
让 AI 写代码的提示词，本质上就像你是一个产品经理+技术经理，把每个版本、模块的要求定义清楚，把技术规范说清楚。比如我第一个版本的提示词很简单：
----
v 0.1 需求
请帮我实现一个基础的 cli 程序，名称是 Translator Agent。类似于 Chatbot，能输入消息，显示消息历史
运行环境：Nodejs v20+
技术栈：TypeScript + React + ink
UI 要求：
- 启动后顶部显示欢迎消息
- 中间显示消息历史
- 底部有一个输入框可以输入消息，输入消息后提交消息清空输入框，显示输入的消息在消息历史中
- 消息框下面有一行文字显示错误信息、状态等
- 确保能作为一个 cli 程序正常运行，正常运行后，更新版本号、Changelog，提交commit
---
2、把全局要求放在 https://t.co/vgzTFPUACZ 文件上
我在第 0 个版本就是初始化 https://t.co/vgzTFPUACZ，说明清楚我要做一个什么产品，有哪些主要功能，技术栈是什么，每次开发后一定要自己测试等等。这样后续就不用每次说这些细节
（参考图2）
3、要加上参考代码
现在 AI 的训练截止日期一般都是 2024 年的，这期间很多代码库都更新了，比如我用的 AI SDK，在我前几天测试的时候，AI 总是生成老版本的代码，导致很多问题，所以这次我每次实现前，都去官方文档把最新的代码示例都复制下来放到提示词里面，这样就不担心 AI 生成代码时过于老旧。
（参考图3）
4、出问题后有时候回滚好过继续修复
在第一次实现 v0.3 版时，测试后结果很不理想，主要还是我复制 ai sdk 的参考代码时搞错了，虽然我可以让它基于错误的代码修正，但这种情况下要改对反而不太容易，不如直接回滚到 v0.2，修改提示词后重新开始。结果修改提示词后一次就成了。
最后
上面就是我用 ClaudeCode 做了一个基于豆包 1.6 模型的翻译智能体的分享。几点心得：
1、无论是学习 AI Agent 还是 AI 编程，最好的学习方法还是动手实践，只有动手实践过才能真正掌握好
2、AI 编程可以提升效率，但是要用好，要学会描述清楚需求，学会划分版本拆分模块
3、开发 AI Agent，要用适合 AI Agent 的模型，比如豆包 1.6、o3、Claude 4、Gemini 2.5 Pro，不然你再怎么优化提示词效果可能也不理想
项目地址：https://t.co/WMBjU4FTg1
在开发这个翻译 Agent 的时候，我是用的 Claude Code 来开发的，几乎没有手动写代码就完成了这个翻译智能体的开发。但我在这里还是要说明一下，Vibe Coding 并没有那么神奇，没有谁能不懂代码就做出成熟的产品。我之所以能这么快借助 Claude Code 开发出来，只是因为我用 Claude Code 开发之前，我已经半手工的写了好几个版本了，反复完成了几个试验品后，把需求理清楚了，把技术栈确定了，把一些坑踩完了，再让 AI 写就没那么复杂了。
当然这个过程肯定还是有可以学习和借鉴的地方，所以我把所有和 AI 交互的记录都一起放在 GitHub 上了 https://t.co/WMBjU4FTg1 ，如果你有兴趣可以看我是怎么从头构建这个项目的。
要让每个版本都独立可以运行
新手使用 AI 编程容易犯的一个错误就是一次憋一个大版本，期望一个版本内把所有功能都实现了，让 AI 写了一堆代码，最后合并在一起无法正常运行，跑起来到处都是 Bug。
所以借助 AI 编程的最佳实践，一定是要小版本迭代，并确保每个版本都能正常运行，充分测试后再下一个版本。就像你要造汽车，第一步先造个滑板车，然后自行车、再摩托车、最后再汽车。（参考图1）
就像我这个翻译 Agent，我分成了几个版本迭代：
- v0： 初始化项目说明，设定好 CLAUDE Code 的规则，比如要求 Claude Code 每次生成完要自己测试，有错误自己修复
- v0.1：一个只有 UI 的程序，没有任何后台功能
- v0.2: 接上豆包 1.6 模型，让它可以实现简单的聊天对话
- v0.3: 添加了网页抓取和文件读取工具，并且让 LLM 可以接上工具
- v0.4: 把工具调用的状态和工具返回结果显示在 UI 中
这里面每一个版本都是可以独立运行的。
怎么写好 AI 编程的提示词
很多人觉得写提示词似乎要个模板才能写好，但实际上写提示词没你想的那么复杂，我把每个版本的提示词都放在 GitHub 上了，你完全可以照着复现整个过程。
1、描述清楚需求
让 AI 写代码的提示词，本质上就像你是一个产品经理+技术经理，把每个版本、模块的要求定义清楚，把技术规范说清楚。比如我第一个版本的提示词很简单：
----
v 0.1 需求
请帮我实现一个基础的 cli 程序，名称是 Translator Agent。类似于 Chatbot，能输入消息，显示消息历史
运行环境：Nodejs v20+
技术栈：TypeScript + React + ink
UI 要求：
- 启动后顶部显示欢迎消息
- 中间显示消息历史
- 底部有一个输入框可以输入消息，输入消息后提交消息清空输入框，显示输入的消息在消息历史中
- 消息框下面有一行文字显示错误信息、状态等
- 确保能作为一个 cli 程序正常运行，正常运行后，更新版本号、Changelog，提交commit
---
2、把全局要求放在 https://t.co/vgzTFPUACZ 文件上
我在第 0 个版本就是初始化 https://t.co/vgzTFPUACZ，说明清楚我要做一个什么产品，有哪些主要功能，技术栈是什么，每次开发后一定要自己测试等等。这样后续就不用每次说这些细节
（参考图2）
3、要加上参考代码
现在 AI 的训练截止日期一般都是 2024 年的，这期间很多代码库都更新了，比如我用的 AI SDK，在我前几天测试的时候，AI 总是生成老版本的代码，导致很多问题，所以这次我每次实现前，都去官方文档把最新的代码示例都复制下来放到提示词里面，这样就不担心 AI 生成代码时过于老旧。
（参考图3）
4、出问题后有时候回滚好过继续修复
在第一次实现 v0.3 版时，测试后结果很不理想，主要还是我复制 ai sdk 的参考代码时搞错了，虽然我可以让它基于错误的代码修正，但这种情况下要改对反而不太容易，不如直接回滚到 v0.2，修改提示词后重新开始。结果修改提示词后一次就成了。
最后
上面就是我用 ClaudeCode 做了一个基于豆包 1.6 模型的翻译智能体的分享。几点心得：
1、无论是学习 AI Agent 还是 AI 编程，最好的学习方法还是动手实践，只有动手实践过才能真正掌握好
2、AI 编程可以提升效率，但是要用好，要学会描述清楚需求，学会划分版本拆分模块
3、开发 AI Agent，要用适合 AI Agent 的模型，比如豆包 1.6、o3、Claude 4、Gemini 2.5 Pro，不然你再怎么优化提示词效果可能也不理想
项目地址：https://t.co/WMBjU4FTg1