Prompt 编写教程：建立高效 AI 指令

编写高质量的 Prompt是开发者必备的主要技能。一份优秀的 Prompt 就像一张精准的作战地图，能够引导 AI 高效完成任务。

一、什么是 Prompt？

Prompt 是你向 AI 模型发出的指令、问题或请求。它是人与 AI 之间沟通的桥梁，代码、撰写文档、分析数据等。话说回来，

简单Prompt 就是你告诉 AI “做什么” 和 “怎么做”的指令。

Prompt 的作用

1. 明确目标告诉 AI 你想要实现什么功能或达成什么结果。
2. 设定约束限定 AI 的输出范围、格式和风格。
3. 提供上下文为 AI 提供必要的背景信息和参考资料。
4. 引导推理引导 AI 按照特定逻辑或步骤思考问题。

一个典型 Prompt 示例

支持加、减、乘、除四种基本运算
使用命令行界面交互
对除零错误进行异常处理

二、编写高质量 Prompt 的五大原则

从原则一来看，精准描述需求

User Pain Point: 很多人遇到的问题是“模糊需求导致结果不符合预期”。必须用精确语言描述需求，避免歧义。

主要要点：

• 清晰具体，无歧义。
• 使用专业术语和明确功能描述。话说回来，
• Avoid vague phrasing.

说到原则二，提供完整上下文

AIM 在缺少背景信息时常会产生偏差。为此请尽量补充环境与依赖细节，让模型知道你的技术栈与业务规则。按理说，

• 技术栈：编程语言、框架及其版本；例如：“Python 3.11 + FastAPI v0.95”。
• 项目约束：`时间限制` / `性能要求` / `兼容性要求`；例如：“响应时间 ≤ 200ms”。
• 已有代码：`相关片段或结构`；例如：“当前项目采用 MVC 模式”。
• 业务规则：`特定流程` 或 `领域知识`；例如：“订单需通过支付宝支付后才算完成”。

User Pain Point: “不知道应该把哪些信息放进去”，所以可以使用上表格式一次性列出所有关键上下文。这样既避免遗漏，又能防止信息过载。

示例的观点是，

在现有 Vue 项目中添加一个使用者登录功能。要求：
- 使用 Pinia 进行状态管理
- 使用 Axios 调用后端 API
- 登录成功后跳转到首页并存储 JWT Token
- 参考项目中现有组件风格和代码规范

原则三这方面，结构化任务描述

AIM 更擅长按步骤执行任务，所以请把复杂需求拆分成子任务，并按逻辑顺序呈现。这不仅减少错误，还方便后续维护与迭代。

1. AIM 可以按步骤生成代码，从而降低错误概率。
2. AIM 输出更易于审查与测试。
3. AIM 输出更具可读性与可维护性。

示例 ：

一个简单待办事项应用:
1️⃣ 步骤一：数据库设计
- 创建 SQLite 数据库
- design todos 表
2️⃣ 步骤二：后端 API
- FastAPI 框架
- GET /todos,POST /todos。PUT /todos/{id},DELETE /todos/{id}
3️⃣ 步骤三：前端界面
- HTML/CSS/JS 展示列表
- 添加/编辑/删除功能
- fetch API 调用后端接口

至于原则四，设定输出标准

AIM 能够满足各种输出格式，但前提是你先告诉它期望何种结构与质量标准。说到例如，

markdown
函数名为 fibonacci。接受整数参数 n，返回前 n 个斐波那契数列。详细注释 + 示例，时间复杂度 <= O。
符合 PEP8 风格。
---
**Output Requirements**
* **Code Style** – naming convention, indentation.
* **Documentation** – comments, docstrings.
* **Testing** – unit tests if needed.
* **Performance** – time/space constraints.
---
**Example **
python
def fibonacci -> List:
"""
Return first n Fibonacci numbers.
Time complexity: O.
"""
if n <= 0:
        return 
    seq = 
    while len 原则五：迭代调整反馈

AIM 初始输出往往还会出现小瑕疵，例如缺失参数检查或空值处理。此时请按照下面流程反复修正：
1️⃣ **评估结果** – 检查是否满足所有约束。说起来，2️⃣ **识别问题** – 如逻辑错误、不符格式。3️⃣ **调整 Prompt** – 补充缺失信息或纠正错误。4️⃣ **重新生成** –
请求 AIM。
按理说，---
**实战案例**
第一次 Prompt：
text
写一个 Python 函数来反转字符串。AI 输出：
python
def reverse_string:
return s
再看发现问题，* 缺少类型检查；* 空字符串未处理，* 注释不足。调整后的 Prompt：
text
写一个 Python 函数来反转字符串：
- 函数名为 reverse_string；- 接受字符串参数 s，- 返回反转后的字符串；- 若输入非字符串抛 TypeError；- 空字符串返回 ""，- 添加详细注释。生成即可得到更完善版本，---

