提示词工程最佳实践

2025年4月16日

4109 字

预计阅读 17 分钟

提示词工程（Prompt Engineering）是与AI模型有效交互的关键技能。本指南将介绍如何设计高质量的提示词来获得更好的AI输出。

基础原理

什么是提示词工程

提示词工程是设计和优化输入文本（提示词）的过程，目的是引导AI模型产生期望的输出。它涉及：

结构设计：如何组织提示词的结构
上下文管理：如何提供有效的背景信息
指令优化：如何清晰地表达需求
输出控制：如何约束和引导输出格式

核心原则

明确性：指令要清晰、具体、无歧义
上下文：提供充分的背景信息
结构化：使用清晰的格式和组织
迭代优化：通过测试和调整改进提示词

提示词结构

基本结构模板

Plaintext

[角色定义] + [任务描述] + [输入内容] + [输出要求] + [约束条件]

示例：

Plaintext

作为一个有10年经验的前端开发专家，请帮我重构以下React组件。

任务：优化组件性能和可读性
输入：[组件代码]
输出要求：
1. 使用TypeScript
2. 添加详细注释
3. 遵循React最佳实践
4. 包含性能优化建议

约束条件：
- 保持原有功能不变
- 代码长度不超过100行
- 使用现代React Hooks

高级结构模式

思维链（Chain of Thought）：

Plaintext

请按照以下步骤分析这个问题：

1. 首先，理解问题的核心需求
2. 然后，分析可能的解决方案
3. 接下来，评估每个方案的优缺点
4. 最后，推荐最佳解决方案并说明理由

问题：[具体问题描述]

角色扮演：

Plaintext

你是一位资深的系统架构师，拥有15年的大型项目经验。
现在需要为一个电商平台设计微服务架构。

背景信息：
- 日活用户：100万
- 峰值QPS：10000
- 业务模块：用户、商品、订单、支付、库存

请提供：
1. 整体架构设计
2. 服务拆分策略
3. 数据库设计
4. 缓存策略
5. 监控方案

常用技巧

1. 零样本提示（Zero-shot）

Plaintext

将以下文本翻译成英文，要求：
- 保持原意不变
- 使用正式的商务语言
- 确保语法正确

文本：[中文内容]

2. 少样本提示（Few-shot）

Plaintext

请按照以下示例格式，为新的API端点编写文档：

示例1：
端点：GET /api/users/{id}
描述：获取指定用户的详细信息
参数：id (string) - 用户唯一标识符
响应：User对象，包含用户的基本信息

示例2：
端点：POST /api/users
描述：创建新用户账户
参数：用户注册信息（JSON格式）
响应：创建成功的用户对象

现在请为以下端点编写文档：
端点：PUT /api/users/{id}/password

3. 思维链提示

Plaintext

让我们一步步分析这个算法问题：

问题：给定一个整数数组，找出和为目标值的两个数的索引。

分析步骤：
1. 理解问题要求
2. 考虑可能的解决方案
3. 分析时间和空间复杂度
4. 选择最优解决方案
5. 编写代码实现
6. 测试验证

请按照这个步骤详细分析。

4. 自我一致性

Plaintext

请用三种不同的方法解决这个问题，然后比较结果：

问题：[具体问题]

方法1：[第一种思路]
方法2：[第二种思路]  
方法3：[第三种思路]

最后，分析哪种方法最优并说明原因。

特定场景的提示词

代码生成

Plaintext

作为一个Python专家，请帮我实现一个装饰器函数。

需求：
- 功能：记录函数执行时间和参数
- 支持同步和异步函数
- 可配置日志级别
- 包含错误处理

要求：
1. 使用类型注解
2. 添加详细的docstring
3. 包含使用示例
4. 遵循PEP 8规范

请提供完整的实现代码。

代码审查

Plaintext

请作为高级开发者审查以下代码，重点关注：

1. 代码质量和可读性
2. 性能优化机会
3. 潜在的安全问题
4. 最佳实践遵循情况
5. 错误处理完整性

代码：
[代码内容]

请提供：
- 具体的改进建议
- 重构后的代码示例
- 解释每个修改的原因

文档编写

Plaintext

请为以下API编写完整的技术文档：

API信息：[API详情]

文档应包含：
1. 概述和用途
2. 认证方式
3. 请求/响应格式
4. 错误码说明
5. 代码示例（多种语言）
6. 最佳实践建议

