WorkBuddy 高效 Prompt 编写指南Skill
我用 WorkBuddy 的第一个月，走了很多弯路。后来总结出一套方法，把“生成代码准确率”从大概 60% 提升到了 90% 以上。今天全部分享给你。
49%
51%
高效 Prompt 的黄金公式
在写任何 Prompt 之前，先问自己五个问题：
角色 + 任务 + 上下文 + 约束 + 输出格式 = 高质量 Prompt
#vvTQiAewvEWJ text { white-space: pre; }#vvTQiAewvEWJ .fb0 { stroke: var(--N900-FG, 0.15); }#vvTQiAewvEWJ .fb0 {stroke: rgba(31,35,41, 0.15)}#vvTQiAewvEWJ .fx0 { stroke-miterlimit: 10; }#vvTQiAewvEWJ .fx0 {stroke-miterlimit: 10}#vvTQiAewvEWJ .fa1 { fill: rgb(187, 191, 196); }#vvTQiAewvEWJ .fa1 {fill: rgb(187, 191, 196)}#vvTQiAewvEWJ .fx1 { font: 400 12px MonospacedNumber, LarkHackSafariFont, LarkEmojiFont, LarkChineseQuote, -apple-system, BlinkMacSystemFont, "Helvetica Neue", Tahoma, "PingFang SC", "Microsoft Yahei", Arial, "Hiragino Sans GB", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; }#vvTQiAewvEWJ .fx1 {font-style: normal}#vvTQiAewvEWJ .fx2 { text-anchor: middle; }#vvTQiAewvEWJ .fx2 {text-anchor: middle}#vvTQiAewvEWJ .fx3 { dominant-baseline: central; }#vvTQiAewvEWJ .fx3 {dominant-baseline: central}#vvTQiAewvEWJ .fx4 { stroke: none; }#vvTQiAewvEWJ .fx4 {stroke: none}#vvTQiAewvEWJ .fc0 { fill: var(--text-caption); }#vvTQiAewvEWJ .fc0 {fill: #646a73}#vvTQiAewvEWJ .fa2 { fill: var(--text-link-disabled); }#vvTQiAewvEWJ .fa2 {fill: rgb(187, 191, 196)}#vvTQiAewvEWJ .fa3 { fill: rgb(248, 248, 250); }#vvTQiAewvEWJ .fa3 {fill: rgb(248, 248, 250)}#vvTQiAewvEWJ .fx5 { font: 700 14px MonospacedNumber, LarkHackSafariFont, LarkEmojiFont, LarkChineseQuote, -apple-system, BlinkMacSystemFont, "Helvetica Neue", Tahoma, "PingFang SC", "Microsoft Yahei", Arial, "Hiragino Sans GB", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; }#vvTQiAewvEWJ .fx5 {font-style: normal}#vvTQiAewvEWJ .fx6 { text-anchor: start; }#vvTQiAewvEWJ .fx6 {text-anchor: start}#vvTQiAewvEWJ .fx7 { dominant-baseline: alphabetic; }#vvTQiAewvEWJ .fx7 {dominant-baseline: alphabetic}#vvTQiAewvEWJ .fc1 { fill: rgb(51, 51, 51); }#vvTQiAewvEWJ .fc1 {fill: rgb(51, 51, 51)}#vvTQiAewvEWJ .fx8 { font: 400 14px MonospacedNumber, LarkHackSafariFont, LarkEmojiFont, LarkChineseQuote, -apple-system, BlinkMacSystemFont, "Helvetica Neue", Tahoma, "PingFang SC", "Microsoft Yahei", Arial, "Hiragino Sans GB", sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol", "Noto Color Emoji"; }#vvTQiAewvEWJ .fx8 {font-style: normal}#vvTQiAewvEWJ .fc2 { fill: rgb(0, 82, 217); }#vvTQiAewvEWJ .fc2 {fill: rgb(0, 82, 217)}#vvTQiAewvEWJ .fb1 { fill: var(--N900-FG, 0.15); }#vvTQiAewvEWJ .fb1 {fill: rgba(31,35,41, 0.15)}#vvTQiAewvEWJ .fb2 { fill: rgb(225, 228, 233); }#vvTQiAewvEWJ .fb2 {fill: rgb(225, 228, 233)}#vvTQiAewvEWJ .fa4 { fill: var(--bg-body); }#vvTQiAewvEWJ .fa4 {fill: #fff}ABC123456要素角色任务上下文约束输出格式问题示例你希望 AI 扮演什么角色？具体要做什么？项目背景、技术栈、已有代码？有什么限制条件？希望以什么形式返回？“你是一位资深 后端工程师”“帮我写一个用户登录接口”“使用 Flask + Alchemy，已有 User 模型”“必须防止 SQL 注入，密码要哈希存储”“给出完整代码、依赖列表和测试用例”PythonSQL
这五个要素就像给 AI 一张清晰的工单。信息越完整，AI 返回的结果越接近你的预期。
下面这张对比图，能直观看到“模糊 Prompt”和“高效 Prompt”的差异：
52%
48%
高效 Prompt 编写五步流程
理解了五要素之后，怎么落地？我总结了下面五步流程：
第五步“迭代优化”往往被忽略，但它是最关键的一步。
AI 很少能一次给出完美答案。你需要把它的输出当作“初稿”，然后像审阅同事代码一样，指出问题、补充信息、要求调整。
实战案例：从“不及格”到“优秀”的 Prompt
下面我用一个真实需求，演示如何逐步优化 Prompt。
场景：生成一个 Flask 用户注册接口
❌ 版本一：不及格
代码语言：JavaScript
自动换行
AI代码解释
代码块
Plain Text
帮我写个注册接口
问题分析：
•
不知道是什么语言/框架
•
不知道注册需要什么字段
•
不知道数据库用哪种
•
不知道要不要验证、密码加密、错误处理
WorkBuddy 可能的输出：一个非常简单、不够完整的示例，可能还需要你大量补充。
⚠️ 版本二：及格线
代码语言：JavaScript
自动换行
AI代码解释
代码块
Plain Text
用 Python Flask 写一个用户注册接口，包含用户名、密码、邮箱字段，数据存入 MySQL。
提升点：指定了语言、框架、字段和数据库。
还缺少：验证规则、密码加密、错误处理、返回格式、是否使用 ORM。
✅ 版本三：优秀
展开
代码语言：JavaScript
自动换行
AI代码解释
代码块
Plain Text
这个 Prompt 的亮点：
•
✅ 指定了角色（经验丰富的后端工程师）
•
✅ 指定了技术栈（Flask + SQLAlchemy）
•
✅ 列出了每个字段的具体规则
•
✅ 明确了安全要求
•
✅ 要求了返回格式和额外输出
•
✅ 要求可直接运行
WorkBuddy 的 output 几乎可以直接落地，你只需做少量调整就能用到项目里。
📋 六大常见场景 Prompt 模板
把下面这些模板保存下来，用的时候填空即可。
模板一：代码生成
代码语言：JavaScript
自动换行
AI代码解释
代码块
Plain Text
你是一位 [角色]。请使用 [技术栈] 编写 [功能描述]，要求：
1. 输入：[输入参数说明]
模板二：代码解释
代码语言：JavaScript
自动换行
AI代码解释
代码块
Plain Text
请解释下面这段代码的功能和实现逻辑。如果存在潜在问题，请指出并给出改进建议。
【粘贴代码】
模板三：代码重构
展开
代码语言：JavaScript
自动换行
AI代码解释
代码块
Plain Text
请重构下面这段代码，要求：
1. 提高可读性
2. 减少重复代码
3. 保持原有功能不变
4. 添加必要的注释
【粘贴代码】
模板四：Bug 修复
展开
代码语言：JavaScript
自动换行
AI代码解释
代码块
Plain Text
下面这段代码运行时报错，错误信息如下：
【粘贴错误信息】
相关代码：
【粘贴代码】
请帮我定位问题并给出修复方案，同时说明原因。
模板五：生成测试用例
展开
代码语言：JavaScript
自动换行
AI代码解释
代码块
Plain Text
模板六：技术方案设计
展开
代码语言：JavaScript
自动换行
AI代码解释
代码块
Plain Text
⚠️ 写 Prompt 时的五大常见错误
错误一：过于模糊
❌ “帮我写个登录” ✅ “用 Python Flask 写一个包含密码校验、JWT Token 生成和错误处理的登录接口”
错误二：缺少上下文
❌ “这段代码为什么这么慢？” ✅ “这段 Python 函数处理 10 万条 CSV 记录需要 30 秒，数据量在 1-50 万之间，请帮我优化性能。”
错误三：一次提太多需求
❌ “帮我设计一个电商系统，包括用户、订单、支付、库存、物流模块，还要考虑高并发和安全。” ✅ 拆分成多个 Prompt，先设计整体架构，再逐个模块细化。
错误四：不说明输出格式
❌ “解释一下 RESTful API” ✅ “请用表格形式对比 RESTful API 和 RPC 的异同，包含定义、优缺点、适用场景三列。”
错误五：不迭代
❌ 第一次输出不满意，就放弃使用。 ✅ 把 AI 当作初稿工具，通过“这里不对”“请补充…”“请用…方式重写”持续优化。
🚀 五个让 WorkBuddy 输出更稳的进阶技巧
技巧一：给 AI 设定角色
在 Prompt 开头加上角色设定，输出会更专业：
代码语言：JavaScript
自动换行
AI代码解释
代码块
Plain Text
你是一位有 10 年经验的 Python 后端架构师…
你是一位擅长前端性能优化的资深工程师…
你是一位熟悉 Vue3 + TypeScript 的全栈开发者…
技巧二：用结构化格式描述需求
使用编号列表、Markdown 表格、JSON 格式，比大段文字更容易让 AI 理解：
展开
代码语言：JavaScript
自动换行
AI代码解释
代码块
Plain Text
需求如下：
1. 功能：用户注册
2. 字段：
- username: string, 6-20 字符
- password: string, 至少 8 位
- email: string, 邮箱格式
3. 约束：密码必须加密，接口必须防 SQL 注入
4. 输出：完整代码 + 测试用例
技巧三：提供示例（Few-shot）
如果你想要的输出格式比较特殊，先给一个例子：
展开
代码语言：JavaScript
自动换行
AI代码解释
代码块
Plain Text
请按照下面的格式返回结果：
示例：
{
"success": true,
"data": {
"id": 1,
"name": "test"
}
技巧四：主动要求它提问
如果你对需求也不完全确定，可以让 AI 先帮你澄清：
代码语言：JavaScript
自动换行
AI代码解释
代码块
Plain Text
我想做一个文件上传功能，但还没想清楚细节。请你先问我 5 个关键问题，帮我明确需求。
技巧五：建立个人 Prompt 库
把常用的 Prompt 保存到笔记里，复用效率更高。比如：
•
生成 CRUD API 模板
•
解释代码 + 找 Bug
•
生成 pytest 测试用例
•
重构老旧代码
•
写技术文档
🧠 一个真实的迭代案例
我再分享一个我实际使用 WorkBuddy 时的迭代过程。
第一轮 Prompt：
代码语言：JavaScript
自动换行
AI代码解释
代码块
Plain Text
WorkBuddy 输出：一个基础的 Python 脚本，按行读取、正则匹配、计数。
我发现的问题：
•
日志格式是 Nginx 的，但 AI 默认用了通用正则
•
没有处理日志轮转（多个日志文件）
•
输出是打印到控制台，不是文件
第二轮 Prompt：
代码语言：JavaScript
自动换行
AI代码解释
代码块
Plain Text
请优化这个脚本，要求：
WorkBuddy 输出：直接可用，代码质量很高。
第三轮 Prompt：
代码语言：JavaScript
自动换行
AI代码解释
代码块
Plain Text
请再为这个脚本添加异常处理：日志格式不合法时跳过并记录到 error.log；输出文件已存在时覆盖但先备份；添加进度显示。
最终得到的代码，基本可以直接部署到服务器上。
📝 总结：让 WorkBuddy 成为你的编程搭档
写好 Prompt 的本质，是学会清晰地表达需求。
这个能力不仅对 AI 有用，对你和同事沟通、写需求文档、做技术评审也大有裨益。
记住这个黄金公式：
角色 + 任务 + 上下文 + 约束 + 输出格式 = 高质量 Prompt
以及这五步流程：
明确需求
提供上下文
设定约束
指定输出
迭代优化
当你习惯了这种表达方式，你会发现 WorkBuddy 越来越“懂你”。它不再是冷冰冰的代码生成器，而是真正能和你一起解决问题的编程搭档。