Skip to content

Conversation

@gsnaiper
Copy link

Добавлен специализированный навык для оптимизации работы с Yandex Cloud:

  • Основной навык yandex-cloud.md с экспертными знаниями по всем сервисам
  • Команда /yc-setup для настройки Yandex Cloud CLI
  • Команда /yc-search-docs для поиска в документации
  • Команда /yc-create-terraform для генерации Terraform конфигураций
  • Команда /yc-troubleshoot для диагностики и решения проблем
  • Подробная документация по использованию в README.md

Навык охватывает:

  • Автоматизацию развёртывания и управления ресурсами
  • Мониторинг и логирование
  • Управление конфигурацией
  • Работу со 100+ сервисами Yandex Cloud
  • Управление доступом и безопасностью
  • Интеграцию с внешними инструментами (Terraform, Kubernetes, Docker)
  • Поддержку DevOps-практик
  • Обработку ошибок и отладку
  • Оптимизацию затрат

I hereby agree to the terms of the CLA available at: https://yandex.ru/legal/cla/?lang=ru

Description of changes:

Добавлен специализированный навык для оптимизации работы с Yandex Cloud:

- Основной навык yandex-cloud.md с экспертными знаниями по всем сервисам
- Команда /yc-setup для настройки Yandex Cloud CLI
- Команда /yc-search-docs для поиска в документации
- Команда /yc-create-terraform для генерации Terraform конфигураций
- Команда /yc-troubleshoot для диагностики и решения проблем
- Подробная документация по использованию в README.md

Навык охватывает:
- Автоматизацию развёртывания и управления ресурсами
- Мониторинг и логирование
- Управление конфигурацией
- Работу со 100+ сервисами Yandex Cloud
- Управление доступом и безопасностью
- Интеграцию с внешними инструментами (Terraform, Kubernetes, Docker)
- Поддержку DevOps-практик
- Обработку ошибок и отладку
- Оптимизацию затрат
@yfm-team
Copy link

Все готово!
Commit: 793de0a
Проверьте результат: RU.
Check the result: EN.

Полная реструктуризация навыка Yandex Cloud по методологии C.R.A.F.T.:
Context, Role, Action, Format, Target с продвинутыми возможностями.

## Новая архитектура

### 1. Event Bus - Шина контекста (.claude/skills/yandex-cloud/scripts/bus.sh)
- Универсальный API для обмена данными между навыками и агентами
- Поддержка множественных бэкендов:
  * JSON (по умолчанию) - легковесный, файловый
  * SQLite - структурированные запросы, транзакции
  * Redis - распределенный, real-time
  * Neo4j Graph - графовые отношения (planned)
- Pub/Sub события и Key-Value хранилище
- Переключение бэкенда через BUS_BACKEND env variable

### 2. Micro-Agents - Параллельная обработка (.claude/skills/yandex-cloud/agents/)
- agent.docs-indexer.sh - индексация документации
- agent.resource-analyzer.sh - анализ инфраструктуры
- agent.cost-optimizer.sh - оптимизация затрат
- agent.security-auditor.sh - аудит безопасности
- Параллельный запуск с ограничением (AGENTS_MAX)
- Результаты публикуются в event bus
- Координация через agents-runner.sh

### 3. Git Hooks - Автоматическая валидация (.claude/skills/yandex-cloud/hooks/)
- pre-commit: быстрые проверки (<10s)
  * Синтаксис скриптов
  * Валидация YAML/JSON
  * Проверка зависимостей
- pre-push: тщательная валидация (<60s)
  * Полный self-test
  * Проверка всех компонентов
- post-skill-run.d/:
  * 10-docs-update.sh - автообновление документации
  * 20-emit-metrics.sh - сбор метрик выполнения
- Поддержка SKIP_HOOKS=1 для быстрой работы

### 4. Automation Scripts - Исполняемая логика (.claude/skills/yandex-cloud/scripts/)
- skill-run.sh - главный entrypoint с задачами:
  * analyze - анализ инфраструктуры
  * build - сборка конфигураций
  * test - тестирование
  * deploy - развертывание (с флагом ALLOW_DEPLOY=1)
  * monitor - настройка мониторинга
  * troubleshoot - диагностика
  * optimize - оптимизация затрат
  * document - обновление документации
  * stats - статистика
- self-test.sh - проверка зависимостей
- env-check.sh - информация об окружении
- agents-runner.sh - оркестратор агентов
- skill-undo.sh - безопасное удаление навыка

### 5. Context System - Общее состояние (.claude/context/)
- skills.index.json - индекс всех навыков
- docs/INDEX.md - индекс документации с датами проверки
- events/*.jsonl - журнал событий (по датам)
- Автоматическое обновление через post-hooks

### 6. Configuration Management (.claude/skills/yandex-cloud/templates/)
- bus.config.yaml - конфигурация шины событий
- skill.env.example - шаблон переменных окружения
- Поддержка .env файлов
- Безопасное хранение секретов

### 7. Structured Metadata (skill.yaml)
- Полное описание capabilities
- Определение dependencies (required/recommended)
- Регистрация micro-agents
- Темы event bus
- Ссылки на официальную документацию с датами
- Performance limits и timeouts
- Security policies

## Возможности v2.0

✨ **Параллельная обработка**: До 4 агентов одновременно
⚡ **Быстрые проверки**: pre-commit <10s, pre-push <60s
🔄 **Автообновление доков**: После каждого запуска
📊 **Метрики и события**: Полная трассировка операций
🔌 **Pluggable storage**: JSON/SQLite/Redis/Graph
🛡️ **Безопасность**: Аудит команд, секреты в env
📚 **Контекстная память**: Обмен данными между навыками
🎯 **Idempotent scripts**: Безопасный повторный запуск

## Производительность

- Analyze task: ~30s (с 4 агентами)
- Bus operations: <100ms (JSON), <50ms (SQLite/Redis)
- Pre-commit hook: <10s
- Pre-push hook: <60s

## Миграция

- Старый skill.md → SKILL_GUIDE.md (сохранен)
- Новая структура в .claude/skills/yandex-cloud/
- Обратная совместимость с slash-командами
- .gitignore обновлен для временных файлов

## Использование

```bash
# Быстрый старт
./.claude/skills/yandex-cloud/scripts/self-test.sh
./.claude/skills/yandex-cloud/scripts/skill-run.sh analyze

# С разными бэкендами
BUS_BACKEND=json ./scripts/skill-run.sh analyze
BUS_BACKEND=sqlite ./scripts/skill-run.sh analyze

# Параллельные агенты
AGENTS_MAX=4 ./scripts/skill-run.sh analyze
SKIP_AGENTS=1 ./scripts/skill-run.sh analyze  # без агентов

# Быстрый режим
FAST=1 SKIP_HOOKS=1 ./scripts/skill-run.sh test
```

Подробности: .claude/skills/yandex-cloud/README.md
@yfm-team
Copy link

Все готово!
Commit: e9393d5
Проверьте результат: RU.
Check the result: EN.

@yfm-team
Copy link

Все готово!
Commit: 0687c20
Проверьте результат: RU.
Check the result: EN.

@vnkiryushkin
Copy link
Contributor

@gsnaiper, здравствуйте.
Не могу понять, намеренно ли вы открыли ПР в наш репозиторий, а не в свой форк. Выглядит так, будто хотели распространять навык из своего репозитория. Если я не прав — поправьте.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants