Lister les éléments ouverts avant d'en ajouter un autre
Lire d'abord permet d'éviter les TODO dupliqués lorsque plusieurs agents travaillent dans le même périmètre de projet.
todo({ action: "list" })Outil MCP public
todo
Objectif
Créer, mettre à jour, terminer, lister ou supprimer en bloc de manière explicite les TODO de projet tout en préservant l'état des tâches à proximité de leur contexte de projet autorisé.
Quand l'utiliser
- Un utilisateur a besoin d'un état de tâche durable, de dates d'échéance, de priorité, d'achèvement ou d'une liste de passation.
- Un espace de travail de projet a besoin d'une mutation régie de TODO avec sa capacité de montage signée.
- L'appelant a besoin de lister les éléments ouverts, en cours, terminés ou tous les éléments autorisés.
Quand NE PAS l'utiliser
- N'utilisez pas les TODO pour des faits ou décisions durables généraux ; utilisez remember.
- Ne stockez pas de transactions financières comme contenu de TODO ; utilisez ledger.
- N'appelez pas delete_all sans demande explicite de l'utilisateur et confirm_delete_all=true.
- L'API REST accepte un ensemble de champs plus large que l'outil MCP public ; consultez /docs/api/memory pour les filtres de périmètre, bucket, équipe et provenance.
Périmètre requis
- La liste utilise memory:read ; créer, mettre à jour, terminer et delete_all utilisent memory:write dans la surface de chat publique.
- Les mutations d'espace de travail de projet nécessitent en outre un mount_capability et un project_id valides.
Paramètres
| Nom | Type | Description |
|---|---|---|
action | create | update | complete | list | delete_all · requis | Opération du répartiteur. |
todo_id | string | ID d'élément exact pour la mise à jour ou l'achèvement. |
content / title | string | Texte de la tâche ; lorsque les deux sont fournis, ils doivent concorder. |
project_id | string | Identifiant autorisé de l'espace de travail du projet. |
priority / due_at / status / note | string | Priorité de tâche, horodatage d'échéance, transition de statut et note de passation. |
item_status / due_before / search / query | string | Filtres de liste ; search et query sont réservés à la liste et doivent concorder lorsque les deux sont fournis. |
limit / cursor / owner_timezone | integer / string · par défaut : 20 / empty / configured timezone | Contrôles de pagination et d'interprétation des dates. |
client_mutation_id / expected_version | string / integer | Clé d'idempotence pour create/update et version de concurrence optimiste pour update. |
confirm_delete_all | boolean · par défaut : false | Requis à true pour une suppression en bloc réversible explicite. |
Schéma de retour
La sortie structurée identifie l'action et renvoie le ou les éléments concernés, le curseur de pagination, le statut de la mutation et les métadonnées sécurisées de la tâche. La suppression en bloc est toujours une suppression réversible récupérable.
Exemples
todo({
action: "create",
content: "Review the MCP scope matrix",
client_mutation_id: "task-review-scope-001",
due_at: "2026-08-25T09:00:00Z"
})todo({ action: "list", item_status: "open", limit: 10 })Erreurs
- Échec d'autorisation : la liste manque de memory:read ou une mutation manque de memory:write/capacité de projet.
- Échec de validation : la création manque de client_mutation_id, la mise à jour manque d'un expected_version positif, ou des champs d'action sont en conflit.
- Rejet de sécurité : delete_all requiert une confirmation explicite et n'est pas accessible aux appelants de widget/capacité de montage.
- Les erreurs de fuseau horaire, de projet ou de concurrence optimiste sont renvoyées explicitement ; le répartiteur n'ignore pas silencieusement des champs.
Outils associés
- remember — Enregistrer la décision ou le fait durable sous-jacent à une tâche.
- recall_context — Restaurer le contexte de tâche et de projet avant de poursuivre le travail.
- forget — Supprimer un TODO examiné par son ID exact si nécessaire.
Source : Assistants de flux de travail du SDK