SKILL.md を追加して、コーディングエージェントがプロジェクトの想定どおりに Phaseo を呼び出すようにします。ベース URL、キーの変数、エンドポイント、承認済みモデル、ログ記録がそろいます。完成すると、公開されている Phaseo スキル、その上に重ねるプロジェクトスキル 1 つ、スキルが参照する共有クライアントモジュール 1 つがそろいます。
以下のスキルとモジュールは、モデル ID とプリセット名を自分のものに置き換えれば本番環境でそのまま使えます。
1
公開されている Phaseo スキルをインストールする
公開スキルは Gateway、SDK、プリセット、ルーティング、移行を扱います。
phaseo.app/docs からインストールします。--agent はチームが使うエージェントに変更します。自分の SKILL.md にはプロジェクト固有のルールだけを書いてください。2
SDK をインストールする
3
共有クライアントを 1 つ追加する
エージェントは、大きなラッパーよりも小さく分かりやすいヘルパーのほうを確実に再利用します。クライアントを 1 つのモジュールに置き、どこからでもそれをインポートします。テキスト生成、埋め込み、画像生成、非同期の動画など、使う機能ごとに呼び出し経路を 1 つにしてください。
src/lib/phaseo.ts
4
プロジェクトスキルを書く
リポジトリのルート、またはエージェントが読み込むスキルフォルダー(例:
.agents/skills/phaseo-project/SKILL.md)に SKILL.md を作成します。エージェントは frontmatter の name と description を読んで、いつスキルを読み込むかを判断します。SKILL.md
動作を確認する
「Phaseo でチケットを要約する」のような小さな Phaseo 機能の追加をエージェントに依頼します。変更がsrc/lib/phaseo.ts をインポートし、PHASEO_API_KEY を読み取り、承認済みのモデルまたはプリセットを使い、レスポンス ID をログに記録していれば成功です。そうでない場合は、スキルの description が依頼内容と一致していない可能性があります。チームが使うタスクの言葉を書き込んでください。
スキルに書く内容
エージェントが最も時間を費やす質問にだけ答え、それ以外は書きません。
Codex、Vercel AI SDK、サンプルでは、各ツールで同じ規約を使う方法を紹介しています。