分析近 3000 个真实仓库,给出 AI 编码 Agent 配置最佳路径
JohnAlexander · x · 2026-09-13
一篇《How to Design an Agent Harness》文章基于对近 3000 个真实仓库的扫描,总结了八种编码 Agent 配置方式的实际使用情况,并给出推荐顺序:
- 从 context file 开始,且仅此而已:写清构建/测试命令、代码约定、Agent 不能碰什么,为「周一入职的新人」而写。大多数有效配置止步于此。
- 命名为 AGENTS.md 而非 CLAUDE.md:所有主流工具都读 AGENTS.md,Claude Code 除外——保留一个两行的 CLAUDE.md 指向它即可,维护单文件。从 CLAUDE.md 起家的仓库也在反向迁移。
- 其余配置(如 hooks、多 agent 等)应等 context file 打磨好后数月再逐步添加。
文章还针对「Agent 声称完成但测试没跑」「20 分钟后忘记初始规则」「每会话重打三行指令」等常见痛点给出 harness 设计方案。
「编程与Agent」频道最新
- effect-harness + Cloudflare：agent 循环自由拆到多台 VM 上跑 — samgoodwin89 · 2026-10-31
- jh3yy：AI agent 第一次让工具跟上我的大脑，找回心流 — jh3yy · 2026-10-31
- CAFE 生态周报：Maple 三天迁移 30 万行 React 到 Foldkit — samgoodwin89 · 2026-10-31
- 二十年没写代码，他用 Claude 做出百星开源 TV 启动器 — SuB8u · 2026-10-31
- Factory 收购 typedef_ai，为 AI agent 补上企业数据上下文层 — maddiehfaulkner · 2026-10-31
- 浏览器 Agent 丢链后图搜索救场:5/5 对单轨迹回放 0/5,作者主动更正数据 — JeremyCMorgan · 2026-10-31