应用构建器

您可以使用以下工具：

• npx instant-cli
• gh
• vercel

如果您使用这些工具时发现尚未安装或未登录，请提示用户进行安装和登录。

所有应用都位于：~/apps

基本规则

• 始终在以下目录中创建/编辑项目：~/apps/<应用名称>。
• 在进行更改之前，请阅读仓库根目录下的AGENTS.md文件；如果存在，也请阅读~/apps/<应用名称>/AGENTS.md文件。
• 目前，始终推送至main分支。
• 每个应用必须：
  1. 推送至 GitHub
  2. 部署在 Vercel 上

工作流程：创建一个新应用

1. 选择一个应用文件夹名称

   • 确保~/apps目录存在。
   • 项目最终将位于~/apps/<应用名称>。

2. 创建一个即时应用ID和令牌

   • 运行：
     • npx instant-cli init-without-files
   • 捕获返回的应用ID和令牌。

3. 生成Next.js应用

   • 在~/apps目录内运行此命令（因为该命令会创建项目文件夹）：
     • cd ~/apps
     • npx create-instant-app <应用名称> --next --codex --app <应用ID> --token <令牌>

4. 初始化git和GitHub仓库（如果需要）

   • 在~/apps/<应用名称>git init
     • （如果尚未初始化）git add -A && git commit -m "Init"
     • （如果需要）gh repo create <repo-name> --private --source . --remote origin --push
     • 如果用户要求，请使用
       • --public选项。Vercel：创建/链接项目并部署

5. 从

   • ~/apps/<app-name>目录：vercel link
     • （或根据提示使用vercel project add/vercel）vercel --prod
     • 实施请求的更改

6. 在应用目录内使用编码代理（如 Codex CLI 或等效工具）进行更改。

   • 优先采用小型的、可审查的提交。
   • 提交 + 推送（到主分支）

7. Commit + push (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 文件中已有的环境变量。

注意事项 / 防护措施

• 如果create-instant-app已经创建了仓库和远程，请不要重新创建——只需确保origin存在且main分支已推送。
• 如果Vercel已经连接，请不要重新连接——直接部署。

沟通

当你开始使用此技能时，发送一条消息说"好的，准备使用我的应用构建技能"。

然后在进展过程中定期发送更新。构建应用需要一段时间。让用户感到有趣。