---
title: 编写第一份技能
description: 用 SKILL.md 定义可执行、可复核的方法。
lastVerified: 2026-09-23
---

# 6.2 编写第一份技能

技能是方法说明，不是工具权限或模型权重。先选择一项范围明确、能够检查结果的工作。

## 最小格式

目录中放置 `SKILL.md`，使用 UTF-8：

```markdown
---
name: research-brief
description: 根据已授权资料生成带来源的研究简报，区分事实、推断和待核实项。
---

# 研究简报

1. 写明问题、读者和截止时间。
2. 每条事实附来源；没有依据则标记待核实。
3. 单独列推断、分歧与不确定性。
4. 给出结论和核验清单，不执行对外发送。
```

`name` 使用小写英文字母、数字和单个连字符分隔，例如 `research-brief`。不要用中文、空格、下划线或文件名代替技能标识；名称必须与导入时声明的技能身份一致。界面显示标题可以使用中文。

## 导入并验证

进入 **市场 → 导入 → 导入 Skill**，选择包含 `SKILL.md` 的目录。填写标识 `research-brief`、显示名称“研究简报”和版本 `1.0.0`。保存技能后，在资源页核对说明与正文。

导入后打开资源条目，按状态完成安装或启用。先暂停研究同事，再修改配置并关联该技能，完成后恢复在岗。回到能力页检查状态；导入目录、安装到运行环境与岗位关联是不同步骤。

为同事提供一段虚构资料并要求使用技能。检查输出是否真的区分事实与推断、是否保留来源，以及是否没有擅自调用外部工具。

## 更新与失败

更新技能时提高版本，并检查引用它的任务模板是否仍固定旧版本。若导入被拒绝，先检查 frontmatter、身份一致性、目录边界和编码。

[下载完整通用研究示例包](https://docs.teloa.ai/examples/general-research.zip)，其中包含合法技能、岗位、资料与任务模板。包中的关联声明不自动授予工具权限。