ARTICLE · 1063189
WorkBuddy 技能清单与使用·卸载手册
WorkBuddy 技能清单与使用·卸载手册
扫描范围：本机 WorkBuddy 技能目录
扫描时间：2026-09-21
本手册所列技能全部来自对本机目录的实际扫描，非推测。
本手册盘点当前机器上 WorkBuddy 可用的全部技能（Skill），说明每个技能的作用、如何调用、以及如何卸载。数据来自对本机技能目录的实际扫描，扫描时间 2026-09-21。
一、总览
技能按来源分三层：用户自建、应用内置、插件携带。三层在数量、装载位置和管理权限上完全不同——只有第一层是你自己的资产。
1.1 三层来源与数量
来源 | 数量 | 装载位置 | 可否手动增删 |
自建技能（用户级） | 54个 | C:\Users\yl\.workbuddy\skills\ | 可以，这是你自己的资产 |
应用内置技能 | 26个 | WorkBuddy安装目录...\app.asar.unpacked\resources\plugins\workbuddy-builtin\skills\ | 不可，随应用更新 |
插件 / 市场技能 | 79个（去重后） | C:\Users\yl\.workbuddy\plugins\cache\ | 不可单独删，随插件装卸 |
三层合计约 159 个技能条目。真正属于你个人资产、需要管理的是第一层 54 个自建技能，本手册第三章逐个列出；内置与插件两层由应用和插件系统托管，本章第四、五章作索引说明。
1.2 自建技能的功能分布
功能板块 | 数量 |
坐标系与投影 | 2 |
数据质检与几何处理 | 6 |
属性与字段处理 | 2 |
数据转换与导出 | 3 |
制图、符号化与布局 | 5 |
工具箱与二次开发 | 6 |
环境运维与资产盘点 | 3 |
外部数据与在线底图 | 5 |
知识与智能助手 | 4 |
文档与办公产出 | 9 |
系统与开发工具 | 3 |
媒体生成 | 4 |
业务专项 | 2 |
合计 | 54 |
二、技能的使用方式
技能有四种调用方式。日常用自动触发即可；一旦发现模型挑错了技能，改点名最省事。
2.1 四种调用方式
方式 | 怎么用 | 适用场景 | 例子 |
自动触发 | 直接描述任务，不提技能名 | 日常最常用。模型读技能的description ，命中触发词就自动加载 | 「帮我检查这个图层的拓扑错误」 |
显式点名 | 在指令里写出技能名 | 同类技能有多个、怕模型挑错时用 | 「用arcgis-topology帮我做拓扑检查」 |
斜杠命令 | 输入 /技能名 | 仅对声明了「仅命令触发」的技能有效 | /kcdj-workflow |
先查后装 | 让WorkBuddy去找技能 | 手上没有合适技能，需要新能力 | 「有没有适合处理XX的技能？」 |
建议：日常用自动触发；一旦发现模型挑错了技能（例如你明明想用 crs-selector，它却调了 arcgis-coordinate-system-lecture），就改成显式点名，并在后续对话里保持点名习惯。
2.2 技能管理页的五个操作
入口：WorkBuddy 左侧「技能」菜单。页面分上下两区——上区是技能市场（推荐技能，一键安装），下区是已安装（本地技能，可直接在对话中调用）。
操作 | 位置 | 说明 |
添加技能 | 页面内「添加技能」按钮 | 三个子项： 上传技能 （导入本地技能包）、 查找技能 （描述任务，自动查找）、 创建技能 （描述任务，自动创建） |
启用 / 关闭 | 已安装列表内开关 | 关闭后技能不再在对话中被调用。 偶尔用一次、又不想卸的，用关闭而不是卸载 |
搜索技能 | 页面顶部搜索框 | 技能多了以后按关键词定位 |
卸载技能 | 选中技能→卸载 | 从本机彻底移除， 支持勾选多选批量卸载 |
更新 / 回滚 | 已安装列表内 | 有新版会提示；支持版本更新与回滚。更新前先看更新日志 |
上传技能的文件要求：上传文件夹或 .zip，其中必须包含 SKILL.md，且该文件头部需有 YAML 格式的 name 与 description。缺 SKILL.md 或缺这两个字段，导入后不会被正确识别。
2.3 触发控制字段
技能是否允许被模型自动调用，由 SKILL.md frontmatter 里的字段决定：
字段 | 取值 | 效果 |
disable-model-invocation | true | 禁止模型自动调用，只能手动点名或用斜杠命令 |
disable-model-invocation | false | 允许自动调用（默认） |
name | 技能标识 | 必填 。缺了技能不会被识别，也不出现在列表里 |
description | 用途+触发词 | 必填 。模型据此判断要不要加载，写得好坏直接决定命中率 |
agent_created | true | 标记为AI创建，可用于区分自建资产 |
kcdj-workflow 没有用 disable-model-invocation 字段，而是在 description 里写明「仅命令触发，不要自动触发」，靠这一句约束触发行为。这也是一种可行写法，但不如字段硬约束可靠。
2.4 技能冲突的处理
技能装多了会让模型在「该用哪个」上判断混乱，甚至互相抢占。处理三步：
1.识别冲突：模型调错技能，或产出不符合预期，先怀疑有多个技能功能重叠。
2.明确指定：在指令中点名——「用 XX 技能帮我做 YY」，杜绝模型猜测。
3.精简列表：同类技能只留一个。例如 PDF 类留一个顺手的，其余卸掉。
三、自建技能清单（54 个）
以下 54 个技能是你自己的资产，按功能板块分为 13 组。编号对应右上角技能管理页「已安装」区里的实际条目。
3.1 坐标系与投影（2 个）
技能名 | 用途 |
crs-selector | 坐标系全面知识库。按坐标数值判断该用哪个坐标系；涵盖投影方法比较（兰伯特 / 高斯 - 克吕格 / 温克尔三重 /Mercator ）、高斯分带（ 3度带 /6度带 / 带号 / 中央经线 /WKID ）、自定义坐标系、动态投影、椭球体转换（ WGS84/ 北京 54/ 西安 80/CGCS2000 ） |
arcgis-coordinate-system-lecture | 坐标系全体系知识库（基于《 3. 坐标系介绍》培训讲义）。基准面分类、高斯 - 克吕格投影、四种坐标系文件、定义坐标系位数法、动态投影、坐标变换（同 / 不同椭球体、七参数）、坐标系错误诊断 |
两个技能主题重叠度高，区别：crs-selector 偏「拿到坐标快速判断 + 查 WKID」，arcgis-coordinate-system-lecture 偏「教学讲授 + 全体系铺开」。若要精简，可只保留 crs-selector。
3.2 数据质检与几何处理（6 个）
技能名 | 用途 |
arcgis-topology | 拓扑检查全流程。容差 / 脏区 / 规则 / 等级概念、 32条拓扑规则速查、 Refresh与Validate的区别、修复几何前置、建拓扑与验证、拓扑错误修复、环方向与面积计算、 ArcPy自动化脚本、 Pro 3.x相关API坑 |
arcpy-remove-overlap | 面要素重叠消除（ RemoveOverlapMultiple ）。按中心线 / 泰森多边形 / 格网均分，生成无重叠新面 |
arcpy-polygon-split | 线分割面并保留属性。用道路 / 河流 / 行政界线等线要素切分地块与行政区面 |
max-inscribed-rect | 任意多边形最大水平内接矩形。栅格化+直方图单调栈算法，求轴对齐最大面积内接矩形 |
arcpy-create-tin | 从点 / 线 / 面创建TIN （不规则三角网）。含本机实测正确的in_features 参数格式、 SF_type合法值、 CreateTin报ERROR 000800的解法 |
arcpy-raster-erase | 栅格擦除。 ArcGIS没有栅格Erase工具，本技能给出Con(IsNull(mask), raster)等价实现及全部坑位（波段数、像元对齐、 U8→U16 、 CalculateStatistics崩溃） |
3.3 属性与字段处理（2 个）
技能名 | 用途 |
arcpy-field-seq-numbering | 字段顺序编号（ 0001/0002/0003… ）。支持全局连续与按字段分组两种口径、多种排序依据；含文件级备份与三重校验强制流程 |
arcpy-attr-crosswalk | 按Excel对照表批量换算属性编码（二调 ↔ 三调地类互转、新旧标准码互转、代码 → 名称回填）。核心是反向映射的歧义检测与择优 |
3.4 数据转换与导出（3 个）
技能名 | 用途 |
gdb-feature-to-shp | GDB要素类导出Shapefile 。自动处理字符串字段长度自适应（ gdb按字符计、 dbf按字节计，汉字UTF-8占3字节/ GBK占2字节，超254字节自动压缩），防属性截断；可设dbfDefault=936 解决中文乱码 |
gdb-stat-to-excel-table | GDB分组汇总出统计表。按字段分组统计面积 / 数量，按xlsx模板生成新文件；覆盖CodedValue域取码表、合计行自洽、 editor_sdk插行保留模板样式 |
arcgis-mdb-to-gdb | 个人地理数据库 .mdb 转文件地理数据库 .gdb ，并把 .mxd图层数据源从mdb换成gdb后导入Pro保存工程。解决Pro 3.x不支持.mdb导致图层断链 |
3.5 制图、符号化与布局（5 个）
技能名 | 用途 |
arcgis-stylx-builder | 用Python直接生成.stylx符号库（纯标准库，无需arcpy/Pro GUI ）。适用于根据颜色表批量生成地类符号库。已逆向Pro 3.6格式，含「可写stylx用ITEMS/CLASSES表而非DATA表」关键坑 |
arcgis-stylx-symbolize | 用 .stylx对要素类做唯一值符号化并新建Pro工程（纯arcpy ）。核心是arcpy.cim把stylx里的CIM符号注入渲染类 |
arcgis-unique-value-cleanup | 唯一值符号化清理。删除有符号定义但无对应要素记录的多余符号项 |
arcpy-fixed-scale-layout | 固定比例尺+固定页边距布局。反算图纸尺寸（比例尺分母×数据范围→所需mm ）、自动选配最小标准图幅、铺地图框并锁死比例尺，导出300dpi PDF 。含「 arcpy.mp.Layer 没有 getExtent() 」等坑 |
arcpy-layout-graticule | 布局地图框添加 / 重建经纬网与公里网。设置间距、删除已有网格、控制标签方位字母（东 / 西 / 南 / 北）与分秒显示、坐标标签按千米显示。已封装为E:\2024\Pro\经纬网.atbx 、 E:\2024\Pro\公里网.atbx |
3.6 工具箱与二次开发（6 个）
技能名 | 用途 |
atbx-builder | 构建Pro.atbx工具箱。把Python脚本封装为ArcGIS工具、批量建多个工具、定义参数与摘要、修改或重建现有atbx |
atbx-deps-installer | 为 .atbx自动发现Pro的Python环境、解析依赖、检测并安装缺失的pip库。不硬编码路径，靠注册表+ conda登记表+常见位置定位 |
atbx-toolset-inventory | 解析 .atbx （ zip格式），按工具集提取全部脚本工具的名称、参数、依赖与实现细节，可汇总输出docx清单 |
arcgis-sdk-api-verify | 不具备编译条件时验证Pro SDK / CIM的类名与属性名是否存在，避免「写完才发现API不存在」的CS1061返工。含查官方XML文档、从.pagx/.lyrx反推CIM结构、二进制grep兜底、 C#大括号平衡校验 |
ylcpro | Pro C#二次开发实战指南。基于《 ArcGIS Pro C#二次开发：从0到1实战指南》，覆盖环境搭建、 DAML界面定制、地图操作、数据管理、几何处理、编辑、专题图、布局打印、 GP工具调用、三维、多线程、状态控制 |
gisai | ArcPy编程技能。覆盖Pro 3.x与ArcGIS 10.x的数据处理、游标操作、空间查询、几何处理、栅格处理、 MXD/APRX文档自动化、批处理工作流 |
arcgis-tool-inventory（见 3.7）与 atbx-toolset-inventory 的分工：前者管全盘跨箱清点与双口径对比，后者只管单个 atbx 的工具集明细。
3.7 环境运维与资产盘点（3 个）
技能名 | 用途 |
arcgis-pro-conda-pkgs | Pro自带Python环境（ arcgispro-py3 ）的第三方包安装 / 卸载。覆盖conda优先原则、 Program Files提权、 WorkBuddy safe-delete垫片绕过、五项残留验证 |
arcgis-pro-addin-uninstall | Pro插件（ Add-in / .esriAddinX ）彻底卸载。只删插件不动Pro本体；核心是定位Pro 3.x插件的真实安装位置 |
arcgis-tool-inventory | 全盘清点Pro工具资产并输出统计报告（ docx + Excel台账）。双口径： arcpy运行时枚举+全盘atbx容器解析 |
3.8 外部数据与在线底图（5 个）
技能名 | 用途 |
tencent-basemap-arcgis | 把腾讯地图（或任意XYZ/TMS在线瓦片）接入Pro/ArcMap ，产出可拖入地图的.lyrx 。核心是本地瓦片代理+手写CIMTiledServiceLayer JSON |
gdb-webmap-tencent | 把GDB矢量做成腾讯地图网页（单文件HTML ），可缩放平移、可点选属性，满足中国地图合规（南海诸岛插图+十段线）。链路为arcpy投影→ shapely简化→ GCJ-02纠偏→腾讯地图GL JS |
chirps-precip-clip | 下载CHIRPS全球降水栅格并按行政区矢量裁剪，输出GeoTIFF +网格采样点TXT/CSV 。纯GDAL/OGR ，不依赖arcpy 。含NASA POWER单点降水接口取数与单位换算 |
cloud-cog-window-fetch | 从公有云STAC/COG （ Earth Search的Sentinel-2 、 Landsat等）按bbox窗口抓栅格并算NDVI 。绕开本机GDAL vsicurl因libcurl版本错配导致的206误判，只下窗口瓦片 |
html-map-tool-headless-verify | 对依赖第三方地图SDK （腾讯TMap /高德AMap / Leaflet ）的本地单文件HTML工具做离线可复现的集成自测与版式截图。把SDK换成桩实现，用Chrome/Edge headless取报告与截图 |
3.9 知识与智能助手（4 个）
技能名 | 用途 |
arcgis-pro-knowledge-base | Pro全域知识库（源自68篇技术文章的提炼）。覆盖坐标系、拓扑、数据管理与字段、编辑工具、空间分析、制图打印、编程自动化、 ArcMap迁移与CAD对比、工具速查排错。含「按问题快速定位表」 |
arcgis-pro-copilot | Pro / ArcPy智能助手。面向ArcPy脚本、自动化、空间分析、地理处理、批量制图、用地分析、缓冲区、选址、水文、适宜性评价等任务 |
cad-agent | CAD Agent ——渲染服务器，让AI能「看见」正在构建的CAD模型：发建模命令→收渲染图→迭代。面向3D打印零件、参数化CAD 、机械设计、 build123d建模。 本技能当前无法被调用，见第七章体检结论 |
geo-awesome | Rust地理空间生态的技术选型与代码生成。精通geo 、 rstar 、 geozero 、 gdal 、 proj等库的空间算法、空间索引、拓扑计算与数据格式处理。 本技能 frontmatter 有格式问题，见第七章 |
3.10 文档与办公产出（9 个）
技能名 | 用途 |
docx-tech-report | 生成≤3页专业技术Word报告（排查总结 / 技术方案 / 调研报告）。 4色callout框、代码块、结构化表格、双语标题；用Word COM精确验证页数 |
conv-summary-docx | 把会话历史中的领域交流总结为结构化Word文档（如「总结最近20天的ArcGIS交流」） |
excel-word-batch-replace | Excel数据批量填充Word模板，每条记录生成独立文档。用lxml直接操作document.xml 的 w:t 元素，保留全部格式 |
minimax-docx | 基于OpenXML SDK （ .NET ）的专业docx创作、编辑与格式化。三条管线：从零创建/填充编辑/套用模板（带XSD校验门禁） |
pptx-generator | 专业PPT生成器。 11种幻灯片类型、 5套配色、图表 / 表格 / 时间线 / 图片支持， JSON驱动，产出标准可编辑PPTX |
pptx-apply-template | 把PPTX （内容源）套用另一个PPTX （模板源）的母版 / 主题 / 版式 / 配色，内容一页不改。含三件套脚本与「 PowerPoint报内容有问题」避坑指南 |
video-lecture-to-docx | 中文讲解视频本地语音识别转录后整理成带对比表 / 分级标题的Word文档。无需OpenAI key ，用faster-whisper + docx-js |
CSDN2PDF | 把CSDN博客文章转成干净PDF ，绕开反爬（反机器人验证、 headless 403 ）。支持blog.csdn.net链接 |
openstd-downloader | 从国家标准全文公开系统（ openstd.samr.gov.cn ）检索与下载GB/GB-T/GBZ标准 |
3.11 系统与开发工具（3 个）
技能名 | 用途 |
windows-disk-cleanup | Windows磁盘垃圾与缓存清理。流程为只读扫描→确认范围→分批清理→处理锁定与权限→表格汇报释放量；只删可再生缓存，绝不碰个人文件 |
ai-api-key-setup | 给WorkBuddy添加 / 更换 / 体检AI模型API Key 。自动探测可用模型、写入配置、验证连通。涉及models.json 、 DeepSeek/ 智谱 /Groq/OpenRouter |
github | 用 ghCLI操作GitHub （ issue 、 PR 、仓库管理、代码审查） |
3.12 媒体生成（4 个）
技能名 | 用途 |
muse-ai | AI音乐创作。生成原创歌曲、纯音乐与BGM 。三种模式：灵感模式（一句话生成）、定制模式（自定义歌词 + 风格）、纯音乐模式 |
suno-ai | 通过Suno生成音乐（本地浏览器驱动流程）。用于Suno歌曲、纯音乐、歌词歌曲、额度检查、会话恢复 |
sag | ElevenLabs文字转语音，仿macOSsay 的使用体验 |
openai-whisper-api | 通过OpenAI Audio Transcriptions API （ Whisper ）转录音频 |
3.13 业务专项（2 个）
技能名 | 用途 |
kcdj-workflow | 土地勘测定界全流程。流程为：用地范围∩三调DLTB →地块分析→界址点提取→面积平差→制图输出→报告生成。 仅命令触发 ，用 /kcdj-workflow 手动调用 |
qcc-company | 通过企查查查询中国企业工商信息、股权结构、高管、财务、对外投资、历史变更、上市信息、分支机构、联系方式、开票信息及企业身份核验 |
四、内置技能（26 个，不可卸载）
内置技能随 WorkBuddy 应用本体分发，覆盖设计、多模态生成、文档路由、金融、地图合规等公共能力。它们不属于你的个人资产，也无法单独管理。
技能名 | 用途 |
ardot-design-core | Ardot画布设计的通用工作流与硬规则 |
ardot-design-to-code | 把Ardot设计稿转成前端代码 |
ardot-poster | Ardot画布：海报类交付物 |
ardot-slides | Ardot画布：幻灯片类交付物 |
ardot-ui-design | Ardot画布： UI设计交付物 |
buddy-image-processing | 图片处理：去文字水印、通用增强、人像美化、修复、抠图 |
buddy-multimodal-generation | 多模态生成：文生3D 、图生3D 、基于模板的图片视频特效 |
cloud-service | 为应用接入托管Serverless后端（数据库、鉴权、文件存储、免密钥LLM ） |
design-router | 设计类任务的调度入口 |
expert-manager | 专家包全生命周期运营（转化、修改、合规检查、批量更新、质量审查） |
geo-map-compliance-guard | 地图合规强制守卫。任何地图生成 / 可视化 / 路径 / 位置服务请求都会触发，确保中国地图数据合规 |
library | 在线文档、数据表增删改查、看板 / 运营页、 md转网页、资料库 / 网盘操作 |
livestream-poster | 生成直播宣传海报（风格文件、风格目录静默匹配、参考图三种工作流） |
marketplace-skill-installer | 一句话从推荐市场搜索并安装技能 |
miora-brand-design | 品牌视觉设计决策层（ Logo 、吉祥物 /IP 、品牌VI 、物料延展） |
miora-creative-core | 创意媒体生成通用底座（意图识别、参数契约、费用边界、工具路由） |
miora-image-generation | 图片生成与编辑决策层（ prompt构建、比例尺寸、参考图、系列一致性） |
miora-video-generation | 视频生成决策层（镜头运动、时长画幅、主体一致性、失败处置） |
recommend-connectors | 任务需要外部应用 / 服务 /API/MCP且无现成工具时，搜索可安装的连接器 |
recommend-experts | 任务需要专业判断 / 深度研究 / 多角色协作时，搜索专家 |
sites | 把生成内容发布为在线链接，或取消发布 |
skill-creator | 技能创建指南（如何写出有效的技能） |
tencent-docs-routing | 本地Office/WPS文件的处理入口（读取、编辑、创建前必读） |
tencent-local-office-edit | 通过editor_sdk实时读写本机Office文件，编辑所见即所得 |
wb-finance-skill | 金融场景总入口（股票 / 基金 /ETF/ 板块 / 指数 / 宏观 / 外汇 / 大宗 / 财报 / 估值 / 量化） |
wecom-forwarded-chat-resources | 抓取企业微信转发聊天记录里的在线资源 |
内置技能随应用版本更新，不要手动删除（删除后应用更新会还原，且可能破坏其他功能）。
五、插件技能（79 个，由插件系统托管）
插件技能装在各插件目录下，不能单独卸载某个技能，只能卸载整个插件。当前来源有四类：
插件来源 | 技能数 | 代表技能 |
workbuddy-builtin （内置插件包） | 约44 | tencent-docx 、 tencent-pptx 、 tdoc-orchestrator 、 excel-generation 、 excel-handler 、 html-to-docx 、 doc-typeset 、 general-writer 、 legal-contract-expert 、 stock-research-report-expert 、 wechat-* 、 weixinpay-* |
codebuddy-plugins-official （官方插件） | 7 | agent-browser 、 playwright-cli 、 pdf 、 docx 、 pptx 、 xlsx 、 find-skills 、 skills-sec-audit |
experts （专家包携带） | 9 | aippt 、 ppt-implement 、 anti-distill 、 humanizer 、 mp-draft-push 、 wechat-draft-writer 、 wechat-style-profiler 、 wechat-title-generator 、 wechat-topic-outline-planner |
cb_teams_marketplace （团队市场） | 6 | neodata-financial-search 、 westock-data 、 westock-tool 、 pdfkit-py 、 pdf 、 wb-finance-skill |
说明：workbuddy-builtin 在插件缓存里存在多个版本目录（5.5.3 / 5.5.4 / 5.5.6），上表已按最高版本去重。与其他来源重名的技能（如 pdf、wb-finance-skill）在不同插件里是各自独立的副本。
六、卸载方法
卸载分两条路：官方技能管理页（推荐，安全可批量）与手动删目录（兜底）。内置技能和插件技能另有各自的规则，见后三节。
6.1 首选：技能管理页卸载（推荐）
这是官方支持的方式，安全、可批量、可撤销重装。
1.打开 WorkBuddy 左侧「技能」菜单，进入「已安装」区。
2.找到目标技能（技能多时用搜索框定位）。
3.勾选要卸载的技能，支持多选批量操作。
4.点「卸载」，确认。
卸载后技能市场里仍可重新安装，不必担心「删了就没了」。
6.2 临时不用：关闭而非卸载
偶尔才用、或者只是想降低误调用概率的，用「关闭」开关即可。关闭后技能不会在对话中被调用，但配置和文件都还在，随时可重新开启。
判断标准：一个月内没用过、且未来也用不上的，才卸载；偶尔要用的，关闭就好。
6.3 兜底：手动删除目录
技能管理页不可用时（例如界面异常、技能有格式错误不显示在列表里），可直接删目录。要删的技能就放在这个根目录下：
技能根目录 | 路径 |
用户级技能目录 | C:\Users\yl\.workbuddy\skills\< 技能目录名 >\ |
例如要删 cad-agent，就删除整个 C:\Users\yl\.workbuddy\skills\cad-agent\ 文件夹。
三条红线
红线 1：只删技能自己的文件夹，不要删 skills\ 根目录本身。
红线 2：绝对不要删 skills\ 根目录下的这几个 JSON 文件 —— 它们是 WorkBuddy 的内部状态记录，不是技能：
文件名 | 作用 |
.disable_to_model_invocation_migration.json | 触发控制字段的迁移状态 |
.model_invocation_to_override_migration.json | 同上 |
.user_invocable_only_to_off_migration.json | 同上 |
_bm_skillid_migration.json | 市场技能ID迁移状态 |
删掉它们可能导致技能触发行为异常。
红线 3：先备份再删。你自己的技能是长期积累的资产，删除前建议先把目录打包留档。目录里已经有两个 .rar 备份（arcgis-stylx-builder.rar、crs-selector.rar），可以继续沿用这个习惯。
删除方式：建议移到回收站而不是永久删除，误删了还能还原。
6.4 内置技能
不可卸载。它们随 WorkBuddy 应用本体一起分发，位于应用安装目录下。手动删除会在下次应用更新时还原，且可能影响依赖它们的其他功能。如果某个内置技能造成困扰，正确的做法是关闭它，而不是删文件。
6.5 插件技能
不能单独卸载技能，只能卸载插件。卸载插件时，它携带的全部技能一并移除。操作入口在插件的管理界面。手工删 plugins\cache\ 下的目录不是卸载——下次插件检查时会重新拉取。
七、体检结论：两个技能存在格式问题
在扫描过程中发现两个自建技能无法被正常识别，建议修复。以下给出问题定位与修复写法。
7.1 cad-agent —— 缺少 frontmatter（严重）
C:\Users\yl\.workbuddy\skills\cad-agent\SKILL.md 文件开头没有 YAML frontmatter，直接就是正文标题：
文件当前位置 | 实际内容 |
第1—2行 | # CAD Agent > Give your AI agent eyes for CAD work. |
后果：没有 name 和 description，WorkBuddy 无法把它识别为一个技能，它既不会出现在技能列表里，也永远不会被调用。目前等同于一个躺在硬盘上的文件。
修复：在文件最开头补上 frontmatter，建议内容如下：
应补内容 | 写法 |
frontmatter三行 | --- name: cad-agent description: CAD Agent —— 让 AI 能看见正在构建的 CAD 模型：发送建模命令、接收渲染图、迭代修改。适用于设计 3D 打印零件、参数化 CAD、机械设计、build123d 建模。 --- |
7.2 geo-awesome —— frontmatter 前有多余空行（中等）
C:\Users\yl\.workbuddy\skills\geo-awesome\SKILL.md 的第一行是个空行，--- 从第二行才开始。同时整个文件用的是 CRLF（Windows）行尾。
后果：严格解析器要求 --- 必须出现在文件第一个字符位置，前面有空白会导致 frontmatter 解析失败，name/description 读不到，技能同样可能不被识别。
修复：删除文件开头的那个空行，让 --- 位于第 1 行。
7.3 其余 52 个技能格式正常
其余 52 个技能的 name、description 齐全，frontmatter 位置正确。
八、维护建议
技能列表的维护成本随数量线性上升，建议按以下四条保持精简。
1.每月做一次技能整理：查看使用情况，卸载长期不用的，检查有没有功能重复的只留一个，让列表保持精简。
2.优先「关闭」而不是「卸载」：只在确定长期不用时才卸载。
3.发现模型挑错技能，就点名：用「用 XX 技能做 YY」的写法，比让它自己猜可靠。
4.新建技能时把 description 写好：这是模型判断是否加载的唯一依据，要写清用途和触发词。写完用「上传技能」导入，导入要求是文件夹或 zip 里含 SKILL.md。
WorkBuddy 技能清单与使用·卸载手册 · 数据来源：本机目录实际扫描（2026-09-21）