本页内容

跨 Agent ToDoList

任务清单记的是你的长期待办；跨 Agent ToDoList 记的是要交给运行中 Agent 执行的任务。两者互不影响。交接条目保存标题、上下文与目标，换会话或重启应用都不会丢失。

跨项目交接示例#

当前端、后端和客户端需要配合时，先让 Kaya 汇总需求文档、接口约定、已完成内容与待办，再把需求和上下文交给目标 Agent。不同项目各自保留终端和工作目录，通过同一份约定衔接工作。

例如，在对话中提出：

整理登录接口的约定，交给后端 Agent 实现；前端 Agent 负责接入。两边沿用同一份约定，完成后分别汇报结果。

确认目标与分工后派发，目标 Agent 读取需求、检查自己的项目并继续工作。你可以随时查看终端输出，询问进展或调整下一步。跨项目可以在本机完成；如果还需要跨设备派发，请另见跨机协同。

默认由你决定：目标 Agent 空闲时，对话里的 AI 会询问「现在执行吗」，你明确同意后才派发；也可以随时手动点「派发」。在 设置 → 模型 把「指令确认」切到自动模式后，时机成熟可直接派发，但终端写入仍受授权卡约束。

派发需要 coding 模式总闸 + 该 tab 授权卡。如果点击派发时还没有终端写入授权，Kaya 会一并弹出授权卡，允许后自动派出。

Kaya 会识别 Agent 已经自行完成或正在执行的任务，避免重复派发。已经开始的任务会转为「执行中」并进入后续感知闭环；同一 Agent 有多个实例、无法确定目标时，不会自动接管。

Chat 输入框上方的 To Do List 默认收起，展开后可见：

完成后不再自动删除，而是进入底部「已完成」折叠区，保留完成时间、结论与证据，最多 50 条，可一键清空。展开态的「汇总进展」会把各 Agent / 仓库的进展整理成报告发到对话里。

失败条目保留结构化原因：执行失败 / 感知不明 / 目标已退出 / 环境受阻。可以按原因选择重试、重新观察、标记完成、重派或删除。

Agent 报空闲不等于任务完成。空闲后 Kaya 发起一轮感知回合，综合三类证据：

结论分为：已完成 / 仍在推进 / 执行失败 / 证据不足 / 与本任务无关。证据不足不会立即判失败；连续多轮无法判断才收敛为「感知不明」，你可以人工确认后标记完成。

目标或验收标准不明确时，Kaya 先向你澄清，不创建含糊任务。
确认执行失败时先读屏归因，不盲目重试；失败条目显示原因与补救建议。
自动模式下，除「任务不清」外会带归因自动重试一次，仍失败则停下来等你。
Kaya 的创建与验收遵循小步快跑、改动带测试、验收要证据、失败先归因。可以在 ~/.kaya/methodology.md 写入自己的规范；该文件会随对话发给模型，不要写入机密。

ToDoList 只存本机。重启时进行到一半的任务安全回到待执行，不会丢失。