“Harness Engineering” 是一种通过精心设计编码代理的环境——提供精心策划的上下文、工具和可执行的约束,来提升代理输出质量的方法论,这些约束编码了组织的非功能性需求和累积经验。

Stars

2,320

7 天增长

+2,010

Fork 数

236

开放 Issue

2

开源协议

CC-BY-4.0

最近更新

2026-07-18

为什么值得关注

它提出了一种系统化的、基于证据的框架,使组织知识和质量标准可被代理恢复,将代理交互转变为累积反馈循环,而非仅依赖模型权重。

适合谁使用

  • 使用 AI 编码代理的软件工程师
  • 管理代理集成工作流的工程经理
  • 构建代理工具的平台或基础设施工程师
  • 采用基于代理的开发流程的组织

典型使用场景

  • 设置仓库使编码代理自动理解项目约定和非功能性需求
  • 将可靠性、安全性、可维护性检查作为可执行约束嵌入代理环境
  • 建立从已接受工作和失败中学习的反馈循环,持续改进代理行为
  • 实施“最后一英里部署”,提供上下文、能力和权限,无需人类审查每个代理操作

项目优势

  • 概念清晰,有具体杠杆(上下文和工具)和系统级框架
  • 包含实用剧本、论文索引和参考实现(AGENTS.md)
  • 引用真实来源和先前工作,展示外部验证和社区参与
  • 聚焦累积一致性和组织学习,使实践可扩展

使用前须知

  • 需要大量前期投入来为特定组织或系统定制 harness
  • 假设代理为黑盒且能力强大,可能无法解决弱模型局限
  • 组织特定的过程数据需手动捕获和维护,带来维护负担

README 快速开始

Harness Engineering

“Most people do not know that they can just point their agents at my writing, tweets, podcasts, and talks and improve the output of their agents by 100x.”

Ryan Lopopolo

Harness engineering, the practice of improving agent output by shaping the environment around it, holds a chosen model and coding agent constant as a black box. It improves the two external levers—context and tools—and curates the environment around them. The worker should be able to recover intent, operate the real system, respect authority, prove the outcome, and leave the next run better equipped.

A central purpose of that environment is to carry an organization's nonfunctional requirements: the quality attributes and constraints governing reliability, security, compatibility, maintainability, performance, operability, risk posture, and polish. The harness also carries local decisions about how to prioritize, trade off, and satisfy those requirements. Ryan adopted a systems-level framing from 2026’s [un]prompted conference that describes this as getting the whole universe of nonfunctional requirements into code. Make the Repository Teach the Agent develops how the requirements and decisions become retrievable context, examples, tools, and executable constraints.

Because work is an iterative game, a harness can make organizational judgment cumulative. Lessons from accepted work, corrections, failures, and user responses become context, boundaries, tools, examples, and checks that shape later trajectories. Over time, that feedback loop can make coherence cumulative across agent-maintained artifacts.

[Code is how an agent uses a computer]. That internal action language can produce reliable domain outcomes for people who never review the implementation when [last-mile deployment] supplies the organization’s context, capabilities, authority, and proof.

[Code is how an

项目描述

🐎 Ryan Lopopolo’s anthology, field guide, and agent context bundle for harness engineering

相关仓库与替代方案

根据分类、Topic 和编程语言匹配的相似项目。

xai-org
精选
xai-org GitHub avatar

grok-build

Grok Build is SpaceXAI's terminal-based AI coding agent that runs as a full-screen TUI, understands codebases, edits files, executes commands, searches the web, and manages tasks interactively or headlessly.

AI 与机器学习AI 智能体
20,399
mereyabdenbekuly-ctrl
精选
mereyabdenbekuly-ctrl GitHub avatar

clodex-ide

Clodex is an open-source, local-first agentic IDE that combines persistent AI tasks, code, terminal, browser, Git, models, memory, and governed execution in one Electron workspace, currently in technical preview.

AI 与机器学习AI 智能体
833
Jakubantalik
精选
Jakubantalik GitHub avatar

thinking-orbs

A React component library that renders six hand-tuned animated thought orb loading indicators on a plain 2D canvas, with two purpose-tuned sizes and automatic theme detection for AI and agent UIs.

AI 与机器学习AI 智能体
1,067