SuperAPI AI 工具集

setup-connect-query

通用与其它

查看项目

更新于 10-16 07:27

技能介绍

用途:该技能用于在开发过程中强制执行 ConnectRPC + Connect Query + Protobuf v2 的编码模式,通过 PostToolUse 钩子对代码进行检查与拦截。

主要能力:

  1. 当文件使用 ConnectRPC 时,禁止从 @tanstack/react-query 直接使用 useQuery/useMutation,应改用 Connect Query;例外为 useTransport/callUnaryMethod 模式。
  2. 禁止无参数的 invalidateQueries(),必须指定 query key。
  3. 对 axios/fetch() 发出警告,建议优先使用 ConnectRPC transport。
  4. Protobuf v2 规范:禁止 new Message(),改用 create(Schema);禁止 PlainMessage/PartialMessage,改用 MessageShape/MessageInitShape;禁止手写 $typeName 字面量。

使用方式:通过 PostToolUse 钩子自动检查。如需临时豁免,可使用注释 // allow: direct-query [reason]。

参考与安装:Protobuf 常见问题(Timestamp、Duration、Any、缓存模式)见 REFERENCE.md;安装配置见 SETUP.md。

限制:资料未提供具体安装命令、支持的平台、收费方式及更多使用细节。