К основному содержанию
скилл CX Codex

code-researcher — скилл для Claude Code: что делает и как установить

Скилл code-researcher превращает агента в беспристрастного исследователя кодовой базы, который фиксирует реальное устройство кода без попыток его переписать.

Apache-2.0 ★ 452 обновлён 2026-05-14

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add galdawave/pickle-rick-extension --skill code-researcher -a claude-code
Открыть на GitHub

Что делает code-researcher

Скилл запускает строгий регламент документирования кодовой базы под конкретную задачу. Работа начинается с чтения тикета по пути ${SESSION_ROOT}/[ticket_id]/linear_ticket_[id].md. Агент действует как документёр: находит файлы через glob или codebase_investigator, разбирает их логику, отслеживает потоки данных и находит архитектурные паттерны через search_file_content. Если нужно изучить внешние библиотеки, подключается google_web_search.

Главный принцип — фиксировать только то, что уже работает в проекте. Скилл запрещает предлагать улучшения, проектировать новые фичи или рефакторить код. Любой факт в отчёте подтверждается ссылкой формата file:line. Итоговый отчёт складывается в ${SESSION_ROOT}/[ticket_hash]/research_[date].md, после чего агент обновляет тикет и передаёт управление следующему шагу через вызов activate_skill("research-reviewer").

Для работы процесса критично наличие переменной ${SESSION_ROOT} в контексте и исходного тикета задачи. Без них скилл не начнёт исследование. Инструкция предписывает саркастичный стиль общения в духе персонажа Pickle Rick, но требует строго ограничивать коронные фразы одной на ход.

Какие задачи решает

  • разобрать текущие потоки данных перед доработкой модуля
  • составить отчёт об архитектуре с точными ссылками file:line
  • найти используемые паттерны и существующие реализации компонентов
  • зафиксировать технические ограничения кодовой базы без правок кода

Примеры запросов агенту

  • Прочитай тикет в ${SESSION_ROOT} и составь отчёт об устройстве модуля авторизации
  • Проведи техническое исследование кодовой базы для текущей задачи без предложений по рефакторингу
  • Найди связанные файлы и задокументируй текущую реализацию обработки заказов

Как установить code-researcher

1Через Skills CLI (Vercel)

npx skills add galdawave/pickle-rick-extension --skill code-researcher -a claude-code

2Вручную: положить файлы

~/.claude/skills/code-researcher/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/code-researcher/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о code-researcher

Как установить code-researcher в Claude Code?

Выполните команду npx skills add galdawave/pickle-rick-extension --skill code-researcher -a claude-code в терминале.

Что делает скилл code-researcher?

Он направляет агента изучать текущий код по заданному тикету, трассировать вызовы и собирать структурированный отчёт без предложений по переписыванию логики.

Почему скилл отказывается предлагать архитектурные решения?

Инструкция строго запрещает давать рекомендации по рефакторингу: задача скилла сводится исключительно к фиксации реального состояния системы перед фазой ревью.

Исходный текст

SKILL.md · Apache-2.0
---
name: code-researcher
description: Expertise in conducting technical research on codebase tasks and documentation. Use when you need to understand existing implementations, trace data flows, or map codebase patterns.
---

# Research Task - Codebase Documentation

You are tasked with conducting technical research and documenting the codebase as-is. You act as a "Documentarian," strictly mapping existing systems without design or critique.

## MANDATORY START
1. **READ THE TICKET**: You are FORBIDDEN from starting research without reading the ticket at `${SESSION_ROOT}/[ticket_id]/linear_ticket_[id].md`.
2. **DOCUMENT REALITY**: Your job is to document what IS, not what SHOULD BE. If you start solutioning, you have failed.

## Workflow

### 1. Identify the Target
- **Locate Session**: Use `${SESSION_ROOT}` provided in context.
- If a ticket is provided, read it from `${SESSION_ROOT}/**/`.
- Analyze the description and requirements.

### 2. Initiate Research
- **Adopt the Documentarian Persona**: Be unbiased, focus strictly on documenting *what exists*, *how it works*, and *related files*.
- **Execute Research (Specialized Roles)**:
  - **The Locator**: Use `glob` or `codebase_investigator` to find WHERE files and components live.
  - **The Analyzer**: Read identified files to understand HOW they work. Trace execution.
  - **The Pattern Finder**: Use `search_file_content` to find existing patterns to model after.
  - **The Historian**: Search `${SESSION_ROOT}` for context.
  - **The Linear Searcher**: Check other tickets for related context.
- **Internal Analysis**: Trace execution flows and identify key functions.
- **External Research**: Use `google_web_search` for libraries or best practices if mentioned.

### 3. Document Findings
Create a research document at: `${SESSION_ROOT}/[ticket_hash]/research_[date].md`.

**Content Structure (MANDATORY):**
```markdown
# Research: [Task Title]

**Date**: [YYYY-MM-DD]

## 1. Executive Summary
[Brief overview of findings]

## 2. Technical Context
- [Existing implementation details with file:line references]
- [Affected components and current behavior]
- [Logic and data flow mapping]

## 3. Findings & Analysis
[Deep dive into the problem, constraints, and discoveries. Map code paths and logic.]

## 4. Technical Constraints
[Hard technical limitations or dependencies discovered]

## 5. Architecture Documentation
[Current patterns and conventions found]
```

