菜单
Migrate a data-fetching endpoint from the legacy ExtensionRegistryService + fetch-retry pattern to a TanStack Query hook. Only do this when the user explicitly asks — it is an opt-in, in-progress migration. Pairs with the tanstack-query-conventions skill.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/eclipse-openvsx/openvsx --skill migrate-to-tanstack命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
How TanStack Query is used in the webui — hook shape, query keys, retries, mutations, options objects, and how consumers read results. Use when writing or reviewing any useQuery/useMutation/useInfiniteQuery code.
The workflow for changing webui source code — understand, implement, test, changelog, lint. Use whenever writing or modifying source (not for docs-only edits). Enforces that every behavioral change ships with tests and a changelog entry.
How to write unit tests for the webui — the vitest + React Testing Library setup, file layout, harness patterns for context/router-dependent code, and the fail-first check that proves a test actually guards its target. Use when adding or updating tests under test/unit.
基于 SOC 职业分类
正在显示 SKILL.md
| name | migrate-to-tanstack |
| description | Migrate a data-fetching endpoint from the legacy ExtensionRegistryService + fetch-retry pattern to a TanStack Query hook. Only do this when the user explicitly asks — it is an opt-in, in-progress migration. Pairs with the tanstack-query-conventions skill. |
Only run this when the user explicitly asks to migrate an endpoint. The migration is in progress and opt-in — never convert endpoints as a side effect of other work.
src/extension-registry-service.ts (ExtensionRegistryService, plus service.admin.*) holds every server call. Legacy, un-migrated consumers call these methods straight from a component, passing an AbortController and relying on fetch-retry's 10-attempt backoff inside sendRequest. That drags along per-component AbortController refs, useEffect fetch-on-mount wiring, and hand-rolled loading/error state.
Migrated endpoints instead go through a use* hook wrapping useQuery/useMutation, and retries move to the shared query client (src/query-client.ts). Roughly half the service is migrated — grep before assuming either state.
Find every consumer of the method you're migrating: grep -rn "service\.<method>\|\.<method>(" src. List them — you'll migrate all of them or a named subset.
Decide the retry scope — ask if unsure. Ideally the service method flips from sendRequest (retriable) to sendNonRetriableRequest, handing retries to TanStack. Only do that when every consumer is moving to a hook — a legacy consumer still calling the method directly would silently lose its retry. If you're migrating just one of several consumers, either leave the method retriable (the query then double-retries, tolerated in the interim) or confirm scope with the user. When the request doesn't make the consumer scope clear, ask.
Adjust the service method.
AbortController param — the hook passes controllerFromSignal(signal).AbortController param — we no longer abort writes.Create the hook — shape and naming per the tanstack-query-conventions skill. Co-locate it in the feature's folder first; move to src/hooks/ only when a second place needs it. The hook returns the react-query result object as-is, never just data or a picked subset.
Update the consumers. Replace the AbortController / useEffect / manual-state boilerplate with the hook, destructuring and renaming its result (const { data: user, error: userError } = ...; const { mutateAsync, isPending } = ...). Delete the dead boilerplate.
Finish per the write-code skill: add or update tests (write-tests), add a changelog entry, and pass yarn lint.
fetch-retry from sendRequest globally — that's the final cleanup once the whole migration is done, and un-migrated direct callers still depend on it. Keep the 429 / Retry-After block regardless.