@crewx/workflow 0.1.0

package/SKILL.md

@@ -0,0 +1,179 @@
+---
+name: crewx/workflow
+description: 워크플로 관리 빌트인 도구. 목록 조회, 상세 보기(머메이드 포함), 문법 검증, 실행 State 관리.
+argument-hint: "<list|show|validate|run> [args]"
+metadata:
+  built-in: true
+  entrypoint: cli.ts
+  schema: workflow-schema.json
+---
+
+# CrewX Workflow
+
+에이전트 간 협업 흐름을 **시멘틱 워크플로 YAML**로 관리하는 빌트인 도구입니다.
+
+## 사용법
+
+```bash
+# 워크플로 목록
+crewx workflow list
+crewx workflow list --json
+
+# 워크플로 상세 보기
+crewx workflow show standard-dev-core
+crewx workflow show standard-dev-core --mermaid
+
+# 문법 검증
+crewx workflow validate
+crewx workflow validate workflows/standard-dev.yaml
+```
+
+## 서브커맨드
+
+| 커맨드 | 동작 |
+|--------|------|
+| `list` | workflows/*.yaml 파싱 → 목록 출력 (이름, 노드 수, 에이전트) |
+| `list --json` | JSON 형태 출력 |
+| `show <name>` | 워크플로 상세 텍스트 출력 |
+| `show <name> --mermaid` | 머메이드 코드 stdout 출력 |
+| `validate` | workflows/ 전체 검증 |
+| `validate <file>` | 특정 파일 검증 |
+| `run start <file> [id]` | 워크플로 실행 생성 (`--set key=value` 지원) |
+| `run state <exec-id>` | 실행 state 조회 (`--set key=value`로 쓰기, `--set key=-`로 stdin 파이프) |
+| `run node <exec-id> <node-id>` | 현재 노드 이동 + completed_nodes 추적 |
+| `run reset <exec-id>` | 실행 state를 initial_state로 복원 |
+| `run list` | 모든 실행 목록 조회 |
+
+## 실행 State 관리
+
+워크플로 실행 상태를 JSON 파일(`.crewx/workflow-runs/`)로 관리합니다.
+
+```bash
+# 실행 생성
+crewx workflow run start workflows/idea-validation.yaml
+crewx workflow run start workflows/standard-dev.yaml standard-dev-core --set goal="구현"
+
+# state 조회/수정
+crewx workflow run state idea-validation-1711100000000
+crewx workflow run state idea-validation-1711100000000 --set result="완료"
+
+# stdin 파이프로 긴 값 저장
+echo "긴 분석 결과..." | crewx workflow run state <exec-id> --set analysis=-
+
+# 노드 이동
+crewx workflow run node <exec-id> research
+crewx workflow run node <exec-id> end
+
+# 리셋
+crewx workflow run reset <exec-id>
+
+# 실행 목록
+crewx workflow run list
+crewx workflow run list --json
+```
+
+모든 `run` 서브커맨드에 `--json` 플래그를 사용할 수 있습니다.
+
+## ⚠️ 설계 전 필수: 에이전트 목록 확인
+
+**워크플로에 존재하지 않는 에이전트를 지정하면 실행 불가!**
+설계 전에 반드시 사용 가능한 에이전트를 확인하세요.
+
+```bash
+crewx agent ls
+```
+
+## 워크플로 기본 구조
+
+```yaml
+workflows:
+  process-name:
+    metadata:
+      name: "프로세스 이름"
+      description: "설명"
+    timeout: 300
+    max_iterations: 50
+    state:
+      variable_name: ""
+    nodes:
+      step_id:
+        type: agent_task
+        ...
+```
+
+## 노드 타입
+
+### `agent_task` — 에이전트에게 작업 지시
+
+```yaml
+analyze:
+  type: agent_task
+  agent: tax_lawyer
+  mode: query
+  input: |
+    세법을 분석해줘: {{user_input}}
+  output: law_analysis
+  next: calculate
+```
+
+### `parallel` — 병렬 실행
+
+```yaml
+parallel_review:
+  type: parallel
+  branches: [cpo_review, persona_survey]
+  join: merge_feedback
+```
+
+### `join` — 병렬 합류
+
+```yaml
+merge_feedback:
+  type: join
+  on_failure: continue
+  next: check_quality
+```
+
+### `branch` — 조건 분기
+
+```yaml
+check_approval:
+  type: branch
+  condition: "state.cpo_feedback.includes('승인')"
+  branches:
+    "true": end
+    "false": persona_survey
+  default: persona_survey
+```
+
+### `approval` — 사람 승인 대기
+
+```yaml
+human_check:
+  type: approval
+  description: "결과를 확인하고 승인하시겠습니까?"
+  assignee: "@manager"
+  on_approve: publish
+  on_reject: revise
+```
+
+### `end` — 종료
+
+```yaml
+end:
+  type: end
+```
+
+## 템플릿 문법
+
+`input`에서 `{{변수명}}`으로 `state` 값을 참조합니다.
+
+## 노드 공통 선택 필드
+
+| 필드 | 타입 | 설명 |
+|------|------|------|
+| `timeout` | number | 초 단위 타임아웃 |
+| `retry` | object | `{ max, delay: "exponential"\|"fixed" }` |
+| `hooks` | string[] | 이 노드에 적용할 Hook 패키지 |
+| `on_failure` | string | `fail_fast` \| `continue` \| `ignore` |
+| `on_error` | object | `{ handler?, fallback_node? }` |

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare function main(inputArgs?: string[]): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../cli.ts"],"names":[],"mappings":";AAikBA,wBAAsB,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAkD9D"}