6人小团队用 AI 开发 WMS，怎么解决文档和系统对不上的问题？

开发调优
, ,
1

佬友们好，想请教一个实际开发中遇到的问题。

我们是6人的全栈团队，做海外仓 WMS，技术栈是 Spring Boot、Vue、Liquibase，还有单独的文档项目。系统支持中英文，菜单、路由、权限和多语言数据都在数据库里。

团队里每个人主要负责自己的模块，部分业务又有交叉。目前需求、开发、测试、翻译和文档基本都在用 AI 辅助。

一般是先和AI聊需求，然后开发功能，开发过程中补中英文，最后再写用户手册和翻译文档。

现在的问题是，时间长了以后经常对不上：

  • 文档里的流程和系统实际操作不一样；
  • 权限、状态和异常情况写得不准确；
  • 系统英文和文档英文用词不一致；
  • 不同开发负责不同模块，同一个业务概念可能有不同叫法；
  • 测试、代码和文档虽然都是AI写的，但不一定真的符合最初的业务意思；
  • 后面如果用这些文档做RAG，感觉还会把错误继续放大。

比如“可用库存”“可分配库存”“锁定库存”“冻结库存”这类词，在不同模块、不同页面和文档中很容易混用。中文都可能没统一，更别说英文了。

想问问佬友们，有没有遇到过类似问题？你们是怎么保证系统功能、测试、中英文和用户手册长期保持一致的？

我们人少，不太想上很重的管理平台，更希望有一套简单、能在现有项目上慢慢加的做法。如果有开源项目或者实践经验，也请佬友们推荐一下。

补充：我不是想问怎么自动更新文档，而是想让一条业务规则只定义一次，然后让代码、测试、系统中英文、用户手册和RAG共同引用，并通过脚本发现它们是否偏离。有没有人做过类似的“业务语义单一事实源”？

11 个赞
2

1 让AI 整理代码和文档。 提取业务专用术语。 出一个skill。 团队分发。 以后讨论需求和更新文档通过 这个skill 来统一表述

2 工作流强约束，让ai 自动维护文档。可以通过ci 钩子再服务端实现。

2 个赞
3

一个人干吧，一个人比多个人干的快

5 个赞
4

是不是说明没有一个有经验的产品？这种情况盲目用 AI 蹬出来未来会出现大量重构工作

5

可以跑ci 每天下班后自动更新文档

6

佬友，你说的不错，这确实是现状，AI 黑盒开发的。24年AI开始兴起时迭代到现在。

7

佬友好，其实我就是在思考这种工作方式，如何让业务变成元数据，能在团队，系统协作的过程中保持一致，简单的skill，解决不了这种问题，因为要深入到，AI 自动翻译，AI 代码开发，AI 写使用手册等等。

8

佬友好，这确实可以解决写文档的问题，但是我的问题是如何保持翻译、代码、文档中的业务一致性。

9

我也经历过两年的 MOM 系统开发，由于零产品经验每个业务都参考金蝶摸索不断碰壁重构，特别是上线生产环境后版本迭代出现差距差异，整整背了两年的锅，建议将精力更多投入到产品规划中

10

先找准问题在哪，这样的问题在团队个人的对齐，不在ai
ai是辅助，开会对齐所有盲点。

管你这那的，全部按照产品经理和团队管理的项目文档和规范文档开发
审核不通过打回去重做。

11

那你可以先用翻译为准 让代码和文档向翻译对齐就好了

12

佬友好，我们经历非常类似，当前的产品就是几个技术，看了产品经理维他命的书，然后参考一些saas 然后做出来的，但是时间不等人，又要coding，又要处理项目上各种事情，是在没有精力了。

13

小团队，都是技术，没有产品经理，测试这些岗位，全干工程师哈哈。

14

我的评价是先弄一个产品规范化所有的名称和对应的功能，要不然这些事情还是会出现的

1 个赞
15

看你们的文档 是用什么工具写的，如果是word等这些就很简单，让MCP直接读取就可以了，如果是飞书这些，就得让MCP安装飞书CLI，再用CLI把文档 下载下来去核对，并将需求文档保存到MCP的指定位置 。保证需求文档 有更新就下载。

16

得有产品管理才行，要不然工程师都在扁平开发 谁都看不起谁的规范，得有牵头的才能进行下去

3 个赞
17

一个人规范定制开发规范和开发字段名。然后基础设施都由一个人开发。例如权限控制，路由，多语言规范。然后再根据业务分发任务。 不然每个人开发业务的时候 都去做权限控制都不一样，不全乱套了吗。
以及 这是实体产业，建议人工体验仓库工作过后再开发。不然建立在美好幻想上，现实是不可行的。

18

我接触过WMS

正常流程不应该是 设计书文档/流程手册 → 系统 ？ 这样业务和名词不就统一了

你们这是违规流程倒过来的 不一致我感觉很正常 Ai的实现方式五花八门 你后续再去补文档肯定不一致

19

佬友，能详细说说这种功能吗？意思是给人用的？

20

本质是开发流程的问题,跳过了蓝图阶段,我们现在改为了DDD的模式,必须先有概念定义,让ai把在domain层先将测试和功能全部实现了,在去做vue界面

1 个赞