前言¶

把已有的 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