Azure/typespec-azure

Azure 资料

最近记录的来源活动: 2026年9月29日 20:59

SkillsMP 收录数据更新: 2026年10月17日 00:09

已收集 skills: 8

GitHub 星标: 27
GitHub Forks: 91

仓库 README

仓库 README 来源：README.md

查看 README 源文件

展开完整 README

# TypeSpec Azure Libraries [TypeSpec](https://github.com/microsoft/typespec) is a language for describing cloud service APIs and generating other API description languages, client and service code, documentation, and other assets. This repository adds common Azure-specific TypeSpec libraries to the [TypeSpec](https://github.com/microsoft/typespec) core that is pulled in as a git submodule. ## Try TypeSpec without installing anything You can try TypeSpec on the web without installing anything. [TypeSpec playground for Azure services](https://cadlplayground.z22.web.core.windows.net/cadl-azure/) ## Prerequisites - To use these libraries, install [Node.js](https://nodejs.org/) (24 LTS or later) and ensure you can run `node --version` from a command prompt. - To develop this repository, install and activate [mise](https://mise.jdx.dev/getting-started.html). From the repository root, run `mise install` to install the development tools defined by `mise.toml` and `mise.lock`. See the [contributing guide](CONTRIBUTING.md#prerequisites) for the complete setup. ## Getting Started For TypeSpec language documentation, see https://typespec.io/docs. If you are team working on Azure, see TypeSpec Azure development documentation https://azure.github.io/typespec-azure. You should pre-install as well `@azure-tools/typespec-azure-core` to define Azure resources, and `@azure-tools/typespec-autorest` to export in Swagger: ``` pnpm add @typespec/rest @typespec/openapi3 @azure-tools/typespec-azure-core @azure-tools/typespec-autorest ``` > If you plan to use the output openapi with autorest or any of the azure sdk tooling _you should use typespec-autorest_, the openapi3 emitter is not going to have any of the ms extensions (pageable, lro, client name, etc.) and so it will be losing information. ## Build Pipelines Information on using TypeSpec within build pipelines [can be found here](https://azure.github.io/typespec-azure/docs/howtos/rest-api-publish/buildpipelines) ## Packages | Name | Changelog | Latest | Next | | ----------------------------------------------------------------------------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------- | | [@azure-tools/typespec-autorest][typespec-autorest_src] | [Changelog][typespec-autorest_chg] | [![](https://img.shields.io/npm/v/@azure-tools/typespec-autorest)](https://www.npmjs.com/package/@azure-tools/typespec-autorest) | ![](https://img.shields.io/npm/v/@azure-tools/typespec-autorest/next) | | [@azure-tools/typespec-azure-core][typespec-azure-core_src] | [Changelog][typespec-azure-core_chg] | [![](https://img.shields.io/npm/v/@azure-tools/typespec-azure-core)](https://www.npmjs.com/package/@azure-tools/typespec-azure-core) | ![](https://img.shields.io/npm/@azure-tools/typespec-azure-core/next) | | [@azure-tools/typespec-resource-manager][typespec-azure-resource-manager_src] | [Changelog][typespec-azure-resource-manager_chg] | [![](https://img.shields.io/npm/v/@azure-tools/typespec-azure-resource-manager)](https://www.npmjs.com/package/@azure-tools/typespec-azure-resource-manager) | ![](https://img.shields.io/npm/@azure-tools/typespec-azure-resource-manager/next) | [typespec-autorest_src]: packages/typespec-autorest [typespec-autorest_chg]: packages/typespec-autorest/CHANGELOG.md [typespec-azure-core_src]: packages/typespec-azure-core [typespec-azure-core_chg]: packages/typespec-azure-core/CHANGELOG.md [typespec-azure-resource-manager_src]: packages/typespec-azure-resource-manager [typespec-azure-resource-manager_chg]: packages/typespec-azure-resource-manager/CHANGELOG.md `@next` version of the package are the latest versions available on the `main` branch. ### Package Layering The main packages in this repository can be considered a series of layers which progressively add functionality for specific scenarios: - [**@azure-tools/typespec-azure-core:**](https://github.com/Azure/typespec-azure/tree/main/packages/typespec-azure-core) Provides core models and interfaces for Azure service modelling - [**@azure-tools/typespec-azure-resource-manager:**](https://github.com/Azure/typespec-azure/tree/main/packages/typespec-azure-resource-manager) Provides additional models and interfaces for modelling Azure Resource Manager services

正在加载仓库 README…

这个仓库中的 skills

软件开发工程师软件质量保证分析师与测试员项目管理专家

3 个职业分类 · 已分类 88%

skill

职业分类

描述

更新

code-review

未分类

Review diffs and pull requests in Azure/typespec-azure for compatibility, .chronus change descriptions, TypeSpec diagnostics and rulesets, SDK emitter and Spector contract regressions, and meaningful tests. Use for Copilot code review in this repository.

原文语言：英语

2026-09-29

typespec-python-release

软件开发工程师

Release @azure-tools/typespec-python after updating @typespec/http-client-python. Use when: preparing, publishing, or creating a PR for a TypeSpec Python emitter release.

原文语言：英语

2026-09-11

typespec-ts-add-spector-test

软件质量保证分析师与测试员

Add or update Spector end-to-end tests for the @azure-tools/typespec-ts emitter in packages/typespec-ts. Use when given Spector case paths, links to http-specs or azure-http-specs cases, or pull requests that add or change Spector scenarios and the TypeScript…

原文语言：英语

2026-08-26

create-linter-rule

软件开发工程师

Create a new TypeSpec linter rule, lint diagnostic, or design guideline checker with a TDD approach, including implementation, tests, documentation, ruleset registration, and changeset. Use this skill when asked to create, add, implement, or write a new…

原文语言：英语

2026-08-04

typespec-go-add-spector-test

软件质量保证分析师与测试员

Adds a Spector mock API test for the typespec-go emitter. Use when given a Spector case link (http-specs or azure-http-specs) to opt the spec into generation, write Go client tests, and validate them against the Spector mock server.

原文语言：英语

2026-07-28

tcgc-newsletter

项目管理专家

Compose a TCGC monthly newsletter for @azure-tools/typespec-client-generator-core. Use when: writing newsletter, creating release notes, summarizing TCGC changes, drafting monthly update.

原文语言：英语

2026-04-20

doc-example-generator

软件开发工程师

Generate verified code examples for TypeSpec documentation. Use this skill to create TypeSpec examples that compile successfully, then run each language emitter to extract real API surface code for the <ClientTabs> blocks in user-facing docs.

原文语言：英语

2026-03-23

hotfix-release

软件开发工程师

Publish a hotfix (patch) release for one or more packages from an existing release branch. Use when the user wants to kick, start, or perform a hotfix release on a release/* branch.

原文语言：英语

2026-02-25

已展示 8 / 8 个已收集 Skill。

用 AI 助手安装

复制这段 Prompt，发给你正在使用的 AI 助手。

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/Azure/typespec-azure.