unity-shared

Name: unity-shared
Author: bigdra50

39stars4forks

How to install unity-shared?

bigdra50/unity-cli/unity-shared

$npx -y skills add bigdra50/unity-cli --skill unity-shared

Installs into the current project.

Summary

unity-cli 共通ルール。全 unity-* スキルが自動ロードする前提条件。Use as prerequisite for any unity-* skill (verification sequence, fallback order, security policy).

Files · 1

View on GitHub

SKILL.md

1	# unity-shared
2
3	全 unity-* スキルが従う共通ルール。
4
5	## インスタンス指定 (必須)
6
7	unity-* スキル経由で `u` コマンドを呼ぶ際は必ず `-i <instance>` を付ける。default インスタンスに依存しない。
8
9	```bash
10	u -i <instance> refresh # OK
11	u refresh # NG (skill 経由では使わない)
12	```
13
14	`<instance>` はユーザーから渡される or 親セッションが指定する値で置き換える。`u instances` で接続中 Unity 一覧を確認できる。本ドキュメント以下のサンプルでは `<instance>` をそのまま使うが、実行時は具体名 (例: `TestProject`) に置換する。
15
16	理由: 複数 Unity 接続環境で誤ったインスタンスへコマンドを送るリスクと、subagent 間の挙動を default 依存にしないため。
17
18	## 接続確認
19
20	```bash
21	u instances # 接続中 Unity 一覧
22	u -i <instance> state # 特定エディタの状態
23	```
24
25	接続不可時: `unity-relay --port 6500` で Relay 起動。
26
27	## Quick Verify
28
29	コード変更後に毎回実行する検証シーケンス。順序厳守 (clear は refresh の前に置く。後にすると refresh の診断ログを消してしまう)。
30
31	```bash
32	# 1. 既存ログをクリア (refresh の診断を残すため refresh の前)
33	u -i <instance> console clear
34
35	# 2. AssetDatabase リフレッシュ (コンパイルトリガー)
36	u -i <instance> refresh
37
38	# 3. isCompiling が false になるまでポーリング (2秒間隔, 最大30秒)
39	for _ in $(seq 1 15); do
40	u -i <instance> state --json \| jq -e '.isCompiling == false' >/dev/null && break
41	sleep 2
42	done
43
44	# 4. Error/Warning 取得 (--count は deprecated. head -N を使う)
45	u -i <instance> console get -l E,W \| head -50
46	```
47
48	`u state --json` の出力例 (抜粋, キーはトップレベル):
49
50	```json
51	{"isCompiling": false, "isPlaying": false, "isPaused": false}
52	```
53
54	- Error あり → 修正して再実行 (最大3回)
55	- Warning のみ → 報告して続行
56
57	### 注記: 空 (0 行) は「クリーン」だが「Warning が無い」とは限らない
58
59	Unity はインクリメンタルコンパイルのため、ソース未変更で `refresh` を呼んでも再コンパイルは走らず、過去の Warning は再出力されない。`console clear` 後に空が返っても以下のいずれかを意味する:
60
61	1. ソース変更があり再コンパイルが走り、エラー/警告がない (本当のクリーン)
62	2. ソース未変更で再コンパイルがスキップされ、過去の警告が出力されないだけ
63
64	直前にソース編集があった文脈なら「クリーン」扱いで OK。過去の警告を確実に確認したい場合は対象ファイルの touch (`touch Assets/.../Foo.cs`) で mtime を更新してから refresh するか、`Library/ScriptAssemblies/` をクリアする。
65
66	## フォールバック順
67
68	CLI 非対応の操作を行う場合:
69
70	```text
71	1. u -i <instance> <既存コマンド> 最優先
72	2. u -i <instance> api call Type Method 5,243 メソッド対応
73	3. YAML 直接編集最終手段 (.meta インポート設定等)
74	```
75
76	## セキュリティ
77
78	- `u api call` は UnityEngine / UnityEditor のみ許可
79	- 破壊的操作の実行前にユーザー確認

People who liked this also viewed

6 picks

Type

