project-setup-git

通过 Git 设置项目（Clone/Pull）

概述

当用户请求使用 Git（git clone 或 git pull）设置或初始化项目，而不是使用 npx 命令创建新项目时，可使用此技能。此技能将指导 Agent 下载现有代码库、安装相应的依赖项、安全地完成基本配置，并运行项目，同时确保界面具有响应式布局。

依赖项

• 无

快速开始

使用示例： "使用 project-setup-git 技能，将仓库 https://github.com/example/repo 克隆到工作目录并安装所有依赖项。"

工作流

1. 克隆或更新仓库（Clone/Pull）

• 使用命令 git clone <url_repositori> . 将现有代码库克隆到当前工作目录。
• 如果该目录已经是有效的 Git 仓库，则使用命令 git pull 获取（fetch）并合并（merge）最新更改。

2. 检测并安装依赖项

• 检查根目录中是否存在 lockfile，以检测所用的 package manager：
  • 如果存在 package-lock.json，运行 npm install。
  • 如果存在 yarn.lock，运行 yarn install。
  • 如果存在 pnpm-lock.yaml，运行 pnpm install。

3. 环境配置（Environment Setup）

• 复制示例环境文件（例如，cp .env.example .env，或在 PowerShell/CMD 中使用相应的复制命令）。
• 请用户手动配置所需的环境变量。

4. 运行项目

• 使用命令 npm run dev 或与项目配置相符的启动命令启动开发服务器（development server）。

常见错误与关键规则

• 敏感凭据暴露：严禁在前端公开项目凭据（如 API key、密码、令牌），或通过客户端访问这些凭据。始终检查 .env 文件的安全性，并确保将其加入 .gitignore。
• 忽略响应式布局：设置完成后自定义 UI/布局时，忽略 mobile-view first 方法。界面必须从一开始就采用响应式设计。
• 错误检测 Package Manager：在包含 yarn.lock 或 pnpm-lock.yaml 的项目中运行 npm install，这可能会破坏项目依赖项的一致性。
• 使用 cd 命令：不要在提供给用户的命令行命令中使用 cd 命令切换终端目录；应在 tool run_command 配置中指定相应的当前工作目录（Cwd），并直接运行命令。