关于 api-patterns
api-patterns 是使用 Connect Query 发起 API 调用的编码技能。它为开发者提供数据获取、变更、缓存失效、错误通知和生成的 Protobuf 文件方面的指导。
主要功能
- 01Connect Query hooks 使用指南
- 02变更后的缓存失效
- 03使用 formatToastErrorMessage 处理错误
- 04生成的 Protobuf 文件规则
适用场景
- 01使用 Connect Query 获取 API 数据
- 02变更后更新缓存数据
- 03显示格式化的变更错误
- 04避免编辑生成的 Protobuf 文件
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ redpanda-data/ console --skill api-patterns安装后在 Claude Code 中输入/api-patterns确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
rules/api-invalidate-cache.mdapi-toast-errors.mdprotobuf-no-edit.mduse-connect-query.md详细介绍
API 模式
使用 Connect Query 发起 API 调用并妥善处理响应。
适用场景
- 发起 API 调用
- 使用 Connect Query 钩子
- 使缓存失效
- 执行变更并进行乐观更新
- 针对错误显示 Toast 通知
快速参考
| 操作 | 规则 |
|---|---|
| 获取数据 | use-connect-query.md |
| 变更后 | api-invalidate-cache.md |
| 处理错误 | api-toast-errors.md(在 onError 中使用 formatToastErrorMessage) |
| Protobuf 文件 | protobuf-no-edit.md |
关键位置
| 位置 | 用途 |
|---|---|
/src/react-query/ | Connect Query 钩子 |
/src/protogen/ | 生成的 protos(请勿编辑) |
重新生成 protos:task proto:generate(在仓库根目录运行)
规则
有关查询、变更、缓存失效和错误处理的详细指南,请参阅 rules/ 目录。
评论
支持 Markdown