Communitygithub.com

AaronAsAChimp/skills

바이브 코딩된 애플리케이션을 평가할 때 사용합니다. 진행 여부를 결정하고 권장 사항을 제시하는 데 도움을 줍니다.

skills란 무엇인가요?

이 스킬은 '바이브 코딩' 방식으로 개발된 코드베이스의 품질을 평가하고 Go/No-Go 결정을 내리는 데 사용됩니다. 개발자가 직접 문제를 수정하는 대신, 보안, 신뢰성, 성능, UI/UX, 접근성이라는 다섯 가지 품질 기둥을 기준으로 코드를 분석하고 구체적인 권장 사항을 제공합니다. Claude Code와 같은 AI 에이전트 환경에서 사용할 수 있으며, 제품 문서 수집, 사용자 질문, 서브 에이전트를 통한 각 영역별 코드 리뷰, 그리고 최종 HTML 보고서 생성까지의 체계적인 프로세스를 따릅니다. 각 발견된 이슈에는 영향도(Showstopper, Critical, Moderate, Nice to have)가 할당되어 우선순위를 명확히 파악할 수 있어, 실무 프로젝트의 품질 평가와 의사 결정에 효과적입니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AaronAsAChimp/skills/tree/HEAD/skills/immaculate-vibes

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

완벽한 바이브 (Immaculate Vibes)

바이브 코딩된 코드베이스를 검토해 달라는 요청을 받았습니다. 발견된 문제를 수정하는 것이 아니라 권장 사항만 제시하면 됩니다.

프로세스

전체 프로세스는 다음과 같습니다:

  1. 사용 가능한 모든 제품 문서를 수집합니다.
  2. 사용자에게 질문하여 애플리케이션에 대한 이해를 깊게 합니다.
  3. 품질 기둥을 기준으로 코드를 검토합니다.
  4. 결과를 바탕으로 보고서를 작성합니다.

품질 기둥

고품질 소프트웨어를 작성하기 위한 기둥입니다. 중요도 순으로 나열되어 있으며, 이 관점을 통해 프로젝트를 바라보십시오.

  • 보안(Security) - 인증, 권한, 데이터 노출 및 안전하지 않은 브라우저 동작.
  • 신뢰성(Reliability) - 중요 플로우, 라우트 상태, 단언(assertion), 콘솔 오류 및 손상된 상태.
  • 성능(Performance) - 로드 동작, 응답성, 비용이 많이 드는 리소스 및 사용자에게 보이는 지연 시간.
  • UI/UX - 탐색, 명확성, 유효성 검사, 콘텐츠 기대치 및 시각적 일관성.
  • 접근성(Accessibility) - 키보드 접근, 의미론(semantics), 레이블, ARIA, 대비 및 보조 기술 신호.

상세 프로세스

1. 사용 가능한 제품 문서 수집

이 단계에서는 사용 가능한 제품 문서를 찾습니다. 이는 검토의 기초가 되므로 품질 기둥과 관련된 모든 것을 찾으십시오.

일반적으로 찾을 수 있는 위치:

  • PRODUCT.md
  • PRD.md
  • README.md
  • docs/

2. 사용자에게 질문하기

제품 문서가 불완전하거나 현재 애플리케이션 상태와 동기화되지 않았을 수 있습니다. 프로젝트와 그 요구 사항에 대한 이해를 깊게 하는 데 도움이 되는 질문을 사용자에게 하십시오. 가능하면 질문 도구를 사용하고, 그렇지 않으면 사용자와 채팅하십시오.

질문 예시:

  • 이 애플리케이션에 누가 접근해야 합니까?
  • 지속적인 유지보수 계획은 무엇입니까?
  • 이 애플리케이션을 어떻게 모니터링하고 성능과 신뢰성을 검증할 예정입니까?
  • 이 애플리케이션은 어디에 호스팅될 예정입니까?

3. 코드 검토

수집한 정보를 바탕으로 각 품질 기둥에 대해 코드를 검토할 서브 에이전트를 시작하십시오. 컨텍스트 오염을 방지하기 위해 서로 분리하여 유지하십시오. 각 서브 에이전트는 자신의 품질 기둥을 기준으로 문제를 찾고 Go/No-Go 평가를 제공하는 임무를 수행합니다.

각 이슈는:

  • 구체적이고 실행 가능한 이슈여야 합니다.
  • 이슈의 영향 평가를 포함해야 합니다.
    • 각 이슈에 다음 영향 수준 중 하나를 할당하십시오: Showstopper(쇼스토퍼), Critical(심각), Moderate(보통), Nice to have(있으면 좋음)
  • 이슈의 명확한 설명과 관련 파일 이름 및 줄 번호(있는 경우)를 포함해야 합니다.
  • 해결 방안에 대한 권장 사항을 제공해야 합니다.

4. 보고서 작성

모든 서브 에이전트의 결과를 수집하여 상세한 HTML 기반 보고서를 만들고 채팅에 높은 수준의 요약을 제공하십시오. 사용자가 검토할 수 있도록 브라우저에서 HTML 보고서를 여십시오.

보고서의 주요 특징:

  • Go/No-Go 권장 사항
  • 요구 사항: 제품에 대한 높은 수준의 요약과 핵심 요구 사항
  • 이슈: 영향 수준이 가장 심각한 것부터 가장 덜 심각한 순서로 정렬된 발견된 이슈 목록
  • 기타 정보: 검토자가 알아야 할 다른 중요한 발견 사항

보고서 예시:

권장 사항: No-go(진행 불가)

Fourgrounds 커피 랭커는 Fourgrounds 커피숍 고객이 자신이 가장 좋아하는 커피 음료를 순위 매길 수 있는 공개 애플리케이션입니다.

핵심 요구 사항:

  • 사용자에게 Fourgrounds에서 현재 제공되는 음료 목록이 표시되어야 합니다.
  • 사용자는 음료를 끌어서 놓아 원하는 순위로 재정렬할 수 있어야 합니다.
  • 사용자는 자신의 순위를 제출하고 선택한 무료 베이커리 품목에 대한 보상을 받을 수 있어야 합니다.
  • 사용자는 순위를 한 번만 제출할 수 있어야 합니다.

이슈:

사용자가 목요일에 여러 번 제출할 수 있습니다.

영향: CRITICAL(심각) - 사용자가 여러 개의 무료 보상을 축적할 수 있습니다.

date.js 42번 줄의 날짜 파싱 오류로 인해 처리되지 않은 예외가 발생하면 check-reward.js 16번 줄에서 이전 제출 여부 확인이 건너뛸 수 있습니다.

권장 사항: 기본 제공 날짜 파서를 사용하고 예외가 애플리케이션의 다른 영역에 영향을 미치지 않도록 날짜 파싱을 try/catch로 감싸십시오.

기타 정보:

  • coffee-products.json 파일은 매일 생성됩니다. 만약 낮에 제품이 변경되면 이 파일이 최신 상태가 아닐 수 있습니다. 순위의 외부 소비자는 제품의 존재 여부를 확인해야 합니다.

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

관련 스킬