클로드스킬마트스킬 둘러보기스킬이 뭐예요?
 
← 목록으로

GitHub 채널 연동 추가 (NanoClaw)

NanoClaw 에이전트가 GitHub PR·이슈 댓글 스레드에서 대화할 수 있도록 GitHub 채널 어댑터를 설치·등록·설정해 주는 스킬.

자동화·워크플로고급★ 30,471⑂ 12,865AI 점수 7/10마지막 업데이트: 2026. 8. 9.

무엇을 해주나

NanoClaw 프로젝트에 GitHub 채널 어댑터를 붙여, 에이전트가 PR과 이슈의 댓글 스레드를 하나의 대화로 취급하도록 만들어 줍니다. 구체적으로는:

  • channels 브랜치에서 src/channels/github.ts와 등록 테스트 파일을 가져와 복사
  • 채널 배럴(src/channels/index.ts)에 자체 등록 import 한 줄 추가
  • @chat-adapter/github를 정확한 버전으로 핀 고정해 설치(범위·latest 금지 정책)
  • pnpm run build와 등록 테스트로 실제로 채널이 레지스트리에 올라갔는지 검증
  • 봇 계정 PAT / 웹훅 시크릿 / 봇 사용자명을 물어본 뒤 .env에 없을 때만 기록
  • ncl로 메시징 그룹과 와이어링 생성, private/public 저장소에 따른 unknown_sender_policy 선택 안내

모든 단계가 nc: 지시문 펜스로 표현되어 있어 사람이 읽어도, 파서가 자동 적용해도 동일하게 동작하고, 여러 번 다시 실행해도 안전합니다.

이런 분께 추천

  • NanoClaw를 셀프호스팅하며 GitHub에서 에이전트를 호출하고 싶은 개발자
  • PR 리뷰 스레드에 상주하는 봇을 만들고 싶은 팀
  • .env, 웹훅, 서비스 재시작까지 한 흐름으로 정리된 가이드가 필요한 운영 담당자

주의: NanoClaw 저장소 밖에서는 의미가 없고, ncl CLI와 실행 중인 호스트 서비스가 필요하므로 초보자용은 아닙니다.

활용 예시

  1. PR 리뷰 도우미: 사내 private 저장소에 웹훅을 걸고 unknown_sender_policy: 'public'로 두면, 협업자가 PR 댓글에 @my-org-bot 이 변경 요약해줘라고 쓰는 순간 에이전트가 같은 스레드에 답변.
  2. 공개 저장소 이슈 트리아지: public 저장소는 strict 정책으로 두고 ncl users create --id "github:12345" --kind github로 신뢰하는 메인테이너만 등록해, 외부인이 에이전트 자원을 소모하지 못하게 차단.
  3. 연동 상태 점검: 채널이 죽었을 때 pnpm exec vitest run src/channels/github-registration.test.ts를 돌려 배럴 import나 어댑터 설치가 어긋났는지 즉시 판별.

· · · 설치 가이드 · · ·

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 nanocoai/nanoclaw 의 .claude/skills/add-github 폴더를 내 ~/.claude/skills/add-github/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/nanocoai/nanoclaw.git && mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-github ~/.claude/skills/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널에서 NanoClaw 저장소를 클론합니다: git clone https://github.com/nanocoai/nanoclaw.git
  2. 스킬을 개인 스킬 폴더로 복사합니다: mkdir -p ~/.claude/skills && cp -r nanoclaw/.claude/skills/add-github ~/.claude/skills/ (NanoClaw 프로젝트 안에서 작업한다면 이미 포함되어 있으니 생략 가능)
  3. 봇 전용 GitHub 계정을 새로 만들고, 감시할 저장소에 write 권한 협업자로 초대합니다. (개인 계정을 쓰면 자기 댓글 필터링 때문에 문제가 생깁니다.)
  4. 봇 계정으로 로그인해 Settings → Developer Settings → Personal Access Tokens에서 fine-grained 토큰을 발급합니다. 권한은 Pull requests(R/W), Issues(R/W).
  5. 각 저장소 Settings → Webhooks에서 Payload URL https://내도메인/webhook/github, Content type application/json, Secret은 openssl rand -hex 20으로 생성, 이벤트는 Issue comments와 Pull request review comments를 선택합니다.
  6. NanoClaw 프로젝트 루트에서 Claude Code를 열고 "GitHub 채널 연동해줘" 또는 /setup 흐름 안에서 이 스킬을 실행합니다.
  7. 스킬이 물어보는 세 값(PAT, 웹훅 시크릿, 봇 사용자명)을 입력하면 .env에 기록됩니다.
  8. 빌드와 등록 테스트가 통과하는지 확인한 뒤, private/public 여부에 맞춰 ncl로 메시징 그룹·와이어링을 만듭니다(호스트 서비스가 실행 중이어야 함).
  9. 마지막으로 서비스를 재시작합니다(macOS: launchctl kickstart -k ..., Linux: systemctl --user restart ...). PR 댓글에서 봇을 @멘션해 동작을 확인하세요.
GitHub에서 원본 보기 ↗라이선스: MIT