大淘宝SDD实战:AI代码渗透率从30%到100%
作者:Agentic AICon组委会 | 来源:技术前沿观察
你肯定遇到过这种场景——
凌晨1点,你对着AI编程工具说:"帮我写个订单导出功能。"
AI秒回了一段代码。跑起来似乎没问题。但你仔细一看:
|
|
• 被逻辑删除的订单也被导出了 • 数据量一过万条,接口直接超时 • 导出接口压根没做权限校验,任意用户都能调 |
你改了一版,AI又改了一版。改到第五版,AI已经忘了你最开始说的"不支持批量导出"这个约束。
这不是AI的问题,是你的"表达方式"有问题。
当你在用自然语言"跟AI聊天"来写代码时,你就掉进了一个叫 Vibe Coding(氛围编码) 的陷阱——靠感觉、靠运气、靠AI"猜你想要什么"。
据CSDN一篇实战文章的统计数据,未经规范约束的AI代码,返工率高达67%。
怎么办?
一种叫 SDD(Spec-Driven Development,规范驱动开发) 的方法论,正在成为2026年AI编程领域最热的工程实践。不只是GitHub推出了官方工具Spec Kit(11.5万star),连大淘宝都在内部全面落地了这套方法论。
今天我们就从大淘宝的真实工程实践出发,拆解SDD到底怎么落地。最终在百亿补贴项目中实现了0手写代码的高质量交付。
一句话讲透SDD的本质
先写规范,再让AI写代码。 |
过去我们写代码的逻辑是:需求 → 设计 → 手写代码 → 测试。
SDD的逻辑是:需求 → 详细规范 → AI生成 → 验证。
人的职责从"写代码"变成了"设计+验证"。AI的职责从"猜你想要什么"变成了"严格按照规范执行"。
就像建筑行业一样——建筑师出图纸,施工队照着图纸建楼。你不会让施工队"凭感觉"盖房子,那为什么要让AI"凭感觉"写生产级代码?
大淘宝的AI Coding三层架构:他们到底怎么落地的?
大淘宝直播数据研发团队在2026年全面落地了AI Coding,他们的架构设计值得每个工程团队参考。
这套架构分三层:
🔻 基建层(确保AI"喂得饱") • CDM(公共维度模型)标准化:表结构、字段注释、枚举值、代码逻辑必须极度精准且持续保鲜 • 知识库双引擎:LightRAG + 图数据库,为AI提供无歧义的知识参照系 • 工程平台:统一的任务调度、版本管理、审计追溯 |
⇅ 提供AI能力支撑
🔸 AI能力层(确保"管得住") • Skill封装:将高频研发模式封装为可复用的原子化能力单元 • SDD规范驱动:每个环节产出标准Spec文件 • AI Coding双路径并行:DSL路径(NL→DSL→SQL)+ Data Agent路径 |
⇅ 为应用层提供能力
🔺 应用层(确保"用得好") • 多Agent协同:规划Agent拆解需求,职能Agent执行任务,报告Agent汇总输出 • 中心化+本地化AI Native并存:中心化适合标准化协作,本地化专注个性化迭代 |
这套架构的核心理念是:以工程的确定性,约束大模型的不确定性。
大淘宝的关键技术决策:为什么选NL2DSL2SQL,而不是端到端?
这是整个体系最值得借鉴的技术决策。
业界多数方案直奔NL2SQL(自然语言直接转SQL),但这本质上是在挑战大模型的泛化能力,过程呈黑盒且难追溯。
大淘宝团队选择了更可控的路径:NL2DSL2SQL。
在自然语言与SQL之间插入DSL(领域特定语言,以JSON结构化描述数据操作),带来三大收益:
|
|
✅ NL2DSL2SQL 三大收益 1. 分段可调试:每个逻辑步骤均可校验 2. 审计前置:AI生成的DSL可以先人工Review,再生成SQL 3. 验证成本降低:当DSL违反平台规范时,系统精准返回错误位置,触发"报错→定位→AI自修正"闭环 |
大淘宝团队将其定义为体系的核心技术锚点——不追求自然语言到SQL的端到端盲目生成,而是构建可编程、可检测的语义缓冲层。
这个思路对SDD的启示是什么?
不要试图让AI一步到位, |
SDD的工程化落地:五步工作流 + 双重运行时锚点
以GitHub Spec Kit和大淘宝实践为参照,完整的SDD工作流分五步:
第1步:写宪法(Constitution)
这是项目的"根本大法"。定义技术栈、命名规范、安全策略等全局约束。
大淘宝的实践更进一步——他们把宪法拆成了三层:
|
|
|
第2步:写规格(Spec)
只写"要做什么",不涉及技术实现。核心是用户故事+验收标准+数据模型。
大淘宝的Spec包含:需求现状、资源缺口、模型设计、输入输出定义。关键是写决策,不写实现。
第3步:澄清(Clarify)
这是很多团队忽略的一步。大淘宝在Spec完成后,会强制进行需求澄清:
|
|
• AI主动识别模糊点(比如"软删除还是硬删除?") • 强制确认,规避80%理解偏差 • 澄清结果回写到Spec,形成闭环 |
第4步:生成计划(Plan)
AI根据宪法+Spec+澄清结果,自动生成技术方案。
大淘宝引入了双重运行时锚点来约束AI:
锚点1 本体论(Ontology) 符号层锚点,统一定义实体、关系与属性(比如"主播ID"的全局语义) |
锚点2 Harness(运行时管控) 执行层锚点,负责调度AI能力与管理上下文,确保长链路任务中会话信息不丢失、不漂移 |
两者协同:本体论解决"AI应理解什么",Harness解决"AI如何正确执行"。
第5步:执行实现(Implement)
AI按照宪法→Spec→Plan的约束链,逐任务生成代码。
大淘宝在这里采用了双路径并行:
|
|
• DSL路径:依赖自研语义层,支持单测与工程检测,适合标准化长期需求,承载70%以上代码量 • Data Agent路径:弱依赖语义层,适配临时取数、历史任务修改等灵活场景 |
真实效果怎么样?看大淘宝的数据。
|
|
|
配合轻量人工修正,实现24小时内高质量交付。
SDD的关键认知转变:不是"写文档",是"建契约"
很多开发者一听"SDD"就觉得是回到瀑布流,写一堆没人看的文档。
大错特错。
SDD的核心不是写文档,而是把Spec从静态文档变成可执行合约。
区别在哪?
|
|
❌ 传统需求文档:写完就扔,代码才是"真理" |
|
|
✅ SDD的Spec:写完持续驱动,代码服从Spec,而不是Spec服务代码 |
每次需求变更,先改Spec,再让AI根据Spec重新生成代码。Spec是活的,它和代码一起版本管理、一起PR Review、一起迭代。
大淘宝还把Spec纳入了持久化记忆系统。每个Agent独立沉淀任务记忆与踩坑记录,新需求到来时优先检索历史Spec,实现从"每日清空的实习生"向"懂业务的老员工"演进。
Harness Engineering:把AI配置从个人电脑移到团队Git
大淘宝还沉淀了一套Harness Engineering落地规范,核心思路是:AI配置应该像代码一样管理。
他们建了一个 team-harness 仓库:
team-harness/ ├── rules/ │ ├── global/ # 全局规则 │ ├── golang/ # 语言特定规则 │ └── frontend/ ├── skills/ │ ├── common/ # 通用能力 │ └── business/ # 业务特定能力 ├── templates/ │ ├── AGENTS.md # Agent配置模板 │ └── project.md # 项目模板 └── docs/ └── onboarding.md # 新人指南 |
通过同步脚本或CI,把团队规范同步到业务仓库的 .codebuddy/ 目录。
这意味着:
|
|
• 有版本 • 有Review • 可回滚 • 可分支 • 可比较不同版本效果 • 新成员可以快速获得同一套起点 |
三阶段落地路线:先建立底线,再接工具,最后形成飞轮
如果你想在团队落地SDD,大淘宝的建议是分三阶段:
|
|
🟢 第一阶段:基础建设(1-2周) • 选择1-2个试点项目 • 明确允许使用的模型和数据边界 • 创建team-harness仓库 • 编写Global、Security、项目架构三类基础Rules • 固化编译、Lint、测试命令 • 记录当前交付周期、Bug率和Review返工基线 |
|
|
🟡 第二阶段:工具接入(2-4周) • 只读方式接入数据库MCP • 接入代码平台、需求平台或Wiki中最有价值的一项 • 从真实成功案例沉淀2-3个原子化Skills • 跑通需求分析、编码、Review、归档的完整流程 • 对照基线复盘效率和质量变化 |
|
|
🔵 第三阶段:持续优化(持续) • 每月Review Rules和Skills • 清理低使用率、低收益MCP • 建立Rules和Skills负责人制度 • 把高频Review问题转化为新的Rules |
工程师的角色在变
SDD带来的最深层变化,不是工具链的升级,而是工程师角色的重新定义。
过去的工程师 = "写代码的人"。
SDD时代的工程师 = "定义意图的人 + 验证质量的人"。
大淘宝明确划定了AI的边界:
|
|
AI负责:上下文管理、过程追溯、模板执行 |
|
|
👤 人负责:数据建模决策、指标口径判定、复杂业务翻译 |
你需要具备的新能力:
|
|
• 意图表达能力:把模糊需求转化为精确规范 • 架构判断力:知道什么该约束、什么该留给AI • 验证思维:从"我能写出来"变成"我能验出来" |
这不是降级,是升级。你从"搬砖工"变成了"建筑师"。
最后说句实话
大淘宝的实践证明:以工程的确定性约束大模型的不确定性,是当前阶段最务实的AI Coding落地路径。
2026年了,别再跟AI"对暗号"了。把你的意图写清楚,让AI当你的施工队,而不是你的猜谜者。
如果你还没试过,建议从下一个独立模块开始——先写一份Spec,跑一遍五步工作流。你会发现,AI从"需要反复调试的实习生",变成了"执行精准可靠的资深工程师"。
这个转变,值得你花一个下午。
你们团队在AI编程中踩过什么坑? |
📌 核心观点 SDD的本质不是写文档,而是建立"规范即源码"的工程契约——大淘宝用三层架构+双重运行时锚点+DSL语义缓冲层,将AI代码生成渗透率从30%提升至接近100%,准确率从50%跃升至80%,证明了"以工程的确定性约束大模型的不确定性"是AI Coding落地的正确路径。 |
|
👆 觉得有用的话,点个「在看」让更多工程师看到

