核心功能

Skill是标准化、可复用的AI任务包，核心强制文件为SKILL.md (头部YAML元数据定义名称、触发场景、版本，正文封装完整业务SOP、多工具调度逻辑、输出规范)，配套模板、脚本、参考文档组成完整文件夹包，可打包为zip分发。

• 自动匹配：AI识别用户需求语义，自动加载对应Skill，无需手动指令唤起

• 分层隔离：支持全局用户级 (所有项目生效)、项目本地级 (仅当前工作区) 两套目录

• 解决痛点：零散Prompt无法沉淀、多步骤流程不稳定、重复上下文浪费Token

• 第三方分发标准：统一以「SKILL.md的文件夹」或「该文件夹压缩的zip包」对外发布

极简发展时间线

2024.6：Cline (原Claude Dev) 率先落地原生SKILL.md技能目录架构，无需MCP中转即可加载第三方Skill

2025.12：OpenAI新版Codex推出配套SKILL.md规范与本地技能目录

2026.3：阿里云Qoder上线Skill功能，配套界面zip上传入口

2026.4：全平台统一SKILL.md格式规范互通

1. VS Code + Cline (无中转，直接目录拷贝，最轻量化)

目录路径

• 完整标准目录在最简结构的目录下，可以自带更多文件和子目录，由SKILL.md引用给智能体按需使用

第三方 zip/SKILL.md 文件夹导入两步法

解压第三方zip包，取出完整skill子文件夹 (文件夹内一级目录必须直接存在SKILL.md，禁止多层嵌套)

将整个skill文件夹直接复制到上述任意skills目录，重启VS Code/Cline 会话自动加载识别

2. VS Code + GitHub Copilot (原生智能编程助手，轻量化部署)

目录路径

第三方 zip/SKILL.md文件夹导入两步法

解压第三方zip包，取出完整skill子文件夹 (文件夹内一级目录必须直接存在 SKILL.md，禁止多层嵌套)

将整个skill文件夹直接复制到.github/skills/ 目录，重启VS Code会话自动加载识别

3. Qoder (阿里云灵码，界面zip上传+目录双模式)

第三方分发载体

标准zip包，包根目录直接包含SKILL.md与配套资源

SKILL升级后旧版本缓存清除

修改/替换第三方SKILL.md技能包后会读取旧缓存导致不生效、加载错乱。

有多种指令语句。最方便在Qoder集成环境的Agent对话框，要求清除某个skill的历史缓存，重载最新版本。

4. OpenAI Codex (本地 Skill 目录与插件分发)

Codex Skill目录

Codex会从仓库级、用户级、管理员级和系统内置位置读取 Skills。常用位置如下：

Windows：C:Users用户名.codexskills；Mac/Linux：~/.codex/skills/

SKILL.md 至少包含：

• name: skill-name

• description: 用英文详细说明该skill应该在什么时候被调用

第三方zipSKILL.md导入流程

解压第三方zip，确认skill文件夹一级目录存在 SKILL.md

将整个skill文件夹复制到.codex/skills/，重启Codex 客户端

第三方Codex如何调用Skill

Codex 支持两种调用方式：

• 显式调用：在Codex CLI/IDE中使用/skills查看，或输入$提及某个Skill。

• 隐式调用：当用户任务匹配description时，Codex自动选择对应Skill。

因此，description要写清楚该Skill适合什么任务、不适合什么任务，以及常见触发关键词。

分发方式

本地Skill文件夹适合个人编写、仓库内共享和本地调试。如果要面向其他开发者长期分发，Codex更推荐把 Skill打包为plugin。Codex也提供$skill-installer用于安装部分curated skills，例如：$skill-installer linear