lark-openapi-explorer飞书/Lark 原生 OpenAPI 探索：从官方文档库中挖掘未经 CLI 封装的原生 OpenAPI 接口。当用户的需求无法被现有 lark-* skill 或 lark-cli 已注册命令满足，需要查找并调用原生飞书 OpenAPI 时使用。SkillsJul 2026378k16k
lark-skill-maker创建 lark-cli 的自定义 Skill。当用户需要把飞书 API 操作封装成可复用的 Skill（包装原子 API 或编排多步流程）时使用。SkillsJul 2026377k16k
azure-cost-optimizationOfficial agent plugin providing skills and MCP server configurations for Azure scenarios.SkillsJul 2026209k1.3k
vercel-react-native-skillsVercel's official collection of agent skillsSkillsJul 2026172k29k
mcp-builderGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate externaSkillsJul 202693k163k
gws-sharedgws CLI: Shared patterns for authentication, global flags, and output formatting.SkillsJul 202653k30k

unity-shared

39stars4forks

View on GitHub

How to install unity-shared?

bigdra50/unity-cli/unity-shared

$npx -y skills add bigdra50/unity-cli --skill unity-shared

Installs into the current project.

Summary

unity-cli 共通ルール。全 unity-* スキルが自動ロードする前提条件。Use as prerequisite for any unity-* skill (verification sequence, fallback order, security policy).

Files · 1

View on GitHub

SKILL.md

1	# unity-shared
2
3	全 unity-* スキルが従う共通ルール。
4
5	## インスタンス指定 (必須)
6
7	unity-* スキル経由で `u` コマンドを呼ぶ際は必ず `-i <instance>` を付ける。default インスタンスに依存しない。
8
9	```bash
10	u -i <instance> refresh # OK
11	u refresh # NG (skill 経由では使わない)
12	```
13
14	`<instance>` はユーザーから渡される or 親セッションが指定する値で置き換える。`u instances` で接続中 Unity 一覧を確認できる。本ドキュメント以下のサンプルでは `<instance>` をそのまま使うが、実行時は具体名 (例: `TestProject`) に置換する。
15
16	理由: 複数 Unity 接続環境で誤ったインスタンスへコマンドを送るリスクと、subagent 間の挙動を default 依存にしないため。
17
18	## 接続確認
19
20	```bash
21	u instances # 接続中 Unity 一覧
22	u -i <instance> state # 特定エディタの状態
23	```
24
25	接続不可時: `unity-relay --port 6500` で Relay 起動。
26
27	## Quick Verify
28
29	コード変更後に毎回実行する検証シーケンス。順序厳守 (clear は refresh の前に置く。後にすると refresh の診断ログを消してしまう)。
30
31	```bash
32	# 1. 既存ログをクリア (refresh の診断を残すため refresh の前)
33	u -i <instance> console clear
34
35	# 2. AssetDatabase リフレッシュ (コンパイルトリガー)
36	u -i <instance> refresh
37
38	# 3. isCompiling が false になるまでポーリング (2秒間隔, 最大30秒)
39	for _ in $(seq 1 15); do
40	u -i <instance> state --json \| jq -e '.isCompiling == false' >/dev/null && break
41	sleep 2
42	done
43
44	# 4. Error/Warning 取得 (--count は deprecated. head -N を使う)
45	u -i <instance> console get -l E,W \| head -50
46	```
47
48	`u state --json` の出力例 (抜粋, キーはトップレベル):
49
50	```json
51	{"isCompiling": false, "isPlaying": false, "isPaused": false}
52	```
53
54	- Error あり → 修正して再実行 (最大3回)
55	- Warning のみ → 報告して続行
56
57	### 注記: 空 (0 行) は「クリーン」だが「Warning が無い」とは限らない
58
59	Unity はインクリメンタルコンパイルのため、ソース未変更で `refresh` を呼んでも再コンパイルは走らず、過去の Warning は再出力されない。`console clear` 後に空が返っても以下のいずれかを意味する:
60
61	1. ソース変更があり再コンパイルが走り、エラー/警告がない (本当のクリーン)
62	2. ソース未変更で再コンパイルがスキップされ、過去の警告が出力されないだけ
63
64	直前にソース編集があった文脈なら「クリーン」扱いで OK。過去の警告を確実に確認したい場合は対象ファイルの touch (`touch Assets/.../Foo.cs`) で mtime を更新してから refresh するか、`Library/ScriptAssemblies/` をクリアする。
65
66	## フォールバック順
67
68	CLI 非対応の操作を行う場合:
69
70	```text
71	1. u -i <instance> <既存コマンド> 最優先
72	2. u -i <instance> api call Type Method 5,243 メソッド対応
73	3. YAML 直接編集最終手段 (.meta インポート設定等)
74	```
75
76	## セキュリティ
77
78	- `u api call` は UnityEngine / UnityEditor のみ許可
79	- 破壊的操作の実行前にユーザー確認

People who liked this also viewed

6 picks

Type