导语

过往基于tab模式进行代码补全对编码效率提升的天花板较低,使用agent模式生成的代码在功能完整性,可用性,安全以及可维护性又有很多问题导致实际代码采纳率不理想;基于以上矛盾点腾讯广告审核团队迫切需要探索出适合团队并且能面向未来的AI开发范式,帮助团队从需求确认到功能上线全链路提效;本文重点介绍通过“AI技术规范(索引/rules)  + 模板化(技术方案/prompt) + MCP工具集成 + AI自我总结”,实现生产力提升的人机协同新范式。

1.背景与挑战

1.1 背景

AI Code正引发一场深刻的软件开发范式变革,其角色已从辅助性的“效率工具”,演进为重塑研发、测试、运维全流程的核心引擎。面对AWS基于规范驱动模型生成代码的Spec范式,Lovable基于自然语言直接生成代码的AI Native范式的推出,以及Cursor、Trae、CodeBuddy等工具的涌现,我们认为AI技术体系已进入可工程化的新阶段。因此,我们亟需探索并确立一套适合广告审核团队特性的AI Code最佳实践范式,以实现研发效率的全面提升。

1.2 现状

审核系统的业务复杂度较高,其研发模式主要基于既有的架构、系统和规范进行迭代演进,且对可用性、可维护性与安全性有着极高要求。每一个需求从设计到上线的全流程,通常都涉及跨越多角色、多平台和多模块的庞杂交付工作。目前,研发阶段占全流程的40%,此阶段以人工设计开发为主导,可以利用AI提效的环节和空间较大。

图片

审核研发流程

1.3 挑战

近年来,AI编程工具虽已在代码生成领域取得长足进步,展现出了巨大潜力。然而,在业务逻辑复杂、技术架构复杂的企业级工程“深水区”,现有AI编程工具仍需应对来自业务、技术架构与模型自身的三重挑战:

图片

 

2.业界AI Code实践范式

当前,AI编程领域的研发范式层出不穷,呈现快速演进与多元探索的格局。其中,AWS的Spec范式与Lovable的AI Native范式因其鲜明的技术理念与显著的应用效果而备受业界关注。为系统把握其核心思路、优势差异及适用场景,我们针对这两类代表性研发范式展开了专项调研与对比分析。

特性维度

AWS Kiro Spec范式

Lovable AI native范式

核心思路

基于规范驱动模型生成代码

基于自然语言直接生成代码

目标用户

专业开发者、技术团队

创业者、产品经理、无代码背景的创作者

工作流程

需求文档 → 设计文档 → 任务清单 → 代码实现

图片

图片

自然语言描述 → AI生成并预览应用 → 反馈调整

图片

图片

图片

核心优势

高可控性,适合企业级应用(补充)

极速上手、门槛极低 ,适合营销活动和展示demo产品

主要局限

● 需求/设计/任务清单的格式复杂、要求严格、门槛高

● 研发流程工具集成不够完善,比如类tapd工具、iwiki工具、DDL等

● 不适合已有系统的迭代

● 不适合定制化的需求实现

● 不适合复杂度高业务

3.审核AI Code实践范式

3.1AICode范式定义

基于行业经验,围绕“如何让AI更理解业务”,生成更可控准确、更完整简洁的代码,审核在现有系统基础上,探索并沉淀了审核业务场景的AI Code范式,核心是要给模型提供更全更准的业务&技术知识,告诉模型:“按什么规范、在哪里、做什么、怎么做”,并让模型告诉我们“做了啥”。

① 什么规范:指需遵循的技术规范,包括安全规范、设计原则、编码风格、约束条件等,确保生成的代码不仅能work、而且符合技术标准

② 在哪里:指现有的代码结构,包括代码仓库目录、代码层级结构、类/方法描述等,辅助模型精准定位代码路径、精确映射设计语义,确保生成的代码位置准确、架构合理

③ 做什么:指需实现的业务逻辑,包括概念定义、功能描述、代码生成范围等,辅助模型精准理解业务需求,精确生成功能代码(细致程度决定生成准确度)

④ 怎么做:指需完成的任务清单及验收标准,指导模型严格按照任务要求逐步实现,并按标准进行检查,确保生成的代码更可控

⑤ 做了啥:指AI总结,让模型在生成代码后,做个自我总结并存档,方便人工review生成的代码是否符合预期,且方便后续维护

结合原有研发流程,我们提炼的AI Code核心范式可概括为:技术方案(①②③) → Prompt(④) → 生成代码 → AI总结(⑤)。该范式以技术方案为起点和依据,通过Prompt提示词作为关键转化,驱动代码生成这一核心环节,并以AI总结完成闭环,整个流程由Agent协同多种MCP工具一站式完成。

图片

我们构建的AI Code开发范式立足于两大支柱:一是稳固的技术基座,这依赖于对AI编程工具、底层大模型及效能度量体系的审慎选型;二是标准化的执行流程,其核心在于将技术规范、方案设计及Prompt指令进行模板化改造。二者共同构成了范式落地的基石。接下来将详细说明我们在技术选型与流程标准化方面的具体实践。

3.2AICode技术选型

● AI Code配套设施:IDE + CodeBuddy插件 + 公司先进大模型 + MCP工具

● AICode度量工具:eplus平台

3.2.1AI编程工具选型

