Communitygithub.com

Adamska1008/코드로-설명

소스 참조와 스니펫을 기반으로 코드 관련 대화를 구체화하는 무음 에이전트 스킬입니다.

코드로-설명란 무엇인가요?

이 스킬은 AI 에이전트(예: Claude Code, Cursor, Codex)가 프로젝트를 설명할 때 추상적인 서술 대신 실제 소스 코드를 증거로 사용하도록 강제합니다. 개발자는 코드 리뷰, 온보딩, 또는 디버깅 중에 '코드를 보여주며 설명'하는 방식을 선호하는데, 이 스킬은 에이전트가 해당 방식을 따르도록 안내합니다. 주요 기능으로는 설명 전 관련 파일 자동 검사, 주요 주장에 대한 구체적인 파일 참조 및 라인 번호 포함, 각 중요 동작에 대한 최소한의 유용한 코드 스니펫 인용, 그리고 진입점, 호출 흐름, 데이터 흐름, 상태 변경, 부수 효과 및 경계와 같은 아키텍처 요소를 코드로 연결하여 설명하는 것이 포함됩니다. 코드를 검사할 수 없거나 증거가 불완전한 경우 이를 명확히 밝히고 추론과 검증된 소스 사실을 분리합니다. 설명 체계는 짧은 답변으로 시작하고 코드 기반 세부 사항으로 이어지는 가독성 높은 형태를 권장합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add Adamska1008/explain-with-code

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

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

문서

코드로 설명

프로젝트를 설명할 때는 코드를 증거로 삼으세요.

  1. 사용자가 정확한 코드를 제공하지 않은 경우, 설명하기 전에 관련 파일을 검사하세요.
  2. 주요 주장에 대해 구체적인 파일 참조와 라인 번호를 포함하세요.
  3. 각 중요한 동작에 대해 가장 작고 유용한 코드 스니펫을 인용하거나 요약하세요. 소스에 연결되지 않은 광범위한 산문은 피하세요.
  4. 참조된 코드가 어떻게 조화를 이루는지 설명하세요: 진입점, 호출 흐름, 데이터 흐름, 상태 변경, 부수 효과 및 경계.
  5. 코드를 검사할 수 없거나 증거가 불완전한 경우, 그 사실을 명확히 말하고 추론과 검증된 소스 사실을 분리하세요.
  6. 설명을 읽기 쉽게 유지하세요: 짧은 답변으로 시작한 다음, 세부 사항을 코드에 고정하세요.

다음 형식을 선호합니다:

짧은 답변.

관련 경로는 `path/to/file.ext:line`에서 시작되며, 여기서 ...

```language
작고 집중된 스니펫
```

이것은 `path/to/other.ext:line`에 있는 `symbol`을 호출하며, 여기서 ...

관련 스킬