Cygnus Tech Blog
Cygnus Tech Blog

第09章 开源 Harness 生态全景 —— 还有哪些值得关注的实现

Cygnus Yang 收录于 01-AI 工具与智能体/07-Harness
 约 1600 字 预计阅读 8 分钟 

上一篇我们剖析了 OpenClaw/Poco 的多渠道架构。本章我们全景扫描开源 Harness 生态——还有哪些值得关注的实现。

开源 Harness 分类

分类维度：按定位、复杂度、技术栈分类。

图表 代码
graph TB
    subgraph Full["完整 Harness (Claude Code 级别)"]
        F1[learn-claude-code
20章教程]
        F2[claw-code-agent
Python 实现]
    end
    
    subgraph MultiChannel["多渠道 Harness"]
        M1[poco-claw
OpenClaw 替代品]
    end
    
    subgraph Lightweight["轻量 Harness"]
        L1[Codex CLI
命令行 Agent]
    end
    
    subgraph Skills["Skills 集合"]
        S1[cc-harness-skills
Skills 示例]
        S2[agent-rules-books
规则集合]
    end
    
    subgraph Source["原始源码"]
        SR1[claude-code-src
instructkr fork]
    end
    
    Full --> MultiChannel --> Lightweight --> Skills --> Source
    
    style Full fill:#E0FFE0
    style MultiChannel fill:#E0E0FF
    style Lightweight fill:#FFE0E0
    style Skills fill:#FFF3E0
    style Source fill:#E0E0E0
graph TB
    subgraph Full["完整 Harness (Claude Code 级别)"]
        F1[learn-claude-code
20章教程]
        F2[claw-code-agent
Python 实现]
    end
    
    subgraph MultiChannel["多渠道 Harness"]
        M1[poco-claw
OpenClaw 替代品]
    end
    
    subgraph Lightweight["轻量 Harness"]
        L1[Codex CLI
命令行 Agent]
    end
    
    subgraph Skills["Skills 集合"]
        S1[cc-harness-skills
Skills 示例]
        S2[agent-rules-books
规则集合]
    end
    
    subgraph Source["原始源码"]
        SR1[claude-code-src
instructkr fork]
    end
    
    Full --> MultiChannel --> Lightweight --> Skills --> Source
    
    style Full fill:#E0FFE0
    style MultiChannel fill:#E0E0FF
    style Lightweight fill:#FFE0E0
    style Skills fill:#FFF3E0
    style Source fill:#E0E0E0
graph TB
    subgraph Full["完整 Harness (Claude Code 级别)"]
        F1[learn-claude-code
20章教程]
        F2[claw-code-agent
Python 实现]
    end
    
    subgraph MultiChannel["多渠道 Harness"]
        M1[poco-claw
OpenClaw 替代品]
    end
    
    subgraph Lightweight["轻量 Harness"]
        L1[Codex CLI
命令行 Agent]
    end
    
    subgraph Skills["Skills 集合"]
        S1[cc-harness-skills
Skills 示例]
        S2[agent-rules-books
规则集合]
    end
    
    subgraph Source["原始源码"]
        SR1[claude-code-src
instructkr fork]
    end
    
    Full --> MultiChannel --> Lightweight --> Skills --> Source
    
    style Full fill:#E0FFE0
    style MultiChannel fill:#E0E0FF
    style Lightweight fill:#FFE0E0
    style Skills fill:#FFF3E0
    style Source fill:#E0E0E0
graph TB
    subgraph Full["完整 Harness (Claude Code 级别)"]
        F1[learn-claude-code<br/>20章教程]
        F2[claw-code-agent<br/>Python 实现]
    end
    
    subgraph MultiChannel["多渠道 Harness"]
        M1[poco-claw<br/>OpenClaw 替代品]
    end
    
    subgraph Lightweight["轻量 Harness"]
        L1[Codex CLI<br/>命令行 Agent]
    end
    
    subgraph Skills["Skills 集合"]
        S1[cc-harness-skills<br/>Skills 示例]
        S2[agent-rules-books<br/>规则集合]
    end
    
    subgraph Source["原始源码"]
        SR1[claude-code-src<br/>instructkr fork]
    end
    
    Full --> MultiChannel --> Lightweight --> Skills --> Source
    
    style Full fill:#E0FFE0
    style MultiChannel fill:#E0E0FF
    style Lightweight fill:#FFE0E0
    style Skills fill:#FFF3E0
    style Source fill:#E0E0E0

