mcpField
P
pipeline-router

pipeline-router

github.com/willoscarエージェントワークフロー51749 回インストール3 週間前に更新
リポジトリ

pipeline-router について

pipeline-routerは、目標成果物に応じてワークフローを選び、その選択を記録するエージェントスキルです。目標と証拠要件に基づくPipelineの選定と初期チェックポイントの準備に使います。

主な機能

  1. 01目標に基づくPipelineの選定
  2. 02PIPELINE.lock.mdへのルート記録
  3. 03初期C0チェックポイントの作成
  4. 04必要に応じた検索クエリの用意
  5. 05Workspaceのルート状態の確認

活用シーン

  1. 01目標から新しいWorkspaceを開始
  2. 02証拠要件に応じたPipelineの選定
  3. 03Pipeline実行用のC0を準備

インストール

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

$npx skills add https://github.com/willoscar/research-units-pipeline-skills --skill pipeline-router

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

同梱ファイルassets/pipeline-selection-form.mdscripts/run.py

詳細

パイプラインルーター

ルーティングとは確定です。目的の成果物とエビデンスの手法に基づいてワークフローを1つ選択し、その選択を記録して、次の人間による判断を提示します。

入力

  • GOAL.md。ワークスペースが新規の場合は、現在のユーザーリクエスト。
  • PIPELINE.lock.md、UNITS.csv、STATUS.md、DECISIONS.md（存在する場合）。
  • 選択時の docs/PIPELINE_TAXONOMY.md と候補パイプラインのフロントマター。

出力

  • 新たに確定した目標に対する PIPELINE.lock.md。
  • DECISIONS.md 内の初期 C0 チェックポイントブロック。
  • 選択された検索ワークフローが C0 から始まる場合の queries.md。
  • STATUS.md 内で同期された現在のパイプライン／チェックポイントの投影。

手順

1. 要求された成果物を確定する

目標を読み、以下を特定します。

  • 読者に提示する成果物。
  • 必要とされるエビデンスの手法。
  • 要求された形式または納品プロファイル。
  • ワークフローの選択に実質的な影響を与える判断。

ルーティングの判別に必要な情報が不足している場合は、必要最小限の質問をまとめて DECISIONS.md に記載し、その判断の時点で停止します。

完了基準：ワークフローの選択に影響し得るすべての事実が判明しているか、DECISIONS.md で明示的に範囲が限定されていること。

2. ワークフローを1つ選択する

docs/PIPELINE_TAXONOMY.md を読み込んでから、候補となるパイプラインの契約だけを確認します。キーワードの一致だけでなく、対象の成果物とエビデンスの手法に基づいて選択します。納品プロファイルとコースレポートのユースケースは、既存のワークフローファミリー内のオーバーレイとして扱います。

完了基準：実行可能なパイプラインがちょうど1つ選択され、その対象成果物が目標と一致していること。

3. 確定内容を反映する

PIPELINE.lock.md に以下を記述します。

pipeline: <pipeline path>
units_template: <template path from Pipeline front matter>
locked_at: <YYYY-MM-DD>

ワークスペースが新規の場合は、そのテンプレートから UNITS.csv を初期化します。有効な既存ロックは保持します。ルートの変更は、明示的なオペレーターの判断と、それに続く再初期化または移行を必要とし、暗黙の書き換えは行いません。

完了基準：ロック、ユニットのテンプレート、ワークスペースの投影が、同じパイプラインを参照していること。

4. C0 チェックポイントを提示する

DECISIONS.md に C0 のキックオフブロックと承認チェックボックスを反映します。検索が選択されたワークフローに含まれる場合は、目標をもとに queries.md を初期化します。以降のチェックポイントでは checkpoint-brief を使用します。C0 の後も保存済みユニットが pipeline-router を呼び出している過去のワークスペースは、非推奨の警告とともに checkpoint-brief に引き継ぎます。ルーターがそれらを承認することはありません。

選択後に、決定論的なヘルパーを使用できます。

uv run python .codex/skills/pipeline-router/scripts/run.py \
  --workspace workspaces/<name> \
  --checkpoint C0

完了基準：DECISIONS.md に C0 チェックポイントと、明確な承認または回答のための入力欄が1つ含まれていること。検索ワークフローでは、C0 のクエリーシードが空でないこと。

5. ルートを検証する

ロックされたパイプラインが存在すること、そのユニットテンプレートが存在すること、アクティブなチェックポイントが STATUS.md と DECISIONS.md の両方に記録されていることを確認します。

完了基準：パイプラインランナーが、追加のルーティング推論を行わずにワークスペースのファイルから処理を続行できること。

コンテキストの参照先

  • ワークフローの選択時または意図的な変更時に限り、docs/PIPELINE_TAXONOMY.md を読みます。
  • 選択後は、ロックされた pipelines/*.pipeline.md が実行契約となり、分類体系は以降のコンテキストから除外されます。
  • ルーティングに必要な情報が不足し、人間による回答が必要な場合に限り、assets/pipeline-selection-form.md を使用します。
  • C0 の反映に関するデバッグが必要な場合は、--help を付けてヘルパーを実行します。ヘルパーは初期ルートの投影を記録しますが、ルートは選択しません。

コメント

Markdown 対応