projectops

한국어 | English | 简体中文 | 日本語

최신 버전 : v4.31.0 (2026-10-02)

전체 버전 기록 보기

30초 시작

Node.js 20.12 이상만 있으면 됩니다. 별도 설치 없이 대화형 마법사가 실행됩니다.

위 화면은 샘플 Spring 프로젝트에서 실제로 실행한 화면입니다. 비대화형 실행과 옵션 전체는 CLI 레퍼런스를 보세요.

왜 이 템플릿인가?

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

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

실제로 이렇게 동작합니다

이 저장소 자신이 이 도구로 운영됩니다. 아래는 가짜 목업이 아니라 이 레포의 실제 이슈·PR·릴리스 화면입니다.

구성 요소

🔄 개발 사이클 자동화

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

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

설계·계획·구현 흐름은 superpowers(brainstorming → writing-plans → executing-plans)가 담당합니다. /pro-plan · /pro-analyze · /pro-implement는 같은 역할의 이전 세대 경로로, 명시적으로 호출할 때만 동작합니다. 위 표의 17종과 이 3종을 합쳐 총 20종입니다.

📝 문서/산출물 생성형

AI 개발 사이클

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

flowchart TD
    A(["작업 시작"]) --> B["/pro-github<br/>이슈 등록"]
    B --> C["/pro-init-worktree<br/>worktree + 민감파일 복사"]
    C --> D{"작업 유형"}

    D -->|새 기능·설계·리팩토링| E1["superpowers:brainstorming<br/>무엇을 왜 만들지 확정"]
    D -->|버그·장애| E2["/pro-note<br/>과거 기록 검색 + 조사"]

    E1 --> P["superpowers:writing-plans<br/>구현 계획"]
    P --> F["superpowers:executing-plans<br/>계획 실행"]
    E2 --> F
    F --> H["/pro-review<br/>셀프 리뷰"]
    H --> I["/pro-commit<br/>이슈 연동 커밋"]
    I --> J["/pro-report<br/>구현 보고서 + GitHub 댓글"]
    J --> K(["PR 등록"])
    K --> L["/pro-changelog-deploy<br/>릴리스 PR + automerge"]

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

GitHub Actions 자동화 파이프라인

flowchart TD
    A([develop 푸시]) --> B[개발 통합]
    B --> C[develop→main 릴리스 PR]
    C --> D["PR 내 버전 확정<br/>커밋 기반 승격 + 태그 + AI 체인지로그"]
    D --> E[자동 머지]
    E --> F["main push → CI/CD 배포<br/>Flutter / Spring / React 등"]
    F --> G([완료])

# 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 가이드를 확인하세요.

지원 프로젝트 타입

댓글 명령어

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

상세: 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

알아둘 것

맞지 않는 경우를 먼저 알려 드립니다.

• GitHub 전용입니다. GitHub Actions와 GitHub 이슈·PR을 전제로 하므로 GitLab 등은 지원하지 않습니다.
• 릴리스는 개발 브랜치 → 기본 브랜치 PR 구조를 전제로 합니다. 브랜치 이름은 version.yml에서 바꿀 수 있지만, 두 브랜치를 나눠 쓰지 않는 저장소에는 맞지 않습니다.
• 이슈·PR 자동화에는 개인 액세스 토큰(PAT) 등록이 필요합니다. 위 설정을 따라 주세요.
• 서버 배포 워크플로우는 SSH로 접속하는 Docker 서버를 전제로 합니다.

문서

전체 문서는 문서 사이트 에서 검색하며 볼 수 있습니다.

• 시작하기
• CLI 레퍼런스
• Agent Skills 가이드
• 버전 관리
• 체인지로그 자동화
• PR Preview
• 이슈 자동화
• SSH + Docker 배포
• Flutter CI/CD
• 트러블슈팅

지원

• Issues — 버그 리포트, 기능 요청
  • 이 레포는 완료된 이슈를 닫지 않고 작업완료 라벨로 표시합니다. 열린 이슈 수가 많아 보이는 이유입니다.
• CONTRIBUTING.md — 기여 가이드
• SECURITY.md — 보안 취약점은 공개 이슈가 아니라 비공개로 신고해 주세요

MIT License