QQ机器人开发全流程指南，涵盖技术选型与官方平台接入。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Qq。 它的用途是：QQ机器人开发全流程指南，涵盖技术选型与官方平台接入。 完整的 Skill 内容见：https://321skill.com/skills/qq-x-2/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我正在为一个游戏社区开发QQ群管理机器人，需要在官方API和OneBot之间做选择，我的需求是能处理图文消息和定时任务，哪个更合适？” 它会引导你对比两种方案在消息类型支持、部署复杂度和长期维护上的差异，并给出建议。接着你可以问：“选择官方API后，如何配置Intents来接收群成员变动事件？” 它会详细解释鉴权流程和所需权限的申请步骤。
介绍
本技能旨在解决开发者在创建QQ机器人时面临的技术路线选择困惑和官方平台接入流程复杂的问题。它系统性地对比了官方Bot API与社区OneBot生态的优劣，帮助开发者根据自身需求做出合适的技术选型。
技能提供了从零到一的完整开发指引，包括官方机器人的注册、鉴权、WebSocket网关连接、Intents配置、消息类型处理乃至Ark卡片等高级功能的使用。对于希望接入QQ小程序或使用OAuth2.0进行用户授权的场景，也给出了清晰的实现路径。
该技能非常适合对QQ生态开发感兴趣的后端开发者、全栈开发者以及智能体开发者。无论是个人兴趣项目还是商业应用，都能从中找到对应的解决方案和最佳实践。
使用建议：建议开发者先通读技术路线对比部分，明确项目需求后再进入具体实现章节。注意，官方API的稳定性高但灵活性可能受限，而社区方案生态丰富但需要自行处理兼容性问题。开发过程中请务必遵守QQ开放平台的相关协议。
核心特点
本技能不仅提供技术实现，更核心的是从决策源头入手，详细对比了官方Bot API与社区OneBot生态的适用场景、优缺点和长期维护成本，帮助开发者避免选型陷阱。同时，它深度整合了官方机器人上线全流程的实操细节，如Intents权限管理和Ark卡片等高级消息类型的应用，这是许多零散教程所缺失的。
注意事项
本技能主要聚焦于QQ官方平台和OneBot标准生态的开发，不涉及其他即时通讯平台（如微信、钉钉）的机器人开发。
常见问题
QQ官方机器人和OneBot机器人哪个更好？
没有绝对好坏，官方API稳定合规但功能可能受限，OneBot生态灵活丰富但需处理兼容性。本技能会帮你根据项目需求（如消息类型、部署方式、合规要求）做出选择。
开发QQ机器人需要准备什么？
需要准备QQ开放平台的企业或开发者账号、一台有公网IP或能进行内网穿透的服务器，以及基本的后端开发知识（如WebSocket、HTTP API调用）。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/qq-x-2/raw/index.md 读取 Qq 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/qq-x-2/raw/index.md（查看排版版本）