From a103c96c41cd4f62154aeeec757427921d9d17b5 Mon Sep 17 00:00:00 2001 From: Matt Miller Date: Tue, 10 Nov 2026 21:34:39 +0000 Subject: [PATCH 1/2] docs: link the comfy-sdk agent skill from the SDKs page Add a "Using a coding agent" section after Install on the SDKs page pointing at the comfy-sdk skill in Comfy-Org/comfy-skills: the Claude Code plugin install commands, or copy the single SKILL.md into another agent's rules. Mirrored in the zh, ja, ko and es pages, which track the English page section by section; translation hashes refreshed with translate:sync-hash. Co-Authored-By: Claude Opus 5.5 --- development/api-development/sdks.mdx | 4 ++++ es/development/api-development/sdks.mdx | 9 +++++++-- ja/development/api-development/sdks.mdx | 7 ++++++- ko/development/api-development/sdks.mdx | 7 ++++++- zh/development/api-development/sdks.mdx | 7 ++++++- 5 files changed, 29 insertions(+), 5 deletions(-) diff --git a/development/api-development/sdks.mdx b/development/api-development/sdks.mdx index b7ad7f273c..94a2a9cd80 100644 --- a/development/api-development/sdks.mdx +++ b/development/api-development/sdks.mdx @@ -47,6 +47,10 @@ Python 3.10 or newer. Node 22 or newer. +## Using a coding agent + +If a coding agent writes your integration, give it the `comfy-sdk` skill. It is written for building on Comfy Router and steers the agent on picking the right client, keeping the API key on the server, discovering a model before calling it, `run` versus `submit`, timeouts, and branching on error buckets. In Claude Code, run `/plugin marketplace add Comfy-Org/comfy-skills`, then `/plugin install comfy-sdk@comfy-skills`. For any other agent, copy the single [`SKILL.md`](https://github.com/Comfy-Org/comfy-skills/blob/main/claude-code-sdk/skills/comfy-sdk/SKILL.md) file into your agent's rules, such as `AGENTS.md` or your Cursor rules. + ## Quickstart Upload an input image, run a workflow, and write the results to disk. diff --git a/es/development/api-development/sdks.mdx b/es/development/api-development/sdks.mdx index 273d018034..fea05760d4 100644 --- a/es/development/api-development/sdks.mdx +++ b/es/development/api-development/sdks.mdx @@ -3,11 +3,12 @@ title: "SDK de Comfy: clientes de Python y TypeScript para ComfyUI" description: "Ejecuta flujos de trabajo de ComfyUI desde Python o TypeScript en Comfy Cloud, tu propio despliegue: recursos, tareas, eventos en vivo y reintentos idempotentes." sidebarTitle: "SDK" icon: "code" -translationSourceHash: fd912955 +translationSourceHash: 08ccc1fa translationFrom: development/api-development/sdks.mdx translationBlockHashes: "_intro": c92c7b51 "Install": da9a0a57 + "Using a coding agent": 2e17afaa "Quickstart": 02297586 "Choosing a base URL": 0e77e81c "Retrying a submit: the idempotency key": 7c83d78f @@ -61,6 +62,10 @@ Python 3.10 o posterior. Node 22 o posterior. +## Usar un agente de programación + +Si un agente de programación escribe tu integración, dale la habilidad `comfy-sdk`. Está escrita para desarrollar sobre Comfy Router y orienta al agente para elegir el cliente correcto, mantener la clave de API en el servidor, descubrir un modelo antes de llamarlo, elegir entre `run` y `submit`, configurar los tiempos de espera y ramificar según la categoría de error. En Claude Code, ejecuta `/plugin marketplace add Comfy-Org/comfy-skills` y después `/plugin install comfy-sdk@comfy-skills`. Para cualquier otro agente, copia el archivo único [`SKILL.md`](https://github.com/Comfy-Org/comfy-skills/blob/main/claude-code-sdk/skills/comfy-sdk/SKILL.md) en las reglas de tu agente, como `AGENTS.md` o tus reglas de Cursor. + ## Inicio rápido Sube una imagen de entrada, ejecuta un flujo de trabajo y escribe los resultados en disco. @@ -142,7 +147,7 @@ const client = new Comfy({ apiKey: "comfyui-..." }); Funciona sin configuración adicional. Crea una [clave API](/es/development/api-development/getting-an-api-key) y pásala al cliente. - El acceso a la API requiere una suscripción de pago a Comfy Cloud. El plan gratuito no lo incluye. Cuántas tareas puedes ejecutar a la vez depende de tu plan. Consulta [Límites de simultaneidad](/es/development/deploy/cloud-usage#tareas-simultáneas). + El acceso a la API requiere una suscripción de pago a Comfy Cloud. El plan gratuito no lo incluye. Cuántas tareas puedes ejecutar a la vez depende de tu plan. Consulta [Límites de simultaneidad](/es/development/deploy/cloud-usage#límites-de-simultaneidad). diff --git a/ja/development/api-development/sdks.mdx b/ja/development/api-development/sdks.mdx index 9dc6994459..3aede1822c 100644 --- a/ja/development/api-development/sdks.mdx +++ b/ja/development/api-development/sdks.mdx @@ -3,11 +3,12 @@ title: "Comfy SDK:ComfyUI 向け Python・TypeScript クライアント" description: "Comfy Cloud、デプロイ環境、または自前の ComfyUI に対して Python または TypeScript から ComfyUI ワークフローを実行し、アセット、ジョブ、ライブイベント、冪等なリトライを扱います。" sidebarTitle: "SDK" icon: "code" -translationSourceHash: fd912955 +translationSourceHash: 08ccc1fa translationFrom: development/api-development/sdks.mdx translationBlockHashes: "_intro": c92c7b51 "Install": da9a0a57 + "Using a coding agent": 2e17afaa "Quickstart": 02297586 "Choosing a base URL": 0e77e81c "Retrying a submit: the idempotency key": 7c83d78f @@ -64,6 +65,10 @@ Python 3.10 以降。Node 22 以降。 +## コーディングエージェントを使う + +コーディングエージェントに連携コードを書かせる場合は、`comfy-sdk` スキルを渡してください。このスキルは Comfy Router 上での開発向けに書かれており、適切なクライアントの選択、API キーをサーバー側に保つこと、呼び出す前にモデルを検出すること、`run` と `submit` の使い分け、タイムアウト、エラーの種別ごとの分岐についてエージェントを導きます。Claude Code では、`/plugin marketplace add Comfy-Org/comfy-skills` を実行してから `/plugin install comfy-sdk@comfy-skills` を実行します。その他のエージェントでは、単一の [`SKILL.md`](https://github.com/Comfy-Org/comfy-skills/blob/main/claude-code-sdk/skills/comfy-sdk/SKILL.md) ファイルを `AGENTS.md` や Cursor のルールなど、エージェントのルールにコピーしてください。 + ## クイックスタート 入力画像をアップロードし、ワークフローを実行して、結果をディスクに書き込みます。 diff --git a/ko/development/api-development/sdks.mdx b/ko/development/api-development/sdks.mdx index cf612468d2..d830eab419 100644 --- a/ko/development/api-development/sdks.mdx +++ b/ko/development/api-development/sdks.mdx @@ -3,11 +3,12 @@ title: "Comfy SDK: ComfyUI용 Python 및 TypeScript 클라이언트" description: "Python 또는 TypeScript로 Comfy Cloud, 자체 배포 또는 자체 ComfyUI를 대상으로 ComfyUI 워크플로를 실행하고, 에셋, 작업, 라이브 이벤트, 멱등 재시도를 다룹니다." sidebarTitle: "SDK" icon: "code" -translationSourceHash: fd912955 +translationSourceHash: 08ccc1fa translationFrom: development/api-development/sdks.mdx translationBlockHashes: "_intro": c92c7b51 "Install": da9a0a57 + "Using a coding agent": 2e17afaa "Quickstart": 02297586 "Choosing a base URL": 0e77e81c "Retrying a submit: the idempotency key": 7c83d78f @@ -64,6 +65,10 @@ Python 3.10 이상. Node 22 이상. +## 코딩 에이전트 사용하기 + +코딩 에이전트가 통합 코드를 작성한다면 `comfy-sdk` 스킬을 제공하세요. 이 스킬은 Comfy Router 기반 개발을 위해 작성되었으며, 올바른 클라이언트 선택, API 키를 서버에 보관하기, 호출 전에 모델 탐색하기, `run`과 `submit` 중 선택하기, 타임아웃, 오류 유형별 분기 처리에 대해 에이전트를 안내합니다. Claude Code에서는 `/plugin marketplace add Comfy-Org/comfy-skills`를 실행한 다음 `/plugin install comfy-sdk@comfy-skills`를 실행하세요. 다른 에이전트의 경우 단일 [`SKILL.md`](https://github.com/Comfy-Org/comfy-skills/blob/main/claude-code-sdk/skills/comfy-sdk/SKILL.md) 파일을 `AGENTS.md`나 Cursor 규칙 등 에이전트의 규칙에 복사하세요. + ## 빠른 시작 입력 이미지를 업로드하고 워크플로를 실행한 다음 결과를 디스크에 기록합니다. diff --git a/zh/development/api-development/sdks.mdx b/zh/development/api-development/sdks.mdx index ee5410768b..09a74d8eb9 100644 --- a/zh/development/api-development/sdks.mdx +++ b/zh/development/api-development/sdks.mdx @@ -3,11 +3,12 @@ title: "Comfy SDK:ComfyUI 的 Python 与 TypeScript 客户端" description: "用 Python 或 TypeScript 对 Comfy Cloud、自建部署或自有 ComfyUI 运行 ComfyUI 工作流,并处理资产、任务、实时事件和幂等重试。" sidebarTitle: "SDK" icon: "code" -translationSourceHash: fd912955 +translationSourceHash: 08ccc1fa translationFrom: development/api-development/sdks.mdx translationBlockHashes: "_intro": c92c7b51 "Install": da9a0a57 + "Using a coding agent": 2e17afaa "Quickstart": 02297586 "Choosing a base URL": 0e77e81c "Retrying a submit: the idempotency key": 7c83d78f @@ -64,6 +65,10 @@ Python 3.10 或更高版本。Node 22 或更高版本。 +## 使用编码代理 + +如果由编码代理编写您的集成,请为它提供 `comfy-sdk` 技能。该技能面向基于 Comfy Router 的开发,引导代理选择正确的客户端、将 API 密钥保留在服务器端、先发现模型再调用、在 `run` 与 `submit` 之间做出选择、设置超时,以及按错误类别分支处理。在 Claude Code 中,先运行 `/plugin marketplace add Comfy-Org/comfy-skills`,再运行 `/plugin install comfy-sdk@comfy-skills`。对于其他代理,将单个 [`SKILL.md`](https://github.com/Comfy-Org/comfy-skills/blob/main/claude-code-sdk/skills/comfy-sdk/SKILL.md) 文件复制到代理的规则中,例如 `AGENTS.md` 或您的 Cursor 规则。 + ## 快速入门 上传输入图像,运行工作流,并将结果写入磁盘。 From 7cd5ee5a9c7e0de53eac9ad00c7b3a220ebc9eb2 Mon Sep 17 00:00:00 2001 From: Matt Miller Date: Tue, 10 Nov 2026 22:36:34 +0000 Subject: [PATCH 2/2] docs: scope the comfy-sdk skill note to Comfy Router integrations The skill itself says it is not for ComfyUI workflows, while this page documents the workflow client. Qualify the recommendation and point workflow integrations at this guide and the Comfy API v2 reference. Mirrored in es/ja/ko/zh with refreshed translation hashes. Co-Authored-By: Claude Opus 5.5 --- development/api-development/sdks.mdx | 2 +- es/development/api-development/sdks.mdx | 6 +++--- ja/development/api-development/sdks.mdx | 6 +++--- ko/development/api-development/sdks.mdx | 6 +++--- zh/development/api-development/sdks.mdx | 6 +++--- 5 files changed, 13 insertions(+), 13 deletions(-) diff --git a/development/api-development/sdks.mdx b/development/api-development/sdks.mdx index 94a2a9cd80..06bedc7736 100644 --- a/development/api-development/sdks.mdx +++ b/development/api-development/sdks.mdx @@ -49,7 +49,7 @@ Python 3.10 or newer. Node 22 or newer. ## Using a coding agent -If a coding agent writes your integration, give it the `comfy-sdk` skill. It is written for building on Comfy Router and steers the agent on picking the right client, keeping the API key on the server, discovering a model before calling it, `run` versus `submit`, timeouts, and branching on error buckets. In Claude Code, run `/plugin marketplace add Comfy-Org/comfy-skills`, then `/plugin install comfy-sdk@comfy-skills`. For any other agent, copy the single [`SKILL.md`](https://github.com/Comfy-Org/comfy-skills/blob/main/claude-code-sdk/skills/comfy-sdk/SKILL.md) file into your agent's rules, such as `AGENTS.md` or your Cursor rules. +If a coding agent writes a Comfy Router integration, give it the `comfy-sdk` skill. It is written for building on Comfy Router and steers the agent on picking the right client, keeping the API key on the server, discovering a model before calling it, `run` versus `submit`, timeouts, and branching on error buckets. The skill does not cover running ComfyUI workflows. For the workflow client on this page, point the agent at this guide and the [Comfy API v2 reference](/api-reference/v2/overview) instead. In Claude Code, run `/plugin marketplace add Comfy-Org/comfy-skills`, then `/plugin install comfy-sdk@comfy-skills`. For any other agent, copy the single [`SKILL.md`](https://github.com/Comfy-Org/comfy-skills/blob/main/claude-code-sdk/skills/comfy-sdk/SKILL.md) file into your agent's rules, such as `AGENTS.md` or your Cursor rules. ## Quickstart diff --git a/es/development/api-development/sdks.mdx b/es/development/api-development/sdks.mdx index fea05760d4..53b4ecc6e9 100644 --- a/es/development/api-development/sdks.mdx +++ b/es/development/api-development/sdks.mdx @@ -3,12 +3,12 @@ title: "SDK de Comfy: clientes de Python y TypeScript para ComfyUI" description: "Ejecuta flujos de trabajo de ComfyUI desde Python o TypeScript en Comfy Cloud, tu propio despliegue: recursos, tareas, eventos en vivo y reintentos idempotentes." sidebarTitle: "SDK" icon: "code" -translationSourceHash: 08ccc1fa +translationSourceHash: 918d35f0 translationFrom: development/api-development/sdks.mdx translationBlockHashes: "_intro": c92c7b51 "Install": da9a0a57 - "Using a coding agent": 2e17afaa + "Using a coding agent": 6540d772 "Quickstart": 02297586 "Choosing a base URL": 0e77e81c "Retrying a submit: the idempotency key": 7c83d78f @@ -64,7 +64,7 @@ Python 3.10 o posterior. Node 22 o posterior. ## Usar un agente de programación -Si un agente de programación escribe tu integración, dale la habilidad `comfy-sdk`. Está escrita para desarrollar sobre Comfy Router y orienta al agente para elegir el cliente correcto, mantener la clave de API en el servidor, descubrir un modelo antes de llamarlo, elegir entre `run` y `submit`, configurar los tiempos de espera y ramificar según la categoría de error. En Claude Code, ejecuta `/plugin marketplace add Comfy-Org/comfy-skills` y después `/plugin install comfy-sdk@comfy-skills`. Para cualquier otro agente, copia el archivo único [`SKILL.md`](https://github.com/Comfy-Org/comfy-skills/blob/main/claude-code-sdk/skills/comfy-sdk/SKILL.md) en las reglas de tu agente, como `AGENTS.md` o tus reglas de Cursor. +Si un agente de programación escribe una integración con Comfy Router, dale la habilidad `comfy-sdk`. Está escrita para desarrollar sobre Comfy Router y orienta al agente para elegir el cliente correcto, mantener la clave de API en el servidor, descubrir un modelo antes de llamarlo, elegir entre `run` y `submit`, configurar los tiempos de espera y ramificar según la categoría de error. La habilidad no cubre la ejecución de flujos de trabajo de ComfyUI. Para el cliente de flujos de trabajo de esta página, indica al agente que consulte esta guía y la [referencia de Comfy API v2](/es/api-reference/v2/overview). En Claude Code, ejecuta `/plugin marketplace add Comfy-Org/comfy-skills` y después `/plugin install comfy-sdk@comfy-skills`. Para cualquier otro agente, copia el archivo único [`SKILL.md`](https://github.com/Comfy-Org/comfy-skills/blob/main/claude-code-sdk/skills/comfy-sdk/SKILL.md) en las reglas de tu agente, como `AGENTS.md` o tus reglas de Cursor. ## Inicio rápido diff --git a/ja/development/api-development/sdks.mdx b/ja/development/api-development/sdks.mdx index 3aede1822c..9fa1e43772 100644 --- a/ja/development/api-development/sdks.mdx +++ b/ja/development/api-development/sdks.mdx @@ -3,12 +3,12 @@ title: "Comfy SDK:ComfyUI 向け Python・TypeScript クライアント" description: "Comfy Cloud、デプロイ環境、または自前の ComfyUI に対して Python または TypeScript から ComfyUI ワークフローを実行し、アセット、ジョブ、ライブイベント、冪等なリトライを扱います。" sidebarTitle: "SDK" icon: "code" -translationSourceHash: 08ccc1fa +translationSourceHash: 918d35f0 translationFrom: development/api-development/sdks.mdx translationBlockHashes: "_intro": c92c7b51 "Install": da9a0a57 - "Using a coding agent": 2e17afaa + "Using a coding agent": 6540d772 "Quickstart": 02297586 "Choosing a base URL": 0e77e81c "Retrying a submit: the idempotency key": 7c83d78f @@ -67,7 +67,7 @@ Python 3.10 以降。Node 22 以降。 ## コーディングエージェントを使う -コーディングエージェントに連携コードを書かせる場合は、`comfy-sdk` スキルを渡してください。このスキルは Comfy Router 上での開発向けに書かれており、適切なクライアントの選択、API キーをサーバー側に保つこと、呼び出す前にモデルを検出すること、`run` と `submit` の使い分け、タイムアウト、エラーの種別ごとの分岐についてエージェントを導きます。Claude Code では、`/plugin marketplace add Comfy-Org/comfy-skills` を実行してから `/plugin install comfy-sdk@comfy-skills` を実行します。その他のエージェントでは、単一の [`SKILL.md`](https://github.com/Comfy-Org/comfy-skills/blob/main/claude-code-sdk/skills/comfy-sdk/SKILL.md) ファイルを `AGENTS.md` や Cursor のルールなど、エージェントのルールにコピーしてください。 +コーディングエージェントに Comfy Router の連携コードを書かせる場合は、`comfy-sdk` スキルを渡してください。このスキルは Comfy Router 上での開発向けに書かれており、適切なクライアントの選択、API キーをサーバー側に保つこと、呼び出す前にモデルを検出すること、`run` と `submit` の使い分け、タイムアウト、エラーの種別ごとの分岐についてエージェントを導きます。このスキルは ComfyUI ワークフローの実行を扱いません。このページのワークフロークライアントについては、代わりにこのガイドと [Comfy API v2 リファレンス](/ja/api-reference/v2/overview) をエージェントに参照させてください。Claude Code では、`/plugin marketplace add Comfy-Org/comfy-skills` を実行してから `/plugin install comfy-sdk@comfy-skills` を実行します。その他のエージェントでは、単一の [`SKILL.md`](https://github.com/Comfy-Org/comfy-skills/blob/main/claude-code-sdk/skills/comfy-sdk/SKILL.md) ファイルを `AGENTS.md` や Cursor のルールなど、エージェントのルールにコピーしてください。 ## クイックスタート diff --git a/ko/development/api-development/sdks.mdx b/ko/development/api-development/sdks.mdx index d830eab419..022776155a 100644 --- a/ko/development/api-development/sdks.mdx +++ b/ko/development/api-development/sdks.mdx @@ -3,12 +3,12 @@ title: "Comfy SDK: ComfyUI용 Python 및 TypeScript 클라이언트" description: "Python 또는 TypeScript로 Comfy Cloud, 자체 배포 또는 자체 ComfyUI를 대상으로 ComfyUI 워크플로를 실행하고, 에셋, 작업, 라이브 이벤트, 멱등 재시도를 다룹니다." sidebarTitle: "SDK" icon: "code" -translationSourceHash: 08ccc1fa +translationSourceHash: 918d35f0 translationFrom: development/api-development/sdks.mdx translationBlockHashes: "_intro": c92c7b51 "Install": da9a0a57 - "Using a coding agent": 2e17afaa + "Using a coding agent": 6540d772 "Quickstart": 02297586 "Choosing a base URL": 0e77e81c "Retrying a submit: the idempotency key": 7c83d78f @@ -67,7 +67,7 @@ Python 3.10 이상. Node 22 이상. ## 코딩 에이전트 사용하기 -코딩 에이전트가 통합 코드를 작성한다면 `comfy-sdk` 스킬을 제공하세요. 이 스킬은 Comfy Router 기반 개발을 위해 작성되었으며, 올바른 클라이언트 선택, API 키를 서버에 보관하기, 호출 전에 모델 탐색하기, `run`과 `submit` 중 선택하기, 타임아웃, 오류 유형별 분기 처리에 대해 에이전트를 안내합니다. Claude Code에서는 `/plugin marketplace add Comfy-Org/comfy-skills`를 실행한 다음 `/plugin install comfy-sdk@comfy-skills`를 실행하세요. 다른 에이전트의 경우 단일 [`SKILL.md`](https://github.com/Comfy-Org/comfy-skills/blob/main/claude-code-sdk/skills/comfy-sdk/SKILL.md) 파일을 `AGENTS.md`나 Cursor 규칙 등 에이전트의 규칙에 복사하세요. +코딩 에이전트가 Comfy Router 통합 코드를 작성한다면 `comfy-sdk` 스킬을 제공하세요. 이 스킬은 Comfy Router 기반 개발을 위해 작성되었으며, 올바른 클라이언트 선택, API 키를 서버에 보관하기, 호출 전에 모델 탐색하기, `run`과 `submit` 중 선택하기, 타임아웃, 오류 유형별 분기 처리에 대해 에이전트를 안내합니다. 이 스킬은 ComfyUI 워크플로 실행을 다루지 않습니다. 이 페이지의 워크플로 클라이언트에 대해서는 대신 이 가이드와 [Comfy API v2 레퍼런스](/ko/api-reference/v2/overview)를 에이전트에게 참고하도록 하세요. Claude Code에서는 `/plugin marketplace add Comfy-Org/comfy-skills`를 실행한 다음 `/plugin install comfy-sdk@comfy-skills`를 실행하세요. 다른 에이전트의 경우 단일 [`SKILL.md`](https://github.com/Comfy-Org/comfy-skills/blob/main/claude-code-sdk/skills/comfy-sdk/SKILL.md) 파일을 `AGENTS.md`나 Cursor 규칙 등 에이전트의 규칙에 복사하세요. ## 빠른 시작 diff --git a/zh/development/api-development/sdks.mdx b/zh/development/api-development/sdks.mdx index 09a74d8eb9..356c7e9f22 100644 --- a/zh/development/api-development/sdks.mdx +++ b/zh/development/api-development/sdks.mdx @@ -3,12 +3,12 @@ title: "Comfy SDK:ComfyUI 的 Python 与 TypeScript 客户端" description: "用 Python 或 TypeScript 对 Comfy Cloud、自建部署或自有 ComfyUI 运行 ComfyUI 工作流,并处理资产、任务、实时事件和幂等重试。" sidebarTitle: "SDK" icon: "code" -translationSourceHash: 08ccc1fa +translationSourceHash: 918d35f0 translationFrom: development/api-development/sdks.mdx translationBlockHashes: "_intro": c92c7b51 "Install": da9a0a57 - "Using a coding agent": 2e17afaa + "Using a coding agent": 6540d772 "Quickstart": 02297586 "Choosing a base URL": 0e77e81c "Retrying a submit: the idempotency key": 7c83d78f @@ -67,7 +67,7 @@ Python 3.10 或更高版本。Node 22 或更高版本。 ## 使用编码代理 -如果由编码代理编写您的集成,请为它提供 `comfy-sdk` 技能。该技能面向基于 Comfy Router 的开发,引导代理选择正确的客户端、将 API 密钥保留在服务器端、先发现模型再调用、在 `run` 与 `submit` 之间做出选择、设置超时,以及按错误类别分支处理。在 Claude Code 中,先运行 `/plugin marketplace add Comfy-Org/comfy-skills`,再运行 `/plugin install comfy-sdk@comfy-skills`。对于其他代理,将单个 [`SKILL.md`](https://github.com/Comfy-Org/comfy-skills/blob/main/claude-code-sdk/skills/comfy-sdk/SKILL.md) 文件复制到代理的规则中,例如 `AGENTS.md` 或您的 Cursor 规则。 +如果由编码代理编写您的 Comfy Router 集成,请为它提供 `comfy-sdk` 技能。该技能面向基于 Comfy Router 的开发,引导代理选择正确的客户端、将 API 密钥保留在服务器端、先发现模型再调用、在 `run` 与 `submit` 之间做出选择、设置超时,以及按错误类别分支处理。该技能不涵盖运行 ComfyUI 工作流。对于本页介绍的工作流客户端,请改为让代理参考本指南和 [Comfy API v2 参考](/zh/api-reference/v2/overview)。在 Claude Code 中,先运行 `/plugin marketplace add Comfy-Org/comfy-skills`,再运行 `/plugin install comfy-sdk@comfy-skills`。对于其他代理,将单个 [`SKILL.md`](https://github.com/Comfy-Org/comfy-skills/blob/main/claude-code-sdk/skills/comfy-sdk/SKILL.md) 文件复制到代理的规则中,例如 `AGENTS.md` 或您的 Cursor 规则。 ## 快速入门