WorkBuddy Skill完全指南：从安装到自定义的AI技能系统实战培训

AI技能系统实战培训WorkBuddySkill完全指南从安装到自定义的AI技能系统实战培训WorkBuddy实战蓝皮书·第5章深度解析课程目录01Skill是什么定义、结构与Prompt的本质区别02Skill的工作原理渐进式披露与三层加载机制03Skill的四大作用程序性知识、工作流、去重与资产化04找到和安装Skill技能市场、SkillHub与zip导入05使用Skill斜杠唤出、实战演示与执行流程06管理与开发Skill关闭卸载、SKILL.md编写与最佳实践共6章·39页·预计学习时长45分钟01Skill是什么为什么一个Markdown文件能让AI获得全新的专业能力？本章将回答：Skill的定义是什么？它的标准结构长什么样？它和普通Prompt有什么本质区别？Skill的定义与本质Skill是一种以Markdown文件为核心的AI能力封装单元。它通过标准化的目录结构和渐进式披露机制，将特定领域的专业知识、操作流程和工具调用打包成可复用、可安装、可管理的独立模块。核心本质：Skill不是更长的Prompt，而是一套按需加载的能力系统。三个关键特征标准化结构：统一的目录规范，SKILL.md为入口文件渐进式披露：按需加载内容，避免Token浪费可独立管理：支持安装、卸载、启用、禁用AI智能工具箱概念示意Skill的标准目录结构my-skill/├──SKILL.md

必需├──scripts/

可选│├──helper.py│└──process.sh├──references/

可选│├──api-docs.md│└──examples.md└──assets/

