| name | slack |
| description | 현재 진행중인 프로젝트의 Slack 알림을 설정·테스트·확인·해제할 때 사용한다. 활성화 시 작업 완료·사용자 승인 이벤트가 해당 프로젝트 채널로 전송된다. 설정은 `workspace/projects/{PROJECT}/.slack.env` 를 SSOT 로 관리한다. |
현재 진행중인 프로젝트에 Slack 알림을 설정한다.
사용법: $ARGUMENTS
서브커맨드:
| 인자 | 동작 |
|---|
| (없음) | .slack.env 를 생성하고 채널·이벤트를 대화식으로 설정 |
test | 현재 설정으로 테스트 메시지 1건 발송 |
status | .slack.env 존재·필드·gitignore 보호 여부 요약 |
disable | 비활성화 방법 안내 (파일 직접 삭제) |
사용 예:
/pilot:slack
/pilot:slack test
/pilot:slack status
/pilot:slack disable
사전 확인
preamble.md 의 P1 수행.
- P1: 진행중 프로젝트
{PROJECT} 획득. 없으면 messages.md 의 no_active_project 출력 후 종료.
{PROJECT_DIR} = workspace/projects/{PROJECT}.
공통 선행 절차 (모든 서브커맨드)
모든 서브커맨드는 먼저 doctor 로 .gitignore 보호 상태를 점검한다. 누락 시 즉시 주입되므로 secret 이 절대 커밋되지 않도록 보장.
python3 ${CLAUDE_PLUGIN_ROOT}/tools/doctor.py workspace 2>&1 | grep -E "\.gitignore secrets|\[CRITICAL\]" || true
[CRITICAL] 이 출력되면 즉시 중단하고 사용자에게 원문을 그대로 보여준다. 이후 서브커맨드 수행 금지 — 사용자의 git rm --cached + webhook 재발급이 선행되어야 한다..gitignore secrets: 누락 패턴 자동 주입 이 출력되면 사용자에게 "리포 루트 .gitignore 에 .slack.env 가 자동 추가되었습니다. 이 변경을 커밋하세요." 안내.
수행 절차
서브커맨드: (없음) — 활성화
-
{PROJECT_DIR}/.slack.env 존재 여부 확인.
- 있으면: messages.md 의
slack.already_active 출력 후 종료. 파일 편집·slack status·slack disable 을 안내한다.
-
대화식 입력:
- 채널명 (예:
#project-x) — 필수. 빈 값이면 재질의.
- 이벤트 — 기본값
complete,approval. 사용자가 엔터만 치면 기본값 적용. 별도 입력 시 complete·approval 중 쉼표 구분.
-
{PROJECT_DIR}/.slack.env 를 아래 내용으로 Write (파일 퍼미션 0600):
# pilot Slack notifier — do NOT commit
# 리포 루트 .gitignore 에 `.slack.env` 가 있어야 안전합니다.
SLACK_WEBHOOK_URL=
SLACK_CHANNEL={채널명}
SLACK_EVENTS={이벤트목록}
-
퍼미션 설정:
chmod 600 {PROJECT_DIR}/.slack.env
-
git check-ignore {PROJECT_DIR}/.slack.env 실행. exit code ≠ 0 이면 .gitignore 가 제대로 동작하지 않는 것 — 파일을 즉시 삭제하고 slack.tracked_critical 요지의 경고를 출력한 뒤 종료.
-
messages.md 의 slack.activated 를 {채널명}·{이벤트목록}·{파일경로} 로 치환해 출력.
-
사용자에게 "SLACK_WEBHOOK_URL 을 파일에 붙여넣으셨다면 /pilot:slack test 를 실행하세요." 안내.
서브커맨드: test
-
{PROJECT_DIR}/.slack.env 없으면 "활성화된 Slack 설정이 없습니다. /pilot:slack 으로 먼저 활성화하세요." 출력 후 종료.
-
아래 Bash 명령 실행:
python3 ${CLAUDE_PLUGIN_ROOT}/tools/slack-notify.py \
--event approval \
--workspace workspace \
--message "테스트 메시지입니다 (/pilot:slack test)"
-
stderr 가 비어 있으면 messages.md 의 slack.test_ok 출력.
-
stderr 에 내용이 있으면 원문 그대로 출력 + slack.test_fail 의 "원인/재시도" 안내 덧붙이기.
서브커맨드: status
-
아래 항목을 표 1개로 출력:
| 항목 | 상태 |
|---|
.slack.env | 존재 / 없음 (없으면 이후 행 전부 -) |
SLACK_WEBHOOK_URL | 설정됨 / 비어있음 (URL 자체는 출력 금지) |
SLACK_CHANNEL | 값 그대로 |
SLACK_EVENTS | 값 그대로 (빈 값이면 기본값 complete,approval) |
.gitignore 패턴 | ✅ / ❌ (grep -q "^\.slack\.env$" {리포루트}/.gitignore 로 판단) |
| git tracked | 안전 (untracked) / 위험 (tracked) |
판단 명령:
git -C {PROJECT_DIR} ls-files --error-unmatch .slack.env
grep -q "^\.slack\.env$" $(git rev-parse --show-toplevel)/.gitignore
-
git tracked: 위험 이면 messages.md 의 slack.tracked_critical 의 git rm --cached 명령을 실제 경로로 치환해 함께 출력.
서브커맨드: disable
messages.md 의 slack.disable_hint 를 {프로젝트경로} 치환해 출력. Claude 가 직접 rm 을 실행하지 않는다. destructive 조치는 사용자 확인이 필요한 경로.
드리프트 대응
없음. 이 스킬은 .slack.env 를 직접 쓰는 유일 경로이므로 drift 가 발생할 소스가 없다.
