joinus 스타일 기여 워크플로(PR·머지·리포트·위키·리뷰) 스킬 모음.
빠른 시작 · 구성 · 설치 상세 · 요구사항 · 라이선스
join-us는 joinus 스타일 기여 워크플로를 위한 스킬 6개 모음입니다. PR 컨벤션과 Copilot 재리뷰, 여러 PR의 dev 순차 머지, PR별·월간 리포트, GitHub Wiki 게시, PR 전 코드리뷰를 제공합니다. 설치하면 스킬이 /join-us:<이름> 네임스페이스로 노출되며, 도구에 무관한 스킬이라 Codex CLI에도 설치됩니다.
🧩 범용화 템플릿: 공개본은 특정 저장소·계정·도메인에 묶이지 않도록 식별자를 플레이스홀더(
<OWNER>/<REPO>,<my-gh-login>,<project-domain>)로 일반화했습니다. 본인 프로젝트 값으로 바꿔 쓰세요(아래 ⚙️ 설정). 시크릿·개인 GitHub 핸들(PII)·인프라 ID는 제거돼 있습니다.🔒 제외: 내부 인프라 재현 런북
init-join-us(실 자격증명·인스턴스 ID·내부 토폴로지 포함)는 공개본에 포함되지 않습니다(로컬 전용).
이 저장소 자체가 Claude Code 마켓플레이스(.claude-plugin/marketplace.json)이자 플러그인(.claude-plugin/plugin.json, name join-us)입니다.
npm 패키지(
@kaydash9999/join-us-plugins)와 GitHub 저장소(smallOpenSource/join-us_plugins)는 같은 메인테이너가 관리합니다.
Claude Code: 마켓플레이스로 설치
claude plugin marketplace add smallOpenSource/join-us_plugins
claude plugin install join-us@join-us-pluginsCodex CLI: npm 전역 설치 후 join-us setup
npm i -g @kaydash9999/join-us-plugins
join-us setup --codex설치 후 본인 프로젝트 값을 주입합니다(스킬 동작에 필수).
join-us config --initClaude Code는 스킬을 /join-us:pr-join-us 처럼, Codex는 join-us-pr-join-us 처럼 호출합니다.
⚠️ join-us 스킬은 범용화 템플릿이라 설정 없이는 동작하지 않습니다.config --init을 건너뛰면 스킬이 실행 중 값을 1회 물어봅니다.
| 스킬 | 설명 |
|---|---|
pr-join-us |
PR 컨벤션대로 feature/fix 브랜치 커밋·push, PR 생성/갱신, Copilot 재리뷰 요청([bot] 접미사 노하우). dev/main 직접 push 금지 |
merge_to_dev-join-us |
여러 열린 PR을 dev에 순차 머지 (required CI·stacked PR·change_log 충돌·배포 트리거 처리) |
make-join-us-pr-report |
본인 PR을 GitHub PR 목록(권위 소스) 기준으로 모아 운영자용 처리 리포트(조치일자·문제·증거·리스크·조치)로 작성, index 재생성 |
monthly-report |
한 달 작업을 봉사활동 보고서 양식(5섹션)으로 집계 (사람 worktime 기준) |
post-wiki-join-us |
정본 wiki_docs/를 라이브 GitHub Wiki(.wiki.git 미러)에 게시/갱신 (슬러그 명명·시크릿 스캔·게시 후 재클론 검증) |
review-before-pr-join-us |
PR 전 다국어 코드리뷰(diff 필터·토큰 가드·언어별 rule_docs). alibaba/open-code-review 기반 |
이 스킬들은
git·gh·bash·python3만 쓰는 도구 무관 워크플로라 Claude Code·Codex 양쪽에서 동작합니다.
마켓플레이스 대신 npm으로 전역 설치할 수 있고, Codex CLI에도 스킬을 설치할 수 있습니다.
npm i -g @kaydash9999/join-us-plugins
join-us setup # 대상 플래그가 없으면 Claude Code와 Codex 둘 다
join-us setup --claude # Claude Code만 (마켓플레이스 등록 후 /join-us:*)
join-us setup --codex # Codex CLI만 (~/.codex/skills/join-us-*)
join-us doctor # 설치 + 설정 상태 점검
join-us uninstall # 제거--scope project로 프로젝트 로컬(./.codex)에 설치하고,--dry-run으로 미리 볼 수 있습니다.- non-root 전용입니다(전역 sudo 설치 시 root 소유 파일을 방지). postinstall이 없으므로
join-us setup을 직접 실행합니다. - Codex에는 도구 무관 스킬 6개가 설치됩니다(
codex/manifest.json). 스킬은~/.codex/skills/join-us-<name>/에 놓이고, 디렉터리명과 일치하도록 프론트매터name:이join-us-<name>으로 재작성되어 Codex가join-us-<name>으로 인식합니다. 이 패키지엔 커맨드가 없어~/.codex/prompts/항목은 0개이며,~/.codex/AGENTS.md는 건드리지 않습니다(omx가 재생성하므로). 재설치할 때마다 기존join-us-*를 먼저 정리하므로 옛 버전이 중복으로 남지 않습니다. - 다른 플러그인(예: banker)과 함께 설치돼도 각자
join-us-*·banker-*접두만 다루므로 서로 간섭하지 않습니다. - Claude Code 세션 안에서는
/plugin marketplace add smallOpenSource/join-us_plugins→/plugin install join-us@join-us-plugins로도 설치됩니다.
스킬 본문은 <OWNER>/<REPO>·<my-gh-login>·<project-root> 같은 플레이스홀더를 씁니다(특정 저장소·계정에 묶이지 않도록 범용화). 실제로 동작시키려면 본인 값을 비공개 설정 파일로 주거나, 스킬이 물어볼 때 답하면 됩니다.
join-us config --init # ~/.config/join-us/config.env 를 템플릿에서 생성 (mode 600)
# 편집해 실제 값 입력: JOINUS_REPO=owner/repo · JOINUS_GH_LOGIN=... · JOINUS_PROJECT_ROOT=... 등
join-us config # 현재 설정 경로 + 설정된 키 확인
join-us doctor # 설치 + 설정 상태 한눈에- 해소 순서(첫 발견 우선):
$JOINUS_CONFIG→./.join-us.env→~/.config/join-us/config.env. - 설정 파일이 없으면 스킬이 1회 질문해 값을 받아 그 세션 동안 사용합니다(인터랙션 폴백).
- 키:
JOINUS_REPO,JOINUS_GH_LOGIN(+_ALT),JOINUS_AUTHOR_NAME,JOINUS_PROJECT_ROOT,JOINUS_WIKI_DOMAIN,JOINUS_TEAM_LOGINS,JOINUS_SECRET_PATTERNS. 템플릿은config/join-us.env.example. ⚠️ 실값 설정 파일은 비공개입니다(별도 관리). 절대 커밋·게시하지 마세요. 공개본엔*.example(플레이스홀더)만 포함됩니다. 번들 스크립트(find_missing_prs.py)는 이 설정을 자동으로 읽고, 미설정 시 안내 후 중단합니다.
- Claude Code (마켓플레이스 설치 경로) 또는 Node.js ≥ 16.7 (npm 전역 설치 경로.
join-usCLI 제공). git·gh(GitHub CLI, 인증 필요)·python3·jq. 스킬이 런타임에 사용합니다.- 본인 프로젝트 설정(위 ⚙️ 설정).
- (선택)
make-join-us-pr-report의 윤문 단계는 humanize-korean 스킬을 사용합니다(없으면 건너뜀).
Claude Code:
claude plugin update join-us # 플러그인 최신화 (재시작 후 적용)
claude plugin marketplace update join-us-plugins # 마켓플레이스 메타 갱신
claude plugin uninstall join-us # 제거npm · Codex:
npm i -g @kaydash9999/join-us-plugins # 최신 버전 설치
join-us setup # 재설치 (기존 join-us-* 정리 후 클린 설치)
join-us uninstall # 제거Codex는 재설치할 때마다 기존 join-us-* 를 먼저 정리하므로 옛 버전이 중복으로 남지 않습니다.
join-us 자체는 MIT (LICENSE). Owner: smallOpenSource.
번들된 코드 (이 패키지가 재배포)
skills/review-before-pr-join-us의rules/·prompts/자산은 alibaba/open-code-review에서 verbatim 복사한 것으로 Apache-2.0(© 2026 Alibaba)입니다. 원본 고지는skills/review-before-pr-join-us/NOTICE에 포함. SKILL.md 파이프라인은 원본 동작을 옮긴 Claude-native 포팅입니다.
아래는 스킬이 런타임에 의존하거나 연동하는 외부 요소로, join-us 가 재배포하지 않으며 각 라이선스·상표는 소유자에게 있습니다.
의존 도구 (사용 시 별도 설치, 라이선스는 각 프로젝트 소유)
- git(GPL-2.0), GitHub CLI
gh(MIT), python3(PSF), jq(MIT), bash. 번들 스크립트find_missing_prs.py(표준 라이브러리만)·post_wiki.sh(bash)는 서드파티 라이브러리를 쓰지 않습니다.
연동·참조
- humanize-korean 스킬:
make-join-us-pr-report의 선택적 윤문 단계에서 사용(없으면 건너뜀).