Инструмент для работы со списком задач (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": "Создать модель пользовательских предпочтений",
"status": "pending",
"activeForm": "Создание модели пользовательских предпочтений"
},
{
"content": "Добавить конечные точки API для предпочтений",
"status": "pending",
"activeForm": "Добавление конечных точек API для предпочтений"
},
{
"content": "Реализовать компоненты интерфейса",
"status": "pending",
"activeForm": "Реализация компонентов интерфейса"
}
])Важные замечания
- Автоматическое использование: ИИ-ассистент автоматически управляет списками дел во время выполнения сложных задач.
- Видимость прогресса: Списки дел обновляются в режиме реального времени по мере выполнения работы.
- Изолированность сессий: Каждая сессия программирования имеет собственный список дел, который не пересекается с другими сессиями.