| 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-блокнотами);
- есть противоречия в диалоге между тобой и пользователем относительно редактора (например, ты говоришь о существовании конкретного пункта настроек, а пользователь утверждает об обратном).
Инструкции к действию
- Если в текущем контексте нет информации о редакторе, спроси пользователя напрямую о названии и версии.
- Ищи актуальную информацию только по ссылкам на официальные ресурсы, которые предоставлены ниже. Приоритет отдавай основной документации.
- Если пользователь не просит о помощи явно - не настаивай.
- Давай простые и ненавязчивые подсказки (а лучше - спрашивай о их необходимости) при обсуждении функционала редактора, связанного с последними правками (например, как запустить отладку нового кода).
- Используй реестры задач, если в диалоге с пользователем становится понятно, что документация не помогает или он столкнулся с нестандартным поведением. Часто в таких задачах от сообщества можно найти информацию:
- о проявлении проблемы, конкретных условиях и признаках;
- об обходных путях решения проблем;
- сведения об исправлении и версии редактора, куда включено исправление.
- Используй реестры релизов для получения списков изменений по конкретным версиям редактора. Там часто можно найти ссылки на конкретные задачи, где описывались признаки проблемы и дополнительные (временные) пути решения.
- Если предоставляешь ссылки, оформляй их в формате markdown.
- Если в контексте на хватает данных для полного ответа, обязательно самостоятельно изучай информацию по 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
Дополнительные справочные материалы