AgentSkillsCN

design-api

当用户提出设计 API、制定 API 规范，或规划 API 端点时自动触发，并自动转交由 API 设计师代理处理。

SKILL.md
--- frontmatter
name: design-api
description: Triggered when user asks to design APIs, create API specifications, or plan API endpoints. Automatically delegates to the api-designer agent.
allowed-tools: Read, Grep, Glob
context: fork
agent: api-designer

Design API Skill

Trigger Phrases

This skill is automatically triggered when the user:

  • •Asks to "design API" or "create API"
  • •Requests API endpoints or specifications
  • •Wants REST API design
  • •Mentions "API design", "endpoints", or "API documentation"
  • •Asks about API structure or patterns

Delegation Instructions

When this skill is triggered:

  1. •Delegate immediately to the api-designer agent
  2. •Provide API requirements and use cases
  3. •Include resource definitions
  4. •Specify API style preferences (REST, GraphQL, etc.)
  5. •Include any constraints or standards

Context to Pass

  • •API Purpose: What the API needs to do
  • •Resources: Resources the API will manage
  • •Use Cases: Main use cases and workflows
  • •API Style: REST, GraphQL, RPC, etc.
  • •Standards: Any API standards to follow
  • •Constraints: Rate limiting, authentication, etc.

Agent Responsibilities

The api-designer agent will:

  1. •Design API structure and endpoints
  2. •Define request/response schemas
  3. •Plan error handling
  4. •Ensure RESTful design
  5. •Create API documentation
  6. •Follow API best practices