企业官网建设流程全解析

Prompt Engineering Guide：5 分钟跑通提示工程完整实战指南

【免费下载链接】Prompt-Engineering-Guide🐙 Guides, papers, lessons, notebooks and resources for prompt engineering, context engineering, RAG, and AI Agents.项目地址: https://gitcode.com/GitHub_Trending/pr/Prompt-Engineering-Guide

Prompt-Engineering-Guide 是一个开源文档站，主题就一件事：提示工程（把指令写得让模型答得准的那套方法）。它把 17 种提示技巧、各主流模型指南、RAG 与 Agent 章节、可运行的 notebook 全部整合在一起，clone 到本地跑起来就能读。

⚡ 最短路径跑起来

1. 拿到源码，进到项目目录：

git clone https://gitcode.com/GitHub_Trending/pr/Prompt-Engineering-Guide cd Prompt-Engineering-Guide

2. 装依赖（需要 Node ≥ 18，没有 pnpm 就先执行npm i -g pnpm）：

pnpm install

3. 启动开发服务器：

pnpm dev

4. 浏览器打开http://localhost:3000/。成功后你会看到一个多语言文档站，左侧导航分 Introduction、Techniques、Models、Risks 等章节，点进去就是带提示词示例的正文。

🧠 两个最提效的技巧

项目把提示技巧按"给不给例子"组织成一条谱系：

重点说 CoT。官方用一个苹果的例子讲得很直白：只问"买了 10 个苹果，送邻居 2 个、修理工 2 个，又买 5 个、吃了 1 个，剩几个"，模型会答 11，是错的；在问题后加一句"让我们一步步思考"，它就按步计算给出正确答案。

更进一步是 ReAct（Reason + Act）：模型先输出 Thought（我在想什么），再执行 Act（比如一次搜索），看到 Obs（搜索结果）后继续下一轮循环，最后才给答案。推理和检索就这样串起来了。

🎯 一个完整小例子

场景：让模型扮演"技术口吻的 AI 研究员"回答黑洞问题。

1. 在系统提示（system prompt，相当于给模型立的规矩）里写：You are an AI research assistant. You use a tone that is technical and scientific.
2. 用户提问：Can you tell me about the creation of black holes?
3. 模型用术语和科学口吻回答黑洞的成因，全程不发散闲聊——角色被锁死在系统提示里，输出风格就稳定了。

想搭更大的东西，项目里也有现成架构图，比如一个深度研究 Agent 的分层设计（前端、API、Agent、工具各层职责一目了然）：

✂️ 让效果更好的 3 个做法

• 误区：一句长话塞所有要求→ 正确做法：按"角色 + 任务 + 约束 + 输出格式"四段拆开写，参考 pages/introduction/ 里的 Prompt Elements 一节。
• 误区：例子给得越多越好→ 正确做法：少样本 2~5 个就够，且正例反例都要有，多了反而拖慢速度、稀释重点。
• 误区：温度一律设 0 最保险→ 正确做法：分类、数学题用 0 附近，创意写作拉到 0.7 以上，具体对照 Settings 章节的说明。

🛠️ 踩坑速查：最常见的 4 个问题

问题：pnpm 命令不存在原因：没装 pnpm。 解决：先npm i -g pnpm；嫌麻烦也可以直接用npm install和npm run dev替代。

问题：启动报错或秒退原因：Node 版本低于 18。 解决：升级 Node 到 18+ 再跑pnpm dev。

问题：3000 端口被占用原因：别的服务占着。 解决：换个端口，如pnpm dev -p 3001。

问题：想读中文版却看到英文原因：站点按语言拆分文件，中文内容在.zh.mdx里，个别章节可能还没译完。 解决：在 pages/ 下找对应的.zh.mdx文件，缺翻译的地方也是你能参与贡献的入口。

📚 接下来去哪看

• 入门顺序：guides/prompts-intro.md → guides/prompts-basic-usage.md
• 技巧详解：pages/techniques/，17 种技巧每篇都带可抄的提示词
• 动手练习：notebooks/ 有可运行的 Jupyter 示例，lecture/ 里还有一份 1 小时讲义 PDF

先跑通上面三条命令看到文档站，再挑 CoT 或 ReAct 一篇边读边在对话框里敲提示词，半小时内你就会有体感。

【免费下载链接】Prompt-Engineering-Guide🐙 Guides, papers, lessons, notebooks and resources for prompt engineering, context engineering, RAG, and AI Agents.项目地址: https://gitcode.com/GitHub_Trending/pr/Prompt-Engineering-Guide