JOTO
Contact us
← AI 智库
大语言模型

万字图文讲透 AI Native 研发体系:四个维度建起你的 AI 生产线

2026 年 10 月 26 日

文章指出AI工具普及后团队整体交付未提速,主因在于生产体系未适配AI特性。提出四个升级维度:AI原生(规则文件化、约束工程化)、系统工程(需求数字线程与阶段门禁)、组织能力(经验版本化沉淀)、多角色协同(角色专属Agent)。核心是将隐性规范、上下文和判断转化为可加载、可验证、可审计的结构化资产。

每个人都快了,然后呢?

一次代码评审会上,一位后端工程师提交了前端页面。功能跑通了,界面也能交互。

评审人却不敢把这段代码合进主分支。满屏都是临时样式类名,绕过了团队的组件库,接口直接调用而非走统一封装层,图标和按钮全是手写实现。代码能运行,但没法被团队接手维护。

这不是个例。产品人员用 AI 搭出可交互原型,设计师直接把界面做成代码。每个人都能生产,但产物风格各异、规范不一。A 同学做的页面像后台管理模板,B 同学做的像官网落地页,摆在一起不像同一套产品。

能运行的代码,不等于能被团队接手的代码。

还有一种更隐蔽的浪费。产品人员用 AI 做出原型,大家讨论完,代码就停在会议室里。轮到实现环节,前端照着原型再做一遍。原型的生成成本降了,后续交接方式却没变。局部的省时,变成了下一环的加班。

AI 让每个人的手变快了。可团队整体交付并没有同比例提速,质量风险反而浮出水面。问题不在工具本身,在于生产代码的团队体系没有跟上。

这就像给工厂每个工位都发了电钻,却没有重新设计生产线。单台机床转速再高,整线产能依然卡在工序之间的传送带上。瓶颈总在交接处,不在工位上。

要让团队真正变快,需要在四个维度上完成跃迁。这四个维度的划分,来自对近半年 AI Native 实践趋势的观察总结。它们不是必须按顺序走完的台阶,而是可以并行推进、互相支撑的四条升级线:

维度核心转变解决的根本问题
从 AI 辅助到 AI 原生体系为 AI 而生,而非人适配 AI产出不稳定、规范难统一
从单点提效到系统工程优化对象从岗位速度换成交付周期上下文在交接处丢失
从个人探索到组织能力经验从聊天记录变成版本化资产换人换模型就得从头来
从开发独用到多角色协同每个角色都有约束内的 Agent开发一个人扛全线

你可以从最痛的那个维度先切入,跑出效果再扩展到其他维度。下面逐一展开每个维度的问题、困难和解法。

维度一:从 AI 辅助到 AI 原生,让体系为 AI 而生

关键问题:外挂式 AI 为什么越用越乱?

多数团队引入 AI 的方式,是在现有工作流旁边开一个对话框。工程师遇到问题就问 AI,拿到答案后自己判断、自己整合到代码里。

这种方式在个人使用时很灵活,但放到团队协作中就暴露了三个致命缺陷:

  • 行为不可控:同一个任务,问三次可能得到三种写法。AI 不知道团队的组件库叫什么、接口该走哪层封装、老项目有什么兼容坑。它只能给出“通用正确”的答案,而不是“团队正确”的答案。
  • 规范难统一:规范停留在口头约定或 Wiki 文档里,AI 不会主动去读。每个人跟 AI 对话时带进去的背景信息不同,产出自然五花八门。
  • 经验存不下来:今天你跟 AI 磨合出了一套好用的提示词,明天换个会话窗口就丢了。团队成员之间也无法共享这些临时摸索出来的经验。

结果就是:省下的时间又被返工吃掉。 表面上每个人都在用 AI,实际上团队在为 AI 的不确定性反复买单。

具体困难:三条老路为什么走不通?

意识到问题后,很多团队尝试过常规解法,但都碰了壁。

第一条路:给全员补基础课。有团队做过系列培训,讲环境安装、框架用法、样式规范、调试技巧。知识有用,但即使认真学完,仍没人敢大胆动手。

因为真正的门槛不在课程里,而在多年具体工作留下的工程判断:这个接口为什么必须走那层封装?这个组件在哪个版本里有兼容问题?这个老项目为什么不能按新项目的方法装依赖?让另一个角色先学得像个专家再跨端动手,门槛几乎没有降低。

第二条路:建传统知识库。方向看起来很稳妥,做起来才发现三处卡点。

