Настройка ИИ-агентов из .agents: практический гайд

Пошаговая инструкция по созданию и настройке ИИ-агентов на основе репозитория mattpocock/skills. Разбираемся с конфигурацией, командами и реальными сценариями использования.

Средний

Алексей Кузнецов

Системный администратор20 октября 2026 г.3 мин чтения

git clone https://github.com/mattpocock/skills.git
cd skills
npm install

ls -la .agents/
find .agents -type f -name '*.yaml' -o -name '*.yml' -o -name '*.json'

cat > .agents/claude-code.yaml << 'EOF'
name: claude-code-agent
description: Агент для автоматизации задач разработки
model: claude-3-opus-20240229
tools:
  - bash
  - file_reader
  - file_writer
  - web_search
prompt: |
  Ты — опытный инженер-разработчик. Помогай с практическими задачами по коду, тестированию и CI/CD.
EOF

cat > .agents/my-custom-agent.yaml << 'EOF'
name: my-custom-agent
description: Специализированный агент для анализа логов
tags:
  - logging
  - monitoring
model: gpt-4-turbo
tools:
  - bash
  - file_reader
  - regex_parser
prompt: |
  Ты — эксперт по анализу логов и обнаружению аномалий. Анализируй логи и выявляй ошибки.
EOF

npx tsx src/agent-runner.ts --config .agents/my-custom-agent.yaml --query "Проанализируй логи за последние 24 часа"

cat > .github/workflows/agent-trigger.yml << 'EOF'
name: Trigger AI Agent
on:
  push:
    branches: [main]
jobs:
  run-agent:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'
      - name: Install dependencies
        run: npm ci
      - name: Run agent
        run: npx tsx src/agent-runner.ts --config .agents/claude-code.yaml --query "Проверь код на ошибки"
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
EOF

echo "ANTHROPIC_API_KEY=your_api_key_here" > .env.local
echo ".env.local" >> .gitignore

cat > .agents/logging-config.yaml << 'EOF'
logging:
  level: info
  format: json
  output:
    - file: logs/agent.log
    - stdout
metrics:
  enabled: true
  endpoint: http://localhost:9090/metrics
EOF

Настройка ИИ-агентов из .agents: практический гайд

Пошаговая инструкция по созданию и настройке ИИ-агентов на основе репозитория mattpocock/skills. Разбираемся с конфигурацией, командами и реальными сценариями использования.

Предварительные требования

• Базовые знания работы с терминалом Linux или macOS
• Установленный Node.js (версия 18 и выше)
• Доступ к GitHub-аккаунту
• Базовое понимание YAML и JSON

Шаг 1: Клонирование репозитория и установка зависимостей

Склонируйте репозиторий mattpocock/skills на локальную машину и установите необходимые зависимости для работы с ИИ-агентами.

git clone https://github.com/mattpocock/skills.git
cd skills
npm install

Шаг 2: Изучение структуры .agents

Перейдите в директорию .agents и изучите её структуру. Здесь находятся конфигурационные файлы для различных ИИ-агентов, включая Claude Code и другие.

ls -la .agents/
find .agents -type f -name '*.yaml' -o -name '*.yml' -o -name '*.json'

Шаг 3: Настройка Claude Code Agent

Создайте или измените конфигурацию для Claude Code, указав необходимые параметры доступа и настройки поведения агента.

cat > .agents/claude-code.yaml << 'EOF'
name: claude-code-agent
description: Агент для автоматизации задач разработки
model: claude-3-opus-20240229
tools:
  - bash
  - file_reader
  - file_writer
  - web_search
prompt: |
  Ты — опытный инженер-разработчик. Помогай с практическими задачами по коду, тестированию и CI/CD.
EOF

Шаг 4: Создание собственного агента

Определите цель нового агента и создайте конфигурационный файл с указанием модели, доступных инструментов и начального промпта.

cat > .agents/my-custom-agent.yaml << 'EOF'
name: my-custom-agent
description: Специализированный агент для анализа логов
tags:
  - logging
  - monitoring
model: gpt-4-turbo
tools:
  - bash
  - file_reader
  - regex_parser
prompt: |
  Ты — эксперт по анализу логов и обнаружению аномалий. Анализируй логи и выявляй ошибки.
EOF

Шаг 5: Тестирование агента локально

Запустите созданного агента с тестовым запросом, чтобы убедиться, что он корректно обрабатывает команды и возвращает ожидаемые результаты.

npx tsx src/agent-runner.ts --config .agents/my-custom-agent.yaml --query "Проанализируй логи за последние 24 часа"

Шаг 6: Интеграция с GitHub Actions

Настройте автоматический запуск агентов в рамках CI/CD-конвейера с использованием GitHub Actions.

cat > .github/workflows/agent-trigger.yml << 'EOF'
name: Trigger AI Agent
on:
  push:
    branches: [main]
jobs:
  run-agent:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '20'
      - name: Install dependencies
        run: npm ci
      - name: Run agent
        run: npx tsx src/agent-runner.ts --config .agents/claude-code.yaml --query "Проверь код на ошибки"
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
EOF

Шаг 7: Добавление переменных окружения

Настройте безопасное хранение секретов и переменных окружения для агентов с использованием .env-файлов или секретов GitHub.

echo "ANTHROPIC_API_KEY=your_api_key_here" > .env.local
echo ".env.local" >> .gitignore

Шаг 8: Логирование и мониторинг выполнения

Включите логирование для отслеживания выполнения агентов и анализа их поведения.

cat > .agents/logging-config.yaml << 'EOF'
logging:
  level: info
  format: json
  output:
    - file: logs/agent.log
    - stdout
metrics:
  enabled: true
  endpoint: http://localhost:9090/metrics
EOF