好文集ChatGPT Plus¥119

把重复工作做成一键 Skill,新手 5 步就够,附我的 Skill 目录结构

文章目录

第一个 Skill 写到能用就行,先把你每天重复三遍以上的一件事写下来。

比如你负责一家门店,每个月底都要把销售明细整理成一份汇报。第一次让 AI 做,你交代了版式、统计口径,还有要不要写原因分析。下个月换了新数据,这些话得重新说一遍,做出来的版式还和上个月不一样。

这类事适合做成 Skill。做完以后,下个月你只说一句“做 12 月的门店汇报”,AI 会按你写好的步骤和标准,拿新数据重做一份。

这篇按“是什么、怎么做、常见问题”三段写。先讲 Skill 是什么,再用这个例子走完 5 步,最后回答新手最常碰到的 12 个问题,并附上我公开在 GitHub 上的 Skill 目录结构,你可以照着改成自己的。

开始前只要准备两样东西。一个能用 Skill 的 AI 工具,Codex、Claude Code、Cursor 都可以。再想好一件你重复做过的事,手边最好有一份上次的成品。Skill 本身是一份文字说明,不需要写代码。

文章配图

1、Skill 是什么

1.1 一份写给 AI 的工作说明书

Skill 是一个文件夹,里面有一份叫 SKILL.md 的说明文件。你可以把它看成交给 AI 的工作说明书,像岗位 SOP,也像给新人看的操作手册,写清这件事怎么做、做到什么程度算完成。AI 遇到相关任务时会去读它,照着做。

它和你平时发给 AI 的提示词有一处明显不同,不用每次重新粘贴。按 Claude Code 官方文档的说法,平时只有每个 Skill 的名称和描述在对话里,真正用到时才把全文读进来,不用的时候占的空间很小。

这套写法在 Codex、Claude Code、Cursor 里都认。格式通用,放在哪个目录、怎么点名调用,各个工具有各自的规定,2.5 会逐个讲。

1.2 一个 Skill 由三块内容组成

我这一两个月一直在做自动化,最后总结下来,核心就三块,流程、知识库和工具。流程是主线,在流程里把知识库和工具组合起来,才变成一件能自己跑的事。

流程写这件事怎么做。每次拿到什么材料,分几步处理,交出什么成品,就像给新人看的 SOP。三块里数它最重要,写第一个 Skill 时先把它写清楚。

再看知识库,放你的口径、上一次的好成品、返工过的地方,让 AI 了解你。它是可选项。事情要和你高度相关时,最好配一份知识库。只是按固定格式做个总结,更多是在模仿一种模式,有没有知识库差别不大。

工具决定 AI 能不能动手。读文件、抓会议记录、把结果发给同事,都靠它。没有工具的 AI 只能站在旁边给建议,有了工具,它才能把事情往前推一步。

文章配图

拿门店汇报对照一下。核对两张表的月份、做各店对比、写原因解读、套版式生成网页,这是它的流程。上个月的汇报和你返工过的规则,构成它的知识库。读表格、生成网页这类动作,AI 工具通常自己就能做,这一块暂时用不着另外装工具。

1.3 什么任务值得做成 Skill

选任务我看三件事。你做过至少三次,下次还会做;材料、步骤和成品你都能说清楚;做完以后你能看出对不对。三件都满足,就值得写。缺一件,先继续手动做几次。

Skill 有大有小。小的只是一个固定动作,大的是一整套复杂编排的流程,上下限差得很远。第一个选最小的,下面三类都适合起步。

  • 整理一个杂乱的文件夹。输入是一堆命名随意的文件,成品是命名统一、分好类的副本,外加一份目录页。

  • 做固定格式的周报或会议纪要,输入是本周记录或会议转写,成品是一页版式固定的文档。

  • 给选题出 5 个标题和一份大纲,只要给出选题和目标读者,就能拿到候选标题加结构化大纲。

