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을 제공하면:
- JSON의 노드 구조를 분석하여 주요 입력 파라미터를 식별한다
params.json의params필드에 각 파라미터의node,field,type,required,default,description을 매핑한다features플래그를 설정한다:checkpoint_auto: CheckpointLoaderSimple 노드가 있으면truelora_injection: LoRA를 동적으로 주입/교체하려면truelora_couple_branches: Attention Couple 좌/우 분리 워크플로우면trueseed_randomize: 시드 파라미터가 있으면truetrigger_tags: LoRA 트리거 태그 자동 삽입이 필요하면true
saveaction으로 저장한다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
generate-video
claude-play-bridge MCP 서버로 영상을 생성한다. 로컬 ComfyUI의 영상 워크플로 패키지(MiniMax H3 = 영상+오디오 동시 생성, WAN 2.2 i2v, Z-Image→영상)를 호출한다. 렌더가 수 분~수십 분 걸리므로 async 큐잉 + 파일 폴링이 기본 절차다. "영상", "동영상", "비디오", "video", "i2v", "t2v", "클립 만들어", "움직이는", "애니메이션 영상" 요청에 트리거된다.
generate-image
claude-play-bridge MCP 서버로 이미지를 생성한다. 기본 백엔드는 ComfyUI(로컬 GPU, 워크플로 패키지 기반)이고, 사용자가 명시적으로 요청할 때만 GPT/Gemini 백엔드를 사용한다.
generate-image-openai
OpenAI/GPT 이미지 생성(GPT Image 품질 / 텍스트 렌더링·이미지 편집 강점). 기본 백엔드는 Codex CLI 구독(건당 과금 없음). ⚠️ 사용자가 이 백엔드를 명시적으로 지정했을 때만 사용한다(예 "GPT로/OpenAI로 그려줘"). 기본 이미지 생성은 generate-image(ComfyUI)이며, 사용자가 콕 집어 요청하지 않았다면 절대 OpenAI를 자동으로 선택하지 마라.
generate-spritesheet
Gemini 이미지 생성으로 게임용 아이콘 스프라이트시트를 만들고 자동 슬라이스한다. 아이콘, UI 리소스, 뱃지, 마커 등 여러 개의 동일 카테고리 에셋이 필요할 때 사용한다.
generate-image-gemini
Gemini API로 이미지를 생성한다. 패널 배경, UI 리소스, 아이콘, 장면 삽화 등 디자인 리소스 제작에 사용한다. ComfyUI가 없을 때의 이미지 생성 대안이기도 하다.
workflow-research
새 ComfyUI 워크플로우를 설계하거나 신규 모델, 양자화 모델, LoRA 개발 전략을 비교할 때 분석 틀을 잡는다.