计划模式和任务跟踪

Triggerfish 提供两个互补的结构化工作工具：计划模式用于复杂实施规划，待办跟踪用于跨会话的任务管理。

计划模式

计划模式约束智能体在做出更改之前进行只读探索和结构化规划。这防止智能体在理解问题之前就跳入实施。

工具

plan_enter

进入计划模式。阻止写操作（write_file、cron_create、cron_delete），直到计划获批。

参数	类型	必需	描述
goal	string	是	智能体计划构建/更改的内容
scope	string	否	将探索限制在特定目录或模块

plan_exit

退出计划模式并呈现实施计划供用户批准。不会自动开始执行。

plan_approve

批准待处理计划并开始执行。用户批准时调用。

plan_reject

拒绝待处理计划并返回正常模式。

工作流

1. 用户要求复杂的事情
2. 智能体调用 plan_enter({ goal: "..." })
3. 智能体探索代码库（仅只读工具）
4. 智能体调用 plan_exit({ plan: { ... } })
5. 用户审查计划
6. 用户批准 → 智能体调用 plan_approve
   （或拒绝 → 智能体调用 plan_reject）
7. 智能体逐步执行，每步后调用 plan_step_complete
8. 智能体完成后调用 plan_complete

待办跟踪

智能体有一个持久的待办列表，用于跟踪跨会话的多步骤工作。

工具

todo_read

读取当前待办列表。返回所有项目及其 ID、内容、状态、优先级和时间戳。

todo_write

替换整个待办列表。这是完全替换，不是部分更新。

参数	类型	必需	描述
todos	array	是	完整的待办项目列表

行为

• 待办项按智能体（非按会话）范围——跨会话、触发器唤醒和重启持久化
• 智能体仅对真正复杂的任务（3+ 个不同步骤）使用待办
• 一次只有一个任务为 in_progress；完成的项目立即标记
• 当智能体写入的新列表省略了先前存储的项目时，这些项目自动保留为 completed

显示

待办在 CLI 和 Tidepool 中都有渲染：

• CLI —— 带状态图标的 ANSI 样式框：✓（已完成，删除线）、▶（进行中，粗体）、○（待处理）
• Tidepool —— 带每种状态 CSS 类的 HTML 列表