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

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

Описание

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

Аргументы

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

todos (array, обязательный): Массив элементов todo, где каждый элемент содержит:
- id (string, обязательный): Уникальный идентификатор элемента todo.
- content (string, обязательный): Описание задачи.
- status (string, обязательный): Текущий статус (pending, in_progress или completed).

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

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

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

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

Ассистент использует todo_write для:

Сложных задач, требующих нескольких шагов
Реализации функций с несколькими компонентами
Операций рефакторинга в нескольких файлах
Любых работ, включающих 3 или более отдельных действия

Ассистент не будет использовать этот инструмент для простых, одноэтапных задач или чисто информационных запросов.

Примеры использования `todo_write`

Создание плана реализации фичи:


todo_write(todos=[
  {
    "id": "create-model",
    "content": "Create user preferences model",
    "status": "pending"
  },
  {
    "id": "add-endpoints",
    "content": "Add API endpoints for preferences",
    "status": "pending"
  },
  {
    "id": "implement-ui",
    "content": "Implement frontend components",
    "status": "pending"
  }
])

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

Автоматическое использование: AI-ассистент автоматически управляет списками todo во время сложных задач.
Видимость прогресса: Вы будете видеть, как списки todo обновляются в реальном времени по мере выполнения работы.
Изоляция сессий: Каждая сессия кодинга имеет свой собственный список todo, который не мешает другим.

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