用途:当用户想创建、编辑或理解 Zed 中的 Agent Skill 时使用。Skill 是代理可按需加载的一组可复用指令,每个技能位于独立目录,由带 YAML frontmatter 的 SKILL.md 定义。
存放位置:全局为 ~/.agents/skills/<skill-name>/SKILL.md,适用于所有项目的个人技能;项目本地为 <project>/.agents/skills/<skill-name>/SKILL.md,适用于仓库专用技能,可通过版本控制与协作者共享。仓库专用优先项目本地,个人通用工作流优先全局。
SKILL.md 格式:必须以 --- 分隔的 YAML frontmatter 开头,包含 name 和 description。name 必填,1–64 字符,小写字母数字,单连字符分隔,需与所在目录名完全一致,正则 ^[a-z0-9]+(-[a-z0-9]+)*$,不得以 - 开头结尾、不得出现连续 --。description 必填,1–1024 字符,是代理判断是否加载该技能的主要信号,应具体且可执行。可选字段 disable-model-invocation 设为 true 时,技能从自动目录隐藏,用户仍可通过 / 斜杠命令菜单手动调用。
指令写法:正文写给代理看,直接说明做什么、检查什么、向用户询问什么;包含具体文件路径、命令、格式与模式;给出何时使用的指引;可用相对路径引用同目录的模板、示例等支持文件,代理激活技能后可读取。
创建步骤:确定全局或项目本地范围;选择描述性连字符名称;创建目录结构;编写含 frontmatter 与指令的 SKILL.md;可选添加支持文件。创建后,Zed 代理会在下一次对话自动发现该技能;若 ~/.agents/skills/ 目录已存在,全局技能无需重启。
限制与未提供信息:资料未说明支持的 Zed 版本、是否需要特定配置、技能数量上限、权限或安全限制,也未提供收费、价格与平台信息。