Learn Harness From Claude Code

这是一个从零构建 Claude Code 智能体 Harness（运行环境/容器）的教学项目，包含两个核心完整版本：

1. s20_comprehensive: 综合版。将所有智能体机制（工具执行、权限控制、Hooks 机制、Todo 计划、子智能体、知识库按需加载、上下文压缩、短期与长期记忆、运行时 Prompt 组装、网络错误恢复、任务依赖图、后台任务、Cron 定时任务、多 Agent 团队协作、工作流协议、自动认领、Worktree 目录隔离、MCP 外部工具等）融合在同一个主循环（Agent Loop）中。
2. s20_layered: 分层版。将上述所有机制以高度模块化、面向对象的分层结构进行重新设计（包含基础执行层、单 Agent 能力层、上下文层、工作流层、协作层、总装配层及 50+ 行为单元测试），是学习 Claude Code 精妙架构的推荐入口。

目录结构

.
├── s20_comprehensive/    # 综合版（单文件实现）
│   ├── code.py           # 核心代码
│   └── README.md         # 详细原理解析
├── s20_layered/          # 分层模块化版（清晰的架构设计）
│   ├── layer_01_foundation/
│   ├── layer_02_single_agent/
│   ├── layer_03_context/
│   ├── layer_04_workflow/
│   ├── layer_05_collaboration/
│   ├── layer_06_integration/
│   ├── shared/
│   ├── tests/            # 单元测试
│   └── README.md
├── skills/               # 智能体可按需加载的 Skill（技能库，如 agent-builder、code-review 等）
├── .env.example          # 环境变量模板
├── requirements.txt      # 依赖包列表
└── LICENSE               # 开源协议

快速开始

1. 安装依赖

pip install -r requirements.txt

2. 配置环境变量

复制 .env.example 并填入您的 API Key 和配置：

cp .env.example .env

3. 运行项目

运行综合版主循环：

python s20_comprehensive/code.py

运行分层版主循环：

python -m s20_layered

运行分层版的所有行为测试：

python -m unittest discover -s s20_layered/tests -v