指南

定义

什么是 Agent Skill?

Agent Skill 是一份 SKILL.md 文件夹,用来教 AI 编程智能体一套可重复流程,并写明何时加载。

更新于 2026-09-18 · 8 分钟阅读

Agent Skill 是带 SKILL.md 的文件夹,用来教 AI 编程智能体一套可重复流程,并写明何时加载。 智能体不必每次上网现查这套步骤。它读的是你安装进去的 markdown。

SKILL.md 契约

文件至少以 YAML frontmatter 开头:

---
name: find-skills
description: 当用户需要从开放目录发现并安装技能时使用。
---
  • name 是小写 slug,也是文件夹名。
  • description 是发现面。必须写何时加载,而不能只写技能是什么。
  • 正文是流程:步骤、文件布局,以及要避开的错误。

技能不是什么

形态存什么何时选它
Agent Skill磁盘上的流程步骤能写进 markdown 和附加文件
MCP带 schema 的实时工具智能体必须调用正在运行的 API
提示词片段一次性文本这活你不会再做
人格包声音,不是流程你要说话风格,不要工作流

文件夹布局

让 SKILL.md 保持短。脚本、模板和长参考放在旁边的文件里,只在需要时打开。这样才能阻止始终加载的上下文膨胀。

下一步:在 Claude、Cursor、Codex 或 Grok 上安装文件夹,或自己写一份 SKILL.md