SKILLπ JOURNAL ↗ 工作流

第一次用 AI 写代码,从一个可验收的功能开始

以浏览器里的待办筛选为例,把需求、实现范围和用户可见的验收条件写清楚。

选一个能在本机运行的项目,例如只有待办列表的小网页。第一个改动只做状态筛选。给 Agent 现有目录和一份任务说明,要求它先定位入口、找已有组件和测试命令,再提出需要改动的文件。

把功能写成可观察结果

准备三条待办,其中一条已完成。选择“未完成”时应显示两条,切到“全部”恢复三条。写下空列表时的提示和初始选项。要求保留现有新增、完成和删除功能,把数据持久化等新需求留到后续单独处理。

边实现边核对

让 Agent 复用现有组件。需要排版时用 Frontend Design 整理筛选控件与列表的关系。每次改动后在本机启动页面,检查控制台错误,再用键盘和手机宽度试一次。用 Webapp Testing 把三条验收数据整理成可重复的浏览器检查。

留下能交接的记录

记录启动命令、改动文件、测试输入、实际结果和未验证项。若运行失败,先把第一条报错与复现步骤交给 Agent,再请它提出最小修复。

开始前先确认能运行和能恢复

先用项目原有命令启动页面,在浏览器里走一遍新增和完成待办。记下运行目录、页面地址和已知问题。用 Git 提交或保留一份干净副本作为起点,把私有配置和真实数据放在任务范围之外。若项目现在就无法运行,把启动问题单独处理,记录第一条有效报错及运行时版本。只有基线行为已知,才能判断后续异常是新改动引起还是早已存在。

场景一:生成一小段能读懂的代码

把任务写成一句用户动作和一句结果。“选择未完成后,仅显示没有勾选的待办。选择全部后恢复完整列表。”随后指定数据样例和改动边界:复用现有列表与按钮,新增、完成和删除操作按原有逻辑执行。请 Agent 先列出它找到的列表入口、状态存储位置和现有检查。你可以在编辑器里打开这些文件,确认名称和路径确实存在,再让它实施。

将实现拆为两步。先加筛选控件和可见选中状态,再连接过滤条件。列表为空时应显示与当前筛选匹配的提示;例如“没有未完成的待办”,避免读者以为数据丢失。用 Frontend Design 帮助组织控件层级、窄屏排版和键盘焦点。运行后先看差异,确认 Agent 没有替换应用框架、引入无关依赖或改写数据格式。输出应包含改动文件和可以执行的检查,便于下一步复核。

场景二:从现象定位到可复现问题

假设点击“完成”后,未完成列表仍留下那条记录。先用固定样例复现,记下选中的筛选条件、点击哪条待办、页面实际变化和是否出现报错。试一次切换到全部再切回来。如果记录这时消失,可能是当前视图没有随状态更新;若刷新后仍显示未完成,则检查更新是否写入。把这两次观察分开交给 Agent,请它从事件处理函数追到列表渲染并解释判断依据。

给修复请求限定范围:只处理复现路径对应的状态更新,保留既有存储格式。修改后用三条固定数据复验原问题,并回归新增、删除和清空筛选。Webapp Testing 可在应用已经运行时把这些操作整理成浏览器用例。断言读者能看到的行数和文字,遇到失败保留页面地址、第一处失败与样例数据。若控制台没有错误却出现行为异常,依然按实际结果记录失败。

场景三:用任务清单管理后续改动

把工作分成现在做、等待确认、下次做。当前项只有状态筛选,等待确认可以是刷新后是否保留选择,下次做可以是跨设备同步。每项写出负责人、涉及页面和完成证据。一个小改动通过后先留一份能运行的版本,再开始下一个。计划本身会随证据变化,例如发现持久化影响现有功能时,把它登记为单独任务,说明是否阻断本次交付。

交接记录需要能让同事从干净目录复跑。写下启动命令、修改文件、浏览器访问地址、三条数据、用例结果和未覆盖范围。不要只写“测试通过”,应写清执行过哪一条、观察到哪几个条目。代码改到一半想撤回时,先查看与起点的差异,仅撤回属于当前任务的变更,保留其他人的工作。

一次可以照着跑的验收

先以三条待办启动,其中一条已完成。打开默认页,确认显示三条。选择未完成,确认剩下两条;勾选其中一条,预期列表缩到一条;再选择全部,确认仍有三条且新增的完成状态正确。新增一条待办后检查它是否出现在未完成筛选里,删除测试新增条目后核对数量恢复。最后切到窄屏用键盘走一遍筛选。把预期和实测按步骤记录,下次做排序时复用同一份样例。

常见问题

Agent 生成的代码我看不懂,怎么验收

请它逐个说明改动文件负责什么,用输入、输出和异常解释关键函数。先对照原项目的写法,再跑一条成功和一条边界用例。看不懂的依赖或权限要求记成待确认项,请熟悉项目的同事复核。

页面打开了,但测试还失败怎么办

先确认测试使用的是刚改好的本地地址和相同数据。再看失败发生在定位控件、等待更新还是断言结果。稳定等到目标行或空状态出现后再读数。若数据与需求约定不一致,补一条可复现样例再改代码。

哪些功能适合留到下一版

当功能需要登录、云端存储或外部通知时,先单列数据与权限要求,再定义自己的验收条件。用已完成的小版本继续验证本地流程,等新需求明确后单独排期。

分享文章X ↗LinkedIn ↗

CONTINUE YOUR WORKFLOW

把这篇教程,用到下一项任务。

按明确的技能关联与共同专题推荐;使用条件以详情和原始来源为准。