AI 编码工具的 Harness 构建指南

刚搭 AI 编码工具，最容易翻车的不是写不出代码，而是权限没关好。

Claude Code 和 Codex 默认能读你电脑上的所有文件。.env、本地密钥全在危险区。沙箱默认不拦读取，只拦写入。所以必须手动配 denyRead，把敏感路径锁死。权限给得越少，用着越卡，但这是保命的事。

主指令文件 AGENTS.md 最好压在两百行内。它只当索引，告诉 AI 怎么跑项目、怎么提交。具体架构和原则，另存到 docs/ 里。/init 命令能自动生成文档，但乱项目跑出来多半是废话。建议先人工审核再启用。

记忆机制是 AI 自己往 .md 文件里写东西。主文件控制在 25KB 以内，细节让它按需去读。规则别堆太多，配置漂移比想象中更容易发生。

说白了，这套架子不是越复杂越好。先锁住权限，再理清文档，后面才不会天天替 AI 擦屁股。