Todo Write Tool (`todo_write`)

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

Описание

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

Инструмент отключен по умолчанию. Включите его в settings.json и перезапустите Qwen Code:


{
  "tools": {
    "todoWrite": {
      "enabled": true
    }
  }
}

Аргументы

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

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

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

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

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

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

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

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

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

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

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


todo_write(todos=[
  {
    "id": "1",
    "content": "Create user preferences model",
    "status": "pending"
  },
  {
    "id": "2",
    "content": "Add API endpoints for preferences",
    "status": "pending"
  },
  {
    "id": "3",
    "content": "Implement frontend components",
    "status": "pending"
  }
])

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

Включение явно: Установите tools.todoWrite.enabled в true и перезапустите Qwen Code перед использованием инструмента.
Автоматическое использование при включении: ИИ-ассистент управляет списками задач при выполнении сложных задач.
Видимость прогресса: Вы будете видеть списки задач, обновляемые в реальном времени по мере выполнения работы.
Изоляция сеансов: Каждый сеанс кодирования имеет свой собственный список задач, который не пересекается с другими.

Todo Write Tool (todo_write)