SuperAPI AI 工具集

unity-cli-snippets

编程与开发

查看项目

更新于 10-16 02:32

技能介绍

用途:为 Unity Editor 自动化提供自进化的可复用 C# 片段库。执行非平凡 Unity 操作前,按严格顺序决策:先 cs list-commands [--type custom] 查内置或自定义命令,再 cs snippets search <description> 查片段,都不匹配才用 ad-hoc cs exec。非平凡指超过 3 行,或使用 LINQ、反射、AssetDatabase、多步骤。若搜索返回 libraryEmpty: true,本会话后续跳过搜索直接 ad-hoc。

主要能力:常用命令包括 cs snippets search <q>(按 id 与 summary 做词法匹配)、cs snippets show <id>(查看完整正文与元数据)、cs snippets use <id> --args '<json>'(带类型参数运行并统计)、cs snippets add <id> --file <md>(校验并注册)、cs snippets deprecate <id> [--supersede <new>](弃用不删除)。完整命令还有 list、update、prune、stats、doctor。

片段结构:frontmatter 含 id、summary、safety、args、example,可选 expected 字符串用于校验 REPL 文本结果。正文须定义一个与 args 顺序匹配的 static Run(...) 方法,辅助成员与 Run 并列,不能用局部函数。参数类型支持 string、int/float/bool、vector2/3/4、color、string[]/int[]/float[],不支持 Quaternion 与 expr。

安全与校验:read-only 为纯查询,add/update 时自动校验;mutates 有副作用,须加 --no-validate,审计标记 unverified。校验门是冒烟测试而非正确性保证。

限制:不要用 shell 直接读取 .unity-cli/snippets~,不要手改片段 .md,不要跳过命令与片段搜索,不要沉淀一次性或过于简单的操作。使用前需先运行 unity-cli-setup 安装。