技术实践

淘宝企业购以Skills完成客户定制接口交付

应用与实践上下文与知识智能体系统AI 基础设施检索增强知识库Agent 工具调用智能体互操作协议Agent SkillsAI 开发与运维平台Sandbox编程MCPAgent Sandbox

概述

淘宝企业购的企业客户大多已有自研内部商城或第三方 SAAS 采购平台,需企业购反向适配客户接口规范,形成高频、碎片化的定制对接场景(覆盖商品、交易、结算三大域)。团队自 2025.8 起分五阶段演进:阶段 1 Vibe Coding(2025.8,某大型 ISV,验证对话式编码可行性并完成架构解耦);阶段 2 Prompt 模板(2025.9,某大型企业,流程模板化 + 子任务 Prompt 模板,AI 生成代码采纳率 70%);阶段 3 SDD 规范驱动开发(2025.12,SAAS 项目,用 OpenSpec 验证 Spec 编程,AI 生成代码可用率从 40% 提升至 80%);阶段 4 Skill 沉淀(2026.1-2,某大型 ISV,采用 Anthropic Agent Skills 标准把流程写进 SKILL.md、领域知识放 references、脚本放 scripts,构建文档评估 → 技术方案 → 编码的全链路流水线,用 15 个接口的项目跑通商品域全流程);阶段 5 云端集成(2026.2)。配套做了架构先行:把系统拆为原子能力层、模板层、适配层,AI 只生成适配层代码,适配层代码量减少 60%、支持多客户并行开发零冲突、原子服务复用覆盖 90%+ 对接场景。调优上针对接口提取幻觉改为脚本提取为主 + AI 校验,针对推拉模式混杂按调用方向拆分链路并注入系统 API 抽象,针对长文档输出崩塌把方案生成 Skill 拆为 4 个子 Skill(pull-indexer / pull-model-designer / pull-interface-generator × N / 汇总组装,每个接口独立上下文约 8k tokens),针对代码编译问题前置 ego-project-initialization Skill 并按依赖顺序生成。整体结果:商品域端到端交付周期从 23.5 人日缩短至 8 人日、整体提效 65%、代码一次生成成功率达 90%(早期不足 50%)。 阶段 4 的 Skill 体系依赖 Cursor 等本地 IDE,安装、配置、调用需理解 SKILL.md 工作流与目录结构,产品与业务运营无法直接使用,且换人换机器需重新配置、能力无法产品化输出。团队在 2026 年 2 月用 OneDay 搭建前端交互界面,结合 Aone 沙箱提供的代码编译与执行环境,自行搭建端到端生码平台原型,把已验证的 Skill 能力从本地 IDE 迁移到云端:非技术人员通过 Web 界面上传客户对接文档后,平台自动完成文档解析、评估报告生成、技术方案输出、适配代码生产的完整流程。当前进展为平台已搭建完成、完整链路已跑通,商品域全流程(文档评估 → 技术方案 → 代码生成)已在平台上端到端验证通过,验证了 Skill 从本地 IDE 到云端平台迁移的可行性、核心能力可复用。待完成项包括沙箱测试(TDD)与 SubAgent 并行化。 Skill 数量增长后出现知识分散、更新不同步、跨 Skill 复用困难的问题,团队构建了三种存储载体协同的知识库体系:Git 知识仓库(自建索引、支持渐进式拉取)、Code Wiki(已完成试跑,产出数据模型、开发指南、核心模块、API 参考,可通过 MCP 召回)、KBase(已完成试跑,支持 RAG 召回文本块/原文,自然语言提问可召回代码片段 + 原文档链接)。知识生产支持钉钉文档、代码、PDF 等多模态格式与 Git 知识仓库、Code Wiki、KBase 等多数据源,人工维护加自动生成增量更新(如需求完成后 Hooks 自动更新)。组织方式参考 Anthropic 官方渐进式加载策略构建 GUIDE.md 一级索引、rules/index.md 二级索引、知识文件三级索引,每个知识文件带 name/description/tags 元数据自描述,并开发 CLI 工具 kn-fetcher(pull / list / search 等 6 个基础命令)支持知识拉取、搜索与批量分发,待对接 Skill 体系。质量侧通过「事前约束 → 运行时约束 → 事后审查 → 人工卡点」四层防线贯穿评估 → 方案 → 代码全链路,并用 ADJUSTMENT_PLAN 机制(发现 → 定位 Skill → 补约束 → 验证 → 交叉验证)把 SPU/SKU 混淆、ID 字段混淆等 11 类跨项目跨模型反复出现的高频问题全部沉淀为 Skill 约束、不再复现;审查 Skill 对评估报告的审查结果为接口覆盖 15/15、字段遗漏率 0%、映射方向正确。