用途:在 Next.js 项目(App Router 或 Pages Router)中集成 CometChat React UI Kit v6。纯 React(Vite/CRA)、React Router、Astro 项目应改用对应框架技能。
主要能力:围绕两部分展开,一是 cometchat CLI 的确定性脚手架,二是 CometChat 文档 MCP 提供的其余 SDK 信息。CLI 模板已覆盖初始化、登录、生产鉴权、用户管理、主题、挂件与组件替换等;超出这些范围的问题必须查询文档 MCP。
用法:先运行 npx @cometchat/skills-cli@latest detect --json 检测框架,若非 nextjs 则停止。随后确定体验类型:多人会话(1)、单会话(2)或完整信使(3),需询问用户而不假设默认值。接着依次执行 view、apply(--placement dedicated-route)与 verify;apply 若返回 conflict 需原文反馈并仅在用户明确同意时使用 --force,报错不重试、不自动修复。之后运行 npx @cometchat/skills-cli@latest install 安装依赖,CLI 已生成含占位值的 .env.local 并写入 .gitignore,用户需替换 APP_ID、REGION、AUTH_KEY 三个变量。集成路径为 /chat,可访问 http://localhost:3000/chat 验证;新应用自带 cometchat-uid-1 至 cometchat-uid-5 测试用户及测试群组,默认以 cometchat-uid-1 登录。
后续阶段:完成初始集成后可选择主题定制、添加功能、定制组件、浮动聊天挂件、生产鉴权、服务端用户管理、诊断与状态查看等迭代项,并循环展示菜单直至用户选择结束。
限制:不能凭记忆编造 SDK 签名,任何 SDK 参考问题须先查文档 MCP;未安装文档 MCP 时需停下并给出安装命令(claude mcp add --transport http cometchat-docs https://www.cometchat.com/docs/mcp)。初始集成阶段只能由 CLI 写文件,不得手工编辑;文档 MCP 不索引示例应用,相关组件需从 GitHub 示例应用获取。禁止自建搜索 UI,应使用内置 CometChatSearch 及 showSearchBar、onSearchBarClicked 等属性。失败命令不自动重试,错误原文呈现。