code-analysis
코드 가독성 개선
팀은 종종 개발자만 이해할 수 있는 코드를 작성합니다. 이 스킬은 이름, 주석, 전문 용어, 문서를 확인하여 더 넓은 범위의 팀이 코드를 더 빠르게 이해할 수 있도록 돕습니다.
스킬 ZIP 다운로드
Claude에서 업로드
설정 → 기능 → 스킬 → 스킬 업로드로 이동
토글을 켜고 사용 시작
에이전트가 읽기 쉬운 리소스
AI 에이전트, 크롤러, 스크립트가 전체 페이지 대신 정리된 컨텍스트만 필요할 때 이 링크를 사용하세요.
테스트해 보기
"code-analysis" 사용 중입니다. 짧은 변수명과 적은 주석이 있는 Python 파일.
예상 결과:
보고서는 보통 수준의 점수를 제공하고, 불명확한 이름을 표시하며, 설명 주석과 함께 더 완전한 이름을 제안합니다.
"code-analysis" 사용 중입니다. 주석에 API 전문 용어가 있는 TypeScript 파일.
예상 결과:
보고서는 설명되지 않은 기술 용어를 식별하고 쉬운 영어 정의를 제안합니다.
"code-analysis" 사용 중입니다. 문서화가 잘 된 서비스 파일.
예상 결과:
보고서는 높은 점수를 제공하고 해당 파일이 비개발자도 이해하기 쉽다고 언급합니다.
보안 감사
낮은 위험The static weak cryptography findings are false positives caused by readability terms such as token, serialize, and hash-related wording, not cryptographic operations. The Markdown backtick findings are also false positives from fenced examples and documented CLI usage. The skill is safe to publish with a low warning because it runs a local script that reads user-selected files and may print code snippets.
Confirmed security concerns (1)
Static false positives ignored (3)
These static matches were dismissed by semantic review or matched schema-only tokens, so they are shown for transparency but do not drive the quality score.
위험 요인
⚡ 스크립트 포함 (2)
📁 파일 시스템 접근 (1)
⚙️ 외부 명령어 (1)
감지된 패턴
품질 점수
만들 수 있는 것
이해관계자에게 공개할 코드 검토
제품 리뷰 전에 비즈니스 로직에 명확한 이름과 쉬운 주석이 있는지 확인합니다.
온보딩 예제 준비
새 팀원과 코드를 공유하기 전에 누락된 설명을 찾습니다.
문서 품질 개선
소스 주석에서 전문 용어와 누락된 What, Why, How 맥락을 식별합니다.
이 프롬프트를 사용해 보세요
code-analysis skill을 사용하여 이 파일의 비개발자 관점 가독성을 검토하세요: [file path].
이름 지정에 집중하여 [file path]을 분석하세요. 어떤 이름이 더 명확해야 하는지와 그 이유를 설명하세요.
새 팀원을 위해 [file path]을 검토하세요. 주석, 전문 용어, 누락된 맥락을 우선적으로 다루세요.
엄격한 가독성 기준으로 [file path]을 분석하세요. 이 코드를 이해관계자와 공유하기 전에 차단 요인을 요약하세요.
모범 사례
- 비밀 정보가 포함된 파일이 아니라 의도한 프로젝트 파일에서 실행하세요.
- 비개발자 대상과 코드를 공유하기 전에 strict mode를 사용하세요.
- 기존 도메인 용어를 변경하기 전에 각 제안을 수동으로 검토하세요.
피하기
- 점수를 코드가 정확하다는 증거로 취급하지 마세요.
- 비공개 자격 증명, 키 또는 민감한 구성 파일을 스캔하지 마세요.
- 사람이 수행하는 문서 검토를 자동화된 결과만으로 대체하지 마세요.