Outil Todo Write (`todo_write`)

Ce document décrit l’outil todo_write pour Qwen Code.

Description

Utilisez todo_write pour créer et gérer une liste de tâches structurée pendant votre session de codage actuelle. Cet outil aide l’assistant IA à suivre l’avancement et organiser les tâches complexes, en vous offrant une visibilité sur le travail en cours.

Arguments

todo_write prend un seul argument :

todos (array, requis) : Un tableau d’éléments todo, où chaque élément contient :
- id (string, requis) : Un identifiant unique pour l’élément todo.
- content (string, requis) : La description de la tâche.
- status (string, requis) : Le statut actuel (pending, in_progress, ou completed).

Comment utiliser `todo_write` avec Qwen Code

L’assistant IA utilisera automatiquement cet outil lorsqu’il travaille sur des tâches complexes nécessitant plusieurs étapes. Vous n’avez pas besoin de le demander explicitement, mais vous pouvez demander à l’assistant de créer une liste de tâches si vous souhaitez voir l’approche planifiée pour votre demande.

L’outil stocke les listes de tâches dans votre répertoire personnel (~/.qwen/todos/) avec des fichiers spécifiques à chaque session, afin que chaque session de codage conserve sa propre liste de tâches.

Quand l’IA utilise cet outil

L’assistant utilise todo_write pour :

Les tâches complexes nécessitant plusieurs étapes
Les implémentations de fonctionnalités avec plusieurs composants
Les opérations de refactoring sur plusieurs fichiers
Tout travail impliquant 3 actions distinctes ou plus

L’assistant n’utilisera pas cet outil pour les tâches simples d’une seule étape ou les demandes purement informatives.

Exemples `todo_write`

Création d’un plan d’implémentation de fonctionnalité :


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"
  }
])

Notes importantes

Utilisation automatique : L’assistant AI gère automatiquement les listes todo pendant les tâches complexes.
Visibilité de la progression : Vous verrez les listes todo mises à jour en temps réel au fur et à mesure de l’avancement du travail.
Isolation des sessions : Chaque session de codage possède sa propre liste todo qui n’interfère pas avec les autres.

Outil Todo Write (todo_write)