可选├──template.docx└──config.json各目录职责说明SKILL.md：技能入口文件，包含YAML元数据和核心指令，是唯一必需文件。scripts/：存放可执行脚本，Skill运行时可调用，用于复杂数据处理。references/：存放参考文档，按需加载，避免主文件过长。assets/：存放模板、配置等静态资源文件。SKILL.md的YAML元数据---name:article-polisherdescription:用于文章润色和去AI味，当用户需要修改文章风格时触发version:1.0.0author:workbuddy-teamtags:-writing-polish-ai-detection---#文章润色技能当用户需要润色文章时...关键字段解析name：技能唯一标识，简短且不含空格，用于安装和调用。description：最重要的字段，写清触发条件和用途，决定Skill何时被唤出。version/author：版本号和作者信息，便于技能管理和更新追踪。tags：分类标签，用于技能市场的搜索和筛选。Skill与Prompt的核心区别对比维度Skill普通Prompt加载方式渐进式披露，按需加载三层内容每次对话全量注入，无法分层可管理性支持安装、卸载、启用、禁用散落在各处，无法统一管理复用性一次安装，跨会话永久可用每次需要手动复制粘贴工具集成可调用scripts和外部工具仅文本指令，无法执行代码分发方式通过技能市场或zip包分享只能通过文本复制传播第一章小结Skill是以Markdown为核心的按需加载能力系统，不是更长的Prompt。支柱判断一标准目录结构以SKILL.md为唯一必需文件，scripts、references、assets三个目录按需扩展。支柱判断二YAML元数据中description是最关键字段，决定Skill的触发条件和唤出时机。支柱判断三Skill与Prompt在加载方式、可管理性、复用性、工具集成、分发方式五个维度存在本质差异。下一章预告深入理解Skill的工作原理：渐进式披露机制如何实现按需加载，三层加载的具体流程是什么。02Skill的工作原理为什么安装几十个Skill也不会让对话变慢？本章将回答：渐进式披露是什么？三层加载机制如何工作？Skill如何在不消耗Token的情况下待命？渐进式披露ProgressiveDisclosure渐进式披露是Skill系统的核心设计理念。它的基本思想是：不一次性加载所有内容，而是根据用户需求逐层深入。就像查字典时先看目录索引，找到相关条目后再阅读详细释义。三层披露策略第一层：仅加载name和description元数据，用于匹配触发第二层：匹配成功后加载SKILL.md正文，获取操作指令第三层：执行过程中按需读取references和scripts三层金字塔加载结构示意三层加载机制详解第一层：元数据匹配系统启动时仅读取每个Skill的name和description，消耗约50-100Token/技能。用户输入后，系统根据语义匹配判断是否触发该Skill。第二层：正文加载匹配成功后，系统加载该Skill的SKILL.md完整正文，包含操作流程、判断标准和注意事项。通常控制在5000Token以内，确保上下文高效。第三层：资源按需执行过程中，仅当SKILL.md中明确引用时，才读取references目录的参考文档或调用scripts目录的脚本，实现真正的按需加载。加载触发流程用户输入→系统遍历所有Skill的description→语义匹配命中→加载SKILL.md正文→执行指令→按需读取references/scripts→输出结果Token效率对比以安装20个Skill、每个Skill平均3000Token为例，对比两种加载策略的Token消耗差异。加载策略Skill渐进式全量Prompt注入节省比例日常对话（未触发）约2,000Token60,000Token约97%触发单个Skill约5,000Token60,000Token约92%触发并读取参考约10,000Token60,000Token约83%关键结论：即使在最复杂的场景下，Skill渐进式加载也比全量Prompt注入节省80%以上的Token，日常对话场景更是节省高达97%。Skill解决的核心问题在没有Skill的时代，AI能力扩展面临三个无法回避的矛盾。Skill系统正是为了解决这些矛盾而设计的。矛盾一能力丰富vs上下文有限希望AI懂编程、会写作、能分析数据，但上下文窗口有限，不可能把所有领域知识都塞进去。Skill解法：按需加载，用的时候才读。矛盾二操作复杂度vs易用性专业任务需要多步骤、多判断、多工具调用，但用户希望一句话就能完成，不想记复杂流程。Skill解法：流程封装在内部，用户只说需求。矛盾三经验复用vs知识沉淀好的Prompt和工作流散落在聊天记录里，换个会话就要重新写，团队之间也无法共享。Skill解法：标准化封装，一次创建永久复用。第二章小结渐进式披露通过三层加载机制，实现了能力丰富性与Token效率的完美平衡。支柱判断一三层加载从元数据匹配到正文加载再到资源按需，逐层深入，只有真正需要的内容才进入上下文。支柱判断二相比全量Prompt注入，Skill渐进式加载在日常对话中节省约97%Token，复杂场景也节省80%以上。支柱判断三Skill解决了能力丰富性与上下文有限、操作复杂度与易用性、经验复用与知识沉淀三大核心矛盾。下一章预告从原理走向价值：Skill的四大核心作用是什么？它如何在实际工作中提升效率和质量？03Skill的四大作用Skill到底能为你的工作带来什么具体价值？本章将逐一讲解Skill的四大核心作用：补充程序性知识、固定复杂工作流、减少重复Prompt、实现经验资产化。作用一：补充程序性知识大模型擅长陈述性知识（"是什么"），但在程序性知识（"怎么做"）上经常出错。Skill通过结构化的操作步骤、判断标准和注意事项，为AI补充了可靠的程序性知识，让它不仅知道概念，更能正确执行操作。没有Skill时的问题步骤顺序混乱，经常跳步或重复判断标准模糊，该检查的地方不检查注意事项遗漏，容易踩坑每次执行结果不一致，质量不稳定有Skill后的改善步骤严格按顺序执行，不跳不重每个判断点都有明确标准注意事项内嵌在对应步骤旁每次执行结果一致，质量可控作用二：固定复杂工作流很多专业任务不是单一操作，而是包含多个阶段、多个判断分支的复杂工作流。Skill可以把整个工作流固化下来，让AI像执行SOP一样稳定完成。典型工作流结构阶段一

需求理解阶段二

信息收集阶段三

分析处理阶段四

