s-skill-shiftee

name: s-skill-shiftee version: 1.0.0 description: | 시프티(Shiftee) 근태/휴가 조회 스킬. 첫 호출 시 shiftee CLI를 자동 다운로드하여 휴가 내역, 출퇴근 기록, 스케줄, 누락 조회, 출퇴근 수정 요청 등 근태 관련 질문에 답한다. Use when asked about vacation, attendance, leave, schedule, clock-in/out, 휴가, 출퇴근, 근태, 스케줄, 누락, or anything HR/time-tracking related. allowed-tools: - Bash - Read - AskUserQuestion

시프티 근태/휴가 스킬

shiftee CLI를 사용해서 근태, 휴가, 스케줄 관련 질문에 답한다. 첫 호출 시 GitHub에서 바이너리를 자동으로 캐시한다.

CLI 부트스트랩 (매 호출 시 가장 먼저)

shiftee 바이너리가 캐시되어 있는지 확인하고, 없으면 GitHub에서 한 번 받아 ~/.cache/s-skill-shiftee/shiftee에 저장한다. 이후 모든 명령은 $SHIFTEE 변수로 호출한다.

SHIFTEE=""
for p in \
  "$HOME/.cache/s-skill-shiftee/shiftee" \
  "$HOME/.claude/skills/s-skill-shiftee/shiftee" \
  "./.claude/skills/s-skill-shiftee/shiftee" \
  "$HOME/.agents/skills/s-skill-shiftee/shiftee"; do
  if [ -x "$p" ]; then SHIFTEE="$p"; break; fi
done

if [ -z "$SHIFTEE" ]; then
  mkdir -p "$HOME/.cache/s-skill-shiftee"
  SHIFTEE="$HOME/.cache/s-skill-shiftee/shiftee"
  curl -fsSL https://raw.githubusercontent.com/Salesmap-tech/s-skill/main/bin/shiftee \
       -o "$SHIFTEE" || { echo "shiftee 다운로드 실패 — 네트워크/방화벽 확인"; exit 1; }
  chmod +x "$SHIFTEE"
fi

스킬을 처음 사용하기 전에 한 번 로그인이 필요하다. 로그인 방식은 이메일/비밀번호다 (쿠키 붙여넣기 아님):

$SHIFTEE login

1. 이메일 입력
2. 비밀번호 입력 (getpass — 화면에 표시되지 않음)
3. CLI가 account 토큰 → employee_id → employee 토큰을 자동 발급한다. 여러 회사/직원에 소속된 경우 번호로 선택한다.

로그인은 대화형 입력(input/getpass)을 받으므로 Claude가 Bash 도구로 대신 입력할 수 없다. 사용자가 직접 실행하도록 안내한다 — 프롬프트에 !$SHIFTEE login을 입력하거나 터미널에서 직접 실행하면 된다.

토큰·이메일·계정 정보는 ~/.config/shiftee-cli/config.json (0600)에 저장된다. 비밀번호는 저장하지 않는다 — 로그인 POST에만 일회성으로 쓰인다. account 토큰은 약 5년, employee 토큰은 약 1년 유효하고, employee 토큰이 만료돼 401이 나면 장수명 account 토큰으로 employee 토큰만 자동 재발급하므로 보통은 한 번만 로그인하면 된다. account 토큰까지 만료되면 $SHIFTEE login을 다시 실행한다.

사용 가능한 명령어

질문 유형별 라우팅

"올해 휴가 언제 썼어?" / "휴가 내역"

$SHIFTEE leaves

"휴가 신청해줘" / "6월 15일 연차 써줘" / "내일 반차"

실제 휴가 신청을 회사에 제출하는 동작이다. 신청 전 반드시 사용자에게 날짜·유형(연차/반차)·반차일 경우 오전/오후·사유를 확인하고, AskUserQuestion으로 최종 승인을 받은 뒤 실행한다.

$SHIFTEE leave --list                              # 어떤 유형이 있는지 먼저 확인
$SHIFTEE leave 2026-06-15 --type 연차 -n "사유"     # 종일 연차
$SHIFTEE leave 2026-06-16 --type 반차 --half am     # 오전 반차 (09:00~13:00)
$SHIFTEE leave 2026-06-16 --type 반차 --half pm     # 오후 반차 (14:00~18:00)
$SHIFTEE leave 2026-06-15 --start 13:00 --end 17:00 # 시간 직접 지정

• 휴가 유형(연차/반차 등)·유급시간·차감량은 과거 휴가 기록에서 자동 수집한다. 기록이 없으면 leave --list가 비어 있을 수 있다.
• 오전 반차는 09:0013:00, 오후 반차는 14:0018:00 KST가 기본값이다. 회사 근무시간이 다르면 --start/--end로 직접 지정한다.

"오늘 출퇴근 했어?" / "오늘 근무"

$SHIFTEE today

"이번 달 출퇴근 기록" / "3월 근태"

$SHIFTEE attendance          # 이번 달
$SHIFTEE attendance -m 3     # 특정 월

"이번 주 스케줄" / "이번 달 스케줄"

$SHIFTEE schedule            # 이번 주
$SHIFTEE schedule --month    # 이번 달

"출퇴근 누락된 거 있어?"

$SHIFTEE missing

"출근/퇴근 수정해줘"

수정 요청 전 반드시 사용자에게 날짜와 시간을 확인한다.

$SHIFTEE fix clock-in 2026-04-15 09:30
$SHIFTEE fix clock-out 2026-04-15 18:00
$SHIFTEE fix create 2026-04-15 09:30 --time2 18:00 -n "사유"

응답 가이드

• CLI 출력을 그대로 붙여넣지 말고, 사용자가 이해하기 쉽게 요약해서 답한다.
• 휴가 기록은 날짜, 유형(연차/반차/병가 등), 사유를 표 형태로 정리한다.
• 출퇴근 기록도 날짜별로 깔끔하게 정리한다.
• fix·leave 명령은 실제 요청을 회사에 제출하므로, 실행 전 반드시 사용자 확인을 받는다. AskUserQuestion으로 최종 승인 후 실행.
• 휴가 신청 시 날짜·유형·반차 오전/오후·사유를 명확히 확인한다. 유형이 불확실하면 먼저 leave --list로 사용 가능한 유형을 보여준다.
• "설정 파일이 없습니다" 에러가 나면 아직 로그인 전이다. 대화형 로그인이므로 사용자에게 !$SHIFTEE login을 직접 실행하라고 안내한다 (Claude가 비밀번호를 대신 입력할 수 없음).

$ARGUMENTS