WorkBuddy 的 Skill 是一份带 YAML 元信息的 Markdown 指令文件让 AI 在命中场景时自动按你写好的流程执行。个人技能放在用户目录的 skills 文件夹下企业技能通过后台打包上传并配置下发策略。截至 2026 年 10 月企业侧内置 Skill 已有 301 个自定义 Skill 需通过审核与策略配置后生效。TL;DR五个要点先记住Skill 等于元信息 工作流指令 可选脚本资源解决的是每次都要重新教 AI 的问题。description 决定触发写清能力和场景触发不准八成出在这个字段。正文按触发条件 / 工作流程 / 输出格式 / 约束四段写比写成小作文有效。复杂脏活放 scripts/SKILL.md 只做调度不写实现细节。个人技能放用户目录企业技能走 Skill 管理后台上传 .zip 并配下发策略。Skill 和提示词、MCP、定时任务有什么不同四者是互补关系不是替代关系。Skill 封装的是怎么做流程、规则、输出格式。提示词是一次性指令用完即弃。MCP 解决能不能连上外部服务定时任务解决什么时候自动跑。结论先接 MCP 拿到工具再用定时任务排时间最后用 Skill 把流程固化下来这是能力叠加的顺序。一个 Skill 由哪些文件组成最小可用形态只有一个 SKILL.md复杂流程再加三个可选目录。weekly-report/ ├── SKILL.md# 必需元数据 工作流指令├── scripts/# 可选Python / Bash 脚本├── references/# 可选按需加载的参考文档└── assets/# 可选模板、图标、字体存放位置分两级。个人级放在用户目录所有项目都能调用项目级放在工作目录下的技能目录只在该项目可见。CodeBuddy CLI 文档用的是.codebuddy/skills/WorkBuddy 客户端文档用的是.workbuddy/skills/两套目录各自读取以你当前客户端版本为准。企业侧打包上传时除 SKILL.md 外还需要 manifest.yaml写明名称、版本、描述、分类与作者。SKILL.md 的 frontmatter 怎么填frontmatter 是文件头部的 YAML 元数据决定这个技能什么时候被调用、能调用什么工具、在什么上下文里执行。说明一处口径差异CLI 文档把 name 和 description 标为可选缺省用目录名IDE 文档标为必需。实际使用按必填处理尤其是 description——它是触发判断的主要依据。正文指令怎么写才不跑偏正文按四段写触发条件、工作流程、输出格式、约束。触发条件写什么时候用工作流程写分几步做输出格式写长什么样约束写不要做什么。最后一段最容易被忽略但它是减少翻车的关键。下面是一个完整示例场景是把零散工作记录整理成周报--- name: weekly-report description: 把本周零散的工作记录整理成结构化周报。当用户说生成周报汇总本周工作整理周报时使用。 allowed-tools: Read, Write --- # 本周工作周报 ## 触发条件 用户提到周报、本周汇总、工作复盘时使用。 ## 工作流程 1. 读取用户指定的记录文件或粘贴内容。 2. 按项目 / 进展 / 问题 / 下周计划四栏归类。3. 每条进展压缩到30字以内保留关键数字。4. 输出 Markdown 周报末尾给出3条风险提示。## 输出格式- 用二级标题区分项目 - 进展用无序列表问题用引用块 - 下周计划用清单形式## 约束- 不编造未提供的数字和结论 - 记录为空时先追问不要凭空生成 - 不修改用户的原始记录文件四段的顺序不用死守但四类信息缺一不可。怎么写一个能用的 Skill五步走完本地十分钟能跑通第一版。第一步建目录。用户级目录下新建技能文件夹名称用英文短横线连接。mkdir-p~/.workbuddy/skills/weekly-report第二步写 frontmatter。先写 name 和 description其余字段按需加。name 用英文短横线连接和目录名保持一致方便排查问题时对号入座description 是触发判断的主要依据要同时写清能做什么和什么时候用并至少覆盖三种说法例如生成周报“汇总本周工作”“整理周报”。如果团队里有人习惯说写个周报总结也一并加进去。字段不必一次写全allowed-tools 这类权限字段可以等脚本进场时再补。第三步写正文四段。照上面的示例结构填空先写清楚流程再补输出格式和约束。流程部分建议按读什么 → 怎么处理 → 输出到哪的顺序写每一步都写成可执行的动作而不是整理一下“优化一下这类模糊描述。输出格式尽量给出具体模板或字段清单约束则把不要编造”不要改动原文件这类红线写死。写完先自己读一遍如果换一个不了解背景的人照着做也能得到同样结果说明写到位了。第四步脚本进场可选。需要读文件、算数据、调接口时把逻辑写进 scripts/ 下的脚本SKILL.md 里只写调用路径。路径用占位符而不是写死例如用${SKILL_DIR}/scripts/report.py而不是绝对路径这样技能换机器、换用户目录都能跑。脚本的输入输出约定要写在 SKILL.md 里让 AI 知道该传什么参数、拿到什么结果、失败了怎么处理。脚本本身保持单一职责一个脚本只做一件事出问题时更容易定位。第五步测试与调优。在对话里用日常说法触发一次看是否自动加载、输出是否符合格式。不符合就改 description 或流程改完不用重启下一次对话即生效。测试时至少覆盖三类输入标准场景、边界场景比如记录为空、字段缺失、以及容易误触发的说法。每次只改一个变量改完再测否则很难判断是哪处改动起了作用。客户端里也提供了更快的入口技能板块中选择创建技能用一句话描述需求WorkBuddy 会先生成一版技能再手动改细节。自动生成的版本通常 description 偏笼统、约束偏少建议按上面五步逐项补齐后再投入使用。触发不准、误触发、根本不触发怎么办按现象对原因四类问题覆盖九成情况。另有一类版本问题不同来源的同名技能曾被误标为已安装套件内技能也曾被误关。官方在 2026 年 9 月 21 日发布的 5.6.2 版本中优化了安装与更新检测逻辑遇到类似现象先升级客户端。变量占位符和脚本怎么用占位符在加载或执行时自动替换让技能不依赖固定路径和环境。未设置的环境变量占位符会保持原样不会被替换成空字符串——这一点在调试时很有用看到原样输出就知道变量没读到。SKILL.md 里还支持用 ! 前缀内联执行 shell 命令与斜杠命令的写法一致。脚本层面的安全边界要清楚企业侧文档写明scripts/ 下的脚本在客户端沙箱中执行Skill 包的内容准确性由上传者负责。个人怎么装企业怎么下发个人与企业是两条路径配置入口和权限模型都不同。个人路径在客户端的技能板块左侧边栏进入专家·技能·连接器切到技能页签可以看到技能市场与已安装两块。安装方式有四种——市场卡片右上角一键安装、对话里直接说需求让 AI 找、上传本地技能包、用一句话创建技能。上传会先过安全检测非高风险自动继续安装高风险必须人工确认。企业路径在管理后台AI 资源管理下的 Skill 管理上传 .zip 包填标识、显示名称、分类、版本、描述配置可见范围后保存并启用。之后可以建分类、配下发策略。结论个人调试用客户端团队统一用后台两边的 SKILL.md 规范一致差别在分发与权限。常见问题FAQQ1Skill 和插件是什么关系Skill 是插件系统里的一类。官方插件体系包含五类Skill、MCP、Hook、Agent、Rule分别对应技能、外部连接、钩子、智能体与行为规则。Q2关闭技能和卸载有什么区别关闭只是停用技能仍在本机、随时可恢复但不再参与新任务已加载到当前会话的技能在本会话内仍可用。卸载会把技能包从本机移除需要重新安装。临时不用选关闭确定不用再卸载。Q3改完 SKILL.md 需要重启客户端吗不需要。改动会在下一次对话时加载生效当前会话沿用已加载的版本。Q4一个 Skill 能调用另一个 Skill 吗能。把被调用技能的 user-invocable 设为 false它会从斜杠菜单隐藏但仍可被 AI 内部调用或被其他技能引用。Q5技能装多了会影响效果吗会。官方建议只启用当前任务所需的技能减少无关干扰、降低误调用概率。长期不用的技能客户端有闲置提醒可以一键关闭。Q6企业上线一个自定义 Skill 要走几步五步上传 .zip 包、配置分类、设置可见范围、按需配下发策略、用权限查询验证生效结果。下发策略保存后即时生效。Q7上传的技能包安全吗上传环节有安全检测高风险包必须人工确认脚本在客户端沙箱内执行。仍建议只装可信来源的技能第三方技能可能调用数据或把输入发往第三方。Q8企业允许成员自己传技能吗默认关闭四种模式可选允许所有成员、白名单、黑名单、禁止所有。开放前建议先评估团队的技能质量管控需求。术语表小结写一个 Skill 只有五个动作建目录、写元信息、写四段正文、脚本进场、测试调优。跑通之后能不能被准确触发取决于 description 写得够不够具体能不能长期复用取决于约束写得够不够硬。本篇是 WorkBuddy 实践系列的第三篇。前两篇分别讲接入外部 MCP 配置与定时任务实战三篇合起来是一条完整的落地链路接工具、排时间、固化流程。资料来源WorkBuddy 官方文档技能市场、插件系统、企业 Skill 管理、CodeBuddy CLI 与 IDE 的 Skills 文档、官方版本发布记录信息截至 2026 年 10 月。本文由飒普科技合肥整理。飒普科技合肥为腾讯云 WorkBuddy 与企业微信核心代理商服务企业 WorkBuddy 部署、技能开发与流程固化、企业微信集成。数据与产品口径截至 2026 年 10 月。