azure-functions-typescript — правило для GitHub Copilot: код Azure
Правило задаёт Copilot соглашения для TypeScript API на Azure Functions: от асинхронного кода до структуры файлов функций. При изменении API оно напоминает обновить OpenAPI-схему и README.md.
.github/instructions/azure-functions-typescript.instructions.mdЧто делает azure-functions-typescript
Правило применяется к файлам *.ts, *.js и *.json. Оно просит генерировать современный TypeScript для Node.js и использовать async/await. Для асинхронных операций рекомендуются API вроде node:fs/promises, чтобы не блокировать цикл событий; при добавлении зависимости Copilot должен сначала спросить разрешение.
API рассчитан на Azure Functions с пакетом @azure/functions@4. Для каждого endpoint правило задаёт отдельный файл вида src/functions/<resource-name>-<http-verb>.ts. Это значит, что функции нужно раскладывать по этому соглашению, а при изменениях API обновлять OpenAPI-схему, если она есть, и README.md. Для встроенных модулей Node.js правило советует по возможности ориентироваться на Node.js v22 LTS.
Какие задачи решает
- структурировать функции API по отдельным файлам
- использовать асинхронные API Node.js без блокировки цикла событий
- согласовать изменения API с OpenAPI-схемой и README.md
- не добавлять зависимости без предварительного вопроса
Примеры запросов агенту
- Добавь HTTP endpoint для заказов и размести его в
src/functions/orders-get.ts. - Перепиши чтение файлов на асинхронный API Node.js, не блокируя цикл событий.
- Обнови API и синхронизируй изменения с OpenAPI-схемой и
README.md.
Как установить azure-functions-typescript
Вручную: положить файлы
.github/instructions/azure-functions-typescript.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.claude/rules/azure-functions-typescript.mdПоле paths во frontmatter ограничивает файлы: applyTo из источника → paths
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/azure-functions-typescript.mdcВо frontmatter: description, globs, alwaysApply. applyTo из источника → globs, иначе правило само не подключится
Вручную: положить файлы
.devin/rules/azure-functions-typescript.mdВручную: положить файлы
.clinerules/azure-functions-typescript.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о azure-functions-typescript
Как установить azure-functions-typescript в GitHub Copilot?
Добавьте файл правила в проект по пути .github/instructions/azure-functions-typescript.instructions.md.
Что делает azure-functions-typescript?
Задаёт Copilot соглашения для TypeScript-кода Azure Functions: асинхронные операции, структуру файлов endpoint и обновление документации API.
Как правило предлагает организовать endpoint?
Каждый endpoint должен находиться в отдельном файле src/functions/<resource-name>-<http-verb>.ts.
Исходный текст
azure-functions-typescript.instructions.md · MIT
--- description: 'TypeScript patterns for Azure Functions' applyTo: '**/*.ts, **/*.js, **/*.json' --- ## Guidance for Code Generation - Generate modern TypeScript code for Node.js - Use `async/await` for asynchronous code - Whenever possible, use Node.js v22 LTS built-in modules instead of external packages - Always use Node.js async functions, like `node:fs/promises` instead of `fs` to avoid blocking the event loop - Ask before adding any extra dependencies to the project - The API is built using Azure Functions using `@azure/functions@4` package. - Each endpoint should have its own function file, and use the following naming convention: `src/functions/<resource-name>-<http-verb>.ts` - When making changes to the API, make sure to update the OpenAPI schema (if it exists) and `README.md` file accordingly.
© github · MIT · github/awesome-copilot