三、高级技巧：提高 Prompt 质量

#### 技巧一：角色扮演
让 AIM 扮演专家角色，可控制其输出深度。例如让它扮演“资深前端工程师”，则会倾向于提供常用方法与性能建议。#### 技巧二：提供参考示例
给出类似代码片段，引导 AIM 保持一致风格。从例如来看，python
# Reference:
def add->int:
"""Calculate sum."""
return a+b
# Request:
# Function name factorial...
#### 技巧三：使用约束条件
设置严格限制。让 AIM 更聚焦，例如：
text
实现整数数组排序：
• 时间复杂度 O
• 空间复杂度 O
• 不使用内置 sort
#### 技巧四：分阶段提示
把极其庞大任务拆解成多阶段，例如先设计 ER 图，再编写 SQL，再实现 ORM 模型。每阶段只给出当前所需信息，可明显提高准确率。#### 技巧五：链式思考
让 AIM 显示推理过程，以验证思路正确性。例如让它解释某算法复杂度，并逐步说明推理方法。---

四、常见错误与避坑教程

##### 错误一：过于简略
| 问题 | 示例 |
|------|------|
| 没有具体需求 | “做个网页” |
| 完全缺乏细节 | “做个网站” |
至于改进方式。text
使用 HTML5/CSS3 创建响应式个人简历网页，包含个人信息、教育背景、
工作经历、技能展示和联系方式五部分，Flexbox 布局，适配移动端 & 桌面端。---
##### 错误二：信息过载
| 问题 | 示例 |
|------|------|
| 提供无关细节 | “我昨天去超市买了苹果，接下来回家做饭…需要一个网站” |
改进方式这方面，text
使用 React 创建个人博客网站。主题颜色蓝色，包含文章列表、详情页及评论功能。---
##### 错误三：缺乏约束
| 问题 | 示例 |
|------|------|
| 没有指定输出格式 | “写一个计算器” |
说到改进方式。text
JavaScript 实现网页计算器，支持四则运算，美观界面并支持键盘事件。---
##### 错误四：《假设模型已知项目结构》
若未明确文件夹布局，则容易导致方法错误。应提前告知项目目录，如 `src/`,`controllers/`。`models/`,`routes/` 等。---

五、Prompt 编写模板— 痛点八方法集锦》
清晰描述你想要实现的功能或达成目标
- 使用语言：
- 框架/库：
- 性能约束：
详细列出各子功能及其行为
- 功能点一
- 功能点二
- 代码风格：
- 文档说明：
- 单元测试？- 已有代码片段：
- 类似示例：
以上模板可根据实际情况自由删减。但请确保「目标」「技术」「约束」「细节」完整覆盖，以免产生模糊不清导致返工成本飙升。


六、实战案例汇总 





说到案例一，前端组件开发

从Prompt来看，

text
组件名 Pagination.
再看props，total:number,pageSize:number。currentPage:number.
从events来看，updateCurrentPage.
说到显示页码范围，当前页前后各 X 页.
含首页/上一页/下一页/末页按钮.
禁用状态规则...
Tailwind CSS 样式化...


从案例二来看，后端 API 开发

text
MongoDB + Mongoose ODM.
GET /api/books 列表分页搜索;GET /api/books/:id 单本详情;POST /api/books 新增;PUT /api/books/:id 更新;DELETE ...
JWT 身份验证，仅管理员权限...
字段定义详见列表...
错误处理 & 输入校验必填...


说到案例三，数据分析

text
Python pandas/numpy 分析销售数据 CSV:
• 清洗缺失值 & 异常值,• 分类总销售额 & 利润,• 月度趋势,• 找出最高最低利润类别。• 可视化柱状图 + 折线图.
完整代码 + 注释 + 报告输出.



— 痛点十 & 行动计划》 


🔗 推荐资源：


"The Art of Writing Prompts for LLMs" —— 程序方法论;
• "ChatGPT Cookbook" —— 实战范例合集;• "OpenAI Cookbook" —— 官方常用方法;• 在线社区如 StackOverflow 与 Reddit r/MachineLearning 对话交流;• GitHub 搜索 open-source prompt templates.
🎯 成功之路，从今天开始！话说回来，🚀👨🏻‍💻👩🏼‍💻"
​
​
​
​
​