jevlaya
日本語
ドキュメント

エージェントスキル

エージェントスキル

Claude Code、Codex、その他のエージェント環境向けのドロップインスキル。

TypeSafe のエージェントスキルは、AI コーディングエージェントに TypeSafe API の完全なコンテキストを与えます。3 つの質問型、アーキテクチャのパターン、評価を構造化するためのベストプラクティスです。

インストール

ターミナルで次の 2 つのコマンドを実行します：

claude plugin marketplace add typesafe-ai/skills
claude plugin install typesafe@typesafe-ai
npx skills add typesafe-ai/skills --skill typesafe-ai

プロンプトが出たら使うエージェントを選びます。インストールは既定でプロジェクトローカルです。グローバルに入れるには -g を付けます。

次のプロンプトをコーディングエージェントに貼り付けます：

Install the TypeSafe skill. If you're in Claude Code, run `claude plugin marketplace add typesafe-ai/skills`, then `claude plugin install typesafe@typesafe-ai`. If you're in another agent, run `npx skills add typesafe-ai/skills --skill typesafe-ai` and select your agent. Use one installation method. You can read the skill directly at https://github.com/typesafe-ai/skills/blob/main/skills/typesafe-ai/SKILL.md (raw: https://raw.githubusercontent.com/typesafe-ai/skills/main/skills/typesafe-ai/SKILL.md). Then use the TypeSafe skill when working on this project.

GitHub の SKILL.md を読むか、生の Markdown を直接取得してください。手動でインストールする場合は、skills/typesafe-ai ディレクトリ を参照ファイルごとエージェントの skills ディレクトリにコピーしてください。

重複したコピーを避けるため、インストール方法は 1 つだけ選んでください。

更新

Claude Code プラグインの場合は次を実行します：

claude plugin marketplace update typesafe-ai
claude plugin update typesafe@typesafe-ai

更新を読み込むには Claude Code を再起動するか /reload-plugins を実行します。自動更新を有効にするには /plugin を開き、Marketplaces → typesafe-ai → Enable auto-update を選びます。

skills.sh 経由のインストールでは npx skills update を実行します。手動コピーの場合は、skill ディレクトリ全体を GitHub の最新版に置き換えます。

プロンプト例

プロンプトでスキル名を挙げる——「use the TypeSafe skill」——のはどのエージェントでも機能するので、以下のプロンプトはどれもそうしています。Claude Code プラグインでは /typesafe:typesafe-ai を直接呼び出すこともできます。

  • 最初に試すのに良いのは、プロジェクトのどこで TypeSafe を最も活かせるかを見つけるためのブレインストーミングのプロンプトです。

    Using the TypeSafe skill, explore the project and find opportunities for using
intelligent judgement to stand in for complex parsing or other fragile code.

  • API key を作成し、安価なテストクエリを実行して TypeSafe の最適な使い方をエージェントに探させることもできます。

    Using the TypeSafe skill, run some experiments using the TypeSafe API key that I've
exported to `TYPESAFE_API_KEY`. Propose changes based on the most promising results.

  • 自分のコードベースの問題を解決する特定の cookbook をエージェントに指すか、cookbook 一覧を指して、プロジェクト内のパターンに似たものがあるか尋ねます。

    Using the TypeSafe skill, analyze my code and see if there are any applicable
cookbooks (https://console.typesafe.ai/docs/cookbooks) that show how I could
refactor my code to be less fragile or complex.

良い vibe coding の原則

  1. 上のプロンプト例を出発点に、エージェントと話し合います。
  2. 実装する前に計画を見直し、筋が通っているか確認します。
  3. 定数（質問としきい値）は 1 か所にまとめ、見直しやすくします。エージェントは質問を書くのが得意ではないので、一緒に編集するつもりでいてください。
  4. 主張をうのみにせず、エージェントに前提を検証するよう促します。

よくある問題

エージェントがスキルを使ってくれない

Claude Code プラグインでは /typesafe:typesafe-ai を呼び出します。他のエージェントでは「use the TypeSafe skill」と頼みます。それでも読み込まれない場合は、インストーラーが使っているエージェントを対象にしたか確認し、エージェントを再起動してください。

ルーティングが期待どおりに動かない

質問としきい値を確認してください。しきい値が高すぎる（偽陰性を招く）か、低すぎる（偽陽性を招く）可能性があります。質問をより具体的にする調整も必要かもしれません。

どこでも信頼度のしきい値を使っている

最も良い選択肢を選ぶことだけが目的なら、信頼度のしきい値を設定するのではなく、最も信頼度の高い選択肢を選べばよいだけです。特定の統計アルゴリズムを想定しているなら、信頼度ではなく確率分布を使うべきでしょう。

TypeSafe のコードを見直しにくい

人が見直すべき最重要点は、質問と、TypeSafe のコードで使うしきい値の定数です。これらは 1 つのコードファイルに定義し、あまり探し回らずに見つけられるようにしてください。

エージェントがリクエストやレスポンスのフィールドをでっち上げる

古いスキルが原因かもしれません。上のインストール方法で更新して再試行してください。