格式要求：
- 使用Markdown格式
- 结构清晰，易于阅读
- 包含实际可运行的示例

问题诊断

Plaintext

作为系统运维专家，请帮我诊断以下问题：

症状：[问题描述]
环境：[环境信息]
日志：[相关日志]

请按照以下步骤分析：
1. 问题定位
2. 根因分析
3. 解决方案
4. 预防措施
5. 监控建议

提供详细的排查思路和具体的解决步骤。

输出格式控制

JSON格式输出

Plaintext

请分析以下代码的复杂度，并以JSON格式返回结果：

{
  "time_complexity": "O(n)",
  "space_complexity": "O(1)",
  "analysis": {
    "best_case": "描述",
    "worst_case": "描述",
    "average_case": "描述"
  },
  "optimization_suggestions": [
    "建议1",
    "建议2"
  ]
}

代码：[代码内容]

表格格式输出

Plaintext

请比较以下三个框架，并以表格形式输出：

| 特性 | React | Vue | Angular |
|------|-------|-----|---------|
| 学习曲线 | | | |
| 性能 | | | |
| 生态系统 | | | |
| 社区支持 | | | |
| 适用场景 | | | |

请填写完整的比较信息。

代码块格式

Plaintext

请提供解决方案，格式如下：

## 解决方案

