Qoder（通义灵码）使用实践2-创建并使用skill

Skill 是 Qoder 的**可复用任务模板**，本质是一个 Markdown 文件，教 Agent 在某类场景下按规范步骤执行。通过 `/指令` 触发，让 AI 带着你的领域知识和模板干活，省去重复解释。

1.创建skill

1.1 手动创建 Qoder skill

1）. 创建目录

复制代码

.qoder/skills/<skill名称>/

2）创建 SKILL.md（必须）

格式如下：

复制代码

---
name: my-skill-name
description: 这个skill做什么，什么时候触发它。
---

# 标题

## 核心内容
...

两个必填字段：

name：小写字母+连字符，最长64字符

description：第三人称，写清楚做什么和何时触发

3). 创建 reference.md（可选）

放详细代码模板、映射表等，供 SKILL.md 引用，避免主文件过长。

最终结构

复制代码

.qoder/skills/
├── save-user/           ← 你已有的
│   ├── SKILL.md
│   └── reference.md
└── save-organ/          ← 你已有的
    ├── SKILL.md
    └── reference.md

关键规范：

SKILL.md 控制在 500 行以内

reference 引用保持一层深度

描述足够具体，包含触发关键词

你也可以直接用 /create-skill 指令让 Agent 辅助生成，但手动创建同样有效。

2.用 /create-skill 指令创建skill

/create-skill <saveOrgan,根据提示词.md帮我生成xxxxx功能的skill>

尽量选择智能体模式

执行后生成了skill文件，并需要人工确认一下是否接受这个生成结果

3.查看有哪些skill

直接执行 /指令就能看到

4.执行skill

1）. 斜杠指令（最常用）

在对话框输入 / 弹出菜单，选择对应 skill 即可：

2）描述关键词自动触发

Skill 的 description 包含触发关键词，当你提到相关内容时 Agent 会自动匹配加载。比如你说：

"帮我做一个从第三方 API 拉取用户并保存到数据库的功能"

Agent 识别到"第三方"、"用户"、"保存"等关键词后，会自动加载 save-user skill。