Tools & CLI-Referenz
Jedes AI-Forge-Tool bringt ein Capability-Manifest mit und läuft in zwei Modi – headless über die CLI oder, bei offenem Editor, über Request/Response-Dateien. Hier die einzelnen Tools mit ihren Fähigkeiten.
Project Lens
Gibt dem Agenten ein strukturiertes Projektverständnis, statt alles zu scannen: ein KI-lesbarer Katalog aus
Skripten, Prefabs, Materialien, Szenen und ScriptableObjects samt Beziehungen. Ein Build erzeugt
Temp/AI/project-index.json.
| Capability | Zweck | Modus |
|---|---|---|
projectlens.index | Katalog bauen/aktualisieren | beide |
projectlens.query | Strukturierte Suche („Prefabs mit Rigidbody", „Typen, die IX implementieren") | closed |
projectlens.usages | Referenzen auf ein Asset/einen Typ finden | closed |
projectlens.summary | Prefab/Szene/Skript zusammenfassen | closed |
Read-only – keine destruktiven Fähigkeiten, gefahrlos ausführbar. Der Index-Build läuft headless; im Editor
aktualisiert er inkrementell über einen AssetPostprocessor.
Scene Smith
Baut und befüllt Szenen aus einer deklarativen SceneSpec. Der Agent denkt in Daten, nicht in Editor-Klicks:
{
"scene": "Assets/Scenes/Arena.unity",
"environment": "skybox-day",
"objects": [
{ "prefab": "Assets/Prefabs/Crate.prefab", "at": [0,0,0], "name": "Crate_A" },
{ "primitive": "Plane", "scale": [10,1,10], "name": "Ground" },
{ "prefab": "Assets/Prefabs/Torch.prefab",
"arrange": { "pattern": "circle", "count": 8, "radius": 5 } }
],
"camera": { "at": [0,6,-10], "look": [0,0,0], "fov": 60 },
"lighting": "three-point"
}| Capability | Zweck | Destruktiv |
|---|---|---|
scenesmith.build | Szene aus SceneSpec bauen/befüllen | nein (neue Szene) |
scenesmith.place | Objekte/Prefabs in die Szene setzen | nein |
scenesmith.arrange | Grid-/Kreis-/Scatter-/Linien-Platzierung | nein |
scenesmith.modify | Bewegen/Rotieren/Skalieren/Umbenennen per Name | ja |
scenesmith.camera-light | Kamera- + Licht-Preset anwenden | nein |
scenesmith.snapshot | Kamera/Scene-View zu PNG rendern | nein |
Unity -batchmode -executeMethod SceneSmith.Editor.BuildCLI.Run \
-spec Assets/Scenes/arena.spec.json \
-out Assets/Scenes/Arena.unitymodify/Reparent sind destruktiv und verlangen Bestätigung; ein dry-run meldet nur die
geplanten Operationen. Bevorzugt additive Szenen – nie eine Szene ohne explizites Ziel + Bestätigung überschreiben.
Scene Verify Pro
Rendert eine gebaute Szene in ein PNG, damit der Agent sein eigenes Ergebnis sieht und sich selbst korrigiert.
Technisch: eine Camera mit targetTexture → Render() → ReadPixels → PNG, headless.
Das schließt den Kreis bauen → schauen → korrigieren – der wichtigste Baustein für zuverlässige autonome Änderungen.
Store Advisor Pro
Bezieht die Asset-Store-Pakete, die du besitzt, in Planung und Umsetzung ein – auch noch nicht importierte. So sagt der Agent „du besitzt bereits X, das das kann", statt es neu zu bauen.
| Capability | Zweck | Modus |
|---|---|---|
storeadvisor.catalog | Besessene/heruntergeladene Store-Assets auflisten (lokaler Cache) | closed |
storeadvisor.inspect | Inhalt eines .unitypackage ohne Import ansehen | closed |
storeadvisor.suggest | Zu einem Bedarf passende besessene Assets vorschlagen | closed |
Privacy: Kaufdaten sind personenbezogen. Store Advisor liest sie nur lokal (unter Windows
%APPDATA%/Unity/Asset Store-5.x/), stellt sie nur dem Agenten im Projekt bereit und überträgt nichts.
Weitere Pro-Erweiterungen
- Scene Smith Pro – Licht-/Umgebungs-Presets (day, sunset, overcast, night), Frame-Everything-Kamera, Save-as-Prefab und Batch-Generierung aus einer Spec.
- Project Lens Pro – tiefere Audits: wahrscheinlich ungenutzte Assets, Größen-Report, Prefabs mit fehlenden Skripten und vollständige Dependency-Bäume.
