
AI 领域绕不开的一个核心概念就是 Skill。它并不是一阵风就会过去的噱头,而是一种能够长期沉淀下来的能力——通俗地说,Skill 就是把我们的工作流程和实战经验结构化、文本化,沉淀为 AI 可复用的标准动作。
和 AI 协作时,最让人头疼的往往是两个问题:
Skill 正是为了解决这两个问题而生的。
用一句话来区分:Prompt 用来表达当下的单次需求,Skill 则适合保存反复使用的方法。
Skill 并不是一句临时的提示词,而是一套包含步骤、决策逻辑以及特定环境适配的完整工作流——明确做什么、按什么顺序做,以及做完如何验收。
在工程与使用层面,Skill 还有两个非常关键的价值:
从内容形态来看,Skill 大致可以分为三类:
Tips:使用 ASD STE100的方式解释/描述 xxx
Skill 的主体可以拆解为步骤(Steps)与参考资料(Reference)两块,具体分为三层:
SKILL.md 中的 Steps(最上层):说明 Agent 要做什么、按什么顺序做,每个 Step 都有一个可判定的完成标准。SKILL.md 中的 Reference(次要层):存放随时需要查阅的定义与规则,很多时候它们是一组平级的同级规则。GLOSSARY.md),也可以是 Skill 系统之外、任何 Skill 都能引用的通用文件。编写结构化 Skill 时,可以参考以下六段式模板:
“一件事做三次以上,就值得变成一个 Skill。”
生成 Skill 主要有两条路径,但底层动作是一致的:先手动完整跑通一次任务,再让 AI 把它固化成 Skill。
迭代提醒:Skill 的初版很少完美,因为它往往“过度拟合”了那一次特定会话——这很正常。下次用的时候再修,而且**修正尽量在会话内完成,不要直接打开硬改
SKILL.md**。
description 中的描述自动匹配加载。description 里只需写明“在什么条件下会触发”即可,但自动触发存在一定概率不命中的情况。/skill-name)显式调用,触发更可靠,代价是需要记住对应的 Skill 名称。除了自己沉淀,也可以直接安装社区或官方提供的 Skill:
npx skills add 安装:例如安装 kepano/obsidian-skills(包含五个技能文件,帮助 Claude Code 掌握完整的 Obsidian 格式规范)。git clone 放入 .claude/skills/**:拉取仓库到对应技能目录即可使用。.claude/skills/**:例如微信读书 Skill[https://cdn.weread.qq.com/skills/weread-skills.zip]。playwright-cli 提供的技能安装方式:playwright-cli install --skills
执行后会直接安装到当前项目的 .claude/skills/playwright-cli。如果要适配 Codex,只需把 .claude 改为 .codex,随后在 Codex 命令行中输入 /skill 即可验证。
全局通用配置通常位于 ~/.claude/ 下,大致结构如下:
~/.claude/
├── CLAUDE.md ← 由你编写的全局规则
├── settings.json ← 由你配置
├── settings.local.json ← 个人覆盖配置,已加入 gitignore
├── skills/ ← 由你构建的全局技能
├── agents/ ← 由你构建的全局智能体
└── projects/ ← Claude 的内部记录目录,不属于你的配置
├── -Users-mariaweaver/
│ └── memory/ ← 从 ~/ 启动的会话所使用的记忆目录
└── -Users-mariaweaver-projects/
└── memory/ ← 已失效的目录
项目级目录下也会有类似的 .claude/skills/ 与 .claude/agents/,仅在当前项目中启用;而不依赖具体项目、跨场景通用的技能(如写作、规划),更适合放在全局通用目录中。
此外,还可以在 ~/.claude/guides 目录下维护评估指南、BI 展示风格等 .md 规范文件,方便随时复用。
如果还不确定从哪里开始,可以用这两种简单方式起步:
先打磨好一个高频单点任务,再逐步把多个 Skill 串成工作流(例如:课程设计 → 教材编写 → 简报制作)。下面看三个典型场景的示例:
每次课程主题不同,但前期沟通与输出结构往往高度一致,适合做成固定流程的 Skill。
示例提示词 请制作“课程设计小帮手”Skill。先询问课程主题、课程说明、使用软件、学习成果与受众,再输出课程名称建议、100 字内课程简述和学习目标。先显示文字,等我确认后,再制作排版好的 Word。请交付
SKILL.md和 ZIP 压缩包。
如果偏爱某种版式或视觉风格,可以直接提供参考图,让 AI 提炼版型、配色和字体规则。
示例提示词 请依据四张参考图制作简报风格 Skill:第一张为封面,第二张为单元页,第三、四张为内页。保留白底、黑色手写感标题、深青绿强调和大留白。标题固定 50pt,正文 20pt,内容过多时拆页,不缩小字号。请附参考图,打包成 ZIP。
SKILL.md 和四张参考图的压缩包,通过格式校验后,后续直接用 /skill 名称即可复用一致的设计风格。当希望 AI 严格依据制度或法规回答时,需要把参考资料和引用格式写进 Skill。
示例提示词 请依据我提供的法规 PDF,制作“劳工请假规则查询”Skill。回答时先引用条文,注明法规名称、条号和 PDF 页码,再用白话解释。资料未涵盖的内容,要明确说明。请将
SKILL.md与参考 PDF 一起打包成 ZIP。
除了通用工作流,日常软件开发中的常见动作也可以拆解成清晰的步骤与提示词(同样适合进一步沉淀为团队或个人的标准流程与 Skill):
我要做一个任务管理应用,功能包括:
- 用户注册和登录
- 创建、编辑、删除任务
- 任务分类和标签
- 任务提醒
请帮我:
- 推荐合适的技术栈
- 设计项目目录结构
- 规划数据库表结构
按照刚才的规划,帮我:
- 创建项目目录结构
- 初始化配置文件(
package.json、.env等)
现在实现用户注册功能,要求:
- 邮箱和密码注册
- 密码加密存储
- 邮箱验证
注意:
- 文字要简洁清晰
- 要 AI 做的事情尽量控制在 3 个以内
步骤 1:确定重构目标(自己完成)
要解决什么问题?(代码重复、结构混乱、性能问题?)
重构的范围有多大?
能接受的风险程度?
步骤 2:制定重构计划(和 AI 一起)
这三个函数(
getUserList、getArticleList、getCommentList)有很多重复代码,都是做分页、排序、筛选。 请帮我:
- 分析重复的部分
- 提出重构方案
- 评估重构的风险
步骤 3:准备安全网(让 AI 帮你)
在重构之前,先帮我写测试用例,确保重构后功能不变。
步骤 4:逐步重构(AI 执行,自己验证)
步骤 5:验证结果(自己完成)
步骤 1:收集信息(自己完成)
错误信息是什么?
如何复现这个问题?
什么时候开始出现的?
影响范围有多大?
步骤 2:定位问题(让 AI 帮你)
用户反馈:点击“提交订单”按钮后,页面卡住不动 浏览器控制台报错:
TypeError: Cannot read property 'id' of undefined错误发生在checkout.js第 45 行 请帮我:
- 分析可能的原因
- 找到相关的代码
- 检查数据流向
步骤 3:分析根因(和 AI 一起)
看看这个 user 对象是从哪里来的,检查在什么情况下 user 会是 undefined。
步骤 4:实施修复(AI 生成,自己审查)
添加防御性代码,检查 user 是否存在;
如果 user 不存在,跳转到登录页;
添加友好的错误提示。
步骤 5:验证修复(自己完成)
按原步骤复现,确认问题解决;
测试相关功能,确保没有引入新问题;
思考是否有其他地方存在类似问题。
步骤 1:理解需求(自己完成)
要实现什么功能?
输入和输出是什么?
有哪些边界条件和异常情况?
性能和安全要求是什么?
步骤 2:了解现有代码(让 AI 帮你)
我需要实现用户评论功能,请帮我:
- 看看项目中有没有类似的功能
- 找到用户数据和文章数据的存储方式
- 了解项目的数据库操作规范
基于刚才的分析,实现评论功能需要:
- 创建评论数据模型
- 实现评论的增删改查 API
- 在前端添加评论展示和发表功能
请帮我确认这个计划是否合理,有没有遗漏的地方。
按照计划,先实现评论数据模型,要求:
- 包含评论内容、作者、文章 ID、创建时间
- 支持评论的嵌套回复
- 添加必要的索引
步骤 1:快速了解改动(让 AI 帮你)
总结这次 PR 做了什么改动,主要修改了哪些文件。
步骤 2:检查常见问题(让 AI 帮你)
检查这次改动:
- 有没有安全问题(SQL 注入、XSS 等)
- 有没有性能问题(N+1 查询、内存泄漏等)
- 有没有明显的 Bug
- 代码风格是否符合项目规范
步骤 3:深入审查(自己完成)
业务逻辑是否正确;
是否考虑了边界情况;
是否有更好的实现方式;
是否需要添加测试。
步骤 4:给出反馈(自己完成)
指出需要修改的地方,解释修改原因,并提供改进建议。
真正值得保存的,是那些你每次都会重复交代、反复修正的要求。把它们整理成清晰的工作流和 Skill,下一次就能直接接着用。