SuperAPI AI 工具集

cometchat-troubleshooting

智能体与模型

查看项目

更新于 10-15 20:14

技能介绍

用途:帮助 Claude 系统化地排查 CometChat 集成故障,包括验证检查、漂移检测和按症状查因。

主要能力:运行 cometchat doctor 检查集成状态、环境变量与 AST 校验规则;通过 npx @cometchat/skills-cli verify --json 复核;根据 doctor 已知问题码(如 env-placeholder、env-missing、drift-modified、init-before-login、no-auth-key-in-source、css_variables_imported_once 等)匹配症状与修复;并区分基础设施问题(环境变量、控制台配置、网络)与代码问题(初始化顺序、CSS 缺失、漂移)。

使用方式:先执行 npx @cometchat/skills-cli info --json 判断集成状态;若为部分状态,按提示用 provision、config init 或 state record 恢复。再运行 cometchat doctor 与 verify,失败项查表或查文档。文档查询优先使用 cometchat-docs MCP,其次通过 claude mcp add --transport http cometchat-docs https://www.cometchat.com/docs/mcp 安装,最后直接抓取或搜索 https://www.cometchat.com/docs。修复后重新运行 verify 确认通过。

适用场景:聊天不加载、401 Unauthorized、/chat 空白页、CSS 变量未生效、主题不生效、自定义消息类型不显示等。

限制:文档 MCP 非硬性要求,未安装时回退到公共文档;漂移属定制后的正常现象,不应自动恢复;doctor 通过但界面仍异常时,问题可能在服务端渲染、网络或控制台配置,CLI 无法修复。所有修复前须先向用户展示将变更的内容。