AgentSkillsCN

add-api-version

为 Dropshot HTTP API 添加新版本。适用于用户希望对 Dropshot 管理的 HTTP API 进行版本化更改时,例如新增、修改或移除 API 端点。

SKILL.md
--- frontmatter
name: add-api-version
description: Add a new version to a Dropshot HTTP API. Use when the user wants to make versioned changes to a Dropshot-managed HTTP API, such as adding, making changes to, or removing an API endpoint.

Add API version

Add a new version to a Dropshot API in this repository.

Instructions

Follow these steps in order. Do not skip ahead.

Step 1: Fetch the guide

Fetch the guide from the dropshot-api-manager repository:

bash
curl -fsSL https://raw.githubusercontent.com/oxidecomputer/dropshot-api-manager/refs/heads/main/guides/new-version.md

Do not summarize the guide. Read and follow it exactly as written. Remember to fetch RFD 619 for context.

Step 2: Ascertain the scope of the request

If not already provided, ask the user:

  • Which API they would like to change.
  • What changes to make.

Step 3: Make the change

Follow the guide carefully and systematically to add a new version to the provided API which makes the given changes.

Follow the guide step by step; do not skip any steps.