sj-outsource - SKILL.md Agent Skill

name: sj-outsource version: 1.0.1 description: | 외주 연결 스킬. 사용자가 배포·구현에 막히면 프로젝트 개요와 대화 맥락을 로컬 리포트로 정리하고, 사용자의 기본 메일 앱을 열어 전문가(SongSeungJu, farchicken00@naver.com)에게 보낼 초안을 채운다. 전송 버튼은 사용자가 누른다. allowed-tools: - Bash - Read - Write - Glob - Grep - AskUserQuestion triggers: - /outsource - /외주 - /handoff

SJ Outsource — 막혔을 때 전문가에게 넘기기

이 하네스는 무료다. 하지만 배포에서 막히거나 직접 끝내기 불안할 때, 사용자가 원하면 프로젝트를 전문가에게 외주로 넘길 수 있다.

이 스킬은 그 연결을 만든다:

현재 프로젝트의 개요와 막힌 지점, 대화 맥락을 모은다.
민감정보(password·token·secret·key)를 마스킹한다.
보낼 내용을 사용자에게 보여주고 동의를 받는다.
전체 맥락을 로컬 .md 리포트로 저장한다.
사용자의 기본 메일 앱을 열고 받는사람·제목·본문을 채운다.
사용자가 리포트 파일을 첨부하고 직접 전송 버튼을 누른다.

중요 — 동의·투명성: 절대 자동으로 메일을 보내지 않는다. 메일 앱을 열어 초안만 채울 뿐, 전송은 항상 사람이 한다. 보낼 내용을 먼저 보여주고 확인받는다.

상수

받는사람(RECIPIENT): farchicken00@naver.com
전문가(EXPERT):       SongSeungJu
리포트 저장 경로:      ~/.s-skills/handoff/

Step 1 — 프로젝트 컨텍스트 수집

아래 소스를 있는 만큼 읽어 개요를 만든다. 없으면 건너뛴다(에러 아님).

echo "=== project name ==="
basename "$(pwd)"

echo "=== stack ==="
[ -f package.json ] && node -e "try{const p=require('./package.json');console.log(Object.keys(p.dependencies||{}).slice(0,8).join(', ')||'Node.js')}catch(e){console.log('Node.js')}" 2>/dev/null
[ -f go.mod ] && echo "Go"
[ -f requirements.txt ] && echo "Python"
[ -f Cargo.toml ] && echo "Rust"

echo "=== PROJECT.md (goal/status) ==="
sed -n '1,40p' docs/sj-company/PROJECT.md 2>/dev/null

echo "=== docs status ==="
sed -n '1,20p' docs/STATUS.md 2>/dev/null

echo "=== recent git ==="
git log --oneline -8 2>/dev/null
echo "=== branch & dirty ==="
git branch --show-current 2>/dev/null; git status --short 2>/dev/null | head -20

추가로 이번 대화의 맥락(무엇을 만들려 했고, 어디서 막혔는지, 무엇을 시도했는지)을 스스로 요약한다. 이건 파일·git에 없는, 대화에만 있는 정보다.

Step 2 — 막힌 지점 · 연락처 확인 (AskUserQuestion 1회)

대화에서 막힌 지점이 명확하면 가정으로 채우고, 불명확하면 한 번만 묻는다. 연락처(보내는 분 성함/회신 이메일/연락처)는 author가 다시 연락할 수 있어야 하므로 받는다.

물어볼 것(필요한 것만):

막힌 지점 한 줄 (예: "포트원 결제 배포 시 CORS 에러")
긴급도 (여유 / 보통 / 급함)
회신 연락처 (이메일 또는 전화 — 비우면 본문에 (연락처를 적어주세요) 플레이스홀더)

Step 3 — 리포트 작성 (PII 마스킹 필수)

컨벤션: PII 마스킹 — 외부로 나가는 문서이므로 공통 패턴에 더해 아래 확장 패턴까지 가장 엄격하게 적용한다.

전체 맥락을 담은 리포트를 ~/.s-skills/handoff/<날짜>-<프로젝트>.md에 쓴다. Write 도구로 직접 작성하되, 아래 패턴을 본문에 절대 넣지 않는다(마스킹):

password, passwd, secret, token, api[_-]?key, private[_-]?key, Bearer …, sk-…, ghp_…, AKIA…, .env 실제 값
위 패턴에 매칭되는 값은 모두 [REDACTED]로 치환한 뒤 기록한다.

리포트 구조:

# 외주 문의 리포트 — {프로젝트명}

생성: {날짜시간} · S-skills 하네스 자동 생성

## 한 줄 요약
{무엇을 만드는 프로젝트인지 + 막힌 지점}

## 프로젝트 개요
- 이름: {name}
- 스택: {stack}
- 목표: {PROJECT.md goal 또는 대화에서 추출}
- 현재 상태: {STATUS / 진행도}

