ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

WorkBuddy + FDE 实战:90天从一句话需求到上线App

WorkBuddy + FDE 实战:90天从一句话需求到上线App

1. 从一句话需求到上线 App 的完整路径拆解

“帮我做一个能记录每天喝水量的 App,最好能提醒我。”——这就是一个典型的“一句话需求”。放在三年前,这句话意味着产品经理写 PRD、设计师出图、前端切页面、后端写接口、测试跑用例,一套流程走下来少说两三个月。而现在,借助 WorkBuddy 这类 AI Coding 工作台配合 FDE 的工作方式,从这句话到真正能装到手机上的 App,周期可以压缩到几天甚至更短。

这套方法论的核心,是把“FDE”这个角色从传统交付模式里解放出来。FDE 原本是 Forward Deployed Engineer(前置交付工程师)的缩写,在不少技术团队里,这个岗位要同时懂业务、懂技术、懂交付,是连接客户需求和工程实现的关键节点。当 AI Coding 工具成熟之后,FDE 的工作重心发生了明显偏移:不再是自己一行行敲代码,而是把需求翻译成 AI 能理解的指令,把控架构方向,验收产出质量,处理 AI 搞不定的边界问题。

WorkBuddy 在这套流程里扮演的是“工作台”角色。它不是一个单纯的代码生成器,而是把需求梳理、任务拆解、代码生成、调试运行、打包发布串成一条流水线。配合 DeepSeek 这类推理能力较强的模型,以及 Claude Code 这类擅长长上下文代码理解与生成的工具,FDE 可以在一个统一的界面里完成从想法到产物的闭环。

这篇文章适合三类人看:一是想转型做 FDE 但不知道从哪下手的开发者;二是手里有产品想法但技术储备有限的创业者或产品经理;三是已经在用 AI Coding 工具但总觉得“差点意思”、产出质量不稳定的工程师。我会把 90 天的成长路径拆成可执行的阶段,把每个阶段的核心动作、工具选型、避坑经验都讲清楚,你照着抄作业就行。

2. 为什么是 WorkBuddy + FDE 这套组合

2.1 传统开发流程卡在哪

先说说传统路径的问题。一个 App 从需求到上线,卡点通常不在写代码本身,而在几个环节的衔接上。需求方说“要一个提醒功能”,开发理解成定时推送,产品想要的是基于用户行为的智能提醒,两边理解偏差导致返工。设计稿给到前端,前端发现某些交互在目标平台上实现成本极高,又要回头改设计。后端接口定义和前端调用对不上,联调阶段发现字段类型不一致,又是一轮扯皮。

这些问题的根源是信息在多个角色之间传递时不断损耗。每经过一个环节,原始意图就衰减一次。FDE 模式的价值在于,一个人从头跟到尾,信息损耗降到最低。而 AI Coding 工具的价值在于,把 FDE 从重复性的编码劳动里解放出来,让他有精力去盯需求理解、架构设计和质量验收这些真正影响交付结果的事情。

2.2 WorkBuddy 工作台到底解决什么问题

WorkBuddy 的定位是“AI 原生的工作台”。它和普通代码编辑器的区别在于,它把项目上下文管理、多模型调度、任务编排、运行环境这些能力都内置了。你可以把它理解成一个专门为 AI Coding 场景优化的 IDE,但又不完全是 IDE——它更像是一个项目指挥中心。

具体来说,它解决了几个实际痛点。第一是上下文管理。AI 生成代码最大的问题是“失忆”,聊了十几轮之后它忘了前面定义的接口规范。WorkBuddy 会把项目结构、关键文件、历史决策都维护在上下文里,每次生成代码时自动带上相关背景。第二是多模型协作。不同任务适合不同模型,写业务逻辑用 DeepSeek 这类推理强的,处理长文件重构用 Claude Code 这类上下文窗口大的,WorkBuddy 允许你在同一个项目里切换模型,不用来回倒腾。第三是环境一致性。AI 生成的代码在你机器上跑得通,换台机器就报错,这种问题太常见了。WorkBuddy 把运行环境容器化,保证开发、测试、构建的环境一致。