一是现状没盘清,前后端项目技术栈各异、版本参差,技术债尚未理清就急着写规范,文档很容易把旧问题固定下来。二是冲突缺少仲裁,不同人对正确写法各有理解,没有明确的负责人和评审机制,规则之间会打架。三是用的时候没入口,需求已经在对话框里了,AI 已经准备写代码了,临时塞进提示词的规范效果并不好,每次都需要人工反复交代。

第三条路是换一个大而全的平台:把现有工具链连根拔掉,先付一大笔迁移成本,产出体验却不一定更好,团队还得重学一遍手感的债。

三条路的共同问题是:它们全押在 AI 动手之前的准备上。 课提前上了,文档提前写了,平台提前换了,可真正生成代码的那一秒,没有任何一道闸门是自动关着的。

外挂式AI辅助与AI原生体系对比示意图

解决步骤:把判断写成文件,让文件驱动执行

换个思路:不逼人在事前做足准备,而是让规则在代码落地的那一秒自己生效。具体分五步。

第一步:盘点仓库,识别技术栈分类。

不要试图用一套规范覆盖所有项目。有团队把十几个项目分成三类:

分类特征约束策略
遗留项目老框架、老依赖、改动需格外谨慎严格限定可用组件和 API 范围
主流项目主流框架、有完整组件库按团队标准写法执行
新项目新技术栈、规范尚在建立允许更大自由度,但记录决策

每类对应不同的约束策略。这一步的关键产出是一张技术栈分类表,后续所有规则都基于这张表来写。

第二步:把判断写成结构化文件。

“能不能上线”的标准不再是口头约定或一次性提示词,而是 AI 每次执行时自动加载的约束文件。举个例子,与其每次跟 AI 说“我们项目用的是 TeamUI 组件库,不要用其他库”,不如在项目根目录放一个 .ai/rules/ui-framework.md,内容写明:

# UI 框架约束
- 本项目使用 TeamUI(@team/ui-components)
- 禁止引入其他第三方组件库
- 图标统一使用 @team/icons,不手写 SVG
- 表格组件只用 ,不用 div 模拟

AI 在执行前自动读取这个文件,就不需要你每次重复交代了。规则即文件,文件驱动执行,执行结果可审计。

第三步:设计技能的五维结构。

技能(Skill)是写给 AI 看的工艺手册,记录某类活儿怎么干好的方法。一个完整的前端技能包含五个维度:

维度解决的问题示例
进入项目读取什么配置才能理解当前项目读 package.json、tsconfig、.ai/ 目录
识别技术栈判断当前项目属于哪个分类根据依赖版本判定为“遗留项目”
确认写法该用什么组件、什么模式、什么禁忌查 ui-framework.md 确认用 TeamUI
查找样板去哪里找已有的正确实现作为参照搜索 src/pages/ 下同类页面的写法
接入能力怎样对接已有的公共能力导入统一的请求封装、埋点 SDK

这五个维度确保 AI 不是凭空发挥,而是在团队既有的工程语境里工作。写技能时,按这五个维度逐项填写,就不会遗漏关键约束。

第四步:建立双层资产架构。

团队规范和个人项目配置需要分层管理:

# 双层目录结构示例
user-level/           # 用户级:团队通用规范
  skills/lint.md      # 通用代码检查技能
  rules/naming.md     # 命名规范
project-level/        # 项目级:随代码仓托管
  .ai/skills/         # 本项目专属技能
  .ai/rules/          # 本项目专属约束

加载顺序是项目优先、通用兜底。 AI 执行时先加载项目级规则,找不到再回退到用户级。这样做的好处是:团队能力升级时全项目无感生效(改用户级即可),项目定制只需少量配置(在项目级覆盖)。

第五步:配套约束工程。

约束工程(Harness Engineering)是给 AI 套上缰绳。前面四步解决了“AI 知道该怎么做”的问题,这一步解决“AI 不会越界做”的问题。

具体来说,需要把以下约束落实到系统里,而不是指望模型自觉:

约束类型说明落地方式
角色约束AI 以什么身份执行在 Skill 开头声明角色和职责边界
权限约束哪些操作允许自动执行配置文件读写白名单、禁止删除操作
验证约束产出必须通过什么检查自动运行 lint、单元测试后才算完成
终止约束什么情况下必须停下来连续失败 3 次、超出时间上限时交还给人

凡是停留在提示词里的规范,都不算真正落地。只有写成文件、嵌入流程、可被系统强制执行,才算数。

