前言¶

把已有的 H5 或原生 JS 游戏逻辑搬进 Cocos Creator，是常见的迁移动因，但通常伴随三个具体问题：逻辑与引擎 API 耦合，脱离编辑器无法测试；场景文件里的 uuid 手写容易出错；屏幕坐标系与引擎世界坐标系不一致，位置算出来对不上。

下面介绍的 Skill 就是为了处理这类迁移而做的。它不负责资源、动画和 UI 搭建，只处理从纯逻辑到可运行项目的这一段。

这是什么¶

Cocos 项目脚手架是一个社区 Skill，用于新建或迁移 Cocos Creator（3.8.x）TypeScript 项目，尤其针对把已有 H5/原生 JS 游戏逻辑搬进 Cocos、希望逻辑可离线 node 测试、并在不依赖编辑器的情况下尽量做静态校验的场景。

基本属性如下：

• 坐标：@user_4edac78e/cocos-project-scaffold
• 名称：Cocos 项目脚手架
• 版本：1.0.0
• 来源：community
• 分类：dev-programming
• 发布者：user_4edac78e
• 标签：requires_api_key=false（不需要 API key）
• SkillHub 数据：评分 100000，下载 914 次，安装 0 次（以抓取时页面为准）

该 Skill 基于通用 SKILL.md 格式，可被读取 SKILL.md 的 Agent 调用。

核心功能¶

官方简介覆盖了以下能力：

1、项目目录结构：给出 Cocos Creator 3.8.x TypeScript 项目的目录组织方式。
2、BattleSim 纯逻辑解耦：把游戏模拟逻辑从引擎 API 中拆出，形成可独立运行的纯逻辑层。
3、cc 桩类型检查：提供 cc 的桩（stub）实现，使依赖 cc 的代码可以在离线环境做类型检查，不需要编辑器。
4、scene 借用内置模板：场景文件基于内置的 scene-2d.scene 模板改写，避免手写 uuid 这类容易出错的操作。
5、坐标系映射：处理屏幕坐标系（左上原点）与引擎世界坐标系（中心原点）之间的转换。
6、designResolution 设置：给出设计分辨率的配置方法。
7、程序化矢量渲染：不依赖图片资源，用代码绘制图形。

安装与启用¶

官方地址：

https://www.skillhub.cn/skills/user_4edac78e/cocos-project-scaffold

安装命令未在抓取资料中给出，请以官方页面当前说明为准。已知信息是该 Skill 不需要 API key（requires_api_key=false），其来源为 community，不是官方出品。

启用方式与通用 SKILL.md 格式一致：Agent 读取 SKILL.md 后按其中的指令执行。具体在 Cursor、Codex CLI、Claude Code 中的差异，抓取资料中未说明，此处不做断言。

典型用法¶

按官方简介描述的能力，迁移一个已有 H5 逻辑项目的步骤可归纳为：

1、搭建项目目录结构，先按 Skill 给出的结构放置 TypeScript 源码与配置。
2、把游戏模拟逻辑抽成 BattleSim 纯逻辑层，与引擎 API 解耦，使其可在 node 下离线运行。
3、用 cc 桩对依赖 cc 的代码做离线类型检查，在没有编辑器的环境完成静态校验。
4、场景文件从内置的 scene-2d.scene 模板改写，而不是手写节点 uuid。
5、在需要定位的地方做坐标系映射，把左上原点的屏幕坐标换算成中心原点的世界坐标。
6、设置 designResolution，使表现与设计分辨率一致。
7、用程序化矢量渲染绘制图形，暂不引入图片资源。

上面是依据官方简介还原的工作流；每一步的具体文件与配置以 Skill 内的 SKILL.md 为准。

适用场景与注意¶

适合以下情况：

• 需要新建 Cocos Creator 3.8.x TypeScript 项目。
• 已有 H5 或原生 JS 游戏逻辑，需要迁入 Cocos。
• 希望核心逻辑可离线 node 测试。
• 想在不启动编辑器的情况下尽量完成静态校验。

需要注意的限制：

• 面向 Cocos Creator 3.8.x，其他主版本未在资料中说明。
• 场景依赖内置 scene-2d.scene 模板，超出模板范围的场景组织需自行处理。
• 坐标映射只覆盖左上原点与中心原点两种约定，更复杂的布局约定未提及。
• 该 Skill 为社区来源，当前安装量为 0，使用前建议先在小项目上验证行为。

结尾¶

这个 Skill 的价值在于把迁移中最琐碎的部分固化下来：目录结构、纯逻辑解耦、cc 桩类型检查、模板化场景、坐标换算、设计分辨率。对需要把现有 H5 逻辑搬进 Cocos Creator 3.8.x 的人来说，它提供了一条可离线验证的路径。

官方地址：https://www.skillhub.cn/skills/user_4edac78e/cocos-project-scaffold