Codex 플러그인 QA (codex-qa)
격리된 CODEX_HOME과 로컬 mock 모델로 omo Codex 플러그인의 훅·설치·TUI를 실제 API 호출 없이 검증하는 QA 스킬입니다.
개발·코딩고급★ 69,329⑂ 5,715AI 점수 7/10마지막 업데이트: 2026. 9. 23.
무엇을 해주나
packages/omo-codex(lazycodex) 플러그인을 실제codex app-server로 구동하되, 임시CODEX_HOME과 로컬 mock 모델을 써서 진짜 API 호출 없이 QA합니다.- 훅이 실제로 발동했는지를 로그 긁기가 아니라
hook/started/hook/completed알림 스트림으로 증명합니다. - 격리 홈에 로컬 빌드를 설치해
config.toml·컴포넌트 바이너리·에이전트 TOML이 제대로 배치됐는지 검증합니다. - 단일 컴포넌트 훅 로직을 결정론적으로 찍어보는 unit probe, tmux 기반 TUI 스모크, xterm.js 웹 터미널 시각 QA, RUST_LOG/SQLite 로그 관찰 경로를 안내합니다.
- 모든 실행 전후로 실제
~/.codex/config.toml해시를 비교해 사용자 환경이 오염되지 않았음을 보장합니다. - 결과는
.omo/evidence/<날짜>-<슬러그>/에 증거 파일로 남기도록 규칙화되어 있습니다.
이런 분께 추천
- oh-my-openagent 저장소에서
packages/omo-codex를 수정하는 기여자·메인테이너 - Codex 플러그인 훅/컴포넌트/인스톨러를 바꾼 뒤 회귀를 확인해야 하는 개발자
- "실제 환경을 건드리지 않는 격리 QA 하네스" 설계 패턴을 참고하고 싶은 분
활용 예시
- 훅 로직을 수정한 뒤
scripts/hook-unit-probe.sh --self-test로 stdout을 고정하고, 이어서scripts/app-server-drive.sh --plugin으로 라이브 배선을 증명. - 인스톨러/
config.toml을 건드린 뒤scripts/install-verify.sh --self-test로 격리 홈 설치 결과를 확인. - TUI 경로를 바꿨을 때
scripts/tui-smoke.sh --self-test로 부팅·렌더 생존을 확인하고, 시각 증거가 필요하면 웹 터미널 QA 스크립트로 PNG/ANSI 아티팩트 생성.
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/code-yeongyu/oh-my-openagent/HEAD/.agents/skills/codex-qa/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 code-yeongyu/oh-my-openagent 의 .agents/skills/codex-qa 폴더를 내 ~/.claude/skills/codex-qa/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/code-yeongyu/oh-my-openagent.git /tmp/oh-my-openagent && mkdir -p ~/.claude/skills && cp -r /tmp/oh-my-openagent/.agents/skills/codex-qa ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 저장소를 클론합니다:
git clone https://github.com/code-yeongyu/oh-my-openagent.git - 스킬 폴더를 Claude 스킬 경로로 복사합니다:
mkdir -p ~/.claude/skills && cp -r oh-my-openagent/.agents/skills/codex-qa ~/.claude/skills/ - 사전 도구를 설치합니다:
codex(0.140.0 이상 권장),node,jq,tmux,bun. - 버전을 확인합니다:
codex --version - 스킬 폴더로 이동해 하네스를 점검합니다:
cd ~/.claude/skills/codex-qa && bash scripts/lib/common.sh --self-check - 실제 QA는 oh-my-openagent 저장소 루트에서 수행해야 하므로, 해당 레포를 함께 체크아웃해 두세요.
- Claude Code를 재시작하고 "codex qa" 또는 "verify codex hook" 같은 문구로 호출합니다.
GitHub에서 원본 보기 ↗라이선스: NOASSERTION