第 08 次课:Agent 技能安装、创建与修改 ​

一、上节课回顾 ​

上节课三个要点:

  1. 装好 WorkBuddy 并选定了工作目录:目录决定 AI 能读写多大范围,也决定生成的文件落在哪里。
  2. 用 Ask、Plan、Agent 三种模式各做了一次:Ask 只回答、Plan 先给步骤、Agent 真正动手产出文件。
  3. 用自定义指令和对话记忆把个人偏好固定下来,让 AI 每次对话都按你的规矩输出;并按「能打开、对得上、无虚构」三关核验了周报。

上一周你让 AI 干活,靠的是每次临场写提示词。这一课解决的是重复劳动:什么样的任务值得从「口头交代」升级成「打包技能」,以及技能是怎么被 AI 自己找到并用的。

二、本节课任务与安排 ​

本课交付

把「把材料做成叙事 PPT」这件事打包成一个可复用的技能:先起草一份六项齐全的最小 SKILL.md,用它生成试用 PPT,再独立创建一个自己的技能,最后针对试用发现的问题改规则、换材料复测。

下课时你会带走交付三件套:修改后的 SKILL.md、材料 A 试用 PPTX、材料 B 复测 PPTX 连同修改说明。

顺序环节学生产出时间
回顾回顾上节课想起三种模式与目录授权5分钟
交付看老师演示技能调用知道本课交三件套3分钟
理论理论基础:提示词 VS 技能三句判断 + 技能触发原理10分钟
案例1🔧 案例1:起草一个最小技能narrative-ppt 的 SKILL.md 草稿12分钟
案例2🔧 案例2:加载技能,出试用 PPT试用 PPTX + 一条待改问题13分钟
案例3🔧 案例3:创建自己的技能并完成任务自己的 SKILL.md + 一次调用产物20分钟
案例4🔧 案例4:改技能、换材料复测修改说明 + 复测 PPTX12分钟
收尾回扣方法与边界能复述技能六项与复测意义3分钟
机动等待与排错补齐必做成果2分钟
扩展扩展任务:技能健壮性挑战(选做)缺信息材料的追问记录与产物10分钟

注意:生成 PPTX 依赖的底层技能由教师提前准备,课堂只讲技能规则的设计与调试,不讲 PPT 排版技巧。技能入口、技能库名称和界面位置以课堂当日版本为准,与讲义截图有差异时以老师演示为准。

环境与准备:本课操作能用鼠标点的都用鼠标;本机课程目录 D:\AIGC\lesson-8(不补零)。WorkBuddy 技能市场中 skill-creator 技能与底层 PPT 技能是否可用,以课前实测为准:[课前演练补充]

三、理论基础:提示词 VS 技能 ​

今天案例2 结束时你会发现:给 AI 的那套规矩,你已经打过第二遍了。规矩要一遍遍口头交代,不是 AI 笨,是你还没把它「固化」——什么时候该固化,就是本课要回答的问题。

概念一:Prompt 是站在旁边口头交代。 把 Agent 想成一个刚入职的实习生:很聪明,但不熟你家规矩。Prompt 就是你站在他旁边当场交代——适合一次性的、临场的、随时变的指令;缺点是你一关对话,规矩就跟着对话一起没了。

概念二:Skill 是把重复的经验打包。 技能的本质是把做一件事的流程、规范、步骤、参考资料甚至工具脚本打包进一个文件夹,需要时让 Agent 自己去找。提示词解决一次任务,Skill 解决一类任务;未来会重复出现的任务,就该沉淀成技能。

示意图:一次性提示词与可复用技能的对比

图:左边每次任务都从零交代,要求随对话一起丢失;右边规矩只写一次,三次调用走同一套规则,产物可以横向对比。

概念三:技能靠 description 被自动用上。 SKILL.md 开头的 description 会被提供给 Agent 做匹配:任务描述命中合适的描述后,Agent 才加载这个文件夹按规矩干活。所以 description 写空话(比如「用于生成 PPT」),技能就永远不会被自动用上——必须写清适用场景、触发词,以及什么情况不适用。

