跳到主要内容

Agent Skills

Skill 是一套可复用操作方法，只有任务匹配时才由智能体加载。最小结构是一个带 SKILL.md 的目录；脚本、参考资料、素材和界面元数据都是可选项。

适合放进 Skill 的内容​

  • 跨会话或仓库反复出现的工作流；
  • 会实质改变执行方式的领域规则；
  • 输入、输出、检查和停止条件清楚的可靠步骤；
  • 重新生成不如直接复用安全的脚本或模板。

一次性偏好、普通知识事实，或只有一条显然命令的薄封装都不值得创建 skill。

设计规则​

  1. description 精确说明做什么、何时触发及重要排除项。
  2. SKILL.md 只做路线图和执行契约。
  3. 详细资料和确定性机械操作下沉到聚焦的文件或脚本。
  4. 引用保持浅层，避免智能体行动前追逐文件迷宫。
  5. 明确权限边界，并按风险选择验证强度。
  6. 用真实任务做正向测试，而不只检查目录格式。

这就是渐进披露：元数据始终可见，激活时加载完整指令，需要时才读取支持资源。

指令定义一定范围内的通用行为；skill 教方法；MCP 连接实时工具或上下文；harness 运行循环并观察方法是否奏效。