一、问题与背景过去两年大模型 Agent 的开发范式经历了一轮典型的野蛮生长。最早是 Prompt Engineering 的胜利开发者把系统提示词塞进 messages 的第一条期望模型能稳定地扮演某个角色。但很快问题就暴露出来——同一个角色在不同团队、不同项目里被反复重写同样的指令在 GitHub Issue 里被复制粘贴了上百次。每一次微调都要改代码每一处修改都没人记得住源头。随后出现了 LangChain、LlamaIndex 这类框架把调用大模型封装成了优雅的 Chain。但它们解决的是如何调用而不是如何管理能力。当 Agent 数量从 1 个变成 10 个、100 个团队开始追问这些 Agent 的能力定义散落在几十个 Python 文件里谁来维护谁来评估谁来升级更糟糕的是能力本身在漂移今天 SA Agent 的 system prompt 是 v1明天有人改成 v1.1但另一处的示例还在用 v1 的格式。上下文越长漂移越明显最后连原作者都说不清现在的 SA 到底会不会画架构图。这种漂移不是靠写更多文档能解决的它需要一套能追溯、可回归、可对比的能力治理机制。这正是 Skill 概念兴起的背景。Skill 不是新的 Prompt而是一份机器可读、可版本化、可评估的能力契约。它把提示词 工具集 知识库 评测用例打包成一个独立单元第一次让 Agent 的能力像代码一样具备工程属性。而当 Skill 的数量也爆炸式增长时第二个问题就来了谁来托管这些 Skill仓库该长什么样谁来决定一个 Skill 是否够格被发布这些问题如果不解决Skill 的复用就只会停留在团队内部传阅阶段无法形成生态。二、产品规格Agent Skill Warehousemcp.smartmoves.com.cn 正是为这一阶段而生的——它把 Skill 提升为一等公民提供了完整的资产管理体系指令层Markdown 格式的角色定义、行为约束、Few-shot 示例知识层RAG 友好的领域文档、FAQ、术语表执行层MCP 协议暴露的工具、API、脚本评测层每个版本配套的回归用例集发布前自动验证围绕这一四层结构平台提供了版本管理语义化版本号、可发现性标签、搜索、依赖图、可评估性基准分数、生命周期草稿/发布/弃用四项核心能力。开发者不再需要自己维护一堆 YAML 和 JSON而是把 Skill 推送到一个集中、可信、可追溯的仓库里。三、技术架构整体架构可以抽象为三层┌─────────────────────────────────────┐ │ Skill 层 (Markdown YAML 资源) │ ├─────────────────────────────────────┤ │ 协议层 (MCP Server / Registry API) │ ├─────────────────────────────────────┤ │ 运行时 (Agent 框架 / IDE / CLI) │ └─────────────────────────────────────┘Skill 层以目录为基本单位SKILL.md是入口文件配套的知识文档、评测用例、工具脚本按约定目录组织。所有内容以纯文本为主方便 diff 和 code review。协议层基于 MCPModel Context Protocol暴露检索与下载接口。后端采用 FastAPI PostgreSQL前端是 Vite React 的轻量门户。文件存储走 MinIO对象检索走 Qdrant。运行时任何兼容 MCP 的 Agent 框架都能消费这些 Skill。开发者通过skill install nameversion类似 npm 的语义拉取所需能力。四、成果与收获把Skill 当代码这件事落地后团队协作模式出现了三个明显变化能力复用成为 KPI衡量一个团队贡献度的不再是写了多少 Prompt而是发布了多少被他人复用的 Skill。评测左移每次 Skill 更新先跑评测集回归失败直接拦截能力迭代变得可信赖。新人 onboarding 加速新人不需要读几十个 Agent 的源码直接复用仓库里成熟的 Skill 即可搭起原型。对 Agent 开发者而言这意味着 Agent 工程从手工作坊迈向了工业化生产。团队里终于有人能说出这个季度我们贡献了 3 个被超过 5 个项目复用的 Skill而不是我们写了 3 个 prompt——考核维度变了组织形态才会跟着变。另外值得一提的是仓库的出现还顺带解决了一个长期被忽略的问题合规与审计。当 Agent 的能力定义在仓库里以 PR 形式变更时每一次能力升级都有迹可查。这对金融、政务等强合规场景意义重大。五、实践成果网站地址plan.smartmoves.com.cn这是 Agent Skill Warehousemcp.smartmoves.com.cn能力在真实业务中的落地形态——一个由 BA-Master / SA-Master / PM-Master 三大技能集驱动的智能规划平台可访问站点直接体验端到端的 Agent 协作流程。在站点上你可以看到需求、方案、计划是如何在三个角色 Agent 之间流动的也可以看到每一次交接的质量评分。这不是 demo是仓库里的技能集跑在真实业务上的样子。
