mcpField
P
prefactor-skill-selector

prefactor-skill-selector

github.com/prefactordevエージェントワークフロー343 回インストール2 日前に更新
リポジトリ

prefactor-skill-selector について

Prefactor のタスクに適したスキルを選ぶルーティングスキルです。エージェントのセットアップ、計測、アダプター作成、コンプライアンス情報、トレース要約、実行分析を案内し、計測の標準手順も示します。

主な機能

  1. 01依頼内容に応じたPrefactorスキルの選択
  2. 02CLIセットアップと認証情報の案内
  3. 03SDKとアダプターによる計測の案内
  4. 04Providerパッケージ作成の手順
  5. 05コンプライアンス情報とテンプレートの振り分け
  6. 06エージェント実行分析への案内

活用シーン

  1. 01既存エージェントの計測に使うスキルの選択
  2. 02Prefactorのリソースと認証情報の設定
  3. 03spanへのコンプライアンス情報の追加
  4. 04想定外のエージェント実行の調査

インストール

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

$npx skills add https://github.com/prefactordev/typescript-sdk --skill prefactor-skill-selector

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

詳細

Prefactor スキルセレクター

Prefactor スキルを選択するためのルーターとして、このファイルを使用してください。

利用可能なスキル

  • skills/bootstrap-existing-agent-with-prefactor-cli/SKILL.md：prefactor setup ／ prefactor setup --create を使って Prefactor の認証情報をプロビジョニングし、環境変数の値を書き込み、パッケージを選択します。
  • skills/instrument-existing-agent-with-prefactor-sdk/SKILL.md：既存のエージェントに Prefactor SDK で計装を追加し、コーディングツールから実行、LLM／ツールのスパン、トークン使用量、失敗を確認できるようにします。
  • skills/create-provider-package-with-core/SKILL.md：コアを優先する境界とトレーシングの規約に沿って、@prefactor/core を基盤とする薄いアダプターとして新しいプロバイダーパッケージを作成します。
  • skills/report-agent-risk-data/SKILL.md：エージェントの計装後に、コンプライアンス追跡とデータガバナンスのため、スパン型に data_risk フィールドを設定します。
  • skills/write-span-summary-templates/SKILL.md：スパンのトレースを Prefactor UI で読みやすい1行の要約として表示するため、スパン型のスキーマに Liquid 表示テンプレートを記述します。
  • skills/inspect-agent-run-with-prefactor-cli/SKILL.md：CLI のスパンデータから Prefactor エージェントの実行を根本原因分析します。エージェント自身のコードベースで実行してください（ユーザーがインスタンス ID と症状を指定します）。

選択ルール

  • CLI で Prefactor のリソースまたは認証情報をプロビジョニングする依頼の場合は、最初に skills/bootstrap-existing-agent-with-prefactor-cli/SKILL.md を読み込んでください。
  • ビジネスロジックを書き換えずに既存のエージェントへテレメトリを追加する依頼の場合は、skills/instrument-existing-agent-with-prefactor-sdk/SKILL.md を読み込んでください。
  • @prefactor/core を使ってカスタムプロバイダーアダプターを作成する依頼の場合は、skills/create-provider-package-with-core/SKILL.md を読み込んでください。
  • スパン型にリスクまたはコンプライアンスのメタデータを追加する依頼の場合は、skills/report-agent-risk-data/SKILL.md を読み込んでください。
  • スパンの要約テンプレート、表示テンプレート、スキーマ上の Liquid テンプレート、または Prefactor UI でスパンを読みやすくする依頼の場合は、skills/write-span-summary-templates/SKILL.md を読み込んでください。
  • 不適切、予想外、高コスト、不完全、または低評価のエージェント実行の根本原因分析を依頼された場合は、skills/inspect-agent-run-with-prefactor-cli/SKILL.md を読み込んでください。

デフォルトのワークフロー

既存のエージェントに計装を追加する場合は、次の順序をデフォルトとしてください。

  1. ユーザーが prefactor login を実行済みであることを確認します。
  2. skills/bootstrap-existing-agent-with-prefactor-cli/SKILL.md を実行します（prefactor setup または prefactor setup --create --name ... --description ...）。
  3. プロジェクトを調べ、対応する Prefactor アダプター（@prefactor/langchain、@prefactor/ai、@prefactor/openclaw、@prefactor/claude）をインストールします。
  4. アダプタースタイルの計装では、init、withSpan、shutdown のインポート元を同じアダプターパッケージに統一します（または、core の withSpan を使う場合はトレーサーを明示的に渡します）。
  5. 対応するアダプターパッケージがない場合は、skills/create-provider-package-with-core/SKILL.md を使用します。
  6. skills/instrument-existing-agent-with-prefactor-sdk/SKILL.md を使って、既存のエージェントに計装を追加します。
  7. 必要に応じて、skills/report-agent-risk-data/SKILL.md を使ってコンプライアンスのメタデータを設定します。
  8. 必要に応じて、skills/write-span-summary-templates/SKILL.md を使って読みやすいトレース要約を追加します。

コメント

Markdown 対応