Community생산성 & 협업github.com

huzimun/remote-git-dev-workflow

Remote Git Dev Workflow는 로컬 머신에서 개발하고 GitHub 또는 GitLab을 중앙 저장소로 사용하며 원격 서버에서 실행 및 검증하는 안전하고 재사용 가능한 협업 워크플로를 구축하기 위한 Codex 스킬입니다.

remote-git-dev-workflow란 무엇인가요?

이 스킬은 로컬 개발 환경, 원격 Git 저장소(GitHub 또는 GitLab), 배포/테스트를 위한 원격 서버 간의 안전하고 재사용 가능한 개발 워크플로를 설정하는 방법을 Codex AI 에이전트에게 가르칩니다. 주요 목표는 개발자가 로컬에서 코드 작업을 하고 변경 사항을 중앙 저장소에 푸시한 다음 원격 서버가 자동으로 코드를 가져와 실행하거나 검증함으로써 수동 배포 오류를 최소화하고 팀 협업을 간소화하는 것입니다. 이 스킬은 Codex 플랫폼에서 사용하도록 설계되었으며 SSH 액세스, Git 후크, CI/CD 파이프라인과 같은 도구를 활용하여 반복 가능한 프로세스를 만듭니다. 또한 보안 모범 사례(예: 환경 변수, 키 관리)를 강조하여 워크플로를 프로덕션에 적합하게 만듭니다. SKILL.md 문서에는 SSH 구성, Git 워크플로 설정, 서버 측 스크립트에 대한 단계별 지침이 포함되어 있어 로컬과 원격 개발을 효율적으로 연결하려는 모든 개발자에게 이상적입니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add huzimun/remote-git-dev-workflow

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

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

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

문서

remote-git-dev-workflow은(는) 무엇을 하나요?

Remote Git Dev Workflow는 Codex 스킬로, 안전하고 재사용 가능한 협업 워크플로를 구축하기 위해 설계되었습니다: 로컬 머신에서 개발하고, GitHub 또는 GitLab을 중앙 저장소로 사용하며, 원격 서버에서 실행 및 검증을 수행합니다.

개요

이 스킬은 로컬 개발 환경과 원격 서버 간의 격차를 해소하여 개발자가 다음을 수행할 수 있도록 합니다:

  • 로컬에서 코드를 작성하고 변경 사항을 커밋합니다.
  • 변경 사항을 중앙 Git 저장소(GitHub/GitLab)에 푸시합니다.
  • 원격 서버가 자동으로 코드를 가져와서 실행하거나 테스트를 수행합니다.

주요 기능

기능설명
자동 배포푸시 이벤트 시 원격 서버에서 코드 가져오기 및 실행
안전한 인증SSH 키를 사용한 서버 액세스
재사용 가능다양한 프로젝트에서 사용 가능한 표준 워크플로
플랫폼 독립적GitHub 및 GitLab 모두 지원

사전 요구 사항

  • 로컬 머신에 설치된 Git
  • GitHub 또는 GitLab 계정
  • SSH로 액세스 가능한 원격 서버 (Linux 권장)
  • Codex 환경

설정 방법

1단계: 로컬 Git 저장소 초기화

git init
git remote add origin <your-repo-url>

2단계: SSH 키 설정

로컬 머신에서 SSH 키를 생성하고 원격 서버에 추가합니다:

ssh-keygen -t rsa -b 4096 -C "[email protected]"
ssh-copy-id user@remote-server

3단계: 서버 측 설정

원격 서버에 Git 후크 스크립트를 생성합니다:

# 예: post-receive 후크
#!/bin/bash
export DEPLOY_DIR="/path/to/deploy"
git --work-tree=$DEPLOY_DIR checkout -f
cd $DEPLOY_DIR
./run.sh  # 사용자 정의 실행 스크립트

4단계: Codex에 워크플로 등록

이 스킬을 Codex 프로젝트의 SKILL.md 파일에 추가합니다.

환경 변수

변수설명
REMOTE_HOST원격 서버 호스트네임
REMOTE_USERSSH 사용자 이름
REPO_URLGit 저장소 URL
DEPLOY_PATH서버의 배포 디렉토리

보안 고려 사항

  • SSH 키는 안전하게 저장하고 절대 저장소에 커밋하지 마십시오.
  • 환경 변수와 .env 파일을 사용하여 민감한 정보를 관리하십시오.
  • 서버 측 스크립트는 최소 권한 원칙을 따라 실행 권한을 제한하십시오.

문제 해결

  • SSH 연결 실패: 키가 올바르게 설정되었는지 확인하고 ssh -v user@host로 디버그합니다.
  • Git 푸시 거부: 저장소 권한과 원격 URL을 확인합니다.
  • 스크립트 실행 오류: 서버 측 스크립트에 실행 권한(chmod +x)이 있는지 확인합니다.

라이선스

이 스킬은 MIT 라이선스 하에 제공됩니다. 자세한 내용은 저장소의 LICENSE 파일을 참조하십시오.

관련 스킬