这个项目记录什么#
这里记录我在学习和拆解 Agent 过程中形成的理解。每个 S 章节都是一个独立栏目，先建立结构，再逐步补充内容、实验、问题和结论。
章节状态#
主目录已对齐当前官方仓库的 S01–S17 顺序，源码基准为 ce8f9f1。S01–S09 中部分教学对照仍来自旧版，版本范围在文章中说明；S10 Task System 已按新版重核。S07 从 Agent Skills 的 roll-dice 最小例子开始，逐个展开技能编写方法；已有发现、调用等机制文章保留在 S07 总览的参考入口。
S13 将团队、协议、自主认领与 Worktree 隔离组织为四个子主题；S15 主章解释运行时组装，S15.1 单独说明 System Prompt 的内容组成，Error Recovery 暂不展开。尚未学习的正文继续逐步填写。
章节名称统一为“编号 + 英文主题 + 一句中文解释”，例如 S02 Tool Use：工具增加，循环不变。左侧导航、下方章节卡片与文章标题使用同一名称。
旧编号怎样迁移#
新版 S16 Workflow Runtime 与 S17 Goal Loop 已补齐正文、源码对照与三张架构图。旧 S18–S20 地址会跳转到对应新页面；旧 S10–S17 地址已被新版同编号主题复用，请按上表查找原内容。
记录方式#
每个章节围绕自己的理解逐步展开：
- 这一节要解决的问题
- 用架构图看清主流程与新增机制
- 分步解释概念，并给出对应代码
- 把步骤串成完整流程或伪代码
- 核对实现边界、实验结果和仍有疑问的地方
- 最后留下的一句话理解
源码范围： 本节保留迁移前旧 20 章原型的学习记录。主目录编号已对齐新版，但这些教学摘录尚未逐段替换为更新后的本地实现；涉及现代产品行为的部分按文内官网来源说明。
...
源码范围： 本节保留迁移前旧 20 章原型的学习记录。主目录编号已对齐新版，但这些教学摘录尚未逐段替换为更新后的本地实现；涉及现代产品行为的部分按文内官网来源说明。
...
源码范围： 本节保留迁移前旧 20 章原型的学习记录。主目录编号已对齐新版，但这些教学摘录尚未逐段替换为更新后的本地实现；涉及现代产品行为的部分按文内官网来源说明。
...
源码范围： 本节保留迁移前旧 20 章原型的学习记录。主目录编号已对齐新版，但这些教学摘录尚未逐段替换为更新后的本地实现；涉及现代产品行为的部分按文内官网来源说明。
...
源码范围： 本节已按当前本地仓库的 s05_todo_write/code.py 核对。图 1 复用博客 S04 总图的结构，标出本轮将扩展的旧接口；本节介绍教学实现，不将固定三轮提醒等设计视为现代 Claude Code 的内部规则。
...
源码范围： 本节按当前本地仓库 s06_subagent/code.py（ce8f9f1）核对。它是独立教学脚本：保留基础工具和 Hook，加入子循环，但没有带入 S05 的 TODO 与三轮提醒。图中的红色只表示这两个示例之间的范围变化，不表示 TODO 能力被整个项目淘汰。
...
先写出一份可以使用的 Skill，再学习从真实经验中提炼方法，判断哪些内容值得保留。主线以 Agent Skills Home、Quickstart 和 Best practices for skill creators 为依据，按小单元逐步展开。
当前学习单元 章节 这一节只解决什么 S07.1 Minimal Skill：写出一份最小完整技能 用官网 roll-dice 例子认识名称、描述和正文；提供中英版本及一次调用 S07.2 Real Expertise：把有效做法写成可复用技能 从真实任务和项目资料中提炼方法，理解 SOP 怎样写成 Skill S07.3 Content Selection：哪些内容值得写进 Skill 对照两份完整文件，判断哪些解释留给读者、哪些指令需要交给 Agent S07.4 Task Scope：一份 Skill 应该负责多大的任务 从交付结果出发，对照范围过宽、过窄与合适的工作单元 S07.5 Calibrating Control：每一步需要多大自由度 按脆弱程度调整约束，给出默认方案，写成可复用流程 S07.6 有效指导的模式：按问题选择解决方案 分六个独立页面，用问题、解决方案、最小示例和检查方式学习各模式 S07.7 References：怎样组织和引用配套资料 对照官方多文件示例，写清相对链接、资料用途、读取条件和检查方式 每个写作单元先提出具体问题，再用实际材料和完整文件解释；涉及改写时对照修改前后，最后给出检查方式。示意的预期与实际运行记录分别标注。
...
按教学仓库逐步解释大结果转存、历史归档、旧结果缩短、模型摘要与一次异常补救，每一部分配套代码。
继承 S08 总图，按当前 repo 展开回合入口的召回、退出前的提取校验、文件保存和按需整理。
先创建任务取得真实 ID，再添加依赖，查看、认领并记录完成结果，接回原来的工具循环。
显式选择后台 Bash，先回复启动编号；worker 发布结果，下一轮请求前再收集为文本通知。
保存调度规则，到期先入队，Agent 空闲后交付 prompt；模型接收后确认，失败恢复并重投。
Lead 创建持久队友，独立循环通过文件邮箱交换事件；空闲认领共享任务，审批与 worktree 约束执行。
连接并发现 server 工具，映射名称与 schema，每轮组装工具池，经宿主权限和调用适配返回原 tool_result。
以本地综合运行时理解消息、上下文、SYSTEM、工具池、权限与异步事件如何组装成一条主循环。
从一次 ctx.agent 调用开始，逐步加入 schema、并行、进度与 journal，再把可恢复的固定流程接回 Agent。
在无工具调用的退出位置加入独立评估：未完成就把原因写回消息并续轮；完成、无法完成、后台待交付或上限分别处理。