← 回總覽

新手小白也能写出好用 Skill,保姆级教程和 SKill 分享。

📅 2026-03-21 16:56 阿真Irene 人工智能 11 分鐘 13360 字 評分: 86
AI Skill Prompt Engineering Claude Code 结构化提示词 Agentic Workflow
📌 一句话摘要 本文是一份针对 AI 开发者和爱好者的 Skill 编写指南,通过结构化框架和原创的“访谈式构建器”,帮助用户低门槛开发高质量 AI 技能包。 📝 详细摘要 文章深入探讨了在 Claude Code、Cursor 等 AI 编程环境下,如何自主开发安全、高效的 Skill(结构化技能包)。作者首先强调了自建 Skill 相比安装第三方工具在安全性和可控性上的优势。随后,文章详细拆解了 Skill 的核心构成,提出了包含目标、触发条件、执行步骤、输出契约等 9 个维度的“多模块骨架”。为了解决新手“需求说不清楚”的痛点,作者分享了一个原创的“访谈式构建器”Skill,该工具能

!Image 1

分享有趣 · 一起精进

嗨大家好!我是阿真!

我算是看明白了,不管是玩转 CC 还是龙虾,就目前来说,首先还是自己要有这个 Skill 输出的能力。不知道最近大家有没有化身囤囤鼠,在各个平台看博主的推荐,安装了非常多各种功能的 Skill。比如我,光是大佬们推荐的和自己搜索安装的就有百八十个。

但实际上,就我自己个人的感受来说,如果是安装了别人的,大部分都使用的不多,甚至有的安装到现在从来没有调用过。

别人写的 Skill 我们未必看得懂它到底干了什么,尤其是那些带脚本、能操作文件、能执行命令的 Skill,装进来就等于给了它更多操作权限。有的龙虾当前会对部分可疑 Skill 给出风险提示或拦截安装,但这不等于所有平台都会帮你把风险兜住。

所以我的建议是:与其到处装别人的 Skill 担心安全风险,不如自己掌握写 Skill 的方法。这个能力是可以不断复用的,学会了之后,我们做的每一个 Skill 都完全在自己的掌控之中,还能根据自己的需求随时调整。

!Image 2

今天这里不讲那些更深奥的进阶知识。只分享我自己的一个超级适合小白且好用的写出自己需要的 Skill 的方法。 我会分享给大家一个我自己做的 Skill,当安装了我这个 Skill 之后,你说“我想要通过访谈来新建 Skill”,这个 Skill 就会开始和你沟通,一步步向你提问。然后在整个对话的过程中,它会逐步梳理清楚你的需求并输出 Skill。

Skill 放在后面,我先讲点基础的东西。

下面这些主要还是作为小白的了解,格式也不用记住,操作也有后面的 Skill 工具托底。 Skill到底是什么, 跟提示词有什么区别?

先说一个我的个人看法。写 Skill 的核心能力,是把一件事说清楚。

我们先复习一下 Skill 的格式👇

!Image 3

简单说,一个 Skill 就像是一个文件夹。你把内容写好放进去,再配一个简短的“封面介绍”。AI 收到任务后,会先扫一眼所有 Skill 的封面介绍,判断当前任务跟哪个 Skill 有关,然后自动加载对应的完整提示词。

就像图书馆管理员,不用把所有书都背下来,只要知道每本书大概讲什么,有人问书名的时候能快速找到对应的那本就行。

所以提示词管的是“当前这一次”,Skill 管的是“这一类任务”。一次写好,反复调用,每次输出稳定。

什么时候该写 Skill 呢?简单的判断标准是:一件事最近一周做了3次以上,做法基本固定,那它就值得变成 Skill 。比如搜集每日专业相关的资讯和资料、做竞品分析、按照公司要求的格式写周报和整理会议纪要、给客户写跟进邮件等等,只要流程基本固定,且输出格式可预期,就都是好的 Skill 候选。

!Image 4 写好Skill的核心

SKILL.md 文件开头有一段元数据,其中首要的是description。把心思全花在正文上,description 随便写两句,后面调用的时候就不方便了。

description 决定了 AI 什么时候会触发这个 Skill 。写得太模糊,该触发的时候不触发;写得太宽泛,不该触发的时候乱触发。