我做的离职交接 Skill 属于第一类。离职交接那段时间,每次都要在对话里让 AI 整理同一批工作文档,整理规则要重新说一遍。后来我把规则写成 Skill,现在执行一次,它会把零散文件规范命名、按岗位分类,再生成一个离线网页当入口,打包后交给负责人或 HR。

2、怎么做,新手 5 步

文章配图

下面用门店汇报走一遍。5 步做完,你的第一个 Skill 就能一句话调用。

2.1 第一步,写流程

打开你的 AI 工具,新建一个文本文件,写下四件事。每次拿到什么材料,分几步处理,交出什么成品,你会怎么叫它。门店汇报可以这样写。

输入 当月销售明细表,当月会员变动表,上个月的汇报(只参考版式)
做法 先核对两张表的月份,再做各店对比,接着写原因解读,最后套上月版式生成网页
输出 一份 6 到 10 页的网页汇报,每页一个结论标题,给各店店长看
叫法 做 12 月的门店汇报

不会拆步骤,就先把这件事画成流程图,纸上画或者让 AI 帮你画都行,画出来的每个框就是一步。材料多又杂的时候,可以让 AI 先把你的文件夹看一遍,列出每次都一样的部分,再由你确认。写完这一步,别人不用问你,也知道该准备什么材料、该交什么东西。哪里写不下去,说明这件事还没拆清楚,先补清楚再往下走。

文章配图

2.2 第二步,写判断标准

AI 会交差,但不知道你怎样才算满意。判断标准就是你检查成品时会看的那几条,要写成 AI 自己也能检查的样子。

“数据要准确,分析要深入,版式要美观”这样的标准没法检查,AI 和你都说不清是否通过。门店汇报可以改成下面这几条。

  • 每家门店都出现在销售对比里,没有漏店。

  • 同比用去年同月,环比用上个月,两个都要写。

  • 会员流失比上月多 10% 以上的门店,单独写一页,原因找不到就写“待确认”。

  • 每一页只有一个结论,标题就是这个结论。

  • 汇报里的每个数字,都能在两张表里找到出处。

写完逐条问自己,看到成品,我能回答“是”或“否”吗?能回答的才算标准。判断标准由你来定,这是整个 Skill 里最该由人写的部分。

文章配图

2.3 第三步,配上知识库和工具

这一步可以很轻。几条经验加两份样例,就算有了知识库,用不到的工具不用装。

先说知识库。经验就是你以前返工过的地方。回想上个月这份汇报改了几遍,每次为什么改,把它们写成“遇到什么情况,就怎么做”。门店汇报里可以放这几条。

  • 金额统一写成万元,表头标明单位。

  • 会员流失率用当月流失人数除以月初会员数。

  • 原因解读只复述数字不算合格,要写出多出来的销售额来自哪几家门店。

再放一份你认可的上月汇报当好样例,和一份你不想再看到的成品,写下它哪里不行。好坏两头都有,AI 就有了对照。样例放进 references/ 文件夹,在 SKILL.md 里写明什么时候去读哪一份。

我的离职交接 Skill 里也有这样的规则。没有确认材料所在的文件夹,就不开始扫描,也不从最近记录里猜;只重命名复制进交接包的副本,原始文件不改名、不移动;岗位和接手人还没确认,只出草稿版。这几条都在公开的 SKILL.md 里,2.6 给了链接。

再看工具。先问自己,这个流程里有没有要去外面拿的东西,或者要往外送的东西。拿的比如读两张表,送的比如把汇报发给各店店长。读表和生成网页,AI 工具通常自己就能做。要接别的软件,先看它有没有现成的命令行工具或接口,有就写进 Skill,说明什么时候用哪个、失败了怎么办。

流程、判断标准、知识库和工具,这四块合起来就是 SKILL.md 的主体。写得含糊,某一次做得漂亮,换一批材料就可能走样。

文章配图

2.4 第四步,试跑和修正

先把前面几块合成一个 Skill 文件。在你的 AI 工具里发下面这段话,把括号里的内容换成你自己写的。

