企业官网建设流程全解析

Easel SKILL开发规范详解：三步打造自己的AI社媒能力技能

【免费下载链接】EaselAn open-source AI agent for social media — discover trends, create content, publish everywhere, and learn what works across Xiaohongshu, Douyin, Zhihu, Bilibili, and more.🎨一个开源的 AI 社交媒体智能体——发现热点趋势、创作内容、一键发布至各大平台，并学习分析哪些内容真正有效，覆盖小红书、抖音、知乎、哔哩哔哩等平台。项目地址: https://gitcode.com/gh_mirrors/easel3/Easel

Easel 是一个开源的 AI 社交媒体智能体，覆盖小红书、抖音、知乎、B 站等平台的热点发现、内容创作与一键发布。它的核心能力由一个个独立的 SKILL（技能）组成——只要遵循 Easel 的 SKILL 开发规范，你就能用三步为自己的 AI 社媒工作流扩展新能力，比如"字数裁剪"、"金句卡片"这类原子技能。本文将带你快速读懂 SKILL 接口规范，从零打造并验证自己的技能。

一、先搞懂：Easel 中的 SKILL 是什么

可以把 SKILL 理解为 Easel 的"能力积木"。每个 SKILL 是一个独立可调的原子能力单元，由 OpenClaw Agent 读取并直接执行，贯穿五个流水线阶段：

除了这五层，还有一个general层用于跨切面基础设施（如画像管理、模板库）。

Easel 内置了 113+ 个技能，全部放在 skills/openclaw/ 目录下，跨技能共享的工具脚本放在 skills/shared/。读懂任意一个现有技能，就等于拿到了最佳实践模板。

二、三步打造自己的 SKILL

第一步：按规范建目录

每个 SKILL 就是一个独立目录，结构如下：

skill-xxx/ ├── SKILL.md 必须 — 执行流程（精简，< 200 行） ├── references/ 可选 — 领域知识（按需加载） ├── scripts/ 可选 — 可执行脚本（代码不进 prompt） └── tests/ 可选 — 测试用例

核心原则只有一条：SKILL.md 只写"怎么做"，领域知识放 references/，代码放 scripts/。这样技能被触发时不会白白吃掉大量 token。

想动手前先看看真实例子，推荐这两个入门技能：

• skills/openclaw/card-quote/SKILL.md — 42 行就能完成的金句卡片技能
• skills/openclaw/text-condenser/SKILL.md — 输入/输出/步骤/Profile 感知四段式完整范例

第二步：写一份合格的 SKILL.md

SKILL.md 由 frontmatter + 正文两部分组成：

--- name: skill-xxx description: 用中文写清技能做什么、用户说什么话时触发、与相邻技能的边界 layer: produce --- # 技能名称 > 一句话描述 ## 输入 ## 输出 ## 执行步骤 ## Profile 感知

这里有三个新手最容易踩的坑：

1. frontmatter 只保留三个字段：name、description、layer。禁止添加version、tags、allowed-tools等冗余字段——它们会常驻在路由上下文中，浪费 token。
2. description 是 Agent 的"触发开关"：必须写清三件事——能力是什么、用户哪些说法应触发、和相邻技能怎么区分。校验脚本会用正则检查是否包含"当用户/触发/使用时机"等触发词。
3. 正文控制在 200 行以内：执行步骤中引用 references/ 下的文件获取领域知识，而不是把知识塞进主文件。

第三步：校验 + 调用，走通闭环

写完不要急着跑，先用仓库内置的校验脚本自检：

python scripts/validate_skills.py python scripts/validate_skill_commands.py

第一条检查 frontmatter 字段、目录结构、资源链接和发布安全契约（见 scripts/validate_skills.py）；第二条解析 SKILL 文档中的 Python 命令，对照脚本真实的 argparse 定义检查参数漂移。两条都通过，说明你的技能"长得和官方技能一样标准"。

然后就可以像调用内置技能一样调用它了：

easel skill <技能名> -i "你的输入" easel skill <技能名> -i "你的输入" -p 画像名

所有调用统一走 OpenClaw Agent，由它读取你的 SKILL.md 并自己执行（实现见 easel/commands/skill.py）。

三、进阶：让你的技能更专业

1. 设计 Profile 感知：规范明确要求技能"无 Profile 也能用，有 Profile 更好"。有画像时从 profiles/ 下的style.md、platforms.md读取账号风格，没有时给出合理默认值。

2. 产物统一落盘：所有输出写入outputs/<主题>/，成品放项目根目录、中间件放assets/，并通过 skills/shared/scripts/output_paths.py 校验路径——这样前端内容库才能正确展示你的技能产物。

3. 发布类技能必须接安全闸门：任何真实发布（--exec）前必须调用 skills/shared/scripts/content_guard.py 的guard_or_die(...)做敏感信息拦截，这是硬性契约。

4. 登记来源：如果技能改编自第三方项目，在技能目录添加EASEL-META.md元数据表并到 docs/ACKNOWLEDGMENTS.md 登记，参考 skills/openclaw/card-quote/EASEL-META.md。

贡献完整约定见 CONTRIBUTING.md，包括提交前必跑的三条命令和 PR 命名规范。

四、小结

回顾一下三步法：

1. 建目录— 照SKILL.md + references/ + scripts/的标准结构搭架子
2. 写 SKILL.md— frontmatter 三字段写全，description 写清触发边界，正文精简
3. 跑校验—validate_skills.py全绿后，用easel skill命令实测

遵循 docs/SKILL-SPEC.md 这套规范，你的技能就能和 Easel 内置的 113 个技能一样被 Agent 稳定路由、独立调用、被下游消费。现在打开skills/openclaw/，挑一个最贴近你需求的技能改一改，五分钟就能拥有自己的 AI 社媒新能力。

【免费下载链接】EaselAn open-source AI agent for social media — discover trends, create content, publish everywhere, and learn what works across Xiaohongshu, Douyin, Zhihu, Bilibili, and more.🎨一个开源的 AI 社交媒体智能体——发现热点趋势、创作内容、一键发布至各大平台，并学习分析哪些内容真正有效，覆盖小红书、抖音、知乎、哔哩哔哩等平台。项目地址: https://gitcode.com/gh_mirrors/easel3/Easel