play-llm-baduk
설치된 `baduk` CLI로 사람 대 LLM 또는 CLI 대 CLI 바둑 대국을 진행한다. 사람 차례 대기, 패스, 무르기, 계가 합의, 재개와 종료를 처리할 때 사용한다.
SKILL.mdbaduk/src/llm_baduk/skills/play-llm-baduk/SKILL.md
GitHubLLM 바둑 대국
사람은 브라우저 보드에서 수를 두고, 언어 모델은 설치된 baduk 명령으로 자신의 수를 전달합니다. CLI 대 CLI 모드에서는 서로 독립적인 AI 세션 두 개가 흑과 백을 각각 맡습니다. 매번 반환된 스냅샷을 현재 상태의 기준으로 사용합니다.
시작 또는 이어하기
baduk --help를 실행하고 표시된 명령 규약을 사용합니다.baduk status로 현재 스냅샷을 확인합니다.status는 색상 지정 여부와 관계없이 읽기 전용입니다.- 명령이 없으면 LLM Baduk을 설치해야 한다고 알리고 멈춥니다.
- 서버에 연결할 수 없으면
baduk start를 별도 프로세스로 실행하고, 대국 명령은 별도 셸에서 실행합니다. - 상태가
setup이면 브라우저에서 대국 모드·판 크기·참가자 이름을 설정하도록 안내합니다. 대국 생성 명령은 CLI에 없습니다. - 상태가 CLI 대 CLI이면 자신의 색상을 정해 모든 참가자 명령의 서브명령 앞에
--color black또는--color white를 붙입니다. 두 색상은 각각 별도 AI 세션에서 실행하며, 공유 세션 설정을 사용하지 않습니다.
턴 진행
status가finished,resigned또는draw이면 종료 상태입니다.result와 마지막 이벤트를 알리고 대국 루프를 끝냅니다.game_reset이벤트가 반환되면 해당 종료 코드는 일시적인 대기 깨움 신호로 취급합니다.baduk status를 다시 실행해 새 상태에서 계속합니다.- 사람의 차례이면
baduk wait를 실행합니다. 계가 중인 상태에서 사람의 다음 변경을 기다릴 때는 검토한 스냅샷의 revision을baduk wait --after-revision N으로 전달합니다. - 언어 모델 차례이면 현재 스냅샷의
legal_moves에서 수를 하나 골라baduk move MOVE로 제출합니다.pass도 유효한 수입니다. 즉시 반환이 필요할 때만--no-wait를 사용합니다. - 대기 중인 사람의 무르기 요청이 반환되면 사용자 지시와 현재 대국 맥락으로 수락 또는 거부를 결정하고,
baduk takeback accept또는baduk takeback reject중 하나를 실행합니다. 요청이 처리될 때까지 새 수를 제출하지 않습니다. - 언어 모델의 최근 수를 무르고 싶으면
baduk takeback request를 실행한 뒤 반환된 수락·거부 스냅샷을 처리합니다.
CLI 대 CLI 턴 진행
- 흑 세션과 백 세션을 각각 독립적으로 실행합니다. 모든
wait,move,takeback,resign,score명령에 해당 세션의--color를 다시 지정합니다. - 기본
move는 상대 응답을 기다리며--no-wait도 사용할 수 있습니다. 한 세션에서 대기 명령을 하나만 실행합니다. game_reset이벤트가 반환되면 종료 코드가 일시적인 대기 깨움 신호입니다. 해당 세션에서baduk --color COLOR status를 다시 실행해 새 상태를 읽습니다.- 무르기 요청은 상대 색상 세션이
baduk --color COLOR takeback accept또는baduk --color COLOR takeback reject로 처리합니다. color_required와player_not_cli는 대국 상태에 따른 정상 오류입니다. 색상, 대국 모드, 참가자 제어 주체를 확인하고 명령을 고칩니다.- CLI가 상대 AI를 자동으로 실행하지 않습니다. 두 세션의 진행과 대기 상태를 각각 관리합니다.
계가와 합의
- 상태가
scoring이면 스냅샷의stones,dead,seki,territory,prisoners,totals를 검토합니다. - 사람 대 LLM 모드에서 죽은 돌이나 세키를 표시하려면
baduk score dead POINT또는baduk score seki POINT를 실행합니다. 표시는 연결된 돌무리 전체에 적용됩니다. CLI 대 CLI 모드에서는 두 명령 모두 검토한 revision을--revision N으로 명시합니다. - 검토를 끝낸 스냅샷의 revision을 사용해 합의합니다. 사람 대 LLM 모드는
baduk score accept를 실행하면 현재 revision을 자동 조회할 수 있고, CLI 대 CLI 모드는 반드시baduk --color COLOR score accept --revision N을 실행합니다. 검토 후 상태가 바뀌었으면 새 스냅샷을 다시 검토하고 새 revision을 사용합니다. - revision 충돌이 나면 해당 색상 세션에서
status를 다시 읽고 새 스냅샷을 검토한 뒤 명령을 재실행합니다. - 양측 합의가 끝나면 반환된 종료 스냅샷의 결과를 알립니다. 계가 의견이 다르면 해당 색상으로
baduk --color COLOR score resume을 실행하고 새 상태를 확인해 턴 루프를 재개합니다.
운영 규칙
- 각 세션에서 한 번에 차단 대기 명령 하나만 실행합니다.
- 브라우저의 색상 선택과 사람 수 입력은 사람의 작업으로 둡니다.
- 서버가 반환한 법적 수와 현재 revision을 벗어나서 수나 계가 결과를 추측하지 않습니다.
- 서버 프로세스는 수, 무르기, 계가, 재개와 종료를 처리하는 동안 유지합니다.