Community코딩 & 개발github.com

LadsonDavid/논리적-코드베이스-감사-스킬

12단계와 21가지 책 기반 프레임워크를 사용하여 모든 코드베이스의 진실성을 감사하고, 팬텀 기능, 스텁 통합, MISALIGNED 주장을 찾아내는 Claude 스킬입니다.

논리적-코드베이스-감사-스킬란 무엇인가요?

이 스킬은 소프트웨어 프로젝트의 코드베이스를 체계적으로 감사하여 문서화된 기능과 실제 구현 간의 불일치를 식별합니다. 12단계 프로세스와 21가지 책 기반 프레임워크를 활용하여 '팬텀 기능'(존재하지 않지만 문서에 언급된 기능), '스텁 통합'(완전히 구현되지 않은 외부 서비스 연결), 'MISALIGNED 주장'(코드 주석, 문서, 또는 커밋 메시지가 실제 코드 동작과 다른 경우)을 찾아냅니다. Claude Desktop, Cursor, Windsurf, GitHub Copilot과 같은 주요 AI 에이전트 플랫폼에서 사용할 수 있습니다. 이 스킬은 개발자, QA 엔지니어, 기술 문서 작성자, 프로젝트 관리자에게 특히 유용하며, 코드베이스의 무결성을 유지하고 기술적 부채를 줄이는 데 도움을 줍니다. SKILL.md 문서화에 따라 사용자는 특정 디렉토리나 파일을 대상으로 감사를 실행하고, 결과를 JSON 또는 Markdown 형식으로 내보낼 수 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add LadsonDavid/Logical-codebase-audit-skill

Installed? Explore more 코딩 & 개발 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

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

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

문서

논리적-코드베이스-감사-스킬은(는) 무엇을 하나요?

12단계와 21가지 책 기반 프레임워크를 사용하여 모든 코드베이스의 진실성을 감사하고, 팬텀 기능, 스텁 통합, MISALIGNED 주장을 찾아내는 Claude 스킬입니다.

개요

이 스킬은 소프트웨어 프로젝트의 코드베이스를 체계적으로 감사하여 다음과 같은 불일치를 식별합니다:

  • 팬텀 기능: 문서화되었지만 코드에 존재하지 않는 기능
  • 스텁 통합: 완전히 구현되지 않은 외부 서비스 연결
  • MISALIGNED 주장: 주장과 실제 구현 간의 불일치

작동 방식

감사는 12단계 프로세스를 따르며, 각 단계는 특정 유형의 불일치를 식별하도록 설계되었습니다. 이 스킬은 21가지 책 기반 프레임워크를 활용하여 감사에 구조화된 접근 방식을 제공합니다.

지원되는 플랫폼

  • Claude Desktop
  • Claude Code (CLI)
  • Cursor
  • Windsurf
  • GitHub Copilot

사용 방법

  1. 코드베이스 디렉토리를 작업 공간으로 엽니다.
  2. 다음 명령 중 하나를 사용합니다:
    • audit codebase — 전체 코드베이스 감사 수행
    • audit codebase --path src/ — 특정 디렉토리 감사
    • audit codebase --files src/main.ts,src/utils.ts — 특정 파일 감사

출력

감사 결과는 기본적으로 콘솔에 표시되며, 다음 옵션을 사용하여 내보낼 수 있습니다:

  • --output report.json — JSON 형식으로 내보내기
  • --output report.md — Markdown 형식으로 내보내기

예시

# 전체 코드베이스 감사
audit codebase

# 특정 디렉토리 감사
audit codebase --path src/components

# 결과를 JSON 파일로 내보내기
audit codebase --output audit-report.json

구성

환경 변수:

  • AUDIT_DEPTH — 감사 깊이 설정 (기본값: deep)
  • AUDIT_FORMAT — 출력 형식 설정 (기본값: table)
  • AUDIT_VERBOSE — 상세 로깅 활성화 (true 또는 false)

대상 사용자

  • 개발자: 코드베이스 무결성 유지
  • QA 엔지니어: 테스트 불일치 식별
  • 기술 문서 작성자: 문서 정확성 보장
  • 프로젝트 관리자: 기술적 부채 추적

라이선스

MIT

관련 스킬