决策关口:先写三句话,再进案例1

  1. 什么时候用:写下今天哪类任务值得从一次性提示词升级成 Skill。
  2. 什么时候不用:写下哪类任务仍该直接用提示词,不要硬包装成技能。
  3. 人工必须核什么:写下 description、产物自检和换材料复测里你最不能省的一步。

四、实操环节 ​

案例1:起草一个最小技能 ​

任务目标:

老师带练用 skill-creator 起草「简洁大气叙事 PPT」技能的 SKILL.md,并逐段看懂六项各管什么。技能的质量不看篇幅,看六项是否齐全、规则是否可被验收;description 写得对不对,案例2 立刻见分晓。

示意图:Skill 的目录结构

图:技能就是一个文件夹,SKILL.md 是它的说明书,其余文件是它自带的资料和模板。

实操步骤

  1. 打开 WorkBuddy 技能面板,搜索 skill-creator。执行后你会看到:技能已存在(第 7 课环境已含)则直接用;不存在就按老师给的入口安装,搜不到就举手,不要卡在这一步等。

  2. 新建对话,发送起草指令。执行后你会看到:AI 按六项要求起草出 narrative-ppt 技能的 SKILL.md。

    text
    请帮我创建一个名为 narrative-ppt 的技能。
    输入素材:
    用途:把一份材料变成 4—5 页简洁大气的叙事型 PPT。
    触发词:叙事PPT、汇报PPT、材料转PPT。
    六项要求:name、description、输入要求、工作步骤、输出规范、自检清单。
    description 必须写清适用场景、触发词和不适用的情况。
    输入要求:材料原文、听众、目的、页数,缺任一项先追问再动手。
    工作步骤:定听众与目的、列故事线、每页一个观点、大字留白排版。
    输出规范:可编辑 PPTX,文件名含主题与日期,配图只用授权素材。
    自检清单:页数、文字溢出、字体一致、每页只有一个观点。
    输入素材结束。

    为什么这么做:name 是标识,description 决定它什么时候被自动用上,正文决定它怎么做、做到什么算完。三项里 description 最容易被写废——写成「用于生成 PPT」这种空话,AI 就永远猜不到该不该调用它。

  3. 把草稿里的 description 单独拿出来读一遍,确认里面既有场景也有触发词。执行后你会看到:类似下面这样的一段,含糊的就让它重写。

    text
    ---
    name: narrative-ppt
    description: 把一份材料变成 4—5 页简洁大气的叙事型 PPT。
    当用户提到「叙事PPT」「汇报PPT」「材料转PPT」,
    或给出活动方案、实习总结、复盘记录等文字材料,
    并希望得到页数可控、每页一个观点的演示稿时使用;
    需要 10 页以上的长篇汇报时不适用。
    ---

    检查点:把材料文件拖进一个全新对话、只说「把这份材料做成叙事 PPT」,技能被自动用上就说明 description 写对了;没被用上就补触发词再试。

  4. 确认技能存在哪一级目录:只给当前项目用的存项目级 .workbuddy\skills\,任何对话都能调用的存用户级 %USERPROFILE%\.workbuddy\skills\。执行后你会看到:技能文件落在你选定的目录里。

    查什么合格的样子
    六项齐全name、description、输入要求、工作步骤、输出规范、自检清单一项不少
    description 合格有场景、有触发词、有不适用说明
    规则可验收每条规则都能逐项打勾,不是「简洁大方」这类形容词
    目录正确技能文件在用户级或项目级目录,位置与用途匹配

问题与注意事项

  • 技能面板里找不到 skill-creator:先按老师给的入口安装;搜不到就用教师机演示的草稿模板对照,不要干等。
  • description 写得很含糊:看里面有没有具体场景、触发词和「不适用」;含糊就重写,再用「只说一句话拖材料」的检查点测一次自动触发。
  • 搞不清技能该存哪一级:问自己「这个技能是不是只给当前项目用」,是就存项目级,否就存用户级。

