跳到主内容
智客 ZICQ

技能库 智客分类:Agent 工作流 environment-setup-guide

Environment Setup Guide

通过建立具有适当工具、依赖性和配置的开发环境来引导开发者

610 安装量

官方网址:skills.sh

技能介绍

先看中文介绍;官方 description 原文单独保留,不改写 SKILL.md。

做什么

通过建立具有适当工具、依赖性和配置的开发环境来引导开发者

何时用

这个技能

代理如何加载

按 Agent Skills 渐进披露:启动时只加载 name 与 description(约 100 token);任务匹配后才读入整份 SKILL.md 正文;scripts/、references/、assets/ 仅在需要时再读。 本文件正文结构:Environment Setup Guide、Overview、When to Use This Skill、How It Works、Step 1: Identify Requirements、Step 2: Check Current Setup。 其中含规范建议的小节:分步指令、输入输出示例。

文件分析

文件分析:这是一份仅含 SKILL.md 的指令型技能,代理激活后整份正文进入上下文。

官方 description(原文)

Guide developers through setting up development environments with proper tools, dependencies, and configurations

Environment Setup GuideOverviewWhen to Use This SkillHow It WorksStep 1: Identify RequirementsStep 2: Check Current SetupCheck versions of installed toolsStep 3: Provide Installation InstructionsStep 4: Configure the EnvironmentStep 5: Verify InstallationExamplesExample 1: Node.js Project Setup

来源分类:skills.sh agent-skill

SKILL.md 与 Agent 调用

官方规范 ↗
name
environment-setup-guide
description
Guide developers through setting up development environments with proper tools, dependencies, and configurations
  1. 发现技能客户端向 Agent 提供名称与描述目录。
  2. 匹配与调用用户指定或任务匹配后,载入 SKILL.md 指令。
  3. 按需加载按步骤读取参考文档、使用脚本与素材。

具体调用语法与可用工具以目标 Agent 客户端为准。 查看调用机制说明 ↗

安装这个技能

Skills CLI ↗

先选择目标 Agent 和安装范围,保留技能包的附属文件,安装后检查客户端能否发现该技能。

交给 Agent 安装

复制安装指令给支持 Agent Skills 的代理,确认其中的目标目录与客户端匹配。

把 Agent Skill「environment-setup-guide」安装到我的项目:SKILL.md 原文与官方 description 见 https://zicq.com/zh/skills/skl-0f9982e6a4a897a1-%E7%8E%AF%E5%A2%83%E8%AE%BE%E7%BD%AE%E6%8C%87%E5%8D%97.html
请存为 .cursor/skills/environment-setup-guide/SKILL.md 或 .claude/skills/environment-setup-guide/SKILL.md,frontmatter 的 name 与 description 保持原样,不要改写。

GitHub 完整包 ↗

终端安装 · Skills CLI

需要 Node.js 与 npx。先查看仓库技能列表,确认实际名称。

npx skills add 'https://github.com/sickn33/agentic-awesome-skills' --list

npx skills add 'https://github.com/sickn33/agentic-awesome-skills' --skill 'environment-setup-guide'

CLI 会交互选择目标 Agent,默认安装到项目;用户级安装使用 -g。先通过查看命令核对仓库内容,再用 npx skills list 检查已安装技能。