完整 Harness 实现

learn-claude-code —— 20章教程

一句话定义：最完整的 Harness 教程——从 Agent Loop 到完整架构，20章递进式学习。

learn-claude-code = 教学版 Claude Code 定位：教你从零构建 Harness，每章添加一个机制

核心特点：

章节Harness 机制格言
s01Agent Loop + Bash“One loop & Bash is all you need”
s02工具注册 + dispatch map“加一个工具, 只加一个 handler”
s03权限判断“先划边界, 再给自由”
s04Hooks 扩展点“挂在循环上, 不写进循环里”
s05TodoWrite 任务系统“没有计划的 agent 走哪算哪”
s06子 Agent 隔离“大任务拆小, 干净的上下文”
s07Skills 按需加载“用到时再加载, 别全塞 prompt 里”
s08上下文压缩（四层策略）“上下文总会满, 要有办法腾地方”
s09记忆系统“记住该记的, 忘掉该忘的”
s10动态 Prompt 组装“prompt 是组装出来的, 不是写死的”
s11错误恢复“错误不是终点, 是重试的起点”
s12任务持久化“大目标拆成小任务, 排好序, 持久化”
s13后台任务“慢操作丢后台, agent 继续思考”
s14Cron 定时调度“定时触发, 不需要人推”
s15Agent Teams“一个搞不定, 组队来”
s16团队协议“队友之间要有约定”
s17自主 Agent“队友自己看板, 有活就认领”
s18Worktree 隔离“各干各的目录, 互不干扰”
s19MCP 插件“外面的系统, 用 MCP 接进来”
s20综合 Harness“全部整合, 真正的 Claude Code”

核心价值：

  • ✅ 教学友好：每章只添加一个机制
  • ✅ 格言设计：每个机制有一句格言
  • ✅ Python 实现：纯 Python，无 Rust/TypeScript
  • ✅ 完整覆盖：覆盖 Claude Code 所有核心机制
图表 代码
graph LR
    s01[Loop] --> s02[工具] --> s03[权限] --> s04[Hooks]
    s04 --> s05[任务] --> s06[子Agent] --> s07[Skills]
    s07 --> s08[压缩] --> s09[记忆] --> s10[Prompt]
    s10 --> s11[错误] --> s12[持久化] --> s13[后台]
    s13 --> s14[定时] --> s15[团队] --> s16[协议]
    s16 --> s17[自主] --> s18[Worktree] --> s19[MCP]
    s19 --> s20[综合]
graph LR
    s01[Loop] --> s02[工具] --> s03[权限] --> s04[Hooks]
    s04 --> s05[任务] --> s06[子Agent] --> s07[Skills]
    s07 --> s08[压缩] --> s09[记忆] --> s10[Prompt]
    s10 --> s11[错误] --> s12[持久化] --> s13[后台]
    s13 --> s14[定时] --> s15[团队] --> s16[协议]
    s16 --> s17[自主] --> s18[Worktree] --> s19[MCP]
    s19 --> s20[综合]
graph LR
    s01[Loop] --> s02[工具] --> s03[权限] --> s04[Hooks]
    s04 --> s05[任务] --> s06[子Agent] --> s07[Skills]
    s07 --> s08[压缩] --> s09[记忆] --> s10[Prompt]
    s10 --> s11[错误] --> s12[持久化] --> s13[后台]
    s13 --> s14[定时] --> s15[团队] --> s16[协议]
    s16 --> s17[自主] --> s18[Worktree] --> s19[MCP]
    s19 --> s20[综合]
graph LR
    s01[Loop] --> s02[工具] --> s03[权限] --> s04[Hooks]
    s04 --> s05[任务] --> s06[子Agent] --> s07[Skills]
    s07 --> s08[压缩] --> s09[记忆] --> s10[Prompt]
    s10 --> s11[错误] --> s12[持久化] --> s13[后台]
    s13 --> s14[定时] --> s15[团队] --> s16[协议]
    s16 --> s17[自主] --> s18[Worktree] --> s19[MCP]
    s19 --> s20[综合]

claw-code-agent —— Python 实现

一句话定义：Python 版 Claude Code——纯 Python 实现，无外部依赖。

claw-code-agent = Python 版 Claude Code 定位：Python 实现的完整 Harness，Easy to work with