扩展练习(选做)

拿草稿做一次「换材料检验」:把材料换成另一个主题再读一遍六项规则,每条仍然成立才算合格。执行后你会得到:凡是出现本次任务专有名词的规则都被改成了通用表述的技能文件。

案例2:加载技能,出试用 PPT ​

任务目标:

在一个全新的对话里用这份技能把材料 A 做成 4—5 页 PPT,并按验收单找出至少一个真问题。本案例验证「技能有没有真的被加载、能不能直接产出可交付的文件」,顺便留一个待改的问题给案例4。

实操步骤

  1. 从课程资料页下载 材料 A(实习经验分享) 放进 D:\AIGC\lesson-8,新建一个任务,只把材料文件拖进对话。执行后你会看到:材料出现在对话里,工作目录指向本课目录。

  2. 发一句最短的指令,故意不用手动点名,检验 description 能不能让技能被自动用上。执行后你会看到:技能被自动调用,并按工作步骤先确认听众和目的,再列故事线。

    text
    把这份材料做成 4—5 页的叙事 PPT,文件保存到当前工作目录。

    为什么这么做:指令越短,越能检验技能本身。如果还要你重述一遍要求,说明规则没写进技能,等于没做。

  3. 按技能的追问补充听众和目的(材料 A 里已写明:同班同学和老师,5 分钟分享),让它继续生成。执行后你会看到:一份 4—5 页的 PPTX 出现在工作目录里。文件打不开或只给了大纲文字,回案例1 检查「输出规范」。

  4. 打开文件逐页看,按下表打勾,并必须写出至少一个可改进的问题。执行后你会得到:一份带问题记录的试用稿验收表。

    text
    试用稿验收(材料A):
    □ 每页只有一个观点,标题就是这个观点
    □ 内容全部来自材料A,没有材料里不存在的事实
    □ 单页正文不超过 5 行,没有整段堆字
    □ 文字没有溢出、字体一致、没有乱码
    □ 材料里标注"待补充"的信息,在 PPT 里也标了"待补充"
    我发现的第一个问题(写清在第几页):

    为什么这么做:找问题不是挑毛病。技能创建之后要经过多次测试才能发现问题、不断改进,之后每次触发才能生成符合预期的产物。

    对着验收表核一遍,两行都过关再进案例3:

    查什么合格的样子
    产物达标PPTX 能打开,页数在 4—5 页之间,自检清单全勾
    问题已记录至少写出一条具体到页码的可改进问题

问题与注意事项

  • 技能没被自动触发:看对话里有没有技能调用提示;先手动点名技能,仍不触发回案例1 补 description 触发词。
  • 生成文件打不开或页数为 0:让 AI 重新生成并说明格式;反复失败换用教师提供的底层 PPT 技能。
  • PPT 里出现材料里没有的数据:逐页对照材料原文,要求「删除或改为待确认」,不接受看起来合理的编造。

扩展练习(选做)

把页数要求从 4—5 页改成 3 页重跑一次,对比两次产物在取舍上的差别。执行后你会得到:一条写进问题记录的结论——技能是「按规则压缩」还是「硬删页面」。

案例3:创建自己的技能并完成任务 ​

任务目标:

脱离教师案例,独立做出一个能用的技能并真的用它完成一次任务。本案例检验迁移能力——你写的规则,别人(或一周后的你)照着做,能不能做出同样水准的东西。

