Skills 故障排查

状态：通用框架。正式 Skill 发布后将补充具体客户端路径、版本和已知问题。

Agent 找不到 Skill

• 确认 Skill 来自 CrowScout 官方来源；
• 检查安装目录或客户端管理页是否显示正确名称和版本；
• 按客户端要求重新加载；
• 检查 Skill 文件是否完整，而不是只复制了说明片段；
• 确认当前工作区允许加载该 Skill。

Skill 没有自动触发

明确描述任务目标，例如“使用 CrowScout Lead triage 工作流审核这些 Leads”。如果仍未触发，请检查当前 Agent 是否支持 Skill 触发、Skill 描述是否被团队定制覆盖，以及任务是否满足所需输入。

Skill 要求 CrowScout 数据，但无法访问

Skill 本身不等于数据连接。检查它是否需要 MCP：

• 如果需要，确认 CrowScout MCP 已连接且具有只读 Product/Lead 权限；
• 如果不使用 MCP，按 Skill 说明提供经过授权的最小输入；
• 不要把访问令牌或服务端密钥粘贴给 Skill。

输出没有引用证据

停止把该输出用于行动，要求 Agent 重新运行并为每个关键结论提供原帖或 CrowScout Evidence。检查团队定制是否删除了证据要求。

Skill 尝试执行不应自动执行的动作

拒绝执行并检查 Skill 来源、版本和定制内容。官方 CrowScout Skills 不应自动向 Reddit 发帖或私信，也不应在没有明确确认时执行批量写入、启动计量任务或删除数据。

升级后团队定制消失

从团队独立保存的覆盖或版本记录恢复，不要从未知旧包复制整个官方 Skill。比较新版本的权限、输入和确认点后，再逐项迁移定制。

联系支持前准备

只收集非秘密信息：

• Agent 名称和版本；
• Skill 名称、版本和官方来源；
• 是否使用 MCP 以及权限类别，不包含凭据；
• 可复现步骤；
• 已脱敏的错误信息；
• 预期行为与实际行为。