Slash-командаSlash commandSlash-команда Навыки: сценарии как slash-командыSkills: workflows as slash commandsНавички: сценарії як slash-команди

Изучить область, прежде чем её менятьInvestigate an area before you change itВивчити ділянку, перш ніж її змінювати

/research - повторяемый проход перед разработкой, работой с документацией или отладкой, затрагивающей несколько поверхностей. Агент сначала собирает черновое досье, идёт по документам в заданном порядке и только потом читает те файлы реализации, что отвечают на вопрос. В конце он называет путь к досье, следующие чтения и ответ./research is a repeatable pass before development, documentation work or cross-surface debugging. The agent builds a rough dossier first, follows a fixed order of documents, then reads only the implementation files that answer the question. It ends with the dossier path, the next reads and the answer./research - повторюваний прохід перед розробкою, роботою з документацією чи налагодженням, що зачіпає кілька поверхонь. Агент спершу збирає чорнове досьє, іде по документах у заданому порядку і лише потім читає ті файли реалізації, що відповідають на запитання. Наприкінці він називає шлях до досьє, наступні читання й відповідь.

Когда это нужноWhen to reach for itКоли це потрібно

Перед любой нетривиальной правкой, перед написанием спеки или когда нужно понять, как что-то устроено в проекте и где оно лежит.Before any non-trivial change, before writing a spec, or when you need to know how something works in this project or where it lives.Перед будь-якою нетривіальною правкою, перед написанням спеки або коли треба зрозуміти, як щось влаштоване в проєкті й де воно лежить.

ТребованияRequirementsВимоги

Где доступноAvailable inДе доступно
Каждая загрузка kitEvery download of the kitКожне завантаження kit
К чему обращаетсяWhat it touchesДо чого звертається
  • Читает файлы проектаReads the files of your projectЧитає файли проєкту
  • Правит файлы проектаEdits files in your projectЗмінює файли проєкту
Работает сWorks withПрацює з
Сделано для Claude Code; другие агенты адаптируютBuilt for Claude Code; other agents adapt itЗроблено для Claude Code; інші агенти адаптують
Где выполняются шагиWhere the steps happenДе виконуються кроки
Чат вашего агента и ваши собственные файлы. Ни то ни другое не интерфейс этого сайта, поэтому шаги описаны текстом, а не скриншотами.Your agent's chat and your own files. Neither is an interface of this site, so the steps are text and not screenshots.Чат вашого агента і ваші власні файли. Ні те, ні інше не є інтерфейсом цього сайту, тому кроки описано текстом, а не скриншотами.
Где это лежит в kitWhere it lives in the kitДе це лежить у kit
.claude/skills/research/SKILL.md
Прежде чем начатьBefore you startПерш ніж почати

Без идентификатора тикета ничего не сохраняется вне чернового досье в scratch, а оно вправе быть небрежным. Выводы, которые стоит сохранить, например выбранный вариант и отвергнутые с причинами, требуют запуска по тикету: /research <ticket-id> <topic>.Without a ticket id, nothing is saved outside the scratch dossier, which is allowed to be rough. Findings worth keeping, such as the chosen option and the rejected ones with reasons, need a ticket-bound run: /research <ticket-id> <topic>.Без ідентифікатора тікета нічого не зберігається поза чорновим досьє в scratch, а воно має право бути недбалим. Висновки, які варто зберегти, наприклад обраний варіант і відхилені з причинами, потребують запуску за тікетом: /research <ticket-id> <topic>.

