---
title: 开发 SKILL
description: 写一份完整方法，导入后用具体输入核对输出。
lastVerified: 2026-10-23
---

# 6.5 开发 SKILL

SKILL 告诉员工一项工作应该怎样做。先写一份小而明确的方法，用虚构输入验证，再逐步增加资料和工具。

## 在平台用自然语言创建 {#create-in-chat}

> 本节示例已用真实 MiniMax 验证；相关修复已包含在 0.2.10 中。截图使用虚构反馈，生成内容以实际模型输出为准。

打开 **市场 > 我的应用与技能 > 添加应用或技能（+）> 创建技能**。输入下面的说明，点 **继续**，到会话中核对并发送：

```text
创建一个“编号反馈简报”技能，供我重复整理带编号的客户反馈，
技能标识用 feedback-brief-demo。
按问题归类，统计每类数量；每项结论引用反馈编号。
输出：最多三条主要发现、一段结论、待确认问题。
只处理我提供的文字，不联网、不外发，不补造客户信息。
这是本例原创方法，采用 MIT 许可，请在 SKILL.md 的 frontmatter
中写入 license: MIT。
先生成完整技能正文和创建预览，供我检查。
```

检查正文中的适用场景、步骤、计数口径和输出格式。需要调整时在原会话说明，满意后回复：

```text
确认应用这份“编号反馈简报”技能草稿，并安装、启用它。
仅处理文字，不增加外部工具权限。
```

在 **我的应用与技能** 核对安装状态，然后新开会话试做：

```text
先加载已安装的 feedback-brief-demo，再整理以下虚构反馈。
按原反馈编号计数，不自动去重。F1 与 F3 是否重复录入只列为
待确认，不改变本轮数量；不得推断客户身份。
[F1] 导入 CSV 时提示编码错误。
[F2] 希望支持深色模式。
[F3] 导入 CSV 时提示编码错误。
```

应得到 CSV 导入 2 条（F1、F3）、深色模式 1 条（F2），合计 3 条。查看调用记录确认实际加载了该技能，不能只看回答是否声称“已使用”。给员工使用时，还需关联到该员工。

打开已安装技能的 **分享技能**，检查文件后导出，或生成在线链接。接收方在 **员工 > 导入模板** 粘贴链接，读取预览并 **确认添加**；如有同名来源冲突，先核对当前选用版本；确认收到的技能可用后，用同一输入复测。完整步骤见[分享与接收](https://docs.teloa.ai/v/0.2.31/markdown/guides/sharing.md)。MIT 只适用于本例原创内容；分享其他作者的技能须保留原许可。

<figure class="guide-screenshot">

[![自然语言创建的技能分享预览](https://docs.teloa.ai/v/0.2.31/assets/screenshots/nl-create-skill.jpg)](https://docs.teloa.ai/v/0.2.31/assets/screenshots/nl-create-skill.jpg)

</figure>

*本地 MiniMax 实测：原创技能已生成分享预览。模型生成的正文可能不同，仍需检查方法和文件。 点击图片查看原图。*

## 下载一个完整例子

[下载 SKILL 示例](https://docs.teloa.ai/v/0.2.31/examples/resource-authoring-024/skill.zip)。解压后有两种使用方式：

- 直接接收：在员工页 **导入模板** 中选择 `skill.json`。
- 编辑后导入：修改 `sources/skills/evidence-brief/SKILL.md`，在市场 **创建 > 导入技能** 中选择这个技能目录。

不要把整个 ZIP 当作分享 JSON。目录导入、分享接收的具体区别见[资源打包](https://docs.teloa.ai/v/0.2.31/markdown/develop/packages.md)。

## 编写 SKILL.md

文件使用 UTF-8，名称与目录身份一致。下面是一份可直接保存的完整方法：

```md
---
name: evidence-brief
description: Summarize supplied notes with sources and unresolved questions.
---

# Evidence brief

Read only the supplied, numbered notes. Write:
1. Three findings, citing the note ID for each.
2. A short conclusion, distinguishing observations from interpretation.
3. Unresolved questions and any missing evidence.

Do not invent sources. Do not browse, send, publish or modify external systems.
```

`name` 用小写字母、数字和连字符，如 `evidence-brief`；界面显示名称可以是中文。`description` 说明何时使用这套方法，正文写清步骤和交付要求。

## 导入并关联员工

在市场 **创建 > 导入技能** 选择包含 `SKILL.md` 的单个目录。展开 **名称与版本**，核对资源标识 `evidence-brief`、显示名称与固定版本，再保存内容。打开技能详情，按状态完成安装或启用。

给员工使用时，先暂停测试员工，关联技能后恢复在岗，再发起新任务。导入内容、安装到运行环境和关联员工是三个动作，以实际状态为准。

## 用同一输入检查效果

```text
请使用 evidence-brief 方法，只整理这些虚构笔记：
[N1] 周一收到 12 条反馈，其中 4 条提及导入失败。
[N2] 周二收到 8 条反馈，其中 2 条提及导入失败。
[N3] 尚未记录反馈来自新用户还是老用户。
```

检查结果是否给出 20 条反馈、6 条导入问题及相应来源，并保留新老用户分布未知。再把 N2 改为 3 条导入问题，要求重做，结果应更新为 7 条。用缺少 N2 的输入再测一次，应报告信息缺口。

查看实际任务和调用记录，确认方法被采用；员工说“我用了技能”本身不算证据。纯文字方法不需要给员工额外的文件、网络或发送权限。

## 更新和分享

修改后提高固定版本，核对引用它的员工和任务。采用新版本前预览变化；旧任务仍保留原来的固定内容。要生成分享文件，在解压目录运行：

```sh
node pack.mjs skill.json
```

再按[分享方法](https://docs.teloa.ai/v/0.2.31/markdown/guides/sharing.md)导出文件或生成公开链接。修改其他人的技能时，先核对其许可，保留来源和修改说明；官方市场收录规则见[投稿指南](https://github.com/teloa-ai/marketplace/blob/main/CONTRIBUTING.md)。

## 常见问题

| 现象 | 检查 |
| --- | --- |
| 目录导入失败 | 是否有唯一 SKILL.md、frontmatter 是否完整、名称是否一致 |
| 分享导入后仍是旧正文 | 修改 sources 后是否运行 pack.mjs |
| 员工没有按方法输出 | 技能是否可用、是否已关联当前员工、是否新开本轮任务 |
| 需要的工具不能调用 | 在连接和岗位授权中配置；写进方法不会自动授权 |