# 微信 AI(开发模式)接入说明 — 浠艾福 > ⚠️ **重要前置**:微信 AI 开发模式目前处于**内测/灰度**,官方明确「开发模式代码暂不可提审,切勿合入正式版本发布」。 > 因此本目录下的 `page-meta.json` / `AGENTS-prompt.md` 与下方 `agent` 字段**仅作为提案**,须通过开关/分支隔离, > 不得进入正式发布构建。自动模式(零改造)可在微信公众平台后台直接开启,无此限制。 ## 1. 前提条件(已满足) - 全局 `lazyCodeLoading: "requiredComponents"` 已在 `package.json` 开启 ✅ - 小程序已上架、已过审、已认证(用户确认)✅ - 个人主体**不能**上架含 AI 对话功能的版本 —— 需先确认当前小程序主体类型 ## 2. pages.json 需补充的 `agent` 字段(uni-app 会编译进 app.json) ```json { "lazyCodeLoading": "requiredComponents", "subPackages": [ { "root": "skills", "independent": true, "pages": [] } ], "agent": { "skills": [ { "name": "family-task", "description": "家庭任务管理:创建、查看、完成家庭任务,按成员与周期管理。", "path": "skills/family-task-skill" } ], "instruction": "docs/geo/AGENTS-prompt.md", "pageMetadata": "docs/geo/page-meta.json" } } ``` ## 3. SKILL 封装硬约束(来自官方最佳实践) - 每个 SKILL 必须放在**独立分包**(`independent: true`),全局开启 `lazyCodeLoading` - 一个小程序**最多 30 个 SKILL** - `SKILL.md` ≤ 16000 字节;`mcp.json` ≤ 24000 字节(去 outputSchema + 空白后) - 不含越狱语句;method 名逐字一致;不规定回复格式;必须用 Markdown 完整呈现关键信息 - 信息源注意力权重:`content`(★★★★★) > `mcp.json.description`(★★★★) > `inputSchema.description`(★★★★) > `SKILL.md`(★★★) ## 4. 落地步骤(建议) 1. 后台先开**自动模式**(零改造,接受首页/运营位可能被跳过) 2. 评估是否在独立分包封装 1–2 个高频原子能力(家庭任务、成长测评查询) 3. 封装与评测通过后,再决定是否走开发模式,并用开关隔离、勿进正式包