技能

技能用于沉淀可复用的能力说明。它将结构化的 Prompt、规则和操作步骤封装为独立单元，供 Agent 在执行任务时调用。

核心概念

什么是技能

技能本质上是一份结构化的能力描述文件（SKILL.md）。它不是可执行程序，而是告诉 Agent"在特定场景下应该怎么做"的指导说明。

技能与 Prompt 的区别

对比项	普通 Prompt	技能
存储方式	写在会话中，用完即弃	保存为独立文件，持久化存储
复用性	需要手动复制粘贴	绑定到 Agent 后自动生效
结构化程度	自由文本	包含名称、描述、规则、步骤
适用范围	单次会话	跨会话、跨 Agent 复用

TIP

当您发现自己反复在不同会话中输入类似的 Prompt 时，就应该将其提取为技能。

创建技能

手动创建

进入技能管理页面，点击「新建技能」，填写以下参数：

字段	类型	必填	说明
名称	文本	是	技能名称，简明描述技能用途
描述	文本	是	技能适用的场景和效果说明，帮助 Agent 判断何时使用
内容	多行文本	是	技能的具体规则、步骤和约束，即 SKILL.md 的正文部分

导入技能

进入技能管理页面，点击「导入技能」，选择导入方式：

字段	类型	必填	说明
导入方式	下拉选择	是	`url`（从 URL 导入）或 `local`（从本地目录导入）
URL 地址	文本	是	技能文件的公开 URL。导入方式为 `url` 时必填
本地路径	文本	是	本地 SKILL.md 文件所在的目录路径。导入方式为 `local` 时必填

SKILL.md 文件结构

技能以 SKILL.md 文件存储，包含 frontmatter 元信息和正文内容。

Frontmatter 字段说明

字段	类型	必填	说明
name	文本	是	技能名称，在技能列表和 Agent 绑定时显示
description	文本	是	技能描述，帮助 Agent 理解技能用途并决定何时调用
id	文本	否	技能唯一标识，不填则自动生成。导入时用于匹配已有技能进行更新

示例

markdown

---
name: 代码审查规范
description: 按照团队标准审查 Pull Request
---

## 审查步骤

1. 检查代码风格是否符合团队规范
2. 确认函数命名清晰、职责单一
3. 检查是否有未处理的错误
4. 确认测试覆盖关键路径

## 输出格式

- 问题等级：Critical / Warning / Info
- 每个问题附带文件路径和行号
- 最后给出整体评价（通过 / 需修改）

编写建议

一个高质量的技能应包含以下要素：

明确的目标：说明技能要解决什么问题
具体的步骤：列出执行的详细步骤
约束条件：定义边界和限制
输出规范：说明期望的输出格式和质量标准

WARNING

技能内容应当清晰、具体。模糊的描述会导致 Agent 执行结果不稳定。

适用场景

场景	示例
稳定的处理规则	数据清洗规范、代码审查标准
固定的输出风格	周报模板、文档格式要求
长期复用的操作说明	部署流程、测试规范
领域专业知识	行业术语规范、合规检查清单

不适合用技能的场景

以下场景更适合使用其他方式：

纯粹依赖外部程序执行的操作：应考虑使用 MCP 工具接入
需要实时调用 API 的能力：应通过工具与 MCP 实现
一次性的简单指令：直接在会话中输入即可

INFO

技能定义的是"知识和规则"，MCP 提供的是"执行能力"。两者配合使用效果最佳。

下一步

接入外部工具：工具与 MCP
社区技能资源：市场资源
Agent 完整能力：AI 助理

技能 ​

核心概念 ​

什么是技能 ​

技能与 Prompt 的区别 ​

创建技能 ​

手动创建 ​

导入技能 ​

SKILL.md 文件结构 ​

Frontmatter 字段说明 ​

示例 ​

编写建议 ​

适用场景 ​

不适合用技能的场景 ​

下一步 ​

技能