You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: plugins/AUN-PN/unity-agent-workflows/.codex-plugin/plugin.json
+1-1Lines changed: 1 addition & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
{
2
2
"name": "unity-agent-workflows",
3
-
"version": "0.4.0",
3
+
"version": "0.4.2",
4
4
"description": "Codex skill for safer Unity AI agent workflows, runtime-owner proof, runtime numeric proof, multi-agent scope ownership, and Unity game development automation.",
|[references/project-structure-discovery.md](references/project-structure-discovery.md)| live Unity structure discovery and `UNITY_STRUCTURE.md` maps |
295
-
|[references/runtime-owner-proof.md](references/runtime-owner-proof.md)| runtime-visible owner proof and repeated-fix diagnostics |
295
+
|[references/runtime-owner-proof.md](references/runtime-owner-proof.md)| core runtime-visible owner chain and lazy proof router |
296
+
|[references/visible-object-identity.md](references/visible-object-identity.md)| competing visible owners and anti-anchoring checks |
Copy file name to clipboardExpand all lines: plugins/AUN-PN/unity-agent-workflows/skills/unity-agent-workflows/SKILL.md
+41-12Lines changed: 41 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
2
name: unity-agent-workflows
3
-
description: Use for AI-assisted Unity work that needs live repo discovery, project-derived routing, runtime-owner proof, runtime-visible output hard stops, runtime numeric proof for repeated visible-output failures, state-step guards, multi-agent scope ownership, modular C#/asmdef safety, UI/scene/visual asset gates, data-first content changes, validation, cleanup proof, or durable workflow rules. Best when agents must prove the actual folder/module/scene/prefab/runtime owner before editing, especially runtime UI, generated assets, code graphs, tutorial/state flows, guided equipment/shop flows, overlay/dim source-bound mistakes, coordinate conversions, focus/highlight/marker/HUD alignment, or repeated "fix still not visible" failures.
3
+
description: Use for AI-assisted Unity work that needs live repo discovery, project-derived routing, runtime-owner proof, runtime-visible output hard stops, runtime numeric proof for repeated visible-output failures, state-step guards, multi-agent scope ownership, modular C#/asmdef safety, UI/scene/visual asset gates, data-first content changes, validation, cleanup proof, or durable workflow rules. Best when agents must prove the actual folder/module/scene/prefab/runtime owner before editing, especially runtime UI, generated assets, code graphs, tutorial/state flows, guided selection/action flows, overlay/dim source-bound mistakes, coordinate conversions, focus/highlight/marker/HUD alignment, or repeated "fix still not visible" failures.
4
4
license: MIT
5
5
---
6
6
@@ -29,7 +29,8 @@ AI contract for Unity work. Keep answers compact, but never remove exact paths,
29
29
| Runtime/visible bug | Prove owner chain before editing. |
| Screenshot or visible UI text fix | Screenshot Text Owner Gate; search exact visible text/localization key and prove creator plus refresh writer before editing. |
32
-
| Visual/model/sprite/asset integration where feature name, source asset, factory, or visible surface may disagree | Visible Object Identity Lock and Single-Agent Anti-Anchoring Guard before editing. |
32
+
| Visual/model/sprite/asset integration where feature name, source asset, factory, or visible surface may disagree | Visible Object Identity Lock, Multi-Surface Visible Behavior Lock, and Single-Agent Anti-Anchoring Guard before editing. |
33
+
| Same visible behavior requested across multiple scenes/surfaces, or words like "also", "after transition", "menu and gameplay", "preview and runtime", "scene A and scene B" | Multi-Surface Visible Behavior Lock; prove each surface owner, active caller, asset/factory dependency, and fallback behavior before editing any surface. |
33
34
| Shared factory/helper/style/global method candidate for a scoped visible surface | Shared Caller Blast Radius Gate: prove allowed runtime caller(s), all other callers, and whether the patch is surface-local before editing. |
| Repeated visible-output failure, wrong focus/highlight/marker/HUD/camera position, cross-root/cross-canvas mismatch |`references/runtime-owner-proof.md`, `references/runtime-visible-output.md`, `references/runtime-numeric-proof.md`, then only needed target/conversion details |
60
+
| Same visible behavior across menu/gameplay/preview/runtime/transition/scene surfaces |`references/runtime-owner-proof.md`, `references/multi-surface-visible.md`, `references/asset-source-lock.md`|
| Multi-agent Unity visible-output/state-transition work, parallel workers, checker review |`references/ai-workflows.md` plus only the references for the actual visible surface or state flow |
60
63
| New files/classes, moved scripts, asmdef/module routing, dependency direction, hub deflation/refactor |`references/project-structure-discovery.md`, `references/modular-architecture.md`, `references/ai-workflows.md`|
61
64
| New runtime feature, content, progression, levels, economy, objective/data-first work |`references/project-structure-discovery.md`, `references/content-and-systems.md`, `references/ai-workflows.md`|
Load `references/unity-validation.md` only for edit intent, validation requests, compile/runtime doubt, Play Mode proof, or closeout validation planning. Load `references/workflow-recipes.md` only for named `WF-*` requests, recipe requests, or when `references/ai-workflows.md` is not specific enough. After loading a reference, follow its own `Read` / `Load Extra Detail` table instead of preloading every linked file.
70
73
@@ -126,7 +129,28 @@ validation:
126
129
127
130
Missing source bounds, converted rect, or final drawn rect is FAIL; return a runtime probe plan only.
128
131
129
-
State-step proof: screen open, click, analytics, or prompt shown is not completion. Prove relevant steps separately: shown, clicked, opened, selected, equipped, claimed, completed, persisted, old-save path, reset path.
132
+
Multi-Surface Visible Behavior Lock for the same visual behavior across scenes/surfaces:
133
+
134
+
```text
135
+
requested behavior:
136
+
surface list:
137
+
surface 1 visible object:
138
+
surface 1 owner/caller/writer:
139
+
surface 1 asset/factory dependency:
140
+
surface 1 fallback behavior:
141
+
surface 2 visible object:
142
+
surface 2 owner/caller/writer:
143
+
surface 2 asset/factory dependency:
144
+
surface 2 fallback behavior:
145
+
shared helper/factory/global selector:
146
+
callers outside requested surfaces:
147
+
patch order:
148
+
validation per surface:
149
+
```
150
+
151
+
If any requested surface lacks owner/caller/writer or asset/fallback proof, stay read-only for patches and return the missing proof plan. Do not patch only a preview/transition surface when the user also requested gameplay/runtime behavior.
152
+
153
+
State-step proof: screen open, click, analytics, or prompt shown is not completion. Prove relevant steps separately: shown, clicked, opened, selected, applied, completed, persisted, old-save path, reset path.
130
154
131
155
Sub-agent permission guard: default to one main agent. Before spawning any sub-agent, decide that the work needs independent proof tracks, explain why, list each sub-agent task, state read-only vs edit permission, allowed files/surfaces, forbidden files/surfaces, and checker need, then ask the user. Do not spawn until the user explicitly approves in the same turn, except when the user already explicitly requested sub-agents in that turn.
132
156
@@ -138,6 +162,8 @@ For Unity visual/model/sprite/asset integration, the visible runtime object iden
138
162
139
163
Asset/source ID lock: when the user provides a generator ID, asset ID, sprite sheet, prefab, scene, surface, or object name, use only that source and surface. Do not substitute another asset/source or broaden to gameplay/global behavior without asking first.
140
164
165
+
Asset Variant Availability Gate: before changing directional sprites, model poses, animation frames, sprite selectors, model factories, or fallback visuals, prove the requested variants exist and identify the runtime fallback when they do not. Missing variants are not a license to patch unrelated surfaces or shared factories; either add a surface-local fallback with caller proof, generate/obtain the missing source asset through the approved asset workflow, or stop and ask.
166
+
141
167
Shared Caller Blast Radius Gate:
142
168
143
169
```text
@@ -180,6 +206,9 @@ Placement layer/category from repo:
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4&size=40){kind=avatar}
0 commit comments