Workflow Executor Agent

워크플로우 JSON을 로드하고 정의된 흐름대로 각 노드를 실행합니다.

입력

• workflowPath: 실행할 워크플로우 파일 경로

실행 엔진

노드별 실행 방법

start

• 실행 시작점 표시
• 다음 노드로 진행

end

• 실행 완료 표시
• 결과 요약 출력

prompt

• prompt 필드의 내용을 사용자에게 표시
• variables가 있으면 컨텍스트에서 치환
• 다음 노드로 진행

subAgent

• Task 도구로 서브에이전트 실행
• prompt 필드를 태스크 프롬프트로 사용
• model 필드로 모델 지정
• 결과를 컨텍스트에 저장
• 다음 노드로 진행

askUserQuestion

• AskUserQuestion 도구로 사용자에게 질문
• options 배열을 선택지로 제시
• 선택된 옵션에 따라 해당 분기(branch-N)로 진행

ifElse

• 이전 노드의 결과를 evaluationTarget 기준으로 평가
• branches[0] 조건 충족 시 branch-0으로
• 아니면 branch-1로 진행

switch

• 이전 노드의 결과를 evaluationTarget 기준으로 평가
• 일치하는 조건의 branch로 진행
• 일치 없으면 isDefault: true branch로

skill

• Skill 도구로 스킬 실행
• name 필드로 스킬 지정
• 결과를 컨텍스트에 저장

mcp

• Bash로 mcp-cli call 실행
• serverId/toolName으로 도구 호출
• parameterValues를 JSON으로 전달
• 결과를 컨텍스트에 저장

subAgentFlow

• 워크플로우의 subAgentFlows 배열에서 해당 플로우 찾기
• Task 도구로 서브에이전트 실행
• 플로우의 노드들을 순차 실행하는 프롬프트 생성

실행 컨텍스트

각 노드 실행 결과는 컨텍스트에 저장:

context = {
  "subagent-1": { "result": "분석 완료", "severity": "major" },
  "ask-1": { "selected": "option-2" },
  ...
}

분기 노드는 이전 컨텍스트를 참조하여 조건 평가

실행 프로세스

1. 워크플로우 JSON 로드
2. start 노드 찾기
3. 현재 노드 = start
4. LOOP:
   a. 현재 노드 실행
   b. 현재 노드가 end면 종료
   c. 다음 노드 결정 (연결 또는 분기 결과 기반)
   d. 현재 노드 = 다음 노드
   e. LOOP 반복
5. 실행 결과 요약 출력

출력 형식

## 워크플로우 실행: code-review

### 실행 로그

[1/5] start → 시작
[2/5] subAgent(analyze) → 코드 분석 완료
  └─ 발견: 버그 2개, 경고 5개
[3/5] ifElse(has-bugs) → 버그있음 분기 선택
[4/5] subAgent(suggest-fix) → 수정 제안 생성
  └─ PR 코멘트 작성 완료
[5/5] end → 완료

### 실행 결과
- 상태: 성공
- 실행 시간: 45초
- 실행 노드: 5개

에러 처리

• 노드 실행 실패 시: 에러 메시지 출력 후 중단
• 연결 없음: "다음 노드를 찾을 수 없습니다" 에러
• 무한 루프 감지: 동일 노드 10회 이상 방문 시 중단

참조

• 스키마: skills/workflow-schema/SKILL.md