技能管理
Skill 是提供给 Agent 的可复用任务方法。它可以描述文档处理、浏览器操作、开发或媒体任务的推荐流程，但是否可用仍取决于当前 Agent、模型、依赖工具和访问权限。
已安装 Skill、技能市场和启用状态开始前准备
- 已经配置一个可用模型，并准备好在线实例。
- 明确 Skill 是否需要读取文件、访问网络或执行本地程序。
- 第一次测试使用非敏感目录和可丢弃的测试文件。
查找和启用已安装 Skill
- 点击左侧“技能管理”。
- 在“已安装”页签中搜索目标技能。
- 打开技能说明，确认用途、来源、版本和依赖。
- 使用卡片右上角开关启用该技能。
- 新建测试对话，在输入区选择 Skill 后发送一个范围明确的小任务。
- 核对结果、输出目录和日志；验证通过后再用于真实资料。
完成状态
Skill 开关保持启用，在目标 Agent 的任务入口中可选择或被明确调用，并能在测试目录生成预期结果。
从技能市场安装
- 切换到“技能市场”。
- 按任务名称搜索，不要只根据热门程度安装。
- 阅读来源和说明，确认它需要的文件、网络、账号及外部程序权限。
- 使用当前页面提供的安装入口完成安装。
- 返回“已安装”，确认新技能出现并按上面的测试流程验证。
市场中出现不代表技能经过了你所在组织的安全审计。第三方 Skill 应按可执行内容处理。
添加自定义 Skill
页面提供“添加”入口时，可以按当前表单导入或登记自定义 Skill。添加前至少确认：
- 名称和用途清晰，不与现有技能混淆。
- 来源目录可追溯，内容已经人工检查。
- 依赖命令、运行环境和输出位置明确。
- 文件、网络和账号权限符合最小权限原则。
- 有一个不会破坏真实数据的验收任务。
具体字段可能随版本变化，以“添加”页面实际显示为准。
Agent 兼容性
不同 Agent 对 Skill 的发现方式和执行能力可能不同。某个 Skill 在 OpenClaw 可用，不代表 Claude Code、Hermes Agent 或 Codex 会以相同方式加载。每次新增或升级后，应在实际使用的 Agent 中分别测试。
停用和更新策略
- 低频或高权限 Skill 默认停用，需要时再开启。
- 更新前记录当前版本和测试结果；更新后重复最小验收任务。
- 不再使用的 Skill 先停用，确认没有定时任务或会话依赖后再按当前界面提供的方式移除。
- 不要在任务执行期间切换关键 Skill 版本。
故障排查
| 现象 | 检查顺序 |
|---|---|
| 页面找不到 Skill | 搜索词、已安装/市场页签、安装是否完成 |
| 已启用但对话中不可用 | 当前 Agent 兼容性、模型、实例和会话是否刷新 |
| 执行时提示缺少命令 | Skill 说明中的依赖、运行环境和 PATH |
| 无法读取文件 | 工作目录、敏感文件夹规则、当前账号权限 |
| 输出位置错误 | 任务指令、工作目录和 Skill 默认输出规则 |
复制错误文字和时间到 日志中心 对照，不要用真实文件反复重试。