# agent-1-issue-scout

Субагент agent-1-issue-scout для Claude, который ищет в отобранных GitHub-репозиториях свободные «good first issue» и отдаёт одну выбранную задачу следующему агенту цепочки.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 138 у репозитория
- Автор: happycapy-ai
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/happycapy-ai/Happycapy-skills/tree/HEAD/skills/oss-contributor-swarm/agents/agent-1-issue-scout.md
- Обновлён: 2026-09-03
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/agent-1-issue-scout

## Что делает

Первый агент в цепочке Open Source Contributor Swarm. Берёт список уже отобранных репозиториев из `./workspace/qualified-repos.json`, ищет в них открытые «good first issue» без исполнителя и складывает выбор в `./workspace/current-issue.json`, чтобы следующий агент начал разбор.

Поиск идёт через `gh search issues`, поэтому нужен установленный и авторизованный GitHub CLI. Кандидат проходит фильтры: от 50 до 10000 звёзд, коммит за последние 30 дней, доля открытых issue ниже 0.5, файл CONTRIBUTING, лицензия OSI; у самой задачи тело от 100 до 5000 знаков, меньше 5 комментариев, возраст 1–60 дней, нет назначенного и нет связанных PR (это проверяется через `gh api` по timeline и `gh pr list`). Дальше функция на Python считает балл до 100: опечатка в документации даёт 30, обновление документации 28, тест 25, простой баг 22.

Потолок в 10000 звёзд отсекает крупные проекты: в репозитории выше этого порога агент искать не станет, даже если задача там на одну строку. На цикл отводится 100 вызовов API с паузой 2 секунды между ними, так что широкий поиск по языкам быстро съедает бюджет.

## Установка

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

**Вручную: положить файлы**
- Файл: `.claude/agents/agent-1-issue-scout.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/agent-1-issue-scout.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/agent-1-issue-scout.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/happycapy-ai/Happycapy-skills/tree/HEAD/skills/oss-contributor-swarm/agents/agent-1-issue-scout.md

## Когда брать
- найти свободную good first issue, которую ещё никто не занял
- отсеять задачи с уже открытым PR по timeline
- оценить свежесть issue и качество описания в баллах
- проверить, что мейнтейнер принимает внешние PR
- отдать следующему агенту готовый JSON с выбранной задачей

## Примеры запросов агенту
- Найди good first issues в репозиториях из `./workspace/qualified-repos.json` и запиши выбранную в `./workspace/current-issue.json`.
- Проверь по timeline, что у кандидата нет связанных PR, и посчитай ему балл.
- Отбрось репозитории, где последний коммит старше 30 дней, и оставь три лучших кандидата.

## Похожие
- [scout-issue](https://affpapa.org/nevibecode/skills/scout-issue.md) — скилл · ★ 41430 у репозитория
- [github-scout](https://affpapa.org/nevibecode/agents/github-scout.md) — субагент · ★ 730 у репозитория
- [security-scout](https://affpapa.org/nevibecode/agents/security-scout.md) — субагент · ★ 730 у репозитория
- [github-fix-issue](https://affpapa.org/nevibecode/skills/github-fix-issue.md) — скилл · 205 установок
- [issue-create](https://affpapa.org/nevibecode/skills/terrylica-issue-create.md) — скилл · 129 установок
- [post-issue-comment](https://affpapa.org/nevibecode/skills/post-issue-comment.md) — скилл · ★ 1636 у репозитория

Из того же набора: [happycapy-ai/happycapy-skills](https://affpapa.org/nevibecode/by/happycapy-ai/happycapy-skills.md) — 41 карточка

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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