Skip to content

12 Skills 怎样组织工作方法 ​

你已经用工具完成一次活动审阅。下次换成另一场活动,又要重新说明统计顺序、报告格式、未知信息处理和检查标准。

当一套方法值得反复使用时,可以把它整理成 Skill。这里要学习的不是“装几个技能”,而是看清方法保存了什么、怎样进入任务、怎样通过失败样本改进。

12.1 哪些要求适合保存成技能 ​

临时要求放在当前任务中。Agent 长期角色可以放在系统提示词中。可重复的工作方法及其资源,适合组织成 Skill。

例如,“这次只改标题”是临时要求;“你审阅活动资料,事实和建议分开”是长期角色;完整的读取、统计、报告生成、异常处理与检查方法,可以形成活动审阅技能。技能与能力库

Skill 不会重新训练模型。它通过说明和资源影响工作方法,再利用已有工具完成实际动作。

12.2 打开一个 Skill 看里面是什么 ​

最小技能包含一个 SKILL.md,文件开头的元数据帮助发现适用任务,正文描述怎样工作。较复杂的技能再增加参考资料、模板或脚本。

text
activity-review/
├── SKILL.md
├── assets/report-template.md
├── references/review-rules.md
└── scripts/check_registrations.py

这是练习包实际提供的目录。脚本只读取给定 CSV 并打印计算结果;不会因为文件存在就自动运行。

一个 Skill 怎样组织工作方法
一个 Skill 怎样组织工作方法元数据帮助发现技能,正文给出方法,资源按需读取,工具负责动作;具体加载策略依宿主实现。 发现技能名称与适用描述判断是否适合任务读取工作说明步骤、条件与边界输出和检查标准按需使用资源模板、参考和脚本明确依赖与路径通过工具落实实际读取和生成核对是否符合方法方法与能力配合
元数据帮助发现技能,正文给出方法,资源按需读取,工具负责动作;具体加载策略依宿主实现。查看原图 →

12.3 元数据 正文和资源的不同职责 ​

name 标识技能,description 说明做什么、何时适用。正文要写输入、步骤、分支、输出和完成标准,而不是只堆砌专业身份。

模板固定报告结构,参考文件承载细节,脚本可以实现确定性处理。资源依赖与路径要清楚,不能引用一个从未提供的文件。

Agent Skills 规范介绍按需加载的组织方式:先用描述发现技能,需要时再读取说明和资源。但每个宿主如何实现、是否能看到加载记录,仍要按实际环境确认。格式与资源规范

实验 E26 拆解课程技能 ​

操作步骤 ​

  1. 打开练习包中的 skills/activity-review/SKILL.md。
  2. 分开标出元数据和正文,说明这个技能解决什么问题。
  3. 在正文里找到输入、步骤、异常处理和检查标准。
  4. 打开模板、参考规则和脚本,说明哪些用于阅读、哪些可能需要执行工具。
  5. 画出说明、资源、工具和产物的关系,不把某个可选文件当成所有技能都必须有。

完成标准 ​

你能解释每个文件为何存在,并发现任何依赖缺失。先阅读源码,不把脚本直接拿到真实目录试运行。

参考解释

模板提供形式,规则提供依据,脚本提供一种计算辅助。技能没有硬编码社区日期或 9 人,应该按每次任务自己的输入处理。它也不包含真实密钥。

12.4 安装 启用与使用需要分别观察 ​

本机实际操作是:新建智能体的“技能”步骤 → 添加技能 → 本地导入 → 从文件夹安装,选择包含 SKILL.md 的 activity-review 目录。安装成功后,它出现在列表,但复选框仍未勾选。

已安装的 activity-review 在创建步骤中尚未绑定

之后打开课程智能体的“管理技能”,将 activity-review 切换为启用。下面截图证明当前绑定状态,实际加载说明与使用模板,还要继续查看任务轨迹和产物。

课程智能体中 activity-review 已启用

将方法写成可以阅读的说明 ​

下面是一份缩短的技能正文,展示条件与动作如何写清楚。练习包提供的版本还包括模板、参考与可选脚本。

markdown
---
name: activity-review
description: 审阅指定活动资料,核对人数、版本冲突和未知事项,生成带来源的报告。
---

