Agent Skills

备注

这篇翻译之后英文原文有更新，内容可能已过时。

安装 skill 以获得最佳效果

仅凭包名，智能体就能把基础部分做对。Skills 则会教给它们其余部分的最新 API，例如测试 fixture 和实时 manager。安装 skill /data-client-setup：

Claude Code plugin

终端

claude plugin marketplace add reactive/data-client
claude plugin install data-client@data-client

在终端中运行

Cursor plugin

复制给 Cursor 的提示词

Codex plugin

终端

codex plugin marketplace add reactive/data-client \
  --sparse .claude-plugin --sparse .agents/skills
codex plugin add data-client@data-client

在终端中运行

Skills CLI

终端

npx skills add reactive/data-client --skill data-client-setup

在终端中运行

OpenSkills

终端

npx openskills install reactive/data-client/.agents/skills/data-client-setup

在终端中运行

然后在你的智能体聊天中运行它：

复制给编程代理的提示词

它会检测你的框架和 API 风格（REST、GraphQL、自定义），安装下面相应的 skill，接好 provider，并迁移现有的 endpoint。

预先安装所有 skill

如果你想现在就安装适用于你的框架的所有 skill，而不让智能体执行安装：

Claude Code plugin

claude plugin marketplace add reactive/data-client
claude plugin install data-client@data-client

在终端中运行

Cursor plugin

复制给 Cursor 的提示词

Codex plugin

codex plugin marketplace add reactive/data-client \
  --sparse .claude-plugin --sparse .agents/skills
codex plugin add data-client@data-client

在终端中运行

Installed packages

# after installing Data Client: links the skills its packages ship
npx --no data-client-skills

在终端中运行

Skills CLI

npx skills add reactive/data-client \
  --skill data-client \
  --skill data-client-setup \
  --skill data-client-manager \
  --skill data-client-schema \
  --skill data-client-v0.18-migration \
  --skill data-client-rest \
  --skill path-to-regexp-v8-migration \
  --skill data-client-react \
  --skill data-client-react-testing \
  --skill data-client-rest-setup \
  --skill data-client-graphql-setup \
  --skill data-client-endpoint-setup

在终端中运行

OpenSkills

npx openskills install reactive/data-client/.agents/skills/data-client
npx openskills install reactive/data-client/.agents/skills/data-client-setup
npx openskills install reactive/data-client/.agents/skills/data-client-manager
npx openskills install reactive/data-client/.agents/skills/data-client-schema
npx openskills install reactive/data-client/.agents/skills/data-client-v0.18-migration
npx openskills install reactive/data-client/.agents/skills/data-client-rest
npx openskills install reactive/data-client/.agents/skills/path-to-regexp-v8-migration
npx openskills install reactive/data-client/.agents/skills/data-client-react
npx openskills install reactive/data-client/.agents/skills/data-client-react-testing
npx openskills install reactive/data-client/.agents/skills/data-client-rest-setup
npx openskills install reactive/data-client/.agents/skills/data-client-graphql-setup
npx openskills install reactive/data-client/.agents/skills/data-client-endpoint-setup

在终端中运行

在 Claude Code 中，插件会一步完成安装。对于其他智能体， TanStack Intent 会加载每个 @data-client/* 包为其版本附带的 skill，因此它们会随 npm update 一起更新。它的安装会在你的 AGENTS.md 中添加一个 skill 加载部分。

可用的 skill

• /data-client — 当你让智能体添加或使用 Data Client 时从这里开始，并将其引导到设置或该任务对应的 skill。
• /data-client-setup — 根据你的框架和 API 风格安装并配置 Data Client，以及它所需的 skill。
• /data-client-rest-setup — 设置 @data-client/rest 并迁移现有的 fetch/axios 客户端。
• /data-client-endpoint-setup — 用 Endpoint 包装自定义异步函数，适用于非 REST、非 GraphQL 的工作流。
• /data-client-graphql-setup — 为 GraphQL API 配置 @data-client/graphql 和 GQLEndpoint。
• /data-client-schema — 设计 Entity、Collection、Union、Query 及相关 schema。
• /data-client-rest — 用 resource()、RestEndpoint、 CRUD 方法和响应解析来定义 REST API。
• /data-client-manager — 实现自定义 Manager，用于 websocket、SSE、轮询、订阅、日志和中间件。

• /data-client-react — 使用 useSuspense、useFetch、useQuery、useLive 及变更相关 hook，并借助 Chrome DevTools MCP 调试运行中的应用。
• /data-client-react-testing — 使用 renderDataHook、 fixture、interceptor 和 nock 编写 React 测试。

在 skills.sh/reactive/data-client 浏览完整目录。

手动设置

若要自行安装包并添加 provider，请按照安装操作。

面向 LLM 的文档

没有安装 skill 的智能体可以按照 llms.txt 约定，以纯 markdown 形式阅读这些文档：

• llms.txt — 所有页面的索引，附有每个页面 markdown 的链接
• llms-full.txt — 将所有 React、REST 和 GraphQL 文档合并为一个文件

任何文档页面都可以在其 URL 后加上 .md 获取 markdown 版本，例如 /docs/api/useSuspense.md。