forgejo-direct-api-skill은(는) 무엇을 하나요?
Forgejo에 특화된 Codex 스킬로, Forgejo v15 API, Actions, 러너, PR 리뷰, 패키지, Swagger 검증을 직접 지원합니다.
개요
이 스킬은 Forgejo v15 API와 직접 통신하여 Forgejo 인스턴스의 다양한 기능을 활용할 수 있도록 합니다. Forgejo는 Git 호스팅, 이슈 트래킹, 코드 리뷰, CI/CD 등을 제공하는 오픈소스 플랫폼입니다.
주요 기능
- 직접 API 호출: Forgejo v15 REST API를 직접 호출하여 인증, 이슈, PR, 리포지토리 등을 관리합니다.
- Actions 및 러너: Forgejo Actions 워크플로우를 트리거하고, 러너 상태를 확인 및 관리합니다.
- PR 리뷰: 풀 리퀘스트 생성, 병합, 리뷰 댓글 추가 등 PR 관련 작업을 수행합니다.
- 패키지 관리: Forgejo 패키지 레지스트리에서 패키지를 검색, 게시, 삭제합니다.
- Swagger 검증: Swagger/OpenAPI 스펙을 검증하고 문서화 오류를 식별합니다.
지원 플랫폼
- Codex (OpenAI)
- Claude Code (Anthropic) – 호환 가능
- 기타 API 기반 AI 에이전트
사용 방법
이 스킬을 사용하려면 Forgejo 인스턴스의 API 토큰이 필요합니다. 토큰은 환경 변수 FORGEJO_TOKEN 또는 FORGEJO_API_KEY로 설정할 수 있습니다.
export FORGEJO_TOKEN=your_forgejo_token_here
export FORGEJO_HOST=https://forgejo.example.com
예시 명령어
# 리포지토리 목록 조회
forgejo repos list
# 이슈 생성
forgejo issues create --repo owner/repo --title "버그 수정" --body "설명"
# Actions 워크플로우 트리거
forgejo actions run --repo owner/repo --workflow main.yml
# 러너 상태 확인
forgejo runners status
# PR 리뷰 제출
forgejo pr review --repo owner/repo --pr 42 --approve
# 패키지 검색
forgejo packages search --query python
# Swagger 검증
forgejo swagger validate --file openapi.yml
설정
| 환경 변수 | 설명 | 기본값 |
|---|---|---|
FORGEJO_TOKEN | API 인증 토큰 | (필수) |
FORGEJO_HOST | Forgejo 인스턴스 URL | https://codeberg.org |
FORGEJO_API_VERSION | API 버전 | v1 |
참고 사항
- 이 스킬은 Forgejo v15 API를 대상으로 하지만, 이전 버전과의 일부 호환성을 제공합니다.
- 모든 API 호출은 HTTPS를 통한 안전한 연결을 권장합니다.
- 자세한 내용은 Forgejo API 문서를 참조하세요.