1像菜谱
普通人会炒菜,但看菜谱能做得更稳定。Agent 很聪明,但看 Skill 能按你想要的方式做事。
这份课件把 Agent Skill 讲成厨房菜谱、岗位手册和工具箱。目标不是背概念,而是让零基础的人能听懂、能照着写、面试时能说清楚。
先不要想代码。先想一个会干活的人,遇到不同任务时,需要不同的说明书。
普通人会炒菜,但看菜谱能做得更稳定。Agent 很聪明,但看 Skill 能按你想要的方式做事。
新员工进公司需要手册:这里的流程、规则、模板、禁忌是什么。Skill 就是 Agent 的岗位手册。
Skill 会告诉 Agent:这个任务要用哪些脚本、参考资料、模板、素材,而不是每次重新找。
面试里最容易被追问的是概念边界。用下面四张小图记住它们的区别。
做事的人。它能理解目标、拆步骤、调用工具、检查结果。
这一次的吩咐。比如:“帮我整理这份简历。”
长期可复用的方法。比如:“整理简历时,先看岗位,再改经历。”
能实际操作的工具。比如读文件、查网页、跑脚本、生成图片。
Skill 不是神秘系统。它通常就是一个文件夹,里面最重要的是 SKILL.md。
resume-helper/
├── SKILL.md # 必须有:说明什么时候用、怎么做
├── agents/
│ └── openai.yaml # 推荐:给界面展示名字和简介
├── scripts/
│ └── score_resume.py # 可选:稳定重复的程序放这里
├── references/
│ └── interview-rubric.md # 可选:长资料、评分标准放这里
└── assets/
└── resume-template.docx # 可选:模板、图片、字体等素材
最核心。前面用 YAML 写名字和触发描述,正文写操作步骤、注意事项、验证方法。
脚本、参考文档、素材不是每个 Skill 都要有。只有重复、复杂、需要稳定的地方才加。
SKILL.md。最常用、最核心的写在正文;很长的资料放到 references/,需要时再读。
用“简历优化 Skill”举例。她面试时可以照着这个流程讲。
---
name: resume-helper
description: Help improve resumes for job applications. Use when the user asks to revise, tailor, score, or prepare a resume for a specific role or interview.
---
# Resume Helper
## Workflow
1. Read the target role and identify the 3-5 most important requirements.
2. Read the resume and find evidence that matches those requirements.
3. Rewrite bullets to show action, context, measurable result, and relevance.
4. Keep facts accurate. Do not invent experience, metrics, employers, or education.
5. Return the revised resume plus a short explanation of what changed.
## Quality Bar
- Every changed bullet should be easier to scan.
- Important keywords from the job description should appear naturally.
- The final answer should separate facts from suggestions.
面试官可能会问:你怎么判断一个 Skill 写得好不好?答案看这里。
Agent 已经懂很多常识。Skill 只写它不知道、但任务必须知道的东西。
description 要写清楚使用场景,因为 Agent 先看它来判断是否加载 Skill。
好 Skill 不只告诉 Agent 做什么,还告诉它怎么检查结果是否达标。
让她做完这三道练习,比单纯听讲更容易在面试中讲出来。
Agent Skill 是给 AI 帮手看的工作说明书,告诉它遇到某类任务时按什么步骤做、用哪些资料、最后怎么检查。
触发描述:当用户要求整理会议录音、会议文字、待办事项或会议总结时使用。流程:先识别参会人和主题;再按决策、待办、风险、开放问题分类;最后输出简洁纪要和负责人截止日期。
不太适合单独写,因为太空。更好的写法是把“有条理”变成格式要求,例如“输出必须分为背景、结论、行动项、风险四部分”。
先背会 30 秒版本,再学会 3 分钟展开。面试时先短后长,别一上来讲太散。
Agent Skill 可以理解为给 AI Agent 的可复用工作说明书。
它定义了什么场景下使用、按什么流程执行、需要哪些脚本或参考资料,以及最后怎么验证结果。Prompt 更像一次性的指令,Skill 更像长期沉淀下来的业务流程。
我会从三个层面理解 Agent Skill。
第一,它解决的是复用问题:同类任务不用每次重新解释流程。
第二,它解决的是稳定性问题:把步骤、禁忌、质量标准写清楚,Agent 更容易按预期执行。
第三,它解决的是资源组织问题:长文档放 references,稳定脚本放 scripts,模板素材放 assets,核心说明放 SKILL.md。
description 很关键,因为它决定 Agent 什么时候会触发这个 Skill。正文则负责告诉 Agent 触发之后怎么做。
这部分可以打印出来,当作面试前速记卡。
SKILL.md,可选 scripts/、references/、assets/。
能用“帮手和说明书”讲清楚,不急着写代码。
选择她熟悉的业务,比如简历、会议纪要、客服回复。
用 30 秒版本开场,再用结构、例子、好坏标准展开。