请把下面的内容整理成一个 Skill,名字叫 store-monthly-report,放在我的个人 Skill 目录里。
动手之前先画一张流程图给我确认,我说可以了你再创建文件。

(粘贴第一步的流程)
(粘贴第二步的判断标准)
(粘贴第三步的经验、样例和工具说明)

先画图再动手,是我做 Skill 的固定习惯,确认之前不让它生成任何文件。我公开的 skill-creator 把这一步写进了流程,创建前先出方案图,等你确认再动手,需要的话可以直接装来用。

确认流程图后,打开生成的 SKILL.md 看一眼,它大致长这样。

---
name: store-monthly-report
description: 把门店当月的销售明细和会员变动整理成网页版月度汇报。用户要做门店月度汇报、月底复盘时使用。
---

# 门店月度汇报

## 输入
当月销售明细表、当月会员变动表,上月汇报只参考版式。缺哪样先问用户,不自己补数据。

## 输出
6 到 10 页网页汇报,每页一个结论标题。

## 做法
1. 核对两张表的月份是否一致。
2. 做各门店销售对比,再做会员新增与流失。
3. 写原因解读和下个月要做的事。
4. 套用上月汇报的版式生成网页。

## 判断标准
(第二步那五条)

## 经验和样例
(第三步的规则,好坏样例放在 references/ 里)

## 工具
读表和生成网页用 AI 工具自带的能力。

接着用三种材料试跑,完整的、缺一样东西的、明显不对的,各来一次。

  • 完整材料。给齐两张表,看它有没有自己用上这个 Skill,成品是否过得了第二步的每一条。

  • 缺材料。只给销售表,看它会追问会员表,还是自己编一份。

  • 明显不对的材料。混进一张 10 月的会员表,看它能不能发现月份对不上。

文章配图

试跑里碰到的问题,先判断它属于哪一块。没有用上这个 Skill,或者拿错了材料,改 description 和输入;成品不合格,改判断标准;同一个坑再次出现,补进经验和样例。一次只改一处,改完用同一批材料再跑一遍。

三种材料都按预期走完,第一个 Skill 就能用了。后面想加功能,一次加一块,再按这一步试跑。

2.5 第五步,放到固定位置,一句话调用

下面的目录和调用方式,按这三个工具 2026 年 11 月的官方资料整理,以后升级了,以各自官方文档为准。Skill 文件夹要放在你的工具会读取的位置。

  • Claude Code 放在 ~/.claude/skills/名字/SKILL.md,只想在某个项目里用,就放项目里的 .claude/skills/。

  • Codex 放在 ~/.agents/skills/名字/SKILL.md,项目里对应 .agents/skills/,旧版的 ~/.codex/skills/ 也还能读。

  • Cursor 放在 ~/.cursor/skills/名字/SKILL.md,项目里对应 .cursor/skills/。Cursor 也会读取 /.agents/skills/、/.claude/skills/ 和 ~/.codex/skills/。

我的做法是只放一份真身,其他工具的目录用软链接指过去。只用 Codex 和 Cursor,放在 ~/.agents/skills/ 就够,两个都会读。还用 Claude Code,就在终端里建一个软链接。

mkdir -p ~/.claude/skills
ln -s ~/.agents/skills/store-monthly-report ~/.claude/skills/store-monthly-report

这两行要在终端里敲,不想自己动手,就把它们发给 AI,让它帮你执行。这样改一处,三个工具里看到的是同一份。

文章配图

名字只能用小写英文、数字和连字符。description 决定 AI 什么时候用它,怎么写见 3.6。

调用时,Codex 里输入 $store-monthly-report,Claude Code 和 Cursor 里输入 /store-monthly-report,后面接上你的要求,比如 /store-monthly-report 做 12 月的门店汇报。三个工具也会根据 description 自动选用它,不点名也行。

