63 · 参照实现对照:子代理与折叠回查
性质:非方案,对照记录。2026-11-05。
只回答「kimi 与 tako 在这两处差在哪」。kimi 指参照实现 kimi-code(本机 clone 在
ref-agent/kimi-code/),tako 指本仓。两边现状都以代码为准,指针见 §3;本篇不作施工真源。
1. 子代理设计
一句话:kimi 的子代理类型可以内置、也可以丢 Markdown 扩展,父代理拿回的是一张固定格式的回执 (编号、类型、成没成、怎么续); tako 的规格是一个目录里的 Markdown(租户可导入、改、删),回传是子代理最后那段话加一个实例 id—— 交接内容全靠规格约束模型自己写全,程序不做抽取。
| 方面 | kimi | tako |
|---|---|---|
| 规格 | 例子: 内置 coder 在代码里注册,三样东西:· description: "General software engineering agent — the only subagent type with file-editing tools…"· tools: CODER_TOOLS· 角色前缀:最后一条消息就是全部交接——改了什么、为什么、碰过的每个文件路径、怎么验证 **描述:**内置类型(agent/coder/explore/plan)加多目录自定义 Markdown;frontmatter 还能写 whenToUse、disallowedTools、subagents,正文是带占位的系统提示模板。 |
例子:agents/coder.md 的 frontmatter,字段就这几行:· description: 把一段要在 workspace 里改文件…的活整包交给它。…最后带回一份自足的交接:改了什么、动过哪些文件、怎么验证的、还剩什么· tools: [write_file, read_text_file, edit_file, list_directory, search_files, memory, bash]· 正文:批量活先写成脚本;终稿要自己说全四件事 **描述:**规格是 Markdown 立文件:出厂就是 agents/ 下这几份,租户可以导入、改、删;frontmatter 字段只有 name、description、tools 或 exclude_tools、model,正文不套模板。 |
| 回传 | 例子: coder 改了 80 个文件,最后一条消息按角色要求写全: · 改了什么、为什么 · 碰过的每个文件路径 · 怎么验证的 父代理收到带字段的交接: · agent_id、actual_subagent_type: coder· status: completed、stop_reason: completed· [summary] ← 上面那段正文· resume_hint ← 怎么续跑**描述:**正文不截断;成没成、是什么类型、怎么续跑都是字段,父代理不用猜。 |
例子: 同一个任务,coder 的最后一条消息就是交接,规格要求它自己写全: · 改了什么、为什么这么改 · 动过的每个文件路径 · 怎么验证的(哪条命令、结果是什么) · 还剩什么没做、什么值得跟进 父代理收到的:这段话原样,末尾加一行 (本次委派实例:sa_…)**描述:**没有回执、没有状态字段、没有程序生成的清单文件;四件套是 coder 规格的要求,不是程序的保证(模型没写全,父代理就收不全)。50 KB 上限只是极端情况的一道保险。 |
| 续跑 | 拿编号调 Agent(resume=…),它从自己的日志里把同一个实例重建出来,没跑完的也能接着干。 |
只认完整档案;正在跑或半截的拒绝;续跑产出新实例,metadata 写 resumed_from,续不续由模型自己决定。 |
| 工具权限 | 自身 profile 的 tools 与全局、工作区、会话三层策略求交,不是父池子集。 | 严格父池子集;委派、resume、技能工具在结构上就拿不到。 |
| 嵌套 | 默认禁,写 subagents: 白名单可放开;另有 AgentSwarm 批量派发。 |
永远不能,子代理拿不到委派工具。 |
| 模型 | 父调用时可以从池里选一个。 | 规格文件里写 model ref,不写就继承主模型。 |
| 运行形态 | 可后台跑,配 TaskList、TaskOutput、TaskWait、TaskStop;默认 2 小时超时;重启后未完成标 lost 并提醒。 | 纯前台阻塞,有池级并发闸,没有后台任务和超时管理。 |
2. 折叠回查
一句话:折叠之后想找回原文,kimi 的入口是程序机械贴在摘要末尾的路径与行号窗口,tako 的入口是 每轮随请求声明的 search_history 工具;两家都不保证一定查得到,差别在入口由谁塞给模型。
| kimi | tako | |
|---|---|---|
| 有没有专门的查询工具 | 没有 | 有,search_history(每轮随请求声明,不用挂) |
| 原文在哪 | 磁盘 agents/main/wire.jsonl,一行一条 JSON,只追加;每个子代理有自己的文件 |
数据库 runlog_entries(本会话已提交的行) |
| 模型怎么查 | 模型要自己想到一个原样出现在日志里的字面串。摘要末尾由程序机械贴了行号窗口,模型可以直接跳到那个区间读某一行(Read 带 line_offset、n_lines=1,长行按 column_offset 续读);也可以先 grep 在区间里缩小范围;bash 可用时还能用它配合 jq 直接抽某个字段的正文 | 模型要自己猜出一个确信在原文里原样出现过的词,写进 query 参数;程序不做抽取,只按空格切词,再用 ILIKE %词% 要求所有词同时命中,按时间倒序取;它不对词做语义兜底,猜成同义词就返回零条 |
| 举个例子 | **前提:**摘要末尾那段 Context Recovery 由程序机械贴上,告诉它原始日志在磁盘上、怎么读,于是它知道自己有得查。 **输入:**用户问“刚才那个 111408 是什么意思,是 key 配错了吗?”,模型从这句话里挑出 111408 这个字面串。**处理:**在 bash 里跑 grep -n "111408" agents/main/wire.jsonl 拿到行号,再精确读第 2841 行(长 JSON 要按 column_offset 续读)。**输出:**第 2841 行那条记录的完整内容,原始工具返回的字段和正文都在。 |
**前提:**它每轮都能读到 search_history 的工具说明,上面写着“用户在问本会话更早一轮的错误码、原句或工具返回中的一截时使用”,于是它知道自己有得查。**输入:**用户问“刚才那个 111408 是什么意思,是 key 配错了吗?”,模型从这句话里挑出两个词,填 query = "111408 key"。**处理:**按空格切成两个词,拼成 text ILIKE '%111408%' AND text ILIKE '%key%',在已提交的行里按时间倒序取。**输出:**只返回两个词都出现的行,每行给一段以 111408 为中心、前后各 200 字的上下文;一行都不满足就是“命中 0 条”。 |
| 谁保证它能用 | 程序把路径、格式、行号窗口机械贴在摘要末尾——这部分是硬的;但“去不去查、怎么查”靠模型读那段说明加沙箱权限,是软的 | 工具 schema 每轮随请求声明,和系统提示同属提示词,能调就保证返回结果,不依赖 bash;但“想起来调、词猜得对”靠模型,是软的 |
3. 出处
tako 侧:
- 子代理规格装载:
yk-tako-eino/internal/runengine/agents.go(run 起手扫agents/或租户规格表) - coder 规格:
yk-tako-eino/agents/coder.md;设计讨论见 doc/23 - 回传与截断:
agents.go的runSubagentGuarded/truncateDelegationReturn;上限 flag-subagent-return-cap(默认 51200 字节) - 子代理档案:
internal/runengine/subagent_wire.go;设计见 doc/39 - 折叠回查:
internal/runengine/search.go;设计见 doc/21
kimi 侧(本机 ref-agent/kimi-code/):
- 规格与角色前缀:
packages/agent-core-v2/src/session/agentLifecycle/profile/profiles.ts - 自定义 agent 与 frontmatter 字段:
docs/en/customization/agents.md - 回传的固定格式(回执):
packages/agent-core-v2/src/agent/tools/agent/agentTool.ts - 折叠摘要末尾的 Context Recovery:
packages/agent-core-v2/src/agent/fullCompaction/contextRecovery.ts与context-recovery-footer.md