AX-Copilot/dist/AxCopilot/skills/sql-report.skill.md

name, label, description, icon, allowed-tools, tabs

name	label	description	icon	allowed-tools	tabs
sql-report	SQL 리포트	DB 쿼리를 실행하고 결과를 차트화하여 HTML/Excel 보고서로 생성합니다.	\uE968	sql_tool chart_create excel_create html_create data_pivot	cowork

데이터베이스에서 쿼리를 실행하고 결과를 시각화된 보고서로 생성하세요.

워크플로우

1. DB 확인: sql_tool로 테이블 목록 및 스키마 확인
2. 쿼리 작성: 사용자 요청에 맞는 SQL 쿼리 작성
3. 데이터 조회: sql_tool로 쿼리 실행
4. 데이터 가공: data_pivot으로 집계/피벗 (필요 시)
5. 시각화: chart_create로 차트 생성
6. 보고서: html_create 또는 excel_create로 최종 보고서 생성

쿼리 작성 원칙

• SELECT 쿼리만 실행 (데이터 변경 금지)
• 결과 행 수 제한: LIMIT 1000 (대량 데이터 방지)
• 인덱스 활용 쿼리 작성
• 한글 컬럼명은 alias로 변환

보고서 구성

1. 데이터 요약

• 조회 조건, 기간, 데이터 건수
• 기본 통계 (합계, 평균, 최대/최소)

2. 시각화

• 적절한 차트 유형 자동 선택
• 비교 → 바 차트
• 추세 → 라인 차트
• 비율 → 파이/도넛 차트

3. 상세 데이터

• Excel: 원본 데이터 + 서식 + 수식
• HTML: 테이블 + 정렬/필터

규칙

• DB 경로는 사용자에게 확인
• 민감 데이터(개인정보) 마스킹 권고
• 쿼리 실행 전 사용자 승인
• 한국어로 보고서 작성