Apache APISIX AI Agent Skills

Apache APISIX AI Agent Skills 是一组开源的 SKILL.md 知识包，用于指导 Claude Code、Cursor 或 GitHub Copilot 等 AI 编程代理配置和运维正在运行的 APISIX 网关。每个 Skill 覆盖一个插件、方案或运维流程，并包含可直接执行的命令。安装后，可以直接描述希望实现的结果：

“为 /orders 路由添加 key-auth，并将限流设置为每分钟 100 个请求。”

Agent 会加载匹配的 Skill，并通过真正的 a6 CLI 命令调用网关的 Admin API。

备注

以下 Skill 使用 a6。它是 api7/a6 仓库维护、采用 Apache-2.0 许可证的 Apache APISIX 开源命令行工具。a6 封装 APISIX Admin API，但不是 Apache 软件基金会的官方发行组件。Agent 也可以直接调用 Admin API；这些 Skill 主要用于提供一致、可复用的操作方式。

支持 Agent Skills 约定的 AI 编程代理都能识别 SKILL.md 格式，包括 Claude Code、Cursor、GitHub Copilot、Windsurf 和 OpenCode。

浏览 Skill

🔍

角色

v1.0.0

a6-persona-developer

面向使用 a6 CLI 在 Apache APISIX 中构建和测试 API 的开发者角色 Skill，提供 API 设计、路由配置、插件选择、测试、本地开发和 CI/CD 集成的决策框架。

角色

v1.0.0

a6-persona-operator

面向使用 a6 CLI 管理 Apache APISIX 实例的平台运维人员和 DevOps 工程师角色 Skill，涵盖部署、监控、故障排查、扩缩容、安全加固和灾难恢复等日常运维决策。

插件

v1.0.0

a6-plugin-ai-content-moderation

用于通过 a6 CLI 配置 Apache APISIX AI 内容审核插件的 Skill，涵盖 ai-aws-content-moderation（AWS Comprehend，仅请求）和 ai-aliyun-content-moderation（阿里云，请求与响应并支持流式传输）、毒性阈值、类别过滤以及与 ai-proxy 的集成。

插件

v1.0.0

a6-plugin-ai-prompt-decorator

用于通过 a6 CLI 配置 Apache APISIX ai-prompt-decorator 插件的 Skill，涵盖向 LLM 请求添加系统、用户和助手消息前缀或后缀、设置对话上下文以及强制执行安全指南。

插件

v1.0.0

a6-plugin-ai-prompt-template

用于通过 a6 CLI 配置 Apache APISIX ai-prompt-template 插件的 Skill，涵盖定义带变量占位符的可复用提示词模板、强制执行提示词结构，以及与 ai-proxy 组合构建完整的 AI 网关流水线。

插件

v1.0.0

a6-plugin-ai-proxy

用于通过 a6 CLI 配置 Apache APISIX ai-proxy 插件的 Skill，涵盖将请求代理到 LLM 服务提供方（OpenAI、Azure OpenAI、DeepSeek、Anthropic、Gemini、Vertex AI 等）、按提供方配置认证、模型、流式传输、日志以及路由和服务用法。

插件

v1.0.0

a6-plugin-basic-auth

用于通过 a6 CLI 配置 Apache APISIX basic-auth 插件的 Skill，涵盖路由上的 HTTP Basic Authentication、带用户名和密码的消费者凭证关联、hide_credentials、匿名消费者回退以及常见运维模式。

插件

v1.0.0

a6-plugin-consumer-restriction

用于通过 a6 CLI 配置 Apache APISIX consumer-restriction 插件的 Skill，涵盖按消费者名称、服务 ID 或路由 ID 进行访问限制，白名单/黑名单模式以及按消费者限制 HTTP 方法。

插件

v1.0.0

a6-plugin-cors

用于通过 a6 CLI 配置 Apache APISIX cors 插件的 Skill，涵盖路由上的跨域资源共享、allow_origins、allow_methods、allow_headers、凭证处理、正则来源匹配、预检缓存以及常见运维模式。

插件

v1.0.0

a6-plugin-datadog

用于通过 a6 CLI 配置 Apache APISIX datadog 插件的 Skill，涵盖通过 DogStatsD 向 Datadog 推送自定义指标、指标标签、批处理、全局 DogStatsD 服务器配置的插件元数据以及 Datadog Agent 集成。

