ai使用skill解析

catino

38人浏览 · 2026-08-25 16:37:03

catino · 2026-08-25 16:37:03 发布

Skill是什么？

Skill 是 Agent 社区事实标准的可复用、可共享工作流包，核心为文件夹 + SKILL.md，Cursor、Claude Code、Codex‑CLI 支持该规范；

一个Skill本质上就是一个文件夹，核心是里面的SKILL.md文件。它用标准化的格式告诉AI：

名字和触发条件：什么时候该用这个技能（比如“用户提到‘发邮件’时”）。
工作流程：一步一步该怎么做。
辅助资源：可以参考的文档、可执行的脚本等。

从能力组成上，可以将 Skill 简单分为两种：

指令/工作流型 Skill：主要由 SKILL.md、规则、流程、示例、参考资料组成。
工具增强型 Skill：在工作流基础上进一步结合脚本、MCP、API 或其他工具，使 Agent 能够执行实际操作。

生成：三种主流方式

方式	操作说明	适用场景
对话固化	先和AI对话，一步步完成一次任务并修正到满意，然后直接对它说：“把刚才的流程固化为一个Skill，命名为[技能名]”。AI会自动生成规范的文件夹和SKILL.md文件。	最快、最直观。适合将你手头已经做熟练的、重复性的任务直接“教”给AI。
内置创建器	在Codex中直接运行命令$skill-creator，它会通过问答的方式引导你填写技能的目的、触发条件、是否包含脚本等信息。	新手友好，有向导，不容易出错。适合第一次创建Skill时熟悉标准格式。
手动编写	在对应的skills目录下（如~/.codex/skills/）新建一个文件夹，在里面手动创建SKILL.md文件，并按照格式填写内容。	高度可控。适合对格式和要求非常熟悉的高级用户，需要精细调整细节。

编写SKILL.md文件的关键要点（ SKILL.md 是核心）

写好description：这是最重要的一步，它决定了AI何时触发你的技能。要写“主动”一点，把你想到的所有相关关键词和场景都写进去，避免AI太“保守”而不调用。描述能力 + 使用场景，而不是堆关键词。
构建“陷阱”部分：在指令里专门加一个Gotchas或Common Pitfalls章节，把你自己（或其他人）在做这个任务时容易犯的错、AI容易踩的坑都写进去。这往往是Skill最有价值的部分。
保持简洁：保持 SKILL.md 简洁，核心工作流和关键规则直接写在其中；详细背景知识、示例和参考资料可以拆分到 references/、examples/ 等文件中

一个简单的 Skill例子：

---

name: java-crud

description: Generate Java CRUD modules following the project's architecture and coding conventions.

---





# Java CRUD Development Skill





## Workflow





1. Analyze the existing project structure.

2. Find a similar existing module.

3. Analyze DO, DTO, VO, Mapper, Service and Controller patterns.

4. Follow the existing naming conventions.

5. Generate the required files.

6. Check imports and dependencies.

7. Run Maven tests.

8. Fix compilation errors.

9. Summarize all changes.





## Rules





- Do not introduce a new architecture.

- Follow the existing project conventions.

- Reuse existing utility classes.

- Do not modify unrelated files.

- Do not delete existing business logic.

一般怎么“生成”一个 Skill？

第一步：找到一个重复工作

第二步：把你的“经验”写出来

第三步：加入真实项目示例。这样 Skill 就不仅仅是：规则还有：真实案例Agent 可以参考已有代码。

第四步：加入模板。可靠性会比单纯依靠 Prompt 更高。

第五步：测试 Skill

如何让其他人使用你的 Skill

Git仓库托管：把包含你Skill的文件夹（比如my-skills/）上传到一个公开或私有的Git仓库（如GitHub）。别人可以通过git clone命令下载，或使用npx skills add <仓库地址>这类标准工具一键安装。
直接复制文件夹：这是最传统的方式。你可以把Skill文件夹打包成ZIP发给别人。接收者需要手动将其解压到对应AI工具的skills目录下，例如：
- Codex 全局级：~/.codex/skills/
- Claude Code 全局级：~/.claude/skills/
通过插件市场分发（Claude Code）：如果你的Skill功能很完善，可以尝试将其发布到Claude Code的插件市场，让用户可以通过claude plugin install命令安装。
组织级统一部署：一些平台支持管理员在组织工作区内统一下发和强制更新Skill，适合团队内部标准化流程。