エージェントによるプランニング（planning-with-agents）

AI/ML
エージェントによるプランニング（planning-with-agents）

エージェントによるプランニング（planning-with-agents）

Claude Codeスキル「planning-with-files」を拡張するプロジェクトで、複雑なタスクを自動で分解し、専門化されたサブエージェントを並列実行、依存関係を明示的に管理して協調的に問題を解決します。プロトタイプ版（v1.0.0）としてコアアルゴリズムを検証済みで、119件のテストが100%通過していることから基本設計と実装品質が高く、Pythonで実装された軽量なオーケストレーションスキルです。並列処理や依存解決が必要なユースケースでの実験や拡張に向いています。

https://github.com/caiqing/planning-with-agents

概要

planning-with-agentsは、Claude Code用のスキルとして設計されたプロトタイプで、既存の「planning-with-files」を基盤に、タスクの自動分解（タスクデコンポジション）、並列サブエージェントの起動、そしてタスク間の依存関係管理を行うことで、単一エージェントでは対応が難しい複雑な問題を解決するための協調フレームワークを提供します。コアアルゴリズムは検証済み（バージョン1.0.0）で、119件のテストを100%通過している点が信頼性の証です。Pythonで実装され、並列化と依存解決に重点を置いた設計になっています。

GitHub

リポジトリの統計情報

  • スター数: 12
  • フォーク数: 1
  • ウォッチャー数: 12
  • コミット数: 2
  • ファイル数: 4
  • メインの言語: Python

主な特徴

  • タスクの自動分解（複雑タスクを複数のサブタスクに分割）
  • サブエージェントの並列実行と結果の集約
  • タスク依存関係の明示的管理と同期
  • Claude Codeスキルとしての統合（既存の planning-with-files を拡張）

技術的なポイント

planning-with-agentsの技術的核は「タスク分解」「並列オーケストレーション」「依存解決」の3点に集約されます。まず入力タスクを解析して、実行可能なサブタスクへとデコンポジションを行い、それぞれに専用のサブエージェントを割り当てます。サブエージェントは独立して並列実行され、各サブタスクの成果物を生成します。並列実行により時間効率を高めつつ、タスク間で必要なデータや成果物の依存関係は明示的なグラフ（あるいはテーブル）で管理され、依存先が完了した段階で次段階の実行がトリガーされます。失敗や遅延が発生した場合の再試行やフォールトハンドリング、部分的な再計画といった回復メカニズムも設計に含めることで実用性を高めます。実装はPythonベースで、Claude Code環境とのシームレスな連携を念頭に置き、既存のplanning-with-filesのインターフェースを拡張する形を取っています。プロトタイプながら119件のテストで100%通過という点は、アルゴリズムロジックと主要な動作フローが確立されていることを示しており、ユースケースに応じたカスタマイズやスケーリングを行いやすい構成になっています。将来的にはサブエージェント間の負荷分散、プラグイン可能なエージェントプロファイル、より洗練された依存解決アルゴリズム（優先順位付けやコスト最適化）などの拡張が考えられます。

プロジェクトの構成

主要なファイルとディレクトリ：

  • .gitignore: file
  • LICENSE: file
  • README.md: file
  • planning-with-agents: dir

READMEの一部抜粋：

Planning with Agents

Multi-Agent Collaborative Planning for Complex Tasks

A Claude Code skill that extends planning-with-files with intelligent task decomposition, parallel sub-agent execution, and comprehensive dependency management. When tasks are too complex for a single agent or would benefit from parallelization, this skill orchestrates multiple specialized agents working collaboratively.

📌 当前状态

版本: 1.0.0 (原型验证版) 状态: ✅ 核心算法已验证，性能优秀 测试覆盖: 119 个测试用例，100% 通过率

まとめ

プロトタイプとして堅牢な基盤を持つ、マルチエージェント協調プランニングの実験用リポジトリ。

リポジトリ情報：

  • 名前: planning-with-agents
  • 説明: A Claude Code skill that extends planning-with-files with intelligent task decomposition, parallel sub-agent execution, and comprehensive dependency management. When tasks are too complex for a single agent or would benefit from parallelization, this skill orchestrates multiple specialized agents working collaboratively.
  • スター数: 12
  • 言語: Python
  • URL: https://github.com/caiqing/planning-with-agents
  • オーナー: caiqing
  • アバター: https://avatars.githubusercontent.com/u/2242128?v=4