2.3 FDE 在 AI 时代的角色转变

FDE 这个角色最早在一些做企业级服务的公司里出现,比如 Palantir 就有大量 FDE 岗位。他们的工作方式是直接驻扎在客户现场,理解业务痛点,快速搭建原型,然后和客户一起迭代。这种模式对个人的综合能力要求极高:既要能写代码,又要能跟客户聊业务,还要能自己做技术决策。

AI Coding 工具普及之后,FDE 的门槛降低了,但天花板提高了。降低是因为你不需要精通每一门语言和框架,AI 可以帮你补足技术栈的短板。提高是因为你需要更强的判断力:AI 给的方案对不对、代码质量行不行、架构能不能撑住后续迭代,这些都需要你来把关。换句话说,FDE 从“执行者”变成了“决策者+验收者”。

我自己的体会是,一个合格的 AI 时代 FDE,时间分配大概是这样的:30% 用于理解需求和拆解任务,40% 用于和 AI 协作生成代码并调试,20% 用于质量验收和边界处理,10% 用于部署和交付。和传统开发相比,写代码的时间占比大幅下降,但思考的时间占比大幅上升。

3. 90 天从零到独立交付的路径设计

3.1 第一个月:建立工具链和基础认知

前 30 天的目标不是做出什么惊艳的东西,而是把工具链跑通,建立对 AI Coding 工作流的肌肉记忆。这个阶段最忌讳的是贪多,看到什么工具都想试,最后哪个都没用熟。

第一周,把 WorkBuddy 装好,跑通官方示例项目。重点不是理解示例代码的逻辑,而是熟悉工作台的界面布局、任务创建流程、模型切换方式、运行和调试入口。同时把 DeepSeek 的 API 接进来,了解它的计费方式和调用限制。如果你之前没用过 Claude Code,这一周也把它配好,后面处理复杂重构时会用到。

第二周,用一个极简需求练手,比如“做一个命令行版的待办事项工具”。需求简单到不需要思考产品设计,你的全部注意力放在“怎么把需求描述清楚让 AI 生成可用的代码”上。这一周你会踩到很多坑:描述太模糊 AI 给的东西不能用,描述太细又不如自己写。找到那个平衡点是这周的核心收获。

第三周,把上周的命令行工具加上持久化存储,再套一个简单的 Web 界面。这一步的目的是体验“从后端到前端”的完整链路,理解 AI 在不同技术栈上的表现差异。你会发现 DeepSeek 在后端逻辑上很稳,但前端样式经常需要你手动调。这不是模型的问题,是训练数据分布的问题,接受它并学会补位。

第四周,做一个有真实用户场景的小工具,比如“记录每天喝水量的网页应用”。这次要完整走一遍:需求拆解、任务编排、代码生成、本地运行、简单部署。部署可以用 Vercel 或 Netlify 这类平台,把链接发给朋友试用,收集反馈。这一步的关键是建立“交付感”,让你习惯“做完的东西是给别人用的”这个事实。

3.2 第二个月:深入 AI Coding 的协作技巧

有了第一个月的基础,第二个月要解决的是“质量不稳定”的问题。同样的需求,有时候 AI 一次就给对的代码,有时候改十遍都不对。这种随机性不解决,交付质量就没法保证。

第一个技巧是“分步生成,逐步验证”。不要一次性让 AI 生成整个模块,而是拆成函数级别,生成一个验证一个。比如做一个用户登录功能,先让 AI 写密码加密函数,你跑个测试确认加密结果正确,再让它写数据库查询,再验证,最后组装成完整的登录接口。这样做虽然步骤多了,但每一步都可控,出问题能立刻定位。

第二个技巧是“用测试用例约束 AI”。在让 AI 写代码之前,你先写好测试用例,把输入输出定义清楚。AI 生成的代码必须通过测试才算完成。这个做法看起来增加了工作量,但实际上大幅减少了来回修改的次数。因为测试用例本身就是最精确的需求描述,AI 不用猜你要什么。

