setup-omx

maestro:setup-omx

/mst:setup-omx는 Codex CLI 프로젝트에 oh-my-codex(OMX)를 설치하고 초기화합니다. 설치, 초기화, gitignore 등록, AGENTS.md 주입의 4단계를 순서대로 자동 실행합니다.

실행 프로토콜

{PLUGIN_ROOT} 경로 규칙: {PLUGIN_ROOT}는 이 스킬의 "Base directory"에서 skills/{스킬명}/을 제거한 절대경로입니다. 상대경로(.claude/...)는 절대 사용하지 않습니다.

MANDATORY Read: ~/.claude/user-profile.json (AskUserQuestion 컨텍스트, 비차단)

1. ~/.claude/user-profile.json을 Read한다.
   • 파일이 없으면 user_profile_context = null로 처리하고 기존 동작을 유지한다 (graceful fallback).
2. 파일이 있으면 JSON을 파싱하고 아래 필드만 사용한다.
   • role (string)
   • experience_level (string)
   • domain_knowledge (string[])
   • communication_style (string)
3. JSON 파싱 실패 또는 타입 불일치 시 warn만 출력하고 user_profile_context = null로 처리한다 (워크플로우 차단 금지).
4. 이후 AskUserQuestion과 사용자 설명 텍스트 작성 시:
   • communication_style을 최우선 반영한다.
   • experience_level/domain_knowledge에 맞춰 용어 수준과 설명 깊이를 조절한다.
   • 누락 필드는 추정하지 않고, 존재하는 필드만 참고한다.

Step 1: OMX 전역 설치

• --skip-install 옵션이 없으면: npm install -g oh-my-codex 실행
• --skip-install 옵션이 있으면: 이 단계를 건너뛰고 Step 2로 이동

Step 2: OMX 초기화

• --dir {path} 옵션이 있으면 해당 경로를 대상 디렉토리로 사용, 없으면 현재 디렉토리 사용
• 대상 디렉토리 존재 여부 확인, 없으면 에러 메시지 출력 후 중단
• omx setup && omx doctor 실행

Step 3: gitignore 처리

• {대상 디렉토리}/.gitignore 파일 확인
• 파일이 없으면: .omx 한 줄을 포함한 새 .gitignore 파일 생성 (멱등성: 이미 있으면 스킵)
• 파일이 있으면:
  • .omx 항목이 이미 존재하면: 스킵 (중복 방지)
  • .omx 항목이 없으면: 파일 끝에 .omx 추가

Step 4: AGENTS.md 주입

• {PLUGIN_ROOT}/AGENTS.md 파일 Read
  • 파일이 없으면: 에러 메시지 출력 후 중단
• {대상 디렉토리}/AGENTS.md 확인:
  • 있으면: "OMx 트리거 자동 분기 규칙" 구문 포함 여부 확인
    • 포함: 스킵 (중복 방지) — 사용자 확인 불필요, 즉시 완료 메시지 출력
    • 미포함: 사용자 확인 단계 진행 (아래)
  • 없으면: 사용자 확인 단계 진행 (아래)

사용자 확인 단계

AskUserQuestion으로 다음 내용을 표시하고 동의 여부 확인:

• 질문: "AGENTS.md 내용을 {대상 디렉토리}/AGENTS.md에 추가합니다. 계속하시겠습니까?"
• 옵션 1 (기본): "추가" — {PLUGIN_ROOT}/AGENTS.md 내용을 append (파일 없으면 신규 생성)
• 옵션 2: "건너뛰기" — 이 단계 스킵, 완료 메시지 출력

사용자가 "건너뛰기" 선택 시: Step 4 종료, 전체 완료 메시지 출력

옵션

• --dir {path}: 대상 프로젝트 디렉토리 지정 (기본: 현재 디렉토리). 상대경로는 현재 작업 디렉토리 기준으로 해석
• --skip-install: OMX 전역 설치(Step 1)를 건너뜀. OMX가 이미 설치된 경우 사용

예시

# 현재 디렉토리에 OMX 설정
/mst:setup-omx

# 특정 프로젝트 경로에 OMX 설정
/mst:setup-omx --dir ./my-codex-project

# 설치 단계 건너뛰고 초기화만
/mst:setup-omx --skip-install

# 특정 경로에 설치 단계 건너뛰고 설정
/mst:setup-omx --dir /path/to/project --skip-install

주의사항

• 멱등성: gitignore의 .omx 항목과 AGENTS.md 주입은 중복 방지 처리가 되어 있습니다. 스킬을 여러 번 실행해도 안전합니다.
• AGENTS.md 소스: {PLUGIN_ROOT}/AGENTS.md 파일에서 내용을 읽습니다. 이 파일이 존재하지 않으면 Step 4가 실패합니다.
• oh-my-codex: npm install -g oh-my-codex 설치를 위해 Node.js와 npm이 필요합니다.
• omx 명령어: Step 2 실행 전 OMX가 설치되어 있어야 합니다 (omx --version으로 확인).

문제 해결

• "omx: command not found" → --skip-install 없이 재실행 또는 npm install -g oh-my-codex
• "대상 디렉토리를 찾을 수 없음" → --dir 경로 확인 (상대경로는 cwd 기준)
• "AGENTS.md 소스 파일 없음" → {PLUGIN_ROOT}/AGENTS.md 확인; 플러그인 재설치