# 活动资料审阅

只使用用户指定的材料与输出位置。
缺少必要材料时先列出缺项,不推测内容。

1. 列出实际读取文件,确认当前有效版本。
2. 读取报名规则,定义状态筛选和去重键。
3. 使用真实报名数据计算,不把固定示例数字写入方法。
4. 将事实、建议和未知事项分开。
5. 按模板生成新报告,不覆盖原始材料。
6. 回读输出,核对数字、来源和遗漏。

版本优先关系不明:列冲突,请求确认。
工具读取失败:报告错误,不声称已读取。
文件无法写入:展示待保存内容,不声称已生成文件。

这些条件让使用者能够检查“怎样处理”,而不只是判断语气是否专业。正文也没有替用户授权其他目录或外部账号。

从技能到实际动作的关系 ​

一种常见组织方式是先发现适用描述,需要时读取工作说明,再按任务读取模板或参考,调用相应工具,最后检查成果。具体加载顺序和可见证据以宿主为准。

模型可能读懂了模板,却没有写入文件;也可能运行了脚本,却没有核对版本。Skill 要把这些检查写清楚,使用者仍需从真实轨迹判断完成到哪里。

当前产品提供技能全局管理和 Agent 绑定。安装列表里出现一个技能,不证明当前 Agent 能选择;能够选择也不证明本次实际加载;加载了也不保证完整遵守。

你需要结合可见读取或加载记录、实际动作和产物检查。不能只问“你用了技能吗”,然后把肯定回复当成独立证据。

实验 E27 对照技能使用前后 ​

准备 ​

一个课程专用 Agent,同一模型、工具、材料与任务说明。先保留未启用技能的基线。

操作步骤 ​

  1. 在未启用技能的新任务中完成一次活动审阅,保存输入、实际动作和输出。
  2. 在“设置—技能”从课程本地文件夹或 ZIP 安装 activity-review。
  3. 查看全局启用状态,再在课程 Agent 的技能配置中启用。
  4. 新建相同条件任务,明确使用课程技能,不粘贴上一份答案。
  5. 检查可见加载或资源读取记录,以及是否完成模板、来源、数字和回读检查。
  6. 再观察技能已安装但未给该 Agent 启用的情况,将各状态分别记录。

完成标准 ​

保存前后产物及方法遵守检查。没有可见加载记录时,仅报告可核对的行为,不断言全部说明已被读取。

参考解释

没有技能时也可能成功。我们比较的是复用、检查一致性和异常处理,而不是预设一个必胜结果。技能中规定回读,仍需要真实回读动作支持。

实验 E28 把一次经验写成新技能 ​

操作步骤 ​

  1. 从成功任务中提炼稳定步骤,删除具体活动日期、人数和路径值。
  2. 写清适用与不适用情况,以及必要输入。
  3. 规定事实、建议、未知项怎样分开,输出模板怎样使用。
  4. 为缺失文件、版本冲突、统计规则不明和写入失败分别写处理分支。
  5. 说明可选脚本依赖,不把工具或权限声明写成自动获得能力的保证。
  6. 在专用 Agent 中用新方法完成一个小任务,回读实际产物。
text
技能应要求:先确认当前资料与规则,再统计和生成。
版本优先关系不明时列出冲突;规则缺失时请求补充。
只在用户指定的输出位置写新文件,不覆盖原材料。
完成后核对来源、数字、未决事项和实际文件。

完成标准 ​

形成可供别人阅读与复用的草稿。文本方法可以先完成,不要求所有人编写程序。对脚本或外部资源的引用要实际存在。

参考解释

“你是活动专家,请做好报告”缺少可检查方法。一个可复用技能应说明怎样得到结论、遇到问题怎么办以及怎样算完成。

实验 E29 用失败样本改进技能 ​

技能怎样通过失败样本改进
技能怎样通过失败样本改进用同一测试集比较修改效果,再增加新主题检验迁移;安装技能不等于已经可靠使用。 先写预期行为正常、缺失和冲突明确检查项目运行并保留结果记录输入和版本观察具体失败修改工作方法补步骤、规则或模板只改相关内容复测与新材料检查旧问题是否修复确认没有带入旧事实复用需要反复检验
用同一测试集比较修改效果,再增加新主题检验迁移;安装技能不等于已经可靠使用。查看原图 →

