에이전트의 질문에 폰으로 답하기

에이전트는 내가 정할 일을 만나면 결정 게이트를 열고 멈춥니다. 폰에서 선택지를 누르면 에이전트가 그 답대로 일을 이어 갑니다.

목표. 에이전트가 일하는 동안 나는 컴퓨터 앞에 없습니다. 에이전트는 내가 정해야 할 일을 만나면 묻고, 폰에는 선택지가 버튼으로 달린 질문이 옵니다. 내가 누른 답이 에이전트의 다음 메시지가 됩니다.

필요한 것

  • st 0.3.83 이상을 쓰고, st hooks install을 해 둡니다.
  • 장치가 로그인(st login)되어 터널로 공유하고 있어야 합니다. 알림이 계정을 거쳐 가기 때문입니다.
  • 폰 앱이 같은 계정으로 로그인되어 있고 알림이 켜져 있어야 합니다.
  • 에이전트가 st가 공유하는 세션의 pane에서 실행 중이어야 합니다. 코디네이터와 워커 모두 물을 수 있습니다.

1. 언제 물을지 알려 주기

프롬프트, 과제 파일, CLAUDE.md 중 한 곳에 적습니다.

이미지 저장 방식을 바꾸기 전에 결정 게이트(st gate ask)로 나에게 묻고,
내가 답할 때까지 멈춰.

st worker start로 띄운 워커에게는 따로 적지 않아도 됩니다. 워커용 안내문에 사람만 정할 수 있는 일이면 게이트를 열라고 적혀 있습니다.

2. 에이전트가 묻기

st gate ask "이미지는 어떻게 다룰까요?" --title "이미지" \
  --option "A: 첨부로만 보관" --option "B: OCR로 글자 추출" --text

st가 "gate … is open"이라고 답하면 에이전트는 턴을 멈춥니다.

  • --option은 아홉 개까지 줄 수 있습니다. --title은 알림과 앱에 보일 짧은 제목입니다. 주지 않으면 "Decision"이 됩니다.
  • --text를 주면 선택지 대신 글로 답하거나, 선택지와 함께 글을 덧붙일 수 있습니다. 선택지 없이 --text만 주면 글로만 답합니다.
  • pane 하나에는 게이트가 하나만 열립니다. 새로 물으면 이전 질문을 대신합니다.

3. 답하기

어디서 답해도 되고, 가장 먼저 들어온 답이 쓰입니다.

  • 폰. 알림에 선택지가 버튼으로 달려 있으니 하나를 누릅니다.
  • 데스크탑 앱과 웹 터미널. 그 에이전트의 창에 ?가 붙고 질문이 보입니다.
  • 공유 세션의 셸. 다음처럼 답합니다.
st gate list                                  # 열린 게이트: id, pane, 질문
st gate answer <id> 2                         # 2번 선택지(번호는 1부터)
st gate answer <id> 2 "원본은 남겨 줘"
st gate answer <id> "1600px로 줄여 줘"          # 글로만(--text일 때)

4. 에이전트가 이어 가기

st가 그 에이전트의 pane에 답을 다음 메시지로 입력합니다.

Decision gate … answered: B: OCR로 글자 추출 — 원본은 남겨 줘. Carry on with that.

에이전트는 거기서부터 이어 갑니다. st gate show <id>는 답이 무엇인지, 그 답이 입력되었는지를 보여 줍니다. 그때 에이전트의 입력창이 보이지 않아 입력되지 않았다면 에이전트에게 직접 말해 줍니다.

워커의 질문

게이트를 연 워커는 질문 중인 것으로 봅니다. 코디네이터의 st worker wait와 st task wait는 "워커가 질문 중"이라는 뜻의 3을 돌려주고, st gate list에 그 질문이 보입니다. 답하면 워커가 일을 이어 가고, 코디네이터의 다음 wait는 워커가 끝날 때 돌아옵니다.

열린 게이트는 st를 다시 시작해도 남습니다. st gate cancel <id>로 질문을 거둘 수 있습니다.

자세한 내용은 결정 게이트에 있습니다.