我想为一家教育培训机构做一个“学员成长档案”微信小程序。这家机构一直在用金数据收集学员档案和课程反馈。老师能够持续记录每名学员的课程表现，但家长想了解孩子最近学了什么、有哪些进步、接下来应该练习什么，仍然需要班主任手工整理。
我希望增加一个微信小程序入口：家长输入姓名和手机号完成身份核验，就能查看成长摘要、历次学习记录和教师建议。
打开 WorkBuddy，把目标直接告诉了“小程序搭建 Agent”。
第一步：把业务目标告诉 Agent
第一段对话不需要使用开发术语，只需要说清楚用户、页面、数据和第一版边界。
我先说清楚这次要做什么：
我要开发一个“学员成长档案”微信小程序，使用微信云托管，数据来自金数据。第一版只证明最核心的纵向闭环，不同时加入排课、续费、作业和消息通知。
WorkBuddy 先复述它理解的核心闭环： 家长核验身份 → 查看成长档案 → 查看历次课程 → 打开记录详情。
我确认范围后，WorkBuddy 开始带着我准备项目所需信息。
第二步 Workbuddy 一次只带我准备一项
小程序涉及金数据、微信公众平台和微信云托管，但我不需要先研究所有后台。
Workbuddy 每次只询问一到两项。我已经准备好的内容直接确认；不知道在哪里获取时，它才展开当前这一项的路径。
项目准备按以下顺序推进：
- 确认微信小程序 AppID 和金数据企业版 API Key / Secret。
- Agent 查询云托管服务访问金数据时使用的出口 IP，我将其加入金数据 API 白名单。
- 准备小程序代码上传密钥，并配置执行代码上传环境的 IP 白名单。
- 如果需要企业微信客服，再补充企业 ID 和客服接入地址；不需要可以跳过。
- 选择代码托管和部署方式，并确认微信云托管环境 ID。
整个过程中，API Key、Secret 和上传私钥只保存在项目配置中。Agent 只确认“是否已经配置完成”，不会要求我把敏感值贴进聊天。
我不知道时，Agent 才提供获取入口
我不需要自己先把所有后台研究一遍。轮到某项信息时，如果我不知道在哪里找，Agent 会直接在对话中给出当前这一项的入口和操作路径，等我完成后再继续下一项。
当 AppID、金数据凭证、白名单、代码上传密钥和部署方式全部确认后，项目进入前端交互阶段。
第三步：先做一个可以点击的 HTML demo
正式生成小程序代码前，Agent 会询问我有没有现成的前端 HTML、品牌规范或参考页面。
- 已有前端规范： 我提供 HTML 文件或参考页面，Agent 提取页面结构、颜色、排版和交互方式。
- 没有前端规范： WorkBuddy 根据业务场景生成一个移动端单文件 HTML demo。
这个 demo 使用虚构数据，不连接真实金数据，也不包含任何真实凭证。它的作用是提前确认：
- 页面之间怎么进入和返回。
- 哪些信息放在首页，哪些信息放在详情。
- 列表、卡片、按钮和底部导航如何组织。
- 手机号、状态和隐私说明如何展示。
WorkBuddy 把 HTML demo 交给我预览。我确认页面结构、字段展示和操作流程后，Agent 记录最终页面与字段清单，再进入金数据字段映射。
第四步：用确认后的页面对齐金数据数据源
字段映射不是凭空设计，而是从已经确认的 HTML demo 反推：每个页面需要什么数据，这些数据来自哪张金数据表单的哪个字段。
已有表单：读取现有结构并核对
这个项目已经在使用金数据收集数据。我只需要提供目标表单 token，Agent 就能在授权范围内读取表单和字段结构，再和页面需求逐项核对。
本案例使用“学员编号”关联学员档案与学习记录，使用姓名和家长手机号共同完成身份核验，并只向家长展示发布状态为“已发布”的课程记录。
没有可用表单：确认字段后再创建
如果我从零开始，或现有表单缺少必要数据，Agent 才会提出新建表单或增加字段。
Agent 会先展示表名、字段、类型、必填规则和用途。我确认后，创建或修改操作才会执行。
每个字段都要明确“在哪里、怎么显示”
确认完成后，Agent 产出“数据源清单 + 字段映射表”。这份结果同时约束小程序页面和云托管接口。
最终字段映射包括：
| 页面位置 | 金数据来源表 | 使用字段名称 | 展示与查询规则 |
|---|---|---|---|
| 身份查询 | 学员档案 | 学员姓名、家长手机号 | 两项共同核验，原始手机号不直接展示 |
| 首页档案区 | 学员档案 | 姓名、班级、主修课程、最近更新日期 | 姓名作为主标题，其余作为辅助信息 |
| 首页摘要区 | 学员档案 | 阶段成长摘要 | 使用独立内容区展示 |
| 首页最近课程 | 学习记录 | 日期、主题、亮点、教师建议 | 读取当前学员最新一条已发布记录 |
| 学习记录时间线 | 学习记录 | 日期、主题、课堂表现、学习亮点、作品 | 按日期倒序，只显示已发布记录 |
| 记录详情 | 学习记录 | 目标、亮点、待提升项、建议、作品、教师、更新时间 | 使用连续内容区展示，避免拆成过多卡片 |
| 我的 | 学员档案 | 家长手机号、当前学员 | 手机号只显示前三位和后四位 |
第五步：在本地开发，边看边改
WorkBuddy 根据已经确认的 HTML demo 和字段映射生成小程序页面与云托管服务代码。
代码先保留在本地。我让 Workbuddy 生成预览二维码，再使用真机预览检查真实手机上的字体、间距、导航和安全区。
本案例收到的反馈包括：
- 底部菜单需要补充图标。
- 子页面需要清楚的返回入口。
- 学习记录左侧留白过多。
- 家长端不需要重复显示“已发布”状态。
- 详情内容不应该拆成过多小卡片。
- 姓名与班级之间的距离太大。
- 手机号只显示前三位和后四位。
- 个别图标没有居中。
这些反馈不需要改写成开发任务。我只要描述“哪里不舒服、希望怎么调整”，Workbuddy 就会修改本地代码，再让我重新预览。
如果出现编译错误、接口异常或环境配置问题，我同样可以把完整报错或截图交给 Workbuddy。
第六步：确认后部署云托管并上传体验版
本地与真机预览通过后，Workbuddy 会先说明即将发生的外部动作，再分别请求确认。
部署微信云托管
部署方式在信息收集阶段已经确定：
- GitHub 托管部署： 代码推送到仓库后，由微信云托管触发构建和部署，适合长期维护。
- Workbuddy 使用 CLI 部署： 我确认目标环境和服务后，Workbuddy 调用微信云托管 CLI，替我完成构建与部署。
- 我在控制台手动部署： Workbuddy 生成可部署的压缩包并交给我，我再到微信云托管控制台上传、构建和部署。
云托管服务保存金数据 API 凭证，并按照字段映射读取和转换金数据内容。小程序前端不会直接持有金数据 Key / Secret，也不会接触原始字段 key。
部署完成后，Workbuddy 先检查云托管接口能否读取金数据，再进入小程序代码上传。
上传小程序体验版
Workbuddy 在上传前确认版本号、更新说明和目标小程序。我确认后，Agent 使用已经配置的代码上传密钥上传体验版。
体验版需要再次进行真机回归，确认部署后的接口、页面和本地预览结果一致。
认证、审核和正式发布
体验版验收通过后，由我在微信公众平台完成小程序认证、准备审核材料、提交审核和正式发布。
这部分属于部署后的人工交接，不是 Agent 自动完成的外部动作。
最终效果：家长可以直接查看成长档案
最终效果图来自项目验收阶段。身份查询页中的姓名与手机号已打码，其余页面使用项目测试数据。
第一版最终跑通了完整链路：
- 我没有迁移原有数据，机构继续使用金数据维护学员档案和学习记录。
- 家长在微信小程序中输入姓名与手机号。
- 微信云托管服务完成身份核验并读取金数据。
- 小程序展示成长摘要、学习记录和教师建议。
- 手机号在家长端按规则脱敏。
- 我完成体验版验收后，进入认证、审核和发布。
我与 Workbuddy 是怎样配合的
整个项目始终重复同一种协作方式：
| Workbuddy | 我 |
|---|---|
| 询问当前最关键的一项 | 提供业务信息或完成当前配置 |
| 复述已经理解和收集的内容 | 检查 Agent 有没有理解错 |
| 生成 HTML demo、字段映射或页面版本 | 预览并提出业务反馈 |
| 在写操作或外部部署前说明影响 | 确认是否执行 |
| 根据结果继续修改或排查 | 完成真机验收和最终发布决定 |
不需要我一次性学会所有平台，也不会在信息不足时猜测表单、字段、AppID 或部署环境。每一步都有明确产出，每个产出得到我的确认后才进入下一步。
如果你想提前准备
这些信息不是开始对话前的必备清单。你可以先把业务目标告诉 Agent，等它询问到当前项目真正需要的内容时再准备。
如果你希望提前完成后台配置，可以参考下面三个入口：
微信公众平台：AppID、代码上传密钥和代码上传 IP 白名单
路径：微信公众平台 → 开发与服务 → 开发管理 → 开发设置
这里的 IP 白名单用于小程序代码上传。执行上传的机器出口 IP 需要加入白名单。
金数据：API Key / Secret
路径：金数据 → 右上角头像 → 个人中心 → 个人 API
金数据 API Key / Secret 用于云托管服务访问金数据。实际值应保存在服务端配置中，不要写进小程序前端或公开对话。
微信云托管：环境、服务与部署工具
路径：微信云托管 → 服务列表；CLI 用法见微信云托管的 CLI 指南
环境 ID 和服务名称用于确定部署目标。选择 CLI 路线时，由 Agent 调用 CLI 帮我部署；选择控制台手动路线时，由 Agent 生成压缩包，我再到后台上传和构建。
常见问题
Q1：不会写代码，能完成整个过程吗？
A：可以。整个过程我没有手写代码，但需要能登录金数据、微信公众平台和微信云托管，按 Agent 的指引完成授权、配置、真机预览和发布。遇到编译错误或接口异常时，把完整报错或截图交给 Workbuddy，比只说“打不开”更容易定位。
Q2：为什么要先做 HTML demo，不直接生成小程序代码？
A：HTML demo 使用虚构数据，不连接金数据，也不包含真实凭证，改起来成本最低。页面结构、字段展示和跳转关系在这一步确认清楚，后面的字段映射和小程序代码才有依据，不用推倒重来。
Q3：已经在用的金数据表单需要迁移吗？
A：不需要。我只提供目标表单 token，Agent 就在授权范围内读取现有表单和字段结构，再和页面需求逐项核对，原表结构保持不变。只有现有表单缺少必要数据时，Agent 才会提出新建表单或增加字段，并且要等我确认后才执行。
Q4：Agent 生成的小程序可以直接提交审核吗？
A：不建议跳过验收。至少要完成本地预览、真机预览、体验版回归和敏感信息检查。云托管部署和体验版上传都属于外部动作，Workbuddy 会先说明影响再请求确认；认证、审核和正式发布仍然由我在微信公众平台完成。
结语
我负责说清目标、判断页面是否符合使用习惯，并决定什么时候可以进入下一步。
WorkBuddy 负责把目标拆成当前可以完成的一项：准备接入信息、生成 HTML demo、核对金数据字段、开发页面、处理报错、部署云托管和上传体验版。
金数据继续承担数据收集和管理。我不需要迁移已经积累的业务数据，就能增加一个更适合家长访问的微信小程序入口。
本文涉及：金数据表单 / 金数据 Tables / 金数据 MCP / WorkBuddy / 微信小程序 / 微信云托管 参考文档：金数据开放平台的 MCP Server 说明 · 微信云托管 CLI 指南