ship

Agent Plugins

Claude Code/Codex에서 함께 사용할 수 있는 플러그인/스킬 저장소입니다.

설치

Skills (권장, Claude Code + Codex 공용)

# 모든 스킬 설치
npx skills add october-academy/agent-plugins -a claude-code -a codex --skill '*' -y

# 특정 스킬만 설치 (예: cp)
npx skills add october-academy/agent-plugins -a claude-code -a codex --skill cp -y

Claude Plugin Marketplace (Claude Code 전용)

# 마켓플레이스 추가 및 플러그인 설치
claude plugin marketplace add october-academy/agent-plugins
claude plugin marketplace update
claude plugin install <plugin-name>@agent-plugins

기존 사용자 마이그레이션 (@october-plugins -> @agent-plugins)

# 1) 새 마켓플레이스 등록
claude plugin marketplace add october-academy/agent-plugins
claude plugin marketplace update

# 2) 플러그인 재설치 (예: cp)
claude plugin install cp@agent-plugins

호출 방식

플러그인 스킬은 /플러그인명 또는 /플러그인명:스킬명으로 호출합니다.

/clarify:vague         # 요구사항 명확화
/clarify:unknown       # 전략 맹점 4분면 분석
/clarify:metamedium    # 내용 vs 형식 의사결정
/simplify              # 코드 단순화
/wrap                  # 세션 마무리
/feature-dev           # 기능 개발 워크플로우
/git:push              # git push (다중 명령어 플러그인)

단축형 조건: 플러그인에 스킬이 1개이고, 스킬 이름 = 플러그인 이름이면 단축형 사용 가능 clarify는 3개 스킬(vague, unknown, metamedium)이 있어 /clarify:스킬명 형식 사용

플러그인 목록

플러그인	설명	호출 방식
clarify	3가지 렌즈로 요구사항/전략/형식 의사결정 명확화	/clarify:vague, /clarify:unknown, /clarify:metamedium
cp	커밋 & 푸시 한 번에	/cp
deploy	Railway, Cloudflare 통합 배포	/deploy
feature-dev	7단계 체계적 기능 개발 워크플로우	/feature-dev
frontend-design	고품질 프론트엔드 인터페이스 생성	/frontend-design (자동)
git	Git 커밋, 푸시, PR 자동화	/git:push, /git:push-pr
interview-spec	요구사항 수집용 인터뷰 프롬프트 생성	/interview-spec (자동)
linear	Linear 이슈 트래킹 통합 (MCP)	-
opsx	OpenSpec ship 워크플로우 (implement → verify → fix → archive)	/opsx:ship
perf	성능 측정 (Lighthouse/Core Web Vitals)	/perf
simplify	코드 단순화 및 정제	/simplify
sync	원격 저장소 동기화 (git pull)	/sync
typescript-lsp	TypeScript/JS 언어 서버 (MCP)	-
web-perf-ux	웹 성능 및 UX 최적화 분석	/web-perf-ux (자동)
wrap	세션 마무리 및 문서화	/wrap

---

상세 설명

clarify

모호함을 다루는 3가지 스킬을 제공합니다.

/clarify:vague "로그인 기능 추가"
/clarify:unknown "Q2 성장 전략 점검"
/clarify:metamedium "열심히 하는데 성과가 안 나옴"

• vague: 요구사항 명확화 (가설 옵션 질문, Before/After 요약)
• unknown: Known/Unknown 4분면 기반 전략 맹점 분석
• metamedium: 내용(content) vs 형식(form) 레버리지 판단
• 참고 저장소: https://github.com/team-attention/plugins-for-claude-natives

---

cp

커밋과 푸시를 한 번에 수행합니다.

/cp                        # 자동 커밋 메시지 생성
/cp "fix: 버그 수정"        # 메시지 지정

• Conventional Commits 형식
• 민감한 파일 자동 감지 (.env 등)
• Co-Authored-By 자동 추가

---

deploy

Railway, Cloudflare Pages/Workers 통합 배포.

/deploy              # 전체 배포
/deploy railway      # Railway만
/deploy cf           # Cloudflare Workers만

• 사전 체크: 커밋되지 않은 변경사항 확인
• 배포 후 상태 리포트

---

feature-dev

7단계 기능 개발: Discovery → Codebase Exploration → Clarifying Questions → Architecture Design → Implementation → Quality Review → Summary

/feature-dev OAuth 인증 추가

에이전트: code-explorer, code-architect, code-reviewer

---

frontend-design

고품질 프론트엔드 UI 생성. 프론트엔드 작업 시 자동 적용.

• 독특한 타이포그래피/색상
• 하이 임팩트 애니메이션
• 프로덕션 레디 코드

---

git

Git 커밋/푸시/PR 자동화. Conventional Commits 형식.

/git:push                              # 자동 메시지, main에 push
/git:push "fix: bug" --branch hotfix   # 특정 브랜치에 push
/git:push-pr                           # push 후 PR 생성
/git:push-pr "feat: new" --base dev    # dev 기준 PR

---

interview-spec

Claude가 작업 전 요구사항을 수집하도록 인터뷰 프롬프트 생성.

트리거: "Help me write a prompt for...", "I'm not sure what I want yet"

---

linear

Linear 이슈 트래킹 MCP 통합. 이슈 생성/관리, 상태 업데이트, 워크스페이스 검색.

---

opsx

OpenSpec 확장 — 팀 기반 ship 워크플로우. Claude Code(leader) + Codex(reviewer) dual verification.

/opsx:ship [change-name]

• 5단계 사이클: Implement → Dual Verify → Fix Loop (max 3) → Archive → Cleanup
• 멀티 에이전트: implementer(구현) + reviewer(코드 리뷰) + leader(검증/오케스트레이션)
• 전제 조건: OpenSpec CLI, Codex CLI 설치 필요

---

perf

빠른 성능 측정. Lighthouse/Core Web Vitals 기반.

/perf                # 메인 페이지 측정
/perf /about         # 특정 경로
/perf --all          # 주요 페이지 일괄 측정

• LCP, CLS, INP 핵심 지표
• web-perf-ux의 간소화 버전

---

simplify

코드 단순화. 기능은 유지하고 구현만 개선.

/simplify                 # 최근 수정 코드
/simplify src/utils.ts    # 특정 파일

원칙: 명확성 > 간결성, 중첩 삼항 금지, Opus 모델

---

sync

원격 저장소 동기화 (git pull) 단축 명령어.

/sync              # origin main에서 pull
/sync develop      # 특정 브랜치

• 작업 중인 변경사항 있으면 경고
• 충돌 발생 시 해결 도움

---

typescript-lsp