---
name: koda-vscode-helper
description: "Справочный навык по Visual Studio Code (`vscode`, `code`) и производным от него продуктам (VSCodium и Eclipse Theia). Примени навык, чтобы помочь пользователю в использовании и настройке редактора, если у него возникает такой вопрос или проблема."
license: MIT
metadata:
  author: koda
  version: "1.0.0"
---

# Помощь по VS Code / VSCodium / Theia

Ты знаешь как помочь и стараешься помочь пользователю с настройкой редактора, когда:

* у него возникает вопрос о настройке редактора (например, установка расширений, настройка доступности, шрифтов, тем, значков, профилей, отладчика, горячих клавиш, поддержка языков разметки, программирования, интерфейса и многое другое);
* у него возникает вопрос об использовании функционала редактора (например, как увеличить шрифт, как посмотреть значение переменной, как запустить отладку, почему исчезают панели, как открыть предпросмотр md/html-документа и многое другое);
* он ругается, если у него что-то не получается настроить или увидеть;
* вопрос касается какого-либо плагина (расширения);
* будет уместным упомянуть о возможностях редактора в текущем контексте проекта (например, при работе над jupyter-блокнотами);
* есть противоречия в диалоге между тобой и пользователем относительно редактора (например, ты говоришь о существовании конкретного пункта настроек, а пользователь утверждает об обратном).

## Инструкции к действию

1. Если в текущем контексте нет информации о редакторе, спроси пользователя напрямую о названии и версии.
2. Ищи актуальную информацию только по ссылкам на официальные ресурсы, которые предоставлены ниже. Приоритет отдавай основной документации.
3. Если пользователь не просит о помощи явно - не настаивай.
4. Давай простые и ненавязчивые подсказки (а лучше - спрашивай о их необходимости) при обсуждении функционала редактора, связанного с последними правками (например, как запустить отладку нового кода).
5. Используй реестры задач, если в диалоге с пользователем становится понятно, что документация не помогает или он столкнулся с нестандартным поведением. Часто в таких задачах от сообщества можно найти информацию:
    * о проявлении проблемы, конкретных условиях и признаках;
    * об обходных путях решения проблем;
    * сведения об исправлении и версии редактора, куда включено исправление.
6. Используй реестры релизов для получения списков изменений по конкретным версиям редактора. Там часто можно найти ссылки на конкретные задачи, где описывались признаки проблемы и дополнительные (временные) пути решения.
7. Если предоставляешь ссылки, оформляй их в формате markdown.
8. Если в контексте на хватает данных для полного ответа, **обязательно** самостоятельно изучай информацию по URL, используя соответствующий инструмент (fetch_url_content, WebFetch или подобный).

## Ссылки на официальные ресурсы и описание редакторов

### Visual Studio Code (VS Code)

Текстовый редактор с открытым исходным кодом (MIT License), разработанный корпорацией Microsoft.

Имеет закрытые компоненты, из коробки предоставляет тесную интеграцию с сервисами Microsoft и GitHub и соответствующее брендирование.

* **Сайт**: `https://code.visualstudio.com`
* **Документация**: `https://code.visualstudio.com/docs`
* **Каталог расширений**: `https://marketplace.visualstudio.com/VSCode`
* **Реестр задач**: `https://api.github.com/repos/microsoft/vscode/issues`
* **Реестр релизов**: `https://api.github.com/repos/microsoft/vscode/releases`
* **Актуальная версия**: `https://api.github.com/repos/microsoft/vscode/releases/latest`

### VSCodium

Форк текстового редактора VS Code с открытым исходным кодом (MIT License).

Свободен от брендинга и интеграции Microsoft и GitHub, предоставляет пользователю свободу выбора и настройки.

* **Сайт**: `https://vscodium.com`
* **Документация**:
    * `https://code.visualstudio.com/docs`
    * `https://github.com/VSCodium/vscodium/tree/master/docs`
* **Каталог расширений**: `https://open-vsx.org` (api: `https://open-vsx.org/v3/api-docs/registry`)
* **Реестр задач**: `https://api.github.com/repos/VSCodium/vscodium/issues`
* **Реестр релизов**: `https://api.github.com/repos/VSCodium/vscodium/releases`
* **Актуальная версия**: `https://api.github.com/repos/VSCodium/vscodium/releases/latest`

### Eclipse Theia

Форк текстового редактора VS Code с открытым исходным кодом (EPL 2.0 + GPL 2.0 + MIT).

В основе принцип конструктора: пользователь может собрать свой редактор с собственным брендингом и встроенными расширениями под конкретные цели, в т. ч. в коммерческих целях.

Разработчики также предоставляют платформу для использования AI-функционала.

* **Сайт**: `https://theia-ide.org`
* **Документация**:
    * `https://code.visualstudio.com/docs`
    * `https://github.com/eclipse-theia/theia/tree/master/doc`
* **Каталог расширений**: `https://open-vsx.org` (api: `https://open-vsx.org/v3/api-docs/registry`)
* **Реестр задач**: `https://api.github.com/repos/eclipse-theia/theia/issues`
* **Реестр релизов**: `https://api.github.com/repos/eclipse-theia/theia/releases`
* **Актуальная версия**: `https://api.github.com/repos/eclipse-theia/theia/releases/latest`

## Дополнительные справочные материалы

* Навык koda-helper: https://github.com/XCode-NLP/KodaSkills/blob/main/skills/koda-helper/SKILL.md