Agent Harness Engineering — Development skill for Claude Code

Agent Harness Engineering

**简体中文** | [English](README.en.md)

一套面向编程 Agent（Codex、Claude Code、pi）的可版本化工程工作流：让 Agent 根据任务风险选择执行方式，调用合适的 Skill， 必要时隔离中高风险修改，完成必要验证，并只沉淀真正需要长期保留的项目知识。

你不需要先读完所有规则。推荐直接在 Codex 中打开或引用本仓库，让 Codex 解释它是否适合你的 使用方式，再决定是否接入。

推荐：直接询问 Codex

1. 了解这个仓库

在 Codex 中发送：

请阅读 AnonymXXX/agent-harness-engineering，告诉我这个仓库是干什么的、解决了什么问题、
包含哪些核心组件、适合哪些用户，以及它的限制。请引用仓库中的具体文件作为依据，
不要只复述 README。

如果已经在 Codex 中打开了本仓库，可以把仓库名替换为“当前仓库”。

2. 分析接入后的收益和改变

让 Codex 结合你当前可访问的配置和使用情况进行个性化比较：

请阅读这个仓库，并在我授权且当前环境可访问的范围内，检查我的 Codex 配置、已安装 Skills、
工作流和近期使用记录。分析如果接入这套 Harness Engineering，我的日常使用会发生什么变化。

请按“当前状态、接入后变化、实际收益、成本或风险、是否建议接入”输出，并引用仓库中的
具体文件作为依据。无法访问的记录请明确说明，不要猜测。

Codex 应重点比较以下方面：

方面	接入后可能发生的变化
风险控制	按 Fast、Standard、Heavy Lane 选择检查强度，中高风险任务在必要时使用独立 Git worktree。
Skill 路由	根据代码设计、故障诊断、领域建模、TDD 等任务自动选择专业工作流。
验证	根据修改范围运行最小但可信的测试、lint、构建或 Doctor 检查。
Git 与平台操作	使用可复用流程处理提交、GitHub 操作和发布任务，并保留明确的停止条件。
并行执行	子代理派发当前暂停（2026-08-06），主 Agent 直接完成工作；原 Worker 协议可从 Git 历史恢复。
知识沉淀	只有满足 Capture Gate 的长期规则和决策才进入项目文档，减少文档噪声。
恢复与升级	通过版本化配置和符号链接保持单一事实源；历史一键安装器可从 Git 历史找回。

这些是工作流提供的能力，不代表每个任务都会使用全部机制。简单任务仍应保持轻量。

3. 让 Codex 安全接入

确认适合后，可以让 Codex 完成检查、链接和验证：

请帮我接入 AnonymXXX/agent-harness-engineering。

先只读检查 ~/.codex、~/.agents/skills、当前 Git 状态和可能冲突。不要读取、复制或输出凭据、
sessions、memory、cache 或其他敏感运行时数据。

修改前列出会影响的文件、备份策略、依赖和风险。在我确认前不要创建符号链接或改写文件。
确认后按 README 的安装说明创建符号链接，随后运行 Skill index 检查和 Harness Doctor。
最后总结实际变更、验证结果，以及是否需要新建 Codex 任务来加载规则和 Skills。

Codex 只能分析当前任务中你明确授权且本机可访问的内容。它无法访问的历史记录、远程数据或 其他设备配置，必须由你补充；不要根据不完整信息推断结论。

技能组成

• 核心工作流：harness-engineering，以及 codebase-design、diagnosing-bugs、 domain-modeling、tdd 四个核心工程 Skill。
• 常用领域 Skill：git-auto-commit、github-cli-ops、release-ops、 frontend-design、develop-uniapp-miniapp、wechat-miniprogram-ci-upload。

安装

本机已经安装时直接使用。换机或重装时，在 macOS 上安装 Codex CLI、Git、`uv`、GitHub CLI， 然后手动创建 Harness 符号链接。浏览器使用 Codex 的 B