Skip to Content
Руководство для разработчиковИнструментыЗапись задач

Инструмент для работы со списком задач (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": "Реализация компонентов интерфейса" } ])

Важные замечания

  • Автоматическое использование: ИИ-ассистент автоматически управляет списками дел во время выполнения сложных задач.
  • Видимость прогресса: Списки дел обновляются в режиме реального времени по мере выполнения работы.
  • Изолированность сессий: Каждая сессия программирования имеет собственный список дел, который не пересекается с другими сессиями.
Last updated on