如何建立 TodoWrite 任务程序？

1. 主要概念澄清

痛点： 开发者常常混淆"Todo"和"Task"这两个概念，导致程序设计混乱。理解它们的区别是建立可靠任务程序的第一步先。

"Ah-ha!"时刻：这两者不是互斥关系。一个Todo可能触发多个Task，而一个Task也可以包含多个Todo项。就像你在笔记本上写下一系列待办事项，接下来每个事项可能需要启动不同的工具或进程来完成。

痛点：您是否曾因以下情况苦恼？

2.1 数据模型 - 清晰定义你的待办事项

type TodoItem = {
content: string // "读取src/utils/tasks.ts"
再看status。
'pending' | 'in_progress' | 'completed'
activeForm: string // "Reading src/utils/tasks.ts"
}
type TodoList = TodoItem

"activeForm"字段特别有用！它使用动词+ing形式显示正在进行中的活动，这比静态描述更符合人的认知方式。再看例如，"Reading file X"比"Read file X"更直观地表达当前正在做什么。

2.2 工具实现 - 助你高效管理待办事项

async call {
const appState = context.getAppState
// 每个代理/会话有独立todo列表
const todoKey = context.agentId?，话说回来，getSessionId
const oldTodos = appState.todos?，// 自动清理已完成所有todo
const allDone = todos.every
const newTodos = allDone?: todos
// 验证提醒机制
let verificationNudgeNeeded = feature && ...
allDone && todos.length>= &&!todos.some)
context.setAppState(prev => ({
...prev,todos: { ...prev.todos,: newTodos }。}))
}
return { data: { oldTodos,newTodos,verificationNudgeNeeded } }
}
}
}
}