e5科普⏱ 约 6 分钟

选修 · 怎么写好 Agent Skill 与提示

让智能体「听话又能干」的内功——好工具描述 + 好提示

🔎 最后验证 2026-06📚 来源:

为什么学这个

同样的模型、同样的工具,有人调出来的智能体又准又听话,有人调出来的答非所问——差别常常不在模型,在你怎么"交代"。

a1.3 你已经知道"工具描述决定它会不会用"。这一篇把这门内功讲透:怎么写好工具/Skill 的说明书,怎么写好提示词——让智能体真正听懂你要什么。

说明:这里说的 Skill,泛指你封装给智能体的一个能力 / 工具(和 a1.3 的"工具"是一回事);它和 Claude 的"Skills"那个特定产品概念不完全相同,本篇讲的是通用功夫。

一、好工具(Skill)说明书的 5 条原则

🎯单一职责

一个工具只干一件事

🏷️名字达意

看名字就懂用途

📖说明清楚

何时用 / 输入 / 输出

🧪给例子

示范一次怎么用

好工具说明书 = 让模型一眼知道「何时用我、给我什么、我返回什么」

对比一眼就懂:

❌ 烂说明	✅ 好说明
`工具1：处理数据`	`汇率查询：查某货币兑人民币汇率，参数 currency(如 USD)，返回数值`
`func_x：见代码`	`日程添加：在日历新增一个事项，参数 time、title，返回是否成功`

第 5 条:错误信息也要友好——工具失败时返回"为什么失败、该怎么办",模型才能自己纠正,而不是卡死。

一段靠谱的系统提示,通常有这几块:

❓ 测验

模型「该用某个工具时却不用」，最常见的原因是？

⚠️ 避坑两个高频翻车:描述含糊 + 工具太多

记住:调教智能体,改提示和工具描述,往往比换模型见效快得多、便宜得多。

🤖 帮我把工具描述写到位

我有几个工具想给智能体用:『___』(我来列名字和大概作用)。请帮我为每个写一份清晰的说明书(名字 / 何时用 / 输入参数 / 返回什么 / 一个示例),标准是让模型一看就知道何时该调用它。

✅ 小结

练好这门内功——工具说明写清楚、提示给骨架,你的智能体会立刻"听话"很多。这是最便宜、最见效的提升,却最容易被忽略。

最后一篇,我把真实开发里最常踩的坑汇成一张总表,提前帮你避开——也是这门课所有"避坑"的一次大收束。

下一节 → 选修：Agent 应用开发踩坑经验

都看到这了，打个赏呗！