로컬 경로 또는 GitHub URL의 프로젝트를 분석하여 _projects/ 에 MDX 콘텐츠를 작성합니다.
분석 대상: $ARGUMENTS
인자가 GitHub URL인지 로컬 경로인지 판별합니다.
다음 패턴 중 하나에 해당하면 GitHub URL로 간주:
https://github.com/<owner>/<repo>github.com/<owner>/<repo><owner>/<repo> (슬래시 1개, 로컬 경로에 해당하는 파일/디렉토리가 없는 경우)# /tmp 하위에 클론
REPO_DIR=$(mktemp -d /tmp/analyze-project-XXXXXX)
gh repo clone <owner>/<repo> "$REPO_DIR" -- --depth 1
$REPO_DIR을 이후 단계에서 프로젝트 경로로 사용<owner>/<repo> 추출하여 frontmatter의 github 필드에 자동 기입$REPO_DIR 삭제$ARGUMENTS를 그대로 프로젝트 경로로 사용이하 단계에서
$PROJECT_PATH는 위에서 결정된 실제 경로를 의미합니다.
결정된 프로젝트 경로를 전체적으로 탐색합니다.
# 디렉토리 구조 확인 (2단계 깊이)
ls -la $PROJECT_PATH
find $PROJECT_PATH -maxdepth 2 -type f | head -50
우선순위대로 읽기:
| 파일 | 확인 내용 |
|---|---|
package.json | 프로젝트명, 설명, 기술 스택, 스크립트 |
README.md | 프로젝트 소개, 기능 설명 |
tsconfig.json / jsconfig.json | 언어 설정 |
Dockerfile, docker-compose.yml | 배포 환경 |
.env.example | 환경 변수 구성 |
build.gradle, pom.xml | Java/Kotlin 프로젝트 |
requirements.txt, pyproject.toml | Python 프로젝트 |
go.mod | Go 프로젝트 |
# 주요 소스 디렉토리 파악
ls -la $PROJECT_PATH/src/ 2>/dev/null
ls -la $PROJECT_PATH/app/ 2>/dev/null
ls -la $PROJECT_PATH/lib/ 2>/dev/null
핵심 파일 탐색:
# 문서 파일 찾기
find $PROJECT_PATH -name "*.md" -maxdepth 3 | head -20
find $PROJECT_PATH/docs -type f 2>/dev/null | head -20
탐색한 내용을 기반으로 다음 항목을 정리합니다:
| 항목 | 설명 |
|---|---|
| 프로젝트명 | 공식 이름 |
| 한줄 소개 | 프로젝트 핵심 설명 (1문장) |
| 기술 스택 | 언어, 프레임워크, 라이브러리, DB 등 |
| 주요 기능 | 핵심 기능 3-5개 |
| 프로젝트 구조 | 디렉토리/모듈 구조 요약 |
| 기간 | 개발 기간 (커밋 이력 또는 문서 기반) |
| 항목 | 설명 |
|---|---|
| 아키텍처 | 전체 시스템 구조 |
| 담당 역할 | 본인 기여 부분 |
| 성과/결과 | 정량적 성과 |
| 트러블슈팅 | 해결한 주요 문제 |
| GitHub URL | 저장소 링크 |
| Demo URL | 배포 URL |
분석 결과를 요약하여 사용자에게 보여주고, 다음을 확인합니다:
_projects/<slug>.mdx 파일을 작성합니다.
---