理解 Skill、Plugin 与 MCP 的分工,并把高频任务沉淀成可复用的操作流程。
Skill 解决什么问题
AGENTS.md 负责整个项目的通用规则,Skill 更像某一类任务的专项流程。写代码审查、整理文档、生成演示文稿、修复 CI 等工作如果反复出现,就适合整理成 Skill。
一个 Skill 不只是提示词。它通常包含触发场景、执行步骤、需要使用的工具、参考资料、产物格式和检查方式。
一个最小 Skill 的结构
最核心的文件是 SKILL.md。文件开头描述名称和用途,正文说明什么时候使用、按什么步骤执行以及完成后如何验证。复杂流程还可以把脚本、参考资料和模板放在独立目录中。
my-skill/
├── SKILL.md
├── scripts/ # 可选:自动化脚本
├── references/ # 可选:详细资料
└── assets/ # 可选:模板和素材SKILL.md 应保持简洁,把长资料放到 references,把可以稳定执行的重复操作放进 scripts。
Skill 如何被使用
系统通常先读取 Skill 的名称和描述,判断它是否与当前任务匹配;真正选中后,再读取完整说明以及需要的脚本或资料。这种按需加载方式可以避免大量技能一开始就占满上下文。
使用时既可以明确指定某个 Skill,也可以让 AI 根据任务描述自动匹配。因此,描述文字要具体说明适用场景,而不是只写“提高效率”这样的宽泛句子。
Plugin 和 MCP 分别做什么
Plugin 更适合把一组 Skills、配置和工具能力打包分发,方便在多个项目或团队成员之间安装使用。MCP 则主要解决外部工具和数据连接,例如浏览器、设计稿、知识库或业务系统。
简单理解:Skill 说明一类任务怎样做;Plugin 负责把能力打包和分发;MCP 给 AI 提供可以调用的外部工具。三者可以配合,但不必在一个小任务里全部使用。
什么时候值得做成 Skill
当一项任务已经出现多次、步骤相对固定、输入输出清楚,并且存在可验证结果时,再考虑沉淀为 Skill。一次性的创意任务不必过早流程化。
先制作覆盖常见场景的最小版本,真实使用几次后再补充异常处理,比一开始追求万能流程更容易维护。
参考来源:CodexGuide 对应教程 ↗