用途:在 React(Vite 或 Create React App)项目中集成 CometChat React UI Kit v6。触发场景包括“给 React 应用加 CometChat”“在 Vite 中集成 CometChat”等,也可通过 /cometchat 或 /cometchat 1/2/3 调用。若项目使用 Next.js、React Router 或 Astro,应改用对应的其他技能。
主要能力:技能本质是薄胶水层,一方面调用 cometchat CLI 做确定性脚手架,另一方面通过 CometChat 文档 MCP 获取组件属性、回调签名、请求构建方法、SDK 事件、CSS 变量名、错误码含义和后台激活步骤等信息。要求始终先查文档 MCP,禁止凭记忆编造 SDK 代码;若未安装文档 MCP,需停止并提示用户安装,不降级到 LLM 记忆。CLI 模板覆盖 init/login/render 路径,以及 apply-feature、apply-theme、add-widget、add-user-mgmt、production-auth 等步骤。
使用方式:依次执行检测、确定体验、预览、应用、验证、安装依赖。关键命令包括 npx @cometchat/skills-cli@latest detect --json、view --experience N --framework reactjs --json、apply --experience N --framework reactjs、verify --json、install。三种体验为多会话(1)、单会话(2)、完整信使(3)。若检测到框架非 reactjs 或项目为纯 JavaScript(.jsx,使用 npm create vite@latest -- --template react 创建),因 v6 模板仅支持 TypeScript,须停止并给出改用 react-ts 模板或先转换为 TypeScript 的选项,等待用户选择。
验证与限制:应用后按状态处理(applied、already-applied、conflict、error),错误信息如实呈现,不重试、不自动修复;仅在用户明确确认时才建议 --force。安装依赖为幂等操作。最后需在 .env 中替换 VITE_COMETCHAT_APP_ID、VITE_COMETCHAT_REGION、VITE_COMETCHAT_AUTH_KEY 的占位值,并参考 https://www.cometchat.com/docs/ui-kit/react/overview。后续 Phase B 自定义需先重读 .cometchat/state.json 项目状态,优先查阅查找表、包内 TypeScript 定义与 v6 示例应用,保持示例应用的原 BEM 类名与完整 prop 接口,仅剥离上下文和本地化等少数内容。具体收费、价格与平台支持细节暂未提供。