unity-claude-code

Unity Claude Code 是一个针对 Unity 仓库的编码辅助技能，目标是在需要编码速度的同时，把资源完整性放在更高的优先级。它适用于在 Unity 项目中使用类似 Claude Code 的工作流进行准备和执行任务。

主要能力与工作流：

1. 确认仓库确实是 Unity 项目。
2. 在提出编辑建议之前，运行 scripts/unity-preflight.sh <repo-root> 进行预检。
3. 只阅读所需的参考文件：references/project-discovery.md 用于仓库扫描和变更定位；references/safe-editing-rules.md 用于 Unity 专用防护规则；references/claude-code-handoff.md 用于准备 Claude Code / ACP 任务。
4. 将编辑范围限制在请求的功能或缺陷内。
5. 用具体检查验证，而不是凭假设。

硬性规则（Non-negotiables）：

• 保留 .meta 文件。不要随意批量删除、重新生成或重命名它们。
• 将 .unity、.prefab、.asset、.mat 和 ProjectSettings/* 视为高风险文件。
• 当 C# 代码改动和宽泛的 YAML 编辑都能解决任务时，优先选择 C# 代码改动。
• 在报告中明确列出任何场景或预制体编辑。
• 如果任务涉及 Addressables、asmdef 边界、包或构建设置，在实施前说明影响范围。

默认执行模式：

1. 预检：运行 bash scripts/unity-preflight.sh /path/to/repo
2. 确定最窄的安全目标：按顺序优先处理 Assets/（用于游戏逻辑、运行时或编辑器代码）、Packages/manifest.json（用于包依赖）、ProjectSettings/（仅在需要更改项目配置时）。
3. 匹配任务类型：缺陷修复时检查堆栈路径、程序集边界、场景引用和回归风险；功能开发时识别运行时入口点、序列化字段、编辑流程和验证路径；重构时梳理公共 API、场景绑定、序列化名称和 asmdef 使用方；评审或交接时使用 references/claude-code-handoff.md 创建可供 Claude Code 使用的任务简报。
4. 具体验证：可使用 bash -n 检查辅助脚本；使用 node --check / node --test 检查 Unity 仓库周边的 JS 工具；如可用则运行仓库专属的构建或测试命令；通过文件差异检查 .meta 变动和场景或预制体 YAML 变动。

报告格式：

• Changed：具体文件
• Risk：场景、预制体、meta、asmdef、包的影响
• Verify：运行的命令及结果
• Next：一条建议的后续操作

资源文件包括：references/project-discovery.md、references/safe-editing-rules.md、references/claude-code-handoff.md、scripts/unity-preflight.sh。

适用场景：Unity 仓库中的功能开发、缺陷修复、重构以及 Claude Code 任务交接准备。 限制：是否可用于具体的 Unity 版本、平台、收费方式、价格等信息暂未提供。