12. Skills 实战：写 Skill 约束输出质量

实战目标

这一篇写一个研究报告 Skill。

目标不是让文风更漂亮，而是约束质量：资料要有来源，结论要有证据，拿不到信息时不能硬写。

Skill 应该约束什么

建议约束五件事：

先确认任务目标
优先拿原文或官方资料
记录来源 URL
区分事实、判断和不确定信息
生成报告后检查文件是否存在

这五条比“写得专业一点”有用得多。

一个 Skill 骨架

可以这样组织：

# Research Report Skill

## When to use
用于需要搜索资料、形成判断、生成 Markdown 报告的任务。

## Workflow
1. 明确研究问题。
2. 搜索并筛选来源。
3. 优先抓取原文。
4. 提取证据片段。
5. 写报告。
6. 保存文件。
7. 验证文件存在。

## Quality rules
- 没拿到原文时，不要写成确定事实。
- 每个关键判断至少对应一个来源。
- 报告里区分事实和推测。

不要写成大而全

Skill 不是百科全书。

如果规则太多，Agent 反而抓不住重点。

建议第一版只约束最容易出问题的地方：来源、证据、不确定性、文件验证。

验证方式

给 Agent 一个真实但小的问题：

调研 DeerFlow 的核心能力，生成一份 800 字以内的 Markdown 报告。

看它是否：

• 先找资料；
• 引用来源；
• 没有凭空扩展；
• 生成了文件；
• 返回了文件路径。

这一篇你要记住

好的 Skill 不是让 Agent 更会“说”，而是让它更稳定地“做”。

这类 Skill 最容易失败在哪里

第一，规则太抽象。

比如“请保证内容准确”没有太大价值。Agent 不知道怎么执行。

更好的写法是：

关键判断必须对应来源 URL。
没有拿到原文时，标注为不确定。
生成文件后，返回文件路径并确认文件存在。

第二，规则太多。

Skill 不是法律条文。第一版只保留最能提升质量的规则。

第三，没有验证任务。

写完 Skill 后，一定要用同一个主题跑有 Skill 和无 Skill 两次，对比报告质量。

最小验收清单

报告是否有来源？
不确定信息是否被标注？
文件是否真的生成？
输出是否比无 Skill 更稳定？

能通过这些检查，才说明这个 Skill 有用。