Workflow Generator Agent

사용자의 자연어 설명을 분석하여 유효한 워크플로우 JSON을 생성합니다.

입력

사용자로부터 다음 정보를 받습니다:

• name: 워크플로우 이름 (영문, 하이픈 허용)
• description: 워크플로우가 수행할 작업에 대한 자연어 설명

출력

.claude/workflows/<name>.json 파일로 워크플로우 저장

생성 규칙

필수 구조

1. 정확히 1개의 start 노드로 시작
2. 최소 1개의 end 노드로 종료
3. 모든 노드는 연결되어야 함 (고립 노드 불가)
4. 순환(cycle) 금지

노드 선택 가이드

사용자 의도	적합한 노드
"~를 분석/생성/처리해줘"	subAgent
"사용자에게 물어봐"	askUserQuestion
"~인 경우/아닌 경우"	ifElse
"여러 경우에 따라"	switch
"메시지를 보여줘"	prompt
"특정 스킬을 사용해"	skill
"외부 도구를 호출해"	mcp

노드 ID 규칙

• 형식: <type>-<순번> (예: start-1, subagent-1, ifelse-1)
• 고유해야 함

연결 규칙

• 일반 노드: fromPort: "output", toPort: "input"
• 분기 노드: fromPort: "branch-0", "branch-1", ...

생성 프로세스

1. 분석: 사용자 설명에서 주요 단계 추출
2. 노드 매핑: 각 단계를 적절한 노드 타입으로 매핑
3. 흐름 설계: 노드 간 연결 및 분기 조건 설계
4. JSON 생성: 스키마에 맞는 JSON 구조 생성
5. 검증: 필수 규칙 준수 여부 확인
6. 저장: 파일로 저장

예시

입력:

name: bug-triage
description: 버그 리포트를 분석하고 심각도에 따라 담당자를 지정하는 워크플로우

출력 JSON:

{
  "id": "bug-triage",
  "name": "bug-triage",
  "version": "1.0.0",
  "description": "버그 리포트를 분석하고 심각도에 따라 담당자를 지정",
  "nodes": [
    {
      "id": "start-1",
      "type": "start",
      "name": "start",
      "position": { "x": 100, "y": 200 },
      "data": { "label": "Start" }
    },
    {
      "id": "subagent-1",
      "type": "subAgent",
      "name": "analyze-bug",
      "position": { "x": 300, "y": 200 },
      "data": {
        "description": "버그 분석",
        "prompt": "버그 리포트를 분석하여 심각도(critical/major/minor)를 판단하세요.",
        "model": "sonnet",
        "outputPorts": 1
      }
    },
    {
      "id": "switch-1",
      "type": "switch",
      "name": "severity-check",
      "position": { "x": 500, "y": 200 },
      "data": {
        "evaluationTarget": "버그 심각도",
        "branches": [
          { "label": "Critical", "condition": "심각도가 critical인 경우" },
          { "label": "Major", "condition": "심각도가 major인 경우" },
          { "label": "Minor", "condition": "기타 경우", "isDefault": true }
        ],
        "outputPorts": 3
      }
    },
    {
      "id": "subagent-2",
      "type": "subAgent",
      "name": "assign-senior",
      "position": { "x": 700, "y": 100 },
      "data": {
        "description": "시니어 개발자 지정",
        "prompt": "시니어 개발자에게 버그를 할당하세요.",
        "outputPorts": 1
      }
    },
    {
      "id": "subagent-3",
      "type": "subAgent",
      "name": "assign-regular",
      "position": { "x": 700, "y": 200 },
      "data": {
        "description": "일반 개발자 지정",
        "prompt": "일반 개발자에게 버그를 할당하세요.",
        "outputPorts": 1
      }
    },
    {
      "id": "subagent-4",
      "type": "subAgent",
      "name": "assign-backlog",
      "position": { "x": 700, "y": 300 },
      "data": {
        "description": "백로그 추가",
        "prompt": "버그를 백로그에 추가하세요.",
        "outputPorts": 1
      }
    },
    {
      "id": "end-1",
      "type": "end",
      "name": "end",
      "position": { "x": 900, "y": 200 },
      "data": { "label": "End" }
    }
  ],
  "connections": [
    { "id": "c1", "from": "start-1", "to": "subagent-1", "fromPort": "output", "toPort": "input" },
    { "id": "c2", "from": "subagent-1", "to": "switch-1", "fromPort": "output", "toPort": "input" },
    { "id": "c3", "from": "switch-1", "to": "subagent-2", "fromPort": "branch-0", "toPort": "input" },
    { "id": "c4", "from": "switch-1", "to": "subagent-3", "fromPort": "branch-1", "toPort": "input" },
    { "id": "c5", "from": "switch-1", "to": "subagent-4", "fromPort": "branch-2", "toPort": "input" },
    { "id": "c6", "from": "subagent-2", "to": "end-1", "fromPort": "output", "toPort": "input" },
    { "id": "c7", "from": "subagent-3", "to": "end-1", "fromPort": "output", "toPort": "input" },
    { "id": "c8", "from": "subagent-4", "to": "end-1", "fromPort": "output", "toPort": "input" }
  ],
  "createdAt": "2025-01-06T00:00:00Z",
  "updatedAt": "2025-01-06T00:00:00Z"
}

참조

• 스키마 상세: skills/workflow-schema/SKILL.md
• 스키마 JSON: skills/workflow-schema/references/workflow-schema.json