---
name: cluster-creator-kit-script
description: >
  Cluster Script API（CCK Script）の型定義から、メソッド・引数・戻り値・型・シグネチャを検索して提示する。
  「ItemHandle/PlayerHandle/ClusterScript等のメソッド」「〜のAPI」「〜のシグネチャ」
  「〜の引数や戻り値の型」など、Script APIの仕様・定義そのものを問うリクエストで使用。
  Scriptを使った実装方法・サンプルコード・チュートリアル（「Scriptで〜する方法」）や、
  操作手順・設定方法など、APIの型・シグネチャを伴わない解説は対象外（Cluster Creators Guide側）。
  Bashでindex.d.tsを検索し、JSDocコメント付きで提示する。
---

# Cluster Script API Search

Cluster Script APIの型定義ファイル（index.d.ts）からAPI情報を検索するスキル。

## 利用可能なスクリプト

スクリプトのパスは `${SKILL_DIR}/scripts/` 配下にある。

### search.py - API検索
```bash
python3 ${SKILL_DIR}/scripts/search.py "キーワード" [--output-dir DIR]
```
キーワードでAPI定義を検索し、マッチしたエントリ（JSDocコメント + シグネチャ）をテキスト形式で出力する。
最大30件まで。`<output-dir>/cluster-script-index.d.ts` を参照し、未ダウンロードの場合は自動でダウンロードする。

### download.py - 型定義ファイルの更新
```bash
python3 ${SKILL_DIR}/scripts/download.py [--output-dir DIR]
```
最新のindex.d.tsをダウンロードして `<output-dir>/cluster-script-index.d.ts` に保存する。型定義を最新に更新したい場合に手動実行する。

### 保存先について

- search.py / download.py とも保存先は共通で、`--output-dir` が無ければ `$PWD` 直下の `cluster-script-index.d.ts`
- ユーザーの一時ファイル配置方針があれば、それに従って `--output-dir` を明示的に指定すること（例: `--output-dir tmp`）

## ワークフロー

1. ユーザーの質問からキーワードを抽出（日英両方、2〜3パターン）
2. `search.py` で各パターンを検索
3. 結果からJSDocとシグネチャを整理して提示

## キーワード最適化ルール

1. **メソッド名を直接検索**: setPosition, getRotation, send 等
2. **日本語でも検索**: 「位置」「回転」「移動」等（JSDocが日本語のため有効）
3. **interface/classで絞り込み**: ItemHandle, PlayerHandle, ClusterScript, Vector3 等のコンテキスト名も検索対象
4. **関連用語で横断検索**: 「アニメーション」「衝突」「マテリアル」等

## スコープ

このスキルは Cluster Creator Kit Script の**API仕様（型定義）の参照専用**。
「〜メソッドの引数」「〜の型」「〜のAPI仕様」といったリファレンス用途に使う。
操作手順や解説（「〜のやり方」「〜を設定する方法」）は対象外で、Cluster Creators Guide (creator.cluster.mu) を参照すること。