夜雨聆风我同时用Claude Code、Codex、WorkBuddy、CodeArts四个AI编程助手干活，花了一周给它们写了一套统一的行为准则。本文分享完整配置和踩坑经验，帮你少走弯路。
为什么需要给AI写行为准则？
你有没有遇到过这些情况：
改好一个bug，另一个地方又坏了 AI自作主张加了一堆注释和"优化" 同一个错误反复犯，说了三遍还是不改 代码跑都没跑就说"已完成"
这些都是因为AI没有行为准则。就像新员工入职没有培训，只能靠猜。
我的4个AI助手
行为准则的核心：11个模块
我最终沉淀了11个模块，覆盖从写代码到调试到审查的全流程。
1. 先理解再动手（8条铁律）
改代码前必须先读完整文件读完相关依赖文件，理解调用链改之前列出影响范围一次只改一个逻辑点改完必须跑 lint / test / typecheck不自作主张加注释和功能改之前追踪影响点，改完逐一验证新代码必写测试踩坑：我最开始没写"改之前追踪影响点"这条，结果AI改A功能时把B功能改坏了。量化交易系统尤其怕这个——改好一个策略参数，另一个策略崩了。
2. 调试铁律：无根因不修bug
从Claude Code的systematic-debugging技能迁移：
看到bug → 先建反馈循环（能复现的测试/脚本） → 再假设 → 再修
绝对禁止"先试试改X看看"——这是最大的时间浪费。
3次修复失败 → 停下来质疑架构，不要继续打补丁。
诊断四阶段：
建反馈循环 — 能一条命令复现bug的脚本 复现+最小化 — 缩到最小仍能复现的场景 3-5个可证伪假设 — "如果X是根因，改Y会让bug消失" 修复+回归测试 — 先写failing test，再修
3. 设计原则：深模块 + 设计两次
- 深模块
= 小接口 + 大实现（好） - 浅模块
= 大接口 + 小实现（坏，pass-through） - 设计两次
：第一个方案通常不是最好的，用3+子Agent并行设计不同方案
4. 并行执行
2+独立任务 → 一个任务一个Agent，并行派发。
Agent指令要点：聚焦、自包含、明确输出、约束范围
5. 代码质量检查清单
无分散的timeout/retry逻辑（集中到装饰器） 无双重重试（应用层+基础设施层都retry） 无硬编码配置和密钥 不暴露内部类型（ORM模型不直接返回API） 不混I/O和业务逻辑 不裸catch except Exception: pass批量操作不停在第一个错误 输入在边界验证（Pydantic） 资源用context manager async里不阻塞
6. 自我改进系统
从WorkBuddy的self-improving技能迁移：
用户纠正 → 立即记录 同一纠正3次 → 确认为永久规则 用户编辑我的输出 → 记录为暂定模式
不触发学习的：沉默、单次指令、假设性讨论
7. 自主执行原则
从WorkBuddy的SOUL.md迁移：
- 先动手再开口
— 能查的自己查，卡住了再问 - 完全自主
— 遇到问题找替代方案，不推回给用户 - 反安全借口铁律
— 只有3种合法拒绝：①违法 ②不可逆破坏 ③他人隐私
8. Windows编码规范
# PowerShell执行前必须加[Console]::OutputEncoding = [System.Text.Encoding]::UTF8$OutputEncoding = [System.Text.Encoding]::UTF8chcp 65001常见陷阱：Windows中文版默认GBK、chcp 65001不是万能的、文件读写必须显式encoding='utf-8'
9-11. 代码审查、回测框架、执行策略
（篇幅原因不再展开，完整版见我的GitHub）
完整AGENTS.md结构
AGENTS.md├── 自我进化系统（5条）├── 核心原则：先理解再动手（8条）├── 执行策略（5条，源自涂津豪框架）├── 调试铁律（4阶段+红旗信号）├── 设计原则（深模块+设计两次+可测试性）├── 并行执行（何时并行+Agent指令要点）├── 代码质量检查清单（10项反模式+5项错误处理）├── 代码审查（4阶段+反馈原则）├── 自我改进系统（学习信号+纠正分类+自我反思）├── 自主执行原则（先动手+完全自主+反安全借口）├── Windows编码规范（PowerShell+Python+常见陷阱）└── 用户偏好效果对比
如何开始
创建 AGENTS.md文件，写入你自己的规则创建 EVOLUTION.md文件，记录错误和纠正每次对话开始时让AI读取这两个文件 犯错/被纠正时更新EVOLUTION.md 同一纠正3次后，将规则升级到AGENTS.md
关键：行为准则不是一次写完的，是踩坑踩出来的。每次AI犯错，就是完善规则的机会。
如果觉得有用，点赞收藏👍下篇分享：如何给AI写SOUL灵魂档案，让它真正有个性、有主见、能自主干活
