AGENT SKILL

dubbo-admin-console-api

Implements and reviews dubbo-admin Console API changes. Use when the user asks about HTTP endpoints, Gin routes, handlers, request or response models, console services, error handling, API pagination, or the handler to service to manager to store flow under pkg/console/. Do not use for frontend-only, discovery-only, or store-internals tasks unless they affect Console API behavior.

License 许可
Apache-2.0
所属仓库
apache/dubbo-admin
最近更新
2026-11-14
Stars
★ 4.1k
Forks
2.2k

01 前言 Front Matter

name
dubbo-admin-console-api
description
Implements and reviews dubbo-admin Console API changes. Use when the user asks about HTTP endpoints, Gin routes, handlers, request or response models, console services, error handling, API pagination, or the handler to service to manager to store flow under pkg/console/. Do not use for frontend-only, discovery-only, or store-internals tasks unless they affect Console API behavior.

02 资源文件 2

03 SKILL.md 正文

dubbo-admin Console API

Purpose

Use this skill to change or explain dubbo-admin Web MVC behavior consistently across router, handler, model, service, manager, and store layers.

When to use

Use for Console API endpoint additions, request binding, response models, service logic, route registration, API error handling, and backend API review.

Do not use for Vue-only changes, registry discovery internals, or memory store implementation details unless an API contract depends on them.

Inputs

Required:

  • Target endpoint, handler, model, or package path.
  • Intended API behavior or observed bug.

Optional:

  • Example request or response payload.
  • Related frontend API caller.
  • Existing route or service function to mirror.

If missing, inspect pkg/console/router/router.go first and ask only for behavior that cannot be inferred from code.

Workflow

  1. Locate the route in pkg/console/router/router.go.
  2. Read the matching handler in pkg/console/handler/ for binding and response style.
  3. Read or update request and response types in pkg/console/model/.
  4. Put business logic in pkg/console/service/; keep handlers focused on HTTP concerns.
  5. Use ctx.ResourceManager() and helpers in pkg/core/manager/ for resource access.
  6. Return responses with model.NewSuccessResp, util.HandleArgumentError, or util.HandleServiceError.
  7. If endpoint behavior is unclear, read references/web-mvc-flow.md.

Output format

Return changed files, endpoint behavior, request and response contract, validation performed, and any frontend impact.

Validation

  • Confirm the route is registered under /api/v1.
  • Confirm handler binding matches method semantics: query for reads, JSON body for mutations.
  • Confirm service code returns typed models and propagates business errors.
  • Run focused Go tests for changed packages; use make test for shared API behavior.

Edge cases

  • Some handlers include lightweight auth, cookie, or parameter logic; do not force all logic into services.
  • If changing response fields, check frontend callers under ui-vue3/src/api/.
  • If a resource query becomes slow, switch to dubbo-admin-store.

References

  • Read references/web-mvc-flow.md for the current route, handler, service, and response pattern.

04 同仓库更多 Skills

apache
apache/dubbo-admin

dubbo-admin-store

Implements and reviews dubbo-admin resource storage and indexing changes. Use when the user asks about ResourceStore APIs, store routing, memory store behavior, index registration, IndexCondition, ListByIndexes, PageListByIndexes, ByMeshIndex, radix-tree prefix lookup, or pkg/core/store/, pkg/core/store/index/, and pkg/store/. Do not use for frontend, Console API, discovery, or engine tasks unless they require store or index changes.

前端开发
★ 4.1k
apache
apache/dubbo-admin

dubbo-admin-runtime

Implements and reviews dubbo-admin runtime component changes. Use when the user asks about component abstraction, component composition, runtime bootstrap, dependency ordering, registration, lifecycle, startup, shutdown, runtime builder behavior, or pkg/core/runtime/ and pkg/core/bootstrap/. Do not use for discovery, engine, store, Console API, or frontend tasks unless component lifecycle or dependencies are affected.

前端开发
★ 4.1k
apache
apache/dubbo-admin

dubbo-admin-frontend

Implements and reviews dubbo-admin Vue 3 frontend changes. Use when the user asks about ui-vue3, Vue views or components, frontend routing, route metadata, API clients, Pinia stores, SearchDomain, i18n, layout tabs, traffic rule form design, frontend tests, or Vite, ESLint, and Prettier configuration. Do not use for Go backend internals unless coordinating an API contract with the frontend.

前端开发后端与接口
★ 4.1k
apache
apache/dubbo-admin

dubbo-admin-events

Implements and reviews dubbo-admin EventBus dispatching. Use when the user asks about Event, Emitter, Subscriber, SubscriptionManager, EventBus component registration, Subscribe or Unsubscribe behavior, Send dispatch rules, subscriber ProcessEvent flow, resource-kind based routing, or event error handling under pkg/core/events/. Do not use for a domain subscriber unless the task changes the event bus contract or dispatch semantics.

★ 4.1k
apache
apache/dubbo-admin

dubbo-admin-engine

Implements and reviews dubbo-admin resource engine changes. Use when the user asks about runtime infrastructure discovery, engine factories, Kubernetes or mock engine ListWatchers, RuntimeInstance informers, RuntimeInstanceEventSubscriber, engine leader election, or merging RuntimeInstance data into Instance resources under pkg/core/engine/ and pkg/engine/. Do not use for registry discovery unless the task concerns engine-sourced RuntimeInstance resources.

运维与部署
★ 4.1k
apache
apache/dubbo-admin

dubbo-admin-domain

Routes dubbo-admin architecture questions to the right domain skill. Use for cross-module questions, end-to-end flows, subsystem boundaries, or deciding whether runtime, discovery, engine, events, store, Console API, or frontend guidance applies. Prefer a narrower dubbo-admin-* skill when the request clearly targets one subsystem.

前端开发
★ 4.1k