플러그인 스킬
자연어 기능(skill) 8개 · 자동 라우팅 훅 · 안전장치 표
이 페이지는 axhub 플러그인의 기능(skill) 이름 · 라우팅 규칙 · 안전장치를 정확히 찾아볼 때 봐요. 플러그인은 Claude Code(터미널 · 데스크톱 앱) 안에서 한국어 · 영어 자연어를 axhub CLI 명령으로 바꿔 실행하는 얇은 라우팅 레이어예요 — 판정 · 실행 로직은 전부 ax-hub-cli(axhub 바이너리)에 있고, 플러그인은 의도를 알맞은 기능으로 연결하고 미리보기 · 확인 같은 안전 가드를 챙겨요. 현재 자연어 기능(skill) 8개와 자동 라우팅 훅으로 구성돼요. 설치 절차와 써 보는 법은 말로 시키기 가이드를 보세요.
플러그인이 요구하는 CLI 최소 버전은 v0.20.0이에요. CLI가 없거나 버전이 낮으면 스킬이 실행을 멈추고 설치 · 업그레이드를 먼저 안내해요.
기능(skill) 8개
자연어 발화가 기본 경로예요 — 정확한 이름을 외울 필요 없이 하려는 일을 그냥 말하면 알맞은 기능으로 연결돼요. 의도를 분명히 하고 싶을 땐 /axhub:<기능이름> 슬래시 명령으로 직접 부를 수도 있어요.
| 기능 | 하는 일 | 대표 발화 |
|---|---|---|
onboarding | 첫 온보딩 — CLI 설치 · 로그인 · git/node 점검 · GitHub App · MCP 연결까지 순서대로 안내 | "온보딩해줘", "처음인데", "셋업해줘" |
bootstrap | 빈 폴더에서 템플릿으로 새 앱 생성 — 앱 · 저장소 · 첫 배포까지 한 번에 | "axhub에 앱 만들고 싶어", "새 앱 만들어줘" |
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 같은 개별 슬래시 명령 세트와 품질 에이전트는 위 8개 기능으로 통합 · 대체됐어요. 지금은 스킬 이름 그대로의 슬래시(/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는 읽기 전용이라 진단 중에 상태를 바꾸지 않아요.