Git Data API를 통해 GitHub 풀 리퀘스트를 만들고 나열하며, 커밋 상태를 확인하고 단일 파일을 푸시하는 종속성 없는 Python CLI입니다.
설치 및 다운로드
1. ClawHub CLI
레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.
npx clawhub@latest install github-workflow-integration
2. 수동 설치
스킬 폴더를 다음 위치 중 하나로 복사하세요
~/.openclaw/skills/ <project>/skills/ 우선순위: 워크스페이스 > 로컬 > 번들
3. 프롬프트 설치
이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.
Clawhub를 사용해서 github-workflow-integration 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).
다운로드를 원하시나요?
ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.
GitHub 워크플로 통합란 무엇인가요?
GitHub 워크플로 통합은 일부 GitHub REST API 작업을 위한 경량 명령줄 래퍼이며, 표준 라이브러리만 사용해 Python 3.8+용으로 만들어졌습니다. 풀 리퀘스트를 만들고 나열하고, 통합 커밋 상태를 조회하며, Git Data API 순서인 blob → tree → commit → ref를 사용해 단일 파일을 푸시할 수 있습니다. Openclaw Skills 사용자는 Git, GitHub CLI 또는 타사 Python 패키지를 설치하지 않고도 이러한 워크플로를 자동화할 수 있습니다.
인증에는 사용자가 제공한 Personal Access Token을 사용하며, 명령이 실행될 때 GITHUB_TOKEN에서 읽습니다. 토큰은 저장되거나 출력되지 않습니다. 쓰기 작업은 --dry-run으로 미리 볼 수 있습니다. 원격 변경을 수행하기 전에 사용자는 대상 저장소, 브랜치, 메시지를 확인해야 합니다. 이 도구는 특정 작업에 초점을 둔 통합 기능이지 범용 GitHub 클라이언트가 아닙니다.
GitHub 워크플로 통합 활용 사례
ghCLI를 설치하지 않고 스크립트에서 풀 리퀘스트를 만듭니다.- 열린 풀 리퀘스트를 나열하고 번호, 제목, 브랜치, URL을 반환합니다.
- CI 결과를 확인하기 위해 커밋 또는 ref의 통합 상태를 확인합니다.
- Git Data API를 사용해 CI 작업 또는 제한된 환경에서 로컬 파일 하나를 원격 브랜치로 푸시합니다.
- 저장소 상태를 변경하기 전에
--dry-run으로 쓰기 요청을 미리 봅니다. - 타사 종속성이 없는 Python 환경에서 GitHub REST API 작업을 사용합니다.
GitHub 워크플로 통합 작동 원리
GITHUB_TOKEN이 설정되어 있는지 확인합니다. 설정되어 있지 않으면 CLI는 인증되지 않은 요청을 시도하지 않고 설정 안내를 제공한 뒤 코드 2로 종료합니다.- 대상
owner\/repo와 필수 옵션을 지정해 해당 명령을 실행합니다:pr create,pr list,status또는push-file. - 쓰기 작업은 먼저
--dry-run으로 실행하고, 실제 요청을 보내기 전에 저장소, 브랜치, 메시지를 확인합니다. - Python CLI가 GitHub REST API에 요청을 보냅니다. 단일 파일 푸시의 경우 blob, tree, commit을 만든 다음 대상 ref를 업데이트합니다.
- 결과를 확인합니다. 성공하면 PR 번호 또는 URL, 상태, commit SHA와 같은 사람이 읽을 수 있는 세부 정보가 반환됩니다. API 오류와 네트워크 오류는 따로 보고됩니다.
- 종료 코드를 처리합니다.
0은 성공,1은 API 또는 네트워크 오류,2는 사용 오류 또는 토큰 누락을 뜻합니다. 401은 토큰 만료 또는 권한 범위 부족을 나타낼 수 있고, 404는 저장소나 브랜치가 잘못되었음을 나타낼 수 있습니다.
GitHub 워크플로 통합 설정 가이드
요구 사항
- Python 3.8 이상.
- 타사 Python 패키지, Git 설치 또는 GitHub CLI 설치가 필요하지 않습니다.
- 대상 작업에 필요한
repo범위를 가진 GitHub Personal Access Token (PAT). 이 skill은 OAuth가 아닌 PAT 인증을 사용합니다.
인증 구성
GitHub의 Settings → Developer settings → Personal access tokens에서 PAT를 만든 다음 GITHUB_TOKEN 환경 변수로 제공합니다. 토큰을 커밋하거나 명령 출력에 포함하지 마세요.
export GITHUB_TOKEN="<your-personal-access-token>"
python3 scripts\/gh_workflow.py pr list --repo owner\/repo
명령 실행
이 skill의 scripts\/gh_workflow.py 진입점을 사용합니다. 쓰기 작업은 먼저 미리 보고, --dry-run 없이 실행하기 전에 요청된 대상을 확인하세요.
python3 scripts\/gh_workflow.py pr create --repo owner\/repo --title "Fix bug" --head fix --base main --body "details" --dry-run
python3 scripts\/gh_workflow.py status --repo owner\/repo --ref main
python3 scripts\/gh_workflow.py push-file --repo owner\/repo --path .\/local.txt --message "add local.txt" --branch main
GitHub 워크플로 통합 데이터 스키마 및 분류 체계
이 skill은 상태를 저장하지 않는 CLI입니다. 로컬 데이터베이스, 생성된 메타데이터 파일 또는 토큰 저장소를 정의하지 않습니다. 입력은 명령줄 인수이며 결과는 사람이 읽을 수 있는 출력으로 기록됩니다.
| 항목 | 세부 정보 |
|---|---|
| 진입점 | scripts\/gh_workflow.py |
| 런타임 | Python 3.8+; 표준 라이브러리만 사용 |
| 인증 | 호출 시 읽는 GITHUB_TOKEN 환경 변수 |
| 저장소 식별자 | owner\/repo |
| 명령 | pr create, pr list, status, push-file |
| 드라이 런 | --dry-run은 요청을 보내지 않고 요청 형태를 미리 보여 줍니다 |
| 출력 | PR 세부 정보, 상태, commit SHA 또는 오류 정보 |
| 종료 코드 | 0 성공; 1 API/네트워크 오류; 2 사용 오류 또는 토큰 누락 |
push-file의 Git Data API 워크플로는 blob을 만들고 tree를 구성한 뒤 commit을 만들고 ref를 업데이트합니다. 토큰은 디스크에 쓰거나 로그에 기록하거나 그대로 출력하지 않습니다.
GitHub 워크플로 통합 고급 기능
- 종속성 없는 API 액세스: Python 표준 라이브러리의 네트워킹 기능을 사용하며 타사 패키지나 하위 프로세스가 필요하지 않습니다.
- Git Data API 단일 파일 푸시: blob → tree → commit → ref 순서로 원격 브랜치에 파일을 기록합니다. 일반 Git 푸시를 사용할 수 없을 때 유용합니다.
- 드라이 런 미리 보기: 지원되는 쓰기 작업을 보내기 전에 요청 형태를 확인합니다.
- 명확한 인증 경계: 사용자가 만든 PAT를
GITHUB_TOKEN에 지정해야 하며 OAuth를 시작하거나 브라우저를 열지 않습니다. - 실용적인 오류 처리: API/네트워크 오류와 사용 오류 및 토큰 누락 오류를 구분하고 스크립트용 종료 코드를 제공합니다.
- 명확한 범위: PR 생성 및 나열, 통합 커밋 상태, 단일 파일 푸시를 지원합니다. 병합, 리뷰 댓글, 릴리스, 워크플로 디스패치 또는 GitHub App 설치는 처리하지 않습니다.
- Openclaw Skills에 적합: 종속성을 최소화하고 자격 증명의 영구 저장을 피해야 하는 스크립트와 CI 작업에 간결한 GitHub 워크플로 구성 요소를 제공합니다.
SKILL.md
로드 중
관련 Openclaw 스킬
llms-generator
AI 에이전트가 프로젝트를 발견하고 이해하는 데 도움이 되는 LLMs.txt v2 구조의 프로젝트 가이드를 생성합니다.
ISO 14971 위험 매트릭스
의료기기 위험을 평가하고 ISO 14971:2019 제어 옵션을 검토하며 위험 관리 파일의 완전성을 확인하는 Python CLI 도우미입니다.
Base Gas
Base Gas provides live and historical network fee data to estimate transaction costs, compare chains, and decide when to transact.
The Yard
The Yard 스킬을 사용하면 OpenClaw 봇이 Stackyard의 봇 전용 메시지 게시판에 참여해 HTTPS로 읽고, 게시하고, 답글을 달고, 투표할 수 있습니다.
Skill 스켈레톤 생성기
Python 명령어 하나로 SKILL.md, AGENTS.md 및 대상 디렉터리를 포함하는 구조화된 LGD 준수 AI skill 시작 템플릿을 생성합니다.
더우바오 휴먼 시그널
더우바오 휴먼 시그널은 글에서 흔히 나타나는 AI 스타일 패턴을 확인하고, 사람 중심의 수정을 돕는 0–100 점수를 반환합니다.
UDI 검증기
규제 데이터베이스에 제출하기 전에 구조적 문제를 포착할 수 있도록 의료기기 UDI 문자열을 로컬에서 검증하고 구문 분석합니다.
추천*
