Skills 与插件专题
目录
本专题讲什么
在 AI Agent 工程里，**Skill（技能）**通常指「可复用的流程与约束说明」，常以 SKILL.md 等形式被助手加载；**Plugin（插件）**通常指「宿主环境里的扩展包」，带有 manifest（例如 Codex 的 .codex-plugin/plugin.json）、可选 Skills/Hooks/MCP 等目录。
本专题分篇说明：Skill 的体系与编写规范、治理与发布；以及 Plugin 的目录结构、manifest、脚手架与和 Skill/MCP 的组合关系。内容兼顾通用方法与常见工具链（如 agentskills.io 所描述的标准化叙事）。
和 OpenClaw / Hermes 的关系
本专题是通用写法与治理；各产品自己的路径、加载方式与安全策略不同，不是「同一套文件无差别通用」。请先读 各宿主 Skills 差异对比，再对照各官方文档落地。
Skill vs MCP vs Plugin（先对齐概念）
| 概念 | 典型形态 | 回答的问题 | 谁执行 |
|---|---|---|---|
| Skill | SKILL.md 文档 + 少量脚本，渐进披露 | 「怎么做」：固化流程、步骤与质量标准 | 模型按步骤执行 |
| MCP | Host/Client/Server，stdio + Streamable HTTP | 「能连什么」：标准化接外部工具/资源 | MCP Server 真实执行 |
| Plugin | 目录 + manifest（如 .codex-plugin/plugin.json）+ 可选代码 | 「怎么打包分发」：统一发现、权限、版本 | 宿主加载，内部可含 Skill/MCP |
一句话：MCP 给「能连什么」，Skill 教「怎么做」，Plugin 负责「怎么打包分发」——三者互补不替代。
三者常一起出现：Plugin 里可以内置多个 Skills 和 MCP 配置；Skill 也可以独立存在于工作区而不依赖 Plugin；MCP 提供 Skill 执行时要调用的真实工具。
发布脉络：Anthropic 先有 MCP（2024，连接工具），后推 Agent Skills（2025，沉淀流程）；详见 Skill 体系概述与生态位。
适合谁
- 要在团队内统一 RAG、评测、发布、值班 等重复流程的工程师。
- 要为 Codex/Cursor 类环境 维护可安装扩展的人。
- 已使用 OpenClaw/Hermes 等助手，需要把工作区 Skills 写得可维护的人（可对照 OpenClaw Skills、Hermes Skills）。
阅读顺序
- Skill 体系概述与生态位
- 各宿主 Skills 差异对比（OpenClaw / Hermes / 插件 / 通用标准）
- Skill 编写规范与 SKILL.md 模板
- Skill 治理、测试与版本发布
- 插件（Plugin）概念与 manifest
- 插件脚手架与工程集成
- Agent Skills 规范对照与宿主接入（与 agentskills.io 逐项对照，可选）
外部参考
- agentskills.io — Skill 开放标准与生态说明（以站点为准）。
- 官方文档索引（便于爬虫/LLM 拉全站）：llms.txt。
- OpenClaw 文档：Skills
- Hermes 文档：Skills
agentskills.io 文档地图（速查）
| 页面 | 链接 |
|---|---|
| Home | agentskills.io/home |
| What are skills? | what-are-skills |
| Specification | specification |
| Quickstart | skill-creation/quickstart |
| Best practices | skill-creation/best-practices |
| Optimizing descriptions | skill-creation/optimizing-descriptions |
| Evaluating skills | skill-creation/evaluating-skills |
| Using scripts | skill-creation/using-scripts |
| Adding skills support | client-implementation/adding-skills-support |
| Client showcase | clients |