大模型、编码智能体已经深度进入日常开发开发者一句话描述需求智能体直接输出前端页面、组件、后端接口、Service逻辑功能快速跑通。这种模式极大提升单功能交付效率但也催生一个新的、比传统游击队更隐蔽的风险每个人、每一轮和智能体对话都是一套独立的实现方案。传统游击队是人各写一套智能体时代是「人智能体」的组合各写一套。同一个项目里不同提示词、不同会话、不同开发者调用智能体产出的组件结构、样式写法、接口返回、异常处理、命名范式完全不一样。单个功能都能跑拼在一起就是缝合怪。风格一致性不再只是团队纪律问题变成智能体时代架构治理的核心命题架构能力的核心就是约束智能体的输出边界把AI的生成能力锁进统一契约之内。一、核心定义传统游击队 VS 智能体时代缝合怪对照表维度传统游击队开发纯人工智能体协同下的缝合怪开发人Agent产生源头开发者个人习惯、认知差异、嫌规范麻烦智能体无上下文记忆、提示词不统一、不同会话独立生成开发者只验收功能通不通不校验范式典型特征人主观上自选写法偶尔复制粘贴AI每次生成都是局部最优不知道项目已有组件、统一DTO、全局样式、基础封装开发者不引导、不校验直接合并代码一致性破坏点UI样式、编码习惯、接口协议组件重复造轮子、同一种业务逻辑两套实现、样式硬写不使用Design Token、响应体随机变化、状态枚举两套映射、AI自创工具函数隐蔽性代码一眼就能看出风格差异AI代码语法工整、注释齐全可读性看着不错但是和项目底座不兼容问题藏在契约和结构里评审更容易放过核心矛盾人的自律不足智能体默认没有项目架构契约感知它只满足单次prompt的需求没有全局项目视角架构应对目标制定规范约束人给智能体注入项目规约、基线模板、组件资产约束AI输出同时约束开发者和Agent交互流程一句话总结传统是人不听话智能体时代是AI不懂项目基线开发者容易偷懒跳过基线校验快速产出一堆互不兼容的合格碎片碎片拼接就是缝合怪。功能都实现但是系统腐化速度会比纯人工时代更快。二、前端侧智能体生成场景下UI代码一致性全景表前端是缝合怪重灾区。开发者让智能体写一个弹窗、表单、列表Agent不知道项目里已经封装好业务组件、主题变量、请求拦截、状态交互规范直接基于原生组件/第三方组件重新实现一套。分类统一契约要求合规Agent被基线约束后的输出缝合怪反面案例无约束AI输出架构Agent支撑方案UI视觉层强制使用项目Design Token、全局主题变量、栅格规范颜色、间距、圆角全部读取var(--xxx)不写死像素和色值AI直接硬编码#1890ff、margin:14px、自定义阴影参数脱离主题给Agent注入主题token清单、禁止硬编码样式规则、组件资产库基础组件调用优先复用项目封装基础组件禁止直接裸用第三方原生组件使用内部BaseButton、BaseModal传入约定propsAI直接写antd.Button自己写弹窗遮罩、关闭逻辑重复实现弹窗组件索引库、组件使用示例作为Agent上下文prompt强制优先检索已有组件交互契约loading、空态、报错、二次确认、toast反馈统一工具调用全局useFeedback、统一请求包装useRequestAI自己写axios、自己写loading变量、自己写alert/Message反馈文案格式不统一统一请求hooks、反馈工具加入Agent参考知识库路由、权限、布局页面必须挂载统一Layout权限key统一、跳转逻辑统一路由在路由表注册权限key引用常量AI独立写页面脱离主Layout自行判断权限、硬编码权限标识路由样板、权限常量文件作为Agent参考上下文TS编码范式命名、类型抽取、状态管理、组件拆分范式统一接口类型统一放到types/xxx.ts组件小驼峰禁止滥用anyAI一次性把类型内联写在页面ref/reactive混用随意新建请求函数eslint规则、样板组件模板、类型仓库喂给Agent业务组件规约业务卡片、筛选栏、表格等复用单元从组件库复用新增必须入库复用已有TableSearch业务组件参数遵守约定schemaAI看到相似业务重新写一套筛选表格字段、校验、事件命名不一样组件检索能力Agent先检索组件库再决定生成还是复用三、后端侧智能体生成场景下代码接口契约一致性全景表后端没有UI但接口结构、异常、日志、分页、枚举就是后端的风格。智能体写Controller、Service的时候如果没有拿到项目统一基线很容易自创返回格式、异常抛出方式、分页参数前端对接直接撕裂契约。分类统一契约要求合规输出约束后的Agent缝合怪反面案例无约束AI输出架构Agent支撑方案全局响应体固定统一返回结构错误码统一枚举{code,msg,data,timestamp}复用统一Result工具AI直接返回List、Map自己组装{success:true}错误码随意定义把全局返回封装类、错误码枚举放进Agent知识库prompt强制使用Result入参出参分页DTO继承基础分页基类参数命名统一pageNum/pageSize、startTime分页DTO继承BasePageDTO排序字段遵守约定AI自创current/pageSize、beginDate/startTime两套分页参数VO随意定义字段名基础DTO样板、参数命名规约注入Agent上下文异常体系业务异常统一抛BusinessException不裸抛RuntimeException异常携带标准错误码统一日志打印AI手动if判断返回失败map、直接throw new RuntimeException、不打链路日志全局异常处理器、异常使用示例作为参考素材命名与枚举数据库字段、类、方法、状态枚举命名统一状态不硬编码状态使用枚举枚举复用已有AI直接写status1/2魔法数字新建同名含义不同的枚举枚举字典库、数据库规约Agent优先检索枚举分层边界Controller只做参数校验、调用Service业务逻辑下沉不写SQL分层严格Mapper只做数据查询AI在Controller写大量业务判断、组装SQL、跨层直接调用Mapper分层样板代码、架构检查规则给Agent作为参考日志、事务、缓存日志携带traceId事务注解传播属性统一缓存key前缀规范使用封装日志工具、统一缓存前缀biz:xxx:{id}AI直接System.out打印日志Transactional传播属性随机缓存key随意起名日志切面、缓存工具类、分布式锁样板加入知识库四、核心联动表前后端契约 智能体生成链路的协同风险缝合怪很多时候不是前端单独乱或者后端单独乱而是AI生成的前后端代码契约对不上。同一个业务前端会话的Agent和后端会话的Agent互相隔离没有共享一份规约。联动场景一致性要求缝合怪典型矛盾Agent架构契约方案状态枚举渲染后端枚举和前端状态标签、下拉选项唯一数据源后端Agent新增枚举前端Agent不知道自己硬写一套状态映射搭建枚举同步中心枚举文档自动同步给前后端Agent知识库表单校验校验提示文案、校验规则前后端对齐后端AI返回参数非法前端AI写的提示是格式不正确校验文案统一常量库Agent必须引用文案常量禁止AI自由编写提示词批量操作返回结构批量新增/删除统一返回成功列表、失败列表后端AI直接返回布尔前端AI按数组结构处理联调翻车批量接口标准样例存入知识库Agent生成批量接口强制参考样例字典下拉字典从统一字典接口获取禁止前端硬编码前端AI直接写死下拉选项后端字典表另外维护字典服务文档、字典组件示例注入Agent上下文权限标识符前后端权限key完全一致后端AI新增权限key为user:edit前端AI写userEdit权限常量文件共享给前后端Agent不允许AI自行定义权限标识五、智能体协同的管控链路全景表传统规范靠MR评审智能体时代防线要前置到和AI对话的阶段。等代码生成完再评审成本很高开发者很容易功能能用就合并。架构能力体现在给Agent装上项目的项目认知给开发者设定使用Agent的标准流程。管控环节管控手段约束对象缝合怪缺失点Agent会话前置基线固定系统提示词System Prompt内置项目架构规约、组件清单、样板代码、禁止项编码Agent前端/后端开发者每次新开会话空上下文直接描述需求让AI自由发挥资产检索优先逻辑Agent生成代码前强制检索知识库组件、DTO、枚举、工具类、接口样例Agent本身AI上来直接生成新代码不查询已有资产重复造轮子开发者Prompt规范写需求时必须附带约束复用组件、遵守返回体、使用已有枚举禁止只写功能描述开发者一句话需求写一个用户列表无任何规约约束本地预校验卡点AI产出代码后先本地执行ESLint、CheckStyle、单元测试、架构规则扫描AI生成产物生成直接丢MR自动化规则后置甚至没有MR流水线专项扫描新增规则识别硬编码色值、新建重复组件、自创返回结构、魔法数字所有AI提交代码流水线只跑编译和单元测试不做架构规约扫描资产更新同步新增基础组件、DTO、枚举、工具类后自动更新Agent知识库架构底座知识库是静态的项目资产迭代了Agent认知永远停留在旧版本评审关注点升级评审不再只看功能是否正确优先校验是否复用资产、契约是否对齐、有没有新增自定义实现代码评审人评审只看功能默认AI写的代码结构没问题放过契约不一致问题六、模式对比表无约束缝合怪模式 VS 带架构基线的Agent开发模式评估维度无约束人Agent缝合怪模式带架构基线的智能体开发模式单功能交付速度极快一句话生成几乎没有前期约束略慢需要检索资产、遵守基线prompt更长中长期迭代速度持续衰减到处是互不兼容的实现改一个业务要改N套逻辑稳定可控新增能力都是在底座之上扩展改动收敛代码特征语法工整、注释漂亮但是实现碎片化重复轮子极多代码样式统一复用率高新增代码差异只在业务本身Bug类型大量契约类Bug、联调Bug、样式不一致Bug业务改枚举、改字典多处不同步Bug集中在业务逻辑本身极少出现协议、样式、范式低级问题人员流动新人上手新人新Agent继续新增碎片债务滚雪球看懂一套逻辑只能看这一段AI代码样板、组件、契约统一新人不管自己用Agent还是手写产出范式一致框架升级、底座改造灾难各处是AI独立实现的自定义逻辑没法统一替换底座改动只改基础库业务层AI生成代码不用大面积修改系统可观测治理成本代码资产散碎很难统计重复组件、非标接口资产可统计非标实现可以自动化扫描出来持续治理七、认知误区纠偏表误区正确认知智能体只要功能实现就行规范是额外负担智能体擅长生成功能但天生没有全局架构视图规范不是限制AI是给AI划定合法的输出空间把规约全部写进文档AI自己会读文档遵守大模型很难自主通读长文档必须把规约压缩成固定system prompt、样板代码、检索知识库可检索、可参考每个开发者自己有Agent怎么prompt是个人自由自由Prompt就是缝合怪源头架构要统一Agent基线模板统一准入上下文而不是统一限制开发者创造力AI生成的代码我简单看一眼没问题就合并AI很会正确的错误代码能跑但脱离项目契约必须自动化规则优先于人眼评审小项目不需要给Agent做基线约束小项目是缝合怪高发地小项目迭代快、频繁用AI快速堆功能债务在不知不觉累积架构师的工作就是写框架、选中间件智能体时代架构师新增核心职责维护Agent知识库、基线模板、检索规则、规约扫描器管控AI的输出域全文总结智能体放大了开发效率同时指数级放大了风格不一致的风险。传统开发不一致是人的习惯差异而智能体协同下不一致来自「每一次对话都是一次独立生成任务」。开发者和Agent的组合只对本次需求负责不对整个项目的长期一致性负责对项目的长期可预测性负责。一个个独立、可运行、语法优美的功能碎片拼接在一起就是缝合怪。架构能力在这里已经不再仅仅是设计分层、接口、组件库而是构建一套面向智能体的契约闭环沉淀统一资产组件、DTO、枚举、工具、样式Token给编码Agent注入固定基线上下文强制先检索再生成约束开发者和智能体的交互方式不能无基线自由提问自动化防线前置在生成、提交、合并链路拦截非标实现。UI一致性管住用户侧体验代码接口一致性管住研发侧契约在智能体加持的应用层开发里一致性是防止AI生产力变成技术债务的闸门。失去这套管控再强大的编码智能体只会加速项目走向缝合化本质就是智能体时代的游击队开发。