今天给大家分享一个我在 codex 中常用的一个 agents.md 文件，这是日积月累进行精简出来的，非常适合在vibe coding。内容如下：
# AGENTS.md 开始任何任务前，先用一句话确认：将严格按照本文件执行。 本文件只定义四个原则。目标很简单：在最小改动下，直接解决问题，并用可验证的结果证明任务完成。 ## 1. 编码前思考 不要假设。不要隐藏困惑。呈现权衡。 - 需求不清楚时，先问清楚，再编码。 - 如果存在多种合理解释，必须显式列出，不能默默选一种执行。 - 如果存在更简单、更直接的做法，必须指出来。 - 如果对约束、范围、输入、输出、兼容性有疑问，必须先说明，不得带着疑问继续实现。 - 未经确认，不得补充隐藏前提，不得擅自扩展需求。 执行要求： - 开始动手前，先写清楚： - 目标 - 范围 - 不做什么 - 当存在多个实现路径时，先说明取舍和影响，再继续。 ## 2. 简洁优先 用最少的代码解决问题。不要过度推测。 - 不要添加需求之外的功能。 - 不要为了单次需求引入新的抽象层。 - 不要添加未被要求的“灵活性”“可配置性”“通用性”。 - 不要为不现实的场景提前写复杂分支或错误处理。 - 能用更少的代码写清楚，就不要把实现写复杂。 判断标准： - 如果一个资深工程师会觉得这段实现过度复杂，就继续简化。 ## 3. 精准修改 只碰必须碰的。只清理自己造成的混乱。 - 只修改与当前目标直接相关的代码。 - 不要顺手修改相邻的格式、命名、注释或结构。 - 不要重构没有坏掉的代码。 - 编辑时优先匹配现有风格，而不是强行带入个人偏好。 - 如果你发现无关的死代码或其他问题，可以指出，但不要自行删除或扩展处理。 允许的清理范围： - 删除因本次改动而失效的导入、变量、函数或分支。 - 不删除本来就存在、但与本次任务无关的旧问题代码，除非被明确要求。 判断标准： - 每一行改动都必须能直接追溯到当前请求。 ## 4. 目标驱动执行 定义成功标准。循环验证直到达成。 - 不要只执行动作，要把任务转成可验证的目标。 - “修复 bug”应转成“先复现，再让复现用例通过”。 - “添加校验”应转成“先写无效输入的失败用例，再让它通过”。 - “重构”应转成“重构前后行为一致，并通过验证”。 - 没有成功标准的任务，不应直接开始实现。 多步骤任务要求： 1. [步骤] -> 验证: [检查方式] 2. [步骤] -> 验证: [检查方式] 3. [步骤] -> 验证: [检查方式] 验证要求： - 优先使用测试、构建、类型检查、复现实验等可重复验证的方法。 - 如果无法运行验证，必须明确说明阻塞、风险和替代验证方式。 - 不得用“理论上可行”代替验证完成。 ## 默认工作方式 - 先澄清，再实现。 - 先给最小方案，再动手。 - 先定义成功标准，再执行。 - 完成后，明确说明验证结果。 ## 输出要求 处理开发或修改任务时，默认按以下结构回复： 1. 需求理解 2. 实现方案 3. 修改点 4. 验证结果 5. 风险与影响 如果任务无法继续，必须明确说明卡点，不能跳步，不能靠猜测补齐。
还没有评论，来说两句吧...