重新定义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.md | |
name + description) | |
scripts/ / references/ / assets/) | |
Skill 的三级加载机制
Skill 并不是一股脑全部塞给 Agent 的,它采用渐进式加载策略,按需提供信息:
💡 为什么要分级加载?
Agent 的上下文窗口是有限的。如果所有 Skill 的全部内容都一次性加载,会迅速耗尽上下文空间。分级加载让 Agent 只在需要时才读取详细指令,既节省资源又保证精准执行。
二、三分钟安装使用 Skill(可以不看)
2.1 Skill 平台介绍
Skill 平台是 Skill 的发布、搜索与安装中心,类似于应用商店。你可以在平台上浏览他人发布的 Skill、一键安装到本地,也可以将自己编写的 Skill 发布出去供他人使用。
npx skills find | ||||||
clawhub search | ||||||
| 内部 | 阿里内部 Skill 发布与安装平台,与 Aone Copilot 深度集成,内网安全可控、即装即用 | 平台 UI 搜索 | ⚡ 即时 | 内部 | ✅ 内网 |
2.2 Agent 平台中的 Skill
除了专门的 Skill 平台,各类 Agent 工具也原生支持 Skill 的加载与使用。以下是常见 Agent 平台的 Skill 使用方式:
| Aone Copilot | ~/.aone_copilot/skills/,或从 Aone Skills 市场一键安装,Agent 自动识别加载 | |
| AccioWork | ||
| QCoder | .skills/ 目录,随项目仓库一起管理 | |
| 悟空 |
2.3 快速安装 Skill(以 Aone Copilot 为例)
方式一:从 Skill Market 一键安装
访问 Aone Skill Market
搜索你需要的 Skill,点击「安装」
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 | 必需 | dingtalk-webhook-skill |
description | 必需 | |
license | MIT、Apache-2.0 | |
compatibility | claude-3.5+、aone-copilot | |
allowed-tools | Read Edit Bash | |
metadata | 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 的「操作手册」,通常包含以下部分:
3.4 Skill规范与最佳实践
创作思维
在动笔写 SKILL.md 之前…