新开一个对话,只说一句话,AI 就找到这个 Skill 开始按步骤做,这就是标题里说的一键。没有找到,先核对放置的位置,再回到上一步改 description,排查顺序见 3.7。

2.6 我的 Skill 目录结构

第一个 Skill 的目录很小,一份 SKILL.md 加一个放样例的文件夹就够。

store-monthly-report/
├── SKILL.md
└── references/
    └── good-example.md

SKILL.md 放流程、判断标准和经验。上月的好成品放进 references/,并在 SKILL.md 里写明什么时候去读它。以后有每次都要跑的固定操作,比如同一段计算,再加一个 scripts/ 放脚本。Claude Code 的官方文档建议 SKILL.md 控制在 500 行以内,更长的内容拆到别的文件里按需读取。

再看我的离职交接 Skill 现在的样子,它公开在 GitHub 上。

文章配图

offboarding-handover/
├── SKILL.md              393 行
├── agents/               5 个专职子代理的说明
├── references/           21 份参考文档
└── scripts/
    ├── bootstrap_handover.py
    └── sync_claude_agents.py

第一个 Skill 用不着这么多,目录会随着需求变多,先从一份 SKILL.md 开始。完整内容在我的 Skill 仓库,除了离职交接,还有 skill-creator 等另外三个 Skill 的完整目录,可以对照着看。

3、常见问题

3.1 我完全不会写代码,能做 Skill 吗

能。Skill 是一份用中文写的说明,上面五步都不用写代码。流程里碰到每次算法都一样的步骤,比如算会员流失率,才考虑写成脚本,这一步可以请 AI 来写。你要做的是拿一份已经知道答案的数据跑一遍,核对结果对不对。

3.2 Skill 和提示词、说明文件有什么区别

提示词是你在一次对话里临时说的话,下次得重新说。Claude Code 里的 CLAUDE.md 这类说明文件,每次对话一开头就整份读进去。Skill 放在固定位置,平时只有名称和描述在对话里,AI 判断任务相关,或者你点名叫它,才读全文,还能带上样例和脚本。官方文档建议 CLAUDE.md 控制在 200 行以内,参考资料挪到按需加载的 Skill 里。

只做一次的事,写提示词就够了。同一件事会反复做,又想要稳定的结果,写成 Skill 才划算。

文章配图

3.3 一定要有知识库和工具吗

不一定。流程是必需的,知识库和工具看这件事需要什么。要用你的口径、你写过的文章,就配知识库。只是照固定格式做个总结,没有知识库也行。流程里没有要去外面拿、往外送的动作,就用不着工具。

我的建议是第一个 Skill 先把流程和判断标准写清楚,经验和样例放几条就够,不用急着搭完整的知识库,也不用急着接工具。试跑发现 AI 总是不了解你的口径,再扩充知识库。发现自己总在手动搬材料,再补工具。

3.4 资料很多,要全放进 SKILL.md 吗

不用。几条规则加几份好样例放进 Skill,它本身就是一个最小可用的知识库。资料多了,AI 一次装得下的内容有限,也没法把你的全部资料塞进一份 Skill,更合适的做法是放在外面,比如一个文件夹或一个文档库。

SKILL.md 里只写目录,说明什么时候去读哪一份,AI 用到时再去取。更长的内容也拆到别的文件里,需要时再读。

文章配图

3.5 工具从哪里来,什么时候写成脚本

先看你要接的软件有没有现成的命令行工具或接口,会议、文档这类软件有的已经提供,有就直接用。同事做好的工具也能拿来用,不用自己从头做。都没有,就把需求告诉 AI,请它写一小段脚本,放进 Skill 的 scripts/ 文件夹。

判断一步该不该写成脚本,看它输入是否明确、规则是否稳定、结果好不好验收。这样的步骤交给脚本,比每次让 AI 重新推理更可靠。需要判断和取舍的步骤,留在 SKILL.md 里交给 AI。

3.6 description 怎么写,AI 才会想起用它

