15 - Prompt 工程实战

1. 定位

Prompt 工程的理论框架 + 进阶技巧 + 个人积累区。

与其他资源的分工：

资源	定位	适用场景
本文档	四要素理论 + 5 个进阶技巧 + 个人积累区	理解"为什么这样写"，提炼新模式
Prompt Cookbook	11 篇场景级深度食谱（变量模板+好坏对比+实战案例）	按阶段找模板直接用
07 §5	每日高频提示词（嵌入操作流）	日常速查
12 §5	反模式速查（嵌入效率实践）	避坑
Skills	固化为 Claude Code 自动化指令	一键执行

---

2. 好 Prompt 的四要素

❌ "做一个用户登录功能"

✅ "实现用户登录功能。
   技术栈：Next.js App Router + NextAuth.js + Prisma。
   支持邮箱密码登录和 GitHub OAuth。
   登录后跳转到 /dashboard。
   参考现有的 /app/layout.tsx 中的导航结构。
   先出方案不要写代码。"

要素	作用	示例
技术栈约束	避免 AI 自选框架	用 Next.js App Router，不用 Pages Router
具体范围	限制改动边界	只改 /app/api/users/route.ts
参考上下文	保持代码风格一致	参考 @src/services/user.service.ts
行动指令	明确下一步动作	先出方案不写代码 / 直接改

速记口诀： 栈 + 范围 + 参考 + 指令。缺任何一个，AI 输出质量都会下降。

---

3. 进阶技巧

3.1 锚定文件模式（效率提升最大的单个技巧）

给 AI 一个项目中已有的类似实现作为"锚点"，而不是从零描述规范：

✅ "参考 @app/api/users/route.ts 中创建用户的实现方式，
   实现用户删除 API。保持相同的：
   - 请求校验方式（zod schema）
   - 错误处理模式（AppError）
   - 响应格式（{ data, error }）"

效果：AI 输出与现有代码高度一致，减少审查负担，不需要在 CLAUDE.md 里写过于细节的规范。

3.2 约束注入（防止 AI "自由发挥"）

在 prompt 开头明确三类约束：

技术约束：用 [框架]，不用 [框架]
范围约束：只改 [文件/函数]，不动 [其他部分]
行为约束：先出方案，不要直接改代码

"不要做什么"往往比"要做什么"更有效。约束越精确，输出越可控。

3.3 分步引导（大任务的节奏控制）

避免让 AI 一次性完成大任务，使用分步确认模式：

Step 1: "先读 [相关代码]，描述你的理解，不做任何修改。"
Step 2: "好的，现在出方案，只列改动点，不写代码。"
Step 3: "方案确认，开始实现第一步：[具体子任务]。"
Step 4: "跑测试，报告结果。"
Step 5: "继续实现第二步..."

每步都有确认点，避免 AI 一次性跑偏太远。

3.4 角色切换（多视角覆盖盲区）

同一段代码用不同角色得到更全面的分析：

实现角色：  "作为实现者，完成这个功能。"
审查角色：  "作为资深审查者，找出这段代码的问题。"
攻击角色：  "作为安全研究员，尝试打破这段代码。"
用户角色：  "作为完全不了解技术的用户，描述使用这个功能的体验。"

最实用的组合：先让 AI 作为实现者写，再开新会话让 AI 作为审查者找问题（三会话隔离审查）。

3.5 精确纠错（避免"不对，重来"）

当 AI 输出不符合预期时，不要只说"不对，重来"：

❌ "这个不对，重写一遍"

✅ "这个实现有两个问题：
   1. [具体问题一：描述错在哪]
   2. [具体问题二：描述错在哪]

   第一个问题的正确做法应该是 [描述]。
   请只修改这两个问题，其他部分保持不变。"

精确指出问题 + 说明预期 + 限制修改范围 = AI 精确改动，不引入新问题。

---

4. 反模式速查

完整反模式表格见 12 §5。以下是最致命的 3 条：

反模式	后果	正确做法
帮我做这个系统	一次性大量低质量代码	拆解为 5-10 个独立子任务
不给约束让 AI 自由发挥	输出不可预期	给技术栈、文件范围、风格参考
连续给 20 条指令不看输出	错误累积不可收拾	每 1-2 步确认输出再继续

---

5. 个人积累（持续更新）

这是你自己的 Prompt 积累区。每当发现一个特别好用的 Prompt 或踩了坑，记录到这里。 更新触发：每次 /retro 时回顾是否有新内容可加。

高效 Prompt（验证有效）

踩过的坑（失效场景）

---

6. 与其他子系统的关系

本文档（理论框架 + 进阶技巧 + 个人积累）
  ├── 被 07-人的操作手册 引用（§5 日常速查）
  ├── 被 12-效率最佳实践 引用（§5 反模式）
  ├── 与 Prompt Cookbook 互补（理论 vs 场景模板）
  ├── 与 01-CLAUDE.md 配合（好 Prompt + 好 CLAUDE.md = 最佳效果）
  └── 与 02-Skills 配合（Skill 是固化了 Prompt 的高级形式）

演进方向： 本文档通过 /retro Skill 持续沉淀。§5 是私人积累区，不受格式约束。发现通用高效 Prompt 模式时，同步到 Prompt Cookbook 对应食谱中。