ШагиStepsКроки

  1. Назовите тему: /research player startup или привяжите её к тикету: /research T0123 best strategy for full-text search over filenames. Слово, подходящее под схему идентификаторов проекта (вроде T0042, JIRA-123 или даты со слагом, как задано в <ID_SCHEME>), делает запуск привязанным к тикету, остальное - тема. Названную вами цель агент берёт как есть, а затрагиваемую область выводит из запроса и открытого файла.Name the topic: /research player startup, or bind it to a ticket: /research T0123 best strategy for full-text search over filenames. A token that matches the project's ticket id scheme (such as T0042, JIRA-123 or a date-slug, whatever <ID_SCHEME> says) makes the run ticket-bound, and the rest is the topic. The agent uses your explicit target when given and infers the affected area from the request and the open file.Назвіть тему: /research player startup або прив'яжіть її до тікета: /research T0123 best strategy for full-text search over filenames. Слово, що відповідає схемі ідентифікаторів проєкту (на кшталт T0042, JIRA-123 чи дати зі слагом, як задано в <ID_SCHEME>), робить запуск прив'язаним до тікета, решта - тема. Названу вами мету агент бере як є, а зачеплену ділянку виводить із запиту та відкритого файлу.
  2. До широкого чтения агент пишет досье в <SCRATCH_DIR>/research_<topic-slug>.md по быстрому обходу: что читать первым, подходящие файлы и символы (один проход grep или индекса кода, не исчерпывающий), существующие спеки и планы в этой области и короткий список следующих чтений.Before broad reading, the agent writes the dossier to <SCRATCH_DIR>/research_<topic-slug>.md from a quick sweep: the docs to read first, the files and symbols that match (one grep or code-index pass, not exhaustive), existing specs and plans in the area, and a short list of suggested next reads.До широкого читання агент пише досьє в <SCRATCH_DIR>/research_<topic-slug>.md за швидким обходом: що читати першим, відповідні файли й символи (один прохід grep чи індексу коду, не вичерпний), наявні спеки та плани в цій ділянці й короткий список наступних читань.
  3. Он идёт по стеку маршрутизации по порядку, если досье не указывает более точного первого чтения: карта репозитория или индексный документ, документ об архитектуре, о сборке и эксплуатации, о зависимостях и стеке, затем индекс кода или <PLAN_DIR>/ с прежними решениями.It follows the routing stack in order, unless the dossier shows a tighter first read: the repo map or index doc, the architecture doc, the build or ops doc, the dependency or stack doc, then your code index or <PLAN_DIR>/ for prior decisions.Він іде по стеку маршрутизації за порядком, якщо досьє не вказує точнішого першого читання: мапа репозиторію чи індексний документ, документ про архітектуру, про збірку й експлуатацію, про залежності та стек, потім індекс коду або <PLAN_DIR>/ з попередніми рішеннями.
  4. Он углубляется в файлы реализации наименьшим набором дальнейших чтений, который отвечает на вопрос, и использует досье, чтобы не искать заново. Вопросы, затрагивающие несколько поверхностей, опираются на разделы досье.It drills into the implementation files with the smallest set of follow-up reads that answers the question, using the dossier to avoid re-grepping. Cross-surface questions stay grounded in the dossier sections.Він заглиблюється у файли реалізації найменшим набором подальших читань, що відповідає на запитання, і використовує досьє, щоб не шукати заново. Запитання, що зачіпають кілька поверхонь, спираються на розділи досьє.
  5. Только для запуска по тикету: он пишет отобранные выводы в <PLAN_DIR>/<ID>_<slug>/research/<NN>__<topic-slug>.md, создавая папку, если её нет: заключения, выбранный вариант, отвергнутые варианты с причинами, затронутые области. Сырые выдачи grep туда не попадают, а досье остаётся черновым.Ticket-bound runs only: it writes curated findings to <PLAN_DIR>/<ID>_<slug>/research/<NN>__<topic-slug>.md, creating the folder if missing - conclusions, the chosen option, rejected options with reasons, affected areas. Raw grep dumps stay out, and the dossier stays scratch.Лише для запуску за тікетом: він пише відібрані висновки в <PLAN_DIR>/<ID>_<slug>/research/<NN>__<topic-slug>.md, створюючи теку, якщо її немає: висновки, обраний варіант, відхилені варіанти з причинами, зачеплені ділянки. Сирі видачі grep туди не потрапляють, а досьє лишається чорновим.
  6. Он сообщает путь к досье, для запуска по тикету - путь к артефакту, следующие 3-6 самых ценных чтений, а затем ответ на ваш вопрос. Раздел без совпадений так и называется, и работа продолжается: отсутствие - тоже находка.It reports the dossier path, the artifact path for a ticket-bound run, the next 3 to 6 high-value reads, and then the answer to your question. A section with no matches is stated as such and the work continues: absence is a finding.Він повідомляє шлях до досьє, для запуску за тікетом - шлях до артефакту, наступні 3-6 найцінніших читань, а потім відповідь на ваше запитання. Розділ без збігів так і називається, і робота триває: відсутність - теж знахідка.
Что вы должны увидетьWhat you should seeЩо ви маєте побачити

Досье в scratch-каталоге, для запуска по тикету - файл выводов в папке research/ тикета, короткий список следующих чтений и прямой ответ на вопрос.A dossier in the scratch directory, for a ticket-bound run a findings file under the ticket's research/ folder, a short list of next reads and a direct answer to the question.Досьє в scratch-каталозі, для запуску за тікетом - файл висновків у теці research/ тікета, короткий список наступних читань і пряма відповідь на запитання.

СоветыTipsПоради

  • Досье нужно лишь затем, чтобы не повторять глобальные поиски, поэтому небрежность допустима. Файл выводов - долговечный результат, который потребит тактический план: пишите заключения и причины, а не выдачу поиска. См. как разбить спеку на план.The dossier exists only to stop repeated global greps, so rough is fine. The findings file is the durable result that a tactical plan will consume: write conclusions and reasons, not search output. See break a spec into a plan.Досьє потрібне лише для того, щоб не повторювати глобальні пошуки, тому недбалість припустима. Файл висновків - довговічний результат, який спожиє тактичний план: пишіть висновки й причини, а не видачу пошуку. Див. як розбити спеку на план.

Термины на этой страницеTerms on this pageТерміни на цій сторінці

Поиск по порталуSearch the portalПошук по порталу