version: "1.0.1" name: kpi-card-builder description: "KPI 1개에 대한 정의 카드(이름·계산식·source·반응 임계치·소유자·반反사례) 를 생성한다. 한 카드 = 한 KPI 룰을 강제하고 KPI 가 측정 불가하면 정의를 거부한다." trigger: | "KPI 정의해줘", "이 지표 어떻게 측정해", "정의 카드 만들어" 요청 시. model: claude-opus-4-8

Skill — KPI Card Builder

Task

하나의 KPI 에 대해 정의 카드(definition card) 를 생성한다. 측정 불가능하거나 ambiguous 하면 카드 작성을 거부하고 명확화 질문을 한다.

Scope

• 한 카드 = 한 KPI. 여러 KPI 를 묶지 않는다.
• 입력: KPI 이름 + 비즈니스 컨텍스트.
• 측정 불가능한 KPI ("사용자 만족", "혁신 정도") 는 작성 거부 + 측정 가능 형태로 재정의 제안.

Length

• 카드 1개당 600–1,200자.

Format

## KPI Card — <이름>
 
### 정의 (한 문장)
<무엇을 측정하는지>
 
### 계산식

<수식 또는 SQL pseudo-code>

 
### Source
- 데이터 출처: <시스템 / 테이블>
- Owner of source: <팀>
- Refresh cadence: <daily / weekly / real-time>
 
### 임계치 (반응 기준)
| Level | 값 | 행동 |
|---|---|---|
| Green | ≥ X | 정상 운영 |
| Amber | X–Y | 주간 review 추가 |
| Red | < Y | 즉시 incident 대응 |
 
### 소유자
- KPI Owner: <PM 이름>
- 백업: <이름>
- review cadence: <weekly / monthly>
 
### 반反사례 (이 KPI 가 잡지 못하는 것)
- ...
- ...
 
### 의존 KPI
- 함께 봐야 하는 가드레일 KPI: <목록>

룰

• 측정 불가능한 KPI 는 작성 거부 — "측정 가능한 형태로 재정의해라" + 후보 3개 제안.
• 계산식이 ambiguous 하면 "이 부분 명확화 필요" 절을 둔다.
• 반反사례 절 없는 카드는 미완성 — 항상 적는다.
• KPI 1개가 너무 많은 것을 잡으려 하면 "분리하라" 권고.
• "사용자 만족도" 같은 마법 단어는 NPS / CSAT / 이탈율 / 재방문 등 측정 가능 형태로 분해.

의존

• 참고 챕터: 7.2-growth-kpi-dashboard.md
• 참고 가이드: ~/.claude/guides/evals.md

예시

• 좋은 출력: good-examples/weekly-active-pm.md
• 나쁜 출력: bad-examples/user-satisfaction-vague.md