research · eugeniughelbur — слэш-команда для Claude Code: что делает и как установить
Команда research ищет материалы по теме и собирает досье с источниками. В режиме без API-ключа агент сам сводит результаты в заметку.
MIT ★ 5 412 обновлён 2026-10-24
/plugin marketplace add eugeniughelbur/obsidian-second-brain
/plugin install obsidian-second-brain@obsidian-second-brainЧто делает research
Запустите /research с темой. Команда использует Perplexity Sonar, если задан PERPLEXITY_API_KEY; иначе ищет в бесплатных источниках, среди которых Wikipedia, HackerNews, arXiv и Reddit. Флаг --free принудительно выбирает бесплатный режим, а --academic ограничивает его научными источниками.
В режиме Perplexity скрипт формирует досье с фактами, временной шкалой, участниками, противоположными взглядами и источниками, затем сохраняет заметку в Research/Web/. В бесплатном режиме агент составляет досье по JSON-результатам и записывает заметку с URL источников. Если вернулось меньше трёх источников, охват будет отмечен как ограниченный.
TAVILY_API_KEY и BRAVE_API_KEY добавляют поисковые источники, но для бесплатного режима они не обязательны. Для поиска только по научным материалам используйте --academic.
Какие задачи решает
- собрать досье по теме с цитируемыми источниками
- сопоставить факты и противоположные взгляды
- составить временную шкалу событий
- сохранить результаты исследования в заметку
Примеры запросов агенту
- Исследуй тему векторных баз данных для RAG:
/research vector databases for RAG. - Найди материалы о новых подходах к памяти ИИ-агентов через
/research AI agent memory. - Собери обзор научных публикаций по теме через
/research --academic AI memory.
Как установить research
1Через маркетплейс плагинов
/plugin marketplace add eugeniughelbur/obsidian-second-brain/plugin install obsidian-second-brain@obsidian-second-brain2Вручную: положить файлы
.claude/commands/research.mdВызов — /research. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/research.mdВызов — /prompts:research. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/research.prompt.mdВручную: положить файлы
.gemini/commands/research.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о research
Как установить research в Claude Code?
Выполните /plugin marketplace add eugeniughelbur/obsidian-second-brain и затем /plugin install obsidian-second-brain@obsidian-second-brain. Файл команды находится по пути .claude/commands/research.md.
Что делает research?
Ищет материалы по заданной теме и готовит досье с фактами, источниками и дополнительными вопросами. При заданном PERPLEXITY_API_KEY использует Perplexity Sonar, иначе работает с бесплатными источниками.
Можно ли искать только научные источники?
Да. Передайте флаг --academic; этот режим использует arXiv, Semantic Scholar, OpenAlex и CrossRef.
Исходный текст
research.md · MIT
---
description: Web research with citations - Perplexity Sonar when an API key is set, free key-less sources (Wikipedia, HackerNews, arXiv, Reddit, and more) otherwise. Deep dossier with summary, facts, timeline, players, contrarian views, open questions
category: research
triggers_en: ["research this", "look up", "find information about", "perplexity research"]
triggers_de: ["recherchiere das", "schlag das nach", "finde Informationen über", "Perplexity-Recherche"]
triggers_es: ["investiga esto", "búscalo", "busca información sobre", "investigación con perplexity"]
triggers_pt: ["pesquise isto", "procure", "encontre informações sobre", "pesquisa perplexity"]
triggers_zh: ["研究一下这个问题", "帮我查资料", "搜索关于这个主题的信息", "做一份带引用的网络研究"]
---
Use the obsidian-second-brain skill. Execute `/research [topic]`:
1. Resolve the topic from the user's argument. Multi-word topics fine ("AI memory tools", "vector databases for RAG"). If no topic, ask: "What topic should I research?"
2. Run the script from the skill root (its absolute path was given at session start as **Skill root**; substitute it for `SKILL_ROOT`):
```bash
uv run --directory "SKILL_ROOT" -m scripts.research.research "<topic>"
```
The script auto-selects its mode: if `PERPLEXITY_API_KEY` is set it uses Perplexity Sonar (paid); otherwise it falls back to free, key-less sources. Pass `--free` to force free mode even when a key is set, or `--academic` (free mode only) to restrict to scholarly sources (arXiv, Semantic Scholar, OpenAlex, CrossRef). If `TAVILY_API_KEY` or `BRAVE_API_KEY` is set, that source joins the free-mode pool as an extra web source; without them the pool stays fully key-less - never require either.
3. Handle the output by mode:
- **Paid mode** - the script prints a finished dossier (Summary, Key Facts with recency markers, Timeline, Key Players, Contrarian Views, Further Reading, Open Questions, Sources) and saves the AI-first note itself to `Research/Web/` plus a log line. Show the dossier verbatim, then surface the saved file path. Nothing else to do.
- **Free mode** - the script prints a JSON block with `"mode": "free-sources"`, containing `results` (raw items per source: title, url, snippet/abstract, authors, year, points, comments), `stats`, and `warnings`. YOU synthesize the dossier from it:
a. Read the JSON. If `stats.success` is false (fewer than 3 sources returned results), say so plainly and flag the thin coverage in Open Questions - do not pad.
b. Write a dossier with the same structure as paid mode. Every Key Fact carries a recency marker and the source domain/URL it came from. Never invent facts to fill a section; if the sources are thin, the section is short or empty (see the anti-fabrication rule below).
c. Save it yourself as an AI-first note at `Research/Web/YYYY-MM-DD - <slug>.md` per `references/ai-first-rules.md` (preamble, frontmatter with `type: research`, `ai-first: true`, a `sources` list of every result URL verbatim, tags). Append a one-line entry to the operation log (`Logs/YYYY-MM-DD.md` if it exists, else `log.md`).
d. Show the dossier to the user and surface the saved path.
4. Plain English triggers: "research [topic]", "look up [topic]", "deep research on [topic]" (note: "do deep research" or "research deep" should route to `/research-deep` instead - the chained version), "find me info on [topic]".
5. If the user wants ALSO X discourse on the same topic, suggest running `/x-pulse [topic]` after this. If they want full vault-aware synthesis with propagation, suggest `/research-deep [topic]`.
6. Errors handled inside the script with auto-retry on transient failures. Surface fatal errors verbatim.
---
**AI-first rule:** Every note created or updated by this command MUST follow `references/ai-first-rules.md` - `## For future agent` preamble, rich frontmatter (`type`, `date`, `tags`, `ai-first: true`, plus type-specific fields), recency markers per external claim, mandatory `[[wikilinks]]` for every person/project/concept referenced, sources preserved verbatim with URLs inline, and confidence levels where applicable. If that path does not resolve from your working directory, search upward for it; if you still cannot read it, say so before writing rather than producing a note that silently skips the rule. The vault is for future agent retrieval - not human reading.
**Anti-fabrication:** Search exhaustively before claiming any note, person, or file is absent - false absence is the most common failure mode - and never invent facts, entities, or dates (mark unknowns as `TBD`). See the anti-fabrication and search-completeness hard rules in `references/ai-first-rules.md`.
© Eugeniu Ghelbur · MIT · eugeniughelbur/obsidian-second-brain
Похожие слэш-команды
Все слэш-команды по теме «Наука и исследования» →Сначала — research от других авторов.