用途
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)直接执行命令。
依赖项:无。