这就好比你去买水果,和店家说要苹果,店家会给你苹果,而不会递给你香蕉、葡萄、草莓。

好的 description 要包含:功能描述 + 触发关键词。 # ❌ 太模糊,AI不知道什么时候该用 description: 帮忙处理文档 # ❌ 太宽泛,什么写作任务都会触发 description: 帮助用户写文章 # ✅ 具体功能 + 触发词 description: | 将故事文本转换为AI视频生成所需的分镜脚本。 当用户说“做分镜“、“分镜脚本“、“故事转分镜“时触发。

如果你的Skill一句话讲不清楚可以干什么,那多半是边界还没收好。这时候试试做减法:砍掉那些副线,保留主线任务。砍掉顺便也能做的部分,只留必须做的那件事,等这件事稳了,再考虑扩展。

小技巧:想想我们自己平时会怎么说话。“帮我做个分镜”、“把这个故事拆成分镜”、“生成分镜脚本”,把这些你可能会用的表达都写进 description 里,AI 才能准确识别,下次你一说它就触发。

!Image 5

截至目前,Claude Code、OpenAI Codex、OpenClaw 这几个体系里,一个可用 Skill 的最小结构通常都是: skill-name/ └── SKILL.md

复杂一点再往里加: skill-name/ ├── SKILL.md ├── scripts/ ├── references/ └── assets/

这个我曾经在拆解我的视频脚本 Skill 的时候详细讲过,感兴趣可以后续看看这篇👉🏻视频分镜提示词Skill,详细制作过程分享!

其中 SKILL.md 是核心,各平台的最小 frontmatter 也很统一,通常就是 name + description 两个字段。所以不管你用哪个平台,上手成本都不高。结构搞清楚了,重点就是把正文内容写好。 多模块骨架

description 搞定之后,正文按什么结构写?我综合了 OpenAI Codex、Claude Code 和 OpenClaw 当前公开文档里的共通思路,梳理了一套骨架。

如果你下面对这些问题很清晰了,那么你可以直接把这些内容全部填完之后,调用一个 Skill Creator 的Skill ,(就是默认可以给你创建 Skill 的那个,对话的时候,你说创建 Skill 就能把它呼唤出来。)直接去完成你的 Skill。

  • 目标是什么
  • 什么情况下触发
  • 什么情况下不要触发
  • 开始前先收集什么信息
  • 按什么顺序干活
  • 输出必须长什么样
  • 做到什么程度算完成
  • 搞不定的时候怎么处理
  • 什么时候去读参考文件
这样 AI 就能清楚地知道该从什么地方开始、做什么、做到哪里停,以及在什么情况下算完成、什么情况别乱来。

这里并不是要求每个模块都要写得很长、很详细,但如果能按照这个框架来写,会比想到什么写什么,或者胡乱、无序地补充要好得多。这样写也不容易有遗漏,能避免后续的反复修改。

!Image 6 SKILL.md 正文写什么

骨架有了,description 也写好了,正文填什么?记住一个原则:你是在给一个聪明但对你的情况一无所知的新同事做工作交接。 1. 只写 AI 不知道的东西。

就这样想,如果你要把这个工作交接给你经验丰富的同事,你需要告诉他什么?Excel 怎么做这种就不用教了吧。

告诉它你的私有规则、个人习惯、行业里的特殊流程等等,这些才值得写。比如“工作周从周三算起”“老板只看柱状图不看饼图”。每写一句想想,这个信息 AI 会知道吗?如果知道,可以删掉。 2. 把流程拆成步骤,带上决策分支。

不只是“第一步、第二步”,还要写清“如果遇到 XX 情况,怎么处理”。比如“如果某个分类没有内容,跳过,不要写'本周无更新'”。这比“你自己判断”靠谱得多。 3. 用示例代替解释。

一个正确示例 + 一个错误示例,胜过三段文字说明。复杂任务就给一个完整的“输入→输出”示例,放到 references/ 文件夹里按需引用。 4. 写任务指令,不要堆身份设定。

“你是一个资深 XX 专家,拥有20年经验”这种人设描述效果并不稳定。一定要告诉 AI 具体要做什么事情。 5. 信息分层,按需加载。

