Todo Write Tool（todo_write）

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

説明

todo_write を使用して、現在のコーディングセッションの構造化タスクリストを作成および管理します。このツールは AI アシスタントが進捗を追跡し、複雑なタスクを整理するのに役立ち、実行中の作業を可視化します。

引数

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

• todos（配列、必須）：Todo アイテムの配列。各アイテムは次の要素を含みます：
  • content（文字列、必須）：タスクの説明。
  • status（文字列、必須）：現在のステータス（pending、in_progress、completed）。
  • id（文字列、必須）：Todo アイテムの一意の識別子。

Qwen Code での todo_write の使用方法

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

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

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

アシスタントは 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"
  }
])

重要な注意事項

• 自動使用： AI アシスタントは複雑なタスク中に todo リストを自動的に管理します。
• 進捗の可視化： 作業の進行に伴い、todo リストがリアルタイムで更新されるのを確認できます。
• セッションの分離： 各コーディングセッションは独自の todo リストを持ち、他のセッションと干渉しません。