注意要点

  • 技能要有明确的负责人、版本号和仲裁流程,避免规则打架无人裁决。
  • 加载顺序必须是项目优先、通用兜底,否则团队升级无法平滑生效。
  • 最核心的一条:规则即文件,文件驱动执行,执行结果可审计。
flowchart LR
    subgraph 外挂式AI辅助
        A1[人的意图] --> B1[对话框]
        B1 --> C1[旧流程]
        C1 --> D1[人兜底判断]
    end
    subgraph AI原生体系
        A2[人的意图] --> B2[约束体系]
        B2 --> C2[可替换Agent]
        C2 --> D2[结构化产物]
        E2[技能与规范] -.->|自动加载| C2
    end

图:外挂式与原生式的本质区别

回到工厂比喻。AI 辅助是给工人发电钻,工艺规程还是贴在墙上的海报,靠人记住并执行。AI 原生是为电钻重新设计整条生产线,工艺规程直接写成机器可执行的程序。

维度间的关系:AI 原生解决的是“AI 产出可控”的问题。但如果只做到这一步,你会发现:每个人的产出确实可控了,可需求从提出到上线的整体周期并没有缩短。因为产出可控只是单点效率的前提,真正耗时的是点与点之间的等待和交接。这就引出了第二个维度。

维度二:从单点提效到系统工程,优化的对象是交付周期

关键问题:为什么每个人都快了,整体还是慢?

当 AI 让每个角色的输出速度都提升之后,一个新的瓶颈浮现出来:上下文在交接处丢失。

传统研发链路里,客户诉求被逐角色翻译。产品人员翻译成需求文档,设计师翻译成交互稿,后端翻译成接口,前端翻译成页面。随后代码还要跨过网关、数据库、环境、测试、审批和文档平台。

角色间的交接往往伴随着原始意图、约束条件和权衡取舍的流失。前端拿到设计稿时,不知道为什么某个按钮要放在右上角;测试拿到代码时,不知道这次改动的业务背景是什么。局部都完成了,整体仍在等待。真正耗时的不是某个岗位的输出速度,而是等待对方、重新解释背景,以及发现上一个环节遗漏了自己需要的信息。

AI 缺少完整上下文时,会基于不完整信息补造接口、字段或预期结果。产出看似合理,实则偏离目标。

只要需求还在系统之间反复失忆,任何单点提效都会被下一个等待环节抵消。

具体困难:为什么“加强沟通”解决不了交接失忆?

面对交接失忆,团队的第一反应通常是“加强沟通”:多开会、多写文档、多用协作工具。但这些做法在实践中碰到了几个结构性障碍。

障碍一:信息的保质期比沟通的频率短。 产品人员在周一澄清了一个需求细节,周三开发才开始做,中间隔了两天。这两天里,代码仓库有了新提交,接口定义改了,之前的澄清可能已经过时。口头沟通和即时消息没有版本概念,无法回答“这个结论现在还成立吗”。

障碍二:文档写了没人看,看了对不上。 团队花精力写了详细的需求文档和设计文档,但开发拿到手时发现文档描述的和实际代码对不上。因为文档是静态快照,代码是动态演进的。文档说“接口返回 userId”,代码里已经改成了 “user_id”。AI 读了旧文档生成的代码,自然跑不通。

障碍三:原型开完会就成了弃稿。 产品人员用 AI 做出可交互原型,大家讨论完方案,代码就停在会议室里。轮到实现环节,前端照着原型再做一遍。原型的生成成本降了,交接方式却没变。前端接到的不是一件快完成的成品,而是一套可以演示运行、却还需要重新接入工程体系的实现。

这三个障碍的共同根源是:信息没有跟着需求的生命周期一起流动。 沟通是瞬时的,文档是静态的,只有把信息组织成一条随需求持续生长的线索,交接失忆才能真正解决。

交接失忆的结构性障碍示意图

解决步骤:建立需求数字线程,让上下文沿链路传递

第一步:定义需求数字线程。

数字线程是把需求、上下文、决策、产物与验证组织成一条持续生长、不中断的线。这条线要做到五个连续:

连续性含义反面案例
目标连续为什么做始终可追溯开发做到一半忘了原始诉求是什么
决策连续每个选择的依据都有记录新人接手不知道当初为什么选了方案 A
产物连续每阶段的交付物有明确版本测试用的接口文档和开发用的不是同一版
状态连续当前进展到哪一步随时可查项目经理挨个问“你做到哪了”
学习连续历史经验能反馈到新任务上次踩过的坑这次又踩了一遍

