Assessment — 읽기 전용 코드베이스 진단 & 의사결정 지원
코드베이스 파악, 서비스 헬스체크, ADR 자문, 의사결정 매트릭스, 다중 페르소나 비평을 하나로 묶은 읽기 전용 분석 스킬.
개발·코딩중급★ 445⑂ 51AI 점수 9/10마지막 업데이트: 2026. 11. 3.
무엇을 해주나
파일을 고치지 않고 '보기만' 하는 분석 작업을 7개 모드로 나눠 수행합니다.
- 읽기 전용 점검: 허용 명령(
ls,git log,ps,curl -s등)만 사용하고rm,git commit, 설치 명령 등은 금지. - 코드베이스 개요: 4단계(탐지→탐색→매핑→요약)로 언어·프레임워크·진입점·핵심 추상화·요청 흐름을 근거 파일과 함께 정리하고, "새 코드는 어디에 넣어야 하나" 섹션까지 생성.
- 레포 가치 분석: 외부 저장소를 얕게 클론해 영역별 병렬 에이전트로 정독 → 비교표 → 갭 등급(HIGH/MEDIUM/LOW) → 검증 → 최종 보고서.
- 서비스 헬스체크:
pgrep, 헬스 파일 JSON,ss로 프로세스/포트/상태를 교차 검증해 DOWN·WARNING·ERROR·HEALTHY 판정. - ADR 자문: 반대론자·사용자 대변자·메타 프로세스 3개 에이전트를 병렬 실행해 PROCEED/BLOCKED 결론.
- 의사결정 스코어링: 정확성5·복잡도3·유지보수3·리스크3 등 가중치로 2~4개 선택지를 가중 평균 채점.
- 다중 페르소나 비평: 논리학자·실용주의 빌더·시스템 순수주의자·사용자 대변자·회의적 철학자 5인이 제안을 평가하고 합의 매트릭스로 종합.
이런 분께 추천
- 처음 보는 저장소에 투입돼 빠르게 구조를 파악해야 하는 개발자·테크리드
- 아키텍처 결정(ADR)이나 빌드 vs 바이 같은 선택을 근거 있게 남기고 싶은 사람
- 프로덕션 변경 없이 '현재 상태 감사'만 안전하게 돌리고 싶은 운영 담당자
활용 예시
- "이 레포 구조 요약해줘" → 코드베이스 개요 모드가 package.json/go.mod로 스택을 판별하고, 진입점·데이터 모델·API 표면을 절대경로 근거와 함께 보고.
- "Postgres로 갈지 DynamoDB로 갈지 결정 도와줘" → 의사결정 스코어링이 가중치를 먼저 고정한 뒤 1~10점 채점, 상위 두 안이 0.5 이내면 '접전'으로 분류해 결정 기준을 제시.
- "이 설계안 구멍 좀 찔러줘" → 다중 페르소나 비평이 5인 평가를 모아 CONSENSUS/CONTESTED/OUTLIER로 분류하고 0~15점 합산 순위를 제공.
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/notque/vexjoy-agent/HEAD/skills/analysis/assessment/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
AI 스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 notque/vexjoy-agent 의 skills/analysis/assessment 폴더를 내 ~/.claude/skills/assessment/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/notque/vexjoy-agent.git && mkdir -p ~/.claude/skills && cp -r vexjoy-agent/skills/analysis/assessment ~/.claude/skills/assessment && cp -r vexjoy-agent/skills/shared-patterns ~/.claude/skills/shared-patterns⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 저장소를 클론합니다:
git clone https://github.com/notque/vexjoy-agent.git - 스킬 폴더가 없으면 만듭니다:
mkdir -p ~/.claude/skills - 스킬 본체를 복사합니다:
cp -r vexjoy-agent/skills/analysis/assessment ~/.claude/skills/assessment - 참조 문서와 스크립트가 함께 있는지 확인합니다:
ls ~/.claude/skills/assessment/references ~/.claude/skills/assessment/scripts(없으면 원본 경로에서 다시 복사) - 보고서 자체 검토 기능을 쓰려면 공용 패턴도 복사합니다:
cp -r vexjoy-agent/skills/shared-patterns ~/.claude/skills/shared-patterns - Claude Code를 재시작한 뒤 "이 레포 개요 좀 줘" 또는 "의사결정 매트릭스 만들어줘"라고 요청해 발동되는지 확인합니다.
- 안전하게 쓰려면 첫 실행 시 "읽기 전용으로만"이라고 명시해 변경 작업을 차단하세요.
GitHub에서 원본 보기 ↗라이선스: MIT