重新定义Skill开发:保姆级教程&一站式开发助手发布


从入门到蒸馏,20 分钟以内学会创建、管理和发布你的第一个 Skill —— 让 AI Agent 真正成为你的超级助手。(文章内容基于作者个人技术实践与独立思考,旨在分享经验,仅代表个人观点。)

零、写在最前:Skill 会替代我吗?

每当我向同事介绍 Skill 时,最常被问到的一个问题是:

"你把自己的工作流写进 Skill,让 AI 自动跑——那以后还需要你吗?还需要我吗?"

这其实是同一道题的两面:当 AI 学会了我们的"流程",我们的"价值"还在哪里?

黄仁勋在那段访谈里给了一个非常性感的回答——任务(Task)会被自动化,但体验(Experience)和判断(Judgment)不会。AI 看片子比放射科医生准,结果放射科医生不降反升,因为医生的工作从"看片子"升级成了"诊断疾病"。

把这个逻辑放回 Skill 的语境里:

  • ❌ Skill 替代的不是"你",而是替代你身上那些重复、冗长、易错、本来就不该占用大脑的"任务"。
  • ✅ Skill 替代不了的"你",是你生成的Skill在体验上的丝滑和你对Skill执行的准确性的判断成为你新的价值。

💡 **你需要焦虑的不是"被 Skill 替代",而是"还没学会用 Skill"**。当别人开始用 Skill 把自己的经验沉淀、复用、放大时,你还在反复手工执行同一套流程——这才是差距的开始。

至于"那以后到底还需要做什么?",这个问题我会在最后一章 《六、其实你只要一个 Skill》 给出我的解答。先别急着翻到最后,先跟着这份指南把 Skill 的本质看明白,再回头看那个答案,会更有体感。

接下来,让我们从「什么是 Skill」开始 👇

一、一分钟了解什么是 Skill(推荐看)

💡 一句话说清楚

Skill 是一份结构化的指令文档,它告诉 AI Agent「在什么场景下、按什么步骤、用什么工具、完成什么任务」。你可以把它理解为 Agent 的 「技能卡」—— 插上就能用,拔掉就没有。

类比理解

想象你是新入职的员工刘一航(化名),公司给了你一本《阿里开发操作手册》:

现实世界
Skill 世界
阿里开发操作手册
SKILL.md
 文件
手册封面(标题 + 简介)
YAML frontmatter(name + description)
开发操作步骤
Markdown 正文中的工作流指令
附录(Aone、语雀、中间件等)
Bundled Resources(scripts/ / references/ / assets/)
你按开发手册干活
Agent 按 Skill 执行任务

Skill 的三级加载机制

Skill 并不是一股脑全部塞给 Agent 的,它采用渐进式加载策略,按需提供信息:

💡 为什么要分级加载?

Agent 的上下文窗口是有限的。如果所有 Skill 的全部内容都一次性加载,会迅速耗尽上下文空间。分级加载让 Agent 只在需要时才读取详细指令,既节省资源又保证精准执行。

二、三分钟安装使用 Skill(可以不看)

2.1 Skill 平台介绍

Skill 平台是 Skill 的发布、搜索与安装中心,类似于应用商店。你可以在平台上浏览他人发布的 Skill、一键安装到本地,也可以将自己编写的 Skill 发布出去供他人使用。

平台
渠道
简介
搜索方式
速度
规模
认证
⚪ skills.sh[1]
外部
开源工作流自动化,快速安装
CLI: npx skills find
⚡ 快速
~千级
❌ 无需
⚪ ClawHub[2]
外部
社区驱动,支持版本管理与发布
CLI: clawhub search
⚡ 快速
社区级
⚠️ 可选
⚪ SkillsMP[3]
外部
最大数据库,AI 语义搜索,适合细分/研究场景
REST API
🐢 5–15s
283K+
✅ 需要
⚪ alphashop
内部
跨境电商场景社区 Skill 中心,聚焦 1688 选品 / 找商 / 素材处理 / 店铺管理 / 智能营销 / 数据分析等电商工作流
平台 UI 分类浏览
⚡ 即时
社区级
⚠️ 可选
🟡 Aone Skills
内部阿里内部 Skill 发布与安装平台,与 Aone Copilot 深度集成,内网安全可控、即装即用平台 UI 搜索⚡ 即时内部✅ 内网

2.2 Agent 平台中的 Skill

除了专门的 Skill 平台,各类 Agent 工具也原生支持 Skill 的加载与使用。以下是常见 Agent 平台的 Skill 使用方式:

Agent 平台
定位
Skill 使用方式
Aone Copilot
阿里内部 IDE AI 编程助手,深度集成 Aone DevOps 全链路
将 Skill 目录放入 ~/.aone_copilot/skills/,或从 Aone Skills 市场一键安装,Agent 自动识别加载
AccioWork
阿里内部通用办公 Agent 平台,支持多场景任务自动化
内置Skill直接安装,自定义Skill需要安装包上传安装
QCoder
轻量级 AI 编码助手,专注代码生成与补全
将 Skill 文件夹放入项目级 .skills/ 目录,随项目仓库一起管理
悟空
阿里内部多模态 Agent 平台,支持浏览器操作与视觉理解
通过平台 UI 上传 Skill 文件,或在系统提示词中加载 Skill 指令

2.3 快速安装 Skill(以 Aone Copilot 为例)

方式一:从 Skill Market 一键安装

  1. 访问 Aone Skill Market

  2. 搜索你需要的 Skill,点击「安装」

  3. Skill 自动下载到本地 ~/.aone_copilot/skills/目录,立即生效