第三个技巧是“建立项目级的规范文档”。在 WorkBuddy 里维护一个CONVENTIONS.md,把命名规范、目录结构、错误处理方式、日志格式都写清楚。每次让 AI 生成代码时,把这个文件作为上下文带上。这样生成的代码风格一致,后续维护成本低很多。我试过不带规范文档生成十个文件,每个文件的错误处理方式都不一样,整合的时候非常痛苦。

3.3 第三个月:完整项目实战与上线

第三个月要做一个完整的、能上线的 App。我建议选一个你自己有真实需求的方向,比如健身记录、读书笔记、记账工具。有真实需求的好处是你知道哪里不好用,能驱动自己迭代。

第一周到第二周,完成核心功能开发。这个阶段用上个月练出来的协作技巧,把需求拆成任务列表,逐个实现。每天结束前把当天的代码提交到 Git,写清楚 commit message。AI 生成的代码也要走代码审查流程,哪怕审查的人是你自己。重点看几个地方:边界条件处理了没有、错误捕获全不全、有没有硬编码的敏感信息。

第三周,处理上线前的准备工作。包括:适配不同屏幕尺寸、处理网络异常情况、加上基本的用户反馈入口、准备应用图标和启动页。这些事情技术含量不高但很琐碎,可以让 AI 批量生成,你来筛选和调整。

第四周,打包发布。如果是 Web App,部署到 Vercel 或 Netlify,绑定自定义域名。如果是移动端 App,用 React Native 或 Flutter 打包,走应用商店的提审流程。第一次提审大概率会被拒,常见原因包括隐私政策不完整、权限申请说明不清晰、截图不符合规范。这些坑我都踩过,后面会详细说怎么避免。

4. 核心实操环节与关键配置

4.1 需求拆解:从一句话到任务列表

“做一个喝水提醒 App”这句话里,藏着大量没有说出来的需求。FDE 的第一个动作,就是把这些隐含需求挖出来,变成可执行的任务。

我会用这样一个拆解模板:先定义核心实体(用户、饮水记录、提醒设置),再定义每个实体的操作(增删改查),然后定义实体之间的关系(一个用户有多条记录、一个用户有一组提醒设置),最后定义非功能性需求(数据持久化方式、提醒的触发机制、多端同步要不要做)。

拆解完之后,用 WorkBuddy 的任务编排功能把任务列出来,每个任务标注优先级和依赖关系。比如“用户注册登录”是“记录饮水量”的前置任务,因为记录需要关联到用户。这种依赖关系如果不提前理清,AI 生成代码时会出现循环依赖或者接口对不上的问题。

注意:拆解任务时不要追求一步到位。先拆出核心链路(用户能记录、能查看、能收到提醒),边缘功能(社交分享、数据导出、主题切换)放到第二个迭代。第一版的目标是跑通闭环,不是功能齐全。

4.2 模型选择与提示词设计

不同任务用不同模型,这是保证产出质量的关键。我的经验是:业务逻辑生成用 DeepSeek,它的推理链比较完整,生成的代码注释也清楚;大文件重构和跨文件修改用 Claude Code,它的长上下文理解能力更强;UI 样式调整用 DeepSeek 配合截图描述,效果比纯文字描述好很多。

提示词的设计有几个要点。第一是给角色,比如“你是一个有五年经验的 React 开发者,注重代码可读性和边界处理”。第二是给约束,比如“不要使用任何外部 UI 库,样式用原生 CSS 写”。第三是给示例,如果你希望 AI 按照某种模式生成代码,先给它看一个你写好的样板文件。第四是给验证方式,告诉 AI 你会怎么测试这段代码,它会倾向于生成更容易测试的实现。

一个实际用过的提示词模板长这样:

角色:资深全栈工程师 任务:实现用户饮水记录的创建接口 技术栈:Node.js + Express + SQLite 约束: - 使用 async/await,不要用回调 - 输入参数做完整校验,返回明确的错误码 - 数据库操作封装在单独的 repository 层 - 写单元测试,覆盖正常流程和参数异常 输出:接口代码 + 测试代码 + 简要说明

