Harness for Codex

为 OpenAI Codex、Claude Code 和 Cursor 提供统一的仓库级代理指引与自动化脚本,让每次 AI 辅助开发都从可预测的基线开始。

Star 数
★ 51
最近更新
5 个月前
License
MIT
主语言
Shell

30 秒速览

运行形态
Agent 插件 / 技能命令行工具
可在哪里用
通用 · 跨平台Codex · Claude Code
费用
免费,无需付费服务
上手难度
低 · 几分钟可跑通
开始前需要
pre-commit(可选钩子)Docker(可选 dev container)Shell / 命令行
典型场景
用 Codex 起新仓库的开发者,希望从第一天就有就绪的代理指令和标准命令
不适合
  • 需要一个能直接完成编码任务的独立 AI 产品的用户
  • 希望仓库自带语言栈、测试或 CI 实现的团队
  • 需要图形界面或云端托管服务的工作流
维护状态
近半年有提交最近提交 2026-05-30最新版本 v0.1.0(2026-05-30)

这个 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。

  1. 用 Codex 起新仓库的开发者,希望从第一天就有就绪的代理指令和标准命令
  2. 团队同时使用 OpenAI Codex、Claude Code 和 Cursor,需要一套共享规则避免各工具行为漂移
  3. 自动化代理需要稳定的 setup/check/test/handoff 入口以便无人值守运行
  4. 维护者希望把项目决策和任务简报固定在可预测的位置,供未来代理读取
  5. 早期或空仓库想在以后接入任意语言栈时不必更换流程契约

如何安装或部署这个 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?

FollowAgents 源码审查 · FARS-2.1
缺口较多
54/ 100 五分制 2.7 / 5
信任安全 11/29
可靠稳定 9/14
适用触发 10/18
规范维护 10/18
有效结果 9/13
证据核验 5/8
查看各维度的扣分理由
信任安全11 / 29 · 1.9/5

AGENTS.md要求按任务收窄改动、保留用户改动;CI仅声明 contents: read,支持一定的最小权限判断。扣分原因:没有明确的高影响操作确认规则或凭据处理说明;README提到 bootstrap、hooks 和 devcontainer,但脚本及相关配置未提供,无法核实数据流、外部副作用、依赖安全或回滚方式。LICENSE署名 Ajin Jeong,但发布者身份未验证,且没有清晰的维护者或更新路径。

可靠稳定9 / 14 · 3.2/5

README、AGENTS.md和CI工作流对标准入口及评估流程的描述基本一致,支持满分。扣分原因:bootstrap/check/test等实际脚本未提供,依赖缺失时的行为和错误信息无法核实;GitHub Action使用 @v4 标签,未显示不可变版本固定。

适用触发10 / 18 · 2.8/5

README列出新仓库、跨代理工作流及后续添加语言栈等场景,AGENTS.md也说明目录和任务循环,适配范围较清楚。扣分原因:能力边界只有概括性说明,缺少不适用场景、触发规则细节及环境支持矩阵;devcontainer标为可选,但其他环境行为未展示。

规范维护10 / 18 · 2.8/5

README、AGENTS.md、CLAUDE.md及目录说明形成清晰的信息架构;命令名称稳定一致,并提供快速开始、工作流及just示例;MIT许可证文本完整。扣分原因:安装说明较简略,FAQ和局限性说明有限;样本中没有版本或变更记录,也未明确维护责任或更新流程。

有效结果9 / 13 · 3.5/5

标准化入口、任务模板和决策记录可帮助团队统一代理工作流程,命令及预期用途易于理解。扣分原因:提供的证据是框架说明而非脚本实现,无法确认这些入口实际覆盖的工作或其维护成本;价值主要由文档声称,缺乏效果证据。

证据核验5 / 8 · 3.1/5

README、AGENTS.md和工作流对命令及流程的描述可相互对照,许可证和CI权限也有直接文本依据。扣分原因:多项功能声明没有对应脚本或配置样本佐证;文档未清楚区分已实现行为与预期用途,结论仅限所提供文件。

风险与缓解建议
  • 审阅材料未包含 README 提及的脚本、hook、devcontainer及 harness.yml;有关其实际权限、副作用、依赖和错误处理的判断仍无法确认。
  • CI 使用 actions/checkout@v4 标签;提供的材料未说明依赖更新或版本固定策略。
证据充分度:低 评估于 2026年11月8日 审查版本 5f9f63b23af5
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/harness-for-codex.svg?lang=zh)](https://followagents.com/zh/agents/harness-for-codex)
<a href="https://followagents.com/zh/agents/harness-for-codex"><img src="https://followagents.com/badge/harness-for-codex.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v0.1.0
    发布说明摘录
    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 密钥吗?
仓库以 MIT 许可发布,harness 本身免费且无需密钥;但它只是流程脚手架,实际的编码能力来自你选择的代理(Codex、Claude Code、Cursor),这些工具自身的费用与本仓库无关。
我必须用 Docker 吗?
不需要。dev container 是可选项;本地开发无需 Docker 即可运行所有脚本。
它支持哪些 AI 工具?
README 明确列出 OpenAI Codex(读 AGENTS.md)、Claude Code(读导入同一指引的 CLAUDE.md)和 Cursor(可将 AGENTS.md 用作共享指引)。
scripts/check 在空仓库里会做什么?
脚本是为空仓库或早期仓库设计的安全默认值:当检测到可用的格式化、lint、类型检查或测试工具时才运行对应检查,否则静默通过。随着项目增长再扩展。
如何保证代理行为一致?
把共享规则集中在 AGENTS.md,让各工具读取同一份指引;仅在工具需要不同桥接时添加工具专属文件,并用 harness.yml 对齐命令名和文档约定。
Harness for Codex 开源吗?
开源。源码在 GitHub(ganimjeong/Harness-for-codex),许可证是 MIT。
Harness for Codex 安全吗?
FollowAgents 的 FARS 评审(2026年11月8日)给 Harness for Codex 的“信任与安全”打了 11/29 分。评审检查的 8 项安全措施没有完全缺失的。
Harness for Codex 还在维护吗?
更新变慢了:GitHub 上最近一次提交是 2026-05-30,在最近半年内,但不在最近 30 天内。最新版本是 v0.1.0(2026-05-30)。
Harness for Codex 是谁开发的?
Harness for Codex 由 GitHub 账号 ganimjeong 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

所属宿主生态

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念