LangGPT 结构化提示词上手指南：从角色模板到可复用提示词
【免费下载链接】LangGPTLangGPT: Empowering everyone to become a prompt expert! 🚀 📌 结构化提示词（Structured Prompt）提出者 📌 元提示词（Meta-Prompt）发起者 📌 最流行的提示词落地范式 | Language of GPT The pioneering framework for structured & meta-prompt design 10,000+ ⭐ | Battle-tested by thousands of users worldwide Created by 云中江树项目地址: https://gitcode.com/gh_mirrors/la/LangGPT
当你需要反复完成同一类任务——整理会议纪要、讲解数据分析术语、生成健身计划——每次都临时组织一段指令，输出质量就时好时坏。LangGPT 就是一个结构化、可复用的提示词设计框架：把提示词像写文章或写代码一样拆成 Role、Rules、Workflow 等模块，用一份 LangGPT 结构化提示词写一次，长期复用。
项目速览：提示词的模板化写法
一句话定义：LangGPT 是 2023 年由云中江树提出的结构化提示词范式，官方 README 把它比作"提示词的编程语言"——系统化、模板化、可扩展。
它适合谁：经常用大模型处理重复任务、希望结果可复现、提示词可以交接和维护的人。与自由发挥写法的差别如下：
| 自由发挥写提示词 | LangGPT 结构化提示词 | |
|---|---|---|
| 形式 | 一段连续的文字 | 分层 Markdown 模块（Role、Rules、Workflow……） |
| 修改 | 动一句往往要重写整段 | 只改对应模块，Profile 里用 Version 记录版本 |
| 复用 | 每次重新描述需求 | 改几个变量或占位符即可再次使用 |
| 交接 | 对方看不懂你的意图 | 结构自带说明，别人接手即可维护 |
| 模型要求 | 任意模型都能用 | 在 GPT-4、Claude 等强模型上表现最佳 |
上图来自 论文中文版：LangGPT 的思路就是借编程语言"函数—类—软件"的分层思想，组织"指令—模块—完整提示词"。
🧭 快速上手：三步写出第一个结构化提示词
本节回答"我现在到底该做什么"。
前置准备
- 一个大模型账号，推荐 GPT-4 或 Claude；GPT-3.5 官方评价为"勉强可用"，需要时降低结构层级
- 基本的 Markdown 语法（
#标题、-列表） - 需要浏览模板与示例时，克隆仓库：
git clone https://gitcode.com/gh_mirrors/la/LangGPT
三步操作
- 复制一个模板骨架：轻量任务用 miniRole，功能更全（含 Commands、Reminder）用 baseRole
- 按顺序填充五个模块：Role（角色名）→ Profile（作者、版本、语言、描述与技能）→ Rules → Workflow → Initialization
- 把整段 Markdown 粘贴到大模型对话框，开始对话
Initialization 是整个模板的"启动脚本"，负责把前面定义的模块串起来：
## Initialization As a/an <Role>, you must follow the <Rules>, you must talk to user in default <Language>, you must greet the user. Then introduce yourself and introduce the <Workflow>.确认成功的标志：模型第一句话以角色身份自我介绍，主动说明交互流程，并按你指定的格式等待输入。如果它只是正常应答而没有进入角色，回头检查五个模块名是否写全、变量名是否与模块名一致。参考 examples/chinese_poet 模板的实际效果：
核心概念拆解：读懂模板里的五个模块
这一节解释"模板为什么这么写"，五个概念按依赖顺序排列。
模板结构：Role 与 Profile
Role 用一级标题定义"AI 是谁"，Profile 是它的"简历"。顶层的# Role告诉模型：后面所有内容都在描述你。
# Role: Your_Role_Name ## Profile - Author: YZFly - Version: 0.1 - Language: 中文 - Description: 一句话说明角色是谁、会做什么要点：#、##这类标识符控制层级，Role、Profile、Rules 这类属性词是语义标签，二者都可以替换成你习惯的写法（中文项目里用"角色/规则/工作流程"也常见），但全篇要前后一致。
变量：让提示词自我引用
变量用尖括号引用前面已定义的模块，一次书写、全篇一致。
作为 <Role>，严格遵守 <Rules>，使用默认 <Language> 与用户对话。要点：<Rules>引用的是整个 Rules 模块的内容，不是"rules"这个词本身。变量名必须与模块标题完全一致，否则引用落空。
Rules：划定行为边界
Rules 是必须遵守的硬约束清单，用来压住幻觉、出戏和跑题。
## Rules 1. 不要在任何情况下破坏角色设定 2. 不要编造事实要点：这里只放"禁止/必须"类条目，别把技能描述塞进来——技能属于 Profile，混放会稀释约束力。
Workflow：规定交互步骤
Workflow 是编号对话步骤，决定模型按什么顺序推进。
## Workflow 1. 先讲这个概念的由来 2. 再讲它是什么、为了解决什么问题 3. 最后结合用户场景讲怎么用要点：一步一个动作，步骤之间要有先后逻辑；步骤越明确，输出的顺序和粒度越可控。
Initialization 与 Commands：启动行为和快捷指令
Initialization 定义开场行为（见快速上手一节）；Commands 给对话加"/"前缀的快捷操作，来自 baseRole 模板：
## Commands - Prefix: "/" - Commands: - help: 介绍自己与命令用法 - continue: 输出中断时从上次的断点继续要点：长对话里输出截断、忘记角色设定是高频问题，/continue、/help这类命令是最省事的补救手段。
场景实践：把三类任务写成可复用的提示词
以下三个场景都基于 examples/ 目录里的真实文件改写，你换掉内容就能直接用。
整理会议纪要：固定输出骨架
目标：把零散的会议记录整理成结构固定的纪要（背景、决策、待办）。写法要点：把纪要的板块结构写成 Template 模块，让 Workflow 按结构填充；Rules 里加一条"只依据用户提供的记录，不补全未提及的内容"。
## Template - Name: 会议纪要结构 - Content: 一、会议背景 二、关键决策 三、待办事项（含负责人与截止时间）效果与可调整项：输出可直接贴进文档。想要周报口吻，就在 Rules 补一句风格约束；想让模型先追问缺失信息，在 Workflow 第一步写"先确认会议主题与参会人"。
数据分析术语讲解：限定知识边界
目标：任何数据分析术语、工具、方法，都按"由来 → 是什么 → 怎么用"三步讲清楚，参考 examples/数据分析.md。写法要点：用 Goals 模块圈定任务范围，用 Constraints 压住编造。
## Constraints 1. 对于不在你知识库中的信息，明确告知用户你不知道 2. 不进行没意义的夸奖和客气对话效果与可调整项：输出固定为三段式，"怎么用"部分会停下来等用户给场景。需要代码示例时，在 Workflow 第三步加"附真实代码片段或实现步骤"。
个性化健身计划：用占位符收集信息
目标：填入年龄、身高、目标等个人信息，拿到饮食加运动计划，参考 examples/Make_Custom_Fitness_Plan。写法要点：在 Profile 里用#开头的占位符列出待填信息，使用时逐个替换。
2. I am #Age years old, #Gender, #Height. 3. My current weight is #Currentweight. 4. My primary fitness and health goals are #PrimaryFitnessHealthGoals.效果与可调整项：该模板的 Workflow 已约定依次产出"计划摘要 → 运动程序 → 餐食计划 → 购物清单"。想要按周循环的计划，把 Workflow 中"Create a detailed workout program"一行改成按周拆分即可。
避坑指南：新手高频错误对照
| 错误写法 | 建议写法 | 原因 |
|---|---|---|
| 一整段文字："你是专家，请帮我……注意要专业" | 拆成 Role、Profile、Rules、Workflow 模块 | 层级结构让模型识别每段的作用范围 |
变量写成<rules>，模块标题却是Rules | 名称与标题完全一致 | 不一致时变量无法解析到正确内容 |
| 技能堆进 Rules："必须擅长写 Python，必须擅长调试" | 技能放 Profile；Rules 只放"不破角色、不编造事实" | Rules 装边界，混放会让约束互相干扰 |
| Workflow 只写"回答用户的问题" | 拆成 3~5 个带明确动作的编号步骤 | 没有步骤，输出顺序和粒度无法控制 |
| 结尾没有 Initialization | 补一句串联<Role>、<Rules>、<Workflow>的启动指令 | 缺启动指令，模型不会主动进入角色 |
❓ 常见问题
问：使用 LangGPT 需要安装环境或调 API 吗？
不需要。它是一套写法加模板，产物就是一份 Markdown 文本，粘贴进任意主流模型的对话框即可。克隆仓库只是为了方便浏览 templates/ 和 examples/ 里的文件。
问：模型能力弱一点，结构化提示词还有效吗？
官方论述建议首选 GPT-4，Claude 次之，GPT-3.5 勉强可用。弱模型上表现不佳时，可以降低结构层级（比如只保留二级标题）、简化属性词，然后小步迭代。
问：属性词一定要用英文吗？
不必。Role、Profile、Rules 本质是语义标签，文档明确说标识符和属性词都可以替换成你喜欢的符号和文字，中文项目用"角色/简介/规则/工作流程"完全可行，关键是全篇一致。
问：同一个提示词迭代多个版本，怎么管理？
在 Profile 里记录 Author 和 Version，每次修改递增 Version；提示词是纯文本，也可以直接用 Git 做版本管理。生态里还有专门做提示词语义版本管理的项目 PromptVer，可在 README 的 Ecosystem 一节查到。
问：一个提示词搞不定的多步任务怎么办？
参考 Docs/PromptChain.md：把大任务拆成多个结构化提示词协同，每个提示词负责一步，用固定的输入输出约定串联。
资源导航
- README / 简体中文版：项目介绍、五种快速开始方式、生态与社区入口
- LangGPT/templates/：miniRole、baseRole、autoGPT 等开箱即用的模板骨架
- examples/：诗人、健身计划、数据分析等可直接套用的结构化提示词
- Docs/HowToWritestructuredPrompts.md：结构化提示词最系统的论述，讲清楚"为什么这么写"
- Docs/PromptChain.md：提示链与多提示词协同，适合处理复杂任务
- Papers/LangGPT_paper_cn.md：结构化可复用提示词设计的学术论文中文版
结尾
挑一件你这周一定会重复做的事——会议纪要、周报、术语讲解——复制 LangGPT/templates/miniRole.md，填完五个模块粘贴给大模型试跑一遍。当天你手上就会有一份能反复使用的结构化提示词。
【免费下载链接】LangGPTLangGPT: Empowering everyone to become a prompt expert! 🚀 📌 结构化提示词（Structured Prompt）提出者 📌 元提示词（Meta-Prompt）发起者 📌 最流行的提示词落地范式 | Language of GPT The pioneering framework for structured & meta-prompt design 10,000+ ⭐ | Battle-tested by thousands of users worldwide Created by 云中江树项目地址: https://gitcode.com/gh_mirrors/la/LangGPT
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
