6.5 开发 SKILL

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

在平台用自然语言创建

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

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

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

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

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

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

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

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

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

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

下载一个完整例子

下载 SKILL 示例。解压后有两种使用方式：

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

不要把整个 ZIP 当作分享 JSON。目录导入、分享接收的具体区别见资源打包。

编写 SKILL.md

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

---
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、显示名称与固定版本，再保存内容。打开技能详情，按状态完成安装或启用。

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

用同一输入检查效果

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

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

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

更新和分享

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

node pack.mjs skill.json

再按分享方法导出文件或生成公开链接。修改其他人的技能时，先核对其许可，保留来源和修改说明；官方市场收录规则见投稿指南。

常见问题

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