用 AI 做小工具：怎样检查它真的能用

项目案例 + 交付检查表 · 更新于 2026-10-19
历史项目记录已核对；本文方法为编辑归纳。未重新进行游戏实测或音频听认。

你不必先学会审查每一行代码。先把“我要一个工具”缩成一句可以检查的话：谁输入什么，经过什么操作，应该得到什么结果。本文帮助你做出一张交付检查表，不承诺任何 AI 能一次交出可靠成品。

先准备什么

准备一台能打开工具的设备、一个实际输入样例和一个明确的预期结果。实现与调试可能需要电脑；只有手机也能先写需求和检查表，但本文没有验证手机可以替代完整开发环境。先使用已有工具，不因这张表购买订阅。

总工时、AI 费用和返工成本没有完整历史记录，因此这里不报一个看似精确的“制作成本”。你可以从本次任务开始记账。

第一步：把目标写成能检查的一句话

虚构练习：做一个待办清单，输入一件事后能加入列表，刷新后仍保留。先不加账号、多人同步或提醒。对应三条标准：加入后能看到原文；删除指定条目不会误删其他条目；刷新后保存的内容仍在。三条只是这个练习的标准，不是所有工具的通用数量要求。

如果你说不清怎样判断结果，先补输入和预期，不急着让 AI 开始写代码。

第二步：默认操作通过后，再改一个选择

口琴工具曾出现这样的历史问题：刚打开时，谱面与试听使用同一方案；用户手动换调后，谱面更新了，试听却还读旧方案。这意味着只检查“打开后能播放”会漏掉分叉。

这些数字是音高编号，不是质量分数。对应复审记录日期为 2026-10-09，修复前版本 f826c5f，收口版本 2b73d54。这是受控环境中执行实际生产函数的结果，不代表扬声器声音或游戏实机全部通过。问题已在该轮闭环，不是当前故障公告。

第三步：问测试有没有经过出错的步骤

同一项目曾在“把曲目交给练习会话”的转换过程中漏掉时值字段。后来的一个测试直接把带有时值的数据交给会话，绕开了转换过程。它能证明会话会用这份数据，却不能证明真实入口不会再次丢字段。

给 AI 的检查要求应是：从用户实际入口开始，经过曾出错的步骤，再比较最终输出。修复后暂时撤掉关键修复，对应测试应失败；如果仍通过，就需要检查测试是否真的覆盖故障。这个操作应在隔离测试副本中做，不能在正式站点试。

拿这张表走一次主要流程

不适用的检查写“不适用”及理由。每一项保留实际证据；“438 项通过”这样的数量本身不告诉你具体覆盖了什么。

把投入和返工记下来

下载交付与投入记录表（TXT）。记录实际操作时间、等待时间、订阅或接口费用，以及每次返工的原因；不要用两个提交之间的间隔估算劳动时长。遇到无法定义预期、缺少关键输入或依赖未开通时，先交缺口表，避免循环重写。

复制给你的 AI

我想做的小工具是：【填写】。
使用者和设备：【填写】。现有工具、预算和时间上限：【填写；未知就写未知】。
请先给出一个最小交付目标和三条可观察的通过标准，不要立即扩功能。
列出默认操作、修改选择、退出重进、无效输入中适用于本项目的检查路径。
实现后分别说明：机器检查了什么，浏览器实际操作了什么，还没有验证什么。
每个通过结论附输入、操作、实际输出和证据；不能用测试数量代替行为结果。
修复故障后，测试必须经过曾出错的步骤，并说明撤掉修复时哪个测试会失败。
不要编造工时、费用、用户反馈或真机结果。发现缺口就明确写出来。

依据、局限与下一步

案例来自本站口琴项目的历史复审材料：f826c5f 复审 R1/R2，以及 2b73d54 收口记录。为避免公开内部路径，本站提供了仅含上述事实和原始对照数据的案例证据摘录。这是同一项目的记录，不是多份独立研究。

本文原创部分是检查顺序、练习与记录表。没有完整成本账单，也没有证明这套方法能消除全部故障。下一步先为你自己的工具填一行真实检查记录；如果要展示作品，可继续看把已有技能做成服务样品。

继续查阅：原始资料与使用说明 · 首版范围、实践与勘误