核心特点：

维度claw-code-agentClaude Code
语言PythonTypeScript/Rust
依赖✅ Zero 外部依赖❌ npm/cargo 依赖
实现纯 PythonTS + Python
工具Bash/Read/Write/Edit20+ 工具
Loop✅ Agent Loop✅ Agent Loop
权限✅ 基础权限✅ 三级权限

核心价值：

  • ✅ 纯 Python：无需 Rust/TypeScript 环境
  • ✅ Zero 依赖：pip install 即可使用
  • ✅ 快速迭代：Python 快速开发
  • ✅ 教学友好：代码简洁易读

多渠道 Harness

poco-claw —— OpenClaw 替代品

已在上一章详细剖析。

核心特点：

  • ✅ 更美观的 Next.js UI
  • ✅ DingTalk/Feishu/Telegram 集成
  • ✅ Channel 团队协作
  • ✅ Docker 沙箱 + 本地挂载
  • ✅ 后台执行 + 定时触发

轻量 Harness

Codex CLI —— 命令行 Agent

已在第七章详细剖析。

核心特点：

  • ✅ 5 工具精简集
  • ✅ 安全沙箱（Docker/Firecracker）
  • ✅ Approval 模式（auto-edit/suggest/full-auto）
  • ❌ 无 Skills/MCP/子 Agent

Skills 集合

cc-harness-skills —— Skills 示例

一句话定义：Claude Code 风格的 Skills 示例集合——内存、验证、多 Agent 协调、上下文压缩。

cc-harness-skills = Skills 示例库 定位：可复用的 Skills Markdown 文件

Skills 分类：

Skills 类型内容用途
内存 Skills记忆管理、上下文记忆持久化记忆
验证 Skills自动验证、测试检查代码质量保证
多 Agent SkillsAgent 协调、任务分发团队协作
上下文压缩 Skills四层压缩策略上下文管理
主动编码 Skills主动重构、自动修复主动工作流

核心价值：

  • ✅ 可复用：Skills Markdown 文件可直接使用
  • ✅ 模板化：提供 Skills 编写模板
  • ✅ 最佳实践：包含 Claude Code 风格的最佳实践

agent-rules-books —— 规则集合

一句话定义：编码规则集合——受 Clean Code、DDD、Clean Architecture 启发的 Agent 规则。

agent-rules-books = 编码规则库 定位：为 Codex/Cursor/Claude Code 提供编码规范

规则来源：

来源内容适用 Agent
Clean Code编码规范、命名约定Codex/Cursor/Claude Code
Refactoring重构规则、代码简化Claude Code
DDD领域驱动设计规则Claude Code
Clean Architecture架构规范、分层设计Claude Code
DDIA数据密集型应用设计Claude Code

核心价值：

  • ✅ 经典书籍提炼：将经典书籍提炼为规则
  • ✅ 多 Agent 支持：支持 Codex/Cursor/Claude Code
  • ✅ 可配置：可选择性加载规则

原始源码

claude-code-src —— instructkr fork

一句话定义：原始 Claw Code 的 fork——instructkr/claw-code 的保存版本。

claude-code-src = 原始源码保存 定位：保存原始 Claw Code 实现

核心价值：

  • ✅ 原始源码：保存 instructkr/claw-code 的第一版
  • ✅ TypeScript 实现：原始 TS 实现
  • ✅ 参考价值：理解原始设计思路

开源 Harness 对比矩阵

完整对比

项目语言定位工具数SkillsMCP子 Agent权限上下文压缩
learn-claude-codePython教学版20+✅✅✅✅✅ 四层
claw-code-agentPythonPython版5+❌❌❌✅ 基础❌
poco-clawTS + Python多渠道25+✅✅✅✅ Docker✅ 基础
Codex CLI?轻量5❌❌❌✅ 沙箱❌
cc-harness-skillsMarkdownSkills库-✅---✅
agent-rules-booksMarkdown规则库-✅----
claude-code-srcTypeScript原始源码10+❌❌❌✅❌
图表 代码
graph TB
    subgraph Complexity["复杂度分层"]
        C1[完整 Harness
learn-claude-code
poco-claw]
        C2[中等 Harness
claw-code-agent
claude-code-src]
        C3[轻量 Harness
Codex CLI]
        C4[Skills/规则
cc-harness-skills
agent-rules-books]
    end
    
    C1 --> C2 --> C3 --> C4
    
    style C1 fill:#E0FFE0
    style C2 fill:#E0E0FF
    style C3 fill:#FFE0E0
    style C4 fill:#FFF3E0
