Когда это нужно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
Без идентификатора тикета ничего не сохраняется вне чернового досье в 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Кроки
- Назовите тему:
/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 asT0042,JIRA-123or 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>), робить запуск прив'язаним до тікета, решта - тема. Названу вами мету агент бере як є, а зачеплену ділянку виводить із запиту та відкритого файлу. - До широкого чтения агент пишет досье в
<SCRATCH_DIR>/research_<topic-slug>.mdпо быстрому обходу: что читать первым, подходящие файлы и символы (один проход grep или индекса кода, не исчерпывающий), существующие спеки и планы в этой области и короткий список следующих чтений.Before broad reading, the agent writes the dossier to<SCRATCH_DIR>/research_<topic-slug>.mdfrom 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 чи індексу коду, не вичерпний), наявні спеки та плани в цій ділянці й короткий список наступних читань. - Он идёт по стеку маршрутизации по порядку, если досье не указывает более точного первого чтения: карта репозитория или индексный документ, документ об архитектуре, о сборке и эксплуатации, о зависимостях и стеке, затем индекс кода или
<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>/з попередніми рішеннями. - Он углубляется в файлы реализации наименьшим набором дальнейших чтений, который отвечает на вопрос, и использует досье, чтобы не искать заново. Вопросы, затрагивающие несколько поверхностей, опираются на разделы досье.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.Він заглиблюється у файли реалізації найменшим набором подальших читань, що відповідає на запитання, і використовує досьє, щоб не шукати заново. Запитання, що зачіпають кілька поверхонь, спираються на розділи досьє.
- Только для запуска по тикету: он пишет отобранные выводы в
<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 туди не потрапляють, а досьє лишається чорновим. - Он сообщает путь к досье, для запуска по тикету - путь к артефакту, следующие 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 найцінніших читань, а потім відповідь на ваше запитання. Розділ без збігів так і називається, і робота триває: відсутність - теж знахідка.
Досье в 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.Досьє потрібне лише для того, щоб не повторювати глобальні пошуки, тому недбалість припустима. Файл висновків - довговічний результат, який спожиє тактичний план: пишіть висновки й причини, а не видачу пошуку. Див. як розбити спеку на план.
Связанные функцииRelated functionsПов'язані функції
- Превратить описание фичи в утверждённую стратегическую спекуTurn a feature description into an approved strategic specПеретворити опис фічі на затверджену стратегічну спеку
/specпишет, что и зачем нужно в фиче, без имён классов и путей к файлам, утверждает и передаёт/spec-tech. Мелкую задачу делает на месте./specwrites the what and why of a feature with no class names or file paths, approves it and passes it to/spec-tech. A small task is built in place./specпише, що й навіщо потрібно у фічі, без назв класів і шляхів до файлів, затверджує та передає/spec-tech. Дрібну задачу робить на місці. - Разбить утверждённую спеку на поэтапный план с проверкой каждого шагаTurn an approved spec into a phased plan with a check on every stepРозбити затверджену спеку на поетапний план із перевіркою кожного кроку
/spec-techпишет тактический план: индекс и файлы фаз, каждый шаг кончается статической проверкой, а порядок фаз сам проверяется до смены статуса./spec-techwrites the tactical plan: an index and phase files, each step ending in a static check, with the phase order self-reviewed before the status flips./spec-techпише тактичний план: індекс і файли фаз, кожен крок закінчується статичною перевіркою, а порядок фаз сам перевіряється до зміни статусу. - Исправить узкий баг без церемонийFix a narrow bug without ceremonyВиправити вузький баг без церемонійБаг с понятной причиной исправлен в корне: минимальная правка, одна локальная проверка, отчёт в три строки, без спеки.A bug with a known cause is fixed at the root: smallest change, one local check, a three-line report, no spec.Баг зі зрозумілою причиною виправлено в корені: мінімальна правка, одна локальна перевірка, звіт у три рядки, без спеки.
- Научить агента искать, а не угадыватьMake the agent look things up instead of guessingНавчити агента шукати, а не вгадуватиФиксированный порядок поиска и, для большого проекта, поддерживаемый индекс вашего материала: каждый путь, символ и API, названные агентом, проверены.A fixed order for finding things and, for a big project, a maintained index of your material, so every path, symbol and API the agent states has been verified.Фіксований порядок пошуку і, для великого проєкту, підтримуваний індекс вашого матеріалу: кожен шлях, символ і API, названі агентом, перевірені.