这个提示词技巧解决什么问题

昨晚刷 GitHub 发现一个很有意思的项目：**Hermes WebUI**，它在 24 小时内涨了 9889 星，热度比肩之前的 AutoGPT。简单说，它给 Hermes Agent（一个能自己写代码、执行命令的 AI 助手）套了个漂亮的可视化界面，手机也能用。

但我在测试过程中发现一个扎心的事实：大部分人的提示词太糙了。

默认的“请写一个 Python 脚本”只会让 Agent 生成一堆通用代码，你还要手动调。但好的提示词能让 Agent 一次性输出可运行的、适配你项目的代码。本文不讲废话，直接给出 3 个我在 Hermes WebUI 里反复测试过的提示词模板，你复制粘贴就能用。

核心思路：给 Agent 一个“脑子”

Hermes Agent 本质上是一个能执行任意命令的 LLM（大模型），它的优势是可以在后台跑 pip install、读你本地文件、运行测试。但这也意味着它很容易“自由发挥”——如果没有明确约束，它会写一个你不需要的复杂框架。

我的经验是：提示词至少要包含三个要素：

• 角色（Agent 以什么身份工作）
• 上下文（当前项目里有什么、你的具体需求）
• 输出格式（只输出代码、还是带解释、还是直接写文件）

下面三个模板就是按照这个思路设计的。

完整提示词模板（可直接复制）

模板 1：生成一次性可运行的代码（带依赖安装）

你是一个资深 Python 开发者。
我的项目目录是 /home/user/my_project，里面目前只有 data/input.csv（CSV 文件，有 id, name, score 三列）。

任务：写一个 Python 脚本，读取该 CSV，计算每行 score 的平均值，然后输出到 output/summary.txt（如果 output 目录不存在，自动创建）。

约束：
- 只使用标准库（csv, os, pathlib）
- 如果发现缺少依赖，先尝试用 pip install 安装，但给出提示
- 代码输出后，直接运行一次，确认能生成文件
- 运行结果用 print 输出

输出格式：先输出完整代码（用代码块），然后输出运行日志（我用来确认执行结果）。

模板 2：调试已有代码（定位 + 修复 + 验证）

你是一个代码调试专家。我的项目是 /home/user/app，目录下有 app.py 和 requirements.txt。

当前问题：app.py 第 42 行报错 "KeyError: 'username'"，当请求参数缺少 username 时。

任务：
1. 先读 app.py 和 requirements.txt 的内容
2. 定位 bug 的根因（不要只看错误行，要分析流程）
3. 给出修复方案（修改代码块）
4. 模拟一个最小请求测试，确认修复后不再报错

约束：
- 只返回最终修复后的 app.py 完整代码（不要 diff）
- 如果修复需要添加依赖，一并安装并更新 requirements.txt
- 运行一遍测试后告诉我是否通过

模板 3：文件批量操作（安全执行）

你是一个文件处理助手。当前工作目录 /home/user/docs，里面有大量 .txt 文件。

任务：把所有 .txt 文件中的电话号码（格式如 138-1234-5678 或 13812345678）替换为 "[隐私脱敏]"，生成新文件到 /home/user/docs_cleaned 目录，原文件不动。

约束：
- 使用正则表达式匹配，并打印每个文件被替换的号码数量
- 如果目标目录已存在，询问我是否覆盖，不要直接删除
- 处理前先列出所有待处理的文件列表，让我确认（输入 y 继续）
- 执行完毕后打印总结（处理了多少个文件，共替换了多少个号码）

效果演示：差 Prompt vs 好 Prompt

我在 Hermes WebUI 里用模板 1 做了测试。

❌ 差 Prompt（常见写法）

写个 Python 脚本统计 CSV 里的分数平均值。

Agent 输出：一段读取数据的代码，没有指定文件名，用了 pandas（需要安装），输出是 print 到控制台而不是文件。之后它自己装 pandas，但我的项目里没有 pandas，浪费了 30 秒还会报错。

✅ 好 Prompt（用模板 1）

Agent 行为：

1. 先读取 data/input.csv 确认格式
2. 用标准库写脚本，自动创建 output 目录
3. 运行脚本，生成了 summary.txt，内容如 Average Score: 78.5
4. 输出日志显示执行成功

整个过程没有多余提问，一次性完成。关键是：它没有擅自改我的项目结构，严格遵守了约束。

变体和注意事项

变体 1：让 Agent 做代码审查

把模板 2 的“调试”改成“审查”：不执行业务逻辑，只检查潜在的安全漏洞、性能问题。在约束里加上“列出每个问题及其严重等级（高/中/低）”。

变体 2：让 Agent 写单元测试

在模板 1 的最后加一句：“然后为这个脚本写 pytest 单元测试（test_目录下），覆盖正常输入、空文件、文件不存在三种情况”。Agent 会自动创建 test_summary.py 并运行。

注意事项

• Hermes WebUI 默认有文件写权限，如果提示词里没给目录绝对路径，它可能会写到临时目录。建议显式指定 当前工作目录：/absolute/path。
• 长任务容易超时，如果你让 Agent 一次做很多事，它可能中途断掉。建议拆成两步：先生成代码，再手动决定是否让它执行。可以在模板里加一句“先输出代码，等我确认后再运行”。
• **Agent 会执行 pip install**，但可能会破坏你的虚拟环境。如果你用的是 conda 或 venv，最好在提示词里声明“使用当前虚拟环境的 pip”，否则它会装到全局。

终极建议

别把 Hermes WebUI 当成“一键生成器”，它是个有智商的实习生。你给的提示词越清晰，它越能帮你干活。这三个模板我花了一周调出来的，你拿去就能用。如果遇到奇怪的行为，可以微调约束里的“如果……就……”条件。

最后提醒：所有 Agent 生成的代码，至少在本地跑一遍测试。我有一次让它写删除日志的脚本，它直接写了个 shutil.rmtree，差点把整个项目删了。所以我的模板里都会加“先打印要删除的文件列表让我确认”。安全第一，这很值得。