Todo Write Tool (todo_write)

このドキュメントでは、Qwen Code 用の todo_write ツールについて説明します。

概要

todo_write を使用して、現在のコーディングセッション用に構造化されたタスクリストを作成・管理できます。このツールは、AIアシスタントが進捗状況を追跡し、複雑なタスクを整理するのに役立ち、あなたがどの作業が行われているかを可視化できます。

引数

todo_write は1つの引数を取ります：

• todos（配列、必須）：todoアイテムの配列で、各アイテムには以下が含まれます：
  • id（文字列、必須）：todoアイテムの一意の識別子。
  • content（文字列、必須）：タスクの説明。
  • status（文字列、必須）：現在のステータス（pending、in_progress、またはcompleted）。

todo_write の使い方 (Qwen Code と一緒に)

AIアシスタントは、複雑なマルチステップタスクに取り組む際に自動的にこのツールを使用します。明示的にリクエストする必要はありませんが、リクエストに対する計画的なアプローチを確認したい場合は、アシスタントにtodoリストを作成するよう依頼できます。

このツールは、ホームディレクトリ（~/.qwen/todos/）にセッション固有のファイルとしてtodoリストを保存するため、各コーディングセッションで独自のタスクリストを維持できます。

AIがこのツールを使用するタイミング

アシスタントは以下のケースで todo_write を使用します：

• 複数のステップが必要な複雑なタスク
• 複数のコンポーネントを持つ機能実装
• 複数のファイルにまたがるリファクタリング操作
• 3つ以上の異なるアクションを含む作業

アシスタントは、単純な1ステップタスクや純粋に情報提供のみを目的とするリクエストに対してはこのツールを使用しません。

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リストを持ち、他のセッションと干渉することはありません。