SKILL.md — CI/CD Templates Generator

Identity

Name: CI/CD Templates Generator (cicd-gen) Type: CLI Tool + OpenClaw Skill Purpose: 一键生成生产级 CI/CD workflow 文件（GitHub Actions / GitLab CI / Jenkins） Author: kay Version: 1.0.0

Triggers

cicd-gen <language> [framework] [options]

触发词示例：

• "生成 Python Flask CI/CD workflow"
• "创建 GitHub Actions workflow for pytest + Docker"
• "GitLab CI for Node.js + Jest"
• "Generate Jenkinsfile for Go + goreleaser"
• "多平台 CI/CD: Python + pytest + Docker"
• "帮我创建一个 CI/CD workflow"
• "CI/CD 模板生成"

Capabilities

支持的语言与框架

支持的场景

• 定时任务 (cron): 集成于 GitHub Actions on.schedule
• PR 测试: 集成于 on.pull_request
• 自动发布: goreleaser / npm publish
• 多平台矩阵: 同时输出 GitHub Actions + GitLab CI + Jenkinsfile
• Docker 构建推送: docker build + push 到 Docker Hub
• 云部署: Azure Web App / 阿里云 ECS / 腾讯云 / Kubernetes / Serverless

CLI Usage

# 基本用法
cicd-gen python flask --test pytest --output ./.github/workflows/

# Python + pytest + Docker
cicd-gen python flask --test pytest --deploy docker

# Python + pytest + Docker + Azure 部署
cicd-gen python flask --test pytest --deploy docker --cloud azure

# Python + unittest + 覆盖率
cicd-gen python django --test unittest --coverage

# JavaScript + Jest
cicd-gen javascript node --test jest

# JavaScript + Jest + Docker + npm 发布
cicd-gen javascript node --test jest --deploy docker --release npm

# Go + goreleaser
cicd-gen go gin --test go-test --release goreleaser

# 多平台输出
cicd-gen python flask --test pytest --format all

# 仅打印不写文件
cicd-gen python flask --test pytest --print-only

# 自定义版本
cicd-gen python flask --test pytest --python-version 3.10 --name "My CI"

参数说明

Installation

pip install cicd-gen
# 或本地安装
cd cicd-templates-generator && pip install -e .

Technical Details

• 语言: Python 3.8+
• 依赖: pyyaml
• CLI 入口: cicd-gen
• 代码行数: 单文件 ≤ 500 行（generator 模块各自独立）
• 测试: 25 个单元测试，全部通过

输出示例

GitHub Actions (.github/workflows/ci.yml)

name: CI
on:
  push:
    branches: [main, master]
  pull_request:
    branches: [main, master]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      - name: Set up Python 3.11
        uses: actions/setup-python@v5
        with:
          python-version: '3.11'
      - name: Install dependencies
        run: pip install -r requirements.txt pytest
      - name: Run tests
        run: pytest
      - name: Log in to Docker Hub
        uses: docker/login-action@v3
        with:
          username: ${{ secrets.DOCKERHUB_USERNAME }}
          password: ${{ secrets.DOCKERHUB_TOKEN }}
      - name: Build and push Docker image
        uses: docker/build-push-action@v5
        with:
          context: .
          push: true
          tags: ${{ secrets.DOCKERHUB_USERNAME }}/app:latest

文件结构

cicd-templates-generator/
├── cicd_gen/
│   ├── __init__.py
│   ├── cli.py                    # CLI 入口
│   └── generator/
│       ├── __init__.py           # BaseGenerator
│       ├── github_actions.py     # GitHub Actions 生成器
│       ├── gitlab_ci.py          # GitLab CI 生成器
│       └── jenkins.py            # Jenkinsfile 生成器
├── tests/
│   └── test_cicd_gen.py          # 单元测试
├── setup.py
├── SKILL.md
└── DESIGN-cicd-templates-generator.md

Integration with OpenClaw

当用户请求创建 CI/CD workflow 时：

1. 解析用户意图（语言、框架、需求）
2. 调用 cicd-gen CLI 生成对应 workflow
3. 展示生成结果（--print-only 模式）
4. 可选：写入项目目录

# 示例调用
cicd-gen python flask --test pytest --deploy docker --print-only