unity-gamedev-skill-pack

Unity GameDev スキルパック

このスキルを使うと、外部の Unity スキルパックをレビュー済みの内部パッケージにできます。

このスキルを使う場面

• 調査中に外部の Unity スキルリポジトリを見つけた場合。
• 直接コピー＆ペーストするのではなく、ワークフローのアイデアを選択的に再利用したい場合。
• リスクに関する注記、出典、ロールバック手順を含む、PR 対応のインポートが必要な場合。

使用しない場面

• 具体的な Unity のランタイム／ビルドエラーを今すぐデバッグする必要がある場合。
• スキルのドキュメントを整理するのではなく、ゲームプレイのコードを直接書いている場合。

手順

ステップ 1：出典情報を記録する

具体的な出典 URL を少なくとも 1 つと、取得方法（indexed snippet または direct page retrieval）を記録します。

ステップ 2：再利用可能なパターンのみを抽出する

出典のパックから、移行可能なワークフロー単位（セットアップ確認、ガードレール、検証の順序）を残します。特定のツールに依存する不要な情報や、検証できない主張は除外します。

ステップ 3：安全性ゲートを実施する

インポートしたガイダンスを追加する前に、以下を確認します。

• ライセンスが適切か確認する
• 更新頻度や活動状況を確認する
• 手順が決定的で、破壊的でないことを確認する
• エンジンのバージョンに関する前提を明示する

ステップ 4：ローカルのスキル構成にまとめる

以下を作成または更新します。

• SKILL.md（運用者向けワークフロー）
• SKILL.toon（簡潔な動作契約）
• evals/evals.json（境界を守るためのプロンプトアサーション）

ステップ 5：PR にリスクとロールバック手順を記載する

インポートした内容、意図的に除外した内容、既知のリスク、具体的なロールバック手順（コミット／PR をリバート）を明記します。

ステップ 6：マージ前に検証する

JSON チェック、差分の整合性チェック（git diff --check）、および利用可能な場合はスキル検証スクリプトを実行します。

出力形式

簡潔なキュレーション記録を返します。

• 出典
• インポートしたパターン
• 除外したパターン
• リスク
• 検証結果

例

• 「調査で tjboudreaux/cc-plugin-unity-gamedev が見つかりました。リスクに関する注記を添えて、再利用可能なセットアップ／検証フローのみをローカルのスキルドキュメントにインポートします。」
• 「メタデータのフォールバック後も出典のライセンスが不明」→ 発見の記録としては保持しますが、明示的な例外理由がない限り、採用／インポートはしません。

ベストプラクティス

1. 複製よりも適応を優先します。外部のガイダンスをローカルの規約に合わせて書き直します。
2. レビュアーがすぐに確認できるよう、主張の近くに出典ラベルを付けます。
3. 外部ワークフローをインポートする場合は、必ず PR の本文にロールバック手順を記載します。

参考資料

• https://github.com/tjboudreaux/cc-plugin-unity-gamedev