AGENT SKILL

manage-workflows

ComfyUI 워크플로우 패키지를 관리할 때 사용한다 (새 워크플로우 등록, 기존 워크플로우 수정/조회/삭제).

License 许可
MIT
最近更新
2026-10-07
Stars
★ 3
Forks
0

01 前言 Front Matter

name
manage-workflows
description
ComfyUI 워크플로우 패키지를 관리할 때 사용한다 (새 워크플로우 등록, 기존 워크플로우 수정/조회/삭제).
allowed-tools
Read

03 SKILL.md 正文

ComfyUI 워크플로우 패키지 관리

개요

comfyui_workflow 도구로 워크플로우 패키지를 CRUD한다. 각 패키지는 workflow.json + params.json + 선택적 resolver.mjs로 구성된다.

LoRA를 포함한 패키지 설계

LoRA를 추가·변경할 때는 이미지 생성 스킬의 「모델별 LoRA 치트시트 확인」 절차로 모델 호환성·권장 강도·트리거·기본 체인 중복을 확인한다. 참조 경로는 이 SKILL.md 기준이다. 단순 목록 조회나 LoRA와 무관한 패키지 수정에는 치트시트 조회가 필요 없다.

Action별 사용법

list — 패키지 목록 조회

{ "action": "list" }

반환: 각 패키지의 name, description, 파라미터 요약, resolver 존재 여부

get — 패키지 상세 조회

{ "action": "get", "name": "portrait" }

반환: workflow.json 전체, params.json 전체, resolver.mjs 소스코드 (있으면)

save — 패키지 생성/수정

{
  "action": "save",
  "name": "my-workflow",
  "workflow": { "1": { "class_type": "...", "inputs": {...} }, ... },
  "params": {
    "description": "워크플로우 설명",
    "features": {
      "checkpoint_auto": true,
      "lora_injection": true,
      "lora_couple_branches": false,
      "seed_randomize": true,
      "trigger_tags": true
    },
    "params": {
      "prompt": { "node": "2", "field": "text", "type": "string", "required": true, "description": "생성 프롬프트" },
      "seed": { "node": "5", "field": "seed", "type": "number", "default": -1 }
    }
  }
}
  • name: 영문, 숫자, 하이픈, 언더스코어만 허용
  • resolver: 문자열이면 resolver.mjs로 저장, null이면 기존 resolver 삭제, 생략하면 기존 유지

delete — 패키지 삭제

{ "action": "delete", "name": "my-workflow" }

새 워크플로우 등록 가이드

사용자가 ComfyUI API format JSON을 제공하면:

  1. JSON의 노드 구조를 분석하여 주요 입력 파라미터를 식별한다
  2. params.json의 params 필드에 각 파라미터의 node, field, type, required, default, description을 매핑한다
  3. features 플래그를 설정한다:
    • checkpoint_auto: CheckpointLoaderSimple 노드가 있으면 true
    • lora_injection: LoRA를 동적으로 주입/교체하려면 true
    • lora_couple_branches: Attention Couple 좌/우 분리 워크플로우면 true
    • seed_randomize: 시드 파라미터가 있으면 true
    • trigger_tags: LoRA 트리거 태그 자동 삽입이 필요하면 true
  4. save action으로 저장한다
  5. comfyui_generate에서 workflow: "my-workflow"로 사용한다

params.json과 resolver의 역할 분리

  • 단순히 하나의 파라미터를 하나의 node/field에 매핑하는 경우에는 params.json만 사용하라.
  • 여러 노드를 동시에 수정해야 하거나, 파라미터 값에 따라 조건 분기가 필요할 때만 resolver.mjs를 작성하라.
  • params.json에 정의된 파라미터 중 node/field가 없는 항목은 resolver가 직접 소비하는 제어 파라미터로 사용할 수 있다.
  • resolver는 강력하지만 유지보수 비용이 높다. 기본 매핑으로 충분한 경우 resolver를 만들지 마라.

resolver.mjs 작성 가이드

기본 리졸버(params.json의 node+field 매핑)로 충분하지 않을 때만 작성한다.

