// 한 프로젝트에서 사용자가 Claude Code에 입력한 프롬프트·작업 이력을 분석해 (1) 사용 패턴 정량화, (2) 사용자의 개발 철학 추출(근거 인용), (3) 그 철학을 렌즈로 한 메타 시스템(하니스·게이트·CI·프로세스) audit, (4) 우선순위가 매겨진 개선점 발굴을 수행한다. 트리거 — "내 프롬프트 분석해줘", "claude code 사용 패턴 분석", "내 개발 철학 추출", "메타 시스템 점검/audit", "하니스 개선점 발굴", "내가 입력한 프롬프트 기반으로 개선점 파악" 및 유사 의도.
| name | cc-usage-audit |
| description | 한 프로젝트에서 사용자가 Claude Code에 입력한 프롬프트·작업 이력을 분석해 (1) 사용 패턴 정량화, (2) 사용자의 개발 철학 추출(근거 인용), (3) 그 철학을 렌즈로 한 메타 시스템(하니스·게이트·CI·프로세스) audit, (4) 우선순위가 매겨진 개선점 발굴을 수행한다. 트리거 — "내 프롬프트 분석해줘", "claude code 사용 패턴 분석", "내 개발 철학 추출", "메타 시스템 점검/audit", "하니스 개선점 발굴", "내가 입력한 프롬프트 기반으로 개선점 파악" 및 유사 의도. |
사용자의 실제 프롬프트(지어낸 것이 아니라 transcript에서 추출한 발화)를 원자료로, 사용 패턴 → 개발 철학 → 메타 시스템 audit → 개선점 발굴까지 정량적·추적가능하게 수행하는 skill.
핵심 원칙(어기지 말 것):
상세 절차·휴리스틱·템플릿은 references/methodology.md 에 있다. 분석을
시작하기 전에 반드시 읽을 것.
대상 프로젝트의 transcript 디렉터리를 찾아 사용자 프롬프트만 뽑는다. 스크립트가 harness 주입(tool 결과·system-reminder·task-notification·command stdout)을 걸러낸다.
SK=.claude/skills/cc-usage-audit/scripts/extract-prompts.mjs # cc-system repo 기준 경로
# (선택) 어떤 프로젝트 dir들이 있는지 + 프롬프트 수 먼저 보기
node "$SK" --list
# 분석 대상 프로젝트의 cwd(또는 worktree)에서 실행하거나 --match로 지정.
# 한 프로젝트가 여러 worktree에 걸쳐 있으면 공유 토큰(repo명/worktree 그룹id)으로 매칭.
node "$SK" --match <substr> --json /tmp/cc-prompts.json
--match 없이 실행하면 현재 git 루트에서 토큰을 자동 도출한다. 매칭 0건이면
--list로 후보를 확인하고 적절한 substr를 골라 재실행한다(막혀도 사용자에게
묻지 말고 --list 결과로 스스로 판단).
스크립트는 프롬프트 수·길이 분포·시간대·워크트리별 분포와 모든 프롬프트 전문을 출력한다. 이걸 다 읽는다.
methodology.md §1의 분류 축으로 프롬프트를 주제별로 묶어 빈도를 센다(반복
잡일 / 메타 의문 / 비판적 논쟁 / 재확인 / 언어교정 / 재전송 / 시간대 집중).
간단한 빈도는 /tmp/cc-prompts.json에 대고 한 줄 node -e로 센다.
신호에서 반복되는 가치를 5~9개 원칙으로 압축한다. 각 원칙 = 주장 / 근거
(직접 인용+날짜) / 함의. 긴장하는 원칙쌍은 그 긴장을 해소하는 규칙까지.
(methodology.md §2 템플릿 사용.)
추출한 철학을 의심 질문 + 검증 방법 + 판정으로 바꿔 대상 산출물(게이트/
하니스/CI/프로세스 문서)에 적용한다. 정량 측정(LOC, 비율, 실행비용) → 의심
질문 → 반박 테스트 → 판정(KEEP/TRIM/MOVE-TO-TEST/DELETE/DEFER). 검증 약화로
통과시키는 것은 절대 금지. (methodology.md §3.)
프로젝트에 이미 audit 지침(예:
guidelines/meta-system-audit.md)이 있으면 단일 출처로 삼고 중복 생성 금지.
audit + 패턴 신호로 개선점을 뽑아 영향 × 근거강도로 정렬하고, 각 항목에
신뢰도 라벨(높음/중간/참고)을 붙인다. 5개 관점(품질게이트/하니스/코드구조/
기능/skill) 또는 프로젝트에 맞는 축으로 표를 만든다. (methodology.md §4·§5.)
마지막에 사용자에게: 추출한 철학을 프로젝트 지침 문서로 남길지, 발굴한 개선점 중 무엇을 먼저 실행할지 제안한다(즉시 수정은 하지 않음).
지금까지의 작업을 한 번에 출하한다 — 커밋 → push → PR 생성 → squash merge. "commit push pr squash merge", "ship it", "출하해줘", "PR 만들고 머지해줘", "커밋푸시 PR 스쿼시", "변경사항 commit push 후 pr 생성하고 squash merge" 등 commit+push+PR+merge를 한 번에 끝내려는 의도에서 트리거된다. 커밋만/푸시만 원하면 commit skill을 쓴다.
사용자에게 Discord DM을 전송한다. 메세지 내용을 입력받아 봇을 통해 개인 메세지를 보낸다.
비즈니스 메일/답장 초안을 작성할 때 적용하는 글쓰기 매너. "초안 작성", "메일 작성", "답변 작성", "회신", "메일 써줘", "draft email", "reply" 등 메일 관련 작성 요청에 트리거된다.
로컬 오디오 파일(m4a 등)을 한국어로 전사하는 skill. "전사해줘", "받아쓰기", "음성 파일 텍스트로", "transcribe", "음성 받아적어줘", "녹음 파일 변환" 등 오디오 → 텍스트 변환 요청에 트리거된다.
gogcli를 사용하여 Gmail 메일을 검색, 조회, 발송하는 skill. "메일 검색해줘", "이메일 보내줘", "gmail search", "메일 확인해줘", "최근 메일", "메일 답장", "gmail send", "메일 보내줘", "안 읽은 메일" 등 Gmail 관련 요청에 트리거된다.
gogcli를 사용하여 Google Calendar 일정을 조회, 검색, 생성, 수정, 삭제하는 skill. "일정 확인해줘", "캘린더 보여줘", "오늘 일정", "이번주 일정", "미팅 잡아줘", "일정 추가", "calendar events", "일정 생성", "스케줄 확인", "빈 시간 확인", "일정 삭제" 등 Google Calendar 관련 요청에 트리거된다.
