从零开始写Skill保姆级教程与实战案例

一、快速概览全文

上次我们开源了一份凝聚十年设计经验的PPT技能库，收到的反馈远超预期——短短数周内，GitHub上的Star数就突破了6000。这份热情背后，折射出大家对高效、结构化工作流的普遍渴望。今天，我们来深入探讨如何构建一个真正“听话”、能够稳定输出的AI Skill。其中的门道，远不止写几行简单指令那么简单。

二、如何高效地构建一个Skill

开门见山地说，从零开始手动编写一个Skill，费时费力且门槛不低，并非最佳路径。更高效的策略是：借助AI的能力快速搭建框架，然后把主要精力集中在核心调优环节。

具体该怎么做？你可以在Trae、Claude Code这类AI编程工具中直接输入指令：“我需要你帮我创建一个Skill…”。只要指令清晰完整，AI就能为你生成一个可用的初始版本，省去大量基础编码时间。

那么，一份能够有效“指挥”AI的指令，至少应该包含哪些要素呢？

• 明确AI身份：让AI以什么角色来工作？是设计专家、产品专家，还是代码架构师？
• 定义Skill用途：这个Skill在什么场景下被调用？具体实现什么功能？
• 规定Skill内容：输出成果应包含哪些层级？需要引用哪些外部规范？
• 设定交付要求：输出格式有何约束？注释、排版等细节如何规范？
• 列出禁用规则：哪些事情是AI绝对不能做的？提前划清边界。

光说理论有些抽象，来看一个真实案例。假设我想把Figma里的业务组件库打包成一个Skill，以便在设计转代码时快速调用，给Claude Code的指令可以这样写：

你现在是一位资深的 Figma 设计系统及组件库专家，帮我编写一份可用于 AI Agent 设计工作流的 Figma 组件库专用 Skill，要求如下：
1. Skill 用途：当我提到做 XXX 业务设计时，能够自动调用这个 Skill，用于一键生成使用 Figma 业务组件库（业务组件库文档链接）搭建的产品页面，保持页面的基本可用性和统一性。
2. 产出规范：
- 先给出 Skill 整体能力说明，再给出关键组件的使用规范说明；
- 组件嵌套合理，颜色、文字、阴影等样式全部绑定样式变量；
- 每条规则清晰、可执行、可被 AI 直接理解并落地到设计稿。
3. 交付要求：
- 用结构化的格式输出，分章节、条款清晰；
- 关键的规则加粗标注，便于阅读；
- 补充 Skill 的使用说明、注意事项和后续迭代扩展方向。
4. 禁止事项：
- 不要自行设计或增加无关的业务组件；
- 不要擅自修改基础变量的数值。

把这样一份指令发送过去，一个Skill的雏形就诞生了。如果你更有耐心，不妨在指令末尾加上一句：“如果有不明确的内容，你还可以再问我”。这样一来，AI可能会反问你一些你未曾考虑到的边界问题，这恰恰是帮你查漏补缺、完善需求的绝佳机会。

初版生成后，先别急着投入使用。不妨让其他AI工具（比如豆包或Gemini）充当“质检员”，把Skill的Markdown内容扔过去，让它们帮忙查找语法错误、逻辑漏洞，做一次初步的交叉验证。

当然，以上所有步骤都只是“从无到有”的基础操作。要想让一个Skill真正落地、稳定可靠，后期的质量检验和人工调优才是重头戏，这一步目前AI还无法完全代劳，必须由人来主导。

三、人工调优：让Skill从“能用”进化到“好用”

打磨一个Skill，就像雕琢一件工具，需要从多个维度入手。以下是三个经过实践验证的核心优化方向。

1. 明确使用场景与触发条件

这是Skill能否被正确激活的根基。在动手之前，必须想清楚：谁会用？在什么场景下用？用户会输入什么样的指令？

关键在于，你对Skill用途的描述必须清晰回答一个问题：什么情况下，AI应该自动使用这个Skill？

举个例子：

• 模糊的写法：实现Figma设计稿转代码的技能。
• 清晰的写法：当用户需要将Figma设计稿进行高质量前端代码转换时触发。

只有把触发条件写得像“钥匙孔”一样精准，AI这把“钥匙”才能准确插入，避免该工作时沉默、不该工作时乱动的尴尬局面。

2. 吃透Skill的结构与原理

一个Skill不是一个孤立的文件，而是一个结构清晰的文件夹。通常包含以下四个部分：

Skill.md：核心“大脑”

这是整个Skill的CPU，负责意图识别和指令分发，里面定义了触发条件、角色设定和核心工作流。它采用Markdown格式，你可以把它理解为一种“机器友好型议论文”——将散乱的自然语言，转化为结构严谨、机器能精准理解的任务书。如果担心输出跑偏，就在这里补充更精确的描述。

References：规范“错题本”

这里是约束AI输出的强规则区，存放着设计原则、命名规范、格式要求等。它的核心价值在于记录“易错点”。把AI曾经犯过的错误、需要注意的细节不断整理补充进来，Skill就会像学生复习错题本一样，越来越“懂事”，输出质量自然水涨船高。很多官方优质Skill，都是这样一点点迭代出来的。

Assets：按需调用的“物料库”

这里存放着图片、模板、配置文件等固定资源。其核心逻辑是“渐进式披露”：不必把所有内容都堆在主文件里造成干扰。把详细的API文档放在references/api.md或assets/目录下，然后在主文件里告诉AI“需要时去那里查找”。这样既能提高AI处理的准确性，也能节省上下文资源。

Scripts：自动化“小助手”

这里可以编写自动化脚本，让Skill自主处理一些确定性高的重复任务，比如格式检查、版本同步、文件批量处理等。这能极大减少人工干预，让Skill更加智能。

只有理解了每个部分该放什么、不该放什么，你才能像架构师一样，牢牢锁住AI的行为框架，让它严格按照你的蓝图执行。

3. 合理拆解任务与施加约束

AI不是人，既不能完全放任，也不宜过度束缚。调优的精髓在于：将你的思考链路，拆解成AI能严格遵循的步骤，并在关键节点设置好路标和护栏。分享三个实用技巧：

写法清晰：建立执行顺序

用清晰的1、2、3序号为AI编排线性步骤。例如：

1. 寻找参考：先去XX文档读取标准设计Token。
2. 进行决策：遇到A情况用卡片布局，遇到B情况用列表布局。
3. 输出内容：最后按照XX骨架生成最终代码。

有效描述：聚焦未知规则

不要浪费篇幅去教AI它已经知道的东西（比如什么是Vue/React）。相反，要重点描述那些它默认机制里没有的、属于你业务特有的非客观规则。例如：“品牌色禁止使用纯黑色”、“按钮禁用状态下必须添加特定透明度”。

异常阻断：预设风险兜底

在工作流中嵌入风险控制逻辑。例如，可以明确要求：“如果用户需求在现有组件库中找不到对应模式，必须停止生成并向用户提问

说到底，构建一个优秀的Skill从来不是“一锤子买卖”，也无法完全依赖AI生成。我们可以借助AI快速完成从0到1的搭建，但核心的场景定义、结构设计、规则沉淀和持续迭代，必须由人牢牢把控。只有将清晰的逻辑、合理的结构与持续的优化相结合，才能打造出真正贴合你工作流、稳定又高效的得力助手。