数字线程不是一个新系统,而是一种组织信息的方式。它可以落在现有的需求管理工具、代码仓库和 Wiki 的组合之上,关键是让每条信息都带来源、时间和版本标注。

第二步:建立阶段生命周期。

一套需求交付系统将完整交付过程分为若干阶段,每个阶段有明确的输入、输出和门禁条件。以十个阶段为例:

阶段最小输入最小输出门禁条件
需求进入与建档来源快照唯一需求 ID + 责任人确认信息完整度检查
评估与澄清需求描述澄清记录 + 可行性结论产品与技术双方签字
方案设计澄清后的需求技术方案 + 接口定义方案评审通过
排期与资源确认技术方案排期计划 + 资源分配各方确认
开发接口定义 + 设计稿代码提交 + 构建产物单元测试通过
集成各模块构建产物集成测试结果集成测试通过率达标
测试集成产物 + 测试用例测试报告 + 缺陷清单阻断级缺陷为零
预发布验证测试通过的产物预发布验证报告关键路径验证通过
正式发布预发布验证报告发布记录 + 监控确认人工授权
运营反馈线上数据反馈记录 + 改进项归档并反馈到下一轮

每个阶段的“最小输出”就是下一阶段的最小输入。没有产出就不能推进,产出不合格就不能放行。

第三步:为每阶段定义最小证据。

“最小证据”是该阶段完成的硬性凭证,不是可选的附加材料。举两个例子:

  • “需求进入与建档”阶段的最小证据:唯一需求 ID、来源快照(截图或链接)、责任人确认记录。缺任何一个,需求就不能进入评估。
  • “开发”阶段的最小证据:关联的代码提交(commit hash)、构建成功记录、单元测试通过截图。AI 说“代码写完了”不算数,磁盘上有文件、代码仓里有提交、构建系统有结果,才算真正完成。

“Agent 已完成”不能代替真实产物。 这是最容易犯的错误。

第四步:建立质量门机制。

质量门像流水线上的质检站,不合格不放行。关键在于失败后的分流处理,而不是简单打回重来。

在实践中,失败至少可以分为四条通道:

失败类型处理方式示例
代码缺陷返回修复单元测试失败、lint 报错
被测对象缺陷交给研发定位接口返回不符合规格
环境依赖缺失进入环境处理测试环境缺少配置项
基础设施故障交给平台恢复构建服务器宕机

暂时无法判断的保留为待裁决状态,进入人工处理。失败按证据分流,而不是靠人来回核对。

第五步:用阶段契约替代口头约定。

每份结论绑定明确版本和输入产物,下游才能判断这句话现在是否仍然有效。阶段之间的传递靠结构化产物,而不是聊天记录或口头交代。

举个例子,测试 Agent 输出的不是“测试通过了”这句话,而是一份结构化报告:

{
  "testReportId": "TR-2026-0892",
  "codeVersion": "commit-a3f8c21",
  "testCaseVersion": "release-2026Q3",
  "passedCount": 47,
  "failedCount": 0,
  "evidencePath": "/artifacts/TR-2026-0892/"
}

下游的发布 Agent 读到这份报告,能验证代码版本是否匹配、测试用例是否是最新版,而不是盲目信任一句“通过了”。

注意要点

  • 上下文就是 AI 干活时需要知道的全部背景:为什么做、为谁做、有哪些约束和风险。每条重要信息应带来源、时间和置信度标注,而不是裸文本堆砌。
  • 容量模型的价值不在精确日期,而在显性化资源约束,让排期讨论有据可依。
  • 当阶段契约和证据记录体系真正运转起来时,团队可以做到多个模块并行推进、数周内从零到上线、数百次提交都有据可查。可能没有一行代码是人手写的,但每一行都是人设计、人验证的。这种效率的背后,不是某个人的超能力,而是一套完整的工程体系在支撑。
flowchart TB
    A[需求进入] --> B{评估门禁}
    B -->|通过| C[方案设计]
    B -->|不通过| A
    C --> D{设计门禁}
    D -->|通过| E[开发与集成]
    D -->|不通过| C
    E --> F{质量门}
    F -->|通过| G[测试验证]
    F -->|代码缺陷| E
    F -->|环境问题| H[环境处理]
    G --> I{发布门禁}
    I -->|通过| J[正式发布]
    I -->|不通过| E
    H --> E

图:需求交付的阶段生命周期与质量门机制

整线产能看节拍,不看单台机床转速。工位之间的半成品必须带流转单,质检站发现问题就地返修。当上下文沿着链路传递而不是在交接处蒸发,单点的快才能累积成整体的快。