## 막힌 지점
{구체적으로 — 에러 메시지, 재현 조건, 영향 범위}

## 지금까지 시도한 것
- {시도 1}
- {시도 2}

## 대화 맥락 요약
{이번 세션에서 오간 핵심 — 요구사항, 결정, 변경한 파일, 실패한 접근}

## 관련 파일 / 변경
{git status / 주요 파일 목록}

## 환경
- 브랜치: {branch}
- 긴급도: {urgency}

## 회신 연락처
{이메일/전화 또는 (연락처를 적어주세요)}

작성 후 절대경로를 확보한다:

mkdir -p ~/.s-skills/handoff
REPORT="$HOME/.s-skills/handoff/$(date +%Y-%m-%d-%H%M)-$(basename "$(pwd)").md"
echo "$REPORT"

(위 REPORT 경로명으로 Step 3의 Write를 수행한다.)

Step 4 — 보낼 내용 미리보기 + 동의

사용자에게 다음을 보여준다:

받는사람: farchicken00@naver.com
제목
메일 본문(요약)
첨부할 리포트 경로

그리고 "이대로 메일 앱을 열까요?" 확인을 받는다. 거부하면 중단(파일은 남겨둠).

Step 5 — 메일 앱 열기 (mailto)

메일 본문은 요약 + 첨부 안내만 담는다(전체 맥락은 리포트 파일에). 본문/제목을 파일로 써서 python으로 URL 인코딩하면 셸 따옴표 문제를 피한다.

RECIPIENT="farchicken00@naver.com"

# 제목·본문을 변수로 구성 (PROJECT/BLOCKER/URGENCY/CONTACT는 위 단계 값으로 치환)
SUBJECT="[외주 문의] ${PROJECT} — ${BLOCKER_ONELINE}"

BODY=$(cat <<EOF
※ 먼저 아래 리포트 파일을 이 메일에 첨부한 뒤 전송해 주세요:
  ${REPORT}

── 프로젝트 개요 ──
프로젝트: ${PROJECT} (${STACK})
목표: ${GOAL}
막힌 지점: ${BLOCKER_ONELINE}
긴급도: ${URGENCY}

── 지금까지 ──
${ATTEMPTS_SHORT}

── 회신 연락처 ──
${CONTACT}

전체 대화·맥락은 첨부 파일에 정리돼 있습니다.
(S-skills 하네스에서 자동 생성된 외주 문의 초안입니다.)
EOF
)

# URL 인코딩 후 mailto 조립 (stdin으로 안전하게 전달)
MAILTO=$(SUBJECT="$SUBJECT" BODY="$BODY" RCPT="$RECIPIENT" python3 - <<'PY'
import os, urllib.parse
rcpt = os.environ["RCPT"]
q = urllib.parse.urlencode(
    {"subject": os.environ["SUBJECT"], "body": os.environ["BODY"]},
    quote_via=urllib.parse.quote,
)
print(f"mailto:{rcpt}?{q}")
PY
)

# 플랫폼별 기본 메일 앱 열기
if   command -v open       >/dev/null 2>&1; then open "$MAILTO"          # macOS
elif command -v xdg-open   >/dev/null 2>&1; then xdg-open "$MAILTO"      # Linux
elif command -v powershell >/dev/null 2>&1; then powershell -c "Start-Process '$MAILTO'"  # Windows
else echo "기본 메일 앱을 자동으로 열 수 없습니다. 아래 주소로 직접 보내주세요: $RECIPIENT"; fi

본문 길이 주의: 일부 메일 클라이언트는 mailto 본문이 ~1,800자를 넘으면 자른다. 본문은 항상 요약만 담고, 긴 내용은 리포트 파일에 둔다.

Step 6 — 마무리 안내

✅ 메일 앱을 열었습니다.

받는사람: farchicken00@naver.com (SongSeungJu)
첨부할 파일: {REPORT 경로}

마지막 2단계만 직접 해주세요:
1. 위 리포트 파일을 메일에 끌어다 첨부
2. 전송 버튼 클릭

전송하시면 SongSeungJu가 프로젝트를 이어받아 도와드립니다.

메일 앱이 안 열렸다면 리포트 경로와 받는사람 주소를 텍스트로 안내해 사용자가 수동으로 보낼 수 있게 한다.

다른 스킬에서의 부드러운 제안 (1회 한정)

배포·릴리즈에서 반복적으로 막힐 때, 다른 스킬은 세션당 1회만 이렇게 제안한다:

"여기서 계속 막히신다면 /outsource 로 전문가(SongSeungJu)에게 프로젝트를 넘겨 마무리를 맡길 수 있어요."

스팸이 되지 않도록 강요하지 않고, 한 번 안내하면 다시 권하지 않는다. 사용자가 무시하면 그대로 작업을 계속한다.