Skills 脚本扩展

基础的 Skill 仅依靠 SKILL.md 文本规则即可完成简单任务，例如问候、掷骰子、格式整理。但如果遇到复杂运算、批量处理、文件解析、数据校验、接口请求等高级任务，仅靠文本指令无法实现。

此时需要使用 Skills 脚本扩展 能力。脚本扩展是 Skill 体系的高级能力，用于为 AI 智能体赋能可编程能力，让技能从「文本规则」升级为「可编程自动化工具」。

一、什么是 Skills 脚本扩展

Skills 脚本扩展，指在标准 Skill 目录中，通过新增 scripts 脚本目录，编写 Python、Shell 等可执行代码，对 Skill 能力进行扩展。

简单理解：

• SKILL.md：负责定义规则、流程、触发条件、输出规范（上层调度）
• 脚本文件：负责复杂计算、逻辑处理、数据操作（底层执行）

脚本扩展让 Skill 不再局限于简单终端命令，能够实现高度自定义的复杂业务逻辑。

二、为什么需要脚本扩展

纯文本 SKILL.md 存在明显局限性，无法满足复杂场景：

• 无法实现多步复杂逻辑判断、循环、遍历运算
• 难以批量处理文件、解析 JSON、统计数据
• 原生终端命令功能单一，无法完成精细化业务处理
• 纯文本规则容易出现输出不稳定、逻辑混乱

通过脚本扩展，可以固化稳定代码逻辑，让 AI 只负责调用工具，不依赖模型脑补，大幅提升技能稳定性。

三、脚本扩展标准目录结构

在原有标准 Skill 目录基础上，新增 scripts 文件夹，即为脚本扩展规范结构：

roll-dice/
├── SKILL.md        # 技能核心规则文件
└── scripts/
    └── main.py     # 自定义扩展脚本

目录规范说明：

• 所有脚本统一存放在当前技能的 scripts 目录下
• 一般使用 main.py 作为入口执行文件
• 脚本仅对当前技能生效，技能之间相互隔离，互不干扰

四、脚本扩展工作机制

脚本扩展完全兼容 Skill 渐进式加载原理，执行流程更加高级：

1. 发现阶段：TraeCode 仅读取 YAML 元数据，不加载脚本
2. 激活阶段：用户指令匹配技能描述，加载完整 SKILL.md
3. 脚本加载阶段：规则中需要代码执行时，按需读取 scripts 目录脚本
4. 代码执行阶段：调用脚本完成复杂逻辑运算，返回标准化结果

核心特点：脚本也是按需加载，不会额外浪费 Token 与系统资源。

五、脚本扩展与基础 Skill 的区别

对比项	基础 Skill（纯 SKILL.md）	脚本扩展 Skill
实现方式	文本规则 + 简单终端命令	文本规则 + 可编程脚本
能力范围	简单问答、简单指令执行	复杂运算、批量处理、数据解析、自动化
逻辑稳定性	一般，依赖模型理解	极高，代码逻辑固定不变
扩展性	弱，无法复杂迭代	强，可无限扩展代码功能

六、脚本扩展典型应用场景

在实际开发中，脚本扩展常用于以下场景：

• 数据计算：复杂骰子算法、分数统计、批量求和
• 文件处理：读取本地文件、解析文本、批量生成文档
• 格式转换：JSON、Markdown、表格数据互转
• 自动化任务：批量重命名、代码格式化、日志分析
• 接口能力扩展：请求网络数据、获取实时信息

七、脚本扩展开发优势

• 逻辑固化：代码逻辑固定，不会因为模型差异导致输出错乱
• 能力极强：突破纯文本技能限制，实现工业级自动化能力
• 解耦清晰：规则层与执行层分离，SKILL.md 管调度、脚本管执行
• 可维护性高：脚本可单独调试、单独迭代、单独优化
• 完全兼容原生机制：不破坏原有渐进式加载、目录规范

八、总结

Skills 脚本扩展是 AI 技能体系的高级进阶能力。通过新增 scripts 目录与可执行脚本，让原本只能执行简单规则的 Skill，拥有可编程、可自动化、可复杂运算的强大能力。

基础 SKILL.md 负责「怎么调度、怎么输出」，脚本扩展负责「怎么计算、怎么执行」，两者结合构成了完整、稳定、可工程化的 AI 智能体技能体系。