---
name: github-analyze
description: GitHub 리포지토리·코드·커밋 히스토리·PR diff·브랜치 구조를 읽고 분석·요약·코드 리뷰(읽기)한다. 사용자가 레포 구조, 최근 변경, 특정 파일·모듈 설명, PR이 무엇을 바꿨는지, 의존성·보안 이슈를 읽기만으로 점검해 달라고 할 때 사용한다. Company X 내부 문서 근거(companyx-rag)와는 별개이며, 로컬에서 git push/commit을 실행하는 요청은 git-ops, GitHub 이슈·PR UI 조작은 github-manage이다.
---

# GitHub Analyze

GitHub API 또는 읽기 전용으로 확보한 메타데이터·소스 스냅샷을 바탕으로 LLM이 분석한다.

## 상위 원칙

- [Writing Principles](https://github.com/happybell80/0_VALUE/blob/main/20_Governance/writing-principles.md)
- [프로젝트 아티팩트 SSOT](https://github.com/happybell80/0_VALUE/blob/main/20_Governance/project-artifacts-ssot.md)

## Trigger

- 레포 설명·구조: "이 레포 뭐 하는 프로젝트야?", "디렉터리 구조 알려줘", "아키텍처 요약해줘"
- 히스토리·변경: "최근 커밋 뭐 올라왔어?", "이 PR 뭐 바꿨어?", "브랜치 상황 어때?"
- 코드 이해·리뷰(읽기): "이 파일 역할이 뭐야?", "이 패치 리뷰해줘", "잠재 버그 있어 보여?"
- 메타 분석: "주로 어떤 언어 쓰는지", "의존성 개요", "보안상 의심되는 지점 있어?" (읽기·분석만)

## Do

- 분석 목표(구조 / diff / 보안 / 성능 등)를 사용자 질문에 맞춘다.
- 근거로 파일 경로·커밋 해시·PR·이슈 번호·URL을 남긴다.
- 접근 불가·권한 부족이면 한계를 명시한다.

## Do Not

- 분석을 이유로 원격 저장소나 로컬 작업 트리에 쓰기 작업을 수행하지 않는다.
- companyx-rag(내부 문서)와 외부 GitHub 분석을 혼동해 답하지 않는다.

## 관련 스킬

- [github-manage](../github-manage/SKILL.md)
- [git-ops](../git-ops/SKILL.md)
- [Web Search](../web-search/SKILL.md)
