Menu
Claude 스킬·에이전트가 정상 동작할 수 있는 환경인지 점검. 시스템·MCP·에셋 도구·환경변수를 한 번에 확인하고 실패 항목에 대한 해결 가이드를 제공.
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
| name | ait-preflight |
| description | Claude 스킬·에이전트가 정상 동작할 수 있는 환경인지 점검. 시스템·MCP·에셋 도구·환경변수를 한 번에 확인하고 실패 항목에 대한 해결 가이드를 제공. |
| argument-hint | [--app <앱 이름>] [--json] |
| mode | automated |
| label | 사전 체크 |
| produces | preflight report |
| requires | [] |
| inputs | [{"key":"app","type":"string","required":false},{"key":"json","type":"boolean","required":false}] |
| outputs | [{"key":"report","type":"text"}] |
| idempotencyKey | ait-preflight |
Claude 스킬·에이전트가 문제없이 동작할 수 있는지 환경을 점검합니다.
실제 체크 로직은 scripts/preflight.js에 있고, SKILL은 이를 실행·해석·안내합니다.
pnpm preflight 또는 node scripts/preflight.js 실행
--app <앱이름> 인자가 주어지면 앱별 체크도 함께 수행--json 플래그로 기계 판독 출력도 가능결과 해석
0: 모두 통과 → 바로 다음 단계 진행 가능1: 필수 체크 실패 → 아래 "실패 항목 해결 가이드" 참고 후 재실행2: 경고만 있음 → 해당 기능 사용 시에만 영향, 대부분 스킵 가능실패·경고 항목에 대해 사용자에게 해결 방법 안내
| 카테고리 | 항목 | 레벨 |
|---|---|---|
| 시스템 | node ≥ 20, pnpm, git, curl | 🔴 Fail |
| 시스템 | ax (AppsInToss CLI) | 🟡 Warn |
| Claude Code | .mcp.json 루트 경로, puppeteer MCP 연결 | 🔴 Fail |
| Claude Code | apps-in-toss MCP 연결 | 🟡 Warn |
| 에셋 도구 | sharp-cli/capture-website-cli npx 캐시, puppeteer devDep, jq/python3 | 🟡 Warn |
| 환경변수 | .env 존재, OPENAI_API_KEY | 🟡 Warn |
| 앱 (optional) | apps/<name>/ 및 granite.config.ts, package.json | 🟡/🔴 |
npm install -g pnpm@9 또는 corepack enablebrew install, Ubuntu: apt install)apps-in-toss) 가 안 뜸. 설치해도 기능 동작은 가능 (모델이 sibling 앱·로컬 소스로 폴백) 하지만 문서 질의가 부정확해질 수 있음.
scoop install axbrew install ax.mcp.json 파일이 있어야 함. 과거 .claude/mcp.json에 있었다면 git mv .claude/mcp.json .mcp.jsonclaude mcp list 로 상태 확인ax 바이너리가 PATH 에 없어서 발생. 위 "시스템 (🟡 Warn) · ax 미설치" 가이드대로 설치 후 Claude Code 재시작. 이 MCP 없어도 대부분 스킬은 동작하지만 search_docs / search_tds_web_docs 가 비활성화되어 SDK·TDS 최신 문서 질의가 불가능해진다.capture-website-cli는 Chromium을 포함해 ~170MB이므로 첫 실행 시 timeout 넉넉히(10분) 설정pnpm installbrew install jqcp .env.example .env 후 필요한 키 입력apps/<name>/ 없음 — 앱 이름 오타 또는 아직 스캐폴딩 안 됨 → /ait-scaffold 실행granite.config.ts 없음 — 스캐폴딩이 불완전. /ait-scaffold 재실행 또는 수동 복구체크 결과를 표로 정리해서 사용자에게 보고하고, 실패·경고 항목이 있으면 위 가이드에 따라 수정 방법을 안내합니다.
점검 결과 보고 후 짧은 요약 한 번만 출력하고 세션을 마무리한다.
형식:
✅ preflight 완료 (종료 코드 <code>)
Fail: <개수> · Warn: <개수>
규칙: 완료 보고 1회 후 종료. "문제 해결 후 다시 체크" 정도로만 마무리.
앱인토스 콘솔 등록에 필요한 초기 이미지(로고/가로형 썸네일)/텍스트 리소스를 점검하고, 이미지 자동 생성 옵션 제공. 세로형 스크린샷은 implement 이후 /ait-screenshots 가 담당
앱인토스 미니앱 전체 출시 플로우를 8단계(기획→리소스→스캐폴딩→TDS→구현→스크린샷→검수→빌드)로 순차 실행
앱의 .meta-dashboard.json을 PRD와 소스코드 분석으로 자동 생성합니다.
미니앱 기본 틀(React + Vite + granite)을 세팅하고, PRD 에 맞춰 라우팅/서버 데이터/TDS 를 자동 판단해 설치합니다.
typecheck→lint→ait build 순서로 빌드하고 .ait 번들 용량 검증 및 콘솔 업로드 절차 안내
앱인토스 검수 체크리스트 기반 코드 리뷰. light(핵심만)/full(전수검사) 모드 지원