文档导航
使用文档 2026-09-03 #AI构建器#指令#最佳实践

给 AI 下指令的模式库:让人和自动化都拿到确定结果

同样的需求,说法不同,AI 的产出质量差别巨大。本篇把高频场景沉淀为可照抄的指令模板:新建、修改、修错、数据导入、跨模块引用,每条都给出推荐措辞、背后发生什么与验收标准。人可以直接照抄,自动化程序也可以按同一契约生成指令。

AI 构建器的输入是自然语言,但好的指令是有结构的。本篇把指令写成模式:每条模式包含适用场景、推荐措辞、执行过程与验收标准。人工照抄即可;如果调用方是自动化程序(RPA、工作流、外部 Agent),按同样的措辞契约通过会话通道发送,也能得到一致的执行结果——这就是「AI 也能照着用」的含义:指令即接口。

一、好指令的四要素

要素说明缺失后果
对象哪个模块、哪张表、哪个页面(新需求可省略)AI 猜错目标,改到别处
动作要新增/修改/删除什么,改成什么样产出与预期偏差
约束必填、唯一、权限、默认值、格式上线后补校验返工
验收怎样算做对了(一条可验证的陈述)无法判断完成

模板句式(对 <对象>)<动作>,要求 <约束>。完成后我会在 <验收方式> 确认。

二、模式库

模式 1:新建模块(从零)

建一个设备台账模块:字段有设备编号、名称、所在车间、责任人、购入日期、原值。
编号必填且唯一;车间做成下拉选择;列表支持按车间筛选、按购入日期倒序。
做完后我在测试环境新建一条数据并按车间筛选验证。

要点:字段用业务语言列举即可,类型 AI 会推断;约束当场说清。有存量表格时改走 Excel 流程(见用 Excel 一步建模块),数据结构与数据一次到位。

模式 2:修改字段/页面

(对设备台账)列表加一列「保养状态」:超过保养周期未保养显示红色「逾期」。

要点:以括号开头指定对象(也可用 #设备台账 引用模块);改动只说一个主题

模式 3:修运行时错误

修复问题:测试环境打开设备台账列表,按车间筛选后点第二条数据的编辑,表单里车间显示的是代码不是名称。

要点:给复现步骤(打开什么、点什么、期望 vs 实际)。错误账本里已有记录的问题,可直接说「修复错误账本里的全部未解决项」(见修改与编辑模块的错误账本一节)。

模式 4:跨模块联动

#设备台账 的「责任人」改成从 #客户管理 的联系人列表选择,保存时只校验 id 存在。

要点:用 #模块名 把两个模块同时带入上下文;明确数据流方向(谁引用谁)。

模式 5:指定执行角色

@前端开发 把设备台账的新建表单改成两列布局。

要点:普通需求不需要指定;当你明确只想动某一端时,@ 指定可减少不必要的全链路执行。可指定的角色见操作手册的 @ 下拉说明。

模式 6:带图实现

(粘贴设计稿/手绘图)按这张图实现设备台账的列表页,字段以图为准,数据用现有模型。

要点:Ctrl+V 直接粘贴;说明图中没有的信息(数据来源、权限)。

三、反例改写

模糊说法改写后
把列表弄好看点列表按状态列着色:在用=绿、停用=灰;行高收紧
加个导出加导出按钮,导出当前筛选结果为 Excel,含表头
有 bug 修一下(按模式 3 给复现步骤)
和客户管理打通#设备台账 的责任人从 #客户管理 的联系人选择(按模式 4)

规律:把「形容词」换成「可验收的陈述」。

四、多轮迭代协议

复杂需求不要试图一句话说完,按固定节奏推进:

  1. 拆分:把需求拆成可独立验收的子项,按优先级排序;
  2. 逐轮下达:每轮一个子项,等 AI 交付(预览自动刷新)再进下一轮;
  3. 即时纠偏:发现理解偏差立即插话纠正,不要攒到最后;
  4. 验收记录:每轮验收通过后,下一步指令里可以引用上一轮结果(「刚才加的保养状态列保留,继续…」)。

五、自动化调用的附加约定

自动化程序(而非人工)驱动构建器时,在上述契约之上再加三条:

  • 幂等标识:指令开头带上任务标识(如 [task:eq-20260903-01]),便于在会话历史中对账;
  • 一轮一验收:每条指令发出后,等待 AI 交付完成信号并检查错误账本归零,再发下一条;失败则重发同标识指令并附「重试」;
  • 终态判定:以「预览可通过指定路径打开 + 错误账本无未解决项」为完成标准,不要以 AI 的文字回复为完成标准。

六、注意事项

  • 不要下达技术实现指令:「建两张表做中间映射」这类说法会限制 AI 的方案空间;说业务目标,实现交给 AI;
  • 敏感操作会二次确认:删除字段、删除模块、覆盖生产数据等指令,AI 会停下来要求确认,自动化流程需预留确认应答;
  • 指令里不要出现账号密码:任何情况下不要把凭据写进对话;
  • 发布相关指令(挂载菜单、正式上线)统一走工作台的「发布」按钮而非对话,人工确认不可省略(见模块的测试与发布)。
一句话,上线一个业务系统 — 照着做卡住了?直接问我们。
咨询热线 / 微信同号 15552251270
进入演示环境