输出与校验Skill固化工作流的三个关键阶段划分：明确每个阶段的输入、输出和完成标准，阶段之间有清晰的交接点分支判断：在关键决策点写明判断条件和不同分支的处理方式，避免AI自行猜测质量校验：每个阶段结束前设置检查点，不满足标准则返回修正，确保最终输出质量作用三：减少重复Prompt你是否经常在不同会话中重复粘贴同一段长Prompt？Skill把这些常用Prompt封装成可安装的技能，一次安装，永久使用，再也不用复制粘贴。传统方式：复制粘贴1.在收藏夹里翻找Prompt2.复制几百字的长文本3.粘贴到新会话中4.手动调整参数和格式5.每次会话重复以上步骤问题：易遗漏、难同步、效率低Skill方式：一键唤出1.输入/唤出技能列表2.选择或输入技能名3.系统自动加载完整指令4.参数和格式已预设好5.所有会话自动可用优势：零遗漏、自动同步、效率高作用四：经验资产化资深员工的经验往往只存在于个人头脑中，人员流动就意味着知识流失。Skill把个人经验转化为可传承、可迭代、可度量的组织资产。经验资产化的四个层次第一层显性化把隐性经验写成SKILL.md，从"只可意会"变为"可以言传"第二层标准化统一结构和格式，确保不同人编写的Skill质量一致、可比较第三层可迭代通过版本管理和反馈机制，持续优化Skill，越用越好第四层可度量统计使用频率、效果反馈和效率提升，量化经验的价值Skill的两种类型根据设计目标的不同，Skill可以分为两种基本类型，理解它们的区别有助于你在创建Skill时做出正确的设计决策。偏好型SkillEncodedPreferenceSkill核心目标：固化个人或团队的偏好和习惯典型内容：写作风格、排版规范、命名约定、回复模板触发方式：全局生效，相关场景自动应用示例：公司邮件回复规范、技术文档写作风格能力型SkillCapabilityUpliftSkill核心目标：赋予AI新的专业能力典型内容：操作流程、判断标准、工具调用、领域知识触发方式：按需唤出，用户明确调用时生效示例：合同审查、代码重构、数据分析流程第三章小结Skill的四大作用从个人效率到组织资产，形成完整的价值闭环。支柱判断一补充程序性知识和固定复杂工作流，解决了AI"知道是什么但不知道怎么做"的核心缺陷。支柱判断二减少重复Prompt提升个人效率，经验资产化实现组织知识传承，从个人价值升维到组织价值。支柱判断三Skill分为偏好型和能力型两类，设计时应先明确主要目标，再围绕目标组织内容结构。下一章预告从理论走向实践：如何找到适合自己的Skill？技能市场、SkillHub和zip导入三种方式怎么选？04找到和安装Skill去哪里找高质量的Skill？三种安装方式怎么选？本章将讲解：WorkBuddy内置技能市场、第三方SkillHub平台、以及自定义zip包导入三种安装方式。WorkBuddy内置技能市场WorkBuddy内置了官方技能市场，这是最便捷的Skill获取渠道。所有上架技能都经过官方审核，质量有保障，安装过程一键完成，无需手动配置。进入技能市场的步骤第一步：打开WorkBuddy主界面第二步：点击左侧导航栏的「技能」图标第三步：在技能市场页面浏览或搜索目标技能第四步：点击技能卡片查看详情，确认功能描述第五步：点击「安装」按钮，等待安装完成技能市场插件商店概念示意搜索和筛选技能技能市场中的技能数量越来越多，掌握高效的搜索和筛选方法，能帮你快速找到真正需要的技能。搜索技巧关键词搜索：用功能关键词如"写作""代码""数据分析"搜索场景搜索：用使用场景如"周报""合同审查""PPT制作"搜索组合搜索：关键词+场景组合，如"写作去AI味"热门标签：点击页面上的热门标签快速筛选筛选维度分类筛选：按写作、编程、设计、办公等大类筛选评分筛选：优先选择4.5分以上的高评分技能安装量筛选：高安装量的技能通常经过更多用户验证更新时间：优先选择近期更新的技能，兼容性更好第三方SkillHub技能市场除了官方内置市场，社区还建立了第三方技能平台SkillHub（也称ClawHub），汇聚了大量社区开发者贡献的高质量技能，覆盖更多细分场景。SkillHub的优势技能数量更多，覆盖更细分的专业场景社区驱动，更新速度快，新功能响应及时可以查看技能源码，学习编写技巧支持开发者上传自己的技能，获得反馈很多技能提供详细的使用教程和示例使用注意事项第三方技能未经官方审核，注意安全性安装前阅读SKILL.md，确认无恶意代码优先选择高星、高下载量的成熟技能注意技能的版本兼容性，避免安装不兼容版本遇到问题可在社区评论区寻求帮助导入自定义zip技能包如果你有自己编写的Skill，或者从其他渠道获取了技能包，可以通过zip导入的方式安装到WorkBuddy中。导入步骤步骤一准备标准结构的技能文件夹步骤二将文件夹压缩为zip格式步骤三技能市场点击「导入」按钮步骤四选择zip完成安装注意事项：zip包的根目录必须直接包含SKILL.md文件，不能多套一层文件夹；压缩时建议使用标准zip格式，避免使用7z、rar等其他格式；导入前确保SKILL.md的YAML元数据格式正确，name字段不与已有技能冲突。第四章小结三种安装方式各有适用场景，覆盖从新手到进阶的全部需求。支柱判断一官方内置市场最安全便捷，适合新手；第三方SkillHub覆盖更细分场景，适合有一定经验的用户。支柱判断二搜索和筛选技能时，优先选择高评分、高安装量、近期更新的技能，安装前务必阅读详细描述。支柱判断三zip导入是安装自定义技能的核心方式，注意根目录结构、压缩格式和name字段唯一性三个要点。下一章预告安装好Skill之后怎么用？斜杠唤出、实战演示和执行流程，第五章带你真正用起来。05使用Skill安装好的Skill怎么用？从唤出到执行的完整流程是什么？本章将讲解：斜杠唤出方式、实战演示文章去AI味、以及Skill从触发到输出的完整执行流程。调用方式：斜杠唤出WorkBuddy提供了两种Skill调用方式：手动斜杠唤出和自动语义触发。掌握这两种方式，能让你在不同场景下高效使用Skill。方式一：手动斜杠唤出操作方法：在输入框中输入/，系统会弹出已安装的Skill列表选择方式：上下键选择或继续输入技能名筛选，回车确认适用场景：明确知道要用哪个Skill，需要精确控制优势：确定性高，不会误触发，适合复杂任务方式二：自动语义触发触发机制：系统根据用户输入的语义，自动匹配description相关的Skill确认方式：系统提示是否使用该Skill，用户确认后执行适用场景：不确定用哪个Skill，或日常高频任务优势：无需记忆技能名，降低使用门槛实战演示：文章去AI味以"文章去AI味"Skill为例，完整演示从唤出到输出的使用过程。第一步唤出：输入/article-polisher或输入"帮我去掉这篇文章的AI味"，系统自动匹配并提示使用该Skill第二步输入：粘贴需要处理的文章内容，Skill会提示选择处理强度（轻度/中度/深度）和目标风格（自然/专业/口语化）第三步执行：Skill按预设流程执行：AI特征检测→句式多样化→词汇替换→语气调整→逻辑连贯性检查第四步输出：返回修改后的文章，附带修改说明（哪些地方做了调整、为什么这样改），用户可选择接受全部或逐条确认关键差异：普通Prompt只做一次改写，Skill按多步骤流程执行，每步有明确标准，输出质量更稳定可控05使用Skill安装好的Skill怎么用？从唤出到执行的完整流程是什么？本章将讲解：斜杠唤出方式、实战演示文章去AI味、以及Skill从触发到输出的完整执行流程。调用方式：斜杠唤出WorkBuddy提供了两种Skill调用方式：手动斜杠唤出和自动语义触发。掌握这两种方式，能让你在不同场景下高效使用Skill。方式一：手动斜杠唤出操作方法：在输入框中输入/，系统会弹出已安装的Skill列表选择方式：上下键选择或继续输入技能名筛选，回车确认适用场景：明确知道要用哪个Skill，需要精确控制优势：确定性高，不会误触发，适合复杂任务方式二：自动语义触发触发机制：系统根据用户输入的语义，自动匹配description相关的Skill确认方式：系统提示是否使用该Skill，用户确认后执行适用场景：不确定用哪个Skill，或日常高频任务优势：无需记忆技能名，降低使用门槛实战演示：文章去AI味以"文章去AI味"Skill为例，完整演示从唤出到输出的使用过程。第一步唤出：输入/article-polisher或输入"帮我去掉这篇文章的AI味"，系统自动匹配并提示使用该Skill第二步输入：粘贴需要处理的文章内容，Skill会提示选择处理强度（轻度/中度/深度）和目标风格（自然/专业/口语化）第三步执行：Skill按预设流程执行：AI特征检测→句式多样化→词汇替换→语气调整→逻辑连贯性检查第四步输出：返回修改后的文章，附带修改说明（哪些地方做了调整、为什么这样改），用户可选择接受全部或逐条确认关键差异：普通Prompt只做一次改写，Skill按多步骤流程执行，每步有明确标准，输出质量更稳定可控Skill执行流程全解析理解Skill从触发到输出的完整执行流程，有助于排查问题和优化使用体验。阶段一触发匹配