实操步骤

  1. 从下面两个任务里选一个(想挑战的选 A,想多看范例的选 B),把选择写进提交说明。执行后你会得到:一条明确的任务线。

    text
    A. 自建技能:创建一个简单技能并完成一次任务
    候选主题(任选其一,也可自定):
    1. 周报助手:把一周记录整理成可提交的周报;
    2. 笔记整理:把零散课堂笔记整理成复习提纲;
    3. 求职邮件:把简历要点写成一封投递邮件。
    要求:六项齐全,并用它真的完成一次任务,保留产物。
    
    B. 选用技能:从技能库选 2 个技能,各完成一个小任务
    要求:每个技能做完一个小任务,并各写一句话适用场景
    (什么情况下该用、什么情况下不该用)。
  2. 下载起跑模板:从课程资料页下载 最小 Skill 样例。先建技能目录:在资源管理器地址栏输入 %USERPROFILE% 回车,双击进入 .workbuddy\skills,在里面右键 → 新建 → 文件夹并命名(如 weekly-report-helper);把样例拖进去,按 F2 改名成 SKILL.md,用记事本改掉名称和正文四段后保存。执行后你会得到:一份属于你自己的 SKILL.md。

    为什么这么做:从模板改比从空白写快得多,也更容易保证六项齐全。真正属于你的是那四段规则——它们来自你做这件事的真实经验,不是 AI 替你编的通用流程。

  3. 用这个技能完成一次真实任务:把一段材料(本周记录、一页笔记、一份简历要点)交给它,只说一句最短的指令。执行后你会得到:一份产物和一次完整的调用记录。

    检查点:产物能被自检清单逐项打勾,说明技能可用;技能主动追问你缺的信息,说明输入要求写对了,这是加分项不是失败。

  4. (进阶,做完基础任务的同学继续)给技能补一个模板文件(放 assets/),或修一次不符合预期的输出:把问题改回规则里,再跑一次同样的材料。执行后你会得到:「修改前 / 修改后」两份产物。

    对着验收表核一遍,三行都过关再进案例4:

    查什么合格的样子
    技能六项齐全自己的 SKILL.md 六项一项不少
    真的调用过有一次完整调用记录和一份产物
    产物过自检自检清单能逐项打勾,追问行为符合输入要求

问题与注意事项

  • 技能跑不出预期产物:先分清是规则写漏还是能力不具备;规则漏了补规则,需要外部工具或密钥的能力换方案。
  • 规则写得像作文、没法执行:看每一条能不能被逐项打勾;把形容词换成可检查的条件(「简洁」改成「单页正文不超过 5 行」)。
  • 把真实姓名、手机号、公司内部数据写进技能或材料:课堂一律用模拟材料,真实内容必须先脱敏再使用。

扩展练习(选做)

与同桌交换技能文件,各自按对方的 SKILL.md 跑同一个小任务。执行后你会得到:一条「照着做能不能复现同样水准」的结论,和对方规则里没写清的一处标注。

案例4:改技能、换材料复测 ​

任务目标:

针对案例2 发现的问题改掉技能里的一条规则,换材料 B 重跑,用对照结果说明改的是可复用的方法。交付三件套:① 修改后的 SKILL.md;② 材料 A 试用 PPTX;③ 材料 B 复测 PPTX 连同《修改说明》。改一次就换一份材料验证,才知道规则有没有真的生效。

实操步骤

  1. 翻译问题:打开案例2 记录的那个问题,把它翻译成技能里的一条规则,直接改 SKILL.md。执行后你会看到:技能文件里多了一条可检查的约束。

    text
    把问题翻译成规则的写法:
    问题:"第 2 页标题太空,看不出这页在讲什么。"
    改成规则:"每页标题必须包含材料中的一个具体名词或数字,
    禁止使用'概述''介绍''分享'这类不含信息的泛标题。"
    问题:"第 3 页文字太多,正文堆成一整段。"
    改成规则:"单页正文不超过 5 行,超过则拆成两页或改为要点列表。"
  2. 调整技能:让 AI 按你改后的规则更新技能文件。执行后你会看到:SKILL.md 保存了新规则。

    text
    请根据下面的规则更新 PPT 生成技能:
    1. 每页标题必须包含材料中的一个具体名词或数字。
    2. 禁止使用'概述''介绍''分享'这类不含信息的泛标题。
    3. 单页正文不超过 5 行,超过则拆成两页或改为要点列表。
  3. 复测:从课程资料页下载 材料 B(校园活动复盘),在新对话里用修改后的技能跑同一类任务。执行后你会得到:一份复测 PPTX。

    text
    把这份材料做成 4—5 页的叙事 PPT,文件保存到当前工作目录。

    为什么这么做:只在原文件上改好,说明你修的是这一份 PPT;换一份材料后同样的问题不再出现,才说明你修的是方法。这一步是判断「改得对不对」的唯一标准。

    对着验收表核一遍,三行都过关,交付三件套就齐了:

    查什么合格的样子
    规则真的改了SKILL.md 里能找到翻译后的新规则
    复测通过材料 B 的 PPTX 里原问题不再出现
    三件套齐SKILL.md、试用 PPTX、复测 PPTX + 修改说明都能交出

