技能管理
技能管理
概述
**技能（Skills）**是预封装的专业能力模块，每个技能通过 SKILL.md 文件声明身份、触发条件和执行逻辑。系统预置 21 项技能，用户还可以创建自定义技能或使用企业统一部署的技能。
21 项预置技能
Office 文档类（4 项）
| 技能 | 说明 |
|---|---|
| docx | Word 文档生成与编辑 |
| xlsx | Excel 表格创建与处理 |
| pptx | PowerPoint 演示文稿制作 |
| PDF 文档处理 |
搜索类（4 项）
| 技能 | 说明 |
|---|---|
| web-search | 网页搜索，获取实时信息 |
| films-search | 影视作品搜索 |
| music-search | 音乐搜索 |
| technology-news-search | 科技资讯搜索 |
设计类（3 项）
| 技能 | 说明 |
|---|---|
| canvas-design | 画布设计，可视化创意生成 |
| frontend-design | 前端界面设计与代码生成 |
| remotion | 程序化视频生成（基于 Remotion 框架） |
AI 生成类（2 项）
| 技能 | 说明 |
|---|---|
| seedance | AI 视频/舞蹈生成 |
| seedream | AI 图像生成 |
开发类（2 项）
| 技能 | 说明 |
|---|---|
| develop-web-game | Web 小游戏开发 |
| playwright | 浏览器自动化测试与操作 |
工具类（4 项）
| 技能 | 说明 |
|---|---|
| create-plan | 创建结构化计划 |
| scheduled-task | 定时任务创建与管理 |
| local-tools | 本地工具集（系统信息、文件操作等） |
| imap-smtp-email | 邮件收发（IMAP/SMTP 协议） |
其他（2 项）
| 技能 | 说明 |
|---|---|
| weather | 天气信息查询 |
| skill-creator | 元技能 — 通过对话创建新技能 |
技能加载机制
目录扫描
系统自动扫描 SKILLs/ 目录，每个子目录包含一个技能：
SKILLs/
├── web-search/
│ ├── SKILL.md ← 技能声明文件
│ └── ... ← 辅助文件
├── docx/
│ ├── SKILL.md
│ └── ...
└── ...
SKILLs/
├── web-search/
│ ├── SKILL.md ← 技能声明文件
│ └── ... ← 辅助文件
├── docx/
│ ├── SKILL.md
│ └── ...
└── ...
此代码块在浮窗中显示
SKILL.md 规范
每个技能的 SKILL.md 文件声明：
- 技能名称与描述
- 触发条件：在什么情况下自动激活此技能
- 执行逻辑：技能的具体行为和能力
加载方式
技能在对话中以 execute_skill_{id} 的形式注入为工具，Agent 根据任务需要自动选择调用。用户也可在 PromptInput 中手动选择激活的技能。
技能状态管理
| 状态 | 说明 |
|---|---|
| 已启用 | 对话中可被 Agent 调用 |
| 已禁用 | 不出现在工具列表中 |
技能启用状态存储在 skill_states.json 中，可在设置页面切换。
自定义技能
通过 skill-creator 元技能，用户可以在对话中创建新技能：
- 在对话中描述想要创建的技能功能
- skill-creator 自动生成
SKILL.md和辅助文件 - 新技能出现在技能列表中
也支持从以下来源安装：
- 本地目录：直接放置到
SKILLs/目录 - Git 仓库：克隆到本地
- ZIP 文件：解压到技能目录
企业技能
工作空间管理员可通过企业资源统一发布技能到组织：
| 特性 | 说明 |
|---|---|
| 组织隔离 | 企业技能按 orgId 隔离，不同组织不互通 |
| 自动同步 | APP 端定期（30 分钟）从后端同步企业技能 |
| 安全级别 | 企业技能可设置安全级别限制 |
操作指南
如何启用/禁用技能
- 打开 APP → 设置 → 技能
- 浏览技能列表，每个技能旁有启用/禁用开关
- 切换开关即可
影响：
- 启用技能 → Agent 在对话中可以调用该技能。例如启用
web-search后，Agent 可以搜索网页获取实时信息。- 禁用技能 → Agent 完全不知道该技能存在。例如禁用
web-search后，Agent 只能依赖自身知识回答，无法获取最新信息。
启用/禁用的实际效果示例
| 技能 | 启用时 Agent 能做什么 | 禁用时的影响 |
|---|---|---|
| web-search | 搜索网页获取最新信息 | Agent 无法获取实时信息，可能给出过时的回答 |
| docx | 生成 Word 文档并提供下载 | Agent 只能输出纯文本，无法创建格式化文档 |
| playwright | 自动控制浏览器（截图、表单填写、爬取） | Agent 无法操作浏览器 |
| seedream | 生成 AI 图像 | Agent 无法生成图片 |
| imap-smtp-email | 收发邮件 | Agent 无法处理邮件相关任务 |
| scheduled-task | 创建定时自动执行的任务 | Agent 无法设置定时任务 |
如何创建自定义技能
使用内置的 skill-creator 元技能：
- 确保
skill-creator技能已启用 - 在 Claw 对话中描述你想要的技能，例如："帮我创建一个技能，可以自动格式化 JSON 文件"
- skill-creator 会生成
SKILL.md和辅助文件 - 新技能自动出现在技能列表中，可以启用使用
也可以手动创建：将包含 SKILL.md 文件的目录放入 SKILLs/ 文件夹。
常见问题
技能列表中看不到企业技能
企业技能每 30 分钟从后端同步一次。可以尝试重启 APP 触发立即同步。确认工作空间管理员已在企业资源中发布了技能。
启用了技能但 Agent 没有使用
Agent 根据任务需求自主决定是否调用技能。可以在对话中明确指示："请使用 web-search 技能搜索最新的 React 版本"。