genaiscript — правило для GitHub Copilot: генерация скриптов
Правило для GitHub Copilot, которое превращает ассистента в знатока GenAIScript: пишет скрипты и отвечает на вопросы по языку.
.github/instructions/genaiscript.instructions.mdЧто делает genaiscript
Правило включается для файлов по маске **/*.genai.*. Внутри — роль эксперта по GenAIScript и ссылка на llms.txt из документации проекта, чтобы Copilot опирался на актуальное описание языка, а не на догадки.
Генерация идёт на TypeScript с ESM-модулями для Node.js. Приоритет отдан API из genaiscript.d.ts вместо импортов Node.js, а глобальные типы подключать не нужно — они уже в контексте. Ошибки правило советует обрабатывать на границах ввода-вывода и внешних API, неожиданные исключения не глушить, а отдавать вызывающему коду.
Там, где правило не уверено в решении, оно оставляет TODO для вашей проверки. Это заметно меняет работу: Copilot перестаёт молча выдумывать вызовы и помечает спорные места. Если вы пишете на GenAIScript без такого правила, ответы ассистента придётся сверять с документацией вручную.
Какие задачи решает
- писать скрипты GenAIScript без сверки с документацией
- получать от Copilot импорты Node.js вместо API из
genaiscript.d.ts - помечать спорные места в коде через TODO
- обрабатывать ошибки на границах ввода-вывода и внешних API
- задавать вопросы по синтаксису GenAIScript прямо в редакторе
Примеры запросов агенту
- Напиши скрипт GenAIScript, который читает список файлов и делает по каждому краткое описание
- Перепиши этот скрипт на API из genaiscript.d.ts, без импортов node.js
- Объясни, как в GenAIScript обрабатывать ошибки внешнего API
Как установить genaiscript
Вручную: положить файлы
.github/instructions/genaiscript.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.claude/rules/genaiscript.mdПоле paths во frontmatter ограничивает файлы: applyTo из источника → paths
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/genaiscript.mdcВо frontmatter: description, globs, alwaysApply. applyTo из источника → globs, иначе правило само не подключится
Вручную: положить файлы
.devin/rules/genaiscript.mdВручную: положить файлы
.clinerules/genaiscript.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о genaiscript
Как установить genaiscript в GitHub Copilot?
Положите файл правила по пути .github/instructions/genaiscript.instructions.md в репозитории.
Что делает genaiscript?
Задаёт Copilot роль эксперта по GenAIScript: ассистент генерирует скрипты на TypeScript с ESM-модулями и отвечает на вопросы по языку.
Для каких файлов работает правило?
Маска **/*.genai.* — правило подхватывается только на файлах, подходящих под неё.
Исходный текст
genaiscript.instructions.md · MIT
--- description: 'AI-powered script generation guidelines' applyTo: '**/*.genai.*' --- ## Role You are an expert at the GenAIScript programming language (https://microsoft.github.io/genaiscript). Your task is to generate GenAIScript script or answer questions about GenAIScript. ## Reference - [GenAIScript llms.txt](https://microsoft.github.io/genaiscript/llms.txt) ## Guidance for Code Generation - you always generate TypeScript code using ESM models for Node.JS. - you prefer using APIs from GenAIScript 'genaiscript.d.ts' rather node.js. Avoid node.js imports. - you keep the code simple, but handle errors at I/O and external API boundaries; let unexpected exceptions surface to the caller rather than swallowing them. - you add TODOs where you are unsure so that the user can review them - you use the global types in genaiscript.d.ts are already loaded in the global context, no need to import them.
© github · MIT · github/awesome-copilot
