mcpField
A
ai-todo

ai-todo

github.com/strzhao生産性047 回インストール8 週間前に更新
リポジトリ

ai-todo について

AI エージェントが ai-todo のコマンドラインでタスク、進捗、作業ログを管理するためのスキルです。サービス上にセッションをまたいで情報を保持し、変更前にタスク階層を確認します。

主な機能

  1. 01階層型タスクツリーの確認
  2. 02タスクの一覧表示と作成
  3. 03進捗と完了状態の更新
  4. 04作業ログの追加
  5. 05プロジェクトと親タスクによる整理
  6. 06計画時と作業後の記録

活用シーン

  1. 01機能計画をタスクに分解
  2. 02実装中の進捗を追跡
  3. 03完了したコミットやデプロイを記録
  4. 04セッションをまたいでタスクの文脈を維持

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/strzhao/ai-todo-cli --skill ai-todo

インストール後、Claude Code で/ai-todoを入力して読み込まれたか確認します。

詳細

AI Todo - AI エージェント向けタスク管理

ai-todo CLI を使ってタスクを管理し、進捗を追跡し、作業ログを維持します。ai-todo (https://ai-todo.stringzhao.life) に接続すると、セッションをまたいだ永続的なタスク管理を実現できます。

前提条件

コマンドを実行する前に、認証状態を確認します：

cat ~/.config/ai-todo/credentials.json 2>/dev/null

未認証の場合は ai-todo login を実行します。インストールされていない場合は npm install -g ai-todo-cli を実行します。

コマンドの確認

コマンドはサーバーから動的に読み込まれるため、ハードコードは厳禁です。コマンドを初めて使う前に、--help でパラメーターを確認します：

ai-todo --help                    # 查看所有可用命令
ai-todo <command> --help          # 查看具体命令的参数

主な規約：

  • デフォルトの出力は JSON です。tasks:tree はプレーンテキストを出力します
  • パラメーターの形式は --key <value> です（--parent_id のように snake_case を使用）
  • 名前空間：タスク操作は tasks:*、スペース操作は spaces:*
  • 終了コード：0=成功、1=エラー、2=未認証

コアワークフロー

ステップ 1：タスク構造を把握する（操作の前に毎回必ず実行）
ai-todo tasks:tree

ツリー形式のテキストを出力します。📌 はプロジェクトスペースを示し、インデントは親子関係を表します。以下に使用します：

  • 新しいタスクを割り当てるプロジェクトスペースまたは親タスクを見つける
  • 重複タスクの作成を避ける
  • 既存のタスク分割を理解する

重要な原則：タスクは正しいプロジェクトと親タスクの下に配置する必要があります。トップレベルにむやみに作成しないでください。

タスクの表示
ai-todo tasks:tree                    # 全局任务树
ai-todo tasks:list --filter today     # 今天的任务
ai-todo tasks:list --filter assigned  # 分配给我的任务
タスクの作成

ユーザーが作業計画を説明した場合、または分割可能な項目を見つけた場合：

  1. まず tasks:tree を実行し、正しい配置先を見つけます
  2. 親タスクを作成します（または既存のものを再利用します）
  3. --parent_id を使って子タスクを作成します
  4. 優先度を適切に設定します（P0=ブロッカー、P1=主要、P2=重要度の低い項目）
ai-todo tasks:create --title "实现支付功能" --priority P1
ai-todo tasks:create --title "对接微信支付" --parent_id <父任务ID> --tags backend
進捗の更新とタスクの完了

作業段階に応じて、適切な操作を選択します：

  • 作業開始：tasks:update --id <ID> --progress 20
  • 段階的な進捗：tasks:update --id <ID> --progress 60 + tasks:add-log --id <ID> --content "XXを完了しました"
  • 作業完了：tasks:complete --id <ID>（子タスクも自動的に完了します）
  • 記録のみ：tasks:add-log --id <ID> --content "XXを実施しました"

ユーザーが明確に「完了した」と伝えた場合は、直接 tasks:complete を使います。段階的な進捗の場合は、tasks:update で progress を増やします。

アクション後（git commit/push/deploy の後）
  1. tasks:tree で関連タスクを見つけます
  2. 関連タスクがある場合 → 進捗を更新し、ログを追加します。完了した場合は tasks:complete を実行します
  3. 関連タスクがない場合 → 完了した作業を記録するタスクの作成を提案します
  4. 軽量な操作では、要約ログを1件追加すれば十分です
アクション前（計画段階）

ユーザーが機能計画、技術設計、スプリントのスケジュールについて話し合う場合：

  1. 話し合いから実行可能な項目を抽出します
  2. タスク階層（親タスク + 子タスク）を作成します
  3. 依存関係に応じて優先度を設定します
スキル間の連携
  • git-tools の完了後：関連タスクに進捗を記録します
  • vercel:deploy の完了後：デプロイを記録し、関連タスクを完了します
  • brainstorming の終了後：結論をタスク階層に変換します

コメント

Markdown 対応