维度间的关系:系统工程解决了“上下文沿链路传递”的问题。但当这套体系跑起来之后,你会发现一个新问题:体系的设计者是你,体系的执行者也主要是你。一旦你休假、离职或换了个项目,这套体系还能运转吗?如果有效方法只存在于你的脑子里和你的聊天记录里,团队就没有真正获得能力。这就引出了第三个维度。

维度三:从个人探索到组织能力,让经验产生复利

关键问题:为什么一次成功不等于团队会了?

当你用 AI 高效完成了一个需求,整个过程行云流水。但换一个同事来做类似的需求,他不知道你用的是什么提示词、参考了哪个样板、避开了哪些坑。他得从头摸索一遍。

如果有效方法停留在个人的提示词、聊天记录和临时脚本里,换个人、换个模型、换个需求,团队就得从头再探索一遍。 只有把经验沉淀为版本化、可验证、可复用的组织资产,AI 能力才会产生复利。

具体困难:四条容易被混淆的等式

实践中有四条容易被混淆的等式,每一条都对应真实的踩坑场景。理解它们,才能理解为什么“把经验分享给大家”这种朴素想法行不通。

聊天记录记的是过程,不是状态。 需求背景、执行过程和关键判断如果主要留在聊天记录里,会话中断、模型切换或人员交接后,接手者仍要重新判断现在到底做到哪一步。一个人上午和 AI 讨论了方案,下午换了个会话窗口,之前的判断就断了。聊天记录是线性的、私有的、易碎的,而工程状态需要是结构化的、共享的、持久的。

模型说“过了”,不等于有凭证。AI 说“测试通过”“改动完成”,如果没有与当前代码版本、输入产物和自动检查结果绑定的证据,下游无法判断这句话是否仍然有效。今天说通过了,明天代码变了,昨天的结论还成立吗?模型的输出是瞬时的,验证证据必须是带版本的、可追溯的。

自动化铺得越开,越不等于交得出去。 如果 Agent 可以自行推进流程、批准评审、推送主干或触发部署,局部效率提升可能换来更大的质量与权限风险。跑得越快,出错时影响面越大。自动化解决的是执行速度,交付能力还需要包含质量控制和风险边界。

赢了一次,不代表团队赢了。 大量有效方法仍停留在个人输入说明和临时脚本中。换一个 Agent、换一个人或进入另一个需求后,团队又从头探索。个人经验是隐性的、情境依赖的,组织能力必须是显性的、可迁移的。

还有一种叫幻觉验证的现象尤其危险。AI 先编了一套接口说法,再拿这套说法给自己的代码打分,自己出题自己阅卷,分数自然全是满分。看似形成了检验回路,实际上只是在空转。比如 AI 生成了一个接口定义,又用这个定义去验证自己写的调用代码,两边都对得上,但接口本身就是编造的。

幻觉验证示意图

解决步骤:把个人经验变成版本化的组织资产

第一步:建立分层事实体系。

将事实分为五类分层管理,各管各的事实,又能相互引用和核对:

事实类型负责系统典型内容为什么单独管理
业务事实需求系统需求描述、优先级、验收标准业务语义不应被代码变更覆盖
执行事实代码仓库提交记录、分支、构建产物代码版本是唯一可信的执行记录
质量事实验证系统测试结果、覆盖率、评审记录质量结论必须绑定代码版本
过程事实执行日志运行状态、耗时、异常记录过程数据用于复盘和优化
领域事实知识库技术规范、最佳实践、历史案例长期知识独立于具体项目演进

工程状态不再活在聊天记录里。任何时候有人问“现在做到哪了”,答案来自系统里的结构化数据,而不是翻聊天记录。

第二步:技能版本化管理。

技能文件跟代码一样纳入版本控制。团队沉淀的做法要跟着代码一起打标签:代码走到哪一版,规则就配到哪一版,执行前先核对版本和适用范围。

举个例子:某个“前端页面创建”技能有两个版本,新版增加了响应式布局规则,但只适用于新项目。当一个遗留项目触发这个技能时,系统会自动匹配适配老框架的旧版,而不是错误地应用新版规则。技能版本与项目分类绑定,避免错配。

第三步:搭建知识库体系。

以 Markdown 为载体、Git 做版本管控、索引机制按需加载。知识更新有三类触发机制:

触发方式时机示例
代码合并触发主干代码合并时新增了一个公共组件,自动同步到知识库
会话结束触发AI 会话结束时自动抽取本次会话中的可复用经验
人工录入触发随时资深工程师补充一条历史踩坑记录

