todo-resolve について
リポジトリ内の承認済みで ready 状態の todo を解決するスキルです。実装を並行して委任し、学びを記録して完了した todo ファイルを整理します。未処理の項目も報告します。
主な機能
- 01ready、pending、complete を分類
- 02ready 項目を並行して解決
- 03学びを記録
- 04解決済み todo ファイルを整理
活用シーン
- 01承認済みのリポジトリ todo を処理
- 02未トリアージの pending 項目を残す
- 03修正で得たパターンを記録
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ everyinc/ compound-engineering-plugin --skill todo-resolveインストール後、Claude Code で/todo-resolveを入力して読み込まれたか確認します。
詳細
承認済みの todo を並列処理で解決し、得られた教訓を記録してから、後片付けを行います。
解決するのは ready の todo だけです。pending の todo は、まだトリアージされていないためスキップします。pending の todo がある場合は、残っているものがわかるよう、最後に一覧表示してください。
ワークフロー
1. 分析する
.context/compound-engineering/todos/*.md と従来の todos/*.md を確認し、ステータスごとに分類します。
ready(ステータスフィールド、またはファイル名の-ready-):解決します。pending:スキップし、最後に報告します。complete:すでに完了しているため、無視します。
引数として特定の todo ID またはパターンが渡された場合は、一致する todo のみに絞り込みます(ただし、ready のものに限ります)。
ce:review mode:autofix の safe_auto パス後に残った、対応可能な作業はすでに ready になっています。
docs/brainstorms/、docs/plans/、docs/solutions/ のファイルの削除、除去、または Git での無視を推奨する todo はスキップしてください。これらは意図的なパイプラインの成果物です。
2. 計画する
タスク一覧を種類ごとにまとめて作成します(Claude Code の TaskCreate、Codex の update_plan など)。依存関係を分析し、ほかの項目が依存する項目を先に実行します。実行順序と並列処理を示す mermaid 図を出力します。
3. 実装する(並列)
項目ごとに compound-engineering:workflow:pr-comment-resolver エージェントを起動します。並列処理を優先し、できない場合は依存関係に従って順次処理します。
バッチ処理: 項目が1~4件の場合は、直接並列で実行します。5件以上の場合は、4件ずつのバッチで処理します。各バッチから返すのは、短いステータスの要約のみとします(対応した todo、変更したファイル、実行/スキップしたテスト、ブロッカー)。
件数が多い場合は、.context/compound-engineering/todo-resolve/<run-id>/ に一時ディレクトリを作成し、各リゾルバーの成果物を保存します。親には完了要約のみを返します。
4. コミットして解決する
変更をコミットし、todo を解決済みにして、リモートにプッシュします。
ゲート:停止します。次に進む前に、todo が解決済みで変更がコミットされていることを確認します。
5. 学んだことをまとめる
ce:compound スキルを読み込み、学んだことを記録します。todo の解決を通じて、記録する価値のあるパターンやアーキテクチャ上の知見が見つかることがよくあります。
ゲート:停止します。docs/solutions/ に解決策ドキュメントが作成されたことを確認します。作成されていない場合(ユーザーが辞退した、または新たな学びがなかった場合)は続行します。
6. 後片付けする
両方のパスから、完了済み/解決済みの todo ファイルを削除します。一時ディレクトリ .context/compound-engineering/todo-resolve/<run-id>/ を作成した場合は、それも削除します(ユーザーが確認を求めている場合を除く)。
Todos resolved: [count]
Pending (skipped): [count, or "none"]
Lessons documented: [path to solution doc, or "skipped"]
Todos cleaned up: [count deleted]
スキップした pending の todo がある場合は、一覧表示します。
Skipped pending todos (run /todo-triage to approve):
- 003-pending-p2-missing-index.md
- 005-pending-p3-rename-variable.md