用 WorkBuddy 做微信小程序:从需求分析到发布上线

0 评论 448 浏览 0 收藏 25 分钟

Vibe Coding 做简单需求很快,复杂需求却容易反复拉扯、把已做好的功能改坏。一套可复制的开发范式把关键决策前置交人工确认,并借助微信开发者工具的 Skill 让智能体自己编译、截图验证、读控制台报错,覆盖从需求分析到发布上线的全过程。

做过Vibe Coding 的同学都应该清楚,通过简单的自然语言提示词,就能把一个简单的需求实现出来。

但如果做一些复杂的需求,就会遇到一个问题:Demo 出来确实很快,但后面打磨起来非常费劲。

然后就跟 AI 反复拉扯,改完这里,再改那里,甚至把之前已经做好的功能也改坏掉了,还还不了原。

这里主要有两个原因:

  1. 需求没想清楚,就让 AI 开始写代码了。很多需要我们自己决定的事情,默认交给了AI,最后做出来不符合预期,也不能怪 AI不懂你。
  2. AI 写完以后,没有充分验证结果。尤其是小程序开发,Agent如果不操作微信开发者工具,就不知道代码编译有没有通过、页面显示成什么样、接口请求报什么错。

对于第一个问题,我在之前的文章里分享过我日常的开发范式:先提出需求、再对需求进行可行性分析、方案设计、出高保真原型、然后编码实现、最后人工验收。这里的核心是把关键决策前置并交给人工来确认,而不是先许愿,等着开盲盒,后面发现不对,又重新许愿。

对于第二个问题,可以借助微信开发者工具提供的 Skill 来解决。安装以后,Agent 就能操作微信开发者工具,自己启动编译、看模拟器运行效果、截图验证、读取控制台及网络日志,如果遇到问题就再继续调整。

今天分享下我日常开发微信小程序的流程和工具,完整走一遍从需求到上线的过程。

我们先看需要需要准备的工具和平台:

  • WorkBuddy / Codex / Claude Code 任选其一
  • 微信开发者工具Nightly版本/ 微信开发者工具 Skill
  • 腾讯云CloudBase
  • Git版本管理
  • 微信公众平台
  • 腾讯云AIGC 检测API
  • Skills: Grill with Docs / Baoyu-Design

大家不用担心工具太多,跟着步骤来就行。用到什么工具,我们再介绍它是干什么的、怎么安装、怎么使用。

很多配置都是一劳永逸的,弄好以后,后面开发其他小程序都能复用。

从一个想法开始

先说一下做这个需求的背景。

起因是在朱雀文本检测工具上使用时,会频繁弹图形验证码,并且每天都有使用次数的限制,当然我知道平台是为了限流和防刷,但是体验感不太好。

基于这样一个痛点就产生了自己做一个检测工具的想法,并且我想做成微信小程序。

创建开发项目

我们使用 WorkBuddy 作为开发工具。

它是整个开发过程的执行主体,后面的需求分析、方案设计、写代码、调试和验证,都交给它来完成。

当然,也可以换成 Codex、Claude Code 或其他 AI Coding 工具,底层开发思路是一样的。

先从官方渠道下载并安装 WorkBuddy,这里就不多说了。

安装完成后,在电脑上创建一个独立文件夹,作为项目目录,比如:ai-detection-miniapp

Windows 用户注意不要选择C盘,因为后面生成的文档、原型和代码文件都会放在这个目录里面,尤其是项目依赖文件会很大,挤占C盘有限的资源空间。

然后打开 WorkBuddy,新建任务,选择开发模式,并把前面创建的文件夹选为工作空间。

模型这里我选择 GLM5.3,开发应用尽量使用编程能力好一点的模型。虽然贵一点,但可以减少很多来回沟通、调试和修复的成本。

另外把权限设置为允许完全访问,不然你得频繁的点击允许;

现在开发环境就准备好了,我们开始第一项任务。

让 Agent 判断可行性

可行性分析通常看两个层面:

  1. 这个功能值不值得做?
  2. 技术上能不能实现,成本结构是怎样的?

