Claude Code 复现

v1/
├── main.py          入口 · 一切逻辑的容器
├── tools.py         工具实现 + 工具定义 + LLM 客户端（重复）
└── permisssion.py   权限管道（3 级检查）

v2/
├── main.py          入口 · agent_loop（纯编排）
├── tools.py         5 个工具实现
├── hook.py          Hook 注册表 + 触发逻辑 + 5 个 handler <- 新增
├── skill.py         Skill 扫描 + SKILL.md 解析 <- 新增
└── permisssion.py   遗留（已被 hook.py 替代）

v3/
├── config.py        统一配置中心 <- 新增
├── llm.py           Anthropic 客户端单例 <- 新增
├── main.py          入口 · agent_loop + 工具注册
├── tools.py         5 个工具（从 config/llm 导入）
├── hook.py          Hook 系统（4 个节点 + 5 个 handler）
├── skill.py         Skill 加载
└── subagent.py      子 Agent 派发 <- 新增

v4/
├── config.py        统一配置中心
├── llm.py           LLM 客户端单例
├── log.py           统一日志模块 <- 新增
├── main.py          入口 · agent_loop + 压缩 + 日志
├── tools.py         5 个工具（纯业务逻辑，无日志语句）
├── hook.py          扩展: OnToolStart/OnToolEnd 自动派发
├── skill.py         Skill 加载
├── subagent.py      子 Agent
└── compact.py       4 级压缩管线 <- 新增

v5/
├── ...（v4 全部模块）
├── memory.py        跨会话持久记忆 <- 新增
│   └── 4 个子系统: 存储（.memory/） · 加载（LLM 侧查询） · 提取（每轮结束） · 合并（满 10 条）
└── recovery.py      错误恢复（3 条路径） <- 新增
    └── Path1: max_tokens -> 升级 -> continuation | Path2: prompt_too_long -> 应急压缩 | Path3: 429/529 -> 指数退避 + fallback

v6/
├── ...（v5 全部模块）
└── task_system.py   持久化 DAG + 后台异步执行 <- 新增
    ├── 任务 DAG: Task (id, subject, status, owner, blockedBy)
    ├── .tasks/ 目录存储 JSON 文件
    ├── can_start() 检查依赖 -> complete_task() 报告解锁
    └── 后台执行: daemon 线程 -> threading.Lock -> <task_notification> 通知注入

v7/
├── ...（v6 全部模块）
└── agent_teams.py   多 Agent 协作层 <- 新增
    ├── MessageBus: .mailboxes/.jsonl 文件邮箱 · 消费式读取
    ├── ProtocolState: request_id · type · status · match_response() 带类型验证
    ├── 两种协议: shutdown（优雅关闭）· plan_approval（计划审批）
    └── Teammate idle loop: 收件箱轮询 -> 协议分发 -> 持续待命

v8/
├── config.py              统一配置
├── llm.py                 LLM 客户端
├── log.py                 统一日志（含 WORKTREE/MCP 类别）
├── main.py                入口 · 动态工具池 + MCP 重组装
├── tools.py               核心工具（支持 cwd 参数）
├── hook.py                Hook 系统
├── skill.py               动态 system prompt（含 MCP 服务器信息）
├── subagent.py            子 Agent
├── compact.py             上下文压缩
├── memory.py              持久记忆
├── recovery.py            错误恢复
├── task_system.py         任务系统 + 后台 + scan_unclaimed()
├── agent_teams.py         多 Agent 协作 + 自主 Agent + worktree cwd
├── worktree_isolation.py  Git worktree 任务隔离 <- 新增
└── mcp_plugin.py          MCP 插件系统 <- 新增

扩展层: MCP 插件系统（打破封闭性，外部工具接入）
协作层: 多 Agent 协作 + 自主 Agent（并行工作，自组织）
任务层: 任务 DAG + 后台执行（工作的内容与顺序）
可靠性层: 记忆 + 恢复 + 压缩 + 日志（稳定运行的基础）
核心层: agent_loop + 工具 + Hook + Skill（Agent 的基本单元）