software

CodePoet: Git 히스토리를 서사시로 변환하기 with GitHub Copilot CLI 🎭

발행: (2026년 2월 15일 오전 10:07 GMT+9)
9 분 소요
원문: Dev.to

Source: Dev.to

위에 제공된 링크에 포함된 전체 텍스트를 알려주시면, 해당 내용을 한국어로 번역해 드리겠습니다.
(코드 블록, URL 및 마크다운 형식은 그대로 유지하고, 본문만 번역합니다.)

내가 만든 것

CodePoet 🎭 – GitHub Copilot CLI를 활용해 코드를 시, 서사시, 전설적인 이야기로 변환하는 즐거운 창의적 CLI 도구입니다.

git 히스토리를 보면서 “이걸 좀 더 드라마틱하게 만들 수 있지 않을까?” 라고 생각해 본 적 있나요? CodePoet는 지루한 커밋 로그를 서사 판타지 사가로 바꾸고, 코드 파일을 아름다운 하이쿠로 변환하며, 팀이 실제로 기억할 수 있는 시적인 커밋 메시지를 생성합니다.

단순한 재미있는 실험이 아니라, 회고에 즐거움을 주고, 팀이 공유할 수 있는 콘텐츠를 만들며, 프로젝트 마일스톤을 축하하는 것을 진정으로 재미있게 만드는 도구입니다.

주요 기능

  • 📜 Epic Sagas – 당신의 git 기록이 영웅, 전투, 그리고 영광스러운 승리의 전설적인 이야기가 됩니다.
  • 🌸 Code Haiku – 모든 코드 파일이 우아한 5‑7‑5 음절 시가 될 수 있습니다.
  • 🎭 Poetic Commits – 커밋 메시지를 하이쿠, 라임리크, 혹은 셰익스피어식 구절로 생성합니다.
  • ⚔️ Developer Stats – 당신의 코딩 여정을 업적과 레벨이 표시된 RPG 캐릭터 시트로 확인하세요.

Tech Stack

  • TypeScript – 견고하고 타입‑안전한 코드.
  • Commander.js – CLI 파싱.
  • Simple‑git – 저장소 분석.
  • Chalk & Ora – 아름다운 터미널 출력.
  • GitHub Copilot CLI – AI‑기반 창의적 생성.

데모

데모 1

데모 2

데모 3

데모 4

데모 5

설치

git clone https://github.com/pealmasa/codepoet.git
cd codepoet
npm install
npm run build
npm link

에픽 사가 명령

당신의 git 히스토리를 서사시로 변환하세요:

codepoet saga

예시 출력

🎭 THE SAGA OF CODEPOET 📜
═══════════════════════════════════════════════════════

In the ancient realm of TypeScript, a brave developer 
embarked upon a legendary quest...

Chapter I: The Initialization
  The hero forged the sacred package.json, binding the 
  project's fate to the Node.js kingdom...

Chapter II: The Battle of Dependencies
  Armed with Commander, Chalk, and the mystical Simple‑git,
  our champion assembled a fellowship of libraries...

Chapter III: The Refactoring Trials
  Through treacherous bugs and tortuous logic, the hero
  persevered, transforming chaos into elegant beauty...

코드 하이쿠

어떤 파일이든 시로 바꿔보세요:

codepoet haiku src/index.ts

예시 출력

Commands await here,
Through typed paths they guide the way,
Poetry takes flight.

시적인 커밋

git add .
codepoet commit --style limerick

예시 출력

There once was a bug in the code,
That caused the whole system to load,
  Fixed it with grace,
  In just one place,
Now smoothly the data has flowed!

개발자 통계

codepoet stats

예시 출력

╔════════════════════════════════════╗
║      DEVELOPER CHARACTER SHEET      ║
╚════════════════════════════════════╝

Name: Pedro Marques Santos
Class: TypeScript Wizard
Level: 42

Stats:
⚔️  STR (Code Quality): 85/100
🛡️  DEF (Bug Fixes): 92/100
✨  INT (Features): 88/100
🏃  AGI (Commits): 156 commits

Achievements Unlocked:
🏆 First Commit
🔥 Bug Slayer (10+ fixes)
⭐ Feature Forger
📜 Documentation Hero

GitHub Copilot CLI와 함께한 나의 경험

CodePoet를 만드는 여정은 창의적인 AI 애플리케이션을 탐구하는 환상적인 여정이었으며, GitHub Copilot CLI가 없었다면 이 작업은 불가능했을 것입니다.