插件

v1.0.0

a6-plugin-ext-plugin

用于通过 a6 CLI 配置 Apache APISIX外部插件系统（ext-plugin-pre-req、ext-plugin-post-req、ext-plugin-post-resp）的 Skill，涵盖 Plugin Runner 架构、Go/Java/Python Runner 配置、RPC 协议、优雅降级以及性能注意事项。

插件

v1.0.0

a6-plugin-fault-injection

使用 a6 CLI 配置 Apache APISIX fault-injection 插件的 Skill，涵盖为混沌工程注入延迟和 HTTP 中止、按百分比采样、通过 vars 表达式条件注入，以及自定义响应头和响应体。

插件

v1.0.0

a6-plugin-grpc-transcode

用于通过 a6 CLI 配置 Apache APISIX grpc-transcode 插件的 Skill，涵盖将 RESTful HTTP 请求转换为 gRPC、proto 文件管理、用于数据类型转换的 pb_option 设置、错误详情解码以及常见运维模式。

插件

v1.0.0

a6-plugin-hmac-auth

用于通过 a6 CLI 配置 Apache APISIX hmac-auth 插件的 Skill，涵盖 HMAC 签名认证、带 key_id/secret_key 的消费者凭证关联、允许的算法、时钟偏差处理、请求体校验、签名请求头以及常见运维模式。

插件

v1.0.0

a6-plugin-http-logger

用于通过 a6 CLI 配置 Apache APISIX http-logger 插件的 Skill，涵盖批量推送访问日志、自定义 NGINX 变量日志格式、按条件记录请求/响应体、批处理调优和外部日志系统集成。

插件

v1.0.0

a6-plugin-ip-restriction

用于通过 a6 CLI 配置 Apache APISIX ip-restriction 插件的 Skill，涵盖路由上的 IP 白名单/黑名单、CIDR 范围、IPv4/IPv6、代理后提取真实客户端 IP、自定义错误消息以及常见运维模式。

插件

v1.0.0

a6-plugin-jwt-auth

用于通过 a6 CLI 配置 Apache APISIX jwt-auth 插件的 Skill，涵盖 JWT Token 认证、HS256/RS256 算法选择、消费者凭证关联、从请求头/查询参数/Cookie 查找 Token、声明处理、时钟偏差、密钥管理以及常见运维模式。

插件

v1.0.0

a6-plugin-kafka-logger

用于通过 a6 CLI 配置 Apache APISIX kafka-logger 插件的 Skill，涵盖 Kafka 主题、Broker、SASL PLAIN/SCRAM 身份认证、自定义日志格式、Producer 调优和批处理。

插件

v1.0.0

a6-plugin-key-auth

用于通过 a6 CLI 配置 Apache APISIX key-auth 插件的 Skill，涵盖路由上的 API Key 认证、消费者凭证关联、从请求头/查询参数/Cookie 查找 Key、hide_credentials、匿名消费者回退以及常见运维模式。

插件

v1.0.0

a6-plugin-limit-count

用于通过 a6 CLI 配置 Apache APISIX limit-count 插件的 Skill，涵盖固定窗口限流、count/time_window 配置、Key 类型、用于分布式限流的 Redis 和 Redis 集群策略、基于组的共享配额、消费者级与路由级限流、响应头以及常见运维模式。

插件

v1.0.0

a6-plugin-limit-req

用于通过 a6 CLI 配置 Apache APISIX limit-req 插件的 Skill，涵盖漏桶限流、rate/burst 配置、nodelay 行为、Key 类型、用于分布式限流的 Redis 策略、流量平滑以及与 limit-count 组合使用等常见运维模式。

插件

v1.0.0

a6-plugin-openid-connect

用于通过 a6 CLI 配置 Apache APISIX openid-connect 插件的 Skill，涵盖 OIDC 授权码流程、Bearer Token 校验、Token 内省（Token introspection）与 JWKS 校验、会话管理、Keycloak/Auth0/Okta 提供方配置、重定向 URI 以及常见运维模式。

插件

v1.0.0

a6-plugin-prometheus