知识不再是某个人脑子里的经验,而是团队共享、持续演进的资产。

第四步:建立双重质量保障。

单一的质量检查容易有盲区,需要两套独立机制互相校验:

  • 开发期 TDD 循环:先写测试、再写实现、跑通后提交。测试定义了“正确”的标准,实现去满足这个标准。
  • 部署后接口自测循环:调用真实接口、比对预期结果、记录偏差。验证实际运行是否符合预期。

两套机制独立运行,互相校验。写代码的 Agent 不能同时证明自己正确并批准合并,这就是编审分离的核心原则。

第五步:技能自我迭代。

从多次任务的执行证据中提取改进方向,经过智能分析、自动优化、评测验证后发布新版本。

关键约束:一次成功案例不能直接证明技能已进化。 需要经过标准化评测、对比基线、确认改进稳定可复现后,才能认定为组织能力的提升。就像药物不能因为一个病人吃了有效就宣布上市,需要经过临床试验。

第六步:可替换 Agent 设计。

模型和工具会不断换代,但约束、技能和证据资产留在体系里。把分析和生成工作交给模型,把流程控制和高风险操作留给规则明确的程序和人工。

今天用的是模型 A,明天换成模型 B,技能文件和约束规则不需要重写。体系的价值不依赖于任何特定模型。

注意要点

  • 编审分离是消除自查盲区的核心机制。 写代码的 Agent 不能同时证明自己正确并批准合并,必须由独立的审查角色来验证。
  • 体系的目标可以概括为四个词:可恢复、可验证、可协作、可改进。 做不到可恢复,中断后就只能重来;做不到可验证,产出就不可信;做不到可协作,就只能一个人扛;做不到可改进,今天的成功就是明天的天花板。
flowchart TB
    subgraph 分层事实体系
        F1[业务事实] --- F2[执行事实]
        F2 --- F3[质量事实]
        F3 --- F4[过程事实]
        F4 --- F5[领域事实]
    end
    subgraph 双重质量保障
        L1[开发期TDD循环] --> L2[部署后接口自测]
        L2 -->|偏差反馈| L1
    end
    F3 -.->|提供验证依据| L1
    F4 -.->|记录执行过程| L2

图:事实分层管理与双重质量保障的关系

老师傅的手艺写进工艺手册并纳入版本管理,生产台账与质检留痕构成追溯体系。换机床不换图纸,这才是组织能力。

维度间的关系:组织能力解决了“经验可复用”的问题。但当你的团队已经建立了完善的技能体系和知识库,你可能会发现:所有这些工具和能力都是给开发用的。产品人员和设计师的工作仍然没有被 Agent 承接,丢过来一份文档或一张设计图,剩下的全靠开发去拉齐、去补齐。这条线绷得再紧,也只是开发一个人在扛。要把线织成面,就需要第四个维度。

维度四:从开发独用到多角色协同,Agent 跑流程人守闸口

关键问题:为什么只给开发配工具是不够?

一套工具链覆盖了需求、编码、发布的完整流程,开发的效率确实上了一个台阶。但回头审视这条链路时发现,所有工具全都是给开发用的。不管是写规格文档还是预审查,都需要开发同学主动去执行。

一个真实的研发流程远不止开发这一个角色。产品人员和设计师站在流程之外,丢过来一份文档或一张设计图,剩下的全靠开发去拉齐、去补齐、去追着问。这条线绷得再紧,也只是一个人在扛。

要把线织成面,就需要让每个角色的工作都能由各自约束内的 Agent 承接,而不是所有事情都经过开发的手。

具体困难:多 Agent 协作为什么容易失控?

让多个 Agent 各司其职听起来美好,实践中却有三个容易失控的风险。

风险一:Agent 越权。 一个调度 Agent 本来只负责分发任务,结果一时“手痒”自己写起代码来。一个测试 Agent 本来只负责验证,结果顺手把代码改了。多 Agent 协作最怕的不是不干活,而是越权乱干。每个 Agent 的职责边界如果不硬编码到系统里,光靠提示词说“你不要做这个”是靠不住的。

风险二:长会话权限失控。 一个 Agent 在一个长会话里同时决策、执行并证明自己正确,权限就会失控。它既能定方案又能写代码还能批准合并,出了问题连追责的路径都没有。就像一个员工同时兼任产品经理、开发和 QA,没有任何制衡。