阅读排版
--- name: environment-setup-guide description: "Guide developers through setting up development environments with proper tools, dependencies, and configurations" risk: critical source: community date_added: "2026-02-27" --- # Environment Setup Guide ## Overview Help developers set up complete development environments from scratch. This skill provides step-by-step guidance for installing tools, configuring dependencies, setting up environment variables, and verifying the setup works correctly. ## When to Use This Skill - Use when starting a new project and need to set up the development environment - Use when onboarding new team members to a project - Use when switching to a new machine or operating system - Use when troubleshooting environment-related issues - Use when documenting setup instructions for a project - Use when creating development environment documentation ## How It Works ### Step 1: Identify Requirements I'll help you determine what needs to be installed: - Programming language and version (Node.js, Python, Go, etc.) - Package managers (npm, pip, cargo, etc.) - Database systems (PostgreSQL, MongoDB, Redis, etc.) - Development tools (Git, Docker, IDE extensions, etc.) - Environment variables and configuration files ### Step 2: Check Current Setup Before installing anything, I'll help you check what's already installed: ```bash # Check versions of installed tools node --version python --version git --version docker --version ``` ### Step 3: Provide Installation Instructions I'll give platform-specific installation commands: - **macOS:** Using Homebrew - **Linux:** Using apt, yum, or package manager - **Windows:** Using Chocolatey, Scoop, or direct installers ### Step 4: Configure the Environment Help set up: - Environment variables (.env files) - Configuration files (.gitconfig, .npmrc, etc.) - IDE settings (VS Code, IntelliJ, etc.) - Shell configuration (.bashrc, .zshrc, etc.) ### Step 5: Verify Installation Provide verification steps to ensure everything works: - Run version checks - Test basic commands - Verify database connections - Check environment variables are loaded ## Examples ### Example 1: Node.js Project Setup ```markdown ## Setting Up Node.js Development Environment ### Prerequisites - macOS, Linux, or Windows - Terminal/Command Prompt access - Internet connection ### Step 1: Install Node.js **macOS (using Homebrew):** \`\`\`bash # Install Homebrew if not installed tmpdir="$(mktemp -d)" trap 'rm -rf "$tmpdir"' EXIT curl -fsSLo "$tmpdir/homebrew-install.sh" https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh cat "$tmpdir/homebrew-install.sh" # review the full installer before executing /bin/bash "$tmpdir/homebrew-install.sh" # Install Node.js brew install node \`\`\` **Linux (Ubuntu/Debian):** \`\`\`bash # Update package list sudo apt update # Install Node.js and npm tmpdir="$(mktemp -d)" trap 'rm -rf "$tmpdir"' EXIT curl -fsSLo "$tmpdir/nodesource-setup.sh" https://deb.nodesource.com/setup_20.x cat "$tmpdir/nodesource-setup.sh" # review the full installer before sudo sudo -E bash "$tmpdir/nodesource-setup.sh" sudo apt install -y nodejs \`\`\` **Windows (using winget):** \`\`\`powershell # Install Node.js winget install OpenJS.NodeJS.LTS \`\`\` ### Step 2: Verify Installation \`\`\`bash node --version # Should show v20.x.x or higher npm --version # Should show 10.x.x or higher \`\`\` ### Step 3: Install Project Dependencies \`\`\`bash # Clone the repository git clone https://github.com/your-repo/project.git cd project # Install dependencies npm install \`\`\` ### Step 4: Set Up Environment Variables Create a \`.env\` file: \`\`\`bash # Copy example environment file cp .env.example .env # Edit with your values nano .env \`\`\` Example \`.env\` content: \`\`\` NODE_ENV=development PORT=3000 DATABASE_URL=postgresql://localhost:5432/mydb API_KEY=your-api-key-here \`\`\` ### Step 5: Run the Project \`\`\`bash # Start development server npm run dev # Should see: Server running on http://localhost:3000 \`\`\` ### Troubleshooting **Problem:** "node: command not found" **Solution:** Restart your terminal or run \`source ~/.bashrc\` (Linux) or \`source ~/.zshrc\` (macOS) **Problem:** "Permission denied" errors **Solution:** Don't use sudo with npm. Fix permissions: \`\`\`bash mkdir ~/.npm-global npm config set prefix '~/.npm-global' echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc source ~/.bashrc \`\`\` ``` ### Example 2: Python Project Setup ```markdown ## Setting Up Python Development Environment ### Step 1: Install Python **macOS:** \`\`\`bash brew install [email protected] \`\`\` **Linux:** \`\`\`bash sudo apt update sudo apt install python3.11 python3.11-venv python3-pip \`\`\` **Windows:** \`\`\`powershell choco install python --version=3.11 \`\`\` ### Step 2: Verify Installation \`\`\`bash python3 --version # Should show Python 3.11.x pip3 --version # Should show pip 23.x.x \`\`\` ### Step 3: Create Virtual Environment \`\`\`bash # Navigate to project directory cd my-project # Create virtual environment python3 -m venv venv # Activate virtual environment # macOS/Linux: source venv/bin/activate # Windows: venv\Scripts\activate \`\`\` ### Step 4: Install Dependencies \`\`\`bash # Install from requirements.txt pip install -r requirements.txt # Or install packages individually pip install flask sqlalchemy python-dotenv \`\`\` ### Step 5: Set Up Environment Variables Create \`.env\` file: \`\`\` FLASK_APP=app.py FLASK_ENV=development DATABASE_URL=sqlite:///app.db SECRET_KEY=your-secret-key-here \`\`\` ### Step 6: Run the Application \`\`\`bash # Run Flask app flask run # Should see: Running on http://127.0.0.1:5000 \`\`\` ``` ### Example 3: Docker Development Environment ```markdown ## Setting Up Docker Development Environment ### Step 1: Install Docker **macOS:** \`\`\`bash brew install --cask docker # Or download Docker Desktop from docker.com \`\`\` **Linux:** \`\`\`bash # Install Docker curl -fsSL https://get.docker.com -o get-docker.sh sudo sh get-docker.sh # Add user to docker group sudo usermod -aG docker $USER newgrp docker \`\`\` **Windows:** Download Docker Desktop from docker.com ### Step 2: Verify Installation \`\`\`bash docker --version # Should show Docker version 24.x.x docker-compose --version # Should show Docker Compose version 2.x.x \`\`\` ### Step 3: Create docker-compose.yml \`\`\`yaml version: '3.8' services: app: build: . ports: - "3000:3000" environment: - NODE_ENV=development - DATABASE_URL=postgresql://postgres:password@db:5432/mydb volumes: - .:/app - /app/node_modules depends_on: - db db: image: postgres:15 environment: - POSTGRES_USER=postgres - POSTGRES_PASSWORD=password - POSTGRES_DB=mydb ports: - "5432:5432" volumes: - postgres_data:/var/lib/postgresql/data volumes: postgres_data: \`\`\` ### Step 4: Start Services \`\`\`bash # Build and start containers docker-compose up -d # View logs docker-compose logs -f # Stop services docker-compose down \`\`\` ### Step 5: Verify Services \`\`\`bash # Check running containers docker ps # Test database connection docker-compose exec db psql -U postgres -d mydb \`\`\` ``` ## Best Practices ### ✅ Do This - **Document Everything** - Write clear setup instructions - **Use Version Managers** - nvm for Node, pyenv for Python - **Create .env.example** - Show required environment variables - **Test on Clean System** - Verify instructions work from scratch - **Include Troubleshooting** - Document common issues and solutions - **Use Docker** - For consistent environments across machines - **Pin Versions** - Specify exact versions in package files - **Automate Setup** - Create setup scripts when possible - **Check Prerequisites** - List required tools before starting - **Provide Verification Steps** - Help users confirm setup works ### ❌ Don't Do This - **Don't Assume Tools Installed** - Always check and provide install instructions - **Don't Skip Environment Variables** - Document all required variables - **Don't Use Sudo with npm** - Fix permissions instead - **Don't Forget Platform Differences** - Provide OS-specific instructions - **Don't Leave Out Verification** - Always include test steps - **Don't Use Global Installs** - Prefer local/virtual environments - **Don't Ignore Errors** - Document how to handle common errors - **Don't Skip Database Setup** - Include database initialization steps ## Common Pitfalls ### Problem: "Command not found" after installation **Symptoms:** Installed tool but terminal doesn't recognize it **Solution:** - Restart terminal or source shell config - Check PATH environment variable - Verify installation location ```bash # Check PATH echo $PATH # Add to PATH (example) export PATH="/usr/local/bin:$PATH" ``` ### Problem: Permission errors with npm/pip **Symptoms:** "EACCES" or "Permission denied" errors **Solution:** - Don't use sudo - Fix npm permissions or use nvm - Use virtual environments for Python ```bash # Fix npm permissions mkdir ~/.npm-global npm config set prefix '~/.npm-global' echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc ``` ### Problem: Port already in use **Symptoms:** "Port 3000 is already in use" **Solution:** - Find and kill process using the port - Use a different port ```bash # Find process on port 3000 lsof -i :3000 # Kill process kill -9 # Or use different port PORT=3001 npm start ``` ### Problem: Database connection fails **Symptoms:** "Connection refused" or "Authentication failed" **Solution:** - Verify database is running - Check connection string - Verify credentials ```bash # Check if PostgreSQL is running sudo systemctl status postgresql # Test connection psql -h localhost -U postgres -d mydb ``` ## Setup Script Template Create a `setup.sh` script to automate setup: ```bash #!/bin/bash echo "🚀 Setting up development environment..." # Check prerequisites command -v node >/dev/null 2>&1 || { echo "❌ Node.js not installed"; exit 1; } command -v git >/dev/null 2>&1 || { echo "❌ Git not installed"; exit 1; } echo "✅ Prerequisites check passed" # Install dependencies echo "📦 Installing dependencies..." npm install # Copy environment file if [ ! -f .env ]; then echo "📝 Creating .env file..." cp .env.example .env echo "⚠️ Please edit .env with your configuration" fi # Run database migrations echo "🗄️ Running database migrations..." npm run migrate # Verify setup echo "🔍 Verifying setup..." npm run test:setup echo "✅ Setup complete! Run 'npm run dev' to start" ``` ## Related Skills - `@brainstorming` - Plan environment requirements before setup - `@systematic-debugging` - Debug environment issues - `@doc-coauthoring` - Create setup documentation - `@git-pushing` - Set up Git configuration ## Additional Resources - [Node.js Installation Guide](https://nodejs.org/en/download/) - [Python Virtual Environments](https://docs.python.org/3/tutorial/venv.html) - [Docker Documentation](https://docs.docker.com/get-started/) - [Homebrew (macOS)](https://brew.sh/) - [Chocolatey (Windows)](https://chocolatey.org/) - [nvm (Node Version Manager)](https://github.com/nvm-sh/nvm) - [pyenv (Python Version Manager)](https://github.com/pyenv/pyenv) --- **Pro Tip:** Create a `setup.sh` or `setup.ps1` script to automate the entire setup process. Test it on a clean system to ensure it works! ## Limitations - Use this skill only when the task clearly matches the scope described above. - Do not treat the output as a substitute for environment-specific validation, testing, or expert review. - Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.

