Skill 找不到或装不上 — 三个原因各有解法

情况一：装了但 AI 说找不到

最常见的原因：上下文太杂。

现象：明明装了 sophnet-pptx，但你让 AI"帮我做个 PPT"时，它却说"我没有 PPT 相关的 skill"。

原因：AI 在选择 Skill 时受当前上下文影响太大。如果之前对话里提到过"我不会装 Skill"或"上次装 Skill 失败了"，AI 可能把这些历史信息当作"应该回避这个 Skill"的信号。

解决：创建一个新的 session（清空上下文或开新对话），在新 session 里重新输入指令。

官方文档也明确提到了这一点——Skill 的调用受主模型性能和上下文影响较大，上下文太杂容易"视而不见"。

情况二：安装命令报错

现象：在对话里说"帮我安装 sophnet-docx skill"，AI 返回一个错误，说安装失败。

排查步骤：

1. 确认 sophnet-skill-installer 已安装（Skill 管理能力依赖它）
2. 确认网络通畅（安装 Skill 需要从 GitHub 或 Sophnet 服务器拉取文件）
3. 检查 Sophclaw 的文件写入权限（安装 Skill 需要写 workspace 目录）
4. 如果是飞书 Skills，先确认飞书机器人已正确接入（飞书 Skills 依赖飞书 channel）

情况三：装上了但调用失败

现象：Skill 显示已安装，执行时出错误或输出不符合预期。

排查步骤：

1. 版本问题：老版本的 Skill 可能有已知 bug。尝试删除后重新安装来更新版本

"帮我删除 sophnet-face-search skill" "帮我重新安装 sophnet-face-search skill"

1. Skill 依赖缺失：比如飞书 Skills 依赖飞书机器人的连接。先确认飞书 channel 在线。
2. 上下文窗口不够：某些重型 Skill（如 stock）需要较大的上下文窗口。在新 session 里试。
3. 配置问题：比如 sophnet-stock 可能需要用户提供 Yahoo Finance API 配置（虽然官方文档说默认用 Yahoo Finance 数据，但有时候需要手动配置）

检查 Skill 装没装对

在对话里问：

"通过 sophnet-skill-installer skill 列出所有已安装的 Skills"

Sophclaw 会列出当前 Agent 已安装的全部 Skills。如果列表里有你想要的 Skill，说明装对了；如果没有，说明安装过程没完成——重新跑安装命令。

Agent 隔离场景下的 Skill 问题

如果你有多个 Agent（比如主 Agent + 飞书 Agent），注意：Skills 是每个 Agent 独立的。在主 Agent 上装的 sophnet-pptx，飞书 Agent 用不了——需要在飞书 Agent 上也装一遍。

这是因为每个 Agent 有独立的 workspace，Skills 安装在各自的 workspace 下。

一个常见的"假没装"场景

有时候你以为 Skill 没装成功，但实际是Skill 已经装好了，只是 AI 选了另一种方式完成任务。比如你装了 sophnet-docx，让 AI 生成 Word 文档，AI 可能：

• 方式 A：调用 sophnet-docx Skill（理想路径）
• 方式 B：不用 Skill，用通用能力直接生成（也能成功，但格式可能没 Skill 生成的专业）

这种情况下 Skill 其实装好了，只是 AI 的调度决策没走 Skill。开一个新 session 明确指定用 Skill：

"用 sophnet-docx skill 帮我生成一个 Word 文档..."

终极解法

如果以上都试过还是不行：

1. 开新 session → 列出已装 Skills → 确认存在 → 明确指定用 Skill
2. 还不行 → 删除 Skill → 重新安装 → 再试
3. 还不行 → 重启 Sophclaw（PC 客户端杀进程重开 / 手机 App 强杀重开）
4. 还不行 → 检查是不是模型选择问题（某些模型对 Skill 调度支持更好，试试 MiniMax 或 Kimi）