风险三:模糊需求被脑补填充。 调度 Agent 收到一条不完整的需求,不是打回去澄清,而是自己猜着补全了缺失的信息。下游 Agent 基于这些猜测开始工作,产出看起来完整,实际上偏离了真实意图。宁可多一轮澄清,也不让模糊需求流入后续环节。

多角色 Agent 协作示意图

解决步骤:为每个角色建约束内的 Agent,人守关键闸口

第一步:为每个角色建立约束内的 Agent。

Agent(智能体)是能自己理解任务、调用工具、分步执行直到交付结果的 AI 程序,比一问一答的对话多了手脚。一个数字团队可以包含:

Agent 角色职责专属技能集
产品 Agent需求澄清、规格文档生成需求模板、业务规则库
调度 Agent任务分发、进度跟踪、门禁检查流程引擎、状态机
设计 Agent交互稿生成、设计规范检查设计系统、组件库映射
开发 Agent代码实现、单元测试技术栈 Skill、代码规范
测试 Agent测试用例生成、执行验证测试框架、断言库

每个 Agent 有专属的技能集和明确的职责边界,各司其职。

第二步:Identity 先写“不做什么”再写“做什么”。

每个 Agent 的职责说明书里,边界与限制这一段往往比职责还长。举例来说,调度 Agent 的 Identity 文件可能是这样的:

# 调度 Agent Identity

## 禁止事项(红线)
- 不得编写或修改任何代码文件
- 不得跳过门禁直接推进流程
- 不得在需求信息不完整时自行补全
- 不得代替人工做决策评审

## 允许事项
- 解析需求文档,提取任务项
- 将任务分发给对应的开发/测试 Agent
- 检查各阶段的门禁条件是否满足
- 汇总进度状态并生成报告

先用禁令把禁区划清楚,再在安全范围内定义它能做什么。多 Agent 协作的安全感来自禁令,不来自能力描述。

第三步:代码所有权按目录分。

新文件自动归负责人,跨目录不许直接改。每个开发 Agent 只在自己负责的模块目录下有写权限,需要改其他模块时只能通过接口协商或提交请求,不能越界操作。

这就像工厂里每个车间有自己的加工区域,跨车间的物料传递必须走正式的交接流程,不能自己去别人车间拿东西。

第四步:用短生命周期 Loop 替代超级 Agent。

Loop(循环)就像一个只领一张工单的临时工:进门读结构化输入,出门交结构化产出,干完就散伙,下次谁也不记得谁,一切都靠单据传递。

为什么要用短 Loop 而不是一个长期运行的超级 Agent?因为长会话有三个固有风险:上下文窗口溢出导致遗忘、权限随任务膨胀难以回收、失败后恢复成本高。短 Loop 每次从零开始,读取结构化输入,产出结构化输出,失败了重跑成本低,权限用完即收。

下一个 Loop 读取上一个 Loop 留下的结构化结果和证据,不需要回忆上一次对话说了什么。失败或输入变化会产生新的运行和清晰路由,而不是恢复旧会话。

第五步:设置三个人工闸口。

无论 Agent 多么能干,以下三个节点必须由人把关:

闸口时机人的角色
决策评审方案设计完成后Agent 可以参与复杂度分析、提出拆分建议,但改变团队计划必须经人工评审
合并授权开发完成后开发环节的终点是可评审的产出,而不是直接合并到主干
上线验收预发布验证通过后由人决定是否正式上线,Agent 只提供验证报告

Agent 跑流程,人守关键闸口。 人从车工升为厂长加质检总监,握着三把签字笔。

第六步:高风险操作参数固化。

例如在变更操作场景中,Agent 执行变更前必须先查询当前状态,引导用户确认操作类型和目标值。所有关键参数必须用户明确给出,Agent 不猜、不补。然后生成结构化的变更预览卡片,明确警告这是写操作、执行后立即生效。用户回复确认后才真正提交。涉及更高级别的操作还会触发独立审批流程。

遇到信息不足或反复失败就停下来交还给人。 Agent 不应在不确定时硬着头皮往下走,停下来报告问题比产出错误结果更有价值。

注意要点

  • 调度 Agent 要有需求门禁。输入的需求信息不完整或不符合格式就打回,绝不脑补填充。
  • 测试 Agent 用代码审查式测试守住下限。按严重程度分级:阻断级问题必须修复才能推进,警告级问题记录但不阻塞,建议级问题留作后续优化参考。
  • 所有产物挂在需求 ID 上,分支名带角色缩写,确保任何一份产出都能追溯到它所属的需求和产出它的角色。
