| name | source-adapter-github |
| description | GitHub 레포의 README.md(+ 선택적 docs/, package.json)를 분석해 개발자 브랜딩용 카드뉴스 8장 시리즈로 정규화한다. 문제 정의-기능-코드 스니펫-CTA 구조. 코드블록은 code-card 템플릿으로 자동 분기. 사용자가 GitHub 프로젝트를 카드뉴스로 홍보하려 할 때 사용. |
GitHub 레포 → card_script.json 어댑터
오픈소스/사이드프로젝트 README 를 Instagram 카루셀로 변환. 코드 데모를 포함해 "이걸 써보고 싶다" 유도.
입력
workspace/<slug>/source/README.md (필수)workspace/<slug>/source/package.json 또는 pyproject.toml (선택 — 언어·버전 힌트)workspace/<slug>/source/docs/** (선택 — 추가 문서)
처리 단계
1. 메타 추출
- 레포명:
package.json.name 또는 pyproject.toml.project.name 또는 README 의 H1
- 한줄 설명:
package.json.description 또는 README 첫 문단
- 주 언어:
package.json 존재 → JS/TS, pyproject.toml → Python, 아니면 README 의 첫 ```lang 태그
- 설치·사용 예시 코드블록 추출
2. 카드 배치 (8장 기본, github 매트릭스)
| n | role | template | 내용 |
|---|
| 1 | hook | photo-overlay | Question 패턴 — "이 문제 아직도 N분씩 걸리나요?" 스타일 |
| 2 | body | typo-minimal | 해결하는 문제 한 줄 |
| 3 | code | code-card | 설치 명령 (npm/pip 한 줄) |
| 4 | body | typo-minimal | 핵심 기능 1개 (강조) |
| 5 | code | code-card | 사용 예시 (5~8줄) |
| 6 | body | typo-minimal | 추가 기능·차별점 |
| 7 | step | typo-minimal | 다음 단계 로드맵 또는 3줄 요약 |
| 8 | cta | typo-minimal | "GitHub ⭐ 누르기 + 프로필 링크" |
코드블록이 3개 이상이면 code 카드를 최대 3개까지 확장(8→10장으로). 1개면 Card 3 하나만.
3. code_snippet 채우기 (code 카드)
{
"lang": "python" | "javascript" | "typescript" | "bash" | "json",
"text": "원문 코드 (최대 8줄, 80자/줄 이내로 자동 래핑)",
"caption": "INSTALL" | "USAGE" | "EXAMPLE" | "API"
}
8줄 초과면 가장 중요한 블록만 선별(함수 정의 1개). 한 줄이 80자 초과면 줄바꿈 시도, 불가능하면 경고.
4. 이미지 프롬프트 (Card 1 만)
개발자 톤 스타일:
"isometric illustration of {domain} concept, dark cyan palette, minimal tech aesthetic, neon accent"- 예: FlowGenie →
"isometric illustration of parallel image processing pipelines, dark cyan palette, minimal tech aesthetic, neon accent"
5. 캡션·해시태그
caption: 한줄 설명 + 링크 (github.com/user/repo) + "스타 ⭐ 주시면 힘이 됩니다"hashtags: ["#개발자", "#오픈소스", "#GitHub", "#Python" or "#JavaScript", "#AI" or "#자동화", "#개인프로젝트"] 범위에서 6~8개
6. 팔레트
- source_type="github" 기본 프리셋
dark-cyan
편집 포인트 안내
- 코드블록이 없으면 Card 3·5 는 body 로 폴백하고 경고
- README 가 300자 미만이면 카드뉴스로 확장할 내용 부족 경고
- 언어 감지 실패 시
code_snippet.lang 을 bash 로 폴백하고 사용자 확인 요청
실패 조건
README.md 파일 없음 → 중단README 에 H1·내용 모두 없음 → series_title 을 package.json.name 으로 폴백, 전체 경고
