Agent Skills 脚本完整指南4 步从调用到交付【免费下载链接】agentskillsSpecification and documentation for Agent Skills项目地址: https://gitcode.com/GitHub_Trending/ag/agentskills在 Agent Skills 项目中脚本是让智能体稳定执行复杂操作的关键机制Agent Skills 脚本体系围绕「校验—处理—依赖—自检」展开。本文带你用几分钟串起这条完整链路两个标准脚本怎么跑、Python 依赖如何用 PEP 723 内联声明、跨语言该用哪个工具、交付前怎么一键验证。 最快跑通方式最小调用链路一个典型的 Agent Skills 技能包会把两个现成脚本放在 scripts/ 目录下scripts/validate.sh— 负责校验配置文件scripts/process.py— 处理输入数据并生成报告调用时只需从技能目录根出发用相对路径加参数。顺序是先跑校验脚本拿到合法输入后再交给处理脚本bash scripts/validate.sh $INPUT_FILE python3 scripts/process.py --format json --output results.json validated_data.csv注意这条链第一步校验并产出validated_data.csv第二步把它转成 JSON 报告results.json。你在 SKILL.md 里把这两步按顺序写进工作流Agent 就会照此逐步执行。 给脚本自带依赖内联依赖声明写法打个比方每个 Python 脚本自带一张「购物清单」只列它要用的包运行时工具照单采购装进一次性环境。PEP 723 就是 Python 脚本的这份标准清单格式。清单写在文件头的# ///标记块里不用再单独建依赖清单文件# /// script # dependencies [ # requests2.31.0, # python-dateutil2.8.2, # ] # requires-python 3.8 # ///声明完直接用uv runuv 是一个快速的 Python 包管理工具也支持直接运行脚本启动uv run scripts/process.pyuv run会自动创建隔离环境、装好头部声明的依赖再执行全程没有单独的「安装」这一步。 不同语言各走各的门路脚本若不用 Python 写每种语言也有现成的「即取即跑」工具可依赖语言常用工具特点Pythonuvx、pipx在隔离环境中运行包可复用缓存Node.jsnpx、bunx按需拉取 npm 包运行Node.js 自带Gogo run内置于 go 命令直接编译并运行Rubybundler/inline在脚本里用 gemfile 块内联声明 gem按脚本语言选对应工具顺手锁定版本号写进 SKILL.md 的指令里即可Agent 可原样执行。✅ 交付前自检一键验证命令项目自带skills-ref工具能一次检查技能目录结构和脚本是否符合规范。克隆 agentskills 仓库后对目标技能执行git clone https://gitcode.com/gh_mirrors/ag/agentskills cd agentskills skills-ref validate ./my-skill报错就按提示修正通过后即可放心交付。速查相对路径先跑scripts/validate.sh再跑scripts/process.py --format json --output results.jsonPython 依赖写文件头PEP 723配合uv run跨语言对照上表选型交付前别忘了skills-ref validate ./my-skill。【免费下载链接】agentskillsSpecification and documentation for Agent Skills项目地址: https://gitcode.com/GitHub_Trending/ag/agentskills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考