--- title: "3.7.3 提示词速查清单" --- ![03-technique_3.7-summary_3.7.3-prompt-checklist.png](/images/Basic/03-technique_3.7-summary_3.7.3-prompt-checklist.png) # 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. [尝试1]：[结果] 2. [尝试2]：[结果] 【环境信息】 - 浏览器/运行环境：[版本] - 相关库版本：[版本] 【请帮我】 1. 分析可能的原因 2. 给出解决方案 3. 解释为什么会出现这个问题 ``` **填写示例**： ```markdown 【问题现象】 点击「完成任务」按钮后，任务状态没有变化，控制台没有报错 【期望行为】 点击后任务左侧的圆圈应该变成勾选状态 【相关代码】 ```typescript const toggleComplete = (id: string) => { setTasks(tasks.map(task => task.id === id ? { ...task, complete: !task.complete } : task )); } ``` 【已尝试的方法】 1. 检查 id 是否正确传递：console.log 确认 id 是对的 2. 检查 tasks 状态：更新前后 tasks 数组没有变化 【环境信息】 - 浏览器：Chrome 120 - React 版本：18.2.0 【请帮我】 1. 分析可能的原因 2. 给出解决方案 3. 解释为什么会出现这个问题 ``` ### 场景四：技术选型 适用于：选择库、框架、架构方案 ```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] ## 输出格式 [说明期望的输出格式] ## 关于我 我是 [技术水平]，如果有 [注意事项]，请提醒我。 ``` ## 本节要点 ✓ **提问前必查**：背景、任务、约束、格式、示例、具体性、不做清单、迭代准备、第二章成果 ✓ **四种场景模板**：代码生成、代码修改、问题排查、技术选型 ✓ **五个常见错误**：没背景、太模糊、没约束、没格式、一次要太多 ✓ **幻觉验证**：先验证存在性，再检查可靠性，最后查官方文档 下一节，我们将通过四个综合练习，帮助你内化这些技能。