前言¶
微信小程序要接大模型或 Agent，常见做法是直接搜接口文档、照着示例改。业务还没想清楚时，开发模式与自动模式怎么选、商品和服务数据怎么结构化，往往在编码阶段才暴露问题，返工成本高。
下面介绍 SkillHub 上的社区 Skill「微信AI接入顾问」（@user_3d8b7a24/wechatai）。它把「先别急着写代码」做成固定流程：用自然语言描述业务，由 Agent 按 Skill 指引梳理接入路径，再落到可执行的方案层面。
这是什么¶
「微信AI接入顾问」是基于通用 SKILL.md 格式的 Agent Skill，坐标 @user_3d8b7a24/wechatai，当前版本 1.3.1，来源为 community，分类 ai-agent，发布者为 user_3d8b7a24（SkillHub 页面标注作者 jayhuang007）。标签 requires_api_key=false，表示按 SkillHub 元数据，启用该 Skill 本身不强制配置 API Key。
它面向商家、小程序运营与开发者，解决的是微信侧 AI / Agent 接入前的方案与结构问题，而不是替代微信官方后台或具体云 API 文档。
核心功能¶
以下能力均来自 SkillHub 与已抓取简介，不含未核实的实现细节：
- 接入前咨询：强调微信 Agent 接入应先理清需求与路径，再进入编码。
- 模式选择说明：覆盖「开发模式 / 自动模式」如何选型（与微信 AI 接入常见分工相关）。
- 商品与服务结构化：指导如何把商品、服务等业务数据整理成便于 Agent 使用的结构。
- 按业务出方案：用户用自然语言说明业务后，由 Agent 在 Skill 约束下输出接入方案。
SkillHub 统计（以抓取资料为准）：评分 100000，下载 1346 次。
安装与启用¶
方式一：SkillHub CLI¶
先确认本机是否已安装 skillhub（完整步骤见 SkillHub 安装说明）：
command -v skillhub && skillhub --version
未安装时可执行官方推荐的一键安装（需联网）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装 Skill 时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/，可能不会被识别。在 Cursor 中常用路径为 ~/.cursor/skills/：
skillhub install user_3d8b7a24/wechatai --dir ~/.cursor/skills/
其他客户端路径以官方文档为准，例如 Claude Code 为 ~/.claude/skills/，Codex 为 ~/.codex/skills/ 或项目下的 .agents/skills/。
方式二：让 Agent 按官方提示安装¶
SkillHub 技能页提供的安装提示为：根据 https://skillhub.cn/install/skillhub.md，安装 @user_3d8b7a24/wechatai。可将该句发给已支持 Skill 的 AI 客户端，由 Agent 按文档完成安装与目录校验。
安装或更新后，若客户端要求重启或重新加载 skills 目录，按各自产品说明操作。
典型用法¶
公开页面未提供单独的命令行子工具；典型用法是在对话中启用该 Skill，用业务语言提问。示例仅说明提问方式，具体输出以当时 Agent 与微信侧政策为准。
示例 1：模式选型
我们是一家本地生活小程序，想在客服场景接微信 AI Agent。
请按微信AI接入顾问 Skill，说明开发模式和自动模式分别适合什么、我们更适合哪一种。
示例 2：商品结构化
小程序里有团购套餐和到店服务两类商品，准备给 Agent 做推荐和问答。
请说明商品和服务应如何结构化，并给出接入方案要点。
示例 3：从业务到方案
业务简述：教育类小程序，用户咨询课程与报名，希望 AI 能查课表并引导留资。
先不要写具体代码，请输出微信 AI 接入方案步骤清单。
适用场景与注意¶
适合谁
- 刚接触微信小程序 AI / Agent，需要先理清接入路径的团队。
- 运营或产品能描述业务，但不确定技术选型与数据结构的场景。
- 希望在写代码前统一「模式 + 数据结构 + 方案」的开发者。
限制与注意
- 方案与解释依赖 Agent 对 Skill 的遵循程度，以及微信开放平台、云开发等文档的当期版本；重大变更需自行对照官方文档核对。
- 社区 Skill（community）由发布者维护，升级与兼容性以 SkillHub 上的版本（当前 1.3.1）为准。
requires_api_key=false仅指 Skill 元数据层面；实际调用微信或第三方模型接口时，仍可能需要在各平台单独配置密钥与合规项。
结尾¶
「微信AI接入顾问」把微信小程序 AI 接入里最容易前置却常被跳过的几步——模式选择、业务结构化、方案输出——收进一个可复用的 Skill。若你正在规划微信侧 Agent，可先安装 @user_3d8b7a24/wechatai，用业务描述驱动方案，再进入具体开发。
- SkillHub 页面：https://www.skillhub.cn/skills/user_3d8b7a24/wechatai
- 官方地址：https://api.skillhub.cn/user_3d8b7a24/wechatai