4.3 本地运行与调试环境搭建

AI 生成的代码要在本地跑起来才能验证。WorkBuddy 内置了运行环境,但有些依赖需要手动装。我的习惯是在项目根目录维护一个setup.sh,把环境初始化命令都写进去,换机器的时候一键执行。

调试的时候,把报错信息完整贴给 AI,不要只贴最后一行。AI 需要看到调用栈才能定位问题。如果报错信息很长,先自己扫一遍,把明显无关的框架内部报错去掉,保留业务相关的部分。这样 AI 的分析准确率会高很多。

还有一个技巧是“二分法定位”。当 AI 改了几次都没修好一个 bug 时,让它把可疑代码注释掉一半,看问题是否还在。在的话说明问题在另一半,不在的话说明问题在被注释的部分。这样几轮下来就能锁定问题代码,比盲目修改效率高得多。

4.4 打包发布的关键步骤

Web App 的发布相对简单。Vercel 和 Netlify 都支持从 Git 仓库自动构建部署,推代码就自动上线。需要注意的几个点:环境变量在平台后台配置,不要写在代码里;构建命令和输出目录要配对,比如npm run build对应dist目录;自定义域名要配 DNS 解析,生效需要几分钟到几小时。

移动端 App 的发布复杂一些。以 React Native 为例,打包流程是:配置应用签名、生成 release 包、上传到应用商店后台、填写应用信息和截图、提交审核。审核被拒的常见原因我整理成了表格:

被拒原因具体表现解决方法
隐私政策缺失没有提供隐私政策链接用模板生成一份,部署到可访问的页面
权限说明不清申请相机权限但没说用途在应用描述和权限弹窗里写清楚用途
截图不合规截图里有测试数据或占位文字用真实数据重新截图,去掉调试信息
崩溃问题审核员操作时 App 闪退提审前在多种设备上跑一遍核心流程
内容违规用户生成内容没有审核机制加上举报和屏蔽功能,写进审核说明

5. 常见问题与排查技巧实录

5.1 AI 生成的代码跑不起来怎么办

这是最高频的问题。排查顺序是这样的:先看报错类型,语法错误直接让 AI 修,依赖缺失就装依赖,版本冲突就锁版本。如果报错信息指向的代码看起来没问题,那大概率是环境问题,检查 Node 版本、Python 版本、系统架构这些。

我遇到过一个典型情况:AI 生成的代码用了某个库的新特性,但我本地装的是旧版本。报错信息很隐晦,说某个方法不存在。后来让 AI 把库的版本要求写进package.json,重新安装就解决了。所以现在我的习惯是,让 AI 生成代码时顺便把依赖版本也定好。

还有一种情况是 AI 生成的代码逻辑正确但运行时报错,仔细看是变量名拼写不一致。AI 在长对话中容易把userName和username混用。解决办法是在规范文档里明确命名风格,并且让 AI 每次生成代码后自己检查一遍变量一致性。

5.2 需求变更时怎么高效调整

做 App 的过程中需求变更是常态。今天觉得提醒功能应该支持自定义时间,明天觉得应该加上好友排行榜。如果每次变更都从头改,项目很快就乱了。

我的做法是维护一个“变更日志”,每次需求变更时记录三件事:改什么、为什么改、影响哪些已有功能。然后让 AI 基于变更日志生成修改方案,而不是直接改代码。方案里要包含:需要修改的文件列表、每个文件的修改点、可能受影响的测试用例。确认方案没问题再让 AI 执行修改。

这样做的好处是变更可控。我试过直接让 AI 改代码,结果它改了一个地方但忘了改关联的另一个地方,导致功能异常。走方案确认流程虽然多一步,但避免了返工。

5.3 性能问题的排查思路

AI 生成的代码功能正确但性能差,这个问题在项目后期会暴露出来。常见的性能问题包括:数据库查询没有加索引、循环里做了重复计算、前端组件不必要的重渲染。

