Rex Harness — AI skill for Claude Code

rex-harness

[](https://github.com/rexleimo/aios)

Standalone software-engineering control plane for coding agents. Derives Facts from Observations, selects one Capability at a time, emits a typed Provider Command, and advances only with matching Evidence.

`rex-harness` 是一个可独立运行的软件工程工作流内核。它读取 Coding Agent 的任务和结构化 Observation，推导 Fact，一次只选择一个 Capability，发出当前 Provider Command，并用类型化 Evidence 决定阻塞、续转或完成。

它可以单独辅助 Codex、Claude、Gemini、OpenCode、Hermes、Grok Build 或其他支持目录型 Skill 的 Agent；接入 `AIOS` 后，再获得模型执行、ContextDB、Team、长任务恢复和安全治理等宿主增强。

独立安装只使用 rex 自己实现的需求、设计、规划、测试设计、基础/严格 TDD、根因调试、最小构造、实施、代码审查、专项审查和 Wayfinding Provider。外部 playbook 不属于支持路径，也不是运行依赖。

独立使用

不需要 AIOS、ContextDB、MCP Server 或常驻服务：

rex-harness start \
  --work-item checkout \
  --message "Clarify acceptance criteria before implementing checkout."

rex-harness status --work-item checkout

rex-harness evidence \
  --activation  \
  --command-token  \
  --evidence acceptance-criteria-recorded=artifact:requirements

rex-harness resume --work-item checkout

`start`、`status`、`resume` 和 `evidence` 默认返回 `rex.cli.workflow-command.v1` compact 对象，只包含当前状态、Provider、`instructionsRef`、阶段目标、Evidence Contract 和一次性 `commandToken`。Coding Agent 只执行该 Command 指定的 Provider 和目标，然后提交真实 Evidence；被接受后 token 会轮换，旧 token 立即失效。

需要诊断或审计时添加 `--full`，CLI 才返回完整 `rex.standalone.workflow-result.v1`。JS API 始终保留完整 Workflow 对象，供 AIOS 等宿主直接集成。

默认状态保存在项目本地：

.rex-harness/
  workflows/    # 规范 Workflow Activation 与 work-item 索引
  activations/  # 当前 Capability 的便捷投影
  evidence/     # 只追加的 NDJSON Evidence Journal

可用 `--root ` 指定目标项目。状态损坏、Evidence 类型不匹配、引用没有协议前缀或仍是 placeholder/TODO/TBD 时会 fail-closed。

接入 Coding Agent

把 `rex-workflow` 编排入口和当前可执行的内置 Provider Skill 投影到客户端标准发现目录：

rex-harness init --client codex
rex-harness init --client claude
rex-harness init --client gemini
rex-harness