🧰 hoonse-claude-plugins
코드 생성 및 코드 설명을 위한 개인용 Claude Code 플러그인 마켓플레이스
💁 개요
graph LR
A[hoonse-claude-plugins] --> B[.claude]
B --> B1[마켓플레이스 개발 시 사용되는<br/>claude 설정 및 리소스]
A --> C[plugins]
C --> D[claude-logger]
D --> D1[도구 사용 및 프롬프트<br/>자동 로깅]
C --> F[technical-writing]
F --> F1[기술 문서 작성 전문 에이전트와<br/>README 구조 규약 제공]
C --> G[git-workflow]
G --> G1[로컬 Git 워크플로우 규약<br/>관리]
C --> H[github-workflow]
H --> H1[GitHub Issue 기반<br/>개발 워크플로우 자동화]
C --> I[backend]
I --> I1[RESTful API 설계 규약과<br/>FastAPI 백엔드 개발 전문 에이전트]
C --> J[data-engineering]
J --> J1[Apache Airflow DAG 개발<br/>전문 에이전트]
C --> K[project-analyzer]
K --> K1[프로젝트 구조·문서 품질·<br/>설정 정합성 자동 분석 및<br/>GitHub Issue 등록]
✨ 핵심 워크플로우
이 마켓플레이스의 가장 큰 특장점은 개발 워크플로우 전체를 자동화하는 오케스트레이션 스킬입니다.
Issue 분석부터 브랜치 생성, 구현, 커밋, PR 생성까지 하나의 스킬 호출로 처리할 수 있습니다.
| 스킬 | 플러그인 | 설명 |
|---|
| work-on-issue | github-workflow | GitHub Issue 번호를 받아 이슈 분석 → 브랜치 생성 → 계획 수립 → 구현 및 커밋 → PR 생성까지 전체 워크플로우를 오케스트레이션합니다. |
| work-from-scratch | github-workflow | Issue 없이 작업 설명을 받아 브랜치 생성부터 PR 생성까지 전체 워크플로우를 오케스트레이션합니다. |
| work-on-pr | github-workflow | GitHub PR 번호를 받아 리뷰 분석 → 피드백 반영 커밋 → PR 코멘트 작성까지 리뷰 대응 워크플로우를 오케스트레이션합니다. |
| analyze-project | project-analyzer | 플러그인 마켓플레이스 프로젝트를 자동 분석하여 구조·문서·설정 문제를 파악하고, 필요 시 GitHub Issue로 등록합니다. |
아래 차트는 각 오케스트레이션 스킬의 단계별 실행 흐름을 보여줍니다.
graph TB
subgraph WOI ["/work-on-issue (github-workflow)"]
direction TB
WOI1["① @issue-fetcher"]
WOI2["② @branch-creator"]
WOI3["③ Plan Mode"]
WOI4["④ 코드 구현\n+ @auto-committer"]
WOI5["⑤ git push\n+ @pr-creator"]
WOI1 --> WOI2 --> WOI3 --> WOI4 --> WOI5
end
subgraph WOP ["/work-on-pr (github-workflow)"]
direction TB
WOP1["① @pr-fetcher"]
WOP2["② 브랜치 체크아웃"]
WOP3["③ Plan Mode"]
WOP4["④ 코드 수정\n+ @auto-committer"]
WOP5["⑤ git push\n+ gh pr comment"]
WOP1 --> WOP2 --> WOP3 --> WOP4 --> WOP5
end
subgraph WFS ["/work-from-scratch (github-workflow)"]
direction TB
WFS1["① 작업 정의"]
WFS2["② @branch-creator"]
WFS3["③ Plan Mode"]
WFS4["④ 코드 구현\n+ @auto-committer"]
WFS5["⑤ git push\n+ @pr-creator"]
WFS1 --> WFS2 --> WFS3 --> WFS4 --> WFS5
end
subgraph ANAP ["/analyze-project (project-analyzer)"]
direction TB
ANAP0["① 분석 범위 결정"]
ANAP1["② 병렬 분석"]
ANA1["@structure-analyzer"]
ANA2["@docs-analyzer"]
ANA3["@settings-analyzer"]
ANAP2["③ 종합 리포트 작성"]
ANA4["④ @issue-creator\n(선택)"]
ANAP0 --> ANAP1
ANAP1 --> ANA1
ANAP1 --> ANA2
ANAP1 --> ANA3
ANA1 --> ANAP2
ANA2 --> ANAP2
ANA3 --> ANAP2
ANAP2 -. "개발자 승인 후" .-> ANA4
end
classDef plan fill:#fef9c3,stroke:#ca8a04,color:#713f12
class WOI3,WOP3,WFS3 plan
위 오케스트레이션 스킬들은 브랜치 생성(해당되는 경우) 및 커밋 단계에서 git-workflow 플러그인의 에이전트를 활용합니다.
graph LR
WOI["/work-on-issue"] -->|사용| BC
WFS["/work-from-scratch"] -->|사용| BC
WOI -->|사용| AC
WOP["/work-on-pr"] -->|사용| AC
WFS -->|사용| AC
subgraph GW ["git-workflow 플러그인"]
BC["@branch-creator"]
AC["@auto-committer"]
end
💾 설치 방법
이 마켓플레이스 프로젝트에서 제공하는 플러그인을 사용하려는 프로젝트의 루트 디렉토리에서 아래 명령어를 실행합니다.
GitHub에서 추가
# 마켓플레이스 등록
/plugin marketplace add iamhoonse-dev/hoonse-claude-plugins
# 플러그인 설치
/plugin install git-workflow@hoonse-claude-plugins
로컬 경로에서 추가
# 마켓플레이스 등록
/plugin marketplace add /path/to/hoonse-claude-plugins
# 플러그인 설치
/plugin install git-workflow@hoonse-claude-plugins
🧑💻 사용 예시
📖 Skills
Skills는 /<plugin-name>:<skill-name> 형태로 호출합니다.
commit-message (git-workflow)
with plugin namespace
/git-workflow:commit-message
without plugin namespace
/commit-message
🤖 Agents
Agents는 대화 중 관련 요청 시 자동으로 활성화되거나, 직접 요청할 수 있습니다.
auto-committer (git-workflow)
with plugin namespace
@git-workflow:auto-committer 변경사항을 커밋해 줘
without plugin namespace
변경사항을 커밋해 줘
🛠️ 플러그인 목록