Harness Engineering 智能调度系统

基于 OpenClaw 的多 Agent 协同编程框架，支持智能调度、对抗评审、持续运行

项目概述

Skill 目录: ~/.openclaw/workspace/skills/claude-harness/

定时任务: 每 15 分钟自动巡检

核心能力：

🤖 多 Agent 协同（规划/执行/监督/协调）
⚔️ 对抗评审（Producer → Critic → Reviewer）
🔄 持续运行（Ralph Loop + Checkpoint）
🛡️ 护栏系统（危险操作拦截）
📊 可观测性（进度追踪 + 日志）
🔔 问题上报（自动发现并记录）

系统架构


┌─────────────────────────────────────────────────────────────────┐
│                     Harness Orchestrator                        │
│                   (智能调度中心 - LLM 驱动)                       │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  ┌─────────────┐    ┌─────────────┐    ┌─────────────┐         │
│  │ Task Queue  │    │  Scheduler  │    │  Monitor    │         │
│  │ (任务队列)  │───▶│ (智能调度)  │───▶│ (进度监控)  │         │
│  └─────────────┘    └─────────────┘    └─────────────┘         │
│                            │                                    │
│                            ▼                                    │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │                   Multi-Agent Layer                      │   │
│  │                                                          │   │
│  │  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐│   │
│  │  │ Planner  │  │ Executor │  │  Critic  │  │Reviewer  ││   │
│  │  │  Agent   │  │  Agent   │  │  Agent   │  │  Agent   ││   │
│  │  └──────────┘  └──────────┘  └──────────┘  └──────────┘│   │
│  │                                                          │   │
│  └─────────────────────────────────────────────────────────┘   │
│                                                                 │
│  ┌─────────────────────────────────────────────────────────┐   │
│  │                   State Management                       │   │
│  │                                                          │   │
│  │  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐│   │
│  │  │Checkpoint│  │ Progress │  │  Issues  │  │  Report  ││   │
│  │  │  Store   │  │ Tracker  │  │  Log     │  │  Gen     ││   │
│  │  └──────────┘  └──────────┘  └──────────┘  └──────────┘│   │
│  │                                                          │   │
│  └─────────────────────────────────────────────────────────┘   │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

核心模块

1. Orchestrator（多 Agent 协调器）

文件：scripts/orchestrator.py
功能：任务分发、Agent 调度、状态管理
状态：✅ 完成并测试通过

2. Guard（护栏系统）

文件：scripts/guard.py
功能：危险操作拦截、权限控制
规则：
- rm -rf / → 拦截
- git push --force → 需确认
- npm install → 自动批准

3. Adversarial（对抗评审）

文件：scripts/adversarial.py
功能：Critic-Reviewer 模型
流程：Producer → Critic → Reviewer → 迭代

4. Continuous（持续运行）

文件：scripts/continuous.py
功能：Ralph Loop + Checkpoint
特性：自动恢复、状态持久化

5. Observability（可观测性）

文件：scripts/observability.py
功能：日志记录、进度追踪、快照创建
存储：SQLite 本地数据库

6. Intervention（人工介入）

文件：scripts/intervention.py
功能：Yes/No 确认、审批流程

可视化 Dashboard

位置: ~/.openclaw/workspace/skills/agentscope-bridge/dashboard/

技术栈: Vue 3 + Tailwind CSS + WebSocket

启动方式:

bash
cd ~/.openclaw/workspace/skills/agentscope-bridge/dashboard
npm install
npm run dev
# 访问 http://localhost:5173/

功能：

📊 实时进度可视化
📋 任务列表查看
📈 状态图表展示
🔄 WebSocket 实时更新

使用方式

CLI 命令

bash
# 规划任务
~/.openclaw/workspace/skills/claude-harness/scripts/run.sh plan "任务描述"

# 执行任务
~/.openclaw/workspace/skills/claude-harness/scripts/run.sh exec <task-id>

# 查看状态
~/.openclaw/workspace/skills/claude-harness/scripts/run.sh status

# 查看任务列表
~/.openclaw/workspace/skills/claude-harness/scripts/run.sh list

OpenClaw 集成

python
# 启动规划 Agent
sessions_spawn(
    task="分析需求并创建任务规划",
    mode="run",
    runtime="subagent",
    label="harness-planner"
)

# 启动对抗评审
sessions_spawn(
    task="审查代码质量，发现问题",
    mode="run",
    runtime="subagent",
    label="harness-critic"
)

定时任务

任务	Job ID	间隔	状态
Harness 巡检	`bad8745a-...`	15 分钟	✅ 运行中

巡检内容：

核心模块测试 (5/5)
Guard 护栏验证
Checkpoint 恢复测试
子 Agent 状态检查

验收标准

验收项	状态	说明
实际运行对抗评审流程	✅ 完成	运行 6 验证
sessions_spawn 启动子 Agent	✅ 完成	运行 10 验证
问题自动发现上报	✅ 完成	22 个问题已记录
任务状态可追踪可恢复	✅ 完成	Checkpoint 已修复
核心概念代码实现测试	✅ 完成	5/5 测试通过

文件结构


~/.openclaw/workspace/skills/claude-harness/
├── SKILL.md              # 主文档 v3.0
├── docs/
│   └── TEST_REPORT.md    # 测试报告
└── scripts/
    ├── orchestrator.py   # 多 Agent 协调器
    ├── guard.py          # 护栏检查器
    ├── observability.py  # 可观测性模块
    ├── intervention.py   # 人工介入模块
    ├── delivery.py       # 交付模块
    ├── adversarial.py    # 对抗评审
    ├── continuous.py     # 持续运行
    ├── openclaw_integration.py  # OpenClaw 集成
    ├── research.py       # Web 调研
    ├── run.sh            # CLI 启动脚本
    └── test_harness.py   # 测试文件

~/.openclaw/workspace/skills/agentscope-bridge/
└── dashboard/            # 可视化 Dashboard
    ├── index.html
    ├── src/
    └── package.json

文档	路径
设计文档	`memory/harness-design.md`
调研进度	`memory/harness-research.md`
问题追踪	`memory/harness-issues.md`

更新日志

2026-03-29 v3.0

✅ 完成所有验收标准
✅ 修复 Checkpoint 序列化问题
✅ 验证 sessions_spawn 调用
✅ Dashboard 可视化完成
✅ 定时巡检正常运行

最后更新: 2026-03-29

目录