Estimate

Estimate — 개발 견적서

젭마인 산출물 또는 프로젝트 분석 결과를 기반으로 비용 그룹별 견적서를 엑셀(.xlsx)로 생성하는 스킬.

Quick Start

/estimate                           # 프로젝트 자동 분석 + 견적서 생성
/estimate docs/plan/my-feature      # 특정 젭마인 산출물 기준
/estimate --template only           # 빈 견적서 양식만 생성

공식 호출명: /estimate (별칭: 견적, 견적서, 공수 산정)

파이프라인 위치

/zephermine → spec.md + sections/ + api-spec.md
                    ↓
              /estimate (견적서)
                    ↓
              estimate.xlsx

독립 실행 가능 — 젭마인 산출물 없이도 프로젝트를 직접 분석하여 생성 가능.

CRITICAL: First Actions

1. Print Intro

Estimate — 개발 견적서 생성
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
순서: Analyze → Ask → Calculate → Excel

2. Resolve Inputs

입력 소스를 결정합니다:

A. 젭마인 산출물이 있는 경우 (권장, archive/ 경로 제외):

• docs/plan/*/spec.md — 기능 요구사항
• docs/plan/*/sections/ — 섹션별 상세 스펙
• docs/plan/*/api-spec.md — API 엔드포인트
• docs/plan/*/db-schema.md — DB 구조

B. 없는 경우:

• 네이티브 위임이 가능하면 읽기 전용 탐색 역할에 기능, API, 데이터 모델, 외부 서비스 근거를 조사시킵니다. 이 역할은 파일을 수정하지 않고 file:line 근거와 기능 목록만 반환하며, 특정 커스텀 에이전트 이름을 요구하지 않습니다.
• 위임 기능이 없거나 실패하면 메인 컨텍스트에서 코드맵(있는 경우) → rg → 핵심 파일 읽기 순으로 같은 조사를 순차 수행합니다.
• 공수 계산, 사용자 확인, 엑셀 작성과 검증은 항상 메인 스킬 하네스가 담당합니다.
• 사용자에게 기능 목록 직접 질문

Phase 1: 기능 추출

젭마인 산출물에서 추출

spec.md → 기능 요구사항 목록 (FR-001, FR-002, ...)
sections/ → 섹션별 상세 기능 (프론트/백엔드 분리)
api-spec.md → API 엔드포인트 수
db-schema.md → 테이블/엔티티 수

기능별 복잡도 분류

각 기능을 복잡도로 분류합니다:

기본 공수는 참고값 — 사용자가 조정할 수 있습니다.

Phase 2: 비용 기준 확인

현재 CLI의 질문 방식으로 사용자에게 단가를 확인합니다:

question: "견적서 기본 단가를 설정해주세요"
header: "비용 기준"

확인 항목

사용자가 "기본값 사용"을 선택하면 위 기본값으로 진행.

Phase 3: 견적서 구조 생성

비용 그룹

1. 개발비
   ├── 1.1 프론트엔드 개발
   │   ├── 기능 A (보통) — 0.5MM
   │   ├── 기능 B (단순) — 0.3MM
   │   └── ...
   ├── 1.2 백엔드 개발
   │   ├── API 개발 — N개 엔드포인트
   │   ├── DB 설계/구현 — N개 테이블
   │   └── ...
   ├── 1.3 공통
   │   ├── 인증/권한 — 1.0MM
   │   ├── 초기 설정/환경 구성 — 0.3MM
   │   └── 배포 환경 구성 (Docker) — 0.3MM
   └── 소계

2. 인건비
   ├── 2.1 PM/기획 (개발비의 N%)
   ├── 2.2 디자인 (해당 시)
   ├── 2.3 QA/테스트 (개발비의 N%)
   └── 소계

3. 인프라 비용 (월간)
   ├── 3.1 클라우드 서버 (AWS/GCP/Azure 등)
   ├── 3.2 DB 서버/서비스
   ├── 3.3 스토리지 (S3 등)
   ├── 3.4 CDN
   └── 소계 (월)