CodeBuddy在腾讯内生态较为活跃,功能迭代速度快,内部免费、安全性高,而且内部集成了混元、deepseek等模型,可以灵活适配不同场景的需求,所以我们最终选择CodeBuddy作为我们的AI编程工具。

图片

3.2.2 大模型的选择

在审核日常的业务需求场景下,使用AI Agent生成代码验证过程中,采用公司先进模型 + iwiki的mcp工具结合,作为我们的代码生成的模型底座,代码行采纳率大于50%。

3.2.3 度量工具的选型

一套优秀的AI代码度量工具,是有效评估AI生成代码成效、设定可量化目标并推动持续优化的基石。它能够为团队提供清晰的观测视角,例如eplus平台目前已支持对活跃用户数代码补全采纳率、代码补全生成率Agent代码行采纳率等关键指标进行监控,从而帮助团队精准掌握AI编码的应用效果,并指引其向既定目标稳步推进,具体数据指标类型如下图所示:

图片

3.3AICode过程标准化

为了让AI生成更可控、更准确、更完整简洁的代码,我们给AI制定了一套标准的技术规范,在技术方案上从面向人转变到面向AI,同时将Prompt提示词标准化,方便给大模型发出清晰的指令,最后让大模型给出自我总结,以便人工检查和后续维护。目前我们已将这套标准的AI研发流程推广到审核中心,AI实现的需求覆盖率达到70%+,同时Agent代码行采纳率在50%以上,研发节约时长比例达到30%+。

图片

3.3.1 技术规范制定

为应对审核系统多语言、多框架的复杂技术栈及差异化的安全要求,需为AI代码生成制定涵盖安全、工程与代码的规范性标准,以确保输出代码除保证可用性之外,还符合项目的长期技术约束与质量目标,部分规范示例如下:

图片

3.3.2 技术方案模版化

为适配AI编程,技术方案的设计思路需进行根本性的范式转型,即从易于人类理解转变为利于AI识别与执行。为实现这一目标,我们需要推动技术方案的标准化与模块化,将其固化为可复用的模板。开发人员仅需根据具体需求对模板进行少量调整,即可快速生成高质量方案,这将极大降低研发人员采用AI编程的门槛,并为我们在全中心推广奠定了基础,目前我们将技术方案分为:代码层级结构设计、控制器层设计、业务逻辑层设计、持久层设计,具体每一层的设计如下所示:

● 代码层级结构模版化设计(structrue):代码层级结构设计的核心目标之一,是建立一套明确的代码组织契约。它应清晰定义在哪个层级、哪个模块下,创建何种类型和职责的文件。这为AI生成代码提供了规范性指引,更为重要的是,它为开发团队后续的修改、阅读和维护提供了精准的定位地图,从而有效降低维护成本。

代码层级结构模版截图

示例截图

图片

图片

● 控制器层模版化设计(controller):控制器层主要是为前端层设计API,如果需要对前端提供API,需向大模型明确其技术契约,包括协议、路径、参数、响应格式等核心约束条件,以确保生成的接口代码可直接投入使用。

控制器层模版截图

示例截图

图片

图片

● 业务逻辑层模板化设计(service):service层主要写一些核心的业务逻辑代码,修改Service层逻辑时,需向大模型精准指定目标类、方法及具体的功能变更点。

业务逻辑层模版截图

示例截图

图片

图片

● 持久层模版化设计(repository):持久层主要是写一些存储相关的接口,修改或者新增持久层代码的时候,需向大模型提供具体的Dao接口、数据实体类、库表名称、表格字段等信息

持久层模版截图

示例截图

图片

图片

3.3.3 prompt模版化

为提升大模型对指令的解析精度,同时降低研发人员的使用门槛与操作成本,我们通过构建一套规范化、可复用的Prompt模板,实现了提示词的标准化管理。

图片

3.3.4 AI自我总结

在AI生成代码后,强制其进行自我总结并归档。该文档直接服务于人工代码审查(快速验证是否符合预期)与长期项目维护(留存关键决策上下文),是提升AI代码可用性的关键步骤。

图片

4.实践总结
4.1进展及效果

审核中心已全面推广该范式,人员覆盖率100%、需求覆盖率70%+、Agent代码行采纳率在50%以上。

图片

4.2 困难/不适用点

虽然该范式已全面推广,但大模型本身依然存在发散和遗漏的问题,同时在项目实现上也存在大模型不适合及知识盲区的问题。

图片

5.未来展望

当前AI Code的应用价值已在编码环节得到验证,为将其增效能力从“单点突破”升级为“全局赋能”,我们下一步将着力打通开发、测试、部署环节的全链路协同,并重点探索“需求->技术方案”的端到端一站式研发的可行性。

图片

 

结语

本文阐述的AI研发范式:技术方案模板化→Prompt模板化→代码生成→AI总结,是基于广告审核场景总结提炼出来的实践范式。该范式可能未必普适,不过其核心方法论——将人工分析的需求,通过模板转化为面向AI的技术方案与清晰指令,最终驱动代码生成——具有重要的可迁移价值。我们希望这一抛砖引玉的研发范式能为寻求利用AI生成高质量代码的团队提供有益参考。

文章来源:https://mp.weixin.qq.com/s/WXXKpVth8OJqvjrnS1m7Cw

Logo

有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

更多推荐