核心规则放主文件,参考资料、模板放单独文件,AI 需要时再去调用读取。主文件控制在 500 行以内,引用保持一层深度,别套娃。SKILL.md 直接引用参考文件就好,(比如“需要参考格式时,请读取 references/output-example.md”),注意参考文件本身不要再引用其他文件。 6. 复杂流程加验证环节。

AI 可能在某一步出错但要到后面才暴露。如果是比较复杂的任务,就可以在关键步骤后加检查点,验证通过才继续。可以在关键步骤后加一句“做完这步先检查 XX 是否正确,确认没问题再继续下一步”。 7. 先跑起来,再慢慢打磨修改。

Skill 很难做到一次就是完美的,可以先做一些尝试,哪里不对再优化。

!Image 7 帮你写 Skill 的 Skill

虽然官方都有类似 Skill Creator 的 Skill ,但说实话,我们的重点不是格式说不清楚,而是需求说不清楚。第一次写 Skill 的时候,大家可能还是会不知道从哪里下手。

所以我做了一个 Skill 来解决这个问题。这也是我自用好物 🐶 ,和大家分享。

这份模板大家可以直接复制过去用,也可以在这个链接下载压缩包,然后扔给CC或者龙虾一类的工具安装。

安装好以后,只要说“我想通过访谈新建一个 Skill ”,或者关键词带有“访谈”和“ Skill ”,它就会一步步问你问题,还会引导你提交配套素材,问完之后直接帮你生成完整的 Skill 文件包,包括 SKILL.md、参考文档、示例文件、文件夹结构和测试 Prompt。你也完全不需要记住骨架怎么填,只要回答问题就行。

