@gw-config-management（网关配置管理）

Configuration Management for gw

Configure and optimize gw-tools for different project types and team needs

What You'll Learn

This skill teaches you how to configure gw for optimal workflow in any project type. You'll learn:

• Configuration fundamentals - Understanding .gw/config.json structure and auto-detection
• IDE autocompletion - JSON Schema support for VS Code, JetBrains, and other editors
• Auto-copy strategies - Which files to copy automatically for different project types
• Hooks - Pre/post checkout commands for automated setup
• Project-specific patterns - Ready-to-use configs for Next.js, Node.js APIs, monorepos, and SPAs
• Team configuration - Sharing configs across teams and onboarding new developers
• Advanced techniques - Multiple source worktrees, environment-specific configs
• Troubleshooting - Solving common configuration issues

Installation

npx skills add https://github.com/mthines/gw-tools --skill

Select gw-config-management from the interactive menu.

Prerequisites

• gw CLI tool installed (installation guide)
• A project to configure (Next.js, Node.js, monorepo, etc.)
• Basic understanding of Git worktrees (git-worktree-workflows skill)

What's Included

Main Documentation

• SKILL.md - Comprehensive configuration guide

Project-Type Configuration Guides

• Next.js Config - For Next.js applications
• Node.js API Config - For backend APIs
• Monorepo Config - For monorepo projects
• React SPA Config - For React single-page apps

References (Lazy-loaded)

• Next.js Setup - Step-by-step Next.js configuration
• Monorepo Setup - Configuring for monorepos
• Troubleshooting - Common configuration problems

Quick Start

After installing this skill, try asking your AI agent:

"Configure gw for a Next.js project with Vercel"

"Set up auto-copy for my Node.js API with secrets"

"How should I configure gw for a monorepo with multiple packages?"

"Why aren't my environment files being copied?"

Quick Configuration

Option 1: Auto-Detection (Easiest)

cd /path/to/your/project
gw init

# gw will auto-detect:
# - Repository root
# - Default branch (main/master)
# - Creates config with $schema for IDE autocompletion

Option 2: Manual Configuration

gw init --root /path/to/repo.git \
        --default-source main \
        --auto-copy-files .env,.env.local,secrets/

Option 3: Use a Project-Type Guide

# Check the recommended config for your project type
# See: ./rules/project-types/nextjs.md (or nodejs-api.md, monorepo.md, react-spa.md)

# Then initialize with the recommended settings
gw init --auto-copy-files .env,.env.local,.vercel/

Option 4: With Hooks

gw init --auto-copy-files .env,secrets/ \
        --post-checkout "cd {worktreePath} && pnpm install"

Related Skills

• git-worktree-workflows - Learn worktree basics first
• autonomous-workflow - Autonomous feature development workflow

Common Configuration Patterns

Next.js Projects

• Copy: .env*, .vercel/, public/uploads/
• Skip: .next/, node_modules/

Node.js APIs

• Copy: .env, ssl/, keys/, secrets/
• Skip: node_modules/, dist/, build/

Monorepos

• Copy: Root .env, workspace configs, shared secrets
• Skip: Individual node_modules/, build outputs

React SPAs

• Copy: .env, .env.local, public/config.json
• Skip: build/, dist/, node_modules/

Need Help?

• Check the Troubleshooting Guide
• Review project-type guides
• Ask your AI agent with this skill loaded
• Open an issue in the main repository

_Part of the gw-tools skills collection_