graph TB
    subgraph Complexity["复杂度分层"]
        C1[完整 Harness
learn-claude-code
poco-claw]
        C2[中等 Harness
claw-code-agent
claude-code-src]
        C3[轻量 Harness
Codex CLI]
        C4[Skills/规则
cc-harness-skills
agent-rules-books]
    end
    
    C1 --> C2 --> C3 --> C4
    
    style C1 fill:#E0FFE0
    style C2 fill:#E0E0FF
    style C3 fill:#FFE0E0
    style C4 fill:#FFF3E0
graph TB
    subgraph Complexity["复杂度分层"]
        C1[完整 Harness
learn-claude-code
poco-claw]
        C2[中等 Harness
claw-code-agent
claude-code-src]
        C3[轻量 Harness
Codex CLI]
        C4[Skills/规则
cc-harness-skills
agent-rules-books]
    end
    
    C1 --> C2 --> C3 --> C4
    
    style C1 fill:#E0FFE0
    style C2 fill:#E0E0FF
    style C3 fill:#FFE0E0
    style C4 fill:#FFF3E0
graph TB
    subgraph Complexity["复杂度分层"]
        C1[完整 Harness<br/>learn-claude-code<br/>poco-claw]
        C2[中等 Harness<br/>claw-code-agent<br/>claude-code-src]
        C3[轻量 Harness<br/>Codex CLI]
        C4[Skills/规则<br/>cc-harness-skills<br/>agent-rules-books]
    end
    
    C1 --> C2 --> C3 --> C4
    
    style C1 fill:#E0FFE0
    style C2 fill:#E0E0FF
    style C3 fill:#FFE0E0
    style C4 fill:#FFF3E0

开源 Harness 生态趋势

2025-2026 发展趋势

图表 代码
timeline
    title 开源 Harness 生态发展趋势
    2025-06 : learn-claude-code 发布
20章教程
    2025-07 : claw-code-agent 发布
Python 实现
    2026-01 : poco-claw 发布
OpenClaw 替代品
    2026-03 : instructkr/claw-code
原始源码保存
    2026-04 : cc-harness-skills
Skills 示例库
    2026-04 : agent-rules-books
规则集合
timeline
    title 开源 Harness 生态发展趋势
    2025-06 : learn-claude-code 发布
20章教程
    2025-07 : claw-code-agent 发布
Python 实现
    2026-01 : poco-claw 发布
OpenClaw 替代品
    2026-03 : instructkr/claw-code
原始源码保存
    2026-04 : cc-harness-skills
Skills 示例库
    2026-04 : agent-rules-books
规则集合
timeline
    title 开源 Harness 生态发展趋势
    2025-06 : learn-claude-code 发布
20章教程
    2025-07 : claw-code-agent 发布
Python 实现
    2026-01 : poco-claw 发布
OpenClaw 替代品
    2026-03 : instructkr/claw-code
原始源码保存
    2026-04 : cc-harness-skills
Skills 示例库
    2026-04 : agent-rules-books
规则集合
timeline
    title 开源 Harness 生态发展趋势
    2025-06 : learn-claude-code 发布<br/>20章教程
    2025-07 : claw-code-agent 发布<br/>Python 实现
    2026-01 : poco-claw 发布<br/>OpenClaw 替代品
    2026-03 : instructkr/claw-code<br/>原始源码保存
    2026-04 : cc-harness-skills<br/>Skills 示例库
    2026-04 : agent-rules-books<br/>规则集合

趋势分析

趋势说明代表项目
Python 化纯 Python 实现，无需 TS/Rustlearn-claude-code、claw-code-agent
教学友好递进式教程，格言设计learn-claude-code
多渠道集成IM 集成、团队协作poco-claw
Skills 模板化可复用的 Skills Markdowncc-harness-skills
规则提炼经典书籍提炼为规则agent-rules-books

如何选择开源 Harness

选择决策树

