Skip to content

本篇导读

预计阅读时间:8 分钟。读完你会明白技能(Skill)是什么、它和 MCP 及规则文件的区别、以及怎么写出你的第一个技能。这是 Agent 系统解构的最后一站。

解构 Agent 系统的最后一站,讲一个最有「积累感」的部件:技能。

从一个场景说起

假设你每个月都要做一次月报:拉数据、套模板、生成图表、排版输出。流程固定,每次二十分钟。

第一次你教 Agent 做,它做得不错。第二个月,你又从头教了一遍。第三个月,又一遍。

你肯定想到了:把这套流程存下来,以后直接用。这个「存下来的操作手册」,就是技能(Skill)。

技能长什么样

一个技能,物理上就是一个文件夹,里面必有一份 SKILL.md 文件。它的结构简单到令人发指:

技能名称/
└─ SKILL.md      ← 开头写名字和描述,正文写操作手册

SKILL.md 开头用几行元数据告诉 Agent「我是谁、什么时候该想起我」;正文就是完整的工作流程,想写多细写多细——步骤、注意事项、示例、甚至附上现成的脚本文件。

技能文件夹统一放在用户目录 .zcode\skills\ 下(如果这个文件夹还不存在,在文件管理器中输入 %USERPROFILE%\.zcode\,新建一个叫 skills 的文件夹即可)。会话开始时,Agent 只加载每个技能的「名字 + 描述」(几十个字,很省空间);一旦你的任务匹配上某个技能的描述,它才会展开读完整手册。这个设计叫渐进加载,和上一节记忆系统的「目录 + 按需取用」是同一个思路。

和 MCP、AGENTS.md 的区别

三个东西都是「给 Agent 添能力」,分工完全不同:

部件本质一句话区分
AGENTS.md规矩「你应该怎么做人」——约束和偏好,全局生效
MCP外部工具「你能用什么武器」——接上新的能力源,搜索或其他工具
Skill操作手册「这件事的标准打法」——沉淀流程和经验,只有用到时才按需加载,根据你的提示词进行判定

还拿职场类比:AGENTS.md 是员工守则,MCP 是配发的办公设备,Skill 是老师傅带徒弟时留下的作业指导书。

另外注意一个细节:很多技能的核心其实还是调用 MCP 工具或终端命令——技能的价值不在于提供新能力,而在于把「什么时候做、按什么顺序做、怎么做得对」这些经验固化下来。能力是工具的,流程是技能的。

写一个最小的技能

新建文件夹 .zcode\skills\weekly-report\,里面放一份 SKILL.md:

markdown
---
name: weekly-report
description: 整理指定文件夹里的文件并生成周报。用户提到周报、
  每周整理时使用。
---

# 周报生成流程

1. 读取用户指定的文件夹,按修改时间列出本周新增和改动的文件
2. 按文件类型分组统计数量
3. 套用上周的周报模板(存放在本技能目录 template.md)
4. 生成报告前,先向用户展示统计结果并确认

网络上有极多现成的技能,可以帮助你更好地完善你的工作流。但在下载使用时也需要注意甄别,确保下载渠道为官方。否则某些恶意技能可能会进行提示词注入攻击,窃取你的密钥等敏感信息。

保存,重启会话,然后对它说「帮我做一份周报」——你会看到它按手册逐步执行。恭喜,你刚刚完成了一次「经验资产化」:这份流程以后不属于你的记忆,而属于你的工具。

系统解构·总结

五节走完,我们把 Agent 系统拆了个底朝天:

  1. 执行环境——手和脚:工作目录、文件读写、终端、权限
  2. 规则文件——做人原则:AGENTS.md 分层立规矩
  3. 记忆系统——三层记忆:工作记忆、会话摘要、持久记忆
  4. MCP——外部武器:标准化的工具接口
  5. Skill——经验沉淀:可复用的操作手册

规则管做人,记忆管相识,工具管武器,技能管打法——四件套配齐,这个 Agent 才真正是「你的」。

从下一章开始,进入实战。第一站从最简单的任务入手,让你把这些概念先用起来。

Powered by VIDDsys