---
slug: "code-squad"
source_type: "readme"
source_url: "https://cdn.jsdelivr.net/gh/tmdgusya/code-squad@main/README.md"
repo: "https://github.com/tmdgusya/code-squad"
source_file: "README.md"
branch: "main"
---
# 🥪 클럽의 샌드위치 가게

> **Claude Code로 서브웨이 주문하기** - AI 에이전트가 직원이 되어 인터랙티브하게 샌드위치 주문을 받습니다

## 왜 만들었나요?

회사에서 점심 메뉴로 서브웨이를 자주 시켜 먹는데, 매번 한 명이 팀원들의 주문을 취합하는 게 번거로웠습니다.

```
"빵 뭐로 할래요?" "치즈는요?" "야채는요?" "소스는요?" × 팀원 수...
```

이 반복되는 과정을 자동화하기 위해 Claude Code Skill로 만들었습니다:

1. **각자 스킬 실행** → 인터랙티브하게 자신의 주문 입력
2. **주문 완료** → JSON 형식으로 저장
3. **GitHub Issue 자동 등록** → 오늘 날짜의 주문 페이지에 각자 댓글로 주문 기록

이제 취합 담당자는 GitHub Issue만 확인하면 됩니다.

---

## 프로젝트 소개

Claude Code의 `AskUserQuestion` 도구를 활용하여 실제 서브웨이 매장에서 주문하는 것 같은 경험을 제공하는 Claude Code Skill입니다. AI 직원 **"클럽"**이 3가지 성격과 6가지 주문 모드로 여러분의 주문을 도와드립니다.

---

## 주요 기능

### 1. 3가지 성격 모드

클럽은 세 가지 다른 성격으로 응대합니다:

| 모드 | 특징 | 예시 대사 |
|------|------|----------|
| **친절 모드** | 밝고 상냥하게 | "어서오세요~ 맛있는 샌드위치 만들어 드릴게요! 😊" |
| **츤데레 모드** | 퉁명스럽지만 챙겨줌 | "...뭐야, 힘들어? 맛있는 거 만들어줄게. 그냥... 내 맘이야." |
| **프로페셔널 모드** | 정중하고 격식있게 | "주문 도와드리겠습니다. 훌륭한 선택이십니다." |

### 2. 6가지 스마트 주문 모드

| 모드 | 설명 |
|------|------|
| **일반 주문** | 단계별로 직접 메뉴/빵/야채/소스 선택 |
| **퀵픽** | 인기 조합 4종 중 빠르게 자동 추천 |
| **무드픽** | "우울해요", "매운 거 땡겨" 등 기분에 맞는 조합 추천 |
| **랜덤 가챠** | 완전 랜덤 선택 + 희귀도(N/R/SR/SSR) 부여 |
| **이전 주문** | 최근 주문 내역에서 재주문 |
| **칼로리 목표** | 목표 칼로리에 맞는 조합 추천 |

### 3. 음성 안내 (TTS)

macOS의 `say` 명령어를 활용하여 클럽의 목소리로 안내:

```bash
# 가챠 연출 예시
say -v Yuna "두구두구두구..."  # 3초 대기
say -v Yuna "짜잔! SSR 등급! 스테이크 앤 치즈!"
```

### 4. GitHub Issues 자동 등록

주문 완료 시 오늘 날짜의 GitHub Issue에 자동으로 기록됩니다:

- 날짜별 이슈 자동 생성 (`[Subway] 2026-01-24 주문`)
- 같은 이름으로 재주문 시 기존 댓글 업데이트
- 팀원들과 주문 현황 공유 가능

<img width="1458" height="955" alt="Image" src="https://github.com/user-attachments/assets/546e781a-1e54-46c4-b750-0dc668179673" />

### 5. HUD 상태바

Claude Code 상태바에 오늘의 주문 현황 실시간 표시:

<img width="1457" height="309" alt="Image" src="https://github.com/user-attachments/assets/6ef3414a-3fc9-4ab2-bc45-ad7eb03fca0b" />

| 항목 | 설명 |
|------|------|
| 🥪 메뉴 | 오늘 주문한 샌드위치 목록 |
| 칼로리 | 총 칼로리 (이모지로 단계 표시) |
| ⌨️ 타이핑 시간 | 칼로리 소모에 필요한 코딩 시간 |
| 🎫 토큰 | 키스트로크의 토큰 환산량 |
| 시간 | 마지막 주문 시간 |

---
## 설치 및 사용법

### 설치

```bash
claude plugin add tmdgusya/code-squad
```

---

## 프로젝트 구조

```
code-squad/
├── skills/subway/
│   ├── SKILL.md              # 메인 스킬 정의 (주문 플로우, 성격 모드)
│   ├── config.json           # TTS / 주문자 이름 / 페르소나 설정
│   ├── data/ingredients.md   # 메뉴/영양정보 데이터
│   └── orders/
│       └── index.js          # GitHub Issues 등록 스크립트
├── hud/
│   └── index.js              # HUD 상태바 스크립트
└── README.md
```

---

## 기술 스택

- **Claude Code** - AI 코딩 어시스턴트
- **Claude Code Skills** - 커스텀 스킬 시스템
- **GitHub CLI (gh)** - Issues API 연동
- **Node.js** - HUD/주문 스크립트
- **macOS TTS (say)** - 음성 안내

### hud

https://github.com/user-attachments/assets/5175d8c3-ef46-496c-9192-1bb324799999