| name | writing-skills |
| description | 元技能 —— 教你如何编写高质量的 WorkBuddy Skill。用于创建新 Skill 或改进已有 Skill。触发词:写skill、创建技能、改进skill、skill怎么写、writing skills。 |
| agent_created | true |
编写 WorkBuddy Skill(元技能)
概述
Skill 封装了特定工作流——它不是文档,是塑造 AI 行为的代码。
Skill 的结构
skill-name/
├── SKILL.md # 主文件(必需)
└── references/ # 参考资料(可选)
├── guide-1.md
└── guide-2.md
SKILL.md 模板
---
name: skill-name
description: 用途+触发条件+触发词
agent_created: true
---
# Skill 标题
## 概述
[一段话说明这个 skill 做什么]
## 何时使用
- 触发条件 1
- 触发条件 2
- 触发词: xxx、yyy、zzz
## 核心铁律/硬门禁
[如果有不可违反的规则,放这里]
## 步骤/检查清单
1. **步骤 1** — 具体做什么
2. **步骤 2** — 具体做什么
...
## 工作流/流程图
[复杂流程可用文本流程图]
## 关键原则
- 原则 1
- 原则 2
## 反模式/红灯
[常见的错误做法,列出来警示]
Skill 设计原则
1. 清晰触发条件
描述什么时候该用这个 Skill,什么时候不该用。触发词要覆盖中英双语。
2. 强制流程
用 "MUST"、"强制"、"Hard Gate" 标记不可跳过的步骤。
3. 具体可执行
不是说"做代码审查",而是:
- 运行
pytest -q
- 检查 git diff
- 派发审查子代理(附带完整提示模板)
- 按严重程度分类问题
4. 处理边界情况
- 出错了怎么办?
- 不通过怎么办?
- 用户想跳过怎么办?(说明后果)
5. 给出示例
好的示例和差的示例对比,比纯文字更有效。
6. 保持精简
Skill 不是手册——只放 AI 每次执行时需要遵循的关键规则。
7. 中英双语
触发词和关键描述中英双语,覆盖不同表达习惯。
测试 Skill
写完 Skill 后:
- 用真实场景触发测试
- 观察 AI 的行为是否符合预期
- 收集反例——什么时候 Skill 没触发或触发错了
- 迭代调优
常见错误
| 错误 | 正确做法 |
|---|
| 描述太模糊("做好代码审查") | 给出具体检查清单和命令 |
| 触发条件太宽泛(匹配到不该匹配的任务) | 收紧触发词,加排除条件 |
| 步骤太复杂(AI 执行效率低) | 精简到最小必要步骤 |
| 没有错误处理 | 加"如果失败/不通过怎么办" |
| 纯英文(中文用户触发不了) | 加中文触发词和描述 |