工具的价值层面我已经判断了,它是基于我的痛点出发的,值得做,所以重点看技术上怎么实现。

于是我直接通过语音转文字,把需求告诉 WorkBuddy,让它帮我分析性可行性,以及有哪些实现方案。

它分析完给出的结论是可行,并给出了成本最低的解决方案,我快速扫描了一遍:它建议的是用腾讯云AIGC 检测API,跟现在用的朱雀平台是同源的,然后基于这个API做自己的应用。

因为这里核心是检测能力,能跟之前的保持一致当然是最好的,有了这个判断,我觉得这个方案是可以的。

注意这里的模式:Agent 做分析和罗列方案,人做最终判断和拍板。

这就是“人在关键路径确认”的含义,我们不需要自己研究每个技术方案的全部细节,但至少要知道 Agent 准备怎么做,是否符合自己的预期。

把需求说清楚,输出设计文档

确定了可行性和技术方向,下一步不要着急写代码,继续让 Agent 做详细的需求设计文档。

这里会用到一个 Skill,叫 Grill with Docs,这个 Skill 可以通过不断追问,让我们把很多没有想清楚的问题逐步补充完整,再将确认过的内容沉淀到文档中。

安装完成之后,使用这个Skill 执行需求文档设计。

我这里有必要解释下为什么要让Agent输出设计文档:

在传统开发流程中,文档通常是团队中的一种负担,没人愿意写,写完就过时了,大家也不看,并且维护的速度永远跟不上需求变化的速度。

但现在执行的主体变成了Agent,文档恰好变成了人和Agent、Agent和Agent之间最重要的信息沟通媒介,原因如下:

第一,Agent 把方案写成文档,我们可以通读一遍,看方向对不对,有问题可以直接在文档上改。

第二,每一个 Agent 会话的上下文窗口是有限的,从设计进入开发实现,通常会开一个新的会话。那么前一个会话的思考过程、决策依据、技术方案,都需要通过文档传递给下一个 会话,没有文档,下一个会话就会从零开始。

这个也很好理解,大模型本身是没有记忆的,但它怎么知道我们之前聊过什么呢?

是因为每次对话,我们都把聊天的历史记录都给它了。但是要持久化记忆、或者夸会话记忆,就需要把这些内容放入文件中去,后续执行时把文件中的内容读出来放入上下文中就可以了。

有了需求设计文档,无论我们是新开一个会话,还是换一个Agent执行,都不需要重新给Agent解释来龙去脉,只需要一句话:“按 docs/xxxxx.md 实现”。

再做高保真原型,确认是不是自己想要的

方案设计完之后,仍然不要着急进入代码开发,下一步做高保真原型设计。

为什么要多做这一步呢?

因为设计文档再详细,它终究还是文字,对于界面交互的表达还是不够具象化。

比如我说“我要一个简洁、美观的检测页面”,AI 对简洁、美观的理解,未必跟我理解的一样。

所以我更喜欢先把界面做出来,直接看到它最终长什么样,交互是否符合自己的预期。

这里就会用到第二个 Skill:Baoyu-Design,它是一个高保真原型设计 Skill。

安装完成之后,利用这个Skill,基于前面的设计文档做高保真原型设计。

如果对任何交互或界面设计有不满意的地方只需要用自然语言描述我想要什么变化,AI 很快就能完成原型修改。在这个阶段调整的成本是最低的,因为它的原型是通过 HTML 文件实现,只有交互和UI,没有真实的业务逻辑。

如果等开发完成,在来修改的成本会呈指数级上升。不仅要改代码逻辑,还要改样式、改状态管理、改测试用例。但在原型阶段,改一个布局可能就是一句话的事。

所以这个阶段值得花时间反复打磨的。

注意这里做出来的原型,不是粗糙的线框图,而是接近最终成品的高保真设计,直接包含了交互逻辑和UI界面设计,它整个界面是可以交互的,包含空状态、处理中、检测结果、异常情况等状态的界面交互。

