Unity Workflow Skill

Claude Code 技能——Unity 开发的透明增强层，与 superpowers 工作流无缝集成。

核心能力

阶段	做什么
Phase 0: 工具探测	自动扫描所有已连接的 MCP Server 和 CLI 工具，生成工具能力清单
Phase 1: 原子 Spec	实施前将需求拆分为原子任务，每任务附带文件、位置、改动代码、验收标准
Phase 2: 路由执行	根据探测结果自动选择 MCP → CLI → Manual 执行路径，支持依赖 DAG 排序
Phase 3: 自动验证	逐任务自动验证（编译检查、Console 检查、截图对比、属性检查）+ 声明式清单兜底

---

安装

方式一：Git 一键安装（推荐）

全局安装（所有项目可用）：

git clone https://github.com/Mortal-XJ/unity-workflow.git && \
  cp -r unity-workflow/unity-workflow/ ~/.claude/skills/unity-workflow/ && \
  rm -rf unity-workflow

项目本地安装：

git clone https://github.com/Mortal-XJ/unity-workflow.git && \
  cp -r unity-workflow/unity-workflow/ .claude/skills/unity-workflow/ && \
  rm -rf unity-workflow

方式二：Plugin 安装

/plugin install unity-workflow@orange-unity

方式三：手动克隆

git clone https://github.com/Mortal-XJ/unity-workflow.git
# 全局
cp -r unity-workflow/unity-workflow/ ~/.claude/skills/unity-workflow/
# 或项目本地
cp -r unity-workflow/unity-workflow/ <your-project>/.claude/skills/unity-workflow/

---

触发条件

任何涉及 Unity/游戏开发的对话都会激活此技能：

• 脚本创建、编辑、调试
• GameObject、场景、Prefab 操作
• UI 开发（uGUI / UI Toolkit）
• Unity 测试（EditMode / PlayMode）
• 构建设置和项目配置

不触发： 与 Unity 无关的纯 C# 问题、非游戏软件架构。

---

文件结构

unity-workflow/
  SKILL.md                    # 主技能文件
  .claude-plugin/
    plugin.json               # Plugin 安装元数据
  references/
    spec-template.yaml        # 原子 Spec YAML 模板
    tools-registry.md         # 已知 MCP/CLI 工具注册表

---

与 Superpowers 集成

不替代 superpowers——透明增强每个阶段：

Superpowers 阶段	注入内容
brainstorming	工具探测 + Unity 项目上下文
writing-plans	原子 Spec 分解 + 验收标准
executing-plans	MCP/CLI 自动路由 + 执行
verification-before-completion	自动验证 + 声明式清单

---

设计原则

• 零硬编码： 工具探测完全通用，不绑定特定 MCP/CLI
• 优雅降级： 无工具可用时降级为人工指引，Spec 和验证层仍然工作
• 每步验证： 每个原子任务执行后立即验证，失败即停

---

Repository: https://github.com/Mortal-XJ/unity-workflow