description 是 AI 判断要不要用这个 Skill 的主要依据。Claude Code 的官方文档提醒过,描述含糊或者互相重叠,AI 可能选错 Skill,也可能漏掉该用的那个。

写成两句。先说它做什么,再说什么时候用,并带上你平时会说的词。比如“帮忙处理汇报”这样写,AI 分不清是月报还是周报。换成“把门店当月的销售明细和会员变动整理成网页版月度汇报。用户要做门店月度汇报、月底复盘时使用。”,它就知道什么场景该用。几个 Skill 的场景相近时,每个都写出自己独有的那一部分。

3.7 写好了,AI 没有用它怎么办

按顺序查五件事。先看 description 里有没有你平时会说的词,AI 靠它判断什么时候用。再问 AI 现在有哪些可用的 Skill,确认它在列表里。接着换个说法再试一次。还不行就直接点名,Codex 里输入 $名字,Claude Code 和 Cursor 里输入 /名字。点名也不认,就检查名字有没有写错,文件开头那段说明信息的格式对不对。

这五项参考的是 Claude Code 官方文档里的排错清单,Codex 和 Cursor 同样靠 description 判断。装的 Skill 很多时,Claude Code 会缩短一部分描述来省空间,所以 description 开头就要写清用途。

文章配图

3.8 同样的材料,每次做出来不一样怎么办

先看是哪里不一样。版式不一样,把你认可的成品放进 references/,在 SKILL.md 里写明照这份版式做。结论不一样,把判断标准写得再具体,写到能回答是或否。数字不一样,把计算交给脚本。每次只补一处,补完用同一批数据再跑一遍,看变化是不是你想要的。

3.9 AI 缺材料时自己编数据怎么办

在输入那一块写明缺哪样先问,不自己补数据。再用缺一样东西的材料试跑,看它会追问,还是自己编一份。我检查 Skill 时至少用三种材料,完整的、缺东西的、明显不符合要求的,确认它会追问缺失的信息。试跑时没追问,就把追问的规则补进输入,再跑一遍。

3.10 Skill 里能写账号密码和 API Key 吗

不要写。SKILL.md 会被 AI 读取,也可能被你分享出去,里面写了密码或密钥,就等于交给了每个读到这份文件的人。需要凭证的步骤,Skill 里只写用哪个工具、去哪里取,凭证本身放在工具自己的配置或单独的保险库里。我自己就是这样做的,Skill 里只写怎么调用读取脚本,不写内容。分享之前,再把整个文件夹搜一遍,确认没有残留的密钥。

3.11 别人写的 Skill 能直接装吗

装之前先读它的 SKILL.md,再看 scripts 文件夹里的脚本。需要跑命令或联网的,先用只读沙箱和审批模式试,看清它会碰哪些文件、访问哪些服务,再决定要不要放开权限。

3.12 我改了 Skill,已经分享出去的人会同步吗

对方会不会跟着变,要看他的工具怎么安装和更新,不能默认自动同步。分享时在 SKILL.md 里写清它会读写哪些目录、会不会联网、会不会执行命令,再附一个最小例子,注明你是在哪个工具、哪个版本里试的。稳妥的做法是固定到一个版本或提交,把变更说明和验收例子一起留好,更新后再测一遍。

文章配图

想放到 WorkBuddy 这类平台上变现,可以先读我之前写的《WorkBuddy Skill 变现终极教程》,再回头检查上面这几件事。

嵌入推文(联网查看)

回到你自己的那件事。今天就挑一件你这周已经重复过三次的事,写下它的流程,再写三条判断标准。这两步写完,后面三步都有了依据。

这篇可以转给每个月都在重复做同一份报告的同事。我平时会把用过的 Skill 和搭自动化流程的做法整理出来,关注我可以接着看。

全文完
查看原文

沿着这个主题继续读

从一篇文章,找到相关的教程、经验和阅读路径。

AI SkillsAI Skills 使用、编写与工作流实践,按开发、表格和知识整理任务选技能。