Harness Optimizer Agent 是 Everything Claude Code 插件体系中专职优化本地 Agent Harness 配置的智能代理，核心目标是通过自动化审计与微调，提升 AI 编程助手的可靠性、成本效率和任务完成率。它通过标准化流程识别高杠杆点（如 hooks、eval、路由、上下文管理、安全策略），并给出可量化的改进建议，适用于所有基于 Claude Code、Cursor、Codex 的生产环境，无需手动深度理解底层配置即可获得专业级优化效果。

Everything Claude Code Harness Optimizer Agent：提升本地 Agent Harness 配置的可靠性与成本效率

在使用 Claude Code、Codex、Cursor 等 AI 编程助手时，Agent Harness（代理编排与运行环境）配置的科学性直接决定了整个 AI 辅助开发流程的稳定性、成本控制与任务完成率。Harness Optimizer Agent 正是为了解决“配置复杂、难以量化优化、手动调优易出错”这一核心痛点而生。它不是简单的配置顾问，而是一个能自动审计、精确定位瓶颈、提出最小可逆优化并量化成效的专业代理。

1. Harness Optimizer Agent 能解决什么问题？

• 可靠性不足：Agent 执行中断、hooks 失效、配置变更后出现兼容性问题
• 成本不可控：token 浪费、无效调用、上下文窗口溢出、评估流程冗余
• 吞吐量低：Agent 并发调度不合理、路由配置未最优、自动化流程卡顿
• 难以持续改进：配置变动无量化反馈，无法追踪优化收益与风险

传统做法往往依赖开发者手动阅读文档、逐项排查配置，既耗时又难以发现隐藏的高杠杆优化点。而 Harness Optimizer Agent 通过标准化审计和自动修正，极大降低了优化门槛，让每一次配置调整都“有据可依、可回滚、可量化”。

2. Harness Optimizer Agent 的具体能力

能做什么？

• 自动审计本地 Harness 配置：一键运行 /harness-audit，生成当前配置的基线评分（scorecard），包括可靠性、成本、吞吐量等多维指标。
• 智能识别高杠杆优化点：聚焦 hooks、evals、路由策略、上下文管理与安全性，自动排序出最值得优先优化的 3 个方向。
• 提出最小、可逆的配置调整建议：只做微小、可量化的变更，避免大幅度改动带来新风险。
• 自动应用变更并验证效果：变更后自动回归测试，输出前后对比的量化改进报告（deltas）。
• 风险提示与剩余改进建议：在优化后，明确指出尚未解决的潜在风险与后续建议。

不能做什么？

• 不直接修改业务代码：只针对 Harness 配置本身，不涉及产品代码重构。
• 不做大规模不可逆变更：所有建议均为可回滚的最小化调整，保障生产安全。
• 不替代安全审查/代码审查代理：如需安全、代码质量等专项审查，仍需配合 security-reviewer、code-reviewer 等专职代理。

3. 触发方式与自动激活场景

• 手动调用：开发者可在任何需要配置优化的时刻主动运行 /harness-audit 或通过 UI 入口启动 Harness Optimizer Agent。
• 自动触发：在检测到 Agent Harness 相关配置变更、hooks 失效、评估分数下降时，系统可自动激活 Harness Optimizer 进行快速诊断与修正。
• 与持续集成/自动化 Hook 集成：可结合 Everything Claude Code Hooks 实战 配置为 PreToolUse/PostToolUse 事件自动触发，保障每次关键操作前后的配置健康。

4. 与其他 Agent 的协作模式

Harness Optimizer Agent 并非孤立运行，常见协作场景包括：

• 与 Loop Operator Agent 协同：在自主循环（如多 Agent DAG 执行）中，Loop Operator 监控任务进度与死循环，Harness Optimizer 负责优化底层配置，二者结合可实现高可靠的自动化工作流。详见 Loop Operator Agent 指南。
• 与 Build Error Resolver/Code Reviewer/Security Reviewer 组合：Harness 优化后，自动串联构建修复、代码审查、安全检测等环节，形成端到端的高可靠开发链路。
• 与 Eval Harness/Verification Loop Skill 配合：Harness 优化建议可直接反馈到 Eval Harness 评测体系，实现持续量化与闭环改进。

5. 为什么要用专门的代理而不是直接问 Claude？

直接向 Claude 提问虽然可以获得一些配置建议，但存在以下局限：

• 上下文与约束缺失：Claude 并不了解你当前的 Harness 配置、历史变更和实际运行环境，建议往往泛泛而谈，难以落地。
• 无法自动量化效果：Claude 无法自动生成基线评分、对比优化前后数据，也无法追踪变更可回滚性。
• 缺乏最小化、可逆性保障：人工建议容易出现大幅度配置调整，增加系统不稳定风险。
• 无法与自动化 Hook、CI/CD 集成：Harness Optimizer Agent 可作为自动化链路的一环，支持事件触发与持续监控。

因此，Harness Optimizer Agent 提供的是“场景感知、标准化、可追踪”的专业优化流程，远超单次对话式建议。

6. 实际使用示例

以下为一次完整的 Harness 优化对话流程，展示其自动化与量化能力：

用户（手动触发）：

/harness-audit

Harness Optimizer Agent 响应：

---
baseline scorecard:
- Reliability: 7.2/10
- Cost Efficiency: 5.8/10
- Throughput: 6.5/10

Top 3 leverage areas:
1. Hooks: PreToolUse 未配置，导致部分自动化流程未覆盖
2. Context Management: Agent 并发时上下文窗口利用率过高，易溢出
3. Eval Routing: 评测流程未按复杂度路由，导致 token 浪费

Proposed minimal, reversible changes:
- 启用 PreToolUse hook，覆盖所有高风险操作
- 限制单次 Agent 并发数为 3，防止上下文溢出
- 按任务复杂度调整 Eval 路由，低复杂度走快速通道

Applied changes and ran validation.

Measured improvements:
- Reliability: 7.2 → 8.5
- Cost Efficiency: 5.8 → 7.1
- Throughput: 6.5 → 7.0

Remaining risks:
- Hooks 兼容性需在下次大版本升级后复查
- 部分自定义 Agent 需手动适配新路由策略

---

整个流程无需手动比对配置文件、也无需理解底层实现，开发者只需关注“前后分数变化”和“剩余风险提示”，即可持续迭代优化 Harness 配置。

7. 快速上手与进阶实践

• 初次集成：参考 Claude Code 快速上手指南 完成基础安装后，即可直接调用 Harness Optimizer Agent。
• 进阶自动化：结合 Everything Claude Code Hooks 实战 配置自动触发，或与 Verification Loop Skill 形成持续验证闭环。
• 多 Agent 协作：Harness 优化后，建议串联 code-reviewer、security-reviewer 等 Agent，形成生产级开发流水线。

---

FAQ

Q: Harness Optimizer Agent 会修改我的业务代码吗？
A: 不会。它只针对 Agent Harness 配置本身进行优化，绝不直接修改产品代码，保障业务逻辑安全。

Q: 优化建议不可用或导致新问题怎么办？
A: 所有优化均为最小、可逆调整，支持一键回滚。如遇兼容性问题，可随时恢复原配置。

Q: 适用于哪些开发环境？
A: Harness Optimizer Agent 兼容 Claude Code、Cursor、Codex、OpenCode 等主流 AI 编程助手，支持多平台本地开发场景。

---