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.
How it works
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.
Installation
Note: Installation differs by platform. Claude Code and Cursor have built-in plugin marketplaces. Codex and OpenCode require manual setup.
Claude Code / Cursor
/plugin marketplace add Tsukikage7/dubbo-go-skills
/plugin install dubbo-go@dubbo-go-skills
Codex
Tell Codex:
Fetch and follow instructions from https://raw.githubusercontent.com/Tsukikage7/dubbo-go-skills/main/.codex/INSTALL.md
Detailed docs: .codex/INSTALL.md
OpenCode
Add to your opencode.json:
{
"plugin": ["dubbo-go-skills@git+https://github.com/Tsukikage7/dubbo-go-skills.git"]
}
Gemini CLI
gemini extensions install https://github.com/Tsukikage7/dubbo-go-skills
To update:
gemini extensions update dubbo-go-skills
Verify Installation
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.
Skills
scaffolding
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.
extensions
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).
java-interop
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.
debug
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.
guide
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.
migrate
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
Contributing
Skills live directly in this repository.
- Fork the repository
- Add or edit a skill in
skills/<name>/SKILL.md
- Submit a PR
The goal is to eventually contribute this plugin to the Apache dubbo-go community.
Updating
/plugin update dubbo-go@dubbo-go-skills
License
Apache License 2.0
