From e85bcc195916ca15dd1c798ace3baff21b78ec24 Mon Sep 17 00:00:00 2001
From: Oxidaner <18622412361@163.com>
Date: Mon, 1 Jun 2026 09:12:13 +0800
Subject: [PATCH] docs: add dubbo-go agent skills guidance
---
content/en/overview/mannual/golang-sdk/introduction.md | 4 ++++
.../overview/mannual/golang-sdk/quickstart/microservices.md | 6 +++++-
content/en/overview/mannual/golang-sdk/quickstart/rpc.md | 6 +++++-
content/zh-cn/overview/mannual/golang-sdk/introduction.md | 3 +++
.../overview/mannual/golang-sdk/quickstart/microservices.md | 6 +++++-
content/zh-cn/overview/mannual/golang-sdk/quickstart/rpc.md | 6 +++++-
6 files changed, 27 insertions(+), 4 deletions(-)
diff --git a/content/en/overview/mannual/golang-sdk/introduction.md b/content/en/overview/mannual/golang-sdk/introduction.md
index 114eeaaff918..b4062d03574e 100644
--- a/content/en/overview/mannual/golang-sdk/introduction.md
+++ b/content/en/overview/mannual/golang-sdk/introduction.md
@@ -109,3 +109,7 @@ The traffic governance rules implemented by dubbo-go fully comply with Dubbo fra
* [Dubbo Traffic Governance Rule Design](/en/overview/core-features/traffic/)
* [Dubbo Traffic Governance Example Task](/en/overview/tasks/traffic-management/)
+## Agent Skills
+Apache dubbo-go also maintains [Agent Skills](https://github.com/apache/dubbo-go/tree/main/.agents) for AI coding agents that support skill loading, such as Codex, Claude Code, Gemini CLI, and OpenCode. These skills package dubbo-go-specific context for scaffolding v3 providers and consumers, writing extensions, debugging runtime issues, Java interoperability, migration, conceptual guidance, and contributor workflows.
+
+The skills are optional development assistance only. They are not runtime dependencies of dubbo-go applications. Codex users can follow the [installation guide](https://github.com/apache/dubbo-go/blob/main/.agents/.codex/INSTALL.md) to install the skills globally.
diff --git a/content/en/overview/mannual/golang-sdk/quickstart/microservices.md b/content/en/overview/mannual/golang-sdk/quickstart/microservices.md
index b5c40722a53e..2be932171796 100644
--- a/content/en/overview/mannual/golang-sdk/quickstart/microservices.md
+++ b/content/en/overview/mannual/golang-sdk/quickstart/microservices.md
@@ -14,6 +14,11 @@ This example demonstrates how to develop microservice applications using dubbo-g
## Prerequisites
In this example, we will continue to use Protobuf to develop the microservice application. Please refer to [Develop RPC Server and RPC Client](../rpc) to learn how to install necessary plugins like protoc and protoc-gen-go-triple.
+## Optional: Use Agent Skills
+If you have installed dubbo-go's [Agent Skills](https://github.com/apache/dubbo-go/blob/main/.agents/.codex/INSTALL.md), you can ask the agent to scaffold a registry-backed provider and consumer, or to help diagnose service discovery, routing, and connection issues while running this example.
+
+This step is optional and is not required to run dubbo-go applications.
+
## Quick Run Example
### Download Example Source Code
We maintain a series of dubbo-go usage examples in the [apache/dubbo-go-samples](https://github.com/apache/dubbo-go-samples/) repository to help users quickly learn how to use dubbo-go.
@@ -187,4 +192,3 @@ If you want to add more service governance capabilities to the application, plea
{{< /blocks/section >}}
-
diff --git a/content/en/overview/mannual/golang-sdk/quickstart/rpc.md b/content/en/overview/mannual/golang-sdk/quickstart/rpc.md
index 38f9bb4c786e..18167197efc1 100644
--- a/content/en/overview/mannual/golang-sdk/quickstart/rpc.md
+++ b/content/en/overview/mannual/golang-sdk/quickstart/rpc.md
@@ -14,6 +14,11 @@ Based on the Triple protocol defined by Dubbo, you can easily write browser and
This example demonstrates the RPC communication pattern based on the Triple protocol. The example uses Protocol Buffer to define the RPC service and demonstrates the processes of code generation, service publishing, and service access.
+## Optional: Use Agent Skills
+If you use an AI coding agent that supports Agent Skills, you can install dubbo-go's [Agent Skills](https://github.com/apache/dubbo-go/blob/main/.agents/.codex/INSTALL.md) before starting. Then ask the agent to scaffold a Triple provider and consumer that follow this quick start, or to help debug issues when running the sample.
+
+This step is optional and is not required to run dubbo-go applications.
+
## Prerequisites
Since we are using Protocol Buffer, we first need to install the relevant code generation tools, including `protoc`, `protoc-gen-go`, and `protoc-gen-go-triple`.
@@ -243,4 +248,3 @@ This is the basic working principle of dubbo-go RPC!
{{< /blocks/section >}}
-
diff --git a/content/zh-cn/overview/mannual/golang-sdk/introduction.md b/content/zh-cn/overview/mannual/golang-sdk/introduction.md
index c083599cc56e..705d5bb0dec3 100644
--- a/content/zh-cn/overview/mannual/golang-sdk/introduction.md
+++ b/content/zh-cn/overview/mannual/golang-sdk/introduction.md
@@ -116,7 +116,10 @@ dubbo-go 实现的流量治理规则完全遵循 Dubbo 框架设计的流量治
* [Dubbo 流量治理规则设计](/zh-cn/overview/core-features/traffic/)
* [Dubbo 流量治理示例任务](/zh-cn/overview/tasks/traffic-management/)
+## Agent Skills
+Apache dubbo-go 同时在 [Agent Skills](https://github.com/apache/dubbo-go/tree/main/.agents) 中维护了一组面向 AI 编码 Agent 的项目上下文，适用于 Codex、Claude Code、Gemini CLI、OpenCode 等支持加载 skills 的工具。这些 skills 覆盖 dubbo-go v3 provider/consumer 脚手架、扩展点开发、运行时问题排查、Java 互通、迁移、概念说明以及仓库贡献流程。
+这些 skills 只是可选的开发辅助信息，不是 dubbo-go 应用的运行时依赖。Codex 用户可以参考 [安装说明](https://github.com/apache/dubbo-go/blob/main/.agents/.codex/INSTALL.md) 将 skills 安装到全局环境。
diff --git a/content/zh-cn/overview/mannual/golang-sdk/quickstart/microservices.md b/content/zh-cn/overview/mannual/golang-sdk/quickstart/microservices.md
index f234b563735c..c4e7920f3608 100644
--- a/content/zh-cn/overview/mannual/golang-sdk/quickstart/microservices.md
+++ b/content/zh-cn/overview/mannual/golang-sdk/quickstart/microservices.md
@@ -14,6 +14,11 @@ weight: 2
## 前置条件
本示例我们继续使用 Protobuf 开发微服务应用，请参考 [开发 rpc server 和 rpc client](../rpc) 了解如何安装 protoc、protoc-gen-go-triple 等必须插件。
+## 可选：使用 Agent Skills
+如果已经安装 dubbo-go 的 [Agent Skills](https://github.com/apache/dubbo-go/blob/main/.agents/.codex/INSTALL.md)，可以让 Agent 生成带注册中心的 provider 和 consumer，或者在运行本示例时辅助排查服务发现、路由和连接问题。
+
+这个步骤是可选的，不是运行 dubbo-go 应用的必要条件。
+
## 快速运行示例
### 下载示例源码
我们在 [apache/dubbo-go-samples](https://github.com/apache/dubbo-go-samples/) 仓库维护了一系列 dubbo-go 使用示例，用来帮助用户快速学习 dubbo-go 使用方式。
@@ -190,4 +195,3 @@ ins, err := dubbo.NewInstance(
-
diff --git a/content/zh-cn/overview/mannual/golang-sdk/quickstart/rpc.md b/content/zh-cn/overview/mannual/golang-sdk/quickstart/rpc.md
index af06b78ad9e2..cf284a461e71 100644
--- a/content/zh-cn/overview/mannual/golang-sdk/quickstart/rpc.md
+++ b/content/zh-cn/overview/mannual/golang-sdk/quickstart/rpc.md
@@ -14,6 +14,11 @@ weight: 1
本示例演示了基于 Triple 协议的 RPC 通信模式，示例使用 Protocol Buffer 定义 RPC 服务，并演示了代码生成、服务发布和服务访问等过程。
+## 可选：使用 Agent Skills
+如果你使用支持 Agent Skills 的 AI 编码工具，可以在开始前安装 dubbo-go 的 [Agent Skills](https://github.com/apache/dubbo-go/blob/main/.agents/.codex/INSTALL.md)。之后可以让 Agent 按照本快速开始生成 Triple provider 和 consumer，或者在运行示例遇到问题时辅助排查。
+
+这个步骤是可选的，不是运行 dubbo-go 应用的必要条件。
+
## 前置条件
因为使用 Protocol Buffer 的原因，我们首先需要安装相关的代码生成工具，这包括 `protoc`、`protoc-gen-go`、`protoc-gen-go-triple`。
@@ -245,4 +250,3 @@ func main() {
-