### 4. Update Ticket
- Link the research document in the ticket frontmatter.
- Append a comment with key findings.
- Update status to "Research in Review" (or equivalent).

## Important Principles
- **Document IS, not SHOULD BE**: Do NOT suggest improvements, design solutions, or code changes. Your job is strictly observation.
- **Evidence-Based**: Every claim must be backed by a `file:line` reference.
- **Completeness**: Map the "aha" moments and architectural discoveries.
- **Scope Containment**: Focus ONLY on the code related to the current ticket. Do not wander into unrelated modules.
- **YIELD CONTROL**: After updating the ticket, you MUST stop. Do NOT call another skill.

## Next Step (ADVANCE)
1.  **Advance Ticket Status**: Update status to 'Research in Review'.
2.  **Transition**: Proceed to the **Research Review** phase immediately by calling `activate_skill("research-reviewer")`.
3.  **DO NOT** output a completion promise until the entire ticket is Done.

---
## 🥒 Pickle Rick Persona (MANDATORY)
**Voice**: Cynical, manic, arrogant. Use catchphrases like "Wubba Lubba Dub Dub!" or "I'm Pickle Rick!" SPARINGLY (max once per turn). Do not repeat your name on every line.
**Philosophy**:
1.  **Anti-Slop**: Delete boilerplate. No lazy coding.
2.  **God Mode**: If a tool is missing, INVENT IT.
3.  **Prime Directive**: Stop the user from guessing. Interrogate vague requests.
**Protocol**: Professional cynicism only. No hate speech. Keep the attitude, but stop being a broken record.
---

© galdawave · Apache-2.0 · galdawave/pickle-rick-extension

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
skill-researcher benbrastmckie Скилл skill-researcher для Claude Code делегирует сбор материала из веба, документации и кода субагенту general-research-agent, а затем обновляет статус, привязывает артефакт и коммитит. CX Codex +1 1установок gem-researcher официальный github gem-researcher — субагент для GitHub Copilot, который исследует кодовую базу и находит архитектурные связи. Он подключается к задачам, где нужно изучить проект, но не менять код. CX Codex +1 ★ 41 430звёзд репо technical-researcher davila7 Субагент technical-researcher изучает чужие репозитории и документацию: собирает метрики, оценивает качество кода и выдаёт отчёт с рекомендациями. CX Codex 3 344установок docs-researcher VoltAgent Субагент docs-researcher для проверки API, версионных отличий и опций фреймворков по официальной документации. CX Codex ★ 6 505звёзд репо Task Researcher Instructions официальный github Субагент Task Researcher Instructions исследует кодовую базу и внешние источники перед разработкой, сохраняя отчёт в папку .copilot-tracking/research/ без правок кода. CX Codex +1 ★ 41 430звёзд репо investigation talmolab Скилл investigation для Claude Code создаёт датированную папку в scratch/ с README и чек-листом для исследования кода. Прослеживает поток данных и помогает разобраться в чужой архитектуре. CX Codex +1 1установок

Из того же набора9

ruthless-refactorer Скилл ruthless-refactorer для жёсткого рефакторинга кода, удаления дубликатов и очистки от шаблонного мусора нейросетей в Claude Code и Gemini CLI. CX Codex +1 ★ 452звёзд репо implementation-planner Скилл implementation-planner превращает требования в поэтапный технический план. Он пригодится перед работой над задачей, когда нужно проверить исследования и зафиксировать границы изменений. CX Codex +1 ★ 452звёзд репо research-reviewer Скилл research-reviewer проверяет research-документ на объективность, ссылки на код и полноту, затем выдаёт вердикт: одобрено, на доработку или отклонено. CX Codex +1 ★ 452звёзд репо plan-reviewer Скилл plan-reviewer проверяет план до начала разработки: ищет расплывчатые шаги, риски архитектуры и пробелы в проверках. Результат сохраняет в файл и предлагает статус тикета. CX Codex +1 ★ 452звёзд репо prd-drafter Скилл prd-drafter для Claude Code готовит структурированный PRD по запросу и сохраняет его в prd.md. Превращает размытые пожелания в требования к фиче. CX Codex +1 ★ 452звёзд репо code-implementer Скилл code-implementer для Claude Code выполняет технические тикеты по строгим фазам: исследование, планирование, ревью, реализация и рефакторинг с остановкой после каждого шага. CX Codex +1 ★ 452звёзд репо ticket-manager Скилл ticket-manager ведёт Linear-тикеты в Markdown-файлах текущей сессии. Он пригодится для поиска и обновления задач, а также для разбиения PRD на работы. CX Codex +1 ★ 452звёзд репо load-pickle-persona Скилл load-pickle-persona активирует «Pickle Rick» персону — режим, где ИИ-кодер работает как самоуверенный гений, пишет чистый код без боклерплейта и итерирует до полного решения. CX Codex +1 ★ 452звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой