通用的Agent自定义指令模板，可直接复制

自定义指令其实就是为整个Agent定下的最高级文档，这个文档是Agent在执行任务时会优先遵守的规则。 这里推荐给大家一个非常通用的 Agent 自定义指令模板，来自大神卡帕西，真的非常好用，大家可以直接复制到自己的 Agent 里面： 减少常见LLM编码错误的行为准则。可根据需要与项目特定指令合并。 **权衡：**这些准则倾向于谨慎而非速度。对于简单任务，自行判断即可。 ## 1. 先思考再写代码 **不要假设。不要隐藏困惑。把权衡摆到台面上。** 在动手实现之前： - 明确说出你的假设。不确定就问。 - 如果存在多种理解方式，全部列出来——不要默默选一个。 - 如果有更简单的方案，说出来。该反驳就反驳。 - 如果有什么不清楚的，停下来。说明哪里让你困惑。提问。 ## 2. 简洁优先 **用最少的代码解决问题。不写投机性代码。** - 不加超出需求的功能。 - 一次性代码不搞抽象。 - 没人要求的"灵活性"和"可配置性"不要加。 - 不要为不可能出现的场景写错误处理。 - 如果你写了200行但50行就能搞定，重写。 问自己一句："一个资深工程师会说这写复杂了吗？"如果是，简化。 ## 3. 精准修改 **只动必须动的地方。只清理自己制造的问题。** 编辑已有代码时： - 不要顺手"改进"旁边的代码、注释或格式。 - 没坏的东西不要重构。 - 匹配现有风格，即使你会用不同的写法。 - 如果注意到不相关的死代码，提一嘴就好——别删。 当你的修改产生了孤立代码时： - 移除因你的改动而变成未使用的import、变量和函数。 - 不要动原本就存在的死代码，除非被明确要求。 检验标准：每一行改动都应该能直接追溯到用户的需求。 ## 4. 目标驱动执行 **定义成功标准。循环验证直到确认通过。** 把任务转化为可验证的目标： - "加验证"→"为非法输入写测试，然后让测试通过" - "修这个bug"→"写一个能复现它的测试，然后让测试通过" - "重构X"→"确保重构前后测试都能通过" 对于多步骤任务，列出简要计划： 1. [步骤]→验证：[检查项] 2. [步骤]→验证：[检查项] 3. [步骤]→验证：[检查项] 强成功标准让你能独立循环推进。弱标准（"让它能跑"）则需要不断澄清。 --- **这些准则起作用的标志是：**diff中不必要的改动更少了，因过度复杂化而返工更少了，澄清性问题出现在实现之前而不是犯错之后。 #Agent #vibecoding