Github Scout

---
name: github-scout
description: "OSINT-разведка GitHub: топ-5 репо для закрытия узких мест, топ-5 для усиления сильных мест, топ-5 неочевидных кросс-доменных. Автоматически анализирует текущий проект."
triggers: [github-scout, найди репо, osint github, scout repos, что посмотреть на гитхаб, найди библиотеки, github разведка]
tokens: ~400
type: directory
---

# GitHub Scout — OSINT разведка репозиториев

## Когда использовать
- Начало нового проекта — найти reference implementations
- Застрял на архитектурном решении — что используют другие
- Хочешь усилить текущую систему — найти battle-tested решения
- Ищешь вдохновение — кросс-доменные паттерны из других языков/индустрий

## Как запустить

Скажи: **"запусти github-scout"** или **"github-scout на [тема/проблема]"**

---

## Алгоритм (выполни все шаги последовательно)

### Шаг 1 — Извлечь контекст проекта

Прочитай `.claude/memory/activeContext.md`.
Извлеки:
- **Домен**: что делает проект
- **Стек**: язык, ключевые библиотеки
- **Узкие места**: PENDING, известные проблемы, TODO
- **Сильные места**: ключевые фичи уже реализованные
- **Ключевые слова**: 5-8 технических терминов

Если тема задана явно ("github-scout на кэширование") — используй её как приоритет.

---

### Шаг 2 — Поиск через gh CLI (plain-text, без --json)

> ⚠️ ВАЖНО: НЕ используй `--json` с pipe в Python — ломается на Windows из-за encoding.
> Используй plain-text вывод `gh search repos` и читай результат напрямую.

**Угол A — Закрытие узких мест:**
```
gh search repos "[keyword1] [keyword2]" --sort stars --limit 10
gh search repos "[keyword3] [keyword4]" --sort stars --limit 10
```

**Угол B — Усиление сильных мест:**
```
gh search repos "[текущая фича]" --sort stars --limit 10
gh search repos "[домен] [технология]" --sort stars --limit 10
```

**Формат вывода plain-text** (читай как есть):
```
owner/repo    Описание репо    public    2026-04-15T...
```

Из этой строки извлеки: `owner/repo`, дату push (последние 4 символа года).

---

### Шаг 3 — WebSearch для кросс-доменного угла и дообогащения

WebSearch работает лучше чем `gh search` для сложных запросов:

```
WebSearch: github "[домен]" "[технология]" stars 2025 OR 2026
WebSearch: github awesome list "[тема проекта]"
WebSearch: "[проблема] implemented in rust OR go" site:github.com
WebSearch: "[домен] production patterns 2026 github"
```

Дополнительно для топ-кандидатов:
```
WebSearch: [owner/repo] github key features architecture
```

---

### Шаг 4 — Скоринг каждого репо (0-10)

| Критерий | Баллы |
|----------|-------|
| push после 2025-10 | +3 |
| Описание содержит ≥2 ключевых слова проекта | +3 |
| push после 2024-01 (хотя бы живой) | +2 |
| Название/описание прямо по теме | +2 |

Исключи: archived, push до 2023, явные fork-обёртки без кода.

---

### Шаг 5 — Вывод результатов

```markdown
## 🔴 Топ-5 для закрытия узких мест
> Что позаимствовать чтобы закрыть [конкретная проблема]

1. **owner/repo**
   - **Что**: [конкретный паттерн/файл/подход]
   - **Как применить**: [1 действие — файл, строка, метод]
   - **Лицензия**: MIT/Apache | **Риск**: low/medium/high

## 🟢 Топ-5 для усиления сильных мест
> Что улучшает то что уже хорошо работает

1. **owner/repo**
   - **Инсайт**: [конкретная техника]
   - **Почему лучше**: [в чём превосходит текущее]
   - **Интеграция**: [заменить / расширить / вдохновиться]

## 🟡 Топ-5 неочевидных (кросс-домен)
> Репо из других языков/индустрий с применимыми паттернами

1. **owner/repo** | Язык: Go/Rust/etc
   - **Домен**: [откуда паттерн]
   - **Применимый инсайт**: [что перенести]
   - **Почему неочевидно**: [почему обычный поиск не находит]

## 💡 Следующий шаг (выбери 1)
- [ ] [Конкретное действие из 🔴 #1]
- [ ] [Конкретное действие из 🟢 #1]
- [ ] [Неочевидный эксперимент из 🟡]
```

---

## Рабочие примеры запросов gh (проверено на Windows)

```bash
# Работает — простые 1-2 слова:
gh search repos "claude-code" --sort stars --limit 10
gh search repos "llm hooks" --sort stars --limit 10
gh search repos "karpathy llm wiki" --sort stars --limit 8
gh search repos "obsidian automation" --sort stars --limit 8
gh search repos "python hook system" --sort stars --limit 8

# НЕ работает — сложные фразы в кавычках внутри строки:
# gh search repos "claude code hooks python" — возвращает 0 результатов
# Решение: разбей на 2 слова максимум без кавычек внутри
```

---

## Связка с другими скилами

- После scout → `запусти codex-solver` — выбрать лучший из топ-3 кандидатов
- После scout → `запусти skeptic` — проверить что заимствование оправдано
- Найденные паттерны → `error-to-lesson` — сохранить в wiki