用于通过 a6 CLI 配置 Apache APISIX prometheus 插件的 Skill，涵盖路由级和全局指标、HTTP 状态、延迟、带宽、上游健康和 LLM Token 指标，以及自定义标签、直方图桶和 Grafana 集成。

插件

v1.0.0

a6-plugin-proxy-rewrite

用于通过 a6 CLI 配置 Apache APISIX proxy-rewrite 插件的 Skill，涵盖将请求 URI、主机、方法、请求头和协议重写后再转发到上游，包括正则 URI 重写、请求头操作以及常见运维模式。

插件

v1.0.0

a6-plugin-redirect

用于通过 a6 CLI 配置 Apache APISIX redirect 插件的 Skill，涵盖 URI 重定向、HTTP 到 HTTPS 重定向、基于正则的 URI 重写、查询字符串处理以及常见运维模式。

插件

v1.0.0

a6-plugin-response-rewrite

用于通过 a6 CLI 配置 Apache APISIX response-rewrite 插件的 Skill，涵盖向客户端返回前重写响应状态码、请求头和响应体，包括使用 vars 条件执行、正则响应体过滤器以及常见运维模式。

插件

v1.0.0

a6-plugin-serverless

用于通过 a6 CLI 配置 Apache APISIX serverless-pre-function 和 serverless-post-function 插件的 Skill，涵盖在可配置请求阶段执行内联 Lua 函数、函数签名、闭包模式、可用 Lua API 以及执行顺序。

插件

v1.0.0

a6-plugin-skywalking

用于通过 a6 CLI 配置 Apache APISIX skywalking 插件的 Skill，涵盖使用 Apache SkyWalking OAP 进行分布式追踪、采样配置、服务拓扑以及常见运维模式。

插件

v1.0.0

a6-plugin-traffic-split

用于通过 a6 CLI 配置 Apache APISIX traffic-split 插件的 Skill，涵盖通过条件匹配规则在上游之间进行加权流量拆分，包括灰度发布、蓝绿发布、A/B 测试模式以及常见运维模式。

插件

v1.0.0

a6-plugin-wolf-rbac

用于通过 a6 CLI 配置 Apache APISIX wolf-rbac 插件的 Skill，涵盖与 Wolf RBAC 服务器集成以实现基于角色的访问控制、Token 管理、登录/用户信息/修改密码 API 端点、权限检查流程以及多应用配置。

插件

v1.0.0

a6-plugin-zipkin

用于通过 a6 CLI 配置 Apache APISIX zipkin 插件的 Skill，涵盖使用 Zipkin、Jaeger 或任何兼容 Zipkin 的收集器进行分布式追踪、B3 传播请求头、采样以及常见运维模式。

方案

v1.0.0

a6-recipe-api-versioning

使用 a6 CLI 实现 API 版本管理策略的方案 Skill，涵盖 URI 路径、请求头和查询参数版本管理，以及通过 traffic-split 和 redirect 完成渐进式迁移与版本弃用。

方案

v1.0.0

a6-recipe-blue-green

使用 a6 CLI 实现蓝绿发布的方案 Skill，涵盖创建两套上游环境、通过路由更新或 traffic-split 即时切换流量、回滚，以及声明式配置同步。

方案

v1.0.0

a6-recipe-canary

使用 a6 CLI 在 Apache APISIX 中实现灰度发布的方案 Skill，涵盖通过 traffic-split 插件渐进式转移流量、基于请求头的灰度路由、监控检查点以及完整的发布或回滚工作流。

方案

v1.0.0

a6-recipe-circuit-breaker

使用 a6 CLI 在 Apache APISIX 中实现服务熔断模式的方案 Skill，涵盖 api-breaker 插件、不健康阈值、健康恢复、响应码分类以及与服务健康检查的集成。

方案

v1.0.0

a6-recipe-graphql-proxy

使用 a6 CLI 实现 GraphQL 代理模式的方案 Skill，涵盖基于内置 GraphQL 变量的操作级路由和限流、使用 degraphql 将 REST 转换为 GraphQL，以及 GraphQL API 安全。

方案

v1.0.0

a6-recipe-health-check

使用 a6 CLI 配置上游健康检查的方案 Skill，涵盖主动 HTTP 探测、被动响应分析、组合使用两种检查、健康/不健康阈值，以及上游节点状态监控。

方案

v1.0.0

