dubbo-go-skills

English | 中文

dubbo-go-skills is a Claude Code plugin that gives your AI coding agent deep knowledge of Apache dubbo-go — the Go implementation of Apache Dubbo.

When you're working with dubbo-go, your agent now knows what it's doing.

Ask it to scaffold a new provider or consumer, and it picks the right code-API style (dubbo.NewInstance + server.WithServerProtocol), wires up the registry you're actually using, and produces something that compiles on first try. Need a custom filter or load balancer? It knows the SPI pattern — the exact extension.SetXxx call, the blank-import trick, and how to activate the extension per service or per reference. Integrating with a Java Dubbo service? It picks Triple+Protobuf or Dubbo+Hessian2 based on whether you have a .proto or a Java interface, and gets the POJO class names right.

Ask why your service can't connect, and it walks through a structured checklist — registry, protocol match, serialization, filter chain — instead of guessing. Migrating from gRPC-Go or Spring Cloud? It maps the concepts one-for-one instead of making you guess.

The skills activate automatically when the context is right. You don't invoke them manually. Your agent just knows.

Note: All skills target dubbo-go v3 only. v1 and v2 are deprecated.

Note: Installation differs by platform. Claude Code and Cursor have built-in plugin marketplaces. Codex and OpenCode require manual setup.

/plugin marketplace add Tsukikage7/dubbo-go-skills
/plugin install dubbo-go@dubbo-go-skills

Tell Codex:

Fetch and follow instructions from https://raw.githubusercontent.com/Tsukikage7/dubbo-go-skills/main/.codex/INSTALL.md

Detailed docs: .codex/INSTALL.md

Add to your opencode.json:

{
  "plugin": ["dubbo-go-skills@git+https://github.com/Tsukikage7/dubbo-go-skills.git"]
}

gemini extensions install https://github.com/Tsukikage7/dubbo-go-skills

To update:

gemini extensions update dubbo-go-skills

Start a new session and say something like "help me create a dubbo-go service" or "why is my provider not found". The agent should automatically invoke the relevant skill.

Generates provider or consumer skeletons in the v3 code-API style (dubbo.NewInstance / server.NewServer / client.NewClient). Asks about protocol (Triple/Dubbo/gRPC) and registry (Nacos/ZooKeeper/etcd/direct) first, then produces a complete, compilable skeleton matching the official samples.

Guide for writing custom SPI extensions — Filters, LoadBalancers, Registries, Protocols. Explains the uniform pattern (extension.SetXxx + blank import + WithFilter/WithLoadBalance), with a runnable template for each extension point and the common failure modes (name-string mismatch, missing blank import).

Cross-language RPC between dubbo-go and dubbo-java. Helps you pick between Triple+Protobuf (new polyglot services) and Dubbo+Hessian2 (existing Java-defined services), get POJO class names right, and understand the HTTP route format Triple exposes for easy curl-based testing.

Structured diagnosis for runtime errors. Matches your error or log against known patterns — "no provider available", connection refused, serialization mismatch, timeout, filter panic — and gives you a targeted checklist to work through.

Explains dubbo-go architecture, extension points, and best practices. Covers core concepts (Instance, Protocol, Registry, Filter, Cluster, LoadBalance, Router) and the SPI pattern for writing custom extensions. Points to the relevant dubbo-go-samples directory for each scenario.

Step-by-step migration guidance from:

• gRPC-Go — concept mapping, proto reuse, direct-mode equivalent
• Spring Cloud (Java) — registry overlap, Java/Go interop path
• Gin / plain HTTP — coexistence pattern and Triple REST mode
• dubbo-go v1/v2 → v3 — breaking changes table, minimal migration path

Skills live directly in this repository.

1. Fork the repository
2. Add or edit a skill in skills/<name>/SKILL.md
3. Submit a PR

The goal is to eventually contribute this plugin to the Apache dubbo-go community.

/plugin update dubbo-go@dubbo-go-skills

Apache License 2.0