AI Agent Deep Dive 是一份「AI Agent 源码深度研究报告」仓库，核心是面向学习与评论的分析材料：对 Claude Code、Hermes Agent 等 AI 编码代理的实现做系统拆解，产出多版 PDF 报告（v2、v2.1）与一套覆盖 17 个主题的中文文档（系统提示与编排、工具权限与执行、Skills/插件/MCP、记忆与会话、命令与 UI、验证与质量、架构地图、运行时主循环、消息模型与状态、上下文管理、任务模型、工作区隔离、失败恢复、配置系统、MVP 范围、Python 实现注记等）。仓库明确「只保留分析材料、不提供被分析项目的源码目录」，并附带一个教学用的最小 Python Agent 示例（src/agt），用可替换的 Fake LLM 演示 Agent 该如何组织。Python、约 5,700 星。
来源：README 顶部/Quick Links/Notes/Teaching Agent Code、docs 目录、GitHub meta（tvytlx/ai-agent-deep-dive，Python） 查看 GitHub 仓库 →「AI 编码代理到底是怎么实现的」是开发者强烈好奇但缺少系统资料的话题——大家想知道 Claude Code 这类工具的系统提示、工具权限、Skills/MCP、记忆、上下文管理、运行时主循环等是怎么搭起来的。这个仓库把对这些代理的逆向研究整理成结构化的中文文档 + PDF 报告，并配一个能跑的最小教学 Agent 帮助理解，正好填补了「想学 agent 内部机制」的空白，因此快速涨到约 5,700 星。它本质是学习资料而非可用产品。
来源：README Quick Links/Teaching Agent Code、docs 目录主题、GitHub meta（stars 5726、created_at 2026-03-31）对 Claude Code 等 AI 编码代理的实现做深度研究，整理成 PDF 报告（ClaudeCode v2 / v2.1，v2.1 新增第八章记忆系统），并提到《Hermes Agent 源码深度解析》在作者知识星球发布。仓库只保留分析与评论材料、不含被分析项目源码。
来源：README Quick Links/Notes、仓库 PDF 文件docs/ 下系统覆盖产品概览、系统提示与编排、工具权限与执行、Skills/插件/MCP、记忆与会话、命令与操作者体验、验证与质量、架构地图、Agent 运行时主循环、消息模型与状态、上下文管理、任务模型、工作区与隔离、失败恢复、配置系统、MVP 范围、Python 实现注记等，是一份较完整的 agent 机制学习大纲。
来源：docs/00–16 文件、docs/README.md附带一个为教学设计的最小 Agent 项目（src/agt/agent.py 主循环、cli.py 入口），刻意保持结构清晰、减少工程复杂度，当前聚焦 Agent 主循环、Fake LLM 接口、Skills 发现与 CLI 骨架，便于对照文档理解核心结构。
来源：README Teaching Agent Code 段、src/agt 目录当前实现内置一个可替换的 Fake LLM——用户输入什么就以流式文本块返回测试响应，目的是让后续接入真实模型时只需替换 LLM 调用层、无需重写整个 Agent 主体。
来源：README「当前实现说明」段这是一个以研究文档与教学代码为主的仓库，分两部分。文档/报告部分：根目录有多版 PDF（ai-agent-deep-dive-report / v2 / v2.1），docs/ 下是 00–16 共十余篇主题文档构成的 agent 机制学习体系（从系统提示、工具权限、Skills/MCP 到运行时主循环、上下文管理、失败恢复、配置系统等）。教学代码部分：src/agt/ 是一个用 Poetry 管理的最小 Python Agent，agent.py 实现主循环、cli.py 提供 CLI（poetry run agt），内置可替换的 Fake LLM 与 Skills 发现，tests/ 有对应单测，配 .github/workflows/ci.yml。整体定位是「读报告学机制 + 跑最小实现练手」，不提供被分析代理的源码本体。
来源：仓库目录树（PDF、docs/00–16、src/agt、tests、pyproject.toml、ci.yml）、README Notes/Teaching Agent Code中心为项目本体，内环 = 核心功能模块，外环 = 关键技术依赖；按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成
Poetry（依赖管理）可替换 Fake LLM（占位，未接真实模型 API）CLI 入口 agt适合想搞懂「AI 编码代理内部如何工作」的开发者与学习者：系统读完 docs/ 的主题文档与 PDF，理解系统提示、工具权限、Skills/MCP、记忆、上下文管理、运行时主循环、工作区隔离、失败恢复等机制；再对照可运行的最小 Python Agent 把概念落到代码。也适合想从零搭一个结构清晰 Agent 的人作为脚手架起点，或作为教学/分享 agent 原理的素材。它是学习与研究材料，不是即用产品。
来源：README Teaching Agent Code/Quick Links、docs 主题研究报告已出到第二版（ClaudeCode v2、v2.1，v2.1 新增第八章记忆系统），并新增《Hermes Agent 源码深度解析》（发布于作者知识星球）。教学最小 Agent 当前为占位 Fake LLM 的教学实现。仓库最近一次更新在 2026-04-12。
来源：README Quick Links/Notes、GitHub meta pushed_at 2026-04-12、created_at 2026-03-31AI Agent Deep Dive 是一份难得系统的「AI 编码代理是怎么实现的」学习资料：用 17 个主题文档加多版 PDF 把 Claude Code 等代理的系统提示、工具权限、Skills/MCP、记忆、上下文管理、运行时主循环等机制讲清楚，还配一个结构清晰、可运行的最小 Python Agent 帮你把概念落到代码。对想深入理解或自己动手搭 agent 的开发者，它的信息密度和教学价值都很高。要清楚它是研究/教学材料而非可用产品——教学 Agent 用的是 Fake LLM、逆向分析的准确性需结合原项目验证、无明确许可证且部分内容在付费星球。把它当作「读懂并练习 agent 内部机制」的资料库来用，物超所值。
来源：综合 README、docs 主题、教学代码与 GitHub meta 的事实判断