排查性能问题先用工具定位瓶颈。后端用日志记录每个接口的耗时,前端用浏览器开发者工具的 Performance 面板看渲染时间。定位到具体位置后,把相关代码和性能数据一起给 AI,让它给出优化方案。不要只说“太慢了”,要给具体数字,比如“这个接口在 1000 条数据时耗时 2 秒,目标降到 200 毫秒以内”。

5.4 数据安全与隐私处理

App 上线前必须处理数据安全问题。几个基本要求:用户密码必须加密存储,传输层用 HTTPS,敏感操作要有二次验证,数据库定期备份。

AI 生成的代码在安全方面经常有疏漏。比如密码直接明文存、SQL 查询用字符串拼接而不是参数化、API 密钥硬编码在代码里。这些问题需要 FDE 在验收时重点检查。我的检查清单是:搜一遍代码里有没有password相关的明文存储、有没有eval或exec这类危险函数、有没有把密钥写在代码文件里。发现一个改一个,改完让 AI 写个测试用例防止回归。

6. 工具链选型与协作效率提升

6.1 WorkBuddy 的缓存与配置管理

WorkBuddy 用久了缓存会变大,影响响应速度。缓存目录的位置可以在设置里查看,默认在用户目录下的隐藏文件夹里。定期清理缓存是个好习惯,但注意不要删掉项目相关的缓存,否则重新打开项目时要重新索引。

配置管理方面,我建议把个人偏好设置导出成配置文件,换设备时直接导入。包括:模型偏好、快捷键设置、代码风格配置、常用提示词模板。这些配置积累起来需要时间,丢了很可惜。

6.2 多模型协作的实际体验

DeepSeek 和 Claude Code 各有擅长。DeepSeek 在中文理解、业务逻辑推理、代码注释生成上表现更好,而且响应速度快、成本低。Claude Code 在跨文件重构、长上下文理解、复杂 bug 定位上更强,但成本高一些。

我的实际用法是:日常开发用 DeepSeek,遇到需要重构整个模块或者排查复杂 bug 时切到 Claude Code。WorkBuddy 支持在同一个项目里切换模型,切换时上下文会保留,不用重新描述项目背景。这个体验很流畅,比在两个工具之间复制粘贴代码高效得多。

6.3 版本控制与回滚策略

AI 生成的代码也要走 Git 流程。我的习惯是每完成一个可运行的功能就提交一次,commit message 写清楚做了什么。如果 AI 改坏了代码,直接回滚到上一个提交,比让 AI 修复更快。

分支策略上,主分支保持稳定,新功能在 feature 分支上开发。AI 在 feature 分支上怎么折腾都行,验证通过再合并到主分支。合并前跑一遍完整的测试用例,确保没有破坏已有功能。

提示:让 AI 生成代码时,要求它在修改的文件头部加上注释,说明修改时间和修改内容。这样回滚时能快速定位到是哪个提交引入的问题。

7. 从交付到持续迭代的衔接

App 上线不是终点,而是起点。用户反馈会告诉你哪些功能好用、哪些不好用、还缺什么。FDE 的价值在这个时候体现为快速响应迭代。

我的做法是维护一个“反馈池”,把用户反馈分类:bug 类、体验优化类、新功能类。bug 类优先处理,体验优化类攒一批一起改,新功能类评估优先级后排期。每次迭代从反馈池里取任务,用前面说的拆解和协作流程实现,然后发布新版本。

迭代节奏上,初期建议两周一个版本。太频繁用户跟不上,太慢反馈积压。等产品稳定了可以拉长到一个月。每次发版前写清楚更新日志,告诉用户改了什么,这能提升用户对产品的信任感。

这套流程跑通之后,你会发现从一句话需求到上线 App 的周期可以稳定在四到六周。第一个项目可能慢一些,因为要踩坑和建立工具链。第二个项目开始加速,第三个项目基本就是流水线作业了。FDE 的核心竞争力不在于写代码有多快,而在于把需求翻译成 AI 能执行的指令、把控产出质量、处理边界情况的能力。这些能力需要项目实战来积累,90 天的时间足够你从入门到独立交付,前提是每个阶段都扎实走完,不跳步。

RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进