QQ机器人开发一站式指南，涵盖技术选型与全流程实现。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：Qq。 它的用途是：QQ机器人开发一站式指南，涵盖技术选型与全流程实现。 完整的 Skill 内容见：https://321skill.com/skills/qq-x-3/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘我想为我的游戏社群开发一个QQ机器人，用来推送公告和查询游戏数据，应该选择官方API还是OneBot？’ 它会为你分析两种技术路线的优缺点、适用场景和入门成本，帮助你做出决策。接着你可以问：‘选好官方API后，具体怎么注册和连接网关？’ 它会一步步指导你完成应用创建、获取鉴权、建立WebSocket连接以及处理消息的完整流程。
介绍
本技能旨在解决开发者在进行QQ机器人、QQ小程序或开放平台应用开发时面临的技术路线选择困惑和流程不熟悉的问题。它提供了从技术选型到实际上线的完整路径指引。
通过梳理官方Bot API与社区OneBot生态的差异，帮助开发者根据自身需求选择合适的技术栈。同时，详细拆解了官方机器人从注册、鉴权、连接到消息处理（包括Ark卡片等高级消息类型）的全过程，并介绍了QQ小程序与OAuth2.0的接入方法。
该技能非常适合希望快速上手QQ生态开发的初学者、需要为社群或业务搭建自动化工具的开发者，以及希望将服务接入QQ平台的全栈工程师。无论是个人兴趣项目还是企业级应用，都能从中找到清晰的指引。
使用建议：建议开发者先通读技术路线对比部分，明确方向后再按步骤实践。注意事项：官方API与社区协议更新较快，部分细节请以最新官方文档为准，本技能提供的是核心框架和通用流程。
核心特点
核心区别在于同时覆盖了QQ官方Bot API和社区OneBot生态的技术路线对比与选择，并提供了从零到一的官方机器人上线全流程实操指南，而非仅介绍单一技术栈。
注意事项
不适合需要深度定制非标准协议或开发底层通信协议的极客场景。
常见问题
QQ官方机器人和OneBot机器人哪个好？
官方机器人功能新、稳定，但限制多；OneBot生态丰富、社区活跃，但依赖第三方实现。本技能会帮你根据项目需求做选择。
开发QQ机器人需要准备什么？
需要QQ开放平台账号、基本的编程环境（如Node.js/Python），以及了解WebSocket和HTTP API的基础知识。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/qq-x-3/raw/index.md 读取 Qq 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/qq-x-3/raw/index.md（查看排版版本）