SuperAPI AI 工具集

project-setup-git

编程与开发

查看项目

更新于 10-16 09:21

技能介绍

用途

Project Setup via Git (Clone/Pull) 技能用于通过 Git 方式搭建或初始化已有项目。当用户希望用 git clone 或 git pull 获取现有代码库,而不是用 npx 命令创建新项目时,适合使用该技能。它会引导智能体下载已有代码库、安装对应依赖、以安全方式完成基础配置,并运行具有响应式界面的项目。

主要能力

  • 克隆或更新代码库:使用 git clone <仓库URL> . 把已有代码库克隆到当前工作目录;若当前目录已是活动的 Git 仓库,则使用 git pull 拉取并合并最新改动。
  • 检测并安装依赖:检查根目录中的锁文件来判断所用包管理器。存在 package-lock.json 时执行 npm install;存在 yarn.lock 时执行 yarn install;存在 pnpm-lock.yaml 时执行 pnpm install。
  • 环境配置:复制环境示例文件(例如 cp .env.example .env,或 PowerShell/CMD 下相应的复制命令),并请用户手动配置所需的环境变量。
  • 运行项目:使用 npm run dev 或与项目配置相符的启动命令启动开发服务器。

使用方式

示例用法: “使用 project-setup-git 技能把仓库 https://github.com/example/repo 克隆到工作目录并安装其全部依赖。”

工作流程依次为:克隆或拉取仓库、检测并安装依赖、配置环境、执行项目。

适用场景

适用于需要基于已有 Git 代码库进行项目搭建、依赖安装、环境配置和本地运行的场景,尤其是用户明确要求以 clone/pull 而非 npx 新建项目时。

限制与注意事项

  • 敏感凭据暴露:严禁让项目凭据(如 API key、密码、令牌)在前端公开暴露或通过客户端访问。须始终检查 .env 文件的安全性,并确保其被纳入 .gitignore。
  • 忽视响应式界面:在搭建后进行 UI/布局定制时,不可忽略移动优先(mobile-view first)的做法,界面应从一开始就按响应式设计。
  • 错误识别包管理器:在含有 yarn.lock 或 pnpm-lock.yaml 的项目中执行 npm install,可能破坏依赖一致性。
  • cd 命令使用:在给用户的命令行中不要用 cd 命令切换目录,而应在 tool 配置 run_command 中对应的当前工作目录(Cwd)直接执行命令。

依赖项:无。