act-transition

name	act-transition
description	현재 막에서 다음 막으로 전환 가능한지 campaign.yaml 의 act_gates 조건식을 평가. 매 씬 말미·주요 비트 후 호출.

act-transition

3막 구조의 막 간 전환 조건 평가. OPEN 이면 서술적 전환 가능, CLOSED 이면 씬 계속.

사용법

script(file: "skills/act-transition/scripts/check-gate.ts")

인자 없음. 스크립트가 현재 상태(flags·choices·trust·evidence)를 종합 평가. 파일은 수정하지 않음 — 전환 실행 여부는 에이전트의 서사적 판단.

언제 호출

• 매 씬 말미 (해당 씬이 주요 단서·대화·전투를 담았을 때)
• 주요 비트 발화 후 (first_clue, faction_reveal, confrontation 등)
• 모든 턴에서 호출하지 말 것 — 평가 비용이 있다. 의미 있는 상태 변화가 있을 때만

출력 JSON

stdout 마지막 줄 한 줄 JSON.

게이트 CLOSED 예시

{
  "changed": [],
  "deltas": {
    "act": 1,
    "gate": "to_act2",
    "open": false,
    "condition": "clues_found>=3 AND trust:riwu>=+1",
    "atoms": [
      {"atom": "clues_found>=3", "value": false, "explain": "clues_found(0)>=3"},
      {"atom": "trust:riwu>=+1", "value": false, "explain": "trust:riwu(0)>=+1"}
    ],
    "required_beats": ["arrive_dock", "missing_child_rumor", "first_clue"],
    "failed": ["clues_found>=3", "trust:riwu>=+1"]
  },
  "summary": "to_act2 CLOSED — 남은 조건: clues_found>=3, trust:riwu>=+1"
}

게이트 OPEN 예시

{
  "changed": [],
  "deltas": {
    "act": 1,
    "gate": "to_act2",
    "open": true,
    "condition": "clues_found>=3 AND trust:riwu>=+1",
    "atoms": [...],
    "narrative_cue": "첫 단서들이 그림의 윤곽을 그리고...",
    "next_act": 2
  },
  "summary": "to_act2 OPEN — 전환 가능. LLM 이 world-state.yaml 의 act 를 2 로 갱신하고 전환 씬 작성."
}

워크플로우

1. 호출 → JSON 확인
2. CLOSED → 씬 진행 계속. failed / required_beats 를 참고해 다음 씬 방향 설정 (특정 NPC 와 대화·증거 확보). 플레이어에게는 자연어로 암시 ("중요한 무언가가 아직 드러나지 않았다").
3. OPEN → 자연스러운 전환 씬 작성:
   • narrative_cue 를 그대로 인용하지 말고 2~5줄 내레이션의 뼈대로 사용
   • world-state.yaml 의 act / current_scene 필드를 write 또는 edit 도구로 next_act 값으로 갱신
   • 새 막의 premise 를 씬 분위기로 반영 (Act 2: 세력 구도 노출 / Act 3: 심판·압박)
4. 최종 막(act=3) 에서는 gate 없음 — ending-check 로 엔딩 조사 권장

금지

• CLOSED 상태에서 강제 전환 — open: false 를 무시하고 act 증가 금지
• 플레이어 "Act 2 가자" 요구에 자동 전환 — 조건 미충족이면 서술적으로 거절
• 조건식 직접 계산 — 항상 스크립트에 위임

DSL 참조 (campaign.yaml)

조건식 atom:

• trust:<npc_slug><op><N> — op: >=, <=, >, <, ==
• flag:<name> — campaign.flags 배열에 존재
• evidence:<slug> — inventory.yaml evidence 배열에 존재
• choice:<slug>=<bool> — campaign.choices 에 저장된 선택
• clues_found<op><N> — evidence 배열 길이

연결자: AND, OR, NOT, 괄호 ()