12 Skills 怎样组织工作方法
你已经用工具完成一次活动审阅。下次换成另一场活动,又要重新说明统计顺序、报告格式、未知信息处理和检查标准。
当一套方法值得反复使用时,可以把它整理成 Skill。这里要学习的不是“装几个技能”,而是看清方法保存了什么、怎样进入任务、怎样通过失败样本改进。
12.1 哪些要求适合保存成技能
临时要求放在当前任务中。Agent 长期角色可以放在系统提示词中。可重复的工作方法及其资源,适合组织成 Skill。
例如,“这次只改标题”是临时要求;“你审阅活动资料,事实和建议分开”是长期角色;完整的读取、统计、报告生成、异常处理与检查方法,可以形成活动审阅技能。技能与能力库
Skill 不会重新训练模型。它通过说明和资源影响工作方法,再利用已有工具完成实际动作。
12.2 打开一个 Skill 看里面是什么
最小技能包含一个 SKILL.md,文件开头的元数据帮助发现适用任务,正文描述怎样工作。较复杂的技能再增加参考资料、模板或脚本。
activity-review/
├── SKILL.md
├── assets/report-template.md
├── references/review-rules.md
└── scripts/check_registrations.py这是练习包实际提供的目录。脚本只读取给定 CSV 并打印计算结果;不会因为文件存在就自动运行。
12.3 元数据 正文和资源的不同职责
name 标识技能,description 说明做什么、何时适用。正文要写输入、步骤、分支、输出和完成标准,而不是只堆砌专业身份。
模板固定报告结构,参考文件承载细节,脚本可以实现确定性处理。资源依赖与路径要清楚,不能引用一个从未提供的文件。
Agent Skills 规范介绍按需加载的组织方式:先用描述发现技能,需要时再读取说明和资源。但每个宿主如何实现、是否能看到加载记录,仍要按实际环境确认。格式与资源规范
实验 E26 拆解课程技能
操作步骤
- 打开练习包中的 skills/activity-review/SKILL.md。
- 分开标出元数据和正文,说明这个技能解决什么问题。
- 在正文里找到输入、步骤、异常处理和检查标准。
- 打开模板、参考规则和脚本,说明哪些用于阅读、哪些可能需要执行工具。
- 画出说明、资源、工具和产物的关系,不把某个可选文件当成所有技能都必须有。
完成标准
你能解释每个文件为何存在,并发现任何依赖缺失。先阅读源码,不把脚本直接拿到真实目录试运行。
参考解释
模板提供形式,规则提供依据,脚本提供一种计算辅助。技能没有硬编码社区日期或 9 人,应该按每次任务自己的输入处理。它也不包含真实密钥。
12.4 安装 启用与使用需要分别观察
本机实际操作是:新建智能体的“技能”步骤 → 添加技能 → 本地导入 → 从文件夹安装,选择包含 SKILL.md 的 activity-review 目录。安装成功后,它出现在列表,但复选框仍未勾选。
之后打开课程智能体的“管理技能”,将 activity-review 切换为启用。下面截图证明当前绑定状态,实际加载说明与使用模板,还要继续查看任务轨迹和产物。
将方法写成可以阅读的说明
下面是一份缩短的技能正文,展示条件与动作如何写清楚。练习包提供的版本还包括模板、参考与可选脚本。
---
name: activity-review
description: 审阅指定活动资料,核对人数、版本冲突和未知事项,生成带来源的报告。
---
# 活动资料审阅
只使用用户指定的材料与输出位置。
缺少必要材料时先列出缺项,不推测内容。
1. 列出实际读取文件,确认当前有效版本。
2. 读取报名规则,定义状态筛选和去重键。
3. 使用真实报名数据计算,不把固定示例数字写入方法。
4. 将事实、建议和未知事项分开。
5. 按模板生成新报告,不覆盖原始材料。
6. 回读输出,核对数字、来源和遗漏。
版本优先关系不明:列冲突,请求确认。
工具读取失败:报告错误,不声称已读取。
文件无法写入:展示待保存内容,不声称已生成文件。这些条件让使用者能够检查“怎样处理”,而不只是判断语气是否专业。正文也没有替用户授权其他目录或外部账号。
从技能到实际动作的关系
一种常见组织方式是先发现适用描述,需要时读取工作说明,再按任务读取模板或参考,调用相应工具,最后检查成果。具体加载顺序和可见证据以宿主为准。
模型可能读懂了模板,却没有写入文件;也可能运行了脚本,却没有核对版本。Skill 要把这些检查写清楚,使用者仍需从真实轨迹判断完成到哪里。
当前产品提供技能全局管理和 Agent 绑定。安装列表里出现一个技能,不证明当前 Agent 能选择;能够选择也不证明本次实际加载;加载了也不保证完整遵守。
你需要结合可见读取或加载记录、实际动作和产物检查。不能只问“你用了技能吗”,然后把肯定回复当成独立证据。
实验 E27 对照技能使用前后
准备
一个课程专用 Agent,同一模型、工具、材料与任务说明。先保留未启用技能的基线。
操作步骤
- 在未启用技能的新任务中完成一次活动审阅,保存输入、实际动作和输出。
- 在“设置—技能”从课程本地文件夹或 ZIP 安装 activity-review。
- 查看全局启用状态,再在课程 Agent 的技能配置中启用。
- 新建相同条件任务,明确使用课程技能,不粘贴上一份答案。
- 检查可见加载或资源读取记录,以及是否完成模板、来源、数字和回读检查。
- 再观察技能已安装但未给该 Agent 启用的情况,将各状态分别记录。
完成标准
保存前后产物及方法遵守检查。没有可见加载记录时,仅报告可核对的行为,不断言全部说明已被读取。
参考解释
没有技能时也可能成功。我们比较的是复用、检查一致性和异常处理,而不是预设一个必胜结果。技能中规定回读,仍需要真实回读动作支持。
实验 E28 把一次经验写成新技能
操作步骤
- 从成功任务中提炼稳定步骤,删除具体活动日期、人数和路径值。
- 写清适用与不适用情况,以及必要输入。
- 规定事实、建议、未知项怎样分开,输出模板怎样使用。
- 为缺失文件、版本冲突、统计规则不明和写入失败分别写处理分支。
- 说明可选脚本依赖,不把工具或权限声明写成自动获得能力的保证。
- 在专用 Agent 中用新方法完成一个小任务,回读实际产物。
技能应要求:先确认当前资料与规则,再统计和生成。
版本优先关系不明时列出冲突;规则缺失时请求补充。
只在用户指定的输出位置写新文件,不覆盖原材料。
完成后核对来源、数字、未决事项和实际文件。完成标准
形成可供别人阅读与复用的草稿。文本方法可以先完成,不要求所有人编写程序。对脚本或外部资源的引用要实际存在。
参考解释
“你是活动专家,请做好报告”缺少可检查方法。一个可复用技能应说明怎样得到结论、遇到问题怎么办以及怎样算完成。
实验 E29 用失败样本改进技能
先定义用例的输入边界
| 用例 | 允许作为依据的输入 | 预期行为 |
|---|---|---|
| 正常社区任务 | 当前说明、规则、CSV | 正式人数 9,保留未知事项 |
| 规则缺失 | 只提供 CSV 与缺失说明,不授权读取别的规则 | 请求规则,不自行决定口径 |
| 版本冲突 | 两份未标优先关系的冲突说明 | 列出冲突,不凭 A/B 名称猜最新 |
| 文件不存在 | 指定不存在的测试路径 | 报告真实错误,请求补充或明确修正 |
| 校园新主题 | 只用校园材料与 CSV | 正式人数 3,不复制社区数字 |
输入边界需要在任务中明确。如果你允许 Agent 搜索整个课程目录,它找到缺少的规则可能是合理动作,不能再把这个结果算作“没有遵守缺失测试”。
操作步骤
- 在运行前写检查项:正常案例要正确统计,缺规则要先询问,版本冲突要列出待确认。
- 分别运行正常、缺失、冲突和不存在文件的测试,在独立任务中保留结果。
- 找出具体失败步骤,只修改相关说明或模板,保留前后版本。
- 用原问题集复测,再用校园案例检查是否沿用社区事实。
- 对照有工具无技能、有技能缺必要工具、二者都有三种条件;记录替代工具路径,不假装已关闭全部执行能力。
- 汇总改善、退化和仍需人判断的部分。
完成标准
交出技能源文件、测试输入、产物和修订理由。技能安装数量不作为学习成果;一次成功也不能替代多输入检验。
参考解释
校园案例去重后的正式人数是 3,容量 12,剩余 9。通用方法应该重新读取规则和数据,而不是沿用社区的 9 人与剩余 21。缺少工具时,知道步骤也不意味着能实际保存文件。
实测:技能被调用后,还要看资源和产物
这轮在新任务中明确要求使用 activity-review,并换成校园案例。展开处理记录后,能看到“处理 activity-review”、读取 report-template.md 与 review-rules.md、读取三份输入、写入报告、回读报告。
实际输出按模板分为当前事实、报名口径、冲突与未知、建议、检查记录;核对原表得到 5 条记录、4 条已确认、3 位正式人员,容量 12,剩余 9。新活动的时间与地点也没有沿用社区案例。
这是明确点名技能后的迁移案例,不能证明所有相关任务都会自动触发技能;前后两轮使用不同案例,也不是严格的效果对照。检查自动发现是否稳定,应另用相同输入、相同模型与任务要求重复实验。
自检题
01一个 Skill 能否只有 SKILL.md?
可以。规范的最小结构包含元数据与 Markdown 说明,资源按需要增加。文件数量不代表质量,应服务于具体方法与复用。
02Skill 和一条临时提示词有什么区别?
两者都可以表达指令。Skill 更便于组织适用描述、步骤、模板、参考和脚本,并持续维护与复用;不保证天然比一条完整提示词更强。
03脚本放进技能目录后会自动执行吗?
不能这样认为。需要宿主支持、工具执行能力、依赖与相应授权。文本说明本身不会读写文件,资源存在也不等于被使用。
04安装成功,是否证明这个 Agent 已经使用了 Skill?
不是。安装、全局启用、当前 Agent 绑定、实际加载与方法遵守需要分别检查。只有自述或安装列表不构成全部证据。
05技能里能否授予缺少的工具权限?
不能把说明文本当成授权。权限由宿主和用户控制,可选工具声明也不保证各实现支持,更不会自动安装工具或提供凭据。
06为什么测试要增加一个全新主题?
防止方法只适用于原例子,或把旧日期和数字固化在规则里。新材料可以检查步骤是否可迁移,仍需要独立核对输出。
下一章的MCP主要连接外部能力。技能提供方法,MCP 提供连接约定,两者可以组合,但不能互相替代。
本章资料:技能与能力库、Agent Skills 规范、能力组合。



