制作技能模板

一个用于创建新代理技能的元技能。当你需要搭建新的技能文件夹、生成 SKILL.md 文件或帮助用户理解代理技能规范时，请使用此技能。

何时使用此技能

• 用户要求”创建一个技能”、”制作一个新技能”或”搭建一个技能”
• 用户希望为其 GitHub Copilot 设置添加一个专门的功能
• 用户需要帮助构建一个包含捆绑资源的技能
• 用户想要复制此模板作为起点

前提条件

• 理解该技能应完成什么任务
• 对功能和触发条件有清晰、关键词丰富的描述
• 了解可能需要的任何捆绑资源（脚本、参考文件、资源、模板）

创建新技能

步骤 1：创建技能目录

创建一个名称使用小写字母和连字符的新文件夹：

skills/<技能名称>/
└── SKILL.md          # 必需

步骤 2：生成带有前置元数据的 SKILL.md

每个技能都需要包含 name 和 description 的 YAML 前置元数据：

---
name: <技能名称>
description: '<它能做什么>。当 <具体的触发词、场景、用户可能说的关键词> 时使用。'
---

前置元数据字段要求

描述最佳实践

关键：description 是自动技能发现的主要机制。请包含：

1. 做什么（功能）
2. 何时使用它（触发词、场景、文件类型）
3. 关键词 用户可能在提示中提到的词语

好的示例：

description: '使用 Playwright 测试本地网络应用的工具包。当被要求验证前端功能、调试 UI 行为、捕获浏览器截图或查看浏览器控制台日志时使用。支持 Chrome、Firefox 和 WebKit。'

糟糕的示例：

description: '网络测试助手'

步骤 3：编写技能正文

在前置元数据之后，添加 Markdown 说明。推荐的部分：

步骤 4：添加可选目录（如果需要）

示例：完整的技能结构

my-awesome-skill/
├── SKILL.md                    # 必需说明文件
├── LICENSE.txt                 # 可选的许可证文件
├── scripts/
│   └── helper.py               # 可执行的自动化脚本
├── references/
│   ├── api-reference.md        # 详细文档
│   └── examples.md             # 使用示例
├── assets/
│   └── diagram.png             # 静态资源
└── templates/
    └── starter.ts              # 代码脚手架

快速开始：复制此模板

1. 复制 make-skill-template/ 文件夹
2. 重命名为你的技能名称（小写字母、连字符）
3. 更新 SKILL.md：
   • 将 name： 改为与文件夹名称匹配
   • 编写一个关键词丰富的 description：
   • 将正文内容替换为你的说明
4. 根据需要添加捆绑资源
5. 使用 npm run skill：validate 进行验证

验证清单

• 文件夹名称使用小写字母和连字符
• name 字段与文件夹名称完全匹配
• description 长度为 10-1024 个字符
• description 说明了做什么和何时使用
• description 用单引号包裹
• 正文内容少于 500 行
• 每个捆绑资源大小小于 5MB

故障排除

参考资料

• 代理技能官方规范：https：//agentskills.io/specification