AgwaB/pi-workflow

何を解決するか

pi-workflow は、繰り返し可能で構造化された複雑なマルチステップAIエージェントワークフローを実行する方法を提供します。単一のプロンプトに頼るのではなく、深層リサーチやコードレビューなどの決定論的なプロセスを定義でき、複数のサブエージェントが並列または順次に作業して高品質な結果を達成できます。

動作方法

システムは「ステージグラフ」として作業を整理し、自然言語で記述されたタスクを定義されたステップの連鎖で処理します。@agwab/pi-subagent を使ってワーカーを調整し、以下の実行パターンをサポートしています：

• Single: 1つのサブエージェントに向けた集中型プロンプト。
• Foreach: ダイナミックなファンアウト。1つのエージェントがアイテムのリストを作成し、別々のエージェントが各アイテムを処理します。
• Reduce: ファンインの合成。複数の上流ステップからの結果を統合して最終レポートを作成します。
• Loop: 終了条件が満たされるまで制限付きの繰り返し。
• DAG: 複雑な組織構造をサポートするネストされたグラフ。
• Dynamic: コントローラコードを使ってタスクを動的に作成する、適応型のオーケストレーション。

対象ユーザー

Piエコシステムを活用し、アーキテクチャレビュー、仕様準拠チェック、プロジェクト固有のチームルーチンなど、繰り返し発生する高リスクタスクを自動化したい開発者やチーム。

特徴

• バンドル済みワークフロー: deep-research、deep-review、spec-review、impact-review のための事前定義されたテンプレートを含む。
• 視覚的モニタリング: 実行進捗の確認、ステージの詳細調査、タスクアーティファクトの表示が可能な組み込みTUIワークフローボード（/workflow）。
• カスタマイズ可能: workflow-guide スキルを使ってワークフローをカスタムまたはカスタマイズ可能。
• 実行プロファイル: low、medium、high などのカスタム名のプロファイルをサポートし、ワークフローの実行方法を制御。
• 適応型ルーティング: execution-router スキルにより、タスクが単一エージェント、特定のワークフロー、またはターゲット検証者を必要とするかを判断する。