Agent-First 时代：OpenAI 的 Harness Engineering 实践深度剖析

本文详细记录了OpenAI Codex团队在2025年底至2026年初进行的一项内部实验——“Harness Engineering”。实验以"Agent-First"（智能体优先）理念为核心，彻底颠覆了传统软件开发模式。一个三人团队在五个月内，从空仓库起步，构建出一个内部产品，全程零行人工手写代码，生成约100万行代码、合并1500个PR，效率约为传统手写模式的10倍。

文章深入剖析了工程师角色的革命性转变（从代码生产者到环境设计师）、知识管理的创新（从大文件到结构化生态）、Agent可读性与架构约束的重要性（约束即速度），以及挑战治理（AI Slop与技术债）。文章还探讨了这一实践对软件工程行业的深远影响和未来展望。

核心论点

• Agent-First的Harness Engineering模式可行且高效，效率提升可达10倍。
• 工程师角色必须从"代码生产者"转变为"环境设计师"和"监督者"。
• 知识管理是Agent-First模式成功的关键，需要从"大文件"转向"结构化生态"。
• 严格的架构约束和"Agent可读性"是提升速度的基石。

关键数据

• 三人团队，五个月，零人工手写代码
• 生成约100万行代码
• 合并1500个PR
• 人均日吞吐3.5个PR
• 效率约为传统手写模式的10倍
• 早期每周花20%时间手动清理AI Slop

方法论

• 人类掌舵，Agent执行：人类负责分解目标、指定意图、构建反馈循环；Agent负责具体执行。
• 渐进式披露：核心文档（AGENTS.md）只作为目录，详细知识存储在结构化的子文档中。
• 仓库即真理源头：所有对Agent有效的信息都必须存在于代码仓库中。
• 约束即速度：通过严格的架构约束和自动化检查，为Agent提供清晰的边界和规则。
• 文档园丁Agent：用于维护文档健康度的自动化工具。