Prompt 工程 · 怎么写让 AI 少犯错

核心不是背语法，是把意图写成可执行的 Spec——也就是下面这类「给 AI 的 Prompt」。

AI CODING · Prompt

目标 + 范围 + 契约 + 验收。缺一就容易假完成。需求糊时先澄清，不要直接开写。

产出 可粘贴 Prompt节奏 先复述再改

看骨架 →

本节要点

• SPEC 五层：需求 / 设计 / 开发 / 验收 / 运维
• 需求糊时先用澄清 Prompt，再开写代码
• 通用「给 AI 的 Prompt」骨架与纠错骨架

核心原则

1. 目标一句 + 约束几条 + 验收几条
2. 一次一事 — 禁止「顺便重构和测试」
3. 契约优于文案 — 字段/事件 > 好看
4. 上下文用 @ — 规范与邻居文件；别整仓
5. 先复述再动手 — 你点头后再生成

SPEC：指导生成的契约总和

层	最少写清	出现在哪
需求	谁、主路径、不做啥	场景一 PRD / 澄清卡
设计	页面职责、API 字段	场景二·三
开发	允许/禁止文件、命名分层	每张给 AI 的 Prompt
验收	怎么点、哪条 curl	【验收】
交付/运维	启动、健康检查	部署 / 场景四

Spec Coding = 先把上表写进对话或文档，再让 AI 写代码。

需求还糊时：先澄清，别直接开写

给 AI · Prompt · 需求澄清（写代码前）

【角色】你是需求分析澄清助手，不要直接写业务代码。

【原则】
- 主动澄清模糊点；按功能 / 边界 / 约束拆
- 明确写出你的假设，让我确认
- 完整性：谁、做什么、为什么、何时算完成

【请你按结构回复】
1. 需求理解（5 行内）
2. 澄清问题（编号列表）
3. 假设说明
4. 建议的下一步（是否可以开 Prompt 写代码）

给 AI 的 Prompt 骨架

给 AI · Prompt · 通用骨架

【目标】一句话业务结果
【范围】只改哪些路径；明确「不要动」什么
【契约】输入 / 输出 / 字段名
【参考】@文件或 @文档
【验收】你怎么点、或哪条命令
【请你】先复述，再给 diff

纠错卡骨架

给 AI · 纠错 · 通用骨架

【现象】我做了什么 → 期望 → 实际 → 报错原文
【约束】最小改动；不换栈；不重构
【请你】根因一句话 + 最小 diff + 我再点哪步确认

好 vs 坏对照

弱 Prompt	问题	改成
「帮我把前端做好」	无边界	允许文件 + 主路径验收
「参考最佳实践重构」	巨 diff	「只修当前报错，不重构」
「报错了再看看」	无原文	贴控制台 + 期望/实际
整仓 @ + 一句话	噪声	@ 单文件 + 契约

进阶：让 AI 自己列风险

【额外】列出本次改动可能碰到的权限/数据/兼容风险（≤5 条）。没有写「无」。

场景嵌入（母版怎么落到正文）

场景	卡里特有字段
一	纯静态；三步路径；最多三文件
二	组件 props/事件；禁止 domain/data（若本卡只做 UI）
三	字段对照表；curl
四	风险栏；禁止鉴权

正面例子：场景一、页面拆解、API。