TronCode Tron CLI 技能扩展

概述

技能(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] 语法调用:

Tron TUI
/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.yamlREADME.md(可选)以及必要的示例文件。

2
登录 TronCode 账号
终端
tron auth login
3
发布技能
终端
tron skill publish ./my-skill
正在验证技能格式...
发布成功:https://skills.troncode.cn/my-name/my-skill
💡
提示

发布前请确保技能描述清晰,并在 README.md 中提供使用示例,有助于其他用户发现和使用你的技能。