К основному содержанию
скилл CX Codex

devops-excellence — скилл для Claude Code: что делает и как установить

Скилл devops-excellence задаёт строгие правила DevOps: запрещает root в контейнерах, убирает секреты из сборки и настраивает OIDC в GitHub Actions.

MIT 114 установок ★ 300 обновлён 2026-10-23

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add majiayu000/spellbook --skill devops-excellence -a claude-code
Открыть на GitHub

Что делает devops-excellence

Скилл внедряет в ассистента набор жестких инженерных правил для инфраструктурного кода. Он категорически запрещает запуск Docker-контейнеров от имени root, упаковку секретов в слои образов или build-args и статичные ключи облачных провайдеров вроде AWS IAM. Вместо этого агент переключается на аутентификацию через OIDC, использование выделенных пользователей с UID выше 1000 и runtime-монтирование конфигов.

Внутрь зашиты практические матрицы выбора: паттерны развёртывания (Rolling, Blue-Green, Canary, Recreate) с оценкой времени простоя и рисков, а также правила компоновки пайплайнов. Агент настраивает параллельные задачи, кэширование зависимостей под цель в десять минут на билд, внедряет пирамиду тестов (70% unit, 20% integration, 10% E2E) и подключает утилиты безопасности Trivy, CodeQL и Gitleaks.

Любые деплои в прод скилл принудительно ограничивает веткой main и требует обязательного ручного аппрува через GitHub Environments.

Какие задачи решает

  • заменить долгоживущие статические токены AWS на OIDC-аутентификацию
  • переписать Dockerfile на безопасную многоэтапную сборку без root
  • встроить сканирование Trivy, CodeQL и Gitleaks в пайплайн CI/CD
  • подобрать стратегию релиза между Canary и Blue-Green

Примеры запросов агенту

  • Настрой пайплайн сборки Node.js приложения с кэшированием и проверкой безопасности через Trivy
  • Перепиши Dockerfile для нашего бэкенда на multi-stage сборку с пользователем nodejs
  • Добавь в GitHub Actions шаг деплоя в production через AWS OIDC с ограничением по ветке

Как установить devops-excellence

1Через Skills CLI (Vercel)

npx skills add majiayu000/spellbook --skill devops-excellence -a claude-code

2Вручную: положить файлы

~/.claude/skills/devops-excellence/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/devops-excellence/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о devops-excellence

Как установить devops-excellence в Claude Code?

Выполните в терминале команду npx skills add majiayu000/spellbook --skill devops-excellence -a claude-code. Файл правил запишется в ~/.claude/skills/devops-excellence/SKILL.md.

Что делает devops-excellence?

Он направляет ИИ-ассистента на соблюдение строгих практик CI/CD, контейнеризации и IaC. Скилл блокирует утечки ключей в Docker-образах и настраивает защиту релизов.

Какие жесткие ограничения скилл накладывает на Dockerfile?

Он полностью запрещает директиву USER root и дефолтный root-запуск, требуя заводить отдельного пользователя с UID выше 1000. Передавать секреты через ENV или build-args скилл также запрещает.

Исходный текст

SKILL.md · MIT
---
name: devops-excellence
description: DevOps and CI/CD expert. Use when setting up pipelines, containerizing applications, deploying to Kubernetes, or implementing release strategies. Covers GitHub Actions, Docker, K8s, Terraform, and GitOps.
---
# DevOps Excellence

## Core Principles

- **Shift Left** — Address security and quality early in SDLC
- **GitOps** — Git as single source of truth for infrastructure and deployments
- **Infrastructure as Code** — All infrastructure versioned and reproducible
- **Progressive Delivery** — Gradual rollouts with feature flags and canary releases
- **Immutable Infrastructure** — Replace, don't modify running systems
- **Observability-First** — Monitor metrics tied to deployments and features
- **Policy as Code** — Enforce compliance and security automatically
- **Platform Engineering** — Build golden paths and self-service portals

---

## Hard Rules (Must Follow)

> These rules are mandatory. Violating them means the skill is not working correctly.

### No Static Credentials

**Never use long-lived static credentials. Always use OIDC or short-lived tokens.**