export default function resolve(workflow, params, context) {
  // context.defaultResolve — 기본 매핑을 먼저 적용하고 싶을 때
  const patched = context.defaultResolve(workflow, params, context);

  // context.sessionDir — 세션 디렉토리 경로
  // context.config — comfyui-config.json 내용
  // context.models — { checkpoints: [...], loras: [...] }

  // 커스텀 로직...
  return patched;
}

resolver에서 에러가 발생하면 이미지 생성 자체가 실패한다 (폴백 없음).

features 플래그 상세

플래그 설명 해당 런타임 변환
checkpoint_auto CheckpointLoaderSimple의 ckpt_name을 사용 가능한 모델로 자동 교체 체크포인트 없는 워크플로우(후처리 등)는 false
lora_injection base LoRA 주입 + 동적 LoRA override/injection + 프루닝 LoRA를 쓰지 않는 워크플로우는 false
lora_couple_branches scene-couple용 좌/우 CLIP 브랜치 LoRA 주입 Attention Couple 워크플로우에서만 true
seed_randomize seed=-1이면 랜덤 값으로 교체 시드 파라미터가 없으면 false
trigger_tags 활성 LoRA의 트리거 태그를 프롬프트에 삽입 LoRA trigger 자동 삽입이 불필요하면 false

04 同仓库更多 Skills

DevelopmentDummy
DevelopmentDummy/claude-play

generate-video

claude-play-bridge MCP 서버로 영상을 생성한다. 로컬 ComfyUI의 영상 워크플로 패키지(MiniMax H3 = 영상+오디오 동시 생성, WAN 2.2 i2v, Z-Image→영상)를 호출한다. 렌더가 수 분~수십 분 걸리므로 async 큐잉 + 파일 폴링이 기본 절차다. "영상", "동영상", "비디오", "video", "i2v", "t2v", "클립 만들어", "움직이는", "애니메이션 영상" 요청에 트리거된다.

图像与多媒体Skill与智能体开发
★ 3
DevelopmentDummy
DevelopmentDummy/claude-play

generate-image

claude-play-bridge MCP 서버로 이미지를 생성한다. 기본 백엔드는 ComfyUI(로컬 GPU, 워크플로 패키지 기반)이고, 사용자가 명시적으로 요청할 때만 GPT/Gemini 백엔드를 사용한다.

图像与多媒体Skill与智能体开发
★ 3
DevelopmentDummy
DevelopmentDummy/claude-play

generate-image-openai

OpenAI/GPT 이미지 생성(GPT Image 품질 / 텍스트 렌더링·이미지 편집 강점). 기본 백엔드는 Codex CLI 구독(건당 과금 없음). ⚠️ 사용자가 이 백엔드를 명시적으로 지정했을 때만 사용한다(예 "GPT로/OpenAI로 그려줘"). 기본 이미지 생성은 generate-image(ComfyUI)이며, 사용자가 콕 집어 요청하지 않았다면 절대 OpenAI를 자동으로 선택하지 마라.

图像与多媒体
★ 3
DevelopmentDummy
DevelopmentDummy/claude-play

generate-spritesheet

Gemini 이미지 생성으로 게임용 아이콘 스프라이트시트를 만들고 자동 슬라이스한다. 아이콘, UI 리소스, 뱃지, 마커 등 여러 개의 동일 카테고리 에셋이 필요할 때 사용한다.

★ 3
DevelopmentDummy
DevelopmentDummy/claude-play

generate-image-gemini

Gemini API로 이미지를 생성한다. 패널 배경, UI 리소스, 아이콘, 장면 삽화 등 디자인 리소스 제작에 사용한다. ComfyUI가 없을 때의 이미지 생성 대안이기도 하다.

图像与多媒体
★ 3
DevelopmentDummy
DevelopmentDummy/claude-play

workflow-research

새 ComfyUI 워크플로우를 설계하거나 신규 모델, 양자화 모델, LoRA 개발 전략을 비교할 때 분석 틀을 잡는다.

资料检索与研究Skill与智能体开发
★ 3