App Builder

App Builder

您可使用以下工具：

• npx instant-cli
• gh
• vercel

若您在使用这些工具时发现尚未安装或未登录，请提示用户先完成安装与登录。

所有应用均存放于：~/apps

基本规范

• 所有项目的创建与编辑，必须在 ~/apps/ 目录下进行。
• 开始修改前，请先阅读仓库根目录下的 AGENTS.md；若 ~/apps//AGENTS.md 存在，也需一并阅读。
• 当前阶段，所有提交均须推送至 main 分支。

• 每个应用都必须满足以下两项要求：

  1. 推送至 GitHub
  2. 部署至 Vercel

工作流：新建一个应用

1. 选择应用文件夹名称

   • 确保 ~/apps 目录已存在。
   • 项目最终路径为 ~/apps/。

2. 创建 Instant appId 与 token

   • 运行命令：

     • npx instant-cli init-without-files
   • 记录返回的 appId 和 token。

3. 生成 Next.js 应用

   • 在 ~/apps 目录内执行（因该命令会自动创建项目文件夹）：

     • cd ~/apps
     • npx create-instant-app --next --codex --app --token

4. 初始化 Git 并创建 GitHub 仓库（如尚未完成）

   • 进入 ~/apps/ 目录后执行：

     • git init（若尚未初始化）
     • git add -A && git commit -m "Init"（如需首次提交）

     • gh repo create --private --source . --remote origin --push

       • 若用户明确要求公开仓库，请改用 --public 参数。

5. Vercel：创建/关联项目并部署

   • 进入 ~/apps/ 目录后执行：

     • vercel link（或根据 CLI 提示选择 vercel project add / vercel）
     • vercel --prod

6. 实现用户提出的变更需求

   • 在应用目录内，使用编码代理（如 Codex CLI 或同类工具）进行修改。
   • 建议采用小粒度、可审查的提交方式。

7. 提交并推送至 main 分支

   • git add -A
   • git commit -m ""
   • git push -u origin main

8. 部署更新版本

   • vercel --prod

工作流：编辑已有应用

1. cd ~/apps/
2. 阅读相关 AGENTS.md 文件。

3. 拉取最新代码：

   • git checkout main && git pull
4. 通过编码代理或常规编辑方式进行修改。
5. 按需执行测试与构建。
6. 提交更改并推送到 main 分支。
7. 部署至 Vercel：vercel --prod

环境变量（.env）

首次推送至 Vercel 时，平台很可能尚未配置任何环境变量。请使用 CLI 将本地 .env 文件中已有的环境变量同步至 Vercel。

注意事项与安全守则

• 若 create-instant-app 已自动创建了 GitHub 仓库及远程地址，则无需重复创建——仅需确认远程名为 origin，且 main 分支已推送。
• 若 Vercel 已完成项目关联，则无需再次执行 vercel link——直接部署即可。

沟通规范

当您开始使用本技能时，请首先发送消息：“Okay, getting ready to use my app builder skill”。

随后，在执行各关键步骤时，应定期向用户发送进度更新。构建一个应用需要一定时间，请让整个过程对用户而言轻松而有趣。