플러그인 스킬
자연어 기능(skill) 10개 · 자동 라우팅 훅 · 안전장치 표
이 페이지는 axhub 플러그인의 기능(skill) 이름 · 라우팅 규칙 · 안전장치를 정확히 찾아볼 때 봐요.
플러그인은 Claude Code(터미널 · 데스크톱 앱)와 Codex CLI 안에서 한국어 · 영어 자연어를 axhub CLI 명령으로 바꿔 실행하는 얇은 라우팅 레이어예요. 판정 · 실행 로직은 전부 ax-hub-cli(axhub 바이너리)에 있고, 플러그인은 의도를 알맞은 기능으로 연결하고 미리보기 · 확인 같은 안전 가드를 챙겨요. 현재 자연어 기능(skill) 10개와 자동 라우팅 훅으로 구성돼요. 설치 절차와 써 보는 법은 말로 시키기 가이드를 보세요.
플러그인이 요구하는 CLI 최소 버전은 v0.20.0이에요. 일부 스킬은 더 높은 버전이 필요해요 — scaffold는 v0.30.0, plugins는 axhub plugin 명령이 생긴 v0.33.0 이상. CLI가 없거나 버전이 낮으면 스킬이 실행을 멈추고 설치 · 업그레이드를 먼저 안내해요.
기능(skill) 10개
자연어 발화가 기본 경로예요 — 정확한 이름을 외울 필요 없이 하려는 일을 그냥 말하면 알맞은 기능으로 연결돼요. 의도를 분명히 하고 싶을 땐 /axhub:<기능이름> 슬래시 명령으로 직접 부를 수도 있어요.
| 기능 | 하는 일 | 대표 발화 |
|---|---|---|
onboarding | 첫 온보딩 — CLI 설치 · 로그인 · git/node 점검 · GitHub App · MCP 연결까지 순서대로 안내 | "온보딩해줘", "처음인데", "셋업해줘" |
bootstrap | 빈 폴더에서 템플릿으로 새 앱 생성 — 앱 · 저장소 · 첫 배포까지 한 번에 | "axhub에 앱 만들고 싶어", "새 앱 만들어줘" |
scaffold | 템플릿으로 새 앱을 시작하되 저장소를 내 계정 · 조직 소유로 생성 — push 후 멈춰서 확인받고 import로 인계 | "내 계정에 레포 만들어서 시작", "회사 org에 저장소 파고 새 앱" |
plugins | 회사 마켓플레이스의 플러그인 앱 게시 · 목록 · 정확한 버전 다운로드 | "플러그인 목록 보여줘", "1.2.0 내려 받아", "여러 스킬을 하나로 올려줘" |
import | 기존 로컬 앱(비어 있지 않은 폴더)을 axhub에 연결하고 첫 배포까지 준비 | "이 폴더 axhub에 올려줘", "기존 앱 배포해줘" |
development | 이미 만든 axhub 앱에 기능 추가 · 수정 — 실데이터(connector · table) 화면, CRUD, UI · API 개선 | "todo 검색 추가해줘", "내 데이터로 대시보드 만들어줘" |
deploy | 연결된 앱의 현재 브랜치 재배포와 배포 상태 확인 — 미리보기 → 확인 → 실행 → 배포 기록 검증 | "배포해줘", "다시 올려줘" |
diagnosis | 실패한 배포의 원인을 읽기 전용으로 진단 — 재배포 · 롤백은 하지 않아요 | "왜 배포 실패했어?", "원인만 봐줘" |
clarity | 정확한 CLI 운영 명령 실행 — 로그 · 환경변수 · 롤백 · 테이블 · 커넥터 · GitHub 재연결 · 앱 삭제 | "axhub clarity로 로그 보여줘" 처럼 명시적으로 |
update | axhub CLI · 플러그인 버전 확인과 업데이트 적용 | "axhub 최신이야?", "업데이트해줘" |
이전 버전에 있던 /axhub:apps · /axhub:status · /axhub:logs 같은 개별 슬래시 명령 세트와 품질 에이전트는 위 스킬 세트로 통합 · 대체됐어요. 지금은 스킬 이름 그대로의 슬래시(/axhub:deploy 등)만 있어요.
자동 라우팅 훅
플러그인은 발화를 올바른 기능으로 보내기 위해 훅을 함께 설치해요. 사용자가 따로 조작할 건 없어요.
- 세션 시작 — 24시간에 한 번 CLI · 플러그인 업데이트 확인을 제안해요(
AXHUB_NO_AUTO_UPDATE로 끌 수 있어요). 온보딩 중 MCP 연결이 남아 있으면 이어가길 물어보고, Windows에서는 Git Bash 실행 계약을 안내해요. - 프롬프트 라우팅 — "최신 · 업데이트" 발화는
update가 먼저, 기존 앱을 가져오는 발화는import가 먼저, GitHub 재연결 · 디바이스 코드 발화는clarity의 인증 절차로, "상태 확인 · 이어서" 발화는 진행 중이던bootstrap·deploy흐름으로 연결돼요.
안전장치
- 되돌리기 어려운 작업(배포 · 삭제 등)은 먼저 무엇을 할지 미리보기로 보여주고 한 번 더 확인을 받아요. CLI 차원에서도 변경 명령은 dry-run이 기본이고
--execute를 붙여야 실행돼요. - 성공은 증거로 — 배포는 "명령이 끝났다"가 아니라 배포 기록 검증(
axhub deploy verify)으로 확인해요. - 비밀값(시크릿)은 화면 · 명령 기록에 노출되지 않게 입력받아요.
- 배포 · 복구 · 롤백은 어떤 앱 · 회사(tenant)인지 확인한 뒤 실행해요.
diagnosis는 읽기 전용이라 진단 중에 상태를 바꾸지 않아요.
Codex에서 쓰기
axhub는 Codex CLI 0.147.0 이상을 공식 지원해요. Claude 용 번들 대신 Codex 전용 파생 번들(axhub-codex)을 설치해요:
codex plugin marketplace add https://github.com/jocoding-ax-partners/axhubcodex plugin add axhub-codex@axhub스킬 10개는 Claude 판과 같고, 미리보기 · 확인 같은 안전장치도 동일하게 적용돼요. Codex라서 다른 점만 알아두면 돼요.
- 훅 신뢰를 한 번 물어요 — 설치 후 첫 대화에서 Codex가 플러그인 훅(세션 시작 4개 + 프롬프트 1개)을 신뢰할지 물어요. 신뢰하지 않으면 자동 업데이트 확인 · 업데이트 우선 라우팅 · 재시작 확인 · Windows 계약 안내만 조용히 꺼지고, 스킬은 훅 없이도 끝까지 동작해요. 업데이트는 "업데이트해줘" 한마디로
update스킬이 처리해요. - ChatGPT 데스크톱 앱에서도 돼요 — 데스크톱 앱의 Codex는 터미널과 같은 설정을 읽어서, 한 번 설치하면 두 곳 모두에서 스킬을 써요.
- 플러그인 업데이트 후엔 Codex를 재시작해야 새 버전이 반영돼요.
- 예전에 Claude 용 번들(
axhub@axhub)을 Codex에 설치했다면codex plugin remove axhub@axhub후axhub-codex@axhub로 다시 설치해요. 마켓플레이스를 이미 등록해 뒀다면codex plugin marketplace upgrade axhub로 카탈로그를 새로고침하면axhub-codex하나만 보여요. - 카탈로그에 스킬이 안 보이면(플러그인이 많아 설명이 축약될 때)
$axhub-codex:deploy처럼 명시 멘션으로 부르면 돼요. - AI 활용 기록(선택 수집) 옵트인은 Claude 판 전용이라, Codex 판은 이 설정을 만들거나 바꾸지 않아요.