mp — 세션 핸드오프 프롬프트 생성기

Multi-target session handoff prompt generator for Claude Code, Codex CLI, and Gemini CLI.

현재 세션의 작업 맥락을 분석하여, 다음 세션에서 이어서 작업할 수 있는 구조화된 프롬프트 파일을 생성하는 Claude Code 스킬입니다.

주요 기능 (v2)

• Gemini stdin 파이프: Gemini CLI 프롬프트 전달 시 stdin 파이프 사용으로 OS ARG_MAX 제한 해결
• 보안 & 토큰 관리: API 키/토큰 자동 마스킹(Secret redaction) 및 3단계 토큰 예산(Budget) 제어
• 강건한 환경 감지: Git 2단계 감지(detached HEAD, merge conflict, submodule 등), 빈 세션 처리, Non-Git 신뢰도 표시
• 세션 체이닝: 장기 작업을 위한 체인 ID 기반 세그먼트 관리 및 이전 변경 사항 자동 누적
• 구조화된 출력: Markdown 및 JSON Sidecar 동시 생성, 의존성 그래프 및 Preflight 점검 목록 포함
• OS 호환성: bash/pwsh/cmd 지원 및 HHmm suffix로 파일명 충돌 방지, 저장 실패 시 stdout fallback

설치

npm (권장)

npx claude-code-make-prompt

Git clone

git clone https://github.com/tellang/claude-code-make-prompt.git ~/.claude/skills/mp

제거

npx claude-code-make-prompt uninstall

사용법

/mp                                    # 범용 핸드오프
/mp x 인증 모듈 리팩터링 중             # Codex용
/mp g full 로그인 UI 개선 중            # Gemini용 (full budget)
/mp c short 테스트 커버리지 확대 중     # Claude용 (short budget)
/mp x chain:auth-refactor 3번째 세션   # 세션 체이닝

모드별 특징

| 모드 | 인자 | 생성 주체 | 프롬프트 특성 | |------|------|----------|-------------| | generic | (없음) | 자동 라우팅 (Gemini → Codex → Claude) | 범용 마크다운, evidence/preflight 포함 | | codex | x | Codex (cli-route.sh executor, 360s) | 명령형 문체, MCP 힌트, dependency graph | | gemini | g | Gemini (cli-route.sh designer, Pro 3.1, 300s) | 문서/UI 맥락, 디자인 컨텍스트 강조 | | claude | c | Claude (직접 생성) | Glob/Grep 힌트, 테스트 커맨드, 탐색 경로 |

generic 자동 라우팅: /mp (인자 없음) 실행 시 Gemini Pro 3.1로 먼저 시도하고, 실패 시 Codex로 fallback, Codex도 실패 시 Claude가 직접 생성합니다. Codex/Gemini 모드는 cli-route.sh를 통해 외부 CLI에 프롬프트 생성을 위임하여 Claude 토큰을 절약합니다.

토큰 예산 (Token Budget)

프롬프트 길이를 제어하여 토큰 사용량을 최적화합니다.

| 예산 | 인자 | 최대 길이 | 용도 | |------|------|----------|------| | short | short | ~2000자 | 빠른 핸드오프, 요약 위주 | | standard | (기본) | ~5000자 | 일반적인 개발 작업 | | full | full | ~10000자 | 복잡한 리팩터링이나 상세한 맥락 필요 시 |

세션 체이닝 (Session Chaining)

장기 작업을 여러 세션에 걸쳐 추적하고 관리할 수 있습니다.

• chain_id로 그룹화하고 segment로 순서를 관리합니다.
• .claude/handoffs/chains/{chain_id}/에 세그먼트별로 저장됩니다.
• 이전 세그먼트의 결정과 변경 사항을 자동으로 누적하여 참조합니다.

출력

Markdown 파일과 함께 후처리/대시보드 연동을 위한 JSON 파일이 생성됩니다.

.claude/handoffs/{YYYY-MM-DD}-{HHmm}-{mode}-{설명}.md     # 프롬프트 본문
.claude/handoffs/{YYYY-MM-DD}-{HHmm}-{mode}-{설명}.json   # JSON sidecar (메타데이터)
.claude/handoffs/chains/{chain_id}/{segment:03d}-{YYYY-MM-DD}-{HHmm}-{mode}-{설명}.md   # 체인 모드
.claude/handoffs/chains/{chain_id}/{segment:03d}-{YYYY-MM-DD}-{HHmm}-{mode}-{설명}.json # 체인 sidecar

아키텍처

수집(Claude) → 정규화(canonical_state) → 생성(대상 CLI 위임) → 저장의 4-Phase 파이프라인:

1. Phase 0: Git 환경 2단계 감지 (branch, state, conflicts, submodules)
2. Phase 1: 정보 수집 (git diff/log, 프로젝트 컨텍스트, 사용자 확인)
3. Phase 1.5: 보안 필터링 (API 키/토큰/시크릿 자동 마스킹)
4. Phase 2: 프롬프트 생성 — canonical_state를 직렬화하여 대상 CLI에 위임
5. Phase 3: .md + .json sidecar 저장 (실패 시 stdout fallback)
6. Phase 4: 모드/OS별 사용법 안내 (bash/pwsh/cmd)

canonical_state는 project, session, next, meta 4개 섹션으로 구성된 내부 데이터 모델로, 모든 모드에서 공통 사용됩니다.

환경 지원

• Git 프로젝트: Git 2단계 감지를 통해 detached HEAD, merge conflict, rebase, 서브모듈 등 엣지 케이스를 자동 처리합니다.
• Non-Git: 정보별로 (확인됨/추정) 태그를 부여하여 데이터 신뢰도를 표시합니다.
• 빈 세션 처리: 변경 사항이 없는 경우 현재 프로젝트 현황과 함께 다음 작업 제안을 포함합니다.

의존성

• ~/.claude/scripts/cli-route.sh — CLI 라우팅 래퍼 (codex/gemini 모드 사용 시 필수)
• Codex CLI: npm install -g @openai/codex (codex 모드 또는 generic fallback)
• Gemini CLI: npm install -g @google/gemini-cli (gemini 모드 또는 generic 1차 시도)

라이선스

MIT

Disclaimer

This is an unofficial community tool, not affiliated with Anthropic.