QQ机器人开发全流程指南，涵盖技术选型与官方平台接入。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Qq。 它的用途是：QQ机器人开发全流程指南，涵盖技术选型与官方平台接入。 完整的 Skill 内容见：https://321skill.com/skills/qq-x/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'我正在为我的社区选型QQ机器人，官方API和OneBot我应该怎么选？'，它会根据你的需求（如是否需要最新的Ark卡片消息、对稳定性和审核流程的容忍度）分析两者的优缺点，并提供决策建议。或者问：'QQ官方机器人的WebSocket网关连接总是失败，可能是什么原因？'，它会引导你检查鉴权Token、Intents订阅是否正确，以及网络配置等问题。
介绍
本Skill旨在解决开发者在创建QQ机器人时面临的技术路线选择困惑和官方平台接入流程复杂的问题。它提供了从技术选型到实际上线的完整指引，帮助开发者避开常见陷阱。
Skill通过结构化的文档和指南，引导用户完成从注册QQ开放平台账号、选择Bot API或OneBot生态，到配置WebSocket网关、设置Intents（订阅事件）、处理各类消息（包括Ark卡片）以及实现OAuth2.0登录的全过程。它更像一份详尽的开发手册，而非一个可直接运行的代码库。
它非常适合希望为QQ平台开发聊天机器人、小程序或需要集成QQ登录功能的后端开发者、全栈开发者以及智能体开发者。无论是个人项目还是企业应用，都能从中找到对应的官方最佳实践和社区方案对比。
使用建议：建议开发者按照指南顺序阅读，先明确项目需求（如是否需要官方API的高级功能），再决定技术路线。注意事项：本Skill主要提供指南和思路，不包含可直接部署的完整机器人代码，需要开发者具备一定的编程基础并根据指南自行实现。
核心特点
核心区别在于同时深度对比了QQ官方Bot API与社区OneBot生态的优劣，并提供了从零到一的官方机器人上线全流程实操指南，而非仅聚焦于单一技术栈。
注意事项
不适合需要开箱即用、无需理解底层原理的快速部署场景。
常见问题
QQ官方机器人和OneBot机器人有什么区别？
官方机器人功能新且稳定，但需审核；OneBot生态灵活、社区资源多，但依赖第三方实现。
如何快速开始开发一个QQ机器人？
先根据项目需求（如消息类型、是否需要Ark卡片）选择技术路线，然后参照本指南的对应章节逐步进行。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/qq-x/raw/index.md 读取 Qq 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/qq-x/raw/index.md（查看排版版本）