### 方法一：[方法名称]
```javascript
// 代码实现

优点：

优点1
优点2

缺点：

缺点1
缺点2

方法二：[方法名称]

[同样的格式]

Plaintext

## 常见问题和解决方案

### 1. 输出不稳定

**问题**：相同的提示词产生不同的输出

**解决方案**：
- 增加温度参数控制
- 使用更具体的指令
- 添加输出格式约束
- 使用示例引导

### 2. 输出过于冗长

**问题**：AI生成的内容太长

**解决方案**：

请简洁回答，要求：

控制在200字以内
只包含核心要点
使用项目符号列表
避免重复信息

Plaintext

### 3. 缺乏专业性

**问题**：输出不够专业或准确

**解决方案**：

作为[具体领域]的资深专家，请基于以下专业知识回答：

相关理论基础
行业最佳实践
实际案例经验
最新技术趋势

确保回答的专业性和准确性。

Plaintext

### 4. 上下文丢失

**问题**：长对话中AI忘记之前的内容

**解决方案**：
- 定期总结关键信息
- 在新提示中重申重要上下文
- 使用结构化的信息组织
- 分解复杂任务为多个步骤

## 高级技巧

### 1. 提示词链接

第一步：分析需求 [具体分析任务]

基于第一步的分析结果，第二步：设计方案 [设计任务]

基于前两步的结果，第三步：实现代码 [实现任务]

Plaintext

### 2. 条件逻辑

请根据以下条件选择合适的解决方案：

如果项目规模 < 10人：推荐轻量级解决方案否则如果项目规模 < 100人：推荐中等规模解决方案否则：推荐企业级解决方案

项目信息：[项目详情]

Plaintext

### 3. 迭代优化

请按照以下流程优化代码：

初始分析：识别问题点
第一次优化：解决主要问题
第二次优化：性能调优
第三次优化：代码清理
最终验证：确保功能正确

每一步都要说明优化理由和预期效果。

Plaintext

## 最佳实践总结

### 设计原则
1. **清晰明确**：避免模糊和歧义
2. **结构化**：使用清晰的格式和组织
3. **上下文丰富**：提供充分的背景信息
4. **目标导向**：明确期望的输出结果

### 优化策略
1. **迭代改进**：通过测试不断优化
2. **A/B测试**：比较不同提示词的效果
3. **模板化**：为常用场景创建模板
4. **版本管理**：记录和管理提示词版本

### 质量控制
1. **输出验证**：检查AI输出的准确性
2. **一致性测试**：确保输出的稳定性
3. **边界测试**：测试极端情况的处理
4. **人工审查**：重要输出需要人工确认

## 相关资源

- [AI 工具对比与选择指南](./ai-tools-comparison.mdx)
- [AI 辅助开发工作流程](./ai-development-workflow.mdx)
- [DeepSeek R1 完全指南](./deepseek-r1-complete-guide.mdx)
- [开发最佳实践](../guides/best-practices.mdx)

提示词工程最佳实践

2025年4月16日

4109 字

预计阅读 17 分钟

提示词工程（Prompt Engineering）是与AI模型有效交互的关键技能。本指南将介绍如何设计高质量的提示词来获得更好的AI输出。

基础原理

什么是提示词工程

提示词工程是设计和优化输入文本（提示词）的过程，目的是引导AI模型产生期望的输出。它涉及：

结构设计：如何组织提示词的结构
上下文管理：如何提供有效的背景信息
指令优化：如何清晰地表达需求
输出控制：如何约束和引导输出格式

核心原则

明确性：指令要清晰、具体、无歧义
上下文：提供充分的背景信息
结构化：使用清晰的格式和组织
迭代优化：通过测试和调整改进提示词

提示词结构

基本结构模板

Plaintext

[角色定义] + [任务描述] + [输入内容] + [输出要求] + [约束条件]

示例：

Plaintext

作为一个有10年经验的前端开发专家，请帮我重构以下React组件。

任务：优化组件性能和可读性
输入：[组件代码]
输出要求：
1. 使用TypeScript
2. 添加详细注释
3. 遵循React最佳实践
4. 包含性能优化建议

约束条件：
- 保持原有功能不变
- 代码长度不超过100行
- 使用现代React Hooks

高级结构模式

思维链（Chain of Thought）：

Plaintext

请按照以下步骤分析这个问题：

1. 首先，理解问题的核心需求
2. 然后，分析可能的解决方案
3. 接下来，评估每个方案的优缺点
4. 最后，推荐最佳解决方案并说明理由

问题：[具体问题描述]

角色扮演：

Plaintext

你是一位资深的系统架构师，拥有15年的大型项目经验。
现在需要为一个电商平台设计微服务架构。

背景信息：
- 日活用户：100万
- 峰值QPS：10000
- 业务模块：用户、商品、订单、支付、库存

请提供：
1. 整体架构设计
2. 服务拆分策略
3. 数据库设计
4. 缓存策略
5. 监控方案

常用技巧

1. 零样本提示（Zero-shot）

Plaintext

将以下文本翻译成英文，要求：
- 保持原意不变
- 使用正式的商务语言
- 确保语法正确

文本：[中文内容]

2. 少样本提示（Few-shot）

Plaintext

请按照以下示例格式，为新的API端点编写文档：

示例1：
端点：GET /api/users/{id}
描述：获取指定用户的详细信息
参数：id (string) - 用户唯一标识符
响应：User对象，包含用户的基本信息

示例2：
端点：POST /api/users
描述：创建新用户账户
参数：用户注册信息（JSON格式）
响应：创建成功的用户对象

现在请为以下端点编写文档：
端点：PUT /api/users/{id}/password

3. 思维链提示

Plaintext

让我们一步步分析这个算法问题：

问题：给定一个整数数组，找出和为目标值的两个数的索引。

分析步骤：
1. 理解问题要求
2. 考虑可能的解决方案
3. 分析时间和空间复杂度
4. 选择最优解决方案
5. 编写代码实现
6. 测试验证

请按照这个步骤详细分析。

4. 自我一致性

Plaintext

请用三种不同的方法解决这个问题，然后比较结果：

问题：[具体问题]

方法1：[第一种思路]
方法2：[第二种思路]  
方法3：[第三种思路]

最后，分析哪种方法最优并说明原因。

特定场景的提示词

代码生成

Plaintext

作为一个Python专家，请帮我实现一个装饰器函数。

需求：
- 功能：记录函数执行时间和参数
- 支持同步和异步函数
- 可配置日志级别
- 包含错误处理

要求：
1. 使用类型注解
2. 添加详细的docstring
3. 包含使用示例
4. 遵循PEP 8规范

请提供完整的实现代码。

代码审查

Plaintext

请作为高级开发者审查以下代码，重点关注：

1. 代码质量和可读性
2. 性能优化机会
3. 潜在的安全问题
4. 最佳实践遵循情况
5. 错误处理完整性

代码：
[代码内容]

请提供：
- 具体的改进建议
- 重构后的代码示例
- 解释每个修改的原因

文档编写

Plaintext

请为以下API编写完整的技术文档：

API信息：[API详情]

文档应包含：
1. 概述和用途
2. 认证方式
3. 请求/响应格式
4. 错误码说明
5. 代码示例（多种语言）
6. 最佳实践建议

格式要求：
- 使用Markdown格式
- 结构清晰，易于阅读
- 包含实际可运行的示例

问题诊断

Plaintext

作为系统运维专家，请帮我诊断以下问题：

症状：[问题描述]
环境：[环境信息]
日志：[相关日志]

请按照以下步骤分析：
1. 问题定位
2. 根因分析
3. 解决方案
4. 预防措施
5. 监控建议

提供详细的排查思路和具体的解决步骤。

输出格式控制

JSON格式输出

Plaintext

请分析以下代码的复杂度，并以JSON格式返回结果：

{
  "time_complexity": "O(n)",
  "space_complexity": "O(1)",
  "analysis": {
    "best_case": "描述",
    "worst_case": "描述",
    "average_case": "描述"
  },
  "optimization_suggestions": [
    "建议1",
    "建议2"
  ]
}

代码：[代码内容]

表格格式输出

Plaintext

请比较以下三个框架，并以表格形式输出：

| 特性 | React | Vue | Angular |
|------|-------|-----|---------|
| 学习曲线 | | | |
| 性能 | | | |
| 生态系统 | | | |
| 社区支持 | | | |
| 适用场景 | | | |

请填写完整的比较信息。

代码块格式

Plaintext

请提供解决方案，格式如下：

## 解决方案

### 方法一：[方法名称]
```javascript
// 代码实现

