workflow-automation

name	workflow-automation
description	自动执行重复的开发任务和工作流程。在创建构建脚本、自动化部署或设置开发工作流程时使用。处理 npm 脚本、Makefile、GitHub Actions 工作流和任务自动化。
metadata	{"tags":"automation, scripts, workflow, npm-scripts, Makefile, task-runner","platforms":"Claude, ChatGPT, Gemini"}

工作流自动化

何时使用此技能

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

说明

步骤 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 "正在部署到生产环境..."
	./scripts/deploy.sh production

ci: lint test build ## 本地运行 CI 流水线
	@echo "✅ CI 流水线通过！"

用法：

make help        # 显示所有命令
make dev         # 启动开发环境
make ci          # 本地运行完整 CI

步骤 3：Husky + lint-staged（Git 钩子）

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 "正在运行提交前检查..."

# 检查暂存文件
npx lint-staged

# 类型检查
npm run type-check

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

echo "✅ 提交前检查通过！"

步骤 4：任务运行器脚本

scripts/dev-setup.sh：

#!/bin/bash
set -e

echo "🚀 正在设置开发环境..."

# 检查前置条件
if ! command -v node &> /dev/null; then
    echo "❌ 未安装 Node.js"
    exit 1
fi

if ! command -v docker &> /dev/null; then
    echo "❌ 未安装 Docker"
    exit 1
fi

# 安装依赖
echo "📦 正在安装依赖..."
npm install

# 复制环境文件
if [ ! -f .env ]; then
    echo "📄 正在创建 .env 文件..."
    cp .env.example .env
    echo "⚠️ 请用你的配置更新 .env"
fi

# 启动 Docker 服务
echo "🐳 正在启动 Docker 服务..."
docker-compose up -d

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

# 运行迁移
echo "🗄️ 正在运行数据库迁移..."
npm run migrate

# 种子数据（可选）
read -p "是否用示例数据填充数据库？(y/n) " -n 1 -r
echo
if [[ $REPLY =~ ^[Yy]$ ]]; then
    npm run seed
fi

echo 
 

scripts/deploy.sh：

#!/bin/bash
set -e

ENV=$1

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

echo "🚀 正在部署到 $ENV..."

# 构建
echo "📦 正在构建应用..."
npm run build

# 运行测试
echo "🧪 正在运行测试..."
npm test

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

echo "✅ 部署到 $ENV 完成！"

步骤 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: 设置 Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '18'
          cache: 'npm'

      - name: 安装依赖
        run: npm ci

      - name: 运行代码检查
        run: npm run lint

      - name: 类型检查
        run: npm run type-check

      - name: 运行测试
        run: npm test -- --coverage

        
         

输出格式

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

约束条件

必需规则（必须遵守）

1. 幂等性：脚本可以安全地多次运行
2. 错误处理：清晰的失败消息
3. 文档：关于如何使用脚本的注释

禁止事项（不得执行）

1. 硬编码密钥：不要在脚本中包含密码或 API 密钥
2. 破坏性命令：未经确认请勿运行 rm -rf

最佳实践

1. 使用 Make：与平台无关的接口
2. Git 钩子：自动化质量检查
3. CI/CD：使用 GitHub Actions 实现自动化

参考资料

• npm 脚本
• Make 教程
• Husky

元数据

版本

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

标签

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

示例

示例 1：基本用法

示例 2：高级用法