用微信云开发，将你的小程序快速接入微信 AI 生态

[用户] 在小程序 AI 对话框说："帮我记个待办：买牛奶"
        ↓
[小程序 AI] 理解意图，自动选中你的 addTodo 能力，填好参数 title="买牛奶"
        ↓
[你的代码] 执行写入，返回结构化数据
        ↓
[小程序 AI] 在聊天流里弹出一张你设计的「待办清单卡片」

// index.js —— 传统自建后端方案：必须写中间件维护登录态
const skill = wx.modelContext.createSkill('skills/todo-skill')
skill.registerAPI('addTodo', addTodo)

skill.use(async (ctx, next) => {
// 统一登录态：没 token 就走一遍换登录态流程
let token = wx.getStorageSync('token')
if (!token) {
    const { code } = await wx.login()
    const res = await wx.request({
      url: 'https://your-server.com/login',  // 你自己的后端
      data: { code }
    })
    token = res.data.token
    wx.setStorageSync('token', token)
  }
await next()
})

{
  "lazyCodeLoading": "requiredComponents",
"cloud": true,
"subPackages": [
    {
      "root": "skills/todo-skill",
      "independent": true,
      "pages": []
    }
  ],
"agent": {
    "skills": [
      {
        "name": "todo",
        "description": "待办清单业务",
        "path": "skills/todo-skill"
      }
    ]
  }
}

{
  "apis": [
    {
      "name": "addTodo",
      "description": "新增一条待办事项。当用户说『记一下/帮我记/加个待办』并给出具体内容时调用。",
      "_meta": { "ui": { "componentPath": "components/todo-card/index" } },
      "inputSchema": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "description": "待办内容，取自用户原话（如『买牛奶』）。用户未说出具体内容时禁止填写，应反问『您要记什么待办？』。"
          }
        },
        "required": ["title"]
      }
    },
    {
      "name": "listTodos",
      "description": "查看当前用户的全部待办清单。当用户说『看看我的待办/还有什么没做』时调用，无需任何参数。",
      "_meta": { "ui": { "componentPath": "components/todo-card/index" } },
      "inputSchema": { "type": "object", "properties": {} }
    },
    {
      "name": "completeTodo",
      "description": "把一条待办标记为已完成。",
      "_meta": { "ui": { "componentPath": "components/todo-card/index" } },
      "inputSchema": {
        "type": "object",
        "properties": {
          "todoId": {
            "type": "string",
            "description": "待办唯一标识，必须来自上游 listTodos 返回的 todoId 原值。禁止编造，也禁止从用户自然语言推断；上下文无可用 todoId 时应先调 listTodos。"
          }
        },
        "required": ["todoId"]
      }
    }
  ],
"components": [
    { "path": "components/todo-card/index", "relatedPage": "/pages/index/index" }
  ]
}

// skills/todo-skill/index.js
wx.cloud.init({ env: 'your-env-xxxxxx' })  // 换成你的云开发环境 ID

const skill = wx.modelContext.createSkill('skills/todo-skill')

// 添加待办：写操作走云函数（OPENID 由云开发自动注入，无需登录）
skill.registerAPI('addTodo', async ({ title }) => {
if (!title) return { isError: true, content: [{ type: 'text', text: '缺少待办内容，请反问用户要记什么，禁止编造。' }] }

const { result } = await wx.cloud.callFunction({ name: 'addTodo', data: { title } })
return {
    content: [{ type: 'text', text: `已添加「${title}」，请展示最新待办清单卡片。` }],
    structuredContent: { todos: result.todos }
  }
})

// 查看待办：只读，直接连云数据库
skill.registerAPI('listTodos', async () => {
const { data } = await wx.cloud.database().collection('todos').orderBy('createTime', 'desc').get()
return {
    content: [{ type: 'text', text: `共 ${data.length} 条待办，请展示清单卡片，禁止纯文本罗列。` }],
    structuredContent: { todos: data.map(t => ({ todoId: t._id, title: t.title, done: t.done })) }
  }
})

// 完成待办：写操作走云函数
skill.registerAPI('completeTodo', async ({ todoId }) => {
if (!todoId) return { isError: true, content: [{ type: 'text', text: 'todoId 须来自 listTodos 返回值，禁止编造。' }] }

await wx.cloud.callFunction({ name: 'completeTodo', data: { todoId } })
return { content: [{ type: 'text', text: '已标记完成，请刷新待办清单卡片。' }] }
})

module.exports = skill

// cloudfunctions/addTodo/index.js
const cloud = require('wx-server-sdk')
cloud.init({ env: cloud.DYNAMIC_CURRENT_ENV })
const db = cloud.database()

exports.main = async (event) => {
// ✨ 免鉴权：直接拿到当前用户 openid，无需 wx.login，无需 code2session
const { OPENID } = cloud.getWXContext()
const title = String(event.title || '').slice(0, 100)   // 服务端二次校验
if (!title) return { code: 1, msg: '内容为空' }

await db.collection('todos').add({ data: { _openid: OPENID, title, done: false, createTime: db.serverDate() } })
const { data } = await db.collection('todos').where({ _openid: OPENID }).orderBy('createTime', 'desc').get()
return { code: 0, todos: data.map(t => ({ todoId: t._id, title: t.title, done: t.done })) }
}

// cloudfunctions/completeTodo/index.js
const cloud = require('wx-server-sdk')
cloud.init({ env: cloud.DYNAMIC_CURRENT_ENV })
const db = cloud.database()

exports.main = async (event) => {
  const { OPENID } = cloud.getWXContext()
  // where 同时带上 _openid，确保只能改自己的待办（越权校验）
  await db.collection('todos').where({ _id: event.todoId, _openid: OPENID }).update({ data: { done: true } })
  return { code: 0 }
}

Component({
  data: { todos: [] },
lifetimes: {
    created() {
      this.ctx = wx.modelContext.getContext(this)
      // 监听原子接口返回结果，渲染卡片
      this.ctx.on(wx.modelContext.NotificationType.Result, ({ result }) => {
        this.setData({ todos: (result.structuredContent || {}).todos || [] })
      })
    }
  },
methods: {
    onTapTodo(e) {
      const { todoId, title } = e.currentTarget.dataset.todo
      this.ctx.sendFollowUpMessage({
        content: [
          { type: 'text', text: `完成「${title}」` },
          { type: 'api/call', data: { name: 'completeTodo', arguments: { todoId } } }
        ]
      })
    }
  }
})

<view class="card">
  <view wx:for="{{todos}}" wx:key="todoId" class="item {{item.done ? 'done' : ''}}"
        data-todo="{{item}}" bindtap="onTapTodo">
    {{item.done ? '✓' : '○'}} {{item.title}}
  </view>
</view>

const { OPENID } = cloud.getWXContext()
// 读用户专属数据，天然带权限隔离
const todos = await db.collection('todos')
  .where({ _openid: OPENID })
  .get()