【skill封装】

从 0 开始搭建个人专属 AI 工作流把 Prompt 封装成 Skill【系列第 3 篇】一、为什么第 3 篇要讲 Skill上一篇我们讲了 Prompt 模板角色 目标 背景 约束 输出格式它能让一次 AI 输出更稳定。但当你开始反复做同一类任务时会遇到新问题每次都要复制一大段 Prompt规则越写越长容易漏示例、参考规范、脚本不好塞进对话换一个项目或设备又要重新整理。这时就需要 Skill。你可以把 Skill 理解成把一套可复用的 AI 工作方法封装成一个文件夹让 AI 在需要时自动加载并执行。Prompt 更像“临时说明书”Skill 更像“安装好的专业插件”。二、权威资料怎么说 SkillAnthropic 官方在 Agent Skills 相关资料中把 Skill 描述为一种可复用能力包它通常是一个目录里面包含核心说明文件SKILL.md也可以包含参考资料、示例、脚本和资源文件。官方资料里有几个关键词很重要SKILL.md是入口用 YAML frontmatter 描述 Skill 的名称和触发场景再用 Markdown 写具体步骤。渐进式披露Progressive Disclosure不要把所有内容都塞进主说明里核心规则放在SKILL.md细节放到references/、examples/、scripts/等文件需要时再读。适合重复流程Skill 不是为一次性聊天准备的而是为稳定、重复、可复用的任务准备的。可以包含代码高级 Skill 可以带脚本例如检查文件、生成图像、转换格式等。这说明 Skill 的本质不是“更长的 Prompt”而是Prompt 规范 示例 工具脚本 文件结构 的组合封装。三、Skill 和 Prompt 的区别先用一张表讲清楚对比项PromptSkill使用方式每次手动输入放在固定目录自动或手动触发载体一段文字一个文件夹适合场景临时任务重复任务、复杂流程可包含内容主要是指令指令、示例、参考资料、脚本、素材可维护性容易散落在聊天记录里可以版本化、复制、共享本质一次请求可复用能力模块一句话总结Prompt 解决“这次怎么问”Skill 解决“以后这类任务都怎么做”。所以当你的 Prompt 已经稳定并且会反复使用就可以考虑封装成 Skill。四、一个 Skill 的基本目录结构以 Claude Code / Claude Agent Skills 的通用结构为例一个最小 Skill 可以这样放.claude/skills/draw-tech-diagram/ └── SKILL.md更完整一点可以这样.claude/skills/draw-tech-diagram/ ├── SKILL.md ├── references/ │ └── style-guide.md ├── examples/ │ └── workflow-diagram-example.svg └── scripts/ └── validate-svg.py各部分作用如下SKILL.md入口文件告诉 AI 这个 Skill 是什么、什么时候用、怎么做references/放设计规范、颜色规范、尺寸规范examples/放好图示例让 AI 学习风格scripts/放可执行脚本比如检查 SVG 是否有尺寸、文字是否溢出。如果只是入门先写一个SKILL.md就够了。五、实战封装一个“绘图 Skill”假设你经常要给技术博客画封面图、流程图或架构图。每次都告诉 AI蓝紫色科技风、16:9、干净、适合 CSDN、要有标题……很麻烦。我们可以把它封装成一个绘图 Skill。第 1 步创建目录在项目里创建.claude/skills/draw-tech-diagram/如果是个人全局使用也可以放在类似~/.claude/skills/draw-tech-diagram/项目级 Skill 适合当前项目个人级 Skill 适合所有项目复用。第 2 步编写SKILL.md新建文件.claude/skills/draw-tech-diagram/SKILL.md内容可以这样写--- name: draw-tech-diagram description: 当用户需要为什么什么文章、教程或演示文稿生成科技风 SVG 封面图、流程图、架构图时使用。 --- # Draw Tech Diagram Skill ## 目标 根据用户给出的主题生成适合技术博客使用的 SVG 图像。 ## 默认风格 - 比例16:9 - 尺寸1600 x 900 - 风格简洁、现代、科技感 - 主色蓝色、紫色、青色 - 背景深色渐变或轻微网格 - 字体优先使用 Microsoft YaHei、PingFang SC、Arial ## 工作步骤 1. 先提取用户需求中的主题、核心文字、画面元素、比例、风格。 2. 如果用户没有指定比例默认使用 16:9。 3. 生成完整 SVG不依赖外部图片。 4. 保证文字清晰层级明确适合博客封面。 5. 输出时给出文件名建议和 Markdown 引用方式。 ## 输出要求 - 直接生成可保存的 .svg 内容 - 不要只描述画面 - 不要使用无法加载的外部字体或外部图片 - 如果用户要求中文标题必须直接写入 SVG 文本中。这就是一个最小可用 Skill。第 3 步使用这个 Skill以后你不需要再写一长段绘图 Prompt只要说请用 draw-tech-diagram skill帮我生成一张主题为“Prompt 工程”的博客封面图。 文字如何写出稳定可复用的 Prompt 模板。 风格蓝紫色科技风。AI 就会按照 Skill 里的规则执行。如果它支持自动识别当你说“生成一张技术博客封面图”时也可能根据description自动加载这个 Skill。这里有一个关键点description不是给人看的简介而是给 AI 判断“什么时候该用这个 Skill”的触发条件。所以不要写得太空泛。不推荐description:一个绘图 Skill推荐description:当用户需要为技术博客、AI 工作流文章、教程或演示文稿生成科技风 SVG 封面图、流程图、架构图时使用。六、什么时候该把 Prompt 升级成 Skill可以用这个判断标准如果一个 Prompt 被你重复使用 3 次以上并且每次都要补充同样的规则就值得封装成 Skill。尤其适合这些场景固定风格绘图固定格式生成文档固定代码检查流程固定数据分析流程固定发布前检查清单固定项目规范说明。但如果只是一次性问题比如“今天北京天气怎么样”就没必要做成 Skill。七、写 Skill 的 4 条建议1.SKILL.md不要太长核心规则放进去即可细节放到references/。2. 先写步骤再写风格AI 最需要知道“怎么做”其次才是“做成什么风格”。3. 示例比抽象描述更有用如果你有满意的 SVG、流程图、配色方案可以放进examples/。4. 能脚本化的检查就脚本化比如绘图 Skill 可以写一个脚本检查SVG 是否有width和height是否包含标题文字是否使用外部图片文件是否能正常打开。这会让 Skill 从“提示词”进一步变成“可执行工作流”。八、总结这一篇我们讲清楚了 Skill 的核心Prompt 是一次性指令Skill 是可复用能力包Skill 通常由SKILL.md和可选的参考资料、示例、脚本组成description决定 AI 什么时候自动使用它好 Skill 要遵循渐进式披露主文件简洁细节拆出去当一个 Prompt 重复使用多次就应该考虑封装成 Skill。到这里个人 AI 工作流已经有了第三块拼图第 1 篇理解 AI 工作流 第 2 篇写出可复用 Prompt 模板 第 3 篇把高频 Prompt 封装成 Skill下一步你就可以继续把 Skill 和工具、脚本、文件系统结合起来让 AI 不只是“会回答”而是开始具备稳定执行某类任务的能力。参考资料Anthropic Engineering BlogEquipping agents for the real world with Agent SkillsClaude BlogIntroducing Agent SkillsClaude Platform DocsAgent Skills overviewClaude Platform DocsSkill authoring best practicesClaude Help CenterHow to create custom skillsAnthropic GitHubanthropics/skills