做一个小功能前,我希望先把“交付时要查什么”写清楚。这份清单适合已有项目和规格、想逐项核对 AI 改动的开发者。
给 AI 一项已有项目的小改动,开始前可以先留一份清单,结束时把每个“预期”补成有证据的状态。读者可以直接复制下面的空表,再按自己的项目填写。
本文依据 implement 的技能说明与 WorkBuddy 适配说明整理。清单是实验室制作的教学模板;商品搜索是新编假设示例,尚未执行,没有模型试用、WorkBuddy 运行或真人验收结果。所有示例行为均为预期。
第一类是可用输入:能读取的规格或工单副本、项目目录、适用项目说明,以及获准使用的脱敏样例。引用了一个读不到的工单时,先补可访问内容,不能猜它要求什么。
第二类是允许改动:写真实路径或模块范围,同时记录原有用户修改。本次范围外的行为也写明;边界不清楚时先确认,不把清单当扩大任务范围的授权。
第三类是可观察行为:说明从哪个已约定的公开接口检查,给定什么输入、做什么操作、应该看到什么。页面、API 或 CLI 均可,关键是沿用当前项目已确认的接口。规则还没决定,就标“待确认”。
第四类是项目已有的检查:从脚本、构建配置、CI 或维护者已确认说明中找来源,记录工作目录、准确命令和覆盖范围。没有读到来源时填“待确认,未执行”,不要凭项目语言编一个常见命令。
任务/规格来源:[可读取的材料;缺失写待补]
可用输入:[项目、说明、样例及必要版本]
允许改动:[真实路径/模块];范围外:[明确排除事项]
原有修改:[实际基线;未取得写明原因]
观察接口:[已约定的公开界面/API/CLI]
验收项:[一条可判断的行为]
输入与操作:[复现条件和步骤]
预期:[事先确认的值或行为]
实际:[检查后填写;没检查写未执行及原因]
证据:[对应文件/日志/截图片段;没有写暂无]
状态:[待检查/通过/失败/未执行/不适用]
缺口与下一步:[还需确认或补做什么]
命令来源:[本项目真实来源的路径与条目]
工作目录:[实际目录或待确认]
实际命令:[从已确认来源填写;未知则待确认,未执行]
退出码:[实际值;未执行就写未执行]
输出证据:[日志与片段;未取得就如实写]
覆盖项:[这次检查能支持哪些验收项]
仍未验证:[未覆盖行为或环境]一条验收项写一组输入、操作与预期。输入不同或检查接口不同,就拆开记录。空白不会自动变成通过;“暂无证据”也不能用一条肯定句补齐。
假定给商品列表增加按名称搜索。演示数据是 P1“红色杯子”和 P2“蓝色笔”,均为虚构样例。规格需要先确认匹配规则,搜索只筛选可见列表,不修改商品数据。
验收项 | 事先确认后才使用的预期 | 当前实际/状态 | 证据与缺口 |
|---|---|---|---|
输入“杯子”搜索 | 若规格确认按名称包含匹配,应只显示 P1,原数据保持不变 | 未执行:教学示例尚未运行 | 暂无;匹配规则、项目与检查接口待确认 |
清空已有查询 | 恢复查询前当前列表及其顺序,搜索本身不改数据 | 未执行:教学示例尚未运行 | 暂无;实际基线与检查待补 |
大小写、空格处理、无匹配提示和跨页搜索等规则如果未写进规格,就保留待确认。本表没有替项目选择它们,也没有声称搜索功能已经完成。
该示例的命令记录应这样填:来源“待确认”;工作目录“待确认”;命令“待确认,未执行”;退出码“未执行”;输出“未取得”。这些字段要等真实项目中实际检查后再更新。
“待检查”表示尚未开始核对。“未执行”应附具体原因,例如项目未提供、接口规则待定或运行时缺失。“失败”保留实际现象与预期的差异。“通过”只用于对应条件确实检查且证据支持的那一行。“不适用”需要说明与本次规格的关系,不能拿它覆盖未知。
检查命令成功,只能支持其实际覆盖的范围;它不自动证明所有界面交互、其他环境或真人体验都通过。截图能支持其中可见的内容,不能代替未取得的运行日志。缺少一段输出时就记录缺失,别补写退出码或结果。
交付时再核对规格与项目规范,并检查本次暂存、未暂存和新文件的实际变化,保留原有用户修改。没有 Git、写入权限或命令能力时,说明缺少的步骤,交付当前能力范围内的提案或文件证据。提交、推送和远端写入仍按任务授权处理。
适用技能是需求实现 implement。下面引用的是 2026 年 11 月 18 日观察到的公开入口与 1.0.2 版本,只说明当日名称和版本核对情况;公开入口可访问不等于宿主执行能力或任务结果已验证。
原技能作者:Matt Pocock;Copyright (c) 2026 Matt Pocock;MIT。阿零的 AI 实验室负责 WorkBuddy 适配与本教学清单整理,内容有 AI 协助。清单字段和示例是实验室的整理方式,不是原作者对任务成功或效率的承诺。
固定上游提交:5beb35b040e3de97e54fa9e386d7e42d15c295c2。复制或再分发技能包时,应保留完整原许可证与版权声明。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。