语义识别

技能选择阶段二内容加载

读取正文

解析指令阶段三参数收集

确认需求

补充输入阶段四执行任务

按流程操作

调用工具阶段五输出结果

质量校验各阶段关键细节触发匹配：系统遍历所有已启用Skill的description，用语义相似度判断是否匹配，相似度超过阈值则提示用户内容加载：匹配成功后加载SKILL.md正文，解析其中的操作流程、判断标准和注意事项，执行中按需读取references参数收集：如果Skill需要额外参数（如处理强度、输出格式），系统会主动询问用户，确保输入完整后再执行第五章小结Skill使用从唤出到输出有完整五阶段流程，两种方式覆盖不同场景。支柱判断一手动斜杠唤出确定性高适合复杂任务，自动语义触发降低门槛适合日常高频场景，两种方式灵活搭配。支柱判断二实战案例表明，Skill按多步骤流程执行比普通Prompt单次改写质量更稳定，每步有明确标准和校验。支柱判断三完整执行流程分为触发匹配、内容加载、参数收集、执行任务、输出结果五个阶段，理解流程有助排查问题。下一章预告从使用走向创造：如何管理已安装的Skill？怎样编写自己的SKILL.md？有哪些最佳实践？06管理与开发Skill如何管理已安装的Skill？怎样编写属于自己的技能？本章将讲解：Skill的关闭卸载和编辑、SKILL.md的编写方法、以及编写高质量Skill的最佳实践。Skill的管理：关闭、卸载与编辑随着安装的Skill越来越多，有效的管理能保持WorkBuddy的整洁和高效。操作说明适用场景注意事项关闭暂时禁用技能，不删除文件，可随时重新启用暂时不用但以后可能需要关闭后不参与语义匹配卸载完全删除技能文件，释放空间，不可恢复确认不再需要该技能卸载前建议备份配置编辑修改SKILL.md内容，调整指令流程和参数优化技能效果或修复问题编辑后需重新加载生效更新检查并安装技能的最新版本，获取新功能技能有新版本可用时更新前查看更新日志管理入口：WorkBuddy左侧导航栏「技能」→「已安装」标签页，每个技能卡片右侧有操作菜单如何编写SKILL.md编写一个高质量的SKILL.md是创建Skill的核心。文件分为YAML元数据和Markdown正文两部分，各有明确的编写规范。编写步骤第一步：确定技能名称，简短唯一，用小写字母和连字符第二步：编写description，写清触发条件、用途和适用场景第三步：编写正文，用指令式语言描述操作流程和判断标准第四步：长文档放入references/，在正文中按需引用第五步：测试验证，在WorkBuddy中安装并测试触发和执行效果代码编辑器自定义开发概念示意编写Skill的最佳实践应该做的单一职责：一个Skill只做一件事，做好一件事指令式语言：用"做什么"而不是"是什么"的表述明确判断标准：每个决策点都有可执行的判断依据渐进式组织：核心指令在前，参考文档在后按需加载