介绍
# App Builder
你可以访问： - `npx instant-cli` - `gh` - `vercel`
如果你使用这些工具，并且发现没有安装它们或尚未登录，请提示用户安装并登录。
所有应用都位于：`~/apps`
## 基本规则
- 始终在 `~/apps/<app-name>` 中创建/编辑项目。 - 在进行更改之前，请阅读仓库根目录下的 `AGENTS.md`；如果存在，还要阅读 `~/apps/<app-name>/AGENTS.md`。 - 目前，始终推送到 `main`。 - 每个应用必须： 1) 推送到 GitHub 2) 部署在 Vercel 上
## 工作流：创建新应用
1. **选择应用文件夹名称** - 确保 `~/apps` 存在。 - 项目最终将位于 `~/apps/<app-name>`。
2. **创建 Instant appId + token** - 运行： - `npx instant-cli init-without-files` - 捕获返回的 `appId` 和 `token`。
3. **生成 Next.js 应用** - 在 `~/apps` 内部运行此命令（因为该命令会创建项目文件夹）： - `cd ~/apps` - `npx create-instant-app <app-name> --next --codex --app <appId> --token <token>`
4. **初始化 git + GitHub 仓库（如果需要）** - 在 `~/apps/<app-name>` 中： - `git init`（如果尚未初始化） - `git add -A && git commit -m "Init"`（如果需要） - `gh repo create <repo-name> --private --source . --remote origin --push` - 如果用户请求，请使用 `--public`。
5. **Vercel：创建/链接项目并部署** - 在 `~/apps/<app-name>` 中： - `vercel link`（或根据提示使用 `vercel project add` / `vercel`） - `vercel --prod`
6. **实施请求的更改** - 在应用目录内使用编码代理（Codex CLI 或同等工具）进行更改。 - 优先使用小的、可审查的提交。
7. **提交 + 推送** - `git add -A` - `git commit -m "<clear message>"` - `git push -u origin main`
8. **部署更新** - `vercel --prod`
## 工作流：编辑现有应用
1. `cd ~/apps/<app-name>` 2. 阅读相关的 `AGENTS.md`。 3. 拉取最新代码： - `git checkout main && git pull` 4. 通过编码代理/常规编辑进行更改。 5. 适当地测试/构建。 6. 提交 + 推送到 `main`。 7. 部署到 Vercel (`vercel --prod`)。
## 环境变量 (.env)
当你首次推送到 vercel 时，它可能没有环境变量。使用 CLI 推送本地 .env 文件中已有的环境变量。
## 注意事项 / 防护措施
- 如果 `create-instant-app` 已经创建了仓库 + 远程仓库，请勿重新创建——只需确保 `origin` 存在并且 `main` 已推送。 - 如果 Vercel 已经链接，请勿重新链接——只需部署。
## 沟通
当你开始使用此技能时，请发送一条消息，说明“Okay, getting ready to use my app builder skill”。
然后在你取得进展时发送定期更新。构建应用需要一段时间。让用户感到有趣。