技能（Skill）体系详解

技能是什么

技能（Skill）是一份可复用的操作说明书。它把“某类任务该怎么做”固化成一个 Markdown 文件，AI 在相关任务触发时自动加载，按里面的步骤执行。

区别在于：没有技能，AI 每次都要重新摸索；有技能，它直接按你验证过的最佳路径走。

两个存储位置

级别	路径	适用场景
用户级	~/.workbuddy/skills/<技能名>/SKILL.md	跨项目通用（比如“发布公众号文章”）
项目级	{工作区}/.workbuddy/skills/<技能名>/SKILL.md	项目专属（比如“本项目的部署流程”）

默认建在用户级，除非这个技能换项目就没用了。

什么时候会自动触发

两种触发方式：

1. 相关性自动加载 你描述的任务和技能的 description 匹配时，AI 会自己加载。所以 description 写得准不准，直接决定技能能不能被想起来。

2. 你直接点名 “用 xxx 技能帮我做……”，明确指定。

⚠️ 重要提醒：技能不是自动生效的魔法。如果你发现 AI 没按你的技能走，大概率是 description 写得太窄，覆盖不到当前任务的说法。

自建技能的骨架

一个最小可用的技能：

~/.workbuddy/skills/my-workflow/SKILL.md

---
name: my-workflow
description: 当用户需要[做什么事]时使用。触发词：[关键词1]、[关键词2]
---

# 技能名称

## 适用场景
（一句话说清什么时候用）

## 执行步骤
1. 第一步做什么
2. 第二步做什么
3. 验收标准是什么

## 注意事项
（踩过的坑、必须避开的错误）

description 是核心。要写清“什么时候用”和“用户会怎么说”，触发词多写几个同义说法。

一个真实案例

假设你每周都要做同一件事：抓某个网站的内容 → 翻译 → 排版 → 发布。

第一次做完整流程可能要来回 20 轮对话。做完之后让它帮你沉淀成技能：

把我们刚才做的完整流程整理成一个技能，写到 ~/.workbuddy/skills/weekly-digest/SKILL.md，包含：抓取源、翻译要求、排版规范、发布步骤、以及这次踩的两个坑。

下次你只要说“做这周的周报”，它就会按技能执行。

技能的维护

技能写完不是终点。每次实际使用后，如果发现：

• 某步描述不清导致执行跑偏 → 改
• 有更优的路径 → 改
• 环境变了（工具升级、API 变更） → 改

不维护的技能是负债不是资产。过时的技能会让 AI 用错误的方法做事，还不如没有。

安装别人的技能

从市场安装第三方技能时注意：技能本质是会被 AI 执行的指令文件，等同于代码。安装前应做安全检查，重点看：

• 有没有读取敏感文件（密钥、浏览器 Cookie）
• 有没有对外发送数据
• 有没有执行破坏性命令（删除、格式化）

发现高危项就不要装。

下一篇

子代理与并行任务——一次派多个任务同时跑。