cfc/cfc-frontend/docs/geo/agent-field.md

微信 AI（开发模式）接入说明 — 浠艾福

⚠️ 重要前置：微信 AI 开发模式目前处于内测/灰度，官方明确「开发模式代码暂不可提审，切勿合入正式版本发布」。 因此本目录下的 page-meta.json / AGENTS-prompt.md 与下方 agent 字段仅作为提案，须通过开关/分支隔离， 不得进入正式发布构建。自动模式（零改造）可在微信公众平台后台直接开启，无此限制。

1. 前提条件（已满足）

• 全局 lazyCodeLoading: "requiredComponents" 已在 package.json 开启 ✅
• 小程序已上架、已过审、已认证（用户确认）✅
• 个人主体不能上架含 AI 对话功能的版本 —— 需先确认当前小程序主体类型

2. pages.json 需补充的 agent 字段（uni-app 会编译进 app.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. 封装与评测通过后，再决定是否走开发模式，并用开关隔离、勿进正式包