问题与注意事项

  • 改了规则但复测结果没变化:确认保存的是技能文件本身,并在新对话里重跑,旧对话会沿用旧规则。
  • 老问题消失但出现新问题:正常现象,把新问题记下来继续改一轮;技能就是这样迭代的。
  • 改到一半把技能改坏了:保留每版 SKILL.md 的副本再改,回退到上一版比从零重写快得多。

扩展练习(选做)

把复测中新发现的问题再翻译成第二条规则,连改两轮、每轮都换材料验证。执行后你会得到:一份一轮轮缩短的问题清单,和三句话结论——什么问题值得写进技能、什么问题只该留在当次对话。

扩展任务:技能健壮性挑战(选做) ​

任务目标:

故意给技能喂一份缺关键信息的材料,验证它会按「输入要求」先追问、而不是自行脑补。扩展不计入必做时间,时间不够直接跳过。

实操步骤

  1. 在新对话里发送下面的完整提示词;「输入素材」是一份故意没写听众和目的的材料片段,直接可用,想换自己的场景,只替换「输入素材」到「输入素材结束」之间的内容即可。

    text
    请用我的 narrative-ppt 技能处理下面这份材料。
    输入素材:
    材料片段:上周社团招新,摆了三天摊位,收了 86 份报名表,
    面试后录取 32 人,还有 8 人没来面试。
    输入素材结束。
    如果技能的输入要求里写了必须知道听众和目的,
    请先把你的追问原样列出,等我回答后再继续。
    生成 4—5 页叙事 PPT,保存到当前工作目录,文件名含「招新」。

    执行后你会得到:一段追问记录和一份 PPT。追问出现了,说明案例1 写的「输入要求」真的在管住它;没追问就回案例1 把输入要求改成必须先问的写法。

五、总结与巩固 ​

本节小结:

  • 可复用流程:判断任务是否重复 → 提示词 VS 技能 → 写 SKILL.md 六项 → 加载试跑 → 改规则 → 换材料复测。以后把重复做的事都沉淀成技能。
  • 核心一句话:技能是固化的做事方法,写进 SKILL.md 的规则比每次现想的提示词稳定十倍;而规则有没有生效,只能靠换材料复测来证明。
  • 下节预告:第 9 课让多个专家 / 专家团替你干一件复杂的事。

课后巩固:

  • 完成学习通课后巩固题【M0-01】~【M0-03】、【M1-01】~【M1-03】、【M2-01】~【M2-03】、【M3-01】~【M3-03】、【M4-01】~【M4-02】,M0 题考查提示词与技能的本质差别、技能触发原理,其余题目考查 description 对触发的影响、三条硬标准的判断、输入缺口的处理方式,以及「换材料复测」这一步为什么是判断改动是否有效的唯一标准。

六、资料与下载 ​

  • 课前准备:技能库访问与工作目录:账号检查、技能库入口、目录准备与自查表。
  • 课程素材清单:材料A 实习经验分享、材料B 校园活动复盘、最小 Skill 样例、技能与 PPT 验收单,逐个下载。
  • 技能规范参考:Agent Skills 规范与 WorkBuddy 技能说明文档,入口以老师在课前发布的链接为准。
  • 课堂与课后习题:请在学习通对应单元完成,待补充入口链接。

延伸视频

推荐观看:从使用到原理讲清 Agent Skill 的机制,对应本课提示词与技能的理论核心。