概述
技能(Skills)是可复用的 AI 能力包,类似 prompt 模板的高级版本。与简单的 prompt 模板不同,技能可以包含完整的指令链、工具调用序列和上下文注入逻辑,让 Tron 具备特定领域的专业能力。
技能的典型使用场景包括:生成单元测试、执行代码审查、生成 API 文档、分析性能瓶颈等重复性但需要 AI 参与的工程任务。
安装技能
通过 tron skill install 命令从技能市场安装技能:
tron skill install unit-test
正在从技能市场下载 unit-test@1.2.0...
已安装技能:unit-test
也可以从本地目录安装自定义技能:
tron skill install ./my-custom-skill
已从本地路径安装技能:my-custom-skill
使用技能
安装技能后,在 TUI 中通过 /skill <name> [args] 语法调用:
/skill unit-test src/utils/math.ts
也可以在项目的 AGENTS.md 文件中引用技能,让 Tron 在相关任务中自动应用:
markdown
# AGENTS.md
## 技能配置
修改工具函数时,使用 `unit-test` 技能为新函数生成测试用例。
提交 PR 前,使用 `code-review` 技能进行自检。
创建技能
技能以 YAML 格式定义,包含元数据和执行指令。以下是一个 "unit-test" 技能的示例:
yaml
# skill.yaml
name: unit-test
version: "1.0.0"
description: 为指定文件生成完整的单元测试
author: your-name
args:
- name: file
description: 目标文件路径
required: true
prompt: |
请为文件 {{file}} 生成完整的单元测试。
要求:
1. 覆盖所有导出函数和类
2. 包含正常路径和边界情况测试
3. 使用项目已有的测试框架(检测 package.json)
4. 遵循项目现有测试文件的命名和结构规范
读取文件内容后开始生成测试。
tools:
- read_file
- write_file
- list_directory
将 skill.yaml 放入技能目录(默认为 ~/.tron/skills/unit-test/),或通过本地安装命令引入。
发布技能
将技能发布到技能市场,让其他人也能使用:
1
确认技能目录结构完整
确保包含 skill.yaml、README.md(可选)以及必要的示例文件。
2
登录 TronCode 账号
tron auth login
3
发布技能
tron skill publish ./my-skill
正在验证技能格式...
发布成功:https://skills.troncode.cn/my-name/my-skill
提示
发布前请确保技能描述清晰,并在 README.md 中提供使用示例,有助于其他用户发现和使用你的技能。