工作流自动化实战指南：npm脚本、Makefile、Git钩子与任务脚本

workflow-automation by akillness/oh-my-skills

1 周安装量

3 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/akillness/oh-my-skills --skill workflow-automation

开发自动化工程/构建系统

🇨🇳中文介绍

工作流自动化

何时使用此技能

重复性任务：每次运行相同的命令
复杂构建：多步骤构建流程
团队入职：一致的开发环境

使用说明

步骤 1：npm 脚本

package.json：

{
  "scripts": {
    "dev": "nodemon src/index.ts",
    "build": "tsc && vite build",
    "test": "jest --coverage",
    "test:watch": "jest --watch",
    "lint": "eslint src --ext .ts,.tsx",
    "lint:fix": "eslint src --ext .ts,.tsx --fix",
    "format": "prettier --write \"src/**/*.{ts,tsx,json}\"",
    "type-check": "tsc --noEmit",
    "pre-commit": "lint-staged",
    "prepare": "husky install",
    "clean": "rm -rf dist node_modules",
    "reset": "npm run clean && npm install",
    "docker:build": "docker build -t myapp .",
    "docker:run": "docker run -p 3000:3000 myapp"
  }
}

步骤 2：Makefile

Makefile：

.PHONY: help install dev build test clean docker

.DEFAULT_GOAL := help