先定义用例的输入边界 ​

用例允许作为依据的输入预期行为
正常社区任务当前说明、规则、CSV正式人数 9,保留未知事项
规则缺失只提供 CSV 与缺失说明,不授权读取别的规则请求规则,不自行决定口径
版本冲突两份未标优先关系的冲突说明列出冲突,不凭 A/B 名称猜最新
文件不存在指定不存在的测试路径报告真实错误,请求补充或明确修正
校园新主题只用校园材料与 CSV正式人数 3,不复制社区数字

输入边界需要在任务中明确。如果你允许 Agent 搜索整个课程目录,它找到缺少的规则可能是合理动作,不能再把这个结果算作“没有遵守缺失测试”。

操作步骤 ​

  1. 在运行前写检查项:正常案例要正确统计,缺规则要先询问,版本冲突要列出待确认。
  2. 分别运行正常、缺失、冲突和不存在文件的测试,在独立任务中保留结果。
  3. 找出具体失败步骤,只修改相关说明或模板,保留前后版本。
  4. 用原问题集复测,再用校园案例检查是否沿用社区事实。
  5. 对照有工具无技能、有技能缺必要工具、二者都有三种条件;记录替代工具路径,不假装已关闭全部执行能力。
  6. 汇总改善、退化和仍需人判断的部分。

完成标准 ​

交出技能源文件、测试输入、产物和修订理由。技能安装数量不作为学习成果;一次成功也不能替代多输入检验。

参考解释

校园案例去重后的正式人数是 3,容量 12,剩余 9。通用方法应该重新读取规则和数据,而不是沿用社区的 9 人与剩余 21。缺少工具时,知道步骤也不意味着能实际保存文件。

实测:技能被调用后,还要看资源和产物 ​

这轮在新任务中明确要求使用 activity-review,并换成校园案例。展开处理记录后,能看到“处理 activity-review”、读取 report-template.md 与 review-rules.md、读取三份输入、写入报告、回读报告。

实际任务中的 Skill 调用、资源读取与文件工具记录

实际输出按模板分为当前事实、报名口径、冲突与未知、建议、检查记录;核对原表得到 5 条记录、4 条已确认、3 位正式人员,容量 12,剩余 9。新活动的时间与地点也没有沿用社区案例。

校园案例使用 Skill 后返回真实报告及本轮数字

这是明确点名技能后的迁移案例,不能证明所有相关任务都会自动触发技能;前后两轮使用不同案例,也不是严格的效果对照。检查自动发现是否稳定,应另用相同输入、相同模型与任务要求重复实验。

自检题 ​

01一个 Skill 能否只有 SKILL.md?
参考答案

可以。规范的最小结构包含元数据与 Markdown 说明,资源按需要增加。文件数量不代表质量,应服务于具体方法与复用。

02Skill 和一条临时提示词有什么区别?
参考答案

两者都可以表达指令。Skill 更便于组织适用描述、步骤、模板、参考和脚本,并持续维护与复用;不保证天然比一条完整提示词更强。

03脚本放进技能目录后会自动执行吗?
参考答案

不能这样认为。需要宿主支持、工具执行能力、依赖与相应授权。文本说明本身不会读写文件,资源存在也不等于被使用。

04安装成功,是否证明这个 Agent 已经使用了 Skill?
参考答案

不是。安装、全局启用、当前 Agent 绑定、实际加载与方法遵守需要分别检查。只有自述或安装列表不构成全部证据。

05技能里能否授予缺少的工具权限?
参考答案

不能把说明文本当成授权。权限由宿主和用户控制,可选工具声明也不保证各实现支持,更不会自动安装工具或提供凭据。

06为什么测试要增加一个全新主题?
参考答案

防止方法只适用于原例子,或把旧日期和数字固化在规则里。新材料可以检查步骤是否可迁移,仍需要独立核对输出。

下一章的MCP主要连接外部能力。技能提供方法,MCP 提供连接约定,两者可以组合,但不能互相替代。

本章资料:技能与能力库、Agent Skills 规范、能力组合。

微信联系

李不凯的个人微信二维码,扫码添加好友

使用微信扫一扫,手机上可长按保存二维码