Copilot CLI를 사용한 방법

(간략히 생략 – 개인적인 통찰과 사용한 프롬프트 예시를 추가하면 됩니다)

1. 핵심 창작 엔진

CodePoet의 핵심은 GitHub Copilot CLI의 gh copilot suggest 명령을 감싸는 CopilotService 클래스입니다. 코드를 자동 완성하는 용도가 아니라 창의적인 텍스트 생성 엔진으로 활용합니다:

async ask(prompt: string, options: CopilotOptions = {}): Promise {
  const command = `gh copilot suggest "${fullPrompt}"`;
  const { stdout } = await execAsync(command);
  return this.cleanCopilotOutput(stdout);
}

2. 상황 인식 시 Poetry 생성

Copilot CLI에 풍부한 컨텍스트를 제공하는 구체적인 프롬프트를 만들었습니다.

  • Epic Sagas용 – git 히스토리를 제공하고 다음을 요청합니다:
  • 커밋을 영웅적인 행위로 변환
  • 버그 수정을 어둠과의 전투로 전환
  • 기능을 전설적인 유물로 만들기
  • 머지를 왕국 간 동맹으로 변환
  • Code Haiku용 – 실제 코드를 제공하고 다음을 요청합니다:
  • 전통적인 5‑7‑5 음절 구조
  • 코드가 수행하는 핵심을 포착
  • 기술적으로 정확하면서도 시적 아름다움을 유지

3. 다양한 창작 스타일

스타일 지시문은 Copilot의 창작 방향을 안내합니다:

getStyleInstructions(style: string): string {
  const styles = {
    epic:        'Write in dramatic, fantasy‑epic style with grand language',
    haiku:       'Create traditional Japanese haiku with exactly 5‑7‑5 syllables',
    limerick:    'Write a funny limerick with AABBA rhyme scheme',
    shakespearean: 'Write in Shakespearean style with iambic pentameter'
  };
  return styles[style];
}

개발에 미친 영향

AspectBenefit
Speed전체 LLM API(OpenAI, Anthropic 등)를 통합할 필요가 없습니다; Copilot CLI는 즉시, 상황 인식 AI를 제공하며 설정이 전혀 필요 없습니다.
Quality출력이 일관되게 우수합니다. Copilot은 코딩 컨텍스트 와 자연어 생성 모두를 이해하기 때문입니다.
Iteration프롬프트 스타일을 빠르게 프로토타이핑하고 즉시 결과를 확인할 수 있어 피드백 루프가 짧습니다.
Developer Experiencegh copilot suggest는 이미 Copilot 사용자에게 익숙하므로 CodePoet는 자연스러운 워크플로 확장처럼 느껴집니다.

왜 중요한가

CodePoet는 GitHub Copilot CLI가 단순히 셸 명령을 제안하는 도구가 아니라, 풍부한 컨텍스트를 활용해 자연어 콘텐츠를 생성하고, 기술 개념을 창의적으로 번역하며, 설정이 거의 필요 없는 일관된 고품질 출력을 제공하는 강력한 창작 AI 도구임을 보여줍니다.

이는 다양한 창의적인 CLI 도구의 가능성을 열어줍니다: 커밋 메시지 생성기, 코드 문서 시인, PR 설명 작성기 등!

Copilot CLI와 함께할 미래 아이디어

  • 코드 리뷰를 영화 리뷰처럼 – “리팩토링의 걸작! ⭐⭐⭐⭐⭐”
  • PR 설명을 서사시처럼 – diff를 모험 이야기로 변환
  • 릴리즈 노트를 노래 가사로 – “🎵 Version 2.0, here we go! 🎵”
  • 아키텍처 문서를 판타지 지도처럼 – “마이크로서비스의 땅 …”

직접 해보세요!

복제 및 설치

git clone https://github.com/pealmasa/codepoet.git
cd codepoet
npm install
npm run build
npm link

어떤 git 저장소에서도 서사시를 생성하세요:

cd your-project
codepoet saga

소셜 미디어에서 #CodePoet 으로 여러분이 좋아하는 결과물을 공유하세요!

저장소

🔗 GitHub:
📖 Quick‑Start Guide:

“최고의 코드는 이야기를 들려줍니다. CodePoet는 그것을 서사적으로 전달합니다!” 🎭📜✨

0 조회
#software #programming #community
원문 보기
Share:
Back to Blog

관련 글

더 보기 »