Reference · Map

分身 × harness
对照地图

learn-claude-code 的 20 章,逐格量一遍数字分身。每一格三种判定: 自建(代码在你仓库里)、 租的(机制存在,但在外部 CLI 里,换后端会一起丢)、 没有。每条都带证据,可自己核。

先给结论

原理方向是一致的,而且有几格你比教程做得更重(权限、记忆、错误分类)。 真正的差别只有一处,但它是最中心的一处:

分身目前不持有 agent loop——它租了一个。 对话层是刻意单轮的(allow_tool_calls=False), 真正的「想几步、调几轮工具、看结果再决定下一步」全发生在 Codex / Claude Code 那个子进程里。

这不是做错了。ADR-0009 把它写得很清楚:「对话模型不拆解问题、不规划查询步骤、 不多轮调度工具」,因为排查工具本身就是个能自己规划的 agent,再编排一层等于 把同一件事做两遍。这个论证是站得住的。

值得注意的是它和 ADR-0028 之间那道缝。ADR-0028 发现「造在后端私有库里的东西, 换后端就丢」,于是把状态收回了分身。但循环没收回来。 状态搬得走,循环搬不走——一旦哪天后端换成一个不自带 agent loop 的东西 (比如一个纯模型 API),你就必须自己有 s01。 这门课对你的确切价值就在这儿:你在学一个你现在租着的东西。

逐章对照

章机制判定证据 / 说明
s01Agent Loop 租的 deepseek_transport.py _complete() 只跑一轮工具, 第二次问模型时 allow_tool_calls=False。多轮循环在 ADR-0021 的外部子进程里。
s02多工具 / 并发 自建(无并发) 工具有:天气(ADR-0019)、MCP 只读(ADR-0044)。 _answer_tool_calls() 是串行 for 循环,同城去重 + MAX_CITIES_PER_TURN 封顶。教程 s02 讲的并发调度你没有。
s03权限 / 准入 自建 比教程重得多。 生产资源准入(ADR-0008)、只读不写(ADR-0010)、 工具关时不许提排查(ADR-0027)。ADR-0009 明确把安全边界放在「工具调用那一刻」, 不交给模型自己把守——这正是 s03 的核心论点。
s04Hooks 没有 没有生命周期钩子。你的等价物是硬编码在流程里的准入检查,够用。
s05TodoWrite / 计划 没有 全仓库 grep 不到。按形态不需要:单轮回复没有多步计划要维护。 真需要计划的排查侧,计划在子进程里。
s06Subagent 自建 形态不同但是同一件事:ADR-0021 的 headless 只读子进程就是一个 subagent, 只不过跑的是另一个产品而不是同一个模型的第二个会话。
s07Skill 加载 租的 wanghuo-* skill 全在 CLI 的私有目录里,你仓库里一个都没有。 ADR-0028 揭的正是这个坑(记忆那一半已经收回,skill 这一半还没有)。
s08上下文压缩 半格 有预算,没有压缩。 intent.py:216 有容量预检, 连系统提示词一起算。但超了之后的动作是请成员把话说小一点 (intent_runtime.py:64),不是自己压缩历史。这是取舍不是遗漏, 但 s08 值得看——群变忙时这个策略会先撞墙。
s09记忆 自建 memory.py 1490 行。ADR-0033「记忆携带去哪儿看,不携带为什么」、 ADR-0028「状态归分身,算力归后端」——后者比教程 s09 讲得更狠, 教程没有明确处理「换后端会丢什么」。
s10系统提示词 自建 ADR-0011 人格是固定提示词、ADR-0005 改人格要主人批准。 conversation.py _system_prompt() 每轮拼人物名单 + 群记忆 + 人格。
s11错误恢复 自建 deepseek_transport.py 把失败分了四类(限流/配置错/内容过滤/格式坏), _MAX_ATTEMPTS = 2,且注明「重试一次就够,把群晾着才是灾难」。 分类比教程细。
s12任务系统 自建 investigation_queue.py 422 行,有 queue_sequence、 状态机和 InvestigationTaskTransition 轨迹表。
s13后台任务 自建 排查任务离线跑完再回群。(队列表结构确认,执行路径未逐行核实。)
s14定时调度 自建 在系统层不在应用层:launchd(ADR-0015)。等价,且更该这么做。
s15/16Agent 团队 / 协议 没有 只有一个分身。按形态不需要。
s17自主 agent 自建 形态不同但性质一致:ADR-0032 潜水时自发去读材料、ADR-0040 按发言人准入、 ADR-0046 分身自己决定要不要读链接。这几条都是「没人叫它它自己动」。
s18Worktree 隔离 没有 分身只读不写代码(ADR-0010),没有并行改动要隔离。
s19MCP 自建 mcp_gateway.py 413 行 + mcp_subprocess.py。 ADR-0044 注册为只读能力、ADR-0042 钉钉链接继承 MCP 身份权限。用法与 s19 相反:不动态发现、模型看不到任何 MCP 工具、代码按 host 确定性路由(第 5 课)。

三件值得盯的事

事为什么值得盯
循环还在后端 ADR-0028 收回了状态,没收回循环。换后端时状态不丢了,但「会自己规划多轮」 这个能力仍然跟着后端走。学完 s01–s02 再回来判断:这个要不要也收回来。
skill 是 ADR-0028 漏掉的另一半 ADR-0028 的实查只查了记忆(find -iname "*memor*")。 wanghuo-* skill 同样在 CLI 私有目录里,同样换后端就丢, 但那条 ADR 没点到它。这是一个可以自己去核的真问题。
容量超了就请人说短点 在安静的群里成立。群一忙,这个策略会变成频繁追问。s08 讲的是另一条路: 自己压。到时候按哪条走,是个真取舍,不是补丁。