research-first · zaxbyhub, claude — скилл для Claude Code: исследование перед планом
Скилл research-first проверяет актуальную документацию и обсуждения до разбора кода, если проблема связана с внешней библиотекой, платформой или инструментом. Для локальных вопросов он ищет ответы в репозитории.
MIT ★ 539 обновлён 2026-10-29
npx skills add ZaxbyHub/opencode-swarm --skill research-first -a claude-codeЧто делает research-first
Скилл помогает исследовать причину ошибки, планировать исправление или разбирать технический долг. Если вопрос зависит от внешнего фреймворка, инструмента или поведения платформы, он сначала ищет актуальные официальные документы, исправления в новых версиях и обсуждения проблемы в разных источниках. Результаты с URL нужно вернуть до трассировки кода.
Для задач о структуре и правилах самого репозитория веб-поиск пропускается: исследование идёт по AGENTS.md, docs/ и исходникам. Затем скилл прослеживает каждую проблему по коду и отмечает выводы, для которых не хватает подтверждений. Он работает в отдельном контексте Explore и не может запускать субагентов. Если WebSearch или WebFetch недоступны, исследование продолжается по коду, но это ограничивает проверку внешнего поведения.
Какие задачи решает
- проверить, исправлена ли ошибка во внешней библиотеке
- найти актуальные рекомендации для планируемого исправления
- проследить причину сбоя через исходный код
- отделить подтверждённые выводы от непроверенных
Примеры запросов агенту
- Исследуй, почему интеграция с внешним фреймворком ведёт себя не так, как ожидается, и сначала проверь актуальную документацию.
- Разбери технический долг в этом репозитории: найди правила проекта и проследи связанные участки кода.
- Проверь, не исправлена ли проблема в новой версии зависимости, а затем найди её причину в исходниках.
Как установить research-first
1Через Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill research-first -a claude-code2Вручную: положить файлы
~/.claude/skills/research-first/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/research-first/
1Через Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill research-first -a codex2Вручную: положить файлы
.agents/skills/research-first/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill research-first -a cursor2Вручную: положить файлы
.cursor/skills/research-first/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ZaxbyHub/opencode-swarm .claude/skills/research-first2Вручную: положить файлы
.github/skills/research-first/SKILL.md1Через Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill research-first -a gemini-cli2Командой платформы
gemini skills install https://github.com/ZaxbyHub/opencode-swarm --path .claude/skills/research-firstВручную: положить файлы
.devin/skills/research-first/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add ZaxbyHub/opencode-swarm --skill research-first -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о research-first
Как установить research-first в Claude Code?
Выполните npx skills add ZaxbyHub/opencode-swarm --skill research-first -a claude-code, затем используйте файл ~/.claude/skills/research-first/SKILL.md.
Что делает research-first?
Для проблем с внешними технологиями скилл сначала ищет актуальные документы и обсуждения, а затем трассирует проблему по коду. Для вопросов о самом репозитории он сразу изучает его файлы.
Что происходит, если веб-поиск недоступен?
Скилл сообщает об этом и продолжает разбор по исходному коду. Проверить актуальное внешнее поведение в таком случае не получится.
Исходный текст
SKILL.md · MIT
--- name: research-first description: > Apply when planning fixes, investigating tech debt, architecting solutions, or diagnosing unknown issues that may involve external frameworks, dependencies, or platform behavior. Search online for current documentation and state-of-the-art approaches before tracing through code. context: fork agent: Explore metadata: audience: swarm-plugin --- ## Research Before Planning Protocol This skill body runs in an isolated Explore context: it has no conversation history and cannot spawn further sub-agents. Work from the task statement it receives, run searches and reads directly, and return a compact findings report. Scope guard — research the outside world only when the problem involves it: - If the question involves external frameworks, dependencies, platform or toolchain behavior, or a suspected upstream bug: research online first. - If the question is purely repo-local (project conventions, invariants, existing code structure), skip web research; the answer lives in the repository (AGENTS.md, docs/, and the source itself). - If WebSearch/WebFetch are unavailable in this environment, state that explicitly and proceed with code tracing rather than stalling. When researching: 1. Search current official documentation to confirm the behavior is NOT intended and NOT already fixed in a newer release 2. Search for state-of-the-art solutions, known community workarounds, and recent discussion of this problem type 3. Run multiple searches across distinct sources (official docs, issue trackers, release notes) rather than trusting the first hit 4. Report all findings — with URLs — before any code tracing begins Then trace each problem end-to-end through the actual source code. Do not stop until ≥95% confident in the root cause for every issue being investigated, and mark anything below that threshold as UNVERIFIED with what evidence is missing.
© ZaxbyHub · MIT · ZaxbyHub/opencode-swarm
Похожие скиллы
Все скиллы по теме «Код-ревью и рефакторинг» →Сначала — research-first от других авторов.