方式二:下载 zip 手动安装

从 Aone Skills 市场或其他平台下载 Skill 的 zip 包后,解压到对应平台的 Skill 目录:

# Aone Copilotunzip my-skill.zip -d ~/.aone_copilot/skills/# QCoder(项目级)unzip my-skill.zip -d .skills/# 其他平台参考各平台文档,将解压后的目录放入对应 Skill 目录即可

方式三:使用 aone-kit CLI 安装(推荐)

aone-kit 是阿里内部的 Skill 管理命令行工具,支持从 Aone Skills 市场一键搜索、安装和管理 Skill。

第 1 步:安装 aone-kit

前提:需要 Node.js 18 或以上版本

npm install -g @ali/aone-kit --registry=https://registry.anpm.alibaba-inc.com

第 2 步:安装 Skill

在项目目录下执行以下命令,Skill 默认安装到项目下的 .agents/skills/{name}/ 目录:

aone-kit skill install <skill-name>

常用参数:

参数
说明
示例
--location <path>
指定安装目录
--location ~/.aone_copilot/skills
--global
全局安装到 ~/.agents/skills/
aone-kit skill install <name> --global

第 3 步:查看已安装 Skill

aone-kit skill list

方式三:直接创建

在 ~/.aone_copilot/skills/ 下新建一个文件夹,创建 SKILL.md 文件,写入 Skill 内容即可。详见第三章。

2.4 验证安装成功

安装完成后,直接在 Aone Copilot 查看Skill模块或者在输入中用"/"唤起。

三、五分钟创建你的第一个 Skill(可以不看)

别紧张,跟着下面的步骤走,5 分钟就能搞定你的第一个 Skill 🎉

3.1 准备工作

创建 Skill 推荐使用 skill-creator(一个专门用来创建 Skill 的 Skill 🤯)。当然,你也完全可以手动创建。

🎯 使用 skill-creator 的好处

它会引导你完成意图确认、草稿编写、测试用例设计和迭代优化的完整流程,就像有一位经验丰富的 Skill 工程师在旁边手把手教你。只需对 Agent 说:"帮我创建一个 Skill,用来 xxx",skill-creator 就会自动接管。

3.2 Skill 的目录结构

一个 Skill 本质上就是一个文件夹,最简单的情况下只需要一个文件:

my-awesome-skill/├── SKILL.md          ← 唯一必需的文件!└── (可选) 附加资源    ├── scripts/      ← 可执行脚本(Python、Node.js、Shell 等)    ├── references/   ← 参考文档(按需加载到上下文)    └── assets/       ← 静态资源(模板、图标、字体等)

3.3 编写 SKILL.md

这是 Skill 的灵魂文件。它由两部分组成:YAML 头部和 Markdown 正文。

YAML 头部(frontmatter)

---# 必需字段name: dingtalk-webhook-skilldescription: 通过钉钉自定义机器人 Webhook 发送群消息。当用户提到钉钉、机器人、webhook、群消息、通知、dingtalk、发消息时触发。# 可选字段(按需添加)license: MITcompatibility:  - claude-3.5+  - aone-copilotallowed-tools: Read Bash WebFetchmetadata:  author: zefei.szf  version: 1.2.0  category: communication  tags: [dingtalk, webhook, notification]---
字段
是否必需
说明
name必需
Skill 的唯一标识符。最长 64 字符,仅允许小写字母/数字/连字符,如 dingtalk-webhook-skill
description必需
Skill 的触发描述。这是 Agent 判断是否使用该 Skill 的核心依据,最长 1024 字符,务必写清「做什么」和「什么时候用」
license
可选
许可证名称或对 LICENSE 文件的引用,如 MIT、Apache-2.0
compatibility
可选
适配的 Agent / 平台 / 模型范围,如 claude-3.5+、aone-copilot
allowed-tools
可选
预授权工具白名单,空格分隔,如 Read Edit Bash
metadata
可选
任意 KV 元数据,常用子字段:author(作者)、version(语义化版本,如 1.0.0)、category(分类)、tags(标签数组)

📖 字段规范来源:以上字段遵循 Anthropic Agent Skills[4] v0.1 开源规范(业界事实标准),同时兼容 skills.sh / ClawHub / Aone Skills 等主流平台。其中 name 和 description 是所有平台都强制要求的核心字段,其余按需添加。

⚠️ description 是触发的关键

Agent 目前倾向于「少触发」而非「多触发」。因此,description 要写得稍微「积极」一些,多列举可能的触发关键词和场景。例如:

  • ❌ 不够好:发送钉钉消息的技能
  • ✅ 推荐写法:通过钉钉自定义机器人 Webhook 发送群消息。当用户提到钉钉、机器人、webhook、群消息、通知、dingtalk、发消息时触发。

Markdown 正文

正文就是你给 Agent 的「操作手册」,通常包含以下部分:

1.快速开始 / 使用示例 — 给出 1-2 个典型的用户输入示例,让 Agent 快速理解使用场景
2.参数列表 — 用表格清晰列出每个参数的名称、是否必需、默认值和说明
3.工作流 / 执行步骤— Skill 的核心,用分步骤的方式描述 Agent 应该如何执行任务
4.错误处理 — 列出常见的错误场景和对应的处理方式
5.附加资源引用 — 如果有 scripts/ 或 references/,明确指出何时、如何使用

3.4 Skill规范与最佳实践

创作思维

在动笔写 SKILL.md 之前…

— 以上为试看内容(约 40%),开通会员后阅读全文 —