flowchart TB
    R[需求进入] --> S[调度Agent]
    S --> P[产品Agent]
    S --> U[设计Agent]
    S --> Dev[开发Agent]
    S --> T[测试Agent]
    P -->|规格文档| S
    U -->|设计稿| S
    Dev -->|可评审代码| S
    T -->|验证报告| S
    H1{决策评审} -.->|人工闸口| S
    H2{合并授权} -.->|人工闸口| Dev
    H3{上线验收} -.->|人工闸口| T

图:多角色 Agent 协作网络与三个人工闸口

全厂协同生产时,设计、加工、质检、仓储各有机械臂。每个机械臂有职责清单,清单第一条是禁区。人从车工升为厂长加质检总监,握着三把签字笔:决策评审、合并授权、上线验收。

普通团队从哪里开始:不推倒工厂,先升级一条产线

AI Native 不是一步到位换平台,而是一条渐进路径。四个维度之间有递进关系,但每一步都可以独立启动、独立产生价值,不必等四步全走完才见效。

起步动作对应维度解决的痛点具体做法
把判断写成规则AI 辅助 → AI 原生产出不可控选一个痛点最大的项目,盘点技术栈和规范,写成结构化文件,让 AI 在这个项目里先跑起来
把优化对象换成链路单点提效 → 系统工程交接失忆画出当前的需求交付链路,标出每个交接点丢失了什么信息,为这些信息定义结构化的传递载体
把经验升级为资产个人探索 → 组织能力经验无法复利把团队里最资深成员脑子里的判断整理成技能文件,纳入版本管理,让新人和新模型都能继承
把协作开放给多角色开发独用 → 多角色协同开发一人扛全线先从产品和调度两个角色开始,让它们有自己的 Agent 和技能,逐步扩展到设计和测试

先从最痛的点切入,跑出效果再扩展。

不必恐惧 AI 写代码,要警惕的是缺少体系。 AI 写的东西没人能接手、没法验证、无法追责,这才是真正的风险。

AI Native 产线升级示意图

生产线升级的终点不是无人工厂,而是人站上更值钱的位置:判断、审美、授权与担责。每个人都快了之后,只有把“快”组织进体系,团队才会真的变快。

JOTO 企业落地观察

  • 企业部署需重新定义‘可用’标准:不再依赖人工提示词交代规范,而是将UI框架约束、技术栈识别逻辑等写入项目级.ai/rules/目录下的结构化文件,由AI执行前自动加载。这使规则具备版本控制、可审计性与环境感知能力,避免同一模型在不同项目中产出不一致代码。
  • 智能体工程必须建立技能五维结构:进入项目、识别技术栈、确认写法、查找样板、接入能力。每个维度对应具体可读取的工程资产(如tsconfig、package.json、已有页面路径),确保Agent不是凭空生成,而是在真实项目语境中工作。缺失任一维度,智能体就可能越界使用组件或忽略兼容约束。
  • RAG知识工程不能止于文档入库:传统知识库难以解决规则冲突与动态失效问题。有效做法是将规范拆解为按项目分类的约束文件(如.ui-framework.md),并嵌入数字线程各阶段的最小证据链中。例如开发阶段输出必须绑定commit hash与lint结果,使RAG检索到的规则始终与当前代码版本强关联。
  • AI安全治理的关键落地点在于约束工程:需在系统层强制实施角色约束(声明职责边界)、权限约束(读写白名单)、验证约束(自动运行测试)和终止约束(失败阈值)。这些不是提示词里的软性要求,而是加载规则时即生效的执行护栏,防止AI因上下文缺失或幻觉生成越权操作或不可验证产物。

立即咨询 JOTO

JOTO 提供覆盖企业智能体规划与搭建、AI 平台私有化部署、RAG 知识工程、AI 安全治理、FDE 驻场共创及持续运营优化的全周期 AI 落地服务,帮助企业把验证中的 AI 能力转化为安全、可控、可持续迭代的生产力。 联系 JOTO 获取 AI 落地咨询

想把这些做法用到你的业务里?

留下你的场景和痛点,我们帮你判断从哪一步开始。

联系我们
Contact Us

Start your enterprise AI rollout

Tell us your industry, team, and current pain points. We'll get back to you within one business day to help you decide what to tackle first, what data to prepare, and which platform fits.

WeChat
Scan to add us for a 1:1 chat
JOTO WeChat consultation QR code

Tell us what you need

Once we receive your details, we'll be in touch within one business day.