Harness for Codex
为 OpenAI Codex、Claude Code 和 Cursor 提供统一的仓库级代理指引与自动化脚本,让每次 AI 辅助开发都从可预测的基线开始。
- Star 数
- ★ 51
- 最近更新
- 5 个月前
- License
- MIT
- 主语言
- Shell
- FA 评分
- 54/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 免费,无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 用 Codex 起新仓库的开发者,希望从第一天就有就绪的代理指令和标准命令
- 不适合
- 需要一个能直接完成编码任务的独立 AI 产品的用户
- 希望仓库自带语言栈、测试或 CI 实现的团队
- 需要图形界面或云端托管服务的工作流
- 维护状态
- 近半年有提交最近提交 2026-05-30最新版本 v0.1.0(2026-05-30)
- 源码审查
- 54/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
Harness for Codex 是一个语言无关的仓库脚手架,为编码代理提供统一的操作约定。它以 AGENTS.md 作为共享的代理指令中心,并通过 CLAUDE.md 桥接 Claude Code,使 Codex、Claude Code 和 Cursor 读取同一套规则。仓库提供 scripts/bootstrap、scripts/check、scripts/test、scripts/eval、scripts/doctor 和 scripts/hooks 六个标准入口点,外加 justfile 中的等价命令和记录规范命令名的 harness.yml。工作流围绕任务简报(tasks/TEMPLATE.md)、持久决策记录(docs/decisions.md)和完成前的 scripts/check 验证展开。可选的 dev container 会在创建后运行 scripts/bootstrap,但本地开发无需 Docker。它本身不实现 AI 代理,也不包含任何语言栈——它是一个被代理读取和执行的流程契约。
安装后,该仓库向编码代理暴露一套固定入口:scripts/bootstrap 在检测到已知技术栈时准备依赖;scripts/check 依次运行格式化、lint、类型检查和测试(如可用);scripts/test 运行测试套件;scripts/eval 作为交接门禁依次执行 doctor、bootstrap 和 check;scripts/doctor 打印仓库与工具就绪状态;scripts/hooks 通过 pre-commit 安装可选的本地钩子。OpenAI Codex 直接读取 AGENTS.md,Claude Code 读取导入同一指引的 CLAUDE.md,Cursor 可将 AGENTS.md 用作共享项目指引。harness.yml 记录规范命令名、预期文档文件和任务循环阶段,需要与 AGENTS.md 保持一致。使用者通过 tasks/TEMPLATE.md 撰写任务简报,在 docs/decisions.md 记录持久决策,并在收尾前运行 scripts/check。
- 用 Codex 起新仓库的开发者,希望从第一天就有就绪的代理指令和标准命令
- 团队同时使用 OpenAI Codex、Claude Code 和 Cursor,需要一套共享规则避免各工具行为漂移
- 自动化代理需要稳定的 setup/check/test/handoff 入口以便无人值守运行
- 维护者希望把项目决策和任务简报固定在可预测的位置,供未来代理读取
- 早期或空仓库想在以后接入任意语言栈时不必更换流程契约
如何安装或部署这个 Agent?
没有独立的安装步骤:将仓库克隆或复制为你的项目基底即可。
bash
git clone https://github.com/ganimjeong/Harness-for-codex.git your-project
cd your-project可选:如需本地钩子,运行 scripts/hooks 通过 pre-commit 安装;如需容器化环境,可用附带的 .devcontainer/devcontainer.(它会在创建后运行 scripts/bootstrap),本地开发无需 Docker。
如何使用这个 Agent?
首次运行建议先体检再验证:
bash
scripts/bootstrap
scripts/check
scripts/doctor日常工作中:需要上下文时在 tasks/ 用 TEMPLATE.md 写任务简报;实现改动;在 docs/decisions.md 记录持久决策;收尾前运行 scripts/check。交接前的完整评估用:
bash
scripts/eval如果你使用 just,可以用等价命令:
bash
just check
just eval这个 Agent 有哪些优点和局限?
- 一套 AGENTS.md 同时覆盖 Codex、Claude Code 和 Cursor,通过 CLAUDE.md 桥接避免规则重复维护
- doctor/bootstrap/check/eval 的分层脚本设计让 eval 成为完整交接门禁,适合无人值守代理流程
- harness.yml 显式记录规范命令与任务循环阶段,使契约可审计、可对齐
- 语言无关设计:以后接入任何语言栈都无需更换 harness 约定
- 仓库本身不含任何语言栈或测试实现——脚本只是空仓库的安全默认值,需自行扩展
- 价值依赖于所用代理(Codex/Claude Code/Cursor)是否遵守 AGENTS.md 约定,没有强制执行机制
- 可选钩子依赖 pre-commit,容器路径依赖 Docker,均为额外环境要求
- 没有缓存到额外的仓库级指引,适配细节需读者自行从 README 与脚本推断
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Harness for Codex 当前 | 54 · 缺口较多 | Agent 插件 / 技能免费 | ★ 51 | 5 个月前 | Shell | Codex · Claude Code |
| CoCo Super Intelligence | 64 · 存在缺口 | Agent 插件 / 技能免费 + 模型费 | ★ 327 | 今天 | Python | Codex · Claude Code |
| Self-Learning Skills | 54 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 925 | 2 个月前 | — | Codex · Claude Code |
| AIWG | 77 · 表现良好 | 命令行工具免费 + 模型费 | ★ 232 | 今天 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
AGENTS.md要求按任务收窄改动、保留用户改动;CI仅声明 contents: read,支持一定的最小权限判断。扣分原因:没有明确的高影响操作确认规则或凭据处理说明;README提到 bootstrap、hooks 和 devcontainer,但脚本及相关配置未提供,无法核实数据流、外部副作用、依赖安全或回滚方式。LICENSE署名 Ajin Jeong,但发布者身份未验证,且没有清晰的维护者或更新路径。
README、AGENTS.md和CI工作流对标准入口及评估流程的描述基本一致,支持满分。扣分原因:bootstrap/check/test等实际脚本未提供,依赖缺失时的行为和错误信息无法核实;GitHub Action使用 @v4 标签,未显示不可变版本固定。
README列出新仓库、跨代理工作流及后续添加语言栈等场景,AGENTS.md也说明目录和任务循环,适配范围较清楚。扣分原因:能力边界只有概括性说明,缺少不适用场景、触发规则细节及环境支持矩阵;devcontainer标为可选,但其他环境行为未展示。
README、AGENTS.md、CLAUDE.md及目录说明形成清晰的信息架构;命令名称稳定一致,并提供快速开始、工作流及just示例;MIT许可证文本完整。扣分原因:安装说明较简略,FAQ和局限性说明有限;样本中没有版本或变更记录,也未明确维护责任或更新流程。
标准化入口、任务模板和决策记录可帮助团队统一代理工作流程,命令及预期用途易于理解。扣分原因:提供的证据是框架说明而非脚本实现,无法确认这些入口实际覆盖的工作或其维护成本;价值主要由文档声称,缺乏效果证据。
README、AGENTS.md和工作流对命令及流程的描述可相互对照,许可证和CI权限也有直接文本依据。扣分原因:多项功能声明没有对应脚本或配置样本佐证;文档未清楚区分已实现行为与预期用途,结论仅限所提供文件。
- 审阅材料未包含 README 提及的脚本、hook、devcontainer及 harness.yml;有关其实际权限、副作用、依赖和错误处理的判断仍无法确认。
- CI 使用 actions/checkout@v4 标签;提供的材料未说明依赖更新或版本固定策略。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
Initial public release of the Codex harness. Includes AGENTS.md instructions, Claude Code bridge, standard bootstrap/check/test/eval scripts, CI, hooks, task template, workflow docs, MIT license,and public contribution templates.在 GitHub 查看 ↗
常见问题
它是免费的吗?需要 API 密钥吗?
我必须用 Docker 吗?
它支持哪些 AI 工具?
scripts/check 在空仓库里会做什么?
如何保证代理行为一致?
Harness for Codex 开源吗?
Harness for Codex 安全吗?
Harness for Codex 还在维护吗?
Harness for Codex 是谁开发的?
谢谢反馈,我们会据此改进页面。