```yaml
# ❌ FORBIDDEN: Static AWS credentials
env:
  AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
  AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}

# ✅ REQUIRED: OIDC-based authentication
- name: Configure AWS Credentials
  uses: aws-actions/configure-aws-credentials@v4
  with:
    role-to-assume: arn:aws:iam::123456789012:role/GitHubActions
    aws-region: us-east-1
    # No long-lived secrets - uses GitHub OIDC provider
```

### No Root Containers

**Containers must NEVER run as root. Always specify a non-root user.**

```dockerfile
# ❌ FORBIDDEN: Running as root (default)
FROM node:20
WORKDIR /app
CMD ["node", "server.js"]

# ❌ FORBIDDEN: Explicit root user
USER root

# ✅ REQUIRED: Non-root user with UID > 1000
FROM node:20-alpine
RUN addgroup -g 1001 -S nodejs && \
    adduser -S nodejs -u 1001
USER nodejs
WORKDIR /app
CMD ["node", "server.js"]
```

### No Secrets in Images

**Never bake secrets into Docker images. Use runtime injection or secrets managers.**

```dockerfile
# ❌ FORBIDDEN: Secrets in build args or ENV
ARG DATABASE_PASSWORD
ENV API_KEY=sk-xxx

# ❌ FORBIDDEN: Copying secret files
COPY .env /app/.env
COPY credentials.json /app/

# ✅ REQUIRED: Mount secrets at runtime
# docker run -v /secrets:/app/secrets:ro myapp
# Or use Kubernetes secrets/configmaps
```

### Protected Production Deployments

**Production deployments must require approval and be restricted to main branch.**

```yaml
# ❌ FORBIDDEN: Direct production deploy without protection
deploy:
  runs-on: ubuntu-latest
  steps:
    - run: deploy-to-prod.sh

# ✅ REQUIRED: Environment protection
deploy:
  runs-on: ubuntu-latest
  environment:
    name: production
    url: https://myapp.com
  # Requires: approval + main branch only
```

---

## Quick Reference

### When to Use What

| Scenario | Tool/Pattern | Reason |
|----------|--------------|--------|
| Public GitHub project | GitHub Actions | Native integration, free for public repos |
| Enterprise GitLab | GitLab CI | Unified platform, advanced security scanning |
| Multi-cloud IaC | Terraform | Mature ecosystem, wide provider support |
| Developer-centric IaC | Pulumi | Real programming languages, better testing |
| Kubernetes deployments | ArgoCD + Kustomize | GitOps standard, declarative config |
| Zero-downtime releases | Blue-Green or Canary | Instant rollback capability |
| Gradual feature rollout | Feature flags (LaunchDarkly) | Progressive delivery with targeting |

### Deployment Strategy Selection

| Strategy | Downtime | Cost | Rollback Speed | Complexity | Best For |
|----------|----------|------|----------------|------------|----------|
| **Rolling** | Minimal | Low | Medium | Low | Regular updates, cost-conscious |
| **Blue-Green** | Zero | High (2x) | Instant | Medium | Critical systems, easy rollback |
| **Canary** | Zero | Medium | Fast | High | Risk mitigation, data-driven |
| **Recreate** | High | Low | N/A | Very Low | Non-critical, dev/test only |

---

## CI/CD Pipeline Best Practices

### Pipeline Security

```yaml
# Short-lived credentials (not static keys)
- name: Configure AWS Credentials
  uses: aws-actions/configure-aws-credentials@v4
  with:
    role-to-assume: arn:aws:iam::123456789012:role/GitHubActions
    aws-region: us-east-1
    # OIDC provider - no long-lived secrets!

# Protected environments for production
environment:
  name: production
  # Requires approval + restricts to main branch
```

### Speed Optimization

- **10-minute build rule** — Most projects should build in <10 minutes
- **Parallel jobs** — Run tests, linting, security scans concurrently
- **Cache dependencies** — Cache node_modules, .m2, pip packages
- **Conditional execution** — Skip jobs when files haven't changed

```yaml
# Example: conditional job execution
jobs:
  backend-tests:
    if: contains(github.event.head_commit.modified, 'backend/')
    runs-on: ubuntu-latest
```

### Testing Pyramid

