-
Notifications
You must be signed in to change notification settings - Fork 804
docs: add dubbo-go agent skills guidance #3209
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: master
Are you sure you want to change the base?
Changes from all commits
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -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. | ||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. [P1] 这里的文案面向“支持 Agent Skills 的 AI 编码工具”,但链接却直接指到 |
||
|
|
||
| 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! | |
| <hr> | ||
| </div> | ||
| {{< /blocks/section >}} | ||
|
|
||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -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,或者在运行本示例时辅助排查服务发现、路由和连接问题。 | ||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. [P1] 这里同样把多 Agent 通用文案直接链接到了 |
||
|
|
||
| 这个步骤是可选的,不是运行 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( | |
|
|
||
|
|
||
|
|
||
|
|
||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -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,或者在运行示例遇到问题时辅助排查。 | ||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. [P1] 这里的文案说“支持 Agent Skills 的 AI 编码工具”都可以按这个链接安装,但链接实际指向 |
||
|
|
||
| 这个步骤是可选的,不是运行 dubbo-go 应用的必要条件。 | ||
|
|
||
| ## 前置条件 | ||
|
|
||
| 因为使用 Protocol Buffer 的原因,我们首先需要安装相关的代码生成工具,这包括 `protoc`、`protoc-gen-go`、`protoc-gen-go-triple`。 | ||
|
|
@@ -245,4 +250,3 @@ func main() { | |
|
|
||
|
|
||
|
|
||
|
|
||
There was a problem hiding this comment.
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 用户,或者替换成真正的通用安装入口。