dubbo-go-skills
Skills for Apache Dubbo-go v3 framework users — scaffolding, extensions, Java interop, debugging, guidance, and migration.
Open source Open in the app JSON README (API)
About
Skills for Apache Dubbo-go v3 framework users — scaffolding, extensions, Java interop, debugging, guidance, and migration.
Details
- Kind
- Plugins
- Topic
- Developer tools
- Publisher
- tsukikage7
- Origin
- gemini
- Category
- ferramentas
- Version
- 0.1.0
- Stars
- 1
- Last push
- 2026-04-17T09:04:08Z
- Repository state
- ativo
- Language
- JavaScript
- Added
- 2026-08-30 14:13:39
- Updated
- 2026-08-30 14:13:39
- Origin id
tsukikage7/dubbo-go-skills
README
# dubbo-go-skills
[English](README.md) | [中文](README_CN.md)
dubbo-go-skills is a Claude Code plugin that gives your AI coding agent deep knowledge of [Apache dubbo-go](https://github.com/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
```bash
/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](.codex/INSTALL.md)
### OpenCode
Add to your `opencode.json`:
```json
{
"plugin": ["dubbo-go-skills@git+https://github.com/Tsukikage7/dubbo-go-skills.git"]
}
```
### Gemini CLI
```bash
gemini extensions install https://github.com/Tsukikage7/dubbo-go-skills
```
To update:
```bash
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](https://github.com/apache/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.
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.
## Updating
```bash
/plugin update dubbo-go@dubbo-go-skills
```
## License
Apache License 2.0