Hyperithm: SubAgent · Custom Slash Commands · Hooks · GitHub Actions를 한 워크플로우로

배경

한국 핀테크 Hyperithm 박철완 엔지니어가 사내 Claude Code 도입을 위해 정리한 심화 가이드.

접근

SubAgent는 자동 위임보다 @ 명시 호출 권장(컨텍스트 오염 방지). Custom Slash Commands는 ~/.claude/commands/에 마크다운으로 — $ARGUMENTS와 bash 출력 사용 가능. Hooks는 도구 실행 전 보안 스크립트로 디렉토리 traversal·위험 명령·민감 파일 차단. GitHub Actions에 @claude 멘션을 트리거로 자동 PR 리뷰·기능 구현. Super Claude로 사전 빌드된 명령어와 페르소나 도입.

결과

서브에이전트 + 슬래시 명령 + 훅 + GitHub Actions가 결합된 안전한 사내 워크플로우 확보.

교훈

자동 위임 대신 명시 호출, 도구 실행 전 차단 훅, 그리고 GitHub Actions까지 통합해야 사내 도입의 보안 요구를 만족시킨다.

원문 인용

“도구 사용 전 실행되는 보안 스크립트” 의역: 훅은 도구 사용 전에 실행되어 위험 명령을 차단하는 보안 스크립트다.