大家也可以先看到这个 SKILL.md 的完整格式,当然也可以基于这个去继续进一步的优化和修改,整个内容一键下载可以去这里: https://my.feishu.cn/docx/JERudAXvVowpp7x3d2bctjD0n89?from=from_copylink --- name: skill-interview-builder description: | 通过分步访谈引导用户理清需求,最终产出完整的Skill文件包(含SKILL.md、参考文档、示例文件等), 并打包为可直接使用的压缩包。 当用户说“我想通过访谈新建Skill”、“用访谈方式做一个Skill”、“访谈建Skill”、 “通过访谈帮我生成Skill”、“访谈式创建Skill”、“我想访谈做一个XX的技能”时触发。 触发关键词必须包含“访谈”二字,不含“访谈”的Skill创建请求不由本Skill处理。 不用于已有完整SKILL.md只需小改的情况,也不用于一次性提示词请求。 --- # Skill访谈式构建器 引导用户完成一次结构化需求访谈,收集配套素材,最终打包生成一份可直接使用的完整Skill文件包。 ## 核心原则 1. 用户不需要懂Skill格式——他们只需要回答问题,你来负责转化 2. 每轮问完先小结确认——不要一口气把12个问题全抛出来 3. 允许跳过不确定的问题——给出合理默认值,标注为假设 4. 最终产出必须可直接使用——复制到文件夹就能跑 ## 访谈阶段 ### 第一轮:核心意图 依次问这4个问题: 1. 这个Skill最终要产出什么?(比如:一篇文章、一份报告、一组提示词、一个方案) 2. 你平时会怎么说来触发它?(想想你的自然表达,比如“帮我写个周报”、“做个分镜”) 3. 哪些场景绝对不要触发?(比如:不要用来做XX、遇到XX情况不要用) 4. 做到什么程度算完成?(列出3-5个可以打勾的标准) 问完后,把回答整理成简短摘要,请用户确认后再继续。 ### 第二轮:运行环境 依次问这4个问题: 5. 它运行在什么环境里?(选项:Claude Code / Cowork / Cursor / Windsurf / 扣子 / OpenClaw / ChatGPT / 其他) 6. 允许用哪些工具?(如果不确定可以跳过,默认为该环境的标准工具) 7. 需要读取哪些参考资料或文件?(比如:风格指南、模板、行业规范、历史案例) 8. 需要写脚本吗?(如果不确定,默认不需要) 问完后,整理摘要并标记矛盾点,请用户确认后再继续。 ### 素材收集(第二轮确认后立即进行) 根据第二轮中问题7和问题8的回答,主动引导用户提交配套素材。 明确告知用户: > 根据你刚才描述的需求,这个Skill运行时可能需要以下配套素材。如果你手上已经有,可以现在直接上传给我,我会一起打包到最终的Skill文件包里: 按需列出以下类别(只列用户需求相关的,不要全列): 参考文档:风格指南、行业规范、品牌手册、模板文件等(放入 references/) 示例文件:正例输出样本、反例输出样本、历史案例等(放入 examples/) 脚本或代码:运行时需要的辅助脚本、数据处理工具等(放入 scripts/) 素材资源:图片模板、字体文件、配色方案、图标包等(放入 assets/) 规则: - 用户上传的文件原样保存到对应目录,不做修改 - 如果用户暂时没有,标记为「待补充」,在最终文件包中保留空目录和 README 占位说明 - 如果用户表示不需要任何配套素材,跳过此环节直接进入第三轮 ### 第三轮:输出契约 依次问这4个问题: 9. 最终输出必须长什么样?(描述格式、结构、长度等) 10. 有哪些必须包含的内容? 11. 有哪些必须避免的内容? 12. 能给一个正例和一个反例吗?(如果暂时没有可以跳过) 问完后,汇总全部信息。 ## 工作流程 1. 问第一轮,等待回答 2. 整理第一轮摘要,请用户确认 3. 问第二轮,等待回答 4. 整理第二轮摘要,标记矛盾点,请用户确认 5. 引导素材收集:根据第二轮回答,列出需要的配套素材类别,请用户上传或标记为「待补充」 6. 问第三轮,等待回答 7. 汇总成完整的结构化需求 8. 如果还有矛盾或关键信息缺失,最多追问5个修复问题 9. 根据访谈结果,生成完整Skill包: a. 写一句精确的name和description(description必须包含具体触发词和排除条件) b. 按以下骨架生成SKILL.md正文: - Goal(目标) - When to use(触发条件) - Do not use(排除条件) - Inputs to collect(需要收集的信息) - Procedure(执行步骤,含决策分支) - Output format(输出格式) - Definition of done(完成标准,每条可打勾验证) - Failure handling(异常处理) - Additional resources(配套文件引用,明确列出每个配套文件的路径和用途) c. 创建文件夹结构并写入所有文件: - SKILL.md 放在根目录 - 用户上传的参考文档放入 references/ - 用户上传的示例文件放入 examples/ - 用户上传的脚本放入 scripts/ - 用户上传的素材资源放入 assets/ - 对「待补充」的目录,创建空目录并写入 README.md 说明需要补充什么 d. 生成5条测试Prompt(2条应该触发、2条不应该触发、1条边界) 10. ⚠️ 验证点:检查生成的Skill是否满足以下条件 - 12个问题的回答都有体现在最终Skill中 - description包含用户描述的触发词和排除条件 - 完成标准与用户第4题的回答对齐 - 流程步骤可执行,没有模糊指令(不使用“帮助”“支持”“改善”等模糊动词) - 完成标准每一条都可以打勾验证 - 正文预计不超过500行 - SKILL.md 中 Additional resources 引用的文件路径与实际文件夹结构一致 如果不满足,修正后再继续 11. 根据当前环境能力,选择交付方式(三档降级): 方式A:打包下载(首选) 适用环境:Claude Code、Cowork 等支持 Bash + 文件系统的环境 操作:将整个Skill文件夹打包为 .zip 压缩包,提供下载链接 方式B:写入指定文件夹 适用环境:Cursor、Windsurf 等有文件写入能力但无法打包下载的环境 操作:询问用户保存路径,逐个创建目录和文件,完成后列出文件清单 方式C:纯文本输出(兜底) 适用环境:扣子、ChatGPT 等无文件系统操作能力的环境 操作:在对话中依次输出所有文件内容,每个文件用路径标题分隔,方便复制 判断规则:优先尝试方式A,不支持则降级到B,再不支持则降级到C。 12. 交付最终Skill包,附上关键设计决策的说明和文件清单 ## 生成SKILL.md的质量标准 1. 用具体动作动词开头,不用“帮助”“支持”“改善”等模糊词 2. 触发条件用用户的自然表达,不用技术术语 3. 软性质量要求必须转化为可检查的规则 4. 正文只写AI不知道的信息——不要解释AI已知的概念 5. 正文控制在500行以内,超出部分拆到配套文件 6. 确保另一个AI看了也能直接执行,不需要额外解释 7. 不要堆砌身份设定(如“你是资深XX专家”),聚焦任务指令和流程约束 ## 输出格式 最终交付物根据环境能力,以三种方式之一交付(zip压缩包 → 写入指定文件夹 → 纯文本输出)。 同时在对话中展示以下摘要信息: ### 访谈简报 <三轮问答 + 素材收集的结构化汇总> ### 已解决的问题 <消除的模糊点、做出的假设、解决的矛盾> ### 文件包清单 skill-name/ ├── SKILL.md(核心技能文件) ├── references/(参考文档) ├── examples/(示例文件) ├── scripts/(辅助脚本,如果需要) └── assets/(素材资源,如果需要) 注:只创建用户需求相关的目录。无内容的目录保留 README.md 占位说明。 ### 最终SKILL.md <完整内容,已写入文件包> ### 配套文件说明 <文件路径、来源(用户上传/AI生成/待补充)、用途说明> ### 测试Prompt <5条Prompt及预期触发结果:2条应触发、2条不应触发、1条边界> ### 设计决策说明 <为什么这样设计description、为什么这样划分边界、为什么选择这个文件结构> ## 完成标准 1. 12个访谈问题都有回答或合理推断 2. 矛盾点已解决或已明确标注为假设 3. 产出了完整的SKILL.md,可直接复制到文件夹使用 4. 用户上传的配套素材已归入对应目录 5. 未提供的配套素材目录已创建 README.md 占位说明 6. SKILL.md 中 Additional resources 的文件路径与实际文件夹结构一致 7. 所有文件已通过方式A/B/C之一交付给用户 8. 包含5条测试Prompt及预期结果 9. description足够精确,能被准确触发 10. 所有完成标准都是可打勾验证的 操作流程

