← 전체 기능

설치·운영v0.3.0에서 사용 가능

명령과 다음 단계 안내

AI는 oah init이 설치한 규칙과 각 명령의 다음 단계 안내를 따라 대화 아래에서 oah 명령을 실행한다. 모든 명령은 --help를 받고, 종료 코드는 정해져 있으며(0 완료, 1 거절, 2 사용법, 69 환경, 75 대기 시간 초과), 모든 거절은 OAH_* 코드로 시작해 다음에 실행할 것을 알려 준다.

필요한 상황

AI가 도구를 대신 실행하면 사용자는 설명서를 외우지 않고도 각 명령이 무엇을 했고 다음에 무엇을 해야 하는지 알아야 한다.

동작 방식

  1. 평소 말로 요청하면 설치된 규칙과 다음 단계 안내가 AI를 packet, preflight, start, call, gates, review, fix, finish, land로 이끈다.
  2. 명령 표에는 init, doctor, packet, intent, preflight, start/renew/status/finish/release/log, recommend, models, call/wait, gates, check, wiki, impact, eval, graph, review, fix, land, rules, skills, hooks, ci가 있다.
  3. oah fix는 다다른 단계부터 다음 단계를 한 줄씩 출력한다. 순서대로 따른다.
  4. “리뷰 끝났어?”, “게이트 다 통과했어?”라고 묻고, 무엇이든 확인하기 전에 증거를 살핀다.

예제

다음 명령을 알려 주는 결과 줄(따라 하기 예제의 예시 리뷰 결과).

OAH_REVIEW_CHANGES_REQUESTED: R1 of task hello-name requested changes (P1×1). Correct them (oah fix --task hello-name runs Codex for that), commit, then run oah review --task hello-name again

요구 사항

  • 설치된 oah. 엔진 단계에는 Claude Code와 Codex가 필요하다.

한계와 복구

  • 종료 코드 2는 oah preflight의 ABORT 판정이기도 하다. [abort] 줄을 모두 고치고 다시 시도한다.
  • 75는 실행이 아직 진행 중인데 oah wait이 제한 시간에 닿았다는 뜻이다. oah wait <run-id>를 다시 실행한다.
  • oah eval은 정답을 숨긴 실제 사례를 다시 돌려 변형마다 결과와 한계를 보고한다.

원문 문서

관련 기능