Harness Engineer Framework

一个面向 OpenClaw ACP harness 的工程化框架，用于标准化 AI coding agent 的任务下发、执行编排、状态追踪与结果回收。

适用场景

• 使用 sessions_spawn 且 runtime="acp" 启动 Codex、Claude Code、Pi 等 agent
• 需要把单次 agent 调用升级为可复用、可观测、可扩展的工程流程
• 需要支持单 agent、并行、多阶段串行、主从编排、评审链等工作流

快速开始

1. 阅读 CONFIG.md 确认 agent 类型、路径约定与默认参数。
2. 从 prompts/ 选择模板，复制或直接引用对应 prompt 文件。
3. 从 workflows/ 选择工作流，按需调整 agent_configs。
4. 使用 scripts/workflow-runner.sh <workflow.yaml> 执行工作流。
5. 使用 scripts/monitor.sh、scripts/collect-output.sh 跟踪和回收结果。

核心概念

• Harness Engineer：负责 agent 编排、提示词标准化、质量门禁和执行治理
• Prompt Template：统一任务结构，减少 agent 指令漂移
• Workflow：描述 agent 拓扑、执行顺序、输出流转与失败恢复
• State Store：记录 session、队列和标准数据结构
• Script Layer：把框架文档约束转为可执行入口

目录

• prompts/：任务模板库
• workflows/：工作流定义
• scripts/：执行与运维脚本
• state/：运行状态与 schema
• docs/：快速开始、最佳实践、排障和 agent 对比

推荐流程

1. 先定义任务类型和交付物。
2. 再选择模板和工作流。
3. 然后配置 agent 参数与质量门禁。
4. 最后执行、监控、收集结果并关闭任务。

详细设计见 FRAMEWORK.md。