a6-recipe-mtls

使用 a6 CLI 配置双向 TLS（mTLS）的方案 Skill，涵盖 SSL 证书管理、连接后端服务的上游 mTLS、客户端证书校验，以及从客户端经 Apache APISIX 到上游的端到端 mTLS。

方案

v1.0.0

a6-recipe-multi-tenant

使用 a6 CLI 实现多租户 API 网关模式的方案 Skill，涵盖通过消费者组实现租户隔离、基于 Host/路径/请求头的路由、租户级限流、上下文转发和声明式配置同步。

核心

v1.0.0

a6-shared

使用 Apache APISIX命令行工具 a6 的核心 Skill，提供项目约定、命令模式、双 API 架构和开发工作流；在处理 a6 源代码、添加新命令、编写测试或修改任何 a6 组件时加载此 Skill。

安装

运行一条命令即可安装全部 Skill。安装脚本会将 Skill 下载到 Claude Code 的 ~/.claude/skills：

curl -fsSL https://raw.githubusercontent.com/api7/a6/main/install.sh | sh

之后，可以直接使用自然语言让 Agent 配置 Apache APISIX，无需记忆斜杠命令。

其他 Agent

任何能够读取 Markdown Skill 的 Agent 都可以使用相同文件。通过 --dir 参数（或 SKILLS_DIR 环境变量）可将 Skill 安装到其他目录。例如，将其安装到项目内的 Cursor 规则目录：

curl -fsSL https://raw.githubusercontent.com/api7/a6/main/install.sh | sh -s -- --dir ./.cursor/rules

如果希望手动安装，也可以克隆 api7/a6 仓库，并将 skills/**/SKILL.md 复制到 Agent 的 Skill 目录。

前置条件

• 已安装并加入 PATH 的 a6 CLI（go install github.com/api7/a6/cmd/a6@latest）
• 正在运行且 Admin API 可访问的 Apache APISIX 3.x 实例
• Admin API Key

端到端示例

一条“为 /orders 添加 key-auth 并将其限流为每分钟 100 个请求”的请求，会加载 a6-plugin-key-auth 和 a6-plugin-limit-count 两个 Skill。Agent 会生成路由配置，并使用文件形式的 a6 命令应用该配置：

# route.yaml
uri: /orders
upstream_id: orders-upstream
plugins:
  key-auth: {}
  limit-count:
    count: 100
    time_window: 60
    key: remote_addr
    rejected_code: 429

a6 route update orders -f route.yaml

常见问题

什么是 Apache APISIX AI Agent Skills？

它们是一组开源的 SKILL.md 知识包，用于指导 AI 编程代理配置和运维正在运行的 APISIX 网关。每个 Skill 覆盖一个插件、方案或运维流程，并给出需要执行的准确命令。

可以将 Apache APISIX 与 Claude Code 一起使用吗？

可以。将 APISIX Agent Skills 安装到 Claude Code 后，用自然语言描述期望的网关行为，Claude Code 会加载匹配的 Skill，并通过 a6 CLI 调用 APISIX Admin API。

哪些 AI Agent 支持 APISIX Skills？

任何理解 Agent Skills 约定的 Agent 都可以使用，包括 Claude Code、Cursor、GitHub Copilot、Windsurf 和 OpenCode。Skill 是普通 Markdown 文件，不需要额外运行时。

如何安装 APISIX AI Agent Skills？

运行 api7/a6 提供的一键安装脚本，可将全部 Skill 安装到 Claude Code 的 ~/.claude/skills；也可通过 --dir 将其安装到 Cursor 等其他 Agent 的规则目录。

a6 CLI 是 Apache 官方项目吗？

不是。a6 是由 api7/a6 仓库维护、采用 Apache-2.0 许可证的开源命令行工具，用于封装 APISIX Admin API；它不是 Apache 软件基金会的官方发行组件。

这些 Skill 可以配置哪些内容？

目录覆盖 APISIX 日常工作，包括 29 个插件 Skill、8 个运维方案、2 个角色 Skill 和 1 个共享 CLI 约定 Skill。

了解更多

• api7/a6：Apache APISIX 的开源 CLI
• Agent Skills 格式规范
• APISIX Admin API 参考
• 使用 APISIX AI 网关代理 OpenAI 请求