返回博客

怎样口述一条边界清楚的 AI 编程指令

先说目标和限制,再粘贴准确的文件与测试信息;提交前核对你允许编程助手做哪些事。

2026年11月12日Whisper One TeamWhisper One Team

你盯着一个设置页面:一出现错误提示,按钮就往下跳。开口解释比打字快,但只说“修一下布局”,编程助手还得猜你想要什么。可以先说清楚看到的现象、希望改成什么样,以及哪些行为应该保留。需要逐字准确的信息,再用键盘补进去。

这套流程是为了在可编辑的输入框里起草指令。Whisper One 负责输入文字,编程助手是另一个工具。加入项目资料或允许它执行操作前,先确认它有哪些权限,以及团队允许你分享什么。

用一段短录音说清现象

先说一件同事能在屏幕上核实的事:“个人资料表单在姓名下方显示错误时,窄窗口里的保存按钮会被挤出屏幕。”如果你只在一台设备上看到,或者只试了一次,也写清楚。先交代什么操作触发了问题,别急着猜哪个组件有错。

再补上希望看到的结果:“窄窗口里还能操作保存按钮,同时错误提示仍然可见。”这样就有两项可以验证。只说“把表单做得好看点”,助手可能会替你做一些你本来没打算交出去的设计决定。

如果问题偶尔才出现,或还不能稳定重现,先把准确操作步骤记下来。怎样口述一份能复现的 Bug 报告可以帮你分清亲眼看到的现象和对原因的猜测。

给助手一个可以照着做的边界

说明哪些事属于这次任务。例如:“查看个人资料表单和它的布局测试,保留现有校验规则和按钮文案。如果看起来必须改共享组件,先说明原因,等我确认后再动。”最后一句交代了遇到什么情况该停下来。

按你真正想授予的权限来措辞。如果在摸索一个不熟悉的代码库,可以先说:“阅读相关文件,提出一个小改动方案,暂时不要编辑。”允许改动时,就说清楚改动范围。验证修复并不等于授权发布。如果工具可以执行上线命令,这一点要明确写在指令里。

说完经过,再粘贴准确的参考信息

文件路径、测试名称、报错文案和允许分享的截图,都从原处复制。如果不知道文件在哪,就请助手查找个人资料表单的路由,别猜一个路径。贴日志时,只保留能说明问题的最短片段,并遵守团队对代码、编号和客户数据的规定。云端语音识别和编程助手是两个不同的服务;发给助手之前,还要按该服务的规则核对一遍。语音输入隐私清单可以用来做录音前的检查。

把参考资料放在指令后面,方便分开复核。最后可以写:“在显示校验错误的窄窗口里验证。确认提示仍然看得见,也能用键盘访问保存按钮。说明实际执行了哪些检查。”知道确切测试命令就粘贴进去;不确定就请助手先找出适用的测试。

提交前通读一遍

读一遍最终草稿,留意“查看”“编辑”“测试”“发布”这些动作:每一个都在你的授权范围内吗?再检查有没有漏掉“不要”。少一个否定词,就可能变成另一件事。最后核对文件名和预期行为,确认它们仍然和你描述的例子一致。

可以先拿一个风险低的小改动练习。用符合要求的 Mac 下载 Whisper One,登录后按快速开始,把目标和限制说进未提交的草稿。补好准确的参考信息,检查后再自己提交。AI 提示词指南也介绍了怎样定位光标和开始短录音。