uni-app项目创建器Skill：一句话生成规范 uni-app 项目骨架，把初始化交给 AI
- 核心定位：把 uni-app 项目从零初始化这件事，从"翻文档、选模板、改配置"变成一句自然语言指令。
- 能力范围：覆盖 Vue 2 / Vue 3 / TypeScript 模板选择、CLI 与 HBuilderX 两条创建路径、
manifest.json与pages.json配置生成、标准目录结构搭建。 - 使用门槛：不需要记住 CLI 参数，只需说明项目类型与技术栈，技能会自动匹配对应的模板与命令。
- 差异化价值：普通脚手架只给命令，这个技能给"命令 + 结构 + 配置 + 最佳实践"的整套方案。
- 适用人群：跨端小程序/App 开发者、需要快速搭原型的独立开发者、团队内负责统一项目规范的技术负责人。
该技能叫什么？如何下载安装 AI 技能提升开发效率？
基本信息
| 项目 | 内容 |
|---|---|
| 技能中文名 | uni-app项目创建器Skill |
| 技能英文名 | uniapp-project-creator |
| 技能ID | 12643 |
| 官方文档参考 | https://uniapp.dcloud.net.cn/quickstart-cli.html（以官方说明为准） |
它解决什么问题
uni-app 是一个可以用一套代码发布到小程序、H5、App 多端的跨端框架，但"从零开始"这一步对很多人并不轻松：
- 不确定该选 Vue 2 还是 Vue 3 模板，选错了后面迁移成本很高；
- CLI 与 HBuilderX 两条创建路径的参数、命令不一样，容易记混；
manifest.json（应用配置）和pages.json（页面路由与窗口样式）字段多、容易漏配；- 目录结构不规范，团队多人协作时各写各的。
uni-app项目创建器Skill 就是把这一整套"初始化知识"封装成技能：你说清楚要一个什么样的项目，它按官方 CLI 快速启动流程与模板规范，把项目结构、配置文件和创建命令一并产出。
一键安装的思路与步骤
"一键安装"的本质是：先把技能装到你的 AI 助手环境里，之后每次说一句话就能触发项目创建，而不用每次重新解释需求。
第一步：确认安装前提
- 已具备可加载技能的 AI 助手/开发环境（具体入口以你所使用平台的官方说明为准）；
- 本地已准备 Node.js 与包管理器环境（uni-app CLI 创建方式依赖 Node 环境，版本要求以官方文档为准）；
- 如果走 HBuilderX 路径，需先安装 HBuilderX 客户端（下载地址：https://www.dcloud.io/hbuilderx.html，以官方说明为准）。
第二步：安装技能
在技能市场/技能管理入口搜索技能英文名 uniapp-project-creator 或技能ID 12643，按平台提示完成添加。具体按钮位置、是否需要授权、是否收费等，均以官方说明为准。
第三步：验证是否生效
回到对话中，用一句明确的需求触发技能，例如：
帮我用官方 CLI 创建一个 Vue 3 的 uni-app 项目，项目名叫 my-shop，并生成 manifest.json 和 pages.json 的基础配置。
如果技能已生效，你会看到它先确认项目类型（标准项目 / HBuilderX 项目 / CLI 项目），再输出对应的创建命令、目录结构与配置文件内容。若回复只是泛泛而谈、没有给出模板与命令，说明技能未被正确加载，可检查技能是否启用或重新触发。
该技能的主要功能和特点
- 单命令创建项目：面向"一句话创建"的场景，用户只需描述目标技术栈，技能输出可直接执行的 CLI 快速启动命令，而不是让用户自己拼参数。
- 多模板类型覆盖：支持标准 uni-app 项目（Vue 2 / Vue 3）、HBuilderX 创建方式、CLI 创建方式，并覆盖 TypeScript 等不同项目类型。
- 配置文件生成：针对
manifest.json与pages.json给出配置内容与说明，减少字段漏配、格式错误。 - 标准目录结构输出：依据
templates/project-templates.md的项目结构模板，生成符合 uni-app 规范的目录骨架。 - 页面与组件创建：除初始化外，也支持创建 uni-app 页面和组件，方便项目起步阶段快速铺开。
- 最佳实践内置：模板选择、配置正确性、目录组织、优先使用 CLI、创建后初始化 git 仓库等建议直接内置在流程里。
- 知识分层加载：通过
examples/guide/（安装、快速启动、项目类型）与templates/（项目结构、CLI 命令）分层组织资料，回答时按需取材，避免一次性输出无关内容。
和普通脚手架/文档比强在哪：脚手架只提供命令，文档只提供说明，二者之间"选哪个模板、参数怎么填、配置怎么写、结构怎么摆"的判断题，正是这个技能承接的部分。
如何使用该技能？
步骤一：明确你的项目类型
先在心里（或直接告诉技能）回答三个问题：
- 用 CLI 创建还是用 HBuilderX 创建？
- 用 Vue 2 还是 Vue 3（是否需要 TypeScript）？
- 是否已有项目名与目标目录？
步骤二：发起自然语言请求
输入示例 1（CLI + Vue 3）
用官方 CLI 快速启动方式创建一个 uni-app 项目，Vue 3 模板，项目名 my-shop。
输入示例 2（HBuilderX 路径）
我不想用命令行，想用 HBuilderX 创建 uni-app 项目，请给我完整步骤和需要注意的配置项。
输入示例 3（配置补充）
项目已经创建好了，帮我把 manifest.json 的应用名称、版本号和 pages.json 的首页路由配好，并给出目录结构说明。
步骤三：读取输出并执行
技能会先从 examples/guide/ 中加载对应的指南（安装、快速启动、项目类型），再从 templates/ 中加载项目结构与 CLI 命令模板，然后输出：
- 识别出的项目类型与模板选择理由；
- 创建命令（可直接复制到终端执行）；
- 生成的目录结构与关键文件说明；
manifest.json、pages.json的配置内容；- 后续建议（如初始化 git 仓库）。
步骤四：创建后自检
- 命令是否与你的 Node 环境匹配（版本要求以官方说明为准）；
- 模板是否与团队技术栈一致（Vue 3 项目不要误用 Vue 2 模板）；
pages.json中的首页路由是否与实际页面文件对应；- 目录结构是否符合 uni-app 标准约定。
步骤五：进入开发
项目骨架就绪后，页面与组件的进一步开发、组件与 API 的详细参考，可转到 uniapp-project-guide 相关指引中继续，避免把"创建"和"开发"混在一次请求里。
同类型竞品对比分析
| 方案名称 | 定位 | 核心功能 | 安装/使用门槛 | 适用场景 | 优势与不足 |
|---|---|---|---|---|---|
| uni-app项目创建器Skill（本技能） | AI 驱动的一站式项目初始化助手 | 模板选择建议、CLI/HBuilderX 路径分流、manifest.json 与 pages.json 配置生成、目录结构模板、页面组件创建 | 需在 AI 环境加载技能；本地仍需 Node 或 HBuilderX | 需要"边问边建"、希望有人解释每一步为什么这么做 | 优势：把决策与配置一起解决，适合新手与快速原型；不足：本质仍调用官方 CLI，最终执行依赖本地环境 |
| uni-app 官方 CLI 快速启动 | 官方标准脚手架入口 | 一条命令拉取模板并初始化项目 | 需自行查文档、记参数、选模板 | 熟悉 uni-app 的老手批量建项目 | 优势：官方权威、轻量；不足：无解释、无配置建议，选错模板需返工 |
| HBuilderX 可视化创建 | 官方 IDE 内置创建方式 | 可视化新建项目、内置运行与调试 | 需安装 HBuilderX 客户端 | 偏好图形界面、以 App/小程序调试为主的开发者 | 优势：开箱即用、调试链路完整；不足：灵活性弱于 CLI，团队协作与自动化不便 |
| 通用前端脚手架（如 Vue CLI 生态模板） | 通用 Web 项目脚手架 | 生成通用前端工程结构 | 需自行适配跨端配置 | 纯 H5 或需要高度自定义工程化的项目 | 优势：生态成熟、插件丰富；不足：不内置 uni-app 多端约定，manifest.json/pages.json 需自行补齐 |
选择建议：追求"少踩坑 + 有人讲清楚"选本技能；追求极致轻量选官方 CLI；完全不碰命令行选 HBuilderX。
该技能的典型应用场景与实际体验情况
场景一：跨端小程序开发者接新需求
- 角色与痛点：外包或公司内开发者接到一个新小程序需求，要当天出可运行骨架，但记不清 CLI 参数和新版模板差异。
- 使用方式：说明"Vue 3 + CLI + 项目名"，让技能输出命令与目录结构，复制执行后直接进入页面开发。
- 实际体验：上手难度低，首次使用基本零学习成本；效果体现在"省掉查文档的 20~30 分钟"；注意事项是执行前确认本地 Node 环境，命令细节以官方文档为准。
场景二：技术负责人统一团队项目规范
- 角色与痛点：团队多人各自建项目，目录结构和
manifest.json配置五花八门，Code Review 成本高。 - 使用方式：先用技能生成一份标准项目结构与配置说明，作为团队模板基线，再让成员按同一套请求话术创建项目。
- 实际体验：价值不在"建项目快"，而在"标准统一"；建议把技能输出的结构说明沉淀为团队文档。
场景三：教学与新人上手
- 角色与痛点：新人第一次接触 uni-app，不理解为什么要选 Vue 3、
pages.json到底管什么。 - 使用方式：让技能在给出命令的同时解释模板选择理由与配置文件作用。
- 实际体验：技能内置的最佳实践条目对教学很友好；注意它聚焦"创建与初始化"，组件 API 细节需转到配套指引。
场景四：快速原型与 Demo 验证
- 角色与痛点：需要半小时内验证一个多端想法是否可行。
- 使用方式：一句话创建项目，按模板补齐首页与基础组件，立即跑通。
- 实际体验：效率提升明显；注意原型阶段也别跳过 git 初始化，避免后续版本混乱。
该技能能为用户带来的价值
- 效率提升：把"查文档—选模板—敲命令—补配置"的串行流程压缩为一次对话，项目初始化从数十分钟级降到分钟级。
- 门槛降低：不需要背 CLI 参数、不需要通读
manifest.json与pages.json字段说明，新手也能产出规范骨架。 - 错误率下降：模板与技术栈匹配、配置文件正确性、目录结构规范这三类高频错误被前置规避，减少返工。
- 规范可复用：输出的项目结构与最佳实践可沉淀为团队标准，长期看降低协作与维护成本。
- 决策有依据：Vue 2 / Vue 3、CLI / HBuilderX 的选择不再靠猜，而是基于项目目标给出建议。
常见问题 FAQ
Q1：怎么安装这个技能？装完怎么确认能用？
A：在技能管理入口搜索英文名 uniapp-project-creator 或技能ID 12643 添加即可，具体入口与授权方式以官方说明为准。验证方法：发一句"用官方 CLI 创建 Vue 3 的 uni-app 项目"，若返回项目类型判断、创建命令与目录结构，说明已生效。
Q2：这个技能收费吗？
A：技能本身的授权条款以其 LICENSE.txt 与所在平台说明为准，本文不提供价格信息；uni-app、HBuilderX、Vue CLI 均为各自官方提供的工具，其授权与收费政策以官方说明为准。
Q3：它和直接敲官方 CLI 命令有什么区别？
A：官方 CLI 只给命令，你需要自己决定模板、参数和配置；本技能额外提供模板选择建议、manifest.json 与 pages.json 配置、目录结构模板和最佳实践。如果你已经很熟这套流程，直接用 CLI 更轻。
Q4：适合谁用？不适合谁？ A：适合跨端开发新手、需要快速搭原型的开发者、要统一团队项目规范的技术负责人。不太适合已深度定制自有脚手架、且流程完全固定的成熟团队。
Q5：它能帮我写业务代码吗？
A：这个技能聚焦项目创建与初始化，包括结构、配置、页面与组件创建。组件与 API 的详细参考在配套的 uniapp-project-guide 中，业务逻辑开发仍需你结合项目实际完成。