野生码农
一句差评引发的开发流程重构复盘:从交付断流到系统定名 OPCAIOS
环境说明:本文涉及系统为笔者自研的一人公司管理系统(AI 驾驶舱),运行于本地开发机;协作方为 AI 总调度(军师)与数字员工团队;U盘为在研 AI 课程产品(v3 已产出、v4 改造中,未上架)。时间:2026 年 10 月 7 日晚。
一、现象
对 U盘 v3 做质量评审时发现三类问题:
- 界面缺乏设计美感,文档型教程通篇无一配图,达不到上架标准;
- 内容残留内部引用标记
[来源:kb...]共 182 处,分布在 24 个文件,该类标记在页面上不可点击,属内部痕迹外泄; - 进一步追问"内容是否进入系统产线"后,发现产品骨架虽在驾驶舱内(13 阶段挂 46 个交付物),但版本文件更新日期停留在 2026-09-25——10 月 6 日交付的四个任务单,无一回灌系统。
二、排查
1. 交付断流确认。 流程明文规定"验收必含回灌",四单均未执行。系统内状态与系统外实际交付脱节长达十余天。归档旧产线前的核对又暴露三处遗留:一个字段未迁移、一个页面硬编码读取旧库、46 条交付物的预览文件仍存于旧系统(直接归档将导致整片 404)。
2. "有系统不用系统"。 系统具备 13 阶段过程跟踪、阶段事项管理与 T1 待拍板工作台,但待拍板事项仍在聊天中口头征询,未走系统。进一步核查发现 T1 工作台只有展示与标记完成功能,缺少录入入口——待办事项无处可录,属系统缺口。
3. 会话目标漂移。 会话起始目标为 U盘整改,实际三小时全部投入系统修复,U盘 v4 本体未改一行。复盘指令链后确认每一步均由需求方亲口拉动,定性为:"磨刀三小时,砍柴零刀。"
4. 体验别扭的根因定位。 针对"武器清单、武器评级、扫描镜像等页面看着别扭但说不出原因"的体感,逐项对照后定位为:系统长成了数据库后台,而非驾驶舱。
| 表面症状 | 底层根因 |
|---|---|
| 页面堆叠大量字段 | 数据库表直接铺上前端 |
| 评级只显示编号 | 查询未做关联,名称取不出 |
| 内容只能看不能改 | 以文件浏览器思维做产品 |
| 应用场景空置 | 功能先行,数据未灌入 |
| 扫描镜像不透明 | 数据来源不可见 |
| 页面调一次烧一次 token | 未经验证直接上大模型 |
过程层面同时存在三处断裂:设计简报面向工程师而非决策人;原型未交互打通即跳闸开工;验收只验工程指标,不验实际使用动线。
三、根因
团队岗位齐备,唯独缺失产品经理环节。没有 PRD(范围需求),需求不清时 AI 执行越快、偏差越远;开发模式属"缩水的瀑布"——披着瀑布模型的外壳,缺失每一阶段的评审闸,等同开盲盒。SDLC(软件开发生命周期)教科书口径分六段,每段有交付物与出口闸门,闸不过不得进入下一段;同一错误在需求阶段修改是一句话的事,拖到上线后修改代价大十倍。
四、解决
- 立规"拍板入系统":待确认事项一律录入 T1 工作台,聊天只提醒不替代;系统无入口即按系统缺口立卡补建。补建 36 分钟收口,验收不进执行报告、直接查库对账:9 个阶段 done、3 个 todo、1 个 doing,种子数据 102 条在库,数字一致方算完成。
- 产品职责前置:在"单立产品经理岗(A)"与"产品职责前置进现有岗位并加两道闸(B)"之间选定 B 方案——既有的 28 个设计技能本就在产品设计岗内,不再增设重复岗位。
- 系统定名 OPCAIOS:原"驾驶舱"概念降级为其中一个模块。注意:OPCAIOS 是刚定名、待按新流程重构立项的对象,并非完工系统。
- 规则先行的实施顺序:先将软件开发流程固化进配置,以驾驶舱整改为第一个样板,再开展立项与 PRD。同时补齐既有设计规范(图标、命名、配色)的走查单——规范本身专业,但此前一次未用于驾驶舱开发。
- 原型路线定型:采用 HTML 高保真可点原型(真组件加假数据),过闸后骨架直接复用进正式开发,零浪费。排除墨刀(产出图需丢弃重做)与自研原型工具(本末倒置)。结论:原型必须点得动,图片和文字稿均不算原型。
- 目录规范落地:统一项目文件夹为 12 个标准目录,附加两条修正——测试脚本不进代码目录、验收文件不算临时文件。目录规范即系统的数据接口:结构标准化后,扫描器才能自动灌库,项目全景页与时间轴才有数据源。
五、预防
- 先写范围需求再动手,范围不清,AI 越快偏得越远;
- 原型必须可交互点击方算数;
- 每个阶段设一道决策人验收闸,验使用动线而非仅验工程指标;
- 目录规范按系统数据接口设计,杜绝产出游离于系统之外;
- 落盘不等于进库:文档写完必须执行同步。本次会话纪要落盘后未进知识库检索层,补跑同步后新增 13 条、更新 8 条,验证通过。
六、结语
需求阶段一句话即可修正的错误,拖到验收阶段即演变为设计、开发、测试的整轮返工。本项目即是反面样本:无 PRD、原型跳闸,开发过半后全盘别扭,返工的种子在跳闸当日即已埋下。对团队而言,养一个产品经理环节、或为现有岗位加两道闸,换来的是整个项目不开盲盒。
我是野生码农,AI实战派。17年全栈工程师,一人AI公司实践者。打造个人IP内容体系、软件全链路产品产线,拥有百套企业AI方案、200多个岗位Agent;自研知识库、AI数字员工系统,公开实战复盘。
本文所有内容均为本人 AI 实战的过程和结果,经 AI 整理后发布,无任何瞎编虚构内容。
野生码农AI实战 · 全网同名