这在传统开发流程中基本很难做到,因为成本太高了。

开始开发微信小程序

现在,我们已经有了需求设计文档和确认过的高保真原型。接下来就可以正式进入编码开发了。

但是开发微信小程序,跟开发普通的 Web 网站有一点不同。

普通网页可以直接通过浏览器运行,而小程序需要使用微信官方提供的开发工具进行编译、运行和调试。

所以这里我们要引入两个新东西:微信公众平台和微信开发者工具。

注册微信小程序账号

进入[微信公众平台,按提示注册小程序账号,根据自己的实际情况选择主体和服务类目。

这个地方不要随便选,因为后面能用哪些能力、需要提供哪些材料,跟主体和类目是有关系的。如果你一开始不确定,就先选工具类目。

注册完成后,在后台开发管理相关页面找到 AppID,AppID 可以理解为这个小程序的唯一标识,这个在后面会用到。

微信公众平台主要用于管理小程序账号、成员权限、体验版本,以及后续的审核和正式发布。

现在我们只需要拿到 AppID,其它的等到发布阶段再操作。

安装微信开发者工具

接下来去微信开发者工具的官方下载页面,下载并安装开发工具,注意选择Nightly Electron Build 2.02.2607032 及以上版本,只有Nightly版本才支持导出微信开发者工具Skill。

微信开发者工具是用来运行和调试小程序的,代码写得对不对,编译能不能通过,页面显示有没有问题,都需要通过这个工具来看,就好比我们开发web网页应用的时候,需要用浏览器来预览页面一样。并且后面真机预览、上传代码、版本发布,也会用到它。

安装完成后,打开微信开发者工具,并用自己的微信账号完成登录,并选择小程序。

这里我们点击右上角的导入按钮,然后选择Workbuddy中小程序项目空间目录,此时需要填入前面步骤拿到的AppID。

填入AppID后,点击创建,只不过我们现在项目中还没有生成代码,打开后看到的是一个启动失败的界面。

这里还有一个问题。

我们使用 AI Coding 开发微信小程序的时候,AI 写完代码,我们还要手动打开微信开发者工具,点编译,看报错,再把错误日志复制给 AI,让它继续修复,整个过程挺麻烦的。

不过,现在可以通过微信开发者工具 Skill,让 Agent 自己去完成这些操作。

这里安装方式有点特殊,在开发者工具菜单栏找到 复制Skill 安装提示词这个按钮。

然后粘贴到workbuddy任务中安装 Skill,注意我这里是Mac,路径跟Windows不一样。

安装过程中可能会提示让打开开发者工具的服务端口,操作如下。

让Agent执行编码任务

走到这一步,我们已经有了设计文档和确认过的高精度原型,那么让 Agent 写代码,对于现在的模型来说,就是一件非常简单的事情,这一步也是最不需要我们操心的了。

把设计文档和高保真原型一起发给Workbuddy,让它按照文档去执行,它会按照顺序依次编写代码、运行测试用例、打开开发者工具截图验证结果。

自动打开开发者工具这里,就会用到我们前面安装的微信开发者工具Skill,Agent 就可以通过这个它打开开发者工具自动运行项目,模拟人工进行交互。如果遇到报错,它也会自动从控制台获取错误信息并进行自我修复。

编码完成后,根据提示完成如下操作:

点击微信开发者工具右上角的云开发按钮,可以开通免费版本,试用 6 个月时间。

CloudBase 有很多能力,包括云数据库、云函数、文件存储、静态站点部署、大模型调用等能力,用它非常省事,不需要单独买服务器,自己安装数据库和配置运行环境,对新手来说能省掉不少事情。

到这里就拿到CloudBase 的环境 ID了,下面继续执行。

人工验收

agent 完成任务后,虽然它会自己也会写测试、跑用例、做截图验证,但我们也不能完全信赖它的结果,人工还是要做一次验收兜底。

因为我们前面提供了高保真原型设计,所以这里实现出来的样子基本上是百分之百还原,我们主要是验证它的一些功能逻辑和异常边界是否处理正确了。

如果遇到报错或其他异常,直接把错误信息反馈给 Workbuddy,让他修复。

在验收过程中,只遇到两三个小的交付细节,让他修复了一下,之后基本完全可用了。

版本管理

如果我们的小程序打算持续迭代,一定是离不开代码版本管理的,当然做版本管理我觉得最核心的点是,防止AI把之前做好的功能改坏了还不了原,因此随时做好版本记录,以便可以回退。

这里就需要用到Git,这个去可以让Workbuddy帮我们安装。你可以这样跟它说:

帮我在本机安装Git,并引导我完成初始化设置

我们只需要提供用户名称和邮箱地址,配置完成后,就可以让他把当前项目初始化为一个git仓库。

初始化完成后,它自动帮我们进行了版本提交。

那么后续有任何文件的修改,我希望Workbuddy能自动帮我记录版本,而不是每次都口头交代一次。这里可以利用Workbuddy的记忆规则来完成自动化提交,在当前项目路径下创建.workbuddy/memory/MEMORY.md文件,然后设置如下内容:

## 协作约束

– 每次会话完成后,自动帮我提交代码,提交信息根据当前修改的主题生成

设置完成后,会话完成后一旦有代码变动,就会自动生成版本记录了。

那怎么查看已经提交了哪些记录呢?最简单的方式就是直接问Workbuddy:

这里我们可以看到有三个版本记录,如果我想回到第二次提交的版本,直接跟Workbuddy说:

帮我把代码回退到 31ef608 这个提交

掌握这些基本操作,基本就够用了,确保能在你电脑本地做好版本记录,以便随时可以回退。只有当你需要多人协作或者多台设备同时编码,才需要把代码提交到远端仓库,比如github、gitee等平台上去。

把小程序发布上线

到这里,小程序已经开发完成,并且经过了初步验收。

但是它目前还只是一个开发项目,其他普通微信用户并不能直接搜索使用,所以最后一步,是把代码提交到微信平台,经过审核后正式发布。

这里会用到前面安装的微信开发者工具,以及注册过的微信公众平台。

先在开发者工具中使用上传功能,将当前版本的代码上传到微信公众平台。

代码上传以后,可以在微信公众平台的版本管理页面查看开发版本,并设置为体验版本。

体验确认无误后,按微信公众平台的流程提交审核,通过后正式发布。

至此,一个从需求分析、方案设计、原型制作,到编码、调试、验收和上线的小程序,就真正跑通了。

以后增加功能,在现有项目上继续迭代即可。

每次增加功能前,建议先更新需求文档、确认变更范围,并提交好 Git 版本。

这样即使后面改出了问题,也可以随时回退。

总结

回过头来看,整个过程里,并不是把想法扔给Agent,就啥都不管了。

从判断做这个工具是否可行,到确认方案、打磨原型,再到最后验收,每一步我都参与进去了。只不过我参与的方式,变成了表达需求、确认方向和判断结果。然后把过去需要专业人员才能完成的事情,都交给Agent。

工具会变,模型会变,但这套做事的方法,我认为是不会那么容易过时。

以后遇到新的需求,我们依然可以按照这个流程,把想法一步步实现出来。

对于大多数人而言,没必要一上来就想着做一个多么复杂的产品,就从工作中的小麻烦开始。把你的场景、现在的做法,以及希望达到的效果,直接告诉Agent。

先让它判断可不可行,再确认方案,必要时做个高保真原型,然后让它编码实现,最后自己验收。

核心是把需要人工判断、确认的问题尽量前置,把执行工作交给 Agent。

本文由人人都是产品经理作者【叶小钗】,微信公众号:【叶小钗】,原创/授权 发布于人人都是产品经理,未经许可,禁止转载。

题图来自Unsplash,基于 CC0 协议。

更多精彩内容,请关注人人都是产品经理微信公众号或下载App
海报
评论
评论请登录
  1. 目前还没评论,等你发挥!