优点：

优点1
优点2

缺点：

缺点1
缺点2

方法二：[方法名称]

[同样的格式]

Plaintext

## 常见问题和解决方案

### 1. 输出不稳定

**问题**：相同的提示词产生不同的输出

**解决方案**：
- 增加温度参数控制
- 使用更具体的指令
- 添加输出格式约束
- 使用示例引导

### 2. 输出过于冗长

**问题**：AI生成的内容太长

**解决方案**：

请简洁回答，要求：

控制在200字以内
只包含核心要点
使用项目符号列表
避免重复信息

Plaintext

### 3. 缺乏专业性

**问题**：输出不够专业或准确

**解决方案**：

作为[具体领域]的资深专家，请基于以下专业知识回答：

相关理论基础
行业最佳实践
实际案例经验
最新技术趋势

确保回答的专业性和准确性。

Plaintext

### 4. 上下文丢失

**问题**：长对话中AI忘记之前的内容

**解决方案**：
- 定期总结关键信息
- 在新提示中重申重要上下文
- 使用结构化的信息组织
- 分解复杂任务为多个步骤

## 高级技巧

### 1. 提示词链接

第一步：分析需求 [具体分析任务]

基于第一步的分析结果，第二步：设计方案 [设计任务]

基于前两步的结果，第三步：实现代码 [实现任务]

Plaintext

### 2. 条件逻辑

请根据以下条件选择合适的解决方案：

如果项目规模 < 10人：推荐轻量级解决方案否则如果项目规模 < 100人：推荐中等规模解决方案否则：推荐企业级解决方案

项目信息：[项目详情]

Plaintext

### 3. 迭代优化

请按照以下流程优化代码：

初始分析：识别问题点
第一次优化：解决主要问题
第二次优化：性能调优
第三次优化：代码清理
最终验证：确保功能正确

每一步都要说明优化理由和预期效果。

Plaintext

## 最佳实践总结

### 设计原则
1. **清晰明确**：避免模糊和歧义
2. **结构化**：使用清晰的格式和组织
3. **上下文丰富**：提供充分的背景信息
4. **目标导向**：明确期望的输出结果

### 优化策略
1. **迭代改进**：通过测试不断优化
2. **A/B测试**：比较不同提示词的效果
3. **模板化**：为常用场景创建模板
4. **版本管理**：记录和管理提示词版本

### 质量控制
1. **输出验证**：检查AI输出的准确性
2. **一致性测试**：确保输出的稳定性
3. **边界测试**：测试极端情况的处理
4. **人工审查**：重要输出需要人工确认

## 相关资源

- [AI 工具对比与选择指南](./ai-tools-comparison.mdx)
- [AI 辅助开发工作流程](./ai-development-workflow.mdx)
- [DeepSeek R1 完全指南](./deepseek-r1-complete-guide.mdx)
- [开发最佳实践](../guides/best-practices.mdx)