Инструмент Todo Write (`todo_write`)

В этом документе описывается инструмент todo_write для Qwen Code.

Описание

Используйте todo_write для создания и управления структурированным списком задач в рамках текущей сессии разработки. Этот инструмент помогает AI-ассистенту отслеживать прогресс и организовывать сложные задачи, предоставляя вам информацию о выполняемой работе.

Аргументы

todo_write принимает один аргумент:

todos (массив, обязательный): Массив элементов todo, где каждый элемент содержит:
- content (строка, обязательный): Описание задачи.
- status (строка, обязательный): Текущий статус (pending, in_progress или completed).
- activeForm (строка, обязательный): Форма настоящего продолженного времени, описывающая выполняемое действие (например, “Running tests”, “Building the project”).

Как использовать `todo_write` с Qwen Code

AI-ассистент будет автоматически использовать этот инструмент при работе над сложными многошаговыми задачами. Вам не нужно явно запрашивать его, но вы можете попросить ассистента создать список задач, если хотите увидеть запланированный подход к вашему запросу.

Инструмент сохраняет списки задач в вашей домашней директории (~/.qwen/todos/) в файлах, привязанных к конкретной сессии, поэтому каждая сессия разработки хранит собственный список задач.

Когда AI использует этот инструмент

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

Инструмент Todo Write (todo_write)