tako 文档 GitHub

Handoff · pre-T3 落地(lease 小拍 → T1 → T2)(2026-10-08)

性质:执行 handoff——供接手会话直接开工。范围 = T3 之前的三个任务(lease 小拍 → T1 → T2); T3 本体不在内,停线 = T3 动工前必拍三项(§4)。 触发:用户 2026-10-08「我在另一个会话去落地 t3 之前的任务」;随本文件同批落了两处台账补登—— todos「T 系列」节(lease 小拍四要素 + T3 动工前必拍三项)与 planning §2/§11 镜像。 取信口径:全部为 2026-10-08 当日实读(代码坐标在文内);机制结论均带源坐标、可直接复查。 前置阅读(按序):doc/19-v6/19v6-05-tool-loop.md(机制裁定真源)→ tmp/19-v6/planning.md §11(施工规格) → tmp/19-v6/todos.md「T 系列」节(四要素权威原文——冲突以台账为准;本文件是导览 + 操作要点)。

0. 一句话现状

1. 硬约束与环境(动手前先过一遍)

2. 三个 action(权威四要素见 todos「T 系列」节;这里只给导览 + 已勘察的接线)

2.1 前置小拍 · lease 参数(5s→10s + .env 化)

2.2 T1 · ADK 接入 + Handler 观测架

2.3 T2 · get_time(帧契约 + mh 两列 + runlog 两列)

3. 已裁承重裁定(防重开论战;出处 = 19v6-05 / planning §11.1 / todos 2026-10-08 已裁块)

裁定 内容
底座 循环走 Eino ADK(用户拍板)
sub agent 落地 adk.NewAgentTool 自组装,不用 prebuilt/deep 整包(捆绑 write_todos/FS/Shell + prompt 哲学)
观测 Handler 全套钩子终端日志(脚手架,转正点 T6)
工具分级 node 全注册 + BeforeModelRewriteState 声明过滤(direct/deferred/hidden)
tool_search T4 直出 / T5 BM25 = 独立 task;任何 agent 只搜自己池的 deferred 项
子代理 Model message 进程内、跑完即弃;帧带 agent;runlog 消息粒度;并行不改表
规格 tools 两态:白名单 / 白名单+search(用户裁「当然要」)
fork 后面再做(copy-on-write 策略已备,§11.4)
挂账(用户裁「先别搞」) 子代理目录运行时安装、运行中途改工具集

4. 停线:T3 动工前必拍三项(已写进 todos T3 节)

① 规格字段表(name/description/tools/model 最小集;model 继承 or 覆盖未落笔); ② 预算面明账(并发上限 / 超时 / 回传裁剪;pi 参考 8 任务 / 4 并发 / 并行回传裁 50KB); ③ 规格库 loop(候选)(文件式规格 / 发现时机 / 信任门)——已登记 planning §2「前方未开工登记项」。

到 T3 动工前先把三项拍掉;T3 本体不在本 handoff 范围。

5. 素材坐标索引

素材 位置
机制裁定真源 doc/19-v6/19v6-05-tool-loop.md;19v6-06-deferred-tools与缓存机制.md(缓存 / 延迟工具)
契约真源 doc/19-v6/19v6-01-契约-四个API.md(帧 / 端点字节)、19v6-04-验收-curl.md(期望字节)
施工规格 tmp/19-v6/planning.md §11
四要素权威 tmp/19-v6/todos.md「T 系列」节(lease 小拍 + T1–T6)
Eino ~/go/pkg/mod/github.com/cloudwego/eino@v0.9.21/adk/(chatmodel.go / middlewares/ / agent_tool.go)
现引擎代码 yk-tako-eino/internal/runengine/worker.go(循环 / translator);yk-tako-eino/cmd/yktako/main.go(旗标 / 租约注释)
环境 scripts/dev.sh;yk-tako-eino/.env;internal/runengine/store_test.go(真实例网)
D1 证据 tmp/19-v6/evidence-d1/;todos「D 系列」节末
参考实现 ref-agent/pi(subagent 扩展示例 + src/experimental/durable/)、ref-agent/deepseek-harness

6. 纪律提醒(给接手会话)