结构化提示词工程（Prompt Engineering）知识体系

来源: 极客邦飞书知识库 - Codex Prompt 相关问题
整理时间: 2026-07-21
核心框架: LangGPT 结构化提示词方法论

一、什么是结构化提示词？

1.1 核心思想

写 Prompt 的核心逻辑是减少 AI 的猜测，把任务讲清楚。一个高质量的 Prompt 通常包含以下四个核心要素：

1.2 LangGPT 结构化提示词框架

LangGPT 由云中江树于 2023 年创造，青年节开源发布即登上 GitHub 全球趋势热榜前十。其提出的结构化提示词已被百度、智谱、字节、华为等国内主流大模型智能体平台采用，并成为 Kimi 官方提示词规范。

LangGPT 结构化模板：

# Role: 角色名称
## Profile
- Author: 作者
- Version: 版本号
- Language: 中文
- Description: 角色的简短描述

## Goals
- 目标1
- 目标2

## Constraints
- 约束条件1
- 约束条件2

## Skills
- 技能1
- 技能2

## Workflow
1. 步骤1
2. 步骤2

## OutputFormat
- 输出格式说明

## Initialization
作为 <Role>，你必须遵守 <Constraints>，使用 <Language> 与用户交流。

二、Prompt 编写核心原则

2.1 四大黄金法则

2.2 常见错误与改进

三、实战 Prompt 模板库

3.1 商业写作类

# Role: 企业领导演讲稿撰写人

## Profile
- 假设你是 [企业领导]
- 语言需 [正式且条理清晰]
- 篇幅控制在 [800 字] 左右

## Task
请为以下场景撰写演讲稿：
- 场景：[如：公司年度总结大会]
- 核心主题：[如：回顾成就、展望未来]

## OutputFormat
- 开场白：简短有力，吸引注意力
- 主体内容：分 3 个要点展开
- 结尾：鼓舞人心，呼吁行动

# Role: 专业市场研究员

## Task
为 [LED 显示屏行业] 编写竞争分析报告框架：

1. **行业现状概述**：运用 PEST 分析模型对宏观环境进行解析
2. **主要竞争对手分析**：以 SWOT 分析框架总结每个竞争对手
3. **市场趋势预估**：结合数据驱动的预测方法，展示未来 5 年趋势
4. **竞争策略建议**：基于波特五力模型提出针对性策略

## Constraints
- 语言需逻辑清晰，具备专业性
- 适用于高管汇报场景
- 篇幅控制在 1500 字

3.2 教育教学类

# Role: 语文教师

## Task
为 [《甲午战争的影响》] 设计一堂 45 分钟课程教案：

1. 教学目标
2. 教学重难点
3. 教学流程（含学生互动环节详细描述）
4. 课后作业

## Constraints
- 语言需活泼生动
- 互动环节需具可操作性

3.3 法律与合规类

# Role: 企业法律顾问

## Task
根据以下采购内容起草合同：
- 采购标的：[如电子元件采购]
- 需包含：付款条件、交付时间、验收标准、违约责任、
  争议解决方式及责任划分

## Constraints
- 语言需规范正式
- 篇幅控制在 1200 字

3.4 创意写作类

# Role: 影视评论家

## Task
根据用户偏好推荐 5 部电影：
- 类型：[科幻]
- 主题：[人工智能]
- 每部电影需包含：简介、推荐理由、与用户偏好的契合点

## OutputFormat
以表格形式呈现，按推荐度排序

# Role: 创意文案写手

## Task
根据以下信息创作个人说明书，适合用于 [工作场合] 展示：
- 姓名：[张伟]
- 职业：[软件工程师，热衷于人工智能和开源项目]
- 兴趣爱好：[弹吉他]
- 特点：[喜欢创新、乐于分享、有趣的灵魂]

## Constraints
- 标题有创意且能吸引读者注意
- 语言轻松有趣、结构清晰
- 篇幅：800 字左右

四、AI 编程协作最佳实践

以下内容来自极客邦知识库，关于如何高效与 AI 编程助手（如 Codex）协作。

4.1 核心原则

4.2 详细原则

🔍 动手前检查工作区

在修改前，要求 AI 检查当前工作区状态（已修改文件、未跟踪文件），避免 AI 误删或覆盖未提交的本地文件。

📌 单会话单任务

避免在长会话中塞入多个不相关的任务，防止上下文污染导致 AI 混淆任务边界，或因为上下文压缩丢失关键约束。

🗺️ 先规划再执行

适用场景：同一个需求中包含多种不同工作类型（分析、实现、验证、文档等）

正确做法：

"目录，不要修改代码，列出将权限检查迁移到 middleware 层需要改动的文件及方案，
确认后再开始修改"

错误做法：直接说"把权限检查改到 middleware 层"，AI 可能改错文件、过度重构、覆盖未提交内容。

🔗 尽量低耦合

子任务之间尽量减少相互依赖，提高子任务独立性，让多个 AI 会话可以并行工作。

🔄 最终收口

所有子任务完成后，进行最终收口检查，确保子任务之间的衔接和整体功能的完整性。

🛑 及时纠偏

当 AI 偏离预期或陷入死胡同时，及时介入，提供明确的修正方向，避免 AI 在错误的方向上盲目试错。

4.3 与 AI 沟通的技巧

示例：

五、LangGPT 生态

5.1 项目背景

Error: Parse error on line 1:
timeline   title La
^
Expecting 'open_directive', 'NEWLINE', 'SPACE', 'GRAPH', got 'ALPHA'

5.2 核心价值

📚 参考资料:

• 极客邦飞书知识库
• LangGPT 开源项目
• 小林面试笔记