Инструмент Todo Write (todo_write)
В этом документе описывается инструмент todo_write для Qwen Code.
Описание
Используйте todo_write для создания и управления структурированным списком задач для текущей сессии программирования. Этот инструмент помогает ИИ-ассистенту отслеживать прогресс и организовывать сложные задачи, обеспечивая вам видимость выполняемой работы.
Аргументы
todo_write принимает один аргумент:
todos(массив, обязательный): Массив элементов списка дел, где каждый элемент содержит:content(строка, обязательная): Описание задачи.status(строка, обязательная): Текущий статус (pending,in_progressилиcompleted).activeForm(строка, обязательная): Форма настоящего продолженного времени, описывающая то, что делается (например, “Запуск тестов”, “Сборка проекта”).
Как использовать todo_write с Qwen Code
ИИ-ассистент автоматически использует этот инструмент при работе над сложными многоэтапными задачами. Вам не нужно явно запрашивать его, но вы можете попросить ассистента создать список дел, если хотите увидеть запланированный подход к вашему запросу.
Инструмент сохраняет списки дел в вашем домашнем каталоге (~/.qwen/todos/) в файлах, специфичных для сессии, поэтому каждая сессия программирования поддерживает свой собственный список задач.
Когда ИИ использует этот инструмент
Ассистент использует todo_write для:
- Сложных задач, требующих нескольких шагов
- Реализации функций с несколькими компонентами
- Операций рефакторинга в нескольких файлах
- Любых работ, включающих 3 или более отдельных действия
Ассистент не будет использовать этот инструмент для простых одноэтапных задач или чисто информационных запросов.
Примеры todo_write
Создание плана реализации функции:
todo_write(todos=[
{
"content": "Create user preferences model",
"status": "pending",
"activeForm": "Creating user preferences model"
},
{
"content": "Add API endpoints for preferences",
"status": "pending",
"activeForm": "Adding API endpoints for preferences"
},
{
"content": "Implement frontend components",
"status": "pending",
"activeForm": "Implementing frontend components"
}
])Важные замечания
- Автоматическое использование: AI-ассистент автоматически управляет списками задач во время сложных задач.
- Видимость прогресса: Вы будете видеть, как списки задач обновляются в реальном времени по мере выполнения работы.
- Изоляция сессий: Каждая сессия кодирования имеет свой собственный список задач, который не мешает другим.