```
              /\
             /E2E\        <- Few (slow, expensive)
            /------\
           /Integration\ <- Some (medium speed)
          /------------\
         /  Unit Tests  \ <- Many (fast, cheap)
        /----------------\
```

- 70% Unit tests (fast, isolated)
- 20% Integration tests (service interactions)
- 10% E2E tests (full user workflows)

### Security Scanning Integration

```yaml
# Multi-layer security scanning
jobs:
  security:
    runs-on: ubuntu-latest
    steps:
      # SAST - Static code analysis
      - uses: github/codeql-action/init@v3

      # SCA - Dependency vulnerabilities
      - name: Run Trivy
        uses: aquasecurity/trivy-action@master
        with:
          scan-type: 'fs'
          format: 'sarif'

      # Secret scanning
      - name: Gitleaks
        uses: gitleaks/gitleaks-action@v2

      # Container scanning
      - name: Scan Docker image
        run: trivy image myapp:${{ github.sha }}
```

---

## Docker Best Practices

### Multi-Stage Builds

```dockerfile
# Build stage - includes build tools (900MB+)
FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production

# Runtime stage - minimal image (<100MB)
FROM node:20-alpine AS runtime
RUN addgroup -g 1001 -S nodejs && \
    adduser -S nodejs -u 1001
WORKDIR /app
COPY --from=builder --chown=nodejs:nodejs /app/node_modules ./node_modules
COPY --chown=nodejs:nodejs . .
USER nodejs
EXPOSE 3000
CMD ["node", "server.js"]
```

### Security Hardening

- **Non-root user** — ALWAYS run as non-root (UID 1001)
- **Minimal base images** — Use `alpine`, `distroless`, or `scratch`
- **Read-only filesystem** — `docker run --read-only`
- **No secrets in layers** — Use build secrets or external vaults
- **Resource limits** — Set CPU/memory limits to prevent DoS
- **Signed images** — Enable Docker Content Trust

```dockerfile
# Security best practices example
FROM gcr.io/distroless/nodejs20-debian12
COPY --chown=65532:65532 /app /app
USER 65532
EXPOSE 8080
```

### .dockerignore

```
# Version control
.git
.gitignore

# Dependencies (install fresh in container)
node_modules
vendor/
*.pyc
__pycache__

# Secrets and configs
.env
.env.local
secrets/
*.key
*.pem

# Development files
README.md
Dockerfile
docker-compose.yml
.vscode/
.idea/

# Testing and CI
tests/
*.test.js
.github/
```

---

## Kubernetes Deployment Patterns

### Resource Management (Right-Sizing)

```yaml
# 99.94% of clusters are over-provisioned!
# Average CPU usage: 10%, Memory: 23%
resources:
  requests:
    memory: "128Mi"  # Guaranteed allocation
    cpu: "100m"      # 0.1 CPU cores
  limits:
    memory: "256Mi"  # Maximum allowed
    cpu: "200m"      # Hard cap

# Use tools: Kubecost, Goldilocks, VPA
```

### Health Checks

```yaml
# Liveness: Is container alive?
livenessProbe:
  httpGet:
    path: /health
    port: 8080
  initialDelaySeconds: 30
  periodSeconds: 10
  timeoutSeconds: 5
  failureThreshold: 3

# Readiness: Can it receive traffic?
readinessProbe:
  httpGet:
    path: /ready
    port: 8080
  initialDelaySeconds: 5
  periodSeconds: 5
  successThreshold: 1

# Startup: Has initialization completed?
startupProbe:
  httpGet:
    path: /startup
    port: 8080
  failureThreshold: 30  # 30*10s = 5min for slow starts
  periodSeconds: 10
```

### ConfigMaps and Secrets

```yaml
# Group related resources in single manifest
---
apiVersion: v1
kind: ConfigMap
metadata:
  name: app-config
data:
  APP_ENV: production
  LOG_LEVEL: info
---
apiVersion: v1
kind: Secret
metadata:
  name: app-secrets
type: Opaque
stringData:
  DATABASE_URL: postgresql://user:pass@db:5432/mydb
---
apiVersion: apps/v1
kind: Deployment
metadata:
  name: myapp
spec:
  template:
    spec:
      containers:
      - name: app
        envFrom:
        - configMapRef:
            name: app-config
        - secretRef:
            name: app-secrets
```

