Agent Skills 是把一类任务的做法保存成技能目录，让支持该格式的 AI 工具按需读取。最小目录只需要一个 SKILL.md：前面的元数据说明何时使用，后面的正文说明怎样完成任务。它适合保存反复使用的工作方法；连接外部系统则通常还需要工具或 MCP。
Skills、提示词与 MCP 有什么区别？
| 对象 | 负责什么 | 周报任务中的例子 |
|---|---|---|
| 提示词 | 本次具体要求 | 本周写中文周报，控制在500字内 |
| Skill | 可反复使用的方法 | 固定归纳进展、阻塞、下周动作，不猜结果 |
| MCP/工具 | 读取或操作外部数据 | 查询项目任务、读取会议记录 |
三者可以一起用：MCP负责取回任务，Skill说明如何归纳，当前提示词指定本周范围。仅安装Skill不会自动获得项目系统访问权；一个只处理你提供文本的Skill，也不必接入MCP。
完整 SKILL.md 示例
下面是可保存的周报技能，示例只整理输入材料，不要求联网或发送消息。目录名与name保持一致，文件使用UTF-8编码。
weekly-report/
SKILL.md
---
name: weekly-report
description: 将用户提供的本周工作记录整理成进展、阻塞和下周动作；用户要求周报时使用。
---
先确认输入的日期范围。逐条区分已完成、进行中、待确认。
输出三个部分：本周进展、当前阻塞、下周动作。
保留项目名、负责人、日期和原始数字；缺失信息写“待确认”。
只有输入明确说已上线，才能归入已完成。
不发送消息，不修改外部项目，不编造业务结果。怎样放进工具并触发？
- 先查看所用工具的Skills说明，确认它支持开放格式及扫描目录。不要把不同工具的个人目录混用。
- 创建weekly-report目录并保存SKILL.md。若工具允许直接选择技能目录，选择这个目录；若使用固定目录，按该工具当前文档放置。
- 新建或刷新会话，确认技能出现在可用列表，然后输入下面的触发请求。
- 检查是否读到了这份技能，以及结果是否保留了“待确认”状态；仅回复得像周报还不能证明自动触发成功。
请用 weekly-report 整理10月19日至22日周报。
输入：产品A已完成接口联调，尚未上线；产品B等待供应商报价；下周由小林补充报价比较。预期结果应把产品A写成“联调完成、待上线”，把产品B列为等待报价，并保留小林的下一步动作。若输出“产品A成功上线”，就没有遵守技能中的状态约束。这个输入和预期结果也可作为你修改技能后的回归样例。
没有生效时检查哪里？
先检查文件名是否正好为SKILL.md、元数据能否解析、name是否与目录一致；再检查description是否明确描述周报任务。若手动指定能用、自动触发不能用，优先改触发说明。若两种方式都失败，检查路径和工具兼容性，不要只增加正文长度。
继续阅读
上下文工程是什么？与提示词工程的区别及上下文整理示例；MCP 工具太多怎么办？Tool Search 与程序化调用的区别
资料与更新说明
资料核验于2026年10月22日。下列演示输入、费用算例和任务拆分由本文设计；未标明实测的外部模型调用不代表本次已运行。产品开放范围与费用以官方当前页面及账号为准。