逐日AI微信小程序
7 天 Agent Skills:把经验做成可复用能力
第 1 周 · D4🔒 锁定约 5 小时

带脚本的 skill:可执行附件、依赖与沙箱、跨平台,以及文档处理类 skill 的拆解

什么时候该给 skill 配脚本而不是继续写指令,脚本的依赖怎么自包含,接口怎么为 Agent 设计,以及文档处理这类 skill 怎么拆成先规划再校验后执行三步。

今日目标 0/3

登录后可以勾选并保存进度。

今日目标

  1. 能判断一段逻辑该写进 SKILL.md 正文还是该沉淀成 scripts 里的脚本
  2. 能写一个自包含、非交互、输出结构化、错误信息可自纠的 Agent 友好脚本
  3. 能把一个文档处理任务拆成先规划、再校验、后执行的三步流程

昨天讲设计方法时留了个尾巴:「先规划、再校验、后执行」里那道关键的校验,本身是一段代码。今天把 skill 的第三个目录 scripts/ 讲透——什么时候该从写指令切换到写代码,写出来的脚本怎么才算「给 Agent 用的」,以及让模型跑你的脚本风险到底在哪。读完正文、做完实验之后,回到页面顶部把三条目标勾掉。

小白版讲解

什么时候该写脚本

档案柜里的作业指导书,翻到某一页写着「把这张表的三十行金额加起来,误差不能超过一分」。你可以在页面上写清楚加法怎么做,也可以在这一页夹一个计算器。skill 的 scripts/ 目录就是那个夹在页里的计算器。

判断口径有三条,命中任意一条就该写脚本。

第一条,同一段逻辑被重新发明了第三次。 你把一个 skill 跑了几轮,回头翻它的执行轨迹,发现模型每次都在现写一段几乎一样的代码——解析同一种格式、画同一种图、做同一种校验。每次现写,每次都可能写得不一样,而且每次都要花 token 和时间。这时候把它写成一个测好的脚本,一次投入长期受益。

第二条,结果必须逐字一致。 校验、格式转换、哈希计算这类事,正确答案只有一个。让模型「按指令做」意味着每次都有偏移的可能;让它跑脚本意味着结果是确定的。确定性任务交给代码,判断性任务留给模型,这是分工的基本盘。

第三条,一条命令复杂到第一次很难敲对。 一个带七个参数、还要按顺序管道三次的命令,写进正文里模型迟早敲错一个横杠。包成脚本,正文里就只剩一行。反过来,如果只是调一个现成工具加两三个参数,直接在正文里写这条命令就行,没必要为它建一个 scripts/ 目录。

第三条的反面也要说清楚:很多生态本来就有「不用装就能跑」的方式,比如 Node 侧的 npx、Python 侧的 uvx 与 pipx。这类一次性命令直接写进正文即可,但一定要把版本钉死:

BashBash
npx eslint@9.0.0 --fix .
uvx ruff@0.8.0 check .

不钉版本,你的 skill 就会在某个上游发版的早晨突然行为改变,而你完全不知道为什么。同理,如果脚本对运行环境有要求,写进 frontmatter 的 compatibility 字段,比如「需要 git、docker、jq 与联网」。

写脚本的门槛比多数人以为的要高一点:它是一份长期资产,要维护、要跟着模板变、要有人看得懂。所以三条判据一条都不命中的时候,老老实实写正文。

登录并关联后阅读全文

请先登录网页,并在账户页关联微信小程序账号。关联后每天可免费阅读 1 篇;额外文章需在小程序看广告解锁。

小程序码

微信扫码打开「逐日AI」,进入相同课程和章节,选择看广告解锁,完成后刷新本页。

面试题库

  • 什么逻辑该写成脚本放进 skill 的 scripts 目录,什么该留在 SKILL.md 正文里?Which logic belongs in a skill's scripts directory and which belongs in the SKILL.md body?
    国内高频海外高频基础#agent-skills#scripts

    🔒 解锁本章后查看答题要点。

  • 给 Agent 用的命令行脚本,接口设计上和给人用的有什么不同?How does designing a command-line script for an agent differ from designing one for a human?
    国内高频海外高频进阶#agent-skills#scripts#cli-design

    🔒 解锁本章后查看答题要点。

  • skill 里带脚本会带来哪些安全风险?你会怎么限制它?另外,为什么文档处理这类任务要先规划再校验后执行?What security risks come with bundling scripts in a skill, how would you contain them, and why should document tasks follow plan, validate, then execute?
    国内高频海外高频深入#agent-skills#security#workflow-design

    🔒 解锁本章后查看答题要点。

评论