Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions content/en/overview/mannual/golang-sdk/introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[P1] 这里也把面向“已安装 Agent Skills 的用户”的通用说明直接挂到了 .agents/.codex/INSTALL.md 上,但这个链接是 Codex 专用安装说明,不是多 Agent 通用入口。现在的文案会让非 Codex 用户误以为这个链接同样适用于 Claude Code / Gemini CLI / OpenCode。这里应把对象收窄成 Codex 用户,或者替换成真正的通用安装入口。


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.
Expand Down Expand Up @@ -187,4 +192,3 @@ If you want to add more service governance capabilities to the application, plea
<hr>
</div>
{{< /blocks/section >}}

6 changes: 5 additions & 1 deletion content/en/overview/mannual/golang-sdk/quickstart/rpc.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[P1] 这里的文案面向“支持 Agent Skills 的 AI 编码工具”,但链接却直接指到 .agents/.codex/INSTALL.md,这是 Codex 专用安装说明。现在的写法会把 Claude Code / Gemini CLI / OpenCode 用户也带到 Codex 的安装路径,读者会误以为这是通用安装入口。这里应把文案收窄成“Codex 用户”,或者改成真正的通用安装入口。相同问题也出现在 quickstart/microservices.md


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`.
Expand Down Expand Up @@ -243,4 +248,3 @@ This is the basic working principle of dubbo-go RPC!
<hr>
</div>
{{< /blocks/section >}}

3 changes: 3 additions & 0 deletions content/zh-cn/overview/mannual/golang-sdk/introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 安装到全局环境。



Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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,或者在运行本示例时辅助排查服务发现、路由和连接问题。

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[P1] 这里同样把多 Agent 通用文案直接链接到了 .agents/.codex/INSTALL.md,但这个路径是 Codex 专用安装说明,不是其它 Agent 的安装入口。保留现在的写法会把非 Codex 用户带到错误文档。这里应只对 Codex 用户给出这个链接,或者补一个真正覆盖其它 Agent 的通用安装入口。


这个步骤是可选的,不是运行 dubbo-go 应用的必要条件。

## 快速运行示例
### 下载示例源码
我们在 [apache/dubbo-go-samples](https://github.com/apache/dubbo-go-samples/) 仓库维护了一系列 dubbo-go 使用示例,用来帮助用户快速学习 dubbo-go 使用方式。
Expand Down Expand Up @@ -190,4 +195,3 @@ ins, err := dubbo.NewInstance(




6 changes: 5 additions & 1 deletion content/zh-cn/overview/mannual/golang-sdk/quickstart/rpc.md
Original file line number Diff line number Diff line change
Expand Up @@ -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,或者在运行示例遇到问题时辅助排查。

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[P1] 这里的文案说“支持 Agent Skills 的 AI 编码工具”都可以按这个链接安装,但链接实际指向 .agents/.codex/INSTALL.md,它是 Codex 专用安装说明,不是通用入口。现在的写法会把非 Codex 用户也引到错误的安装路径。这里应改成只对 Codex 用户给出这个链接,或者补一个真正覆盖其它 Agent 的通用安装入口。相同问题也出现在 quickstart/microservices.md


这个步骤是可选的,不是运行 dubbo-go 应用的必要条件。

## 前置条件

因为使用 Protocol Buffer 的原因,我们首先需要安装相关的代码生成工具,这包括 `protoc`、`protoc-gen-go`、`protoc-gen-go-triple`。
Expand Down Expand Up @@ -245,4 +250,3 @@ func main() {




Loading