Harness Creator

harness-creator 是一个通用 AI 编程 harness 生成器。它可以为 Codex、Claude Code、OpenClaw 或其他主流 AI CLI 创建同一套工程化工作流骨架。

核心思想是：.harness/ 是跨工具共享的核心，Codex/Claude Code/OpenClaw 只是不同适配层。

能生成什么

通用核心：

• HARNESS.md：通用入口说明
• .harness/workflow.yaml：状态机流程
• .harness/state.json：当前流程状态
• .harness/evidence.json：验证证据
• .harness/agents/*.md：通用角色说明
• .harness/artifacts/：阶段产物
• .harness/rules/：原子规则
• .harness/context/：按需上下文
• .harness/scripts/：门禁脚本
• .harness/evals/：评测脚本
• .harness/lessons/：经验沉淀

适配层：

• Codex：AGENTS.md、.codex/agents/*.toml、.agents/skills/harness-dispatcher/
• Claude Code：CLAUDE.md、.claude/agents/*.md、.claude/settings.harness.example.json
• OpenClaw：.openclaw/harness/agents/、.openclaw/harness/messages/、示例配置
• Generic CLI：.harness/adapters/generic-cli.md

目录结构

harness-creator/
  SKILL.md
  agents/openai.yaml
  references/harness-architecture.md
  scripts/create_harness.py
examples/
  usage-prompts.md
scripts/
  validate_package.py
README.md
LICENSE

harness-creator/ 是 Codex 可安装的 skill 本体。即使你不用 Codex，也可以直接运行里面的 scripts/create_harness.py 来生成通用 harness。

安装到 Codex

Windows:

Copy-Item -Recurse .\harness-creator $env:USERPROFILE\.codex\skills\harness-creator

macOS / Linux:

cp -R ./harness-creator ~/.codex/skills/harness-creator

不安装 Codex，直接作为脚本使用

python harness-creator/scripts/create_harness.py --project /path/to/project --target all --profile standard

目标类型：

--target all          生成通用核心 + Codex + Claude Code + OpenClaw + generic adapter
--target generic      只生成通用核心和 generic adapter
--target codex        生成通用核心和 Codex adapter
--target claude-code  生成通用核心和 Claude Code adapter
--target openclaw     生成通用核心和 OpenClaw adapter

profile：

lean      小 bug、小脚本、低风险修复
standard  常规产品开发
full      高风险系统，增加 pre-mortem、预发验证、接口测试和评分

示例：

python harness-creator/scripts/create_harness.py \
  --project ./my-app \
  --target all \
  --profile standard \
  --domain "B2B SaaS" \
  --stack "Next.js + Node.js" \
  --build-command "npm run build" \
  --test-command "npm test"

在 Codex 中使用

使用 $harness-creator，为当前项目创建一套 target=all、profile=standard 的通用 AI 编程 harness。

在 Claude Code 中使用

先运行脚本：

python harness-creator/scripts/create_harness.py --project . --target claude-code --profile standard

然后在 Claude Code 中说：

请按 CLAUDE.md 和 .harness/dispatch/run-next.md 执行。
你是 dispatcher，下一步专业角色优先使用 .claude/agents 中的 subagent。

在 OpenClaw 中使用

先运行脚本：

python harness-creator/scripts/create_harness.py --project . --target openclaw --profile standard

然后按你的 OpenClaw agent id 调用：

openclaw agent --agent ops --message-file .openclaw/harness/messages/run-next.md --local

OpenClaw 的 agent id、model、channel 和 runtime 需要按你的环境配置；本项目只生成通用 message-file 和示例配置。

本地验证

在仓库根目录运行：

python scripts/validate_package.py

验证内容：

• SKILL.md frontmatter
• 必要资源文件
• create_harness.py 编译
• --target all 脚手架生成
• Codex、Claude Code、OpenClaw、generic adapter 文件存在性

设计原则

• 不绑定单一 CLI。
• .harness/ 是核心协议。
• 各 CLI 适配层只负责入口和角色定义格式。
• 主会话保持 thin dispatcher。
• 专业角色产物隔离。
• 门禁脚本 fail-closed。
• 经验从 lesson 逐步沉淀为 rule。

参考来源

• Claude Code 官方文档说明 custom subagents 使用 Markdown + YAML frontmatter，并支持项目级 .claude/agents/。
• Claude Code hooks 可在生命周期事件中运行命令。
• OpenClaw CLI 支持 openclaw agent --message-file 向指定 agent 投递多行任务文件。
• OpenClaw 也可以通过 Codex runtime 运行 Codex-backed agent turns，但这不是本项目的唯一目标。

License

MIT