docs: add dubbo-go agent skills guidance#3209
Conversation
✅ Deploy Preview for dubbo ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
| 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. |
There was a problem hiding this comment.
[P1] 这里的文案面向“支持 Agent Skills 的 AI 编码工具”，但链接却直接指到 .agents/.codex/INSTALL.md，这是 Codex 专用安装说明。现在的写法会把 Claude Code / Gemini CLI / OpenCode 用户也带到 Codex 的安装路径，读者会误以为这是通用安装入口。这里应把文案收窄成“Codex 用户”，或者改成真正的通用安装入口。相同问题也出现在 quickstart/microservices.md。
| 本示例演示了基于 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，或者在运行示例遇到问题时辅助排查。 |
There was a problem hiding this comment.
[P1] 这里的文案说“支持 Agent Skills 的 AI 编码工具”都可以按这个链接安装，但链接实际指向 .agents/.codex/INSTALL.md，它是 Codex 专用安装说明，不是通用入口。现在的写法会把非 Codex 用户也引到错误的安装路径。这里应改成只对 Codex 用户给出这个链接，或者补一个真正覆盖其它 Agent 的通用安装入口。相同问题也出现在 quickstart/microservices.md。
| 本示例我们继续使用 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，或者在运行本示例时辅助排查服务发现、路由和连接问题。 |
There was a problem hiding this comment.
[P1] 这里同样把多 Agent 通用文案直接链接到了 .agents/.codex/INSTALL.md，但这个路径是 Codex 专用安装说明，不是其它 Agent 的安装入口。保留现在的写法会把非 Codex 用户带到错误文档。这里应只对 Codex 用户给出这个链接，或者补一个真正覆盖其它 Agent 的通用安装入口。
| 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. |
There was a problem hiding this comment.
[P1] 这里也把面向“已安装 Agent Skills 的用户”的通用说明直接挂到了 .agents/.codex/INSTALL.md 上，但这个链接是 Codex 专用安装说明，不是多 Agent 通用入口。现在的文案会让非 Codex 用户误以为这个链接同样适用于 Claude Code / Gemini CLI / OpenCode。这里应把对象收窄成 Codex 用户，或者替换成真正的通用安装入口。
3 participants
No description provided.