Token导航 LogoToken导航TokenDH.com
研究检索需要联网github未标认证来源可访问许可证需确认审计提醒

code-design-api代码设计 API

Agent Skill

用于辅助 API 设计、接口文档、请求响应结构和服务集成说明。它适合让 Agent 梳理 endpoint、生成 OpenAPI 草稿、检查字段命名、整理错误码或辅助前后端联调。使用时需要确认真实业务语义、鉴权方式、分页和错误处理规则;涉及生成接口文档时,应避免凭空补字段,最好从现有代码、schema 或接口样例中提取事实。

总安装

367

周安装

15

GitHub Stars

8

下载量

118
CodexClaudeCursorGemini CLI

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

GitHub

来源数

2

许可证

unknown

最后核验

2026-05-01

来源状态

来源可访问

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:code-design-api(代码设计 API)
来源仓库:https://github.com/sirn/dotfiles
仓库路径:skills/code-design-api
安装命令:
npx skills add https://github.com/sirn/dotfiles --skill code-design-api
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill;本站只展示命令,不托管安装包,也不自动执行。

skills.shnpx skills
npx skills add https://github.com/sirn/dotfiles --skill code-design-api

简介

code-design-api 用于辅助 API 设计、接口文档和响应结构梳理,适合生成 OpenAPI 草稿和联调支持。

  • 它能规范 endpoint 命名、校验字段规则、整理错误码体系,并基于真实业务语义设计服务契约。
  • 使用时需结合实际代码或 schema 提取事实,避免凭空补充未经验证的接口细节。
  • 安装前应评估是否需要访问外部资源或生成敏感配置,防止泄露鉴权密钥等安全信息。
  • 适用宿主包括 Codex、Claude、Cursor、Gemini CLI,接入前应确认版本、权限和运行环境要求。

SKILL.md

Design API contracts, schemas, and specifications before implementation.

Process

  1. Identify context:

- Protocol: REST, GraphQL, gRPC, TRPC - Format: OpenAPI/Swagger, Protocol Buffers, Zod/TypeBox schemas

  1. Research and design:

- Lookup best practices for the protocol (use WebSearch/WebFetch) - Design the API resources, endpoints, and data shapes - Consider versioning, pagination, error handling patterns

  1. Output the design:

- Endpoints/Operations: Method, Path, Name - Request Schema: input validation rules - Response Schema: Success/Error shapes - Examples: JSON/Text payloads

Output

  1. API Specification (OpenAPI YAML, Proto file, or Interface code)
  2. Usage Example (curl or client code)
  3. Design Rationale (RESTfulness, Breaking changes avoidance)

适合场景

01

用户想查找某类 Agent Skill 时

02

需要根据任务场景推荐可安装能力包时

03

需要对比不同来源的安装命令和来源信息时

能力概览

能力 1

按任务关键词查找相关 Skills

能力 2

展示可复制的安装命令

能力 3

保留来源站点、仓库和原始说明,方便继续核验

能力 4

展示第三方安全扫描或审计结果

安装后应在对应宿主中按原始 README 的触发条件使用;具体调用方式请以来源页面和 README 为准。

平台分布

Codex

36.42%
按下载量换算43

Claude

28.3%
按下载量换算33

Cursor

18.63%
按下载量换算22

Gemini CLI

9.42%
按下载量换算11

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

可疑

权限和风险

需要联网

该 Skill 可能需要联网访问来源站点、仓库或外部 API;具体网络访问范围需要结合源码和 README 复核。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。来源安全扫描存在 warning/failed 结果,不能写成本站确认安全。当前只有一个来源,正式发布前建议补源仓库或其他目录站核验。

来源信息

继续浏览同类 Skills