mcpField
B
bootstrap-existing-agent-with-prefactor-cli

bootstrap-existing-agent-with-prefactor-cli

github.com/prefactordev開発337 回インストール1 日前に更新
リポジトリ

bootstrap-existing-agent-with-prefactor-cli について

コードへの計測追加に先立ち、既存または新規エージェントの Prefactor を準備する CLI スキルです。認証情報の設定、環境変数への反映、対応アダプターの選定を案内します。

主な機能

  1. 01setup によるエージェント認証情報の準備
  2. 02出力値の環境変数への割り当て
  3. 03プロバイダー用アダプターの選定
  4. 04設定とシークレットの扱いの確認

活用シーン

  1. 01既存エージェント向けの Prefactor 設定
  2. 02エージェント作成と実行時認証情報の準備
  3. 03計測追加の工程への設定引き継ぎ

インストール

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

$npx skills add https://github.com/prefactordev/typescript-sdk --skill bootstrap-existing-agent-with-prefactor-cli

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

詳細

Prefactor CLI でエージェントをブートストラップする

アプリケーションコードを変更する前に、CLI で Prefactor の認証情報をプロビジョニングします。

基本原則：先にプロビジョニングし、その後に計装します。

コーディングアシスタントでの使用方法

ユーザーから次のような依頼があった場合は、まずこのスキルを適用します。

  • 「このエージェント用に Prefactor をセットアップして」
  • 「Prefactor のエージェントを登録して、環境変数を取得して」
  • 「CLI を使って Prefactor をブートストラップして」
  • 「計装の前に ID と環境変数を準備して」

このスキルの完了後：

  1. プロバイダーがサポートされている場合は、skills/instrument-existing-agent-with-prefactor-sdk/SKILL.md に進みます。
  2. プロバイダーがサポートされていない場合は、skills/create-provider-package-with-core/SKILL.md に進みます。
  3. セットアップで設定した環境変数の値と、選択したパッケージを引き継ぎます。

前提条件

  • Prefactor CLI がインストールされています（prefactor が PATH にあるか、npx @prefactor/cli を使用できます）。
  • ユーザーは実際のターミナルで、すでに prefactor login を実行しています。
  • プロジェクトのルート（または環境変数の設定先となるディレクトリ）で作業しています。

prefactor login、prefactor profiles add を実行したり、API トークンを捏造したりしないでください。CLI にサインインしていないためにセットアップが失敗した場合は、そこで停止し、ユーザーに prefactor login の実行を依頼してください。

CLI のワークフロー

セットアップコマンドを 1 つ使用します。フィールドを確実に解析できるよう、--json を優先してください。

既存のエージェント：

prefactor setup <agent_id> --json

新しいエージェント：

prefactor setup --create --name "<short-agent-name>" --description "<short description>" --json

prefactor setup は必要に応じてデプロイメントを作成し、デプロイメントにスコープを限定したランタイムトークンを発行し、ping でそのトークンを検証して、次の項目を出力します。

  • api_url
  • api_token
  • agent_id
  • agent_identifier

Prefactor の設定では、セットアップの出力を唯一の信頼できる情報源として扱ってください。初回のブートストラップでは、アカウントの一覧表示、環境の作成、API トークンの手動作成、エージェントインスタンスの登録を行わないでください。

環境変数の値を書き込む

セットアップの値を、プロジェクトで既に使用している環境変数のパターン（他のシークレットと同じファイル形式、読み込み方法、命名規則）に追加します。複数のパターンがある場合は、API キーのパターンを優先してください。

JSON フィールドを次のように対応付けます。

PREFACTOR_API_URL=<api_url>
PREFACTOR_API_TOKEN=<api_token>
PREFACTOR_AGENT_ID=<agent_id>
PREFACTOR_AGENT_IDENTIFIER=<agent_identifier>

新しいシークレットの構成を作らないでください。prefactor.json はコミットしないでください（プロファイルのトークンが含まれている場合があります）。

パッケージの選択

プロジェクトを調べ、該当する Prefactor アダプターを選択します。

  • LangChain -> @prefactor/langchain
  • AI SDK -> @prefactor/ai
  • OpenClaw -> @prefactor/openclaw
  • Claude SDK -> @prefactor/claude
  • カスタム／サポート対象外のプロバイダー -> skills/create-provider-package-with-core/SKILL.md を使用します

プロジェクトで既に使用しているパッケージマネージャーを使って、選択したパッケージをインストールします。計装に引き継ぐ際は、同じアダプターパッケージからヘルパーをインポートしてください。

検証

  • セットアップが正常に終了しました。
  • 環境変数の値がセットアップの出力と一致しています。
  • パッケージの選択がプロバイダーまたはセットアップの推奨内容と一致しています。
  • prefactor.json はコミット対象にステージされていません。

よくある間違い

  • prefactor setup を実行する前にコードを計装する。
  • prefactor login を実行したり、セットアップ以外の方法でトークンを作成したりする。
  • セットアップの JSON を無視して、環境変数のキーやパッケージ名を捏造する。
  • 明示的なトレーサーを渡さずに、アダプターの init と @prefactor/core の withSpan／shutdown を混在させる。
  • prefactor.json をコミットする。

コメント

Markdown 対応