User Guide

Skills 技能

可扩展的技能模块系统

Skills 技能

Skills 是预定义的 AI 交互模式,封装了特定任务的提示词、参数和工具配置。

技能定义

什么是技能

技能是一个完整的 AI 交互配置包,包含:

  • 系统提示词
  • 参数配置
  • 工具绑定
  • 输出格式

技能示例

name: "代码解释器"
description: "解释代码功能和逻辑"
system_prompt: |
  你是一个代码解释专家。请详细解释用户提供的代码:
  1. 代码的整体功能
  2. 关键逻辑的解释
  3. 使用的设计模式
  4. 潜在的改进点
parameters:
  temperature: 0.3
  max_tokens: 2000
output_format: markdown

创建技能

新建技能

  1. 进入 Skills 页面
  2. 点击 新建技能
  3. 配置技能信息

配置选项

字段说明
名称技能标识名称
描述技能用途说明
系统提示词技能的核心提示词
参数模型参数配置
工具绑定的 MCP 工具
输出格式期望的输出格式

参数配置

模型参数

参数说明默认值
temperature创造性程度0.7
max_tokens最大输出长度4096
top_p采样范围1.0
presence_penalty重复惩罚0

参数模板

为不同场景预设参数:

# 精确任务
precise:
  temperature: 0.1
  top_p: 0.9

# 创意任务
creative:
  temperature: 0.9
  top_p: 1.0

# 代码生成
coding:
  temperature: 0.2
  max_tokens: 8000

应用技能

在 API 测试中使用

  1. 打开 API 测试 面板
  2. 点击 选择技能
  3. 选择要使用的技能
  4. 输入用户消息
  5. 发送请求

通过 API 调用

curl http://127.0.0.1:9090/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-api-key" \
  -d '{
    "model": "claude-sonnet-4-20250514",
    "skill": "代码解释器",
    "messages": [
      {"role": "user", "content": "解释这段代码: function add(a, b) { return a + b; }"}
    ]
  }'

技能链

组合多个技能形成工作流:

name: "代码审查流程"
steps:
  - skill: "代码分析"
  - skill: "安全检查"
  - skill: "性能评估"
  - skill: "改进建议"

内置技能

代码相关

技能说明
代码解释解释代码功能
代码审查审查代码质量
代码重构提供重构建议
Bug 修复分析和修复 bug

写作相关

技能说明
文档撰写撰写技术文档
邮件回复生成邮件回复
内容总结总结长文内容

翻译相关

技能说明
通用翻译中英互译
技术翻译技术文档翻译

技能管理

编辑技能

  1. 点击技能的 编辑 按钮
  2. 修改配置
  3. 保存更改

删除技能

  1. 点击 删除 按钮
  2. 确认删除

导入导出

  • 导出: 将技能导出为 .yaml 文件
  • 导入: 从文件导入技能