# ae-analysis-global

Настраивает маршрутизацию аналитических запросов ae-cli по физическим серверам и кластерам. Помогает агенту не путать шарды базы данных с сегментами пользователей.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 836 установок · ★ 21
- Автор: ThinkingAIAgenticEngine
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/ThinkingAIAgenticEngine/ae-cli/tree/HEAD/skills/ae-analysis-global/SKILL.md
- Обновлён: 2026-10-22
- HTML: https://affpapa.org/nevibecode/skills/ae-analysis-global

## Что делает

Скилл служит надстройкой маршрутизации для набора команд `ae-analysis`. Он разграничивает физические дата-кластеры (`query-cluster`) и маркетинговые сегменты аудитории (`user-cluster`). Если запрос касается регионов, шардов или площадок, агент сначала собирает список доступных узлов через `ae-cli analysis query-cluster list --project-id <project_id>`.

Для отчётов и произвольных выборок скилл выставляет параметры `--cluster-query-scope GLOBAL|SLAVE`. Значение `SLAVE` всегда требует явный `--slave-cluster-id`, а `GLOBAL` включается только при прямом требовании объединить данные со всех серверов и подтверждённом флаге `can_query_global`.

SQL-запросы и расчёт атрибуции не принимают режим `GLOBAL`. В этих сценариях агент обязан использовать текущий хост или конкретный `SLAVE`, иначе сервер отклонит выполнение. Параметр `--host` при этом меняет сам инстанс AE, не влияя на внутреннюю маршрутизацию.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ThinkingAIAgenticEngine/ae-cli --skill ae-analysis-global -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/ae-analysis-global/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/ae-analysis-global/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ThinkingAIAgenticEngine/ae-cli --skill ae-analysis-global -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/ae-analysis-global/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ThinkingAIAgenticEngine/ae-cli --skill ae-analysis-global -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/ae-analysis-global/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ThinkingAIAgenticEngine/ae-cli ae-analysis-global
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/ae-analysis-global/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ThinkingAIAgenticEngine/ae-cli --skill ae-analysis-global -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/ThinkingAIAgenticEngine/ae-cli --path skills/ae-analysis-global
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/ae-analysis-global/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add ThinkingAIAgenticEngine/ae-cli --skill ae-analysis-global -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/ThinkingAIAgenticEngine/ae-cli/tree/HEAD/skills/ae-analysis-global/SKILL.md

## Когда брать
- разделить обращение к серверным шардам и когортам аудитории
- запросить инвентарь аналитических узлов по идентификатору проекта
- направить отчёт на конкретный slave-сервер с флагом `--slave-cluster-id`
- заблокировать некорректный вызов `GLOBAL` для SQL и анализа атрибуции

## Примеры запросов агенту
- Покажи список всех доступных query-кластеров для проекта 42
- Выгрузи отчёт по событиям со slave-кластера shard_eu_1
- Собери общие метрики со всех серверов в режиме GLOBAL, если права позволяют

## Похожие
- [data-analysis](https://affpapa.org/nevibecode/skills/akillness-data-analysis.md) — скилл · 598 установок
- [aa-conversion-funnel-analysis](https://affpapa.org/nevibecode/skills/aa-conversion-funnel-analysis.md) — скилл · 336 установок
- [cohort-analysis](https://affpapa.org/nevibecode/skills/cohort-analysis.md) — скилл · 2900 установок
- [ab-test-analysis](https://affpapa.org/nevibecode/skills/ab-test-analysis.md) — скилл · 2900 установок
- [traffic-analysis](https://affpapa.org/nevibecode/skills/traffic-analysis.md) — скилл · 1200 установок
- [Funnel Analysis](https://affpapa.org/nevibecode/skills/funnel-analysis.md) — скилл · 693 установки

Из того же набора: [thinkingaiagenticengine/ae-cli](https://affpapa.org/nevibecode/by/thinkingaiagenticengine/ae-cli.md) — 17 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md