Pi の拡張機能「pi-dynamic-workflows」：Claude-Code スタイルの動的ワークフローを実現

Claude-Code スタイルの動的ワークフローを Pi 向けに実装したものです。

この Pi 拡張機能は、ワークフローツールを追加します。1 つのアシスタントが順次すべての作業を行うのではなく、モデルが小さな JavaScript スクリプトを作成して作業を多数の孤立したサブエージェントに分散し、その後結果を統合します。

コードベースの監査、多角的なレビュー、大規模なリファクタリング、およびファンアウト型（並列展開）のリサーチに最適です。

Anthropic の Claude Code における動的ワークフロー にインスパイアされています。

インストール

pi install npm:pi-dynamic-workflows

またはローカルチェックアウトから

pi install /path/to/pi-dynamic-workflows

その後、Pi 内で以下を実行してください：

/reload

これで完了です。拡張機能はワークフローツールを登録し、セッション開始時に自動的に有効化されます。

使用方法

平文で Pi にワークフローの実行を依頼するだけです：

このリポジトリを検査して主要なモジュールを要約するワークフローを実行してください。

モデルがワークフロースクリプトを作成し、ワークフローツールを呼び出します。進行状況はインラインでリアルタイムに表示されます：

◆ Workflow: inspect_project (3/3 done)

✓ Scan 1/1

#1 ✓ repo inventory

✓ Analyze 2/2

#2 ✓ source modules

#3 ✓ final summary

実行中のワークフローをキャンセルするには Esc キーを押してください。アクティブなサブエージェントは中止され、スキップされたものとして表示されます。

ワークフロースクリプトの構造

ワークフローは通常の JavaScript です。最初の文ではリテラルメタデータをエクスポートする必要があります。name と description は必須であり、phases は期待されるアウトラインのためのオプションのドキュメントです。ライブ進行状況ビューは、実行時に phase(...) 呼び出しによって駆動されます：

export const meta = {

name: 'inspect_project',

description: 'リポジトリを検索し、主要なモジュールを要約する',

phases: [

{ title: 'スキャン' },

{ title: '分析' },

],

}

phase('Scan')

const inventory = await agent('リポジトリの構造を検索してください。', {

label: 'リポジトリ目録',

})

phase('Analyze')

const summary = await agent(

'この目録から主要なモジュールを要約してください:\n' + inventory,

{ label: 'モジュール要約' },

)

return { inventory, summary }

フェーズはスクリプト実行中に発見されるため、条件分岐やループで生成されたフェーズも自然に動作します。ブランチがスキップされた場合、そのフェーズは空の進行状況行として表示されません。

エディタインテリセンス

再利用可能なワークフローファイルでは、ワークフローグローバル変数に対するエディタのヒントを有効化できます:

/// <reference types="pi-dynamic-workflows/workflow" />

これにより、TypeScript 対応のエディタに対して agent、parallel、pipeline、phase、log、args、cwd、budget が宣言されます。

利用可能なグローバル変数

グローバル変数 | 説明

---|---

agent(prompt, opts) | 孤立したサブエージェントを起動します。最終的なテキストを返すか、opts.schema を指定された場合は検証済みのオブジェクトを返します。

parallel(thunks) | () => agent(...) の形式の関数配列を並行して実行します。結果は入力順に返されます。

pipeline(items, ...stages) | 各アイテムを逐次的なステージを通じて処理します。アイテムは分岐しながら進みます。各ステージには (prev, original, index) が渡されます。

phase(title) | 現在のフェーズを示します。ライブの進行状況ビューでのグループ化に使用されます。

log(message) | ワークフローレベルのログ行を追加します。

args

ツールの args パラメータを介して渡されるオプションの JSON 値。

cwd, process.cwd()

サブエージェントの現在の作業ディレクトリ。

budget

{ total, spent(), remaining() } トークン予算トラッカー。

決定性ルール

ワークフロースクリプトは Node の vm サンドボックス内で評価されます。以下の機能は意図的に利用できません：

• Date.now(), new Date()

• Math.random()

• require, import, fs, network APIs（ネットワーク API）

• メタ内のスプレッド、計算されたキー、テンプレート補間、関数呼び出し

これにより、メタが解析可能に保たれ、実行結果が再現可能となり、攻撃対象領域を最小限に抑えます。

構造化されたサブエージェント出力

opts.schema を介して JSON スキーマを渡すと、サブエージェントは検証済みのオブジェクトを返します：

const finding = await agent('Find security-sensitive files.', {

label: 'security scan',

schema: {

type: 'object',

properties: {

paths: { type: 'array', items: { type: 'string' } },

reason: { type: 'string' },

},

required: ['paths', 'reason'],

},

})

内部では、これは terminate: true を持つ Pi の structured_output ツールであり、サブエージェントはその呼び出しで終了し、追加のアシスタントターンは発生しません。

仕組み

ユーザープロンプト

→ Pi モデルがワークフロースクリプトを記述

→ ワークフローツールがスクリプトを解析し、vm サンドボックス内で実行

→ スクリプトが agent(), parallel(), pipeline() を呼び出し

→ 各 agent() がメモリ内の Pi サブエージェントセッションを起動

→ スナップショットがコンパクトな進捗としてストリームバックされる

→ 最終的な構造化結果が親アシスタントに返される

サブエージェントは、標準的なコーディングツールを備えた新規のメモリ内 Pi セッションで実行されるため、通常の Pi のターンと同様にファイルの読み込み、シェルコマンドの実行、構造化出力の呼び出しが可能となります。

ライブラリモジュール

File

Purpose

src/workflow.ts

AST 検証済みパーサーおよびサンドボックス化されたワークフローランタイム。

src/workflow-tool.ts

Pi ワークフローツール、プロンプトガイドライン、レンダリング、中止処理。

src/agent.ts

WorkflowAgent（メモリ内 Pi サブエージェントランナー）。

src/structured-output.ts

TypeBox/JSON Schema に基づく構造化出力をバックエンドとする終了用構造化出力ツール。

src/display.ts

ワークフロースナップショットおよびコンパクトテキストレンダラー。

extensions/workflow.ts

Pi 拡張のエントリーポイント。

開発環境構築

npm install

npm test # biome チェック + tsc + ユニットテスト

npm run dev

パーサーのユニットテストは tests/workflow-parser.test.ts にあり、承認されるスクリプト形状と拒絶されるスクリプト形状の両方を網羅しています。

現状

これはプロトタイプです。コアとなるワークフロープリミティブ（スクリプト、サブエージェント、並列/パイプライン、フェーズ、中止、構造化出力）を実装していますが、永続化された実行や再開可能な実行、および /workflows マネージャーの実装はまだ行われていません。

ライセンス

MIT