首先当然是安装上面的Skill,安装也很简单,直接把附件给工具,让它安装就行了。

安装好以后,开始调用。它提问以后,我针对提问,输出细致的回答。这里我做一个简单的尝试,我做一个 Skill ,可以用来提取视频中的关键帧,生成 9 宫格或者 16 宫格。

第一轮,核心意图👇

!Image 8

第一轮摘要👇

!Image 9

第二轮,运行环境👇

!Image 10

然后第三轮,输出契约👇

!Image 11

最后它会做一个全部访谈的汇总。而且和我确认细节。为了避免由于类似的 Skill 名称导致触发错乱,如果出现冲突,比如我有一个专门生成分镜图的 Skill,那么我就会在这里要求它排除触发生成分镜图的情况。

!Image 12

细节确认后,它会生成Skill。

!Image 13

将这个Skill 压缩包下载下来以后,可以看看里面的文件的内容👇

!Image 14

过程中我上传的那张参考图案例,也在这个 examples 的文件夹里👇

!Image 15

!Image 16

完成一个Skill后,可以对照这个清单过一遍👇

□ 触发词和排除条件都写进了 description

□ 有至少 1 个完整的输入→输出示例

□ SKILL.md 不超过 500 行(超出的参考资料、示例拆到配套文件里)

□ 完成标准每条都能验证

□ 实际测试过至少 3 次且都没有问题 小结

怎么样?现在有没有感觉自己强得可怕?

说了这么多,其实动手最重要。只有尝试了,才会知道会遇到什么问题;遇到问题了,再去思考怎么解决。

一开始完全不用追求大而全。先让第一份 Skill 稳定解决一件小事,把这个弄明白了,后续更进一步会非常快。

最后,写好 Skill = 精准触发 + 清晰流程 + 输出契约 + 可验证标准。

Skill 也没有那么复杂和神秘,说白了它就是给 AI 写一份清晰的说明书和指南。太少了它不知道怎么干,太多了它被信息淹没。找到那个平衡点需要点手感,而手感来自多次实践。自己写的 Skill 最安全,也最贴合我们的需求。

今天的分享就到这里啦,如果大家觉得这些分享对你有帮助的话,欢迎点亮下方的 👍🏻 和 🌸 图标,因为这对阿真真的很重要。感谢感谢~

有什么想法或者自己做 Skill 遇到的问题,欢迎评论区一起聊聊实操经验~

下期见~

查看原文 → 發佈: 2026-03-21 16:56:00 收錄: 2026-03-21 22:00:38

🤖 問 AI

針對這篇文章提問,AI 會根據文章內容回答。按 Ctrl+Enter 送出。