技能管理
前置知识： 阅读本文前建议先了解 Bot 管理 中的技能配置部分。
技能（Skill）是可复用的 Markdown 指令包，注入到 Bot 的系统提示词中，赋予 Bot 特定领域的专业能力。
概述
技能解决的问题：系统提示词承载了 Bot 的通用行为指令，但不同场景需要不同的专业能力。把专业指令打包成技能，可以按需启用，避免系统提示词过于臃肿。
技能的本质很简单——一段 Markdown 文本，注入到 Bot 的系统提示词末尾。但通过标准化的格式和管理机制，技能可以在多个 Bot 之间复用。
技能格式
每个技能是一个 .zip 压缩包，包含一个 SKILL.md 文件和可选的附件。
SKILL.md 结构
---
name: code-reviewer
display_name: 代码审查专家
version: 1.0.0
allowed_tools:
- github_*
- web_search
---
## 角色定义
你是一个代码审查专家，专注于...
## 审查流程
1. 获取 PR 的变更内容
2. 分析代码质量
3. ...
## 注意事项
- 始终关注安全漏洞
- ...YAML Frontmatter 字段
| 字段 | 说明 | 必填 |
|---|---|---|
name | 技能标识（全局唯一） | 是 |
display_name | 显示名称 | 是 |
version | 版本号 | 否 |
allowed_tools | 此技能需要的工具列表（glob 模式） | 否 |
正文
YAML 下方的 Markdown 正文就是注入到 Bot 系统提示词中的指令内容。写法与系统提示词相同——告诉 Bot 在什么场景下应该如何行动。
附件
技能包可以包含附件文件（如参考文档、模板文件等）。附件存储在平台中，技能指令中可以引用。
上传技能
- 在左侧导航栏点击 技能
- 点击 上传技能
- 选择
.zip文件（包含SKILL.md） - 上传成功后，技能出现在技能列表中
技能列表
技能列表显示每个技能的：
- 名称和显示名称
- 版本
- 类型（纯指令 / 含工具）
- 工具数量（
allowed_tools中的工具数） - 附件数量
查看技能详情
点击技能名称查看详情，包括：
- 指令内容
- 允许的工具列表
- 附件列表
- 元数据（版本、许可协议等）
为 Bot 启用技能
- 进入 Bot 详情页 → 设置 Tab
- 在 Agent 能力 区域找到 技能 配置
- 从下拉列表中选择要启用的技能
- 可以同时启用多个技能
- 保存
启用后，技能的指令内容会自动追加到 Bot 的系统提示词末尾，以 ## Skills 部分呈现。
技能作用域
技能分为两个作用域：
| 作用域 | 说明 |
|---|---|
| 系统 | 平台内置的技能，所有工作区可用 |
| 工作空间 | 当前工作区上传的技能，仅本工作区可用 |
常见用法
代码审查技能
包含代码审查流程、关注点、输出格式等指令。绑定到代码审查 Bot，让 Bot 按照标准流程审查代码。
运维巡检技能
包含巡检项目清单、异常判断标准、报告格式等。绑定到运维 Bot，确保巡检流程标准化。
报告生成技能
包含报告模板、数据来源说明、格式要求等。绑定到报告 Bot，生成格式统一的报告。
常见问题
技能上传失败
- 确认
.zip文件中包含SKILL.md文件 - 检查 YAML frontmatter 格式是否正确
- 确认
name字段全局唯一
技能启用后 Bot 行为没有变化
- 确认技能已保存到 Bot 设置中
- 技能指令通过系统提示词注入，效果取决于 LLM 对指令的遵循程度
- 检查技能指令内容是否足够明确