Skip to content

Latest commit

 

History

History
138 lines (95 loc) · 5.39 KB

File metadata and controls

138 lines (95 loc) · 5.39 KB

gstack-industrial

작업에 가장 적합한 Claude Code 스킬을 자동으로 제안합니다

gstack 위에 얹는 강화 레이어 — 대체가 아님

License: MIT Version Claude Code Bun

Stars Issues

English | 繁體中文 | 简体中文 | 日本語 | 한국어 | Português | Bahasa | Tiếng Việt


이것은 무엇인가요?

Claude Code 스킬을 수백 개 설치했는데 어떤 것을 사용해야 할지 기억이 안 나시나요?

gstack-industrial이 해결해드립니다:

  • 자동 검색 — 설치된 모든 SKILL.md를 스캔하고 라우팅 규칙을 자동 구축
  • 자동 제안 — 메시지와 프로젝트 상태에 기반해 최적의 스킬 추천
  • 사용 피드백 — 수락/거부한 제안을 학습하여 우선순위 자동 조정
  • 시퀀스 학습 — gstack의 timeline을 읽어 다음에 쓸 스킬 예측
  • Repo 모드 인식 — Solo 개발자는 낮은 임계값, collaborative는 높은 임계값 (gstack 경유)
  • 방해 없음 — 정말 유용할 때만 제안, 스팸하지 않음

모든 상태는 로컬에만 저장됩니다. 텔레메트리 없음, 네트워크 호출 없음.


gstack과의 관계

gstack-industrial은 gstack 위의 강화 레이어이지 대체가 아닙니다. gstack 인프라를 재사용합니다:

gstack 제공 gstack-industrial 추가
36+ 스킬 (ship, review, qa, brainstorming 등) 자동 제안: 설치된 모든 스킬
gstack-repo-mode binary (solo/collaborative 감지) Repo 모드 인식 임계값 (gstack 출력 읽기)
timeline.jsonl (스킬 완료 추적) 시퀀스 학습 (gstack timeline 읽어 다음 스킬 예측)
수동 호출 (/ship, /review 등) 능동적 제안 UserPromptSubmit hook 경유

gstack이 필수 — 먼저 gstack을 설치한 후 gstack-industrial을 설치하세요.


빠른 시작

설치 (2분)

# 1. 클론
git clone https://github.com/kevintseng/gstack-industrial.git
cd gstack-industrial

# 2. 자동 설치
bun install

설치 스크립트가 자동으로:

  • skill-router를 ~/.claude/skills/templates/skill-router/에 복사
  • hooks를 ~/.claude/hooks/에 복사
  • 설치된 모든 스킬 스캔, 라우팅 규칙 구축
  • UserPromptSubmit hook 등록 (자동 제안)
  • SessionStart hook 등록 (자동 검색)
  • 기본 설정 파일 생성

설치는 idempotent합니다 — 재실행해도 중복 hook이 생기지 않습니다.

사용 방법

자동 모드 (권장): 아무것도 할 필요 없음, Claude가 적절한 시점에 자동 제안

당신: "이 기능을 어떻게 구현할지 생각해봐야겠어"
Claude 자동 응답:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
💡 @brainstorming 사용을 제안합니다
   구조화된 사고로 아이디어 정리
   ("yes"로 실행, "stop suggesting"으로 비활성화)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

어떻게 제안 내용을 판단하나요?

Smart Router 분석:

  1. 당신의 말 — "brainstorm" → brainstorming 스킬 제안
  2. 프로젝트 상태 — 커밋되지 않은 파일 → code review 제안
  3. 개발 단계 — "merge 준비 완료" → finishing-branch 스킬 제안
  4. Repo 모드 — Solo dev는 낮은 임계값 (60), collaborative는 높은 임계값 (85)
  5. 당신의 이력 — 자주 수락하는 스킬 우선순위 ↑, 거부하는 것 ↓
  6. 스킬 패턴 — 과거 시퀀스에서 다음 스킬 예측 (gstack timeline 경유)

방해 방지:

  • 쿨다운: 5분 내 중복 제안 없음
  • 세션 상한: 세션당 최대 500개 (도달 시 가시적 경고, 조용한 실패 없음)
  • 같은 스킬 3회 연속 제안 없음
  • 피드백 기반: 거부한 스킬 우선순위 점진적 감소

고급 설정 (선택)

~/.claude/config/skill-router.json 편집:

{
  "disabledSkills": ["skill-judge"],
  "repoModeThresholds": { "solo": 60, "collaborative": 85, "unknown": 80 },
  "feedbackBoost": 20,
  "feedbackPenalty": 30,
  "showLimitWarnings": true
}

자세한 내용: INSTALL.md


라이선스

MIT License - LICENSE 참조

감사의 말