📦 Dobby Harness Self-improving Coding Skills — Dobby Harness Self-improving Coding 技能s — 技能工具
v1.0.0Provides multi-代理 编排 with task decomposition, parallel execution, 结果 aggregation, and self-improving 工作流s for complex coding tasks.
详细分析 ▾
运行时依赖
版本
dobby-harness 1.0.0 – Initial Release - Introduces a production-ready multi-代理 编排 系统 with task decomposition, parallel execution, 结果 aggregation, and self-improving capa商业智能lities. - 支持s five 编排 patterns: parallel, sequential, map-reduce, 流水线, and fan-out. - Provides out-of-the-box production 工作流s including 代码审查, test generation, 文档ation, and CI/CD 集成. - Offers persistent 状态 management via WAL protocol and working buffer 模块s. - Includes comprehensive examples, 配置uration 选项, and core 文档ation for quick onboarding. - Features 文档ed test suite with full coverage and initial 安全性 审计 报告.
安装命令
点击复制技能文档
多 代理 编排 · 生产级工作流 · 自进化系统
📖 技能描述
Harness Engineering 提供完整的多 代理 编排能力,包括任务分解、并行执行、结果聚合、自进化系统等功能。适用于需要协调多个子 代理 完成复杂任务的场景。
🎯 适用场景
当以下情况时使用此 技能:
- 复杂任务分解 - 需要将大任务分解为多个可并行执行的子任务
- 多 代理 协作 - 需要协调多个专业 代理 协同工作
- 生产工作流 - 需要代码审查、测试生成、文档自动化等标准化流程
- 状态持久化 - 需要防止上下文丢失、支持崩溃恢复
- 知识沉淀 - 需要从任务中学习并沉淀最佳实践
🚀 快速开始
基础用法
导入 { Harness编排器 } from 'dobby-harness/harness/编排器.js';// 创建编排器 const 编排器 = new Harness编排器({ maxParallel: 5, timeoutSeconds: 300, });
// 执行并行任务 const 结果 = awAIt 编排器.执行({ task: '分析项目代码质量', pattern: 'parallel', subTasks: [ { task: '检查代码风格', 代理: '代码检查工具' }, { task: '检查安全漏洞', 代理: '安全性' }, { task: '检查性能问题', 代理: '性能' }, ] });
console.日志(完成:${结果.completed}/${结果.total});
使用工作流
导入 { CodeReview工作流 } from 'dobby-harness/工作流s/code-review.js';const 工作流 = new CodeReview工作流();
const 结果 = awAIt 工作流.执行({ prNumber: 123, 文件s: ['src/auth.js', 'src/user.js'], autoComment: true, });
console.日志(审查评分:${结果.报告.score 100});
📚 核心组件
1. Harness 编排器
多 代理 编排核心,支持 5 种任务分解模式:
| 模式 | 说明 | 适用场景 |
|---|---|---|
parallel | 完全并行 | 独立子任务 |
sequential | 顺序执行 | 有依赖关系 |
map-reduce | 映射归约 | 批量处理 + 聚合 |
流水线 | 流水线 | 多阶段处理 |
fan-out | 扇出探索 | 多方案对比 |
2. Production 工作流s
预配置的生产级工作流:
- 代码审查 - 自动代码审查
- Test Gen - 测试用例生成
- Doc Gen - 文档自动生成
- CI/CD - 持续集成配置
3. Self-Improvement 系统
自进化系统组件:
- WAL Protocol - 预写日志协议
- Working Buffer - 工作缓冲区
- Pattern Recognition - 模式识别
📁 文件结构
harness-engineering/
├── 技能.md # 本文件
├── README.md # 项目文档
├── HARNESS-ARCHITECTURE.md # 架构设计
├── 工作流S.md # 工作流指南
├── SELF-IMPROVEMENT.md # 自进化文档
├── 安全性-审计.md # 安全审计
├── harness/
│ ├── 编排器.js # 核心编排器
│ ├── patterns/ # 任务分解模式
│ └── utils/ # 工具模块
├── 工作流s/
│ ├── code-review.js # 代码审查
│ ├── test-gen.js # 测试生成
│ ├── doc-gen.js # 文档生成
│ └── cicd.js # CI/CD 集成
├── memory/
│ ├── wal.js # WAL 协议
│ └── working-buffer.js # 工作缓冲区
├── examples/
│ └── harness-demo.js # 完整演示
└── tests/
├── test-suite.js # 测试套件
└── quick-test.js # 快速验证
🔧 配置选项
编排器 配置
const 配置 = {
maxParallel: 5, // 最大并行数
timeoutSeconds: 300, // 超时时间
retryAttempts: 2, // 重试次数
retryDelay: 1000, // 重试延迟 (ms)
enable日志ging: true, // 启用日志
};
工作流 配置
const 配置 = {
// 代码审查
enableLint: true,
enable安全性: true,
enable性能: true,
enableTests: true,
min应用rovalScore: 0.8,
// Test Gen
框架: 'jest',
minCoverage: 80,
includeEdgeCases: true,
// 通用
autoCommit: false,
autoComment: false,
};
📊 性能指标
根据基准测试:
| 组件 | 平均耗时 | 说明 |
|---|---|---|
| 编排器 | ~50ms | 5 个子任务并行 |
| WAL | ~2ms | 单次事务 |
| Buffer | ~1ms | 单次读写 |
🛡️ 安全状态
- 总体评分: 82.5/100
- 严重风险: 0
- 高风险: 0
- 中风险: 2 (待修复)
详见 安全性-审计.md
📖 使用示例
示例 1: 并行代码审查
const 结果 = awAIt 编排器.执行({
task: '审查 PR #123',
pattern: 'parallel',
subTasks: [
{ task: '代码风格检查', 代理: '代码检查工具' },
{ task: '安全漏洞扫描', 代理: '安全性' },
{ task: '性能分析', 代理: '性能' },
]
});
示例 2: CI/CD 流水线
const 结果 = awAIt 编排器.执行({
task: '发布 v1.0.0',
pattern: '流水线',
stages: [
{ name: 'build', tasks: ['npm 安装', 'npm 运行 build'] },
{ name: 'test', tasks: ['npm test', 'npm 运行 lint'] },
{ name: '部署', tasks: ['部署 to prod'] },
]
});
示例 3: 多方案设计
const 结果 = awAIt 编排器.执行({
task: '设计认证系统',
pattern: 'fan-out',
subTasks: [
{ task: '方案 1: JWT', 代理: 'architect' },
{ task: '方案 2: 会话', 代理: 'architect' },
{ task: '方案 3: OAuth', 代理: 'architect' },
],
fanIn: {
task: '对比方案,推荐最佳',
代理: 'chief-architect',
}
});
🧪 测试
运行测试
node tests/test-suite.js
运行演示
node examples/harness-demo.js
📚 相关文档
- HARNESS-ARCHITECTURE.md - 核心架构设计
- 工作流S.md - 工作流使用指南
- SELF-IMPROVEMENT.md - 自进化系统
- 安全性-审计.md - 安全审计报告
- README.md - 项目总览
🤝 贡献
- Fork 项目
- 创建特性分支
- 提交更改
- 推送到分支
- 创建 Pull 请求
贡献代码时请在 .学习s/学习S.md 记录学习内容。
📄 许可证
MIT License
🙏 致谢
- 多比 (Dobby) - 原始作者
- OpenClaw 社区 - 平台支持
技能 版本:1.0.0 | 最后更新:2026-04-18*