图表 代码
graph TB
    Start[需要什么?] --> Learn{学习 Harness?}
    Learn -->|是| S1[learn-claude-code
20章教程]
    Learn -->|否| Build{构建自己的?}
    
    Build -->|Python| S2[claw-code-agent
Python 版]
    Build -->|TypeScript| S3[claude-code-src
原始源码]
    Build -->|多渠道| S4[poco-claw
多渠道版]
    
    S1 --> End[选定了!]
    S2 --> End
    S3 --> End
    S4 --> End
    
    Build -->|Skills/规则| S5{需要什么?}
    S5 -->|Skills| S6[cc-harness-skills]
    S5 -->|规则| S7[agent-rules-books]
    
    S6 --> End
    S7 --> End
graph TB
    Start[需要什么?] --> Learn{学习 Harness?}
    Learn -->|是| S1[learn-claude-code
20章教程]
    Learn -->|否| Build{构建自己的?}
    
    Build -->|Python| S2[claw-code-agent
Python 版]
    Build -->|TypeScript| S3[claude-code-src
原始源码]
    Build -->|多渠道| S4[poco-claw
多渠道版]
    
    S1 --> End[选定了!]
    S2 --> End
    S3 --> End
    S4 --> End
    
    Build -->|Skills/规则| S5{需要什么?}
    S5 -->|Skills| S6[cc-harness-skills]
    S5 -->|规则| S7[agent-rules-books]
    
    S6 --> End
    S7 --> End
graph TB
    Start[需要什么?] --> Learn{学习 Harness?}
    Learn -->|是| S1[learn-claude-code
20章教程]
    Learn -->|否| Build{构建自己的?}
    
    Build -->|Python| S2[claw-code-agent
Python 版]
    Build -->|TypeScript| S3[claude-code-src
原始源码]
    Build -->|多渠道| S4[poco-claw
多渠道版]
    
    S1 --> End[选定了!]
    S2 --> End
    S3 --> End
    S4 --> End
    
    Build -->|Skills/规则| S5{需要什么?}
    S5 -->|Skills| S6[cc-harness-skills]
    S5 -->|规则| S7[agent-rules-books]
    
    S6 --> End
    S7 --> End
graph TB
    Start[需要什么?] --> Learn{学习 Harness?}
    Learn -->|是| S1[learn-claude-code<br/>20章教程]
    Learn -->|否| Build{构建自己的?}
    
    Build -->|Python| S2[claw-code-agent<br/>Python 版]
    Build -->|TypeScript| S3[claude-code-src<br/>原始源码]
    Build -->|多渠道| S4[poco-claw<br/>多渠道版]
    
    S1 --> End[选定了!]
    S2 --> End
    S3 --> End
    S4 --> End
    
    Build -->|Skills/规则| S5{需要什么?}
    S5 -->|Skills| S6[cc-harness-skills]
    S5 -->|规则| S7[agent-rules-books]
    
    S6 --> End
    S7 --> End

选择指南

需求推荐项目原因
学习 Harness 工程learn-claude-code20章递进教程，格言设计
快速构建 Python Harnessclaw-code-agent纯 Python，Zero 依赖
多渠道生活管理poco-clawIM 集成，Channel 协作
参考原始设计claude-code-srcinstructkr/claw-code fork
Skills 示例参考cc-harness-skills可复用 Skills Markdown
编码规则参考agent-rules-books经典书籍提炼规则

本章小结

  • 开源 Harness 分类：完整 Harness、多渠道 Harness、轻量 Harness、Skills 集合、原始源码
  • 完整 Harness：learn-claude-code（20章教程）、claw-code-agent（Python 版）
  • 多渠道 Harness：poco-claw（DingTalk/Feishu/Telegram）
  • 轻量 Harness：Codex CLI（5 工具精简集）
  • Skills 集合：cc-harness-skills（Skills 示例）、agent-rules-books（规则集合）
  • 原始源码：claude-code-src（instructkr fork）
  • 发展趋势：Python 化、教学友好、多渠道集成、Skills 模板化、规则提炼
  • 选择指南：学习→learn-claude-code，构建→claw-code-agent，多渠道→poco-claw

预告：下一篇我们深入 Harness 的核心——Agent Loop，理解 observe→think→act→feedback 的持续循环。

相关内容

收录于 合集・01-AI 工具与智能体/07-Harness 27
更新于 2026-05-23 
CC BY-NC-SA 4.0
返回 | 主页
如果这篇文章对你有帮助，欢迎请我喝杯咖啡 ☕
Cygnus Yang 支付宝支付宝
Cygnus Yang 微信微信

目录