Skill、MCP、Plugin 与 Hook 排查
按下面的现象排查。保留错误原文，但分享前移除账号信息、凭据和私人任务内容。不要一开始就重新安装：插件安装后，仍可能需要连接服务、启用 Skill，或批准具体操作。
Skill
找不到或不触发
- 打开 插件 → Skills，清空搜索，选择 全部 Skills，关闭 已归档。
- 找到 Skill 并打开详情。同名项目要展开来源标签，核对文件路径。
- 检查 在 Ghast 中启用。插件提供的 Skill 还需检查所属插件是否已安装并启用。
- 刚添加或编辑本地 Skill 时，点击 刷新 Skills。目录应包含
SKILL.md，并具有有效的名称与说明。 - 需要明确测试时，选择 立即试用，补充一个符合指令的小任务。它会创建新草稿，先检查再发送。
- 查看回复和工具结果。启用表示可用，不代表每条消息都会调用该 Skill。
归档的 Skill 需要先开启 已归档，找到项目并选择 恢复，再检查启用状态。完整步骤见管理 Skills 库。
依赖失败
从失败的工具结果中确认缺少哪个程序或命令。安装前核对 Skill 指令与平台要求，使用发布者说明中的安装方法，不要直接运行错误消息提供的陌生安装程序。求助时提供程序名、操作系统和脱敏后的错误，不要提交整个任务历史。
MCP
连接失败
- 打开 插件 → 管理连接，找到对应服务。
- 阅读连接诊断。命令不存在或进程退出通常指向本地安装；未授权响应指向凭据；超时可能涉及网络或服务地址。
- 插件连接使用 连接 或 重新连接，并确认所选账号。
- 自定义服务器打开设置，将传输方式、命令或 URL、参数和所需凭据与发布者说明逐项核对。
- 修正具体问题后重新连接，再测试一个只读请求。
自定义服务器编辑界面可能显示已保存的凭据，截图时不要暴露环境变量值或请求头。具体配置见添加 MCP 服务器。
Connected 但没有 Tool
- 确认当前模型支持工具。
- 明确指定服务及只读动作。不要在添加菜单中寻找服务器分组：当前输入区没有工具选择器。
- 确认所属插件启用、服务器已连接。
- 在 管理连接 中检查工具变更提醒，按下文进行审查。
- 重新连接后，检查已有部分结果，再重试小范围只读请求。如果只有资源，服务器本身可能没有提供工具。
连接成功不代表具体调用成功。首次调用步骤见使用 MCP 工具。
服务器更新后工具暂停使用
打开 插件 → 管理连接，找到工具变更提醒并选择 审查。比较前后的说明和输入参数，确认是否改变账号或数据范围、新增写入动作，或修改重要默认值。
理解变化后再批准。无法解释时，保留暂停状态并联系发布者。批准只接受这一版工具定义，不代表授权之后的每次操作。详见审查 MCP 访问与变化。
Plugin
安装失败
- 阅读安装错误，检查目录是否标明不兼容。
- 在插件库点击 刷新，再打开详情。
- 目录或安装包无法下载时，检查网络、代理及来源地址。
- 使用 本地安装 时选择插件根目录，不是上级目录或单个 Skill 目录。
- 错误指出清单无效或缺少文件时，请作者提供修正的安装包。插件作者可查阅包格式参考。
修正原因后再重试。不要为修复安装包错误删除对话、更换凭据或移除无关插件。
已安装但对话中不可用
打开插件详情，分别检查插件启用状态、各 Skill 开关和应用连接。安装不会自动登录外部服务，单个 Skill 开关也不会启用整个包的其他能力。
尝试提供的示例提示词，检查生成的草稿后发送一个小型只读任务。工具仍未出现时按上面的 MCP 步骤排查；工具执行失败时，阅读其错误并检查是否已产生部分结果，再决定重试。详见浏览、安装和使用插件。
插件 Hooks
先阅读使用插件 Hooks。确认插件已启用、所需运行环境已安装，且插件自身模式允许预期行为。关闭 Skill 或不使用 @提及，都不会停止已启用插件的 Hooks。
如果错误提示插件阻止了请求，阅读原因并满足前置条件。如果发送缓慢或缺少指导，请作者检查命令失败和超时。超时会在不添加该命令上下文的情况下继续，不是策略性阻止。
作者应按编写插件 Hook检查事件、matcher、命令路径、标准输入和输出。先使用无副作用命令测试。不要在问题报告中粘贴私人消息或凭据。
作用域和上下文
在当前对话中只选择任务需要的 Skills 和 Tools。不要只是为了缩短一个对话就断开共享账号。打开输入区旁的 上下文用量；历史过长时按管理上下文压缩处理。提及插件有助于选择能力，但不是排他的权限边界。