相关技能

Agent 工作流

Skill Creator

创造有效技能指南。 当用户想创造出新的技能(或更新现有的技能),以专业知识,工作流程,或工具集成来扩展克洛德的能力时,应该使用这种技能.

Agent 工作流

Clawdhub

使用ClawdHub CLI搜索,安装,更新并发布从taladhub.com的代理技能. 需要获取苍蝇上的新技能时使用,将安装的技能同步到最新版本或特定版本,或者发布 npm-instainddhub CLI 的新/更新的技能文件夹.

Agent 工作流

Agent Team Orchestration

管弦乐团多代理团队,任务设定周期,交接协议,审查工作流程. 使用时间: (1)建立2+特派员队伍,具有不同专业,(2)确定任务路线和生命周期(收录框_ spec_建设_审查_完成),(3)在特派员之间制定交接协议,(4)建立审查和质量关口,(5)管理特派员之间的交流和文物共享.

Agent 工作流

Superpowers

Spec-first,TDD,子代理驱动的软件开发工作流程. 当:(1)构建任何新功能或应用——触发脑暴_计划_子代理执行回路,(2)调试出一个bug或测试失败——触发系统性的根起过程,(3)用户说"让我们构建","帮助我计划","我想添加X",或"这个被打破",(4)完成一个功…