Unity Agent Workflows 插件
产品介绍
Unity Agent Workflows（npm 包名 unity-agent-workflows，Codex 插件显示名 Unity Workflows）是一个 Unity 游戏开发专用的 AI 编程工作流插件，由 AUN-PN 开源在 GitHub（AUN-PN/unity-agent-workflows），以 Codex 插件 + Codex Skill + npx 安装器三种形态发布（当前版本 0.5.0）。它面向 AI 辅助的 Unity 2D 项目，解决的核心问题是：AI 改代码前总是瞎猜——改最近的脚本、信 Play Mode 会被覆盖的场景 YAML、认错重名对象、只查语法就宣称「验证通过」。
核心理念
一句话：No proof, no edit（没有证据就不许改）。
- 改前先证明归属：改动 UI/HUD/场景/预制体前，必须先证明「运行时可见对象 → 场景/预制体引用 → 脚本/组件 → 修改方法 → 序列化覆盖」这条归属链
- 改完拿数字自证：反复出现的可见问题，必须先拿到运行时数值证据才能再打补丁，不允许盲改坐标
- 防瞎猜：证据不全就去深入检查或问一个聚焦的问题，而不是猜
工作流机制
插件把任务强制走一条 10 步流程：读项目本地规则 → 查仓库状态 → 推导项目结构 → 任务分类 → 按需加载参考文档 → 证明循环（证据不全不往下走）→ 锁定范围（明确「允许改哪些文件、绝不碰哪些文件」）→ 最小安全补丁 → 最小有效验证 → 收尾报告（改动文件 + 证据 + 验证结果 + 残余风险）。
配套机制：
- UNITY_STRUCTURE.md 结构地图：用
Teach指令为项目生成结构索引和分领域地图（UI / 运行时 / 内容 / 程序集 / 清理），后续任务只读需要的地图 - 多智能体管控：生成子智能体前必须征得用户同意，子智能体默认只读，主智能体锁定范围后才能打补丁
- 参考文件按需加载：20 个 reference 文件组成规则库，只在任务需要时读取对应规则
安装与使用
- Codex 插件市场安装： marketplace 源填
https://github.com/AUN-PN/unity-agent-workflows.git，ref 填main，装完在插件列表启用Unity Workflows - 本地 Skill 安装：
npx unity-agent-workflows（--target codex|claude|both，--dry-run可预览） - 在 Unity 2D 仓库内用
$unity-agent-workflows触发；新项目或结构地图缺失时用Teach生成
与我们的关系（2026-09-09 评估）
- 可借鉴的是它的理念——AI 干活的最优实践就是「先拿证据再动手」：先证明归属再改、改完用数字自证、不靠猜
相关笔记
- Unity - 面向的游戏引擎
- codex - 插件宿主环境
- 本机 TraeWork 插件一览 - ⚠️ 它不在 TraeWork 插件市场
2026-10-02 核实：容易与另两个东西混
| 名字 | 实际是什么 | 是不是同一个 |
|---|---|---|
| unity-agent-workflows（本文） | Codex 插件市场 / 本地 Skill 分发 | — |
| TRAE Editor for Unity | Trae IDE 的插件（不是 TraeWork） | ❌ 不同产品线 |
| ML-Agents、Antimatter Agent、Codely | Unity 侧第三方工具 | ❌ 都无关 |
结论：TraeWork 插件市场里查不到这个插件。 它装在 Codex 或 Claude Code 里，不装在 TraeWork。
相关日记
- 2026-09-09 - 评估后决定删除，记录可借鉴理念
- 2026-10-02 - 核实：确认不在 TraeWork 插件市场，补与 TRAE Editor for Unity 的辨析