sirius-zuo/skill-reviewer

skill-reviewer은(는) 무엇을 하나요?

다른 AI 에이전트 스킬을 검토하고 구조화된 HTML 보고서를 생성하는 포터블 AI 에이전트 스킬입니다. 로컬 디렉토리나 GitHub 저장소를 지정하면 모든 스킬을 발견하고, 13개 범주에 걸쳐 점수를 매기고, 위험을 식별하며, 우선순위가 지정된 권장 사항을 제공합니다.

기능

• 스킬 검색 - 로컬 디렉토리나 GitHub 저장소에서 모든 SKILL.md 파일을 재귀적으로 검색합니다.
• 13개 범주 평가 - 각 스킬을 다음 기준으로 평가합니다:
  • 설명 명확성
  • 보안 리스크
  • 호환성
  • 유지보수성
  • 문서화 완전성
  • 종속성 관리
  • 코드 품질
  • 테스트 적용 범위
  • 성능 영향
  • 확장성
  • 에러 처리
  • 사용성
  • 혁신성
• 위험 식별 - 보안 취약점, 누락된 구성, 비호환성 등 잠재적 문제를 탐지합니다.
• 우선순위가 지정된 권장 사항 - 심각도(높음/중간/낮음)별로 정렬된 개선 제안을 제공합니다.
• HTML 보고서 생성 - 검토 결과를 시각적으로 표현한 풍부한 HTML 파일을 생성합니다.

사용 방법

전제 조건

• AI 에이전트 (Claude Code, Cursor, Codex 등)
• 검토할 스킬이 포함된 로컬 디렉토리 또는 GitHub 저장소

기본 사용법

1. 에이전트에게 다음 명령을 실행하도록 지시하세요:

# 로컬 디렉토리 검토
review-skills --dir /path/to/skills

# GitHub 저장소 검토
review-skills --repo owner/repo-name

2. 에이전트가 review-report.html 파일을 생성합니다.
3. 브라우저에서 보고서를 열어 결과를 확인하세요.

고급 옵션

# 특정 스킬만 검토
review-skills --dir . --skill my-awesome-skill

# 출력 파일 이름 지정
review-skills --dir . --output my-report.html

# CI 모드 (비대화형, 종료 코드 반환)
review-skills --dir . --ci

보고서 이해하기

생성된 HTML 보고서는 다음 섹션으로 구성됩니다:

1. 요약 - 발견된 스킬 수 총계, 평균 점수, 총 위험 수
2. 스킬 카드 - 각 스킬에 대한 상세 점수 차트
3. 위험 목록 - 발견된 모든 위험을 심각도별로 정렬
4. 권장 사항 - 우선순위별 개선 제안

예제

다음은 기본 디렉토리 검토 실행 예시입니다:

> review-skills --dir ./my-skills

스킬 검토 중: my-skills/
-> 발견된 스킬: 3개
-> 스킬 "data-analyzer" 평가... 점수: 8.2/10
-> 스킬 "web-scraper" 평가... 점수: 6.5/10
-> 스킬 "email-bot" 평가... 점수: 9.1/10

위험: 2개 발견 (높음: 1, 중간: 1, 낮음: 0)
권장 사항: 4개
보고서 생성됨: my-skills/review-report.html

CI/CD 통합

GitHub Actions 워크플로우에 추가하여 품질 게이트를 유지하세요:

name: Skill Review
on: [push, pull_request]
jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      - name: Review Skills
        run: review-skills --dir . --ci

환경 변수

변수	설명	기본값
SKILL_REVIEWER_DIR	기본 검토 디렉토리	.
SKILL_REVIEWER_OUTPUT	출력 파일 경로	review-report.html
SKILL_REVIEWER_CI	CI 모드 활성화	false

지원

문제가 발생하면 GitHub Issues를 통해 보고해 주세요.

라이선스

MIT