3.7.3 提示词速查清单
本节提供一系列可直接使用的速查清单和模板，建议收藏或打印备用。
一页纸速查表：提问前必查
在向 AI 提问之前，快速检查这九项：
┌─────────────────────────────────────────────────────────────┐
│ 提示词自检清单 v1.0 │
├─────────────────────────────────────────────────────────────┤
│ │
│ □ 1. 我说清楚【背景】了吗？ │
│ （项目类型、技术栈、当前进度） │
│ │
│ □ 2. 我说清楚【任务】了吗？ │
│ （要做什么、输入输出是什么） │
│ │
│ □ 3. 我说清楚【约束】了吗？ │
│ （必须遵守的限制、不能做什么） │
│ │
│ □ 4. 我说清楚【格式】了吗？ │
│ （要完整代码还是片段、需要注释吗） │
│ │
│ □ 5. 我给【示例】了吗？ │
│ （如果需要特定格式输出） │
│ │
│ □ 6. 我的提示词够【具体】吗？ │
│ （能否更精确地描述期望） │
│ │
│ □ 7. 我告诉 AI【什么不能做】了吗？ │
│ （防止 AI「加戏」） │
│ │
│ □ 8. 我准备好【迭代】了吗？ │
│ （不期待一次完美） │
│ │
│ □ 9. 我整合了【第二章的思考成果】吗？ │
│ （用户画像、MVP 范围、灵魂三问） │
│ │
└─────────────────────────────────────────────────────────────┘分场景 Prompt 模板
场景一：代码生成
适用于：创建新组件、实现新功能、生成完整模块
markdown
【背景】
项目类型：[网页应用/数据分析/自动化脚本/...]
技术栈：[React/Python/Node.js/...]
当前进度：[项目刚开始/已有基础结构/...]
【任务】
请帮我实现 [功能名称]：
- 功能描述：[用户做什么，系统做什么]
- 输入：[用户输入什么]
- 输出：[系统输出什么]
【约束】
必须：
- [约束1]
- [约束2]
不能：
- [约束3]
- [约束4]
【格式要求】
- [ ] 完整代码文件
- [ ] 包含 TypeScript 类型
- [ ] 包含关键注释
- [ ] 包含使用说明填写示例：
markdown
【背景】
项目类型：个人待办清单网页应用
技术栈：React + TypeScript + Tailwind CSS
当前进度：项目已初始化，已有 AddTask 组件
【任务】
请帮我实现「删除任务」功能：
- 功能描述：用户点击任务右侧的删除图标，该任务从列表中移除
- 输入：用户点击删除图标
- 输出：任务从列表中消失，显示简短的撤销提示
【约束】
必须：
- 删除前显示确认提示（防止误删）
- 删除后 3 秒内可撤销
- 样式用 Tailwind CSS
不能：
- 不用任何 UI 组件库
- 不用 confirm() 弹窗（体验不好）
【格式要求】
- [x] 完整代码文件
- [x] 包含 TypeScript 类型
- [x] 包含关键注释
- [ ] 包含使用说明场景二：代码修改
适用于：修复 Bug、优化性能、重构代码
markdown
【当前代码】
```[语言]
[粘贴当前代码]【问题描述】 现在的问题是：[具体描述问题现象] 期望的行为是：[描述正确的行为]
【修改要求】
- [要求1]
- [要求2]
【约束】
- 只修改必要的部分，保持其他代码不变
- [其他约束]
**填写示例**：
```markdown
【当前代码】
```typescript
const handleSubmit = () => {
if (inputValue) {
addTask(inputValue);
setInputValue('');
}
}【问题描述】 现在的问题是：输入空格也能添加任务 期望的行为是：只有真正有内容时才能添加，空格应该被忽略
【修改要求】
- 添加前去除首尾空格
- 去除空格后如果为空，显示提示
【约束】
- 只修改必要的部分，保持其他代码不变
- 提示用 toast 而不是 alert
### 场景三：问题排查
适用于：代码报错、功能异常、性能问题
```markdown
【问题现象】
[描述你看到了什么]
【期望行为】
[描述你期望看到什么]
【相关代码】
```[语言]
[粘贴相关代码]【已尝试的方法】
- [尝试1]：[结果]
- [尝试2]：[结果]
【环境信息】
- 浏览器/运行环境：[版本]
- 相关库版本：[版本]
【请帮我】
- 分析可能的原因
- 给出解决方案
- 解释为什么会出现这个问题
**填写示例**：
```markdown
【问题现象】
点击「完成任务」按钮后，任务状态没有变化，控制台没有报错
【期望行为】
点击后任务左侧的圆圈应该变成勾选状态
【相关代码】
```typescript
const toggleComplete = (id: string) => {
setTasks(tasks.map(task =>
task.id === id ? { ...task, complete: !task.complete } : task
));
}【已尝试的方法】
- 检查 id 是否正确传递：console.log 确认 id 是对的
- 检查 tasks 状态：更新前后 tasks 数组没有变化
【环境信息】
- 浏览器：Chrome 120
- React 版本：18.2.0
【请帮我】
- 分析可能的原因
- 给出解决方案
- 解释为什么会出现这个问题
### 场景四：技术选型
适用于：选择库、框架、架构方案
```markdown
【项目背景】
[简要描述项目]
【选型需求】
我需要选择 [选型类型]，主要考虑：
- [考虑因素1]
- [考虑因素2]
- [考虑因素3]
【候选方案】（可选）
1. [方案A]
2. [方案B]
3. [方案C]
【请帮我】
1. 分析每个方案的优缺点
2. 给出推荐方案及理由
3. 说明什么情况下应该选择其他方案填写示例：
markdown
【项目背景】
个人待办清单应用，目前数据存在 localStorage，想支持多设备同步
【选型需求】
我需要选择后端数据存储方案，主要考虑：
- 免费或低成本（个人项目）
- 上手简单（我是后端小白）
- 支持用户认证
【候选方案】
1. Supabase
2. Firebase
3. 自己搭建 Node.js + MongoDB
【请帮我】
1. 分析每个方案的优缺点
2. 给出推荐方案及理由
3. 说明什么情况下应该选择其他方案常见错误自检清单
在发送 Prompt 前，检查是否犯了这五个常见错误：
| # | 错误 | 检查方法 | 修正方式 |
|---|---|---|---|
| 1 | 没有背景 | 删掉背景后 AI 还能理解吗？ | 加上项目类型和技术栈 |
| 2 | 太模糊 | 「优化代码」优化什么？ | 具体说明优化哪个方面 |
| 3 | 没有约束 | AI 可能「加戏」吗？ | 加上「不做清单」 |
| 4 | 没有格式 | AI 输出格式随机？ | 指定要代码还是解释 |
| 5 | 一次要太多 | 任务超过 3 个要点？ | 拆分成多轮对话 |
幻觉验证快速指南
当 AI 推荐了你不熟悉的包或 API 时，用这个流程验证：
AI 推荐了一个包或 API
│
▼
┌─────────────────────────┐
│ 1. 验证包是否存在 │
│ npm search <包名> │
│ 或访问 npmjs.com │
└─────────────────────────┘
│
├─ 不存在 ──────────▶ 🔴 包幻觉，要求 AI 重新推荐
│
▼ 存在
┌─────────────────────────┐
│ 2. 检查包的可靠性 │
│ - 周下载量 > 1000? │
│ - 最近更新 < 1年? │
│ - GitHub stars > 100? │
└─────────────────────────┘
│
├─ 不满足 ──────────▶ 🟡 谨慎使用，考虑替代方案
│
▼ 满足
┌─────────────────────────┐
│ 3. 验证 API 是否正确 │
│ 查阅官方文档 │
└─────────────────────────┘
│
├─ API 不存在 ─────▶ 🔴 API 幻觉，查文档找正确 API
│
▼ API 存在
✅ 可以使用迭代反馈模板
当 AI 的输出不满意时，使用这个模板给反馈：
markdown
【问题】
[具体指出哪里不对]
【原因】
[解释为什么这样不行]
【期望】
[明确说明你想要什么]
【示例】（可选）
[给一个你期望的示例]填写示例：
markdown
【问题】
你给的代码中，删除任务后没有撤销功能
【原因】
用户可能误删，需要有后悔的机会
【期望】
删除后显示一个 3 秒的「撤销」提示，点击可以恢复任务
【示例】
类似 Gmail 删除邮件后底部出现的「撤销」按钮可复制的万能模板
这是一个通用模板，适用于大多数场景：
markdown
## 背景
我正在做 [项目类型]。
技术栈：[技术栈]
目标用户：[用户描述]
## 当前任务
[具体描述要做什么]
## 要求
1. [要求1]
2. [要求2]
3. [要求3]
## 不需要
- [不需要1]
- [不需要2]
## 输出格式
[说明期望的输出格式]
## 关于我
我是 [技术水平]，如果有 [注意事项]，请提醒我。本节要点
✓ 提问前必查：背景、任务、约束、格式、示例、具体性、不做清单、迭代准备、第二章成果
✓ 四种场景模板：代码生成、代码修改、问题排查、技术选型
✓ 五个常见错误：没背景、太模糊、没约束、没格式、一次要太多
✓ 幻觉验证：先验证存在性，再检查可靠性，最后查官方文档
下一节，我们将通过四个综合练习，帮助你内化这些技能。