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

Инструмент 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-ассистент автоматически управляет списками задач во время сложных задач.
  • Видимость прогресса: Вы будете видеть, как списки задач обновляются в реальном времени по мере выполнения работы.
  • Изоляция сессий: Каждая сессия кодирования имеет свой собственный список задач, который не мешает другим.
Last updated on