🚀 Projectops

GitHub Actions 자동화 + Agent AI Skills — 개발 사이클 전체를 자동화하는 DevOps 템플릿

이슈 등록부터 커밋, 보고서, 배포까지. 개발자는 코드만 작성하세요.

최신 버전 : v4.2.23 (2026-07-20)

전체 버전 기록 보기

---

왜 이 템플릿인가?

이 프로젝트는 두 축으로 개발 워크플로우를 자동화합니다.

① GitHub Actions — main 푸시 한 번으로 버전 관리, 체인지로그, CI/CD 배포까지 자동 처리
② Agent Skills — /github, /commit, /report 등 AI가 이슈 작성부터 커밋 메시지, 구현 보고서까지 대신 생성

기존 방식	Projectops
버전 수동 관리, 태그 직접 생성	릴리스(develop→main PR) 시 patch 버전 자동 증가 + 태그 생성
체인지로그 직접 작성 (30분+)	CodeRabbit AI가 PR마다 자동 생성
CI/CD 처음부터 설정	프로젝트 타입별 워크플로우 즉시 구성
이슈 매번 형식 맞춰 작성 (5분+)	/pro-github 한 번에 표준 템플릿 생성 + 등록
커밋 메시지 이슈 URL 수동 복사	/pro-commit 이슈 컨텍스트 기반 자동 완성
PR 설명/보고서 직접 작성	/pro-report git diff 분석 후 자동 생성
코드 리뷰·분석 매번 프롬프트 입력	24종 Skills로 일관된 결과, 매번 재입력 불필요

---

AI 개발 사이클

Agent Skills가 개발 사이클 전체를 커버합니다.

flowchart TD
    A([작업 시작]) --> B["/pro-github\n이슈 등록 + GitHub 자동 생성"]
    B --> C["/pro-init-worktree\nworktree + 민감파일 자동 복사"]
    C --> D{작업 유형}

    D -->|새 기능| E1["/pro-plan\n전략 수립"]
    D -->|버그| E2["/pro-troubleshoot\n원인 분석"]
    D -->|리팩토링| E3["/pro-refactor-analyze\nSmell 탐지"]

    E1 --> F["/pro-implement\n구현"]
    E2 --> F
    E3 --> F
    F --> G["/pro-test\n테스트"]
    G --> H["/pro-review\n셀프 리뷰"]
    H --> I["/pro-commit\n이슈 연동 커밋 자동 완성"]
    I --> J["/pro-report\n구현 보고서 + GitHub 댓글"]
    J --> K([PR 등록])
    K --> L["/pro-changelog-deploy\ndevelop push → main 릴리스 PR + automerge"]

Skills 전체 목록 및 상세 사용법: docs/SKILLS.md

---

GitHub Actions 자동화 파이프라인

flowchart TD
    A([develop 푸시]) --> B[개발 통합]
    B --> C[develop→main 릴리스 PR]
    C --> D[PR 내 버전 확정\npatch +1 + 태그 + AI 체인지로그]
    D --> E[자동 머지]
    E --> F[main push → CI/CD 배포\nFlutter / Spring / React 등]
    F --> G([완료])

---

빠른 시작

새 프로젝트

GitHub에서 "Use this template" 클릭 → 1분 내 자동 초기화 완료

기존 프로젝트에 통합

권장 — npx (macOS · Linux · Windows 공통)

npx projectops

Node.js 20.12+ 만 있으면 별도 설치 없이 대화형 마법사가 실행됩니다. 비대화형: npx projectops --mode full --type spring,react --force