4. 외부 서비스 비용 (월간)
   ├── 4.1 API 사용료 (PG결제, SMS, 이메일 등)
   ├── 4.2 SaaS 구독 (모니터링, 로깅 등)
   ├── 4.3 인증 서비스 (OAuth, SMS 인증 등)
   └── 소계 (월)

5. 기타 비용
   ├── 5.1 도메인 (연간)
   ├── 5.2 SSL 인증서 (연간, Let's Encrypt 무료 시 0)
   ├── 5.3 앱스토어 등록비 (해당 시)
   └── 소계

6. 요약
   ├── 개발비 합계 (1회)
   ├── 인건비 합계 (1회)
   ├── 월 운영비 합계 (3+4)
   ├── 기타 비용 합계
   ├── 예비비 (N%)
   ├── 부가세 (10%)
   └── 총 견적

Phase 4: 엑셀 파일 생성

Python openpyxl을 사용하여 .xlsx 파일을 생성합니다.

엑셀 구조

Sheet 1: 견적서 (Summary)

Sheet 2: 기능 상세 (Details)

Sheet 3: 월 운영비 (Monthly)

스타일링

from openpyxl import Workbook
from openpyxl.styles import Font, PatternFill, Alignment, Border, Side

# 헤더: 진한 파란 배경 + 흰색 글자
header_fill = PatternFill(start_color="1F4E79", end_color="1F4E79", fill_type="solid")
header_font = Font(color="FFFFFF", bold=True, size=11)

# 그룹 헤더: 연한 파란 배경
group_fill = PatternFill(start_color="D6E4F0", end_color="D6E4F0", fill_type="solid")
group_font = Font(bold=True, size=11)

# 소계/합계: 노란 배경
subtotal_fill = PatternFill(start_color="FFF2CC", end_color="FFF2CC", fill_type="solid")
total_fill = PatternFill(start_color="FFD966", end_color="FFD966", fill_type="solid")

# 금액: 우측 정렬 + 천 단위 콤마
number_format = '#,##0'

파일 생성

# openpyxl 설치 확인
pip install openpyxl 2>/dev/null || pip3 install openpyxl 2>/dev/null

# Python 헬퍼로 생성 + 실행
python scripts/estimate_builder.py

출력: docs/estimate/estimate-{project-name}-{YYYY-MM-DD}.xlsx

Phase 5: 완료 안내

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 견적서 생성 완료!

📁 산출물:
  docs/estimate/estimate-{project}-{date}.xlsx

📊 요약:
  개발비:     {금액}원 ({N}MM)
  인건비:     {금액}원
  월 운영비:  {금액}원/월
  기타:       {금액}원
  ─────────────────────
  총 견적:    {금액}원 (VAT 포함)

👉 다음 단계:
  엑셀 파일을 열어 단가/수량을 조정하세요.
  수식이 연결되어 있어 단가 변경 시 자동 재계산됩니다.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

옵션

예외사항

다음은 문제가 아닙니다:

1. 젭마인 산출물 없음 — 프로젝트를 직접 분석하거나 빈 양식 생성
2. openpyxl 미설치 — 자동 설치 시도, 실패 시 CSV로 폴백
3. 프론트엔드 없는 프로젝트 — 백엔드만 견적 (프론트 섹션 비움)
4. 클라우드 비용 불확실 — "예상" 표시 + 비고에 가정 명시

엑셀 수식 연결

단가나 수량을 수정하면 자동 재계산되도록 엑셀 수식을 연결합니다:

금액 = 수량 × 단가                    (각 항목)
소계 = SUM(해당 그룹 금액)            (그룹별)
예비비 = (개발비 + 인건비) × 버퍼%     (자동)
부가세 = (합계) × 10%                 (자동)
총 견적 = 합계 + 예비비 + 부가세       (자동)

사용자가 엑셀에서 단가만 바꾸면 총 견적이 자동으로 바뀝니다.

연관 스킬

Helper Scripts

이 스킬에는 재사용 가능한 헬퍼 스크립트가 포함되어 있습니다. Phase 4(엑셀 생성) 단계에서 반복되는 openpyxl 패턴을 함수로 제공합니다.

# 설치
pip install openpyxl

# 직접 실행 (샘플 견적서 생성)
python scripts/estimate_builder.py

주요 함수:

Related Files