在 AI Agent（如 OpenClaw、AutoGPT 等）逐渐普及的今天，Skills（技能）已成为决定 Agent 能力上限的核心模块。
很多人会用 Agent，但不会'教 Agent 做事'。而 Skills，就是你赋予 AI「可控执行能力」的关键。我们将从概念、设计到实战，聊聊如何编写高质量的 Skills。
一、什么是 Skills？
简单来说：
Skill = AI 可调用的'函数能力'
它本质上是一段结构化能力描述，让 AI 能明确知道什么时候用你、怎么用你、以及返回什么结果。
举个例子，如果你定义一个 Skill：
{
"name": "get_weather",
"description": "获取指定城市天气",
"parameters": {"city": "string"}
}
当用户问：'帮我查一下吉隆坡天气'，Agent 就会自动调用这个 Skill。
二、Skill 的核心结构
一个完整的 Skill，通常包含四个核心部分：
1. 名称（name）
必须清晰，尽量以动词开头。
- ✅ 推荐：
get_weather,create_file,deploy_server - ❌ 不推荐：
weather1,doSomething
2. 描述（description）
这是最重要的部分！AI 是否能正确调用 Skill，80% 取决于 description。 好的描述应该明确用途、指出使用场景，避免歧义。
✅ 示例：
获取指定城市的实时天气信息，包括温度、湿度和天气状况。适用于用户询问天气相关问题时使用。
3. 参数（parameters）
定义 AI 传入的数据结构。
{
"type": "object",
"properties": {
"city": {"type"
