Menu
고객사별 특성, 설정 차이, Pain Point, 히스토리를 관리합니다. 고객사당 하나의 파일.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
지정 디렉터리의 문서를 심층 분석하여 지식을 추출하고, 기존 문서 갱신 + 신규 문서 생성으로 프로젝트 지식 베이스에 반영합니다.
기술 의사결정 기록 (Architecture Decision Record). 중요한 기술적 결정의 맥락, 대안, 근거를 구조화하여 기록합니다.
현재 디렉터리의 내용을 분석하여 어떤 목적의 폴더인지 파악
슬랙/메일/메신저로 받은 업무 요청 메시지를 분석하여 의도, 핵심 내용, 판단, 액션 플랜, 대응 가이드를 정리합니다.
비즈니스 규칙, 도메인 규칙, 상태 전이 규칙을 하나의 문서로 관리합니다. 변경 이력이 누적됩니다.
열린 질문, 문제 해결, 기술 의사결정, 아이디어 발산을 구조화합니다. 회의록이나 메모 파일 경로를 인자로 전달하거나 직접 질문하세요.
| name | customer-profile |
| description | 고객사별 특성, 설정 차이, Pain Point, 히스토리를 관리합니다. 고객사당 하나의 파일. |
| when_to_use | 고객사 정보 기록, 이 고객사 특성 정리, 고객사 히스토리. 사람은 people, 장애 대응은 cs. |
| allowed-tools | Read, Write, Glob, Grep, Bash |
각 고객사의 특성, 설정 차이, Pain Point, CS 히스토리, 커스터마이징 내역을 고객사별 파일로 관리.
이 정보는 다른 스킬들이 참조:
/cs: 고객사별 빈출 문제, 설정 차이 확인/prd: 고객 요청의 배경과 맥락 파악/poc: 데모 대상 고객의 관심사/기대 수준 파악/review: 고객사별 프로파일 설정이 영향 주는지 확인/daily: 도메인/비즈니스 인사이트에서 고객 패턴 분석| 데이터 | 경로 | 필수/선택 | 부재 시 동작 |
|---|---|---|---|
| 프로젝트 컨텍스트 | CLAUDE.md | 선택 | 일반 SW 가정으로 진행, [프로젝트 규칙 미확인] 태그 |
| 봇 인덱스 | bot/INDEX.md 또는 .local.claude/ONBOARDING.md | 선택 | 디렉터리 Glob 으로 fallback |
| 비즈니스 규칙 | .local.claude/biz-rules.md | 선택 | Tier 1(도메인 무관) 점검만 수행 |
| 모듈 상세 | .local.claude/modules/{name}.md | 선택 | 코드 Grep 직접 fallback |
| 환경 설정 파일 | application-*_{customer}.yml 등 | 선택 | 환경 분기 키 자동 추출 불가. 사용자에게 질문 |
| CS/미팅 이력 | .local.claude/cs/, .local.claude/meetings/ | 선택 | 자동 연결 생략, 수동 링크 권장 |
기본: 고객사당 하나 .local.claude/customers/{고객사명}.md.
분량 임계에 따른 자동 분리 (대형 고객사):
| 임계 | 동작 |
|---|---|
| ≤300줄 | 단일 파일 유지 |
| 301~500줄 | "곧 분리 권장" 알림 + 사용자 결정 |
| >500줄 | 분리 강제. 디렉터리 패턴으로 전환 customers/{고객사명}/ |
분리 시 디렉터리 구조:
customers/{고객사명}/
├── README.md # 핵심 (기본 정보, Pain Point, 현재 상태) ≤200줄
├── cs-history.md # CS/장애 히스토리 (가장 빠르게 누적)
├── customization.md # 커스터마이징 내역 상세
└── meetings.md # 미팅/소통 히스토리
기존 단일 파일은 README.md 로 이전 + 섹션별 분리. 다른 스킬의 참조 경로 (customers/{고객사명}.md) 는 README.md 자동 fallback (Glob 으로 둘 다 매치).
# {고객사명} 프로필
> 마지막 업데이트: YYYY-MM-DD
> `/customer-profile` 스킬로 관리됩니다.
## 기본 정보
| 항목 | 내용 |
|------|------|
| 고객사명 | |
| 업종 | (예: 제조, 방산, 전기장비, 유통 등) |
| 사용 모듈 | (프로젝트 모듈명) |
| 환경 분기 키 | (예: `dev_{고객키}`, `prod_{고객키}`) |
| 주요 담당자 | (이름, 역할) |
| 계약 형태 | (SaaS / 온프레미스 / 하이브리드) |
## 비즈니스 특성
이 고객사의 비즈니스 프로세스 특징, 우리 제품을 어떻게 쓰는지.
- 주력 제품/사업 분야
- 사용 패턴 특성 (예: 거래 빈도, 사용자 규모, 사용 강도, 산업별 특수성 등)
- 핵심 업무 흐름
## Pain Point & 관심사
이 고객사가 가장 민감하게 반응하는 영역.
| 영역 | 내용 | 근거 |
(예: 특정 영역에 민감, 위반 시 페널티 (예: SLA, 데드라인 등))
## 커스터마이징 내역
표준 기능 대비 이 고객사만의 설정/코드 차이.
| 기능 | 표준 | 커스터마이징 | 비고 |
(예: 알림 일수 | D-3, D-5 | D-7도 추가 | 2026-04 요청)
## CS/장애 히스토리
| 날짜 | 증상 | 원인 | 해결 | CS 파일 |
과거 CS 분석 파일 경로 링크. `/cs` 스킬로 분석한 결과를 여기에 축적.
## 미팅/소통 히스토리
| 날짜 | 참석자 | 핵심 내용 | 회의록 |
과거 회의록 파일 경로 링크. `/meeting-notes` 결과를 여기에 축적.
## 요청 사항 추적
| 날짜 | 요청 | 상태 | PRD/이슈 |
고객이 요청한 것과 현재 상태 (검토중/개발중/완료/보류).
## 변경 이력
| 날짜 | 변경 내용 |
ls .local.claude/customers/ 2>/dev/null
$ARGUMENTS 분석입력 예시:
/customer-profile {고객사} - 특정 알림 기능 추가 요청함
/customer-profile {고객사} - 오늘 CS: 프로젝트 목록 안 보임, 격리/테넌트 이슈
/customer-profile {새 고객사} - 새 고객사, {업종}, {모듈} 도입 예정
/customer-profile {고객사} - {신규 사업부}도 도입 검토 중이라는 시그널
[1M 활용] 다음을 단일 메시지에서 병렬 호출:
- Glob:
**/application-*.yml,**/application-*.properties,**/config/*_{customer}.yml- Grep (병렬):
{고객사키워드}를 각 설정 파일 패턴에서 동시 검색- Read:
CLAUDE.md의 "고객사 분기" 섹션 +.local.claude/biz-rules.md의 테넌트/격리 키 정의 섹션
# 프로젝트 환경 설정 파일에서 고객사 키워드 검색
grep -rl "{고객사키워드}" {프로젝트 환경 설정 디렉터리} 2>/dev/null
가능한 정보를 코드베이스에서 수집하여 초기 프로필 생성. 모르는 항목은 비워두고, 사용자가 점진적으로 채움.
입력 내용을 분석하여 해당 섹션에 추가:
다른 스킬에서 고객사 관련 파일이 생성되면, 이 프로필에 링크를 추가하라고 안내:
/cs로 CS 분석 후: "이 결과를 /customer-profile {고객사}로 히스토리에 추가하세요"/meeting-notes로 고객 미팅 기록 후: "이 회의록을 /customer-profile {고객사}로 연결하세요"Frontmatter (CONTRACT 7-2절 표준): category: customers, retention: permanent
.local.claude/customers/{고객사명}.mdmkdir -p로 생성| 질문 | 담당 | 이 스킬에서 |
|---|---|---|
| 고객사별 특성, 설정 차이, 이력을 누적 관리 | 이 스킬 | 핵심. 고객사 프로필 SSOT |
| 특정 CS/장애의 코드 원인 추적과 대응 | /cs | 결과 링크만 축적. 추적은 위임 |
| 함께 일하는 사람(상사, 동료, 팀원)의 업무 프로필 | /people | 고객사 담당자 표기만. 인물 심층은 위임 |
공통 3블록(빈 / 부분 / 풀 데이터)은 CONTRACT 6-1절 참조.
[의존성 부재] 환경 분기 키 파일 부재
[데이터 결함] 기존 프로필 작성일 90일 이상 경과
customer/{name}.md frontmatter updated가 오늘(2026-04-21) 기준 90일+ 경과[stale] 태그 추가 + 갱신 권장 메시지. "90일+ 경과, 계약/담당자/규모 변동 확인 권장"