help: ## 显示此帮助信息
	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-20s\033[0m %s\n", $$1, $$2}'

install: ## 安装依赖
	npm install

dev: ## 启动开发服务器
	npm run dev

build: ## 构建生产版本
	npm run build

test: ## 运行所有测试
	npm test

lint: ## 运行代码检查
	npm run lint

lint-fix: ## 修复代码检查问题
	npm run lint:fix

clean: ## 清理构建产物
	rm -rf dist coverage

docker-build: ## 构建 Docker 镜像
	docker build -t myapp:latest .

docker-run: ## 运行 Docker 容器
	docker run -d -p 3000:3000 --name myapp myapp:latest

deploy: build ## 部署到生产环境
	@echo "Deploying to production..."
	./scripts/deploy.sh production

ci: lint test build ## 本地运行 CI 流水线
	@echo "✅ CI pipeline passed!"

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

步骤 3：Husky + lint-staged (Git 钩子)

{
  "lint-staged": {
    "*.{ts,tsx}": [
      "eslint --fix",
      "prettier --write"
    ],
    "*.{json,md}": [
      "prettier --write"
    ]
  }
}

.husky/pre-commit：

#!/usr/bin/env sh
. "$(dirname -- "$0")/_/husky.sh"

echo "Running pre-commit checks..."

# 检查暂存文件
npx lint-staged

# 类型检查
npm run type-check

# 运行与更改文件相关的测试
npm test -- --onlyChanged

echo "✅ Pre-commit checks passed!"

步骤 4：任务运行器脚本

scripts/dev-setup.sh：

#!/bin/bash
set -e

echo "🚀 Setting up development environment..."

# 检查先决条件
if ! command -v node &> /dev/null; then
    echo "❌ Node.js is not installed"
    exit 1
fi

if ! command -v docker &> /dev/null; then
    echo "❌ Docker is not installed"
    exit 1
fi

# 安装依赖
echo "📦 Installing dependencies..."
npm install

# 复制环境文件
if [ ! -f .env ]; then
    echo "📄 Creating .env file..."
    cp .env.example .env
    echo "⚠️ Please update .env with your configuration"
fi

# 启动 Docker 服务
echo "🐳 Starting Docker services..."
docker-compose up -d

# 等待数据库
echo "⏳ Waiting for database..."
./scripts/wait-for-it.sh localhost:5432 --timeout=30

# 运行数据库迁移
echo "🗄️ Running database migrations..."
npm run migrate

# 填充数据（可选）
read -p "Seed database with sample data? (y/n) " -n 1 -r
echo
if [[ $REPLY =~ ^[Yy]$ ]]; then
    npm run seed
fi

echo "✅ Development environment ready!"
echo "Run 'make dev' to start the development server"

scripts/deploy.sh：

#!/bin/bash
set -e

ENV=$1

if [ -z "$ENV" ]; then
    echo "Usage: ./deploy.sh [staging|production]"
    exit 1
fi

echo "🚀 Deploying to $ENV..."

# 构建
echo "📦 Building application..."
npm run build

# 运行测试
echo "🧪 Running tests..."
npm test

# 根据环境部署
if [ "$ENV" == "production" ]; then
    echo "🌍 Deploying to production..."
    # 生产环境部署逻辑
    ssh production "cd /app && git pull && npm install && npm run build && pm2 restart all"
elif [ "$ENV" == "staging" ]; then
    echo "🧪 Deploying to staging..."
    # 预发布环境部署逻辑
    ssh staging "cd /app && git pull && npm install && npm run build && pm2 restart all"
fi

echo "✅ Deployment to $ENV completed!"

步骤 5：GitHub Actions 工作流自动化

.github/workflows/ci.yml：

name: CI

on:
  push:
    branches: [main, develop]
  pull_request:
    branches: [main]

jobs:
  test:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v4

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '18'
          cache: 'npm'

      - name: Install dependencies
        run: npm ci

      - name: Run linter
        run: npm run lint

      - name: Type check
        run: npm run type-check

      - name: Run tests
        run: npm test -- --coverage

      - name: Upload coverage
        uses: codecov/codecov-action@v3

project/
├── scripts/
│   ├── dev-setup.sh
│   ├── deploy.sh
│   ├── test.sh
│   └── cleanup.sh
├── Makefile
├── package.json
└── .husky/
    ├── pre-commit
    └── pre-push

必需规则 (必须遵守)

幂等性：脚本可安全地多次运行
错误处理：失败时提供清晰信息
文档：包含如何使用脚本的注释

禁止事项 (严禁)

硬编码密钥：脚本中不得包含密码或 API 密钥
破坏性命令：未经确认不得运行 rm -rf

使用 Make：平台无关的接口
Git 钩子：自动化质量检查
CI/CD：使用 GitHub Actions 自动化

-- 当前版本：1.0.0 -- 最后更新：2025-01-01 -- 兼容平台：Claude, ChatGPT, Gemini

#automation #scripts #workflow #npm-scripts #Makefile #utilities

示例 1：基础用法

示例 2：高级用法

🇺🇸English

Workflow Automation

When to use this skill

Repetitive tasks : running the same commands every time
Complex builds : multi-step build processes
Team onboarding : a consistent development environment

Instructions

Step 1: npm scripts

package.json :

{
  "scripts": {
    "dev": "nodemon src/index.ts",
    "build": "tsc && vite build",
    "test": "jest --coverage",
    "test:watch": "jest --watch",
    "lint": "eslint src --ext .ts,.tsx",
    "lint:fix": "eslint src --ext .ts,.tsx --fix",
    "format": "prettier --write \"src/**/*.{ts,tsx,json}\"",
    "type-check": "tsc --noEmit",
    "pre-commit": "lint-staged",
    "prepare": "husky install",
    "clean": "rm -rf dist node_modules",
    "reset": "npm run clean && npm install",
    "docker:build": "docker build -t myapp .",
    "docker:run": "docker run -p 3000:3000 myapp"
  }
}

Step 2: Makefile

Makefile :

.PHONY: help install dev build test clean docker

.DEFAULT_GOAL := help

help: ## Show this help
	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-20s\033[0m %s\n", $$1, $$2}'

install: ## Install dependencies
	npm install

dev: ## Start development server
	npm run dev

build: ## Build for production
	npm run build

test: ## Run all tests
	npm test

lint: ## Run linter
	npm run lint

lint-fix: ## Fix linting issues
	npm run lint:fix

clean: ## Clean build artifacts
	rm -rf dist coverage

docker-build: ## Build Docker image
	docker build -t myapp:latest .

docker-run: ## Run Docker container
	docker run -d -p 3000:3000 --name myapp myapp:latest

deploy: build ## Deploy to production
	@echo "Deploying to production..."
	./scripts/deploy.sh production

ci: lint test build ## Run CI pipeline locally
	@echo "✅ CI pipeline passed!"

Usage :

make help        # Show all commands
make dev         # Start development
make ci          # Run full CI locally

Step 3: Husky + lint-staged (Git Hooks)

package.json :

{
  "lint-staged": {
    "*.{ts,tsx}": [
      "eslint --fix",
      "prettier --write"
    ],
    "*.{json,md}": [
      "prettier --write"
    ]
  }
}

.husky/pre-commit :

#!/usr/bin/env sh
. "$(dirname -- "$0")/_/husky.sh"

echo "Running pre-commit checks..."

# Lint staged files
npx lint-staged

# Type check
npm run type-check

# Run tests related to changed files
npm test -- --onlyChanged

echo "✅ Pre-commit checks passed!"

Step 4: Task Runner scripts

scripts/dev-setup.sh :

#!/bin/bash
set -e

echo "🚀 Setting up development environment..."

# Check prerequisites
if ! command -v node &> /dev/null; then
    echo "❌ Node.js is not installed"
    exit 1
fi

if ! command -v docker &> /dev/null; then
    echo "❌ Docker is not installed"
    exit 1
fi

# Install dependencies
echo "📦 Installing dependencies..."
npm install

# Copy environment file
if [ ! -f .env ]; then
    echo "📄 Creating .env file..."
    cp .env.example .env
    echo "⚠️ Please update .env with your configuration"
fi

# Start Docker services
echo "🐳 Starting Docker services..."
docker-compose up -d

# Wait for database
echo "⏳ Waiting for database..."
./scripts/wait-for-it.sh localhost:5432 --timeout=30

# Run migrations
echo "🗄️ Running database migrations..."
npm run migrate

# Seed data (optional)
read -p "Seed database with sample data? (y/n) " -n 1 -r
echo
if [[ $REPLY =~ ^[Yy]$ ]]; then
    npm run seed
fi

echo "✅ Development environment ready!"
echo "Run 'make dev' to start the development server"

scripts/deploy.sh :

#!/bin/bash
set -e

ENV=$1

if [ -z "$ENV" ]; then
    echo "Usage: ./deploy.sh [staging|production]"
    exit 1
fi

echo "🚀 Deploying to $ENV..."

# Build
echo "📦 Building application..."
npm run build

# Run tests
echo "🧪 Running tests..."
npm test

# Deploy based on environment
if [ "$ENV" == "production" ]; then
    echo "🌍 Deploying to production..."
    # Production deployment logic
    ssh production "cd /app && git pull && npm install && npm run build && pm2 restart all"
elif [ "$ENV" == "staging" ]; then
    echo "🧪 Deploying to staging..."
    # Staging deployment logic
    ssh staging "cd /app && git pull && npm install && npm run build && pm2 restart all"
fi

echo "✅ Deployment to $ENV completed!"

Step 5: GitHub Actions workflow automation

.github/workflows/ci.yml :

name: CI

on:
  push:
    branches: [main, develop]
  pull_request:
    branches: [main]

jobs:
  test:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v4

      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '18'
          cache: 'npm'

      - name: Install dependencies
        run: npm ci

      - name: Run linter
        run: npm run lint

      - name: Type check
        run: npm run type-check

      - name: Run tests
        run: npm test -- --coverage

      - name: Upload coverage
        uses: codecov/codecov-action@v3

Output format

project/
├── scripts/
│   ├── dev-setup.sh
│   ├── deploy.sh
│   ├── test.sh
│   └── cleanup.sh
├── Makefile
├── package.json
└── .husky/
    ├── pre-commit
    └── pre-push

Constraints

Required rules (MUST)

Idempotency : safe to run scripts multiple times
Error handling : clear messages on failure
Documentation : comments on how to use the scripts

Prohibited items (MUST NOT)

Hardcoded secrets : do not include passwords or API keys in scripts
Destructive commands : do not run rm -rf without confirmation

Best practices

Use Make : platform-agnostic interface
Git Hooks : automated quality checks
CI/CD : automated with GitHub Actions

References

Metadata

Version

-- Current version : 1.0.0 -- Last updated : 2025-01-01 -- Compatible platforms : Claude, ChatGPT, Gemini

Examples

Example 1: Basic usage

Example 2: Advanced usage

Weekly Installs

Repository

akillness/oh-my-skills

GitHub Stars

First Seen

1 day ago

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

mcpjam1

claude-code1

junie1

windsurf1

zencoder1

crush1

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

150,000 周安装