⚠️ 구 template_integrator.sh / .ps1은 지원 종료(EOF) 되었습니다 (#458). 실행하면 npx projectops 안내만 출력하며, 다음 minor에서 파일이 제거됩니다.

Agent Skills만 설치

# Claude Code
claude plugin marketplace add Cassiiopeia/projectops
claude plugin install projectops@projectops-marketplace --scope user

# Gemini CLI
gemini extensions install https://github.com/Cassiiopeia/projectops

# Codex CLI (macOS / Linux)
codex plugin marketplace add Cassiiopeia/projectops

--mode skills 마법사는 Codex marketplace를 등록한 뒤 native skills fallback도 자동 준비합니다. /plugins는 설치 확인/관리용으로만 사용하면 됩니다.

Codex plugin marketplace를 사용할 수 없는 환경에서는 Skills 가이드의 fallback 설치 방식을 사용하세요.

# Cursor / 전체 Agent Skills 설치 메뉴 (권장 — npx)
npx projectops --mode skills

Claude Code는 /pro- 자동완성, Gemini는 extension, Codex는 plugin marketplace를 우선 사용합니다. 자세한 설치 방식은 Skills 가이드를 확인하세요.

---

주요 기능

기능	설명	문서
Agent Skills	Claude Code, Cursor, Gemini CLI, Codex CLI에서 쓰는 24종 AI DevOps Skills	상세
버전 자동화	릴리스(develop→main PR) 시 patch 버전 자동 증가 + Git 태그	상세
AI 체인지로그	provider 사다리(CodeRabbit/GitHub Models/OpenAI 계열/commit) 기반 CHANGELOG 자동 생성	상세
PR Preview	댓글 한 줄로 임시 서버 배포, 닫으면 자동 삭제	상세
이슈 자동화	브랜치명/커밋 메시지 자동 제안, QA 이슈 생성	상세
Flutter CI/CD	iOS TestFlight + Android Play Store 자동 배포	상세
배포 설정 마법사	Play Store / TestFlight / Firebase App Distribution 5단계 HTML 마법사	.github/util/flutter/{playstore,testflight,firebase}-wizard/
SSH+Docker 배포	SSH 접속 서버에 Docker 무중단 배포 (Synology·AWS EC2 등)	상세

---

Agent Skills (24종)

🔄 개발 사이클 자동화

스킬	용도
/pro-init-worktree	Git worktree 생성 + 민감 파일 자동 복사
/pro-commit	이슈 컨텍스트 기반 커밋 메시지 자동 완성 (superpowers 준수)
/pro-report	git diff 분석 → 구현 보고서 생성 + GitHub 댓글 자동 포스팅
/pro-changelog-deploy	develop push → main 릴리스 PR 생성 + 릴리스 노트 작성 + automerge
/pro-github	GitHub 전반: 이슈 생성(설명 한 줄 → 템플릿 작성+등록)/조회/수정/댓글/라벨/담당자, PR 생성/머지/조회, 레포 탐색, Actions/Secret 관리

📊 분석형 (코드 수정 없음)

스킬	용도
/pro-analyze	구현 전 현재 코드 상태 분석 및 영향 범위 평가
/pro-plan	요구사항 명확화 + 2가지 이상 접근 방식 비교로 전략 수립
/pro-design-analyze	아키텍처/API/DB/UI 설계 분석 (구현 X)
/pro-refactor-analyze	Code Smell 탐지 + Before/After 기반 리팩토링 계획
/pro-review	보안/성능/버그/품질 6관점 리뷰, Critical/Major/Minor 분류
/pro-troubleshoot	가설-검증 방식 근본 원인 분석, Quick Fix/Root Fix 제시

🔧 구현형 (실제 코드 작성)

스킬	용도
/pro-implement	계획/분석 결과 기반 코드 구현 (기존 스타일 100% 준수)
/pro-design	아키텍처/API/DB/UI 설계 + 구현까지
/pro-refactor	Extract Method, DRY 등 리팩토링 기법 단계별 적용
/pro-test	AAA 패턴 단위/통합/E2E 테스트 코드 작성
/pro-figma	Figma CSS → React/RN/Flutter 반응형 코드 변환
/pro-build	프로젝트 빌드 실행, 에러 분석, 최적화 제안

📝 문서/산출물 생성형

스킬	용도
/pro-document	코드 주석/README/API 문서 작성
/pro-testcase	이슈 분석 → QA 체크리스트 생성
/pro-ppt	트러블슈팅/구현 사례 → 5섹션 발표자료
/pro-spring-test	Spring Boot 테스트 샘플 코드 생성
/pro-synology-expose	Synology NAS 외부 도메인 노출 설정 가이드
/pro-ssh	원격 서버 SSH 접속·명령 실행 (AWS EC2, 시놀로지 NAS, Linux 등 범용)
/pro-skill-creator	Skill 생성/리뷰/개선 (CREATE·REVIEW·IMPROVE 3모드)

---

지원 프로젝트 타입

타입	버전 파일	CI/CD
spring	build.gradle	SSH+Docker 배포, Nexus
flutter	pubspec.yaml	TestFlight, Play Store
react (Next.js 포함)	package.json	Docker
node	package.json	Docker
python	pyproject.toml	SSH+Docker 배포
react-native	Info.plist + build.gradle	—
react-native-expo	app.json	—
basic	version.yml만	—

---

댓글 명령어

Issue나 PR에 댓글로 자동화를 실행합니다.

명령어	기능	대상
@projectops server build	임시 서버 배포	Spring, Python
@projectops server destroy	서버 삭제	Spring, Python
@projectops server status	서버 상태 확인	Spring, Python
@projectops build app	iOS + Android 빌드	Flutter
@projectops apk build	Android만 빌드	Flutter
@projectops ios build	iOS만 빌드	Flutter
@projectops create qa	QA 이슈 자동 생성	모든 프로젝트

상세: PR Preview | Flutter 빌드 | 이슈 자동화

---

설정

필수 Secret

Repository Settings → Secrets → Actions → New repository secret
Name: _GITHUB_PAT_TOKEN
Value: [Personal Access Token - repo, workflow 권한]

Organization 설정

Settings → Actions → General
├─ ✅ Allow GitHub Actions to create and approve pull requests
└─ ✅ Read and write permissions

---

문서

문서	설명
Agent Skills 가이드	24종 Skills 용도, 사용법, 전체 개발 사이클 흐름
NPX 마법사 가이드	npx projectops 통합·배포/publish 2축·레거시 자동 마이그레이션
통합 스크립트 가이드	구 integrator 지원 종료(EOF) 안내
버전 관리	version.yml, 자동 버전 증가
체인지로그 자동화	릴리스 노트 provider 사다리, CodeRabbit 연동
PR Preview	임시 서버 배포 시스템
Flutter CI/CD	iOS/Android 자동 배포
SSH+Docker 배포	SSH 접속 서버에 Docker 배포 (Synology·AWS EC2 등)
이슈 자동화	Issue Helper, QA 봇
트러블슈팅	자주 발생하는 문제 해결

---

지원

• Issues — 버그 리포트, 기능 요청
• CONTRIBUTING.md — 기여 가이드

---

MIT License