スキルの発見

何をすべきか

このスキルがトリガーされたら、以下の3つのステップを完了するだけです。

1. ユーザーの質問からタスクの目標、タスクの制約を抽出し、キーワードを整理します。
2. scripts/discover.py スクリプトを呼び出し、SkillRadar サービスに条件に合致するスキルを問い合わせます。
3. 返された候補結果に基づいて、関連情報をユーザーに表示し、権限に基づいてスキルを自動インストールするか、不確実な場合やリスクが高い場合はユーザーにインストールを確認します。

入力

タスク目標（必須）

• タスク目標は、スキルに達成してほしいアクションまたはタスクです。タスクの目標を明確に表現することで、SkillRadar があなたの要求を理解しやすくなります。
• 例：ファイルの結合、データの抽出、レポートの生成、画像の処理、アカウントの作成など。

タスク制約（オプション）

• 制約は、タスク目標に対する制限条件です。タスク実行時に許容される条件の範囲を決定します。
• 例：
  • タスクはローカルで実行する必要がある（ネットワーク接続禁止）
  • 特定の形式の出力（CSV、JSONなど）を生成する必要がある
  • データ処理中に特定の権限またはツールサポートが必要

キーワード（オプション）

• ユーザーの要求から3〜10個のキーワードを抽出するだけで十分です。
• キーワードはカンマ区切りで、簡潔で直感的にしてください。
• キーワードは以下をカバーすることをお勧めします。
  • タスクオブジェクト/分野（例：pdf、excel、health、calendar、法律、科研）
  • 主要なアクション（例：extract、summarize、merge、audit、deploy）
  • 主要な形式/ツール（例：markdown、csv、sql、api）

候補数（オプション）

• 返される候補結果の数を表します。
• ユーザーが指定しない場合、デフォルトで5件が使用されます。

スクリプトの実行方法

このスキルは、付属のスクリプトを介してクエリを実行する必要があります。

• スクリプトパス：scripts/discover.py（この SKILL.md があるディレクトリからの相対パス）
• 実行時の作業ディレクトリ：このスキルがあるディレクトリ（つまり、この SKILL.md を含むディレクトリ）に切り替えてからスクリプトを実行する必要があります。
• 呼び出し方法の例：

# まずこのスキルディレクトリに cd し、次にスクリプトを実行します
cd <このスキルがあるディレクトリ> && python scripts/discover.py --task_goal "複数のファイルを結合する" --task_constraints "PDFをサポートする必要がある、バッチ処理をサポートする必要がある" --keywords "pdf, merge, batch" --max_results 5

出力

サーバーから返される候補スキルリストには、以下のフィールドが含まれます。

• candidates：候補スキルリスト（推奨順に並べられ、最初の項目が最も推奨されます）
  • skillradar_id：UUIDv4（各候補スキルを一意に識別します）
  • name：スキル名
  • description：そのスキルの機能を一文で説明します
  • score：一致スコア（0-1、高いほど一致度が高い）
  • match_reasons：一致理由リスト（例："意図一致: 0.85"、"キーワードヒット: 概要, 要約"）
  • install_url：スキルのインストールアドレス（この URL に直接アクセスするとスキルファイルを取得できます）
• note：補足説明（情報不足/不確実性/リスクポイントのヒントに使用されます）

出力 JSON の例：

{
  "candidates": [
    {
      "skillradar_id": "52a78db1-00b0-4163-9154-c8236bd0df37",
      "name": "extract-action-items",
      "description": "会議の議事録やチャット履歴から、ToDo項目、担当者、期限を抽出します。",
      "score": 0.87,
      "match_reasons": ["意図一致: 0.92", "キーワードヒット: 会議, ToDo"],
      "install_url": "https://cdn.skillradar.quest/skills/extract-action-items/skill.zip?v=1738300000"
    }
  ],
  "note": ""
}

スキルのインストール方法

install_url は、スキルの ZIP 圧縮ファイルの場所を指します（例：https://cdn.skillradar.quest/skills/xxx/skill.zip?v=1738300000）。

URL 内の ?v= パラメータについて：これは CDN キャッシュを回避するためのタイムスタンプであり、最新バージョンをダウンロードできるようにします。このパラメータは削除せずに保持してください。

インストール手順：

1. ユーザーに、プロジェクトレベルのディレクトリ（現在の作業ディレクトリ内、例：./xxx/skills/）にインストールするか、グローバルディレクトリ（ユーザーのホームディレクトリ内、例：~/xxx/skills/）にインストールするかを尋ねます。
2. あなた自身のツールタイプに応じて、正しいインストールパスを選択します。
   • Claude Code：プロジェクトレベル .claude/skills/、グローバル ~/.claude/skills/
   • OpenCode：プロジェクトレベル .opencode/skills/、グローバル ~/.config/opencode/skills/
   • Codex CLI：プロジェクトレベル .codex/skills/、グローバル ~/.codex/skills/
   • Gemini CLI：プロジェクトレベル .gemini/skills/、グローバル ~/.gemini/skills/
3. install_url が指す skill.zip ファイルをダウンロードします（?v= パラメータを含む完全な URL を保持します）。
4. ZIP ファイルを対応するディレクトリに解凍します（ZIP の第一層はスキル名ディレクトリです）。
5. ZIP 圧縮ファイルを削除します。
6. ファイル構造が正しいことを確認します（SKILL.md が含まれている必要があります）。

ZIP 内部構造の例：

skill.zip
└── extract-action-items/
    ├── SKILL.md
    ├── scripts/
    │   └── ...
    └── references/
        └── ...

結果の判断

ベクトル検索は常に結果を返しますが、返されたスキルが必ずしもユーザーの要求に本当に適しているとは限りません。あなたは以下のことを行う必要があります。

1. 各候補スキルの name と description を読み、それが本当にユーザーの問題を解決できるかどうかを判断します。
2. すべての候補スキルがユーザーの要求と無関係である場合、「適切なスキルが見つかりませんでした」と正直にユーザーに伝え、無関係なものを無理に勧めないでください。
3. あるスキルが適切かどうか不明な場合は、ユーザーに状況を説明し、ユーザー自身に決定させることができます。

エラーと例外処理

一致する候補スキルが見つからない場合

クエリが一致する項目を返さなかった場合、空の結果が返されます。

{
  "candidates": [],
  "note": "一致するスキルが見つかりませんでした。より具体的なタスク目標またはキーワードを追加してみてください。"
}

サービスが利用できない場合

SkillRadar サービスに接続できない場合、エラーメッセージが返されます。

{
  "candidates": [],
  "note": "SkillRadar サービスに接続できません: <エラー原因>"
}

タスク目標が不明確な場合

タスク目標または制約が不明確な場合は、ユーザーにさらに確認または情報追加を促すことができます。