### Security Best Practices

```yaml
# Pod Security Standards
securityContext:
  runAsNonRoot: true
  runAsUser: 1000
  fsGroup: 1000
  seccompProfile:
    type: RuntimeDefault
  capabilities:
    drop:
    - ALL

# Network Policies (deny-by-default)
apiVersion: networking.k8s.io/v1
kind: NetworkPolicy
metadata:
  name: deny-all-ingress
spec:
  podSelector: {}
  policyTypes:
  - Ingress
```

---


## Extended Reference

Detailed material starting at `## Infrastructure as Code (Terraform/Pulumi)` has been moved to [`reference/extended.md`](reference/extended.md) to keep this skill concise. Load that reference when the task requires the moved examples, command catalogs, checklists, platform details, or implementation templates.

© majiayu000 · MIT · majiayu000/spellbook

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
devops-automator curiositech Скилл devops-automator для Claude Code проектирует CI/CD-pipeline, пишет Terraform и Kubernetes-манифесты, настраивает GitOps. Помогает строить инфраструктуру и автоматизировать развёртывание. CX Codex +1 219установок devops-engineer https://github.com/Jeffallan Скилл devops-engineer для Claude Code создаёт Dockerfile, CI/CD-конфигурации и манифесты Kubernetes. Решает задачи инфраструктуры, деплоя и разбора инцидентов. CX Codex +1 12 400установок devops-cicd miles990 Скилл devops-cicd для Claude Code собирает пайплайны, описывает инфраструктуру кодом и помогает выбрать стратегию деплоя. Включается на задачах про DevOps, CI/CD и деплой. CX Codex +1 610установок devops-deployment OrchestKit Скилл devops-deployment для настройки CI/CD, контейнеризации и инфраструктуры как кода: подсказывает паттерны GitHub Actions, Docker, Helm и Terraform. CX Codex +1 1 600установок devops-infrastructure CloudAI-X Скилл devops-infrastructure для Claude Code пишет Dockerfile, настраивает GitHub Actions, планирует развёртывания и организует мониторинг. Используется при контейнеризации, работе с пайплайнами, Terraform и production-инфраструктурой. CX Codex +1 ★ 1 424звёзд репо config-scan jwynia Скилл config-scan проверяет конфигурационные файлы, Docker, Kubernetes и Terraform на небезопасные настройки. Пригодится перед выкаткой в прод. CX Codex +1 360установок

Из того же набора13

Весь набор →
product-ux-expert Скилл product-ux-expert для проверки интерфейсов по эвристикам Нильсена, построения карт пути пользователя и аудита доступности по WCAG 2.2 AA. CX Codex +1 212установок prd-master Скилл prd-master помогает писать техспецификации, юзер-стори и критерии приёмки. Структурирует требования по RICE и MoSCoW и задаёт измеримые цели. CX Codex +1 166установок observability-sre Скилл observability-sre помогает настраивать наблюдаемость, SLO и процессы реагирования на инциденты. Подключайте его при работе с Prometheus, Grafana и OpenTelemetry. CX Codex +1 165установок database-patterns Скилл database-patterns задаёт правила связки PostgreSQL и Redis: выбор типов, индексы, работу с JSONB, стратегии кэширования и защиту от cache stampede. CX Codex +1 162установок clash-doctor Скилл clash-doctor диагностирует сетевые сбои в Clash Verge и mihomo, правит маршруты для ИИ-инструментов и настраивает исключения TUN. CX Codex +1 142установок trip-planner Скилл trip-planner для Claude Code составляет подробные планы поездок по дням: с адресами, временем в пути и вечерними списками сборов. Планирует отпуска и автопутешествия. CX Codex +1 134установок auth-security Скилл auth-security для Claude Code задаёт правила безопасной авторизации по OAuth 2.1 и RFC 9700: PKCE, ротацию refresh-токенов и строгую проверку JWT. CX Codex +1 117установок golang-web Скилл golang-web для Claude Code, Codex и других сред кодинга, задающий архитектуру веб-приложений на Go. Он выстраивает структуру проекта, управляет зависимостями и задаёт стандарты обработки ошибок. CX Codex +1 102установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой