From dct-claude-plugin
데이터 컨설팅 팀(DCT) Claude Code 신규 셋업 가이드. Atlassian MCP, SSH 키, gh CLI, 팀 CLAUDE.md/rules 배포를 단계별로 안내한다. AWS/GCP CLI, Slack, RTK 는 선택 단계.
How this skill is triggered — by the user, by Claude, or both
Slash command
/dct-claude-plugin:dct-onboardingThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
`/dct` 커맨드의 백엔드. 신규 팀원이 AI Native 개발 환경에 빠르게 적응하도록 돕는다.
/dct 커맨드의 백엔드. 신규 팀원이 AI Native 개발 환경에 빠르게 적응하도록 돕는다.
settings-example.json 을 에디터로 직접 편집 → 완료 후 jq 로 ~/.claude.json 에 병합jq 병합, 또는 신규 생성 시에만 Write 허용gh 로그인, CLAUDE.md, rules 존재 시 스킵gh CLI + SSH 조합 — GitHub MCP/Docker/PAT 방식은 사용하지 않음온보딩 시작 시 아래를 자동 검사해 체크리스트 형식으로 출력한다. 토큰 값은 절대 출력하지 않고, 키 존재 여부·명령 성공 여부만 확인.
| 항목 | 검사 명령 | ✅ 기준 |
|---|---|---|
| Atlassian MCP | jq '.mcpServers["mcp-atlassian"] // empty' ~/.claude.json | 비어있지 않음 |
| SSH 키 | ls ~/.ssh/*.pub | 1개 이상 존재 |
| gh CLI | gh auth status | Logged in 포함 |
| CLAUDE.md | ls ~/.claude/CLAUDE.md | 파일 존재 |
| rules/ | ls ~/.claude/rules/*.md | wc -l | 8개 이상 |
| AWS CLI | aws sts get-caller-identity | exit code 0 |
| GCP CLI | gcloud auth list --filter=status:ACTIVE --format="value(account)" | 계정 1개 이상 출력 |
| Slack MCP | jq '.mcpServers.slack // empty' ~/.claude.json | 비어있지 않음 |
| RTK | which rtk && rtk --version | 명령 존재 + 버전 출력 |
| RTK hook | jq '.hooks.PreToolUse // empty' ~/.claude/settings.json | grep rtk | rtk 포함 |
uvx 설치 확인 (없으면 brew install uv 또는 pip install uv)settings-example.json 에 JIRA_USERNAME, JIRA_API_TOKEN, CONFLUENCE_USERNAME, CONFLUENCE_API_TOKEN 입력 (사용자 직접)~/.claude.json 백업 (cp … .bak-$(date +%Y%m%d-%H%M%S))jq 로 mcpServers.mcp-atlassian 키만 병합 — hooks, statusLine, enabledPlugins 등 기존 키 보존git checkout settings-example.json 으로 리포 파일 플레이스홀더 복원 (실수 커밋 방지)mcp-atlassian 도구 노출 확인ls ~/.ssh/*.pub)
id_ed25519.pub, id_rsa.pub 등) → 재사용, C 단계로ssh-keygen -t ed25519 -C "$(whoami)@madup-dct" -f ~/.ssh/id_ed25519 (기본 이름 권장, _dct 접미사 강제 아님)gh CLI 인증 상태 확인 (gh auth status)
gh auth login → GitHub.com → SSH → 브라우저 인증Git operations protocol: ssh 확인기존 파일 존재 시 건너뛴다. OMC 등 다른 환경을 이미 설정한 사용자를 보호.
~/.claude/CLAUDE.md 없음 → 플러그인 core/CLAUDE.md 복사~/.claude/CLAUDE.md 있음 → 스킵, 사용자에게 "수동 병합 참고" 안내~/.claude/rules/ 없음 → rules/*.md 8개 복사~/.claude/rules/ 있음 → 파일 단위 검사, 없는 파일만 추가 복사 (기존 덮어쓰기 금지)AWS 리소스 접근이 필요하거나 F 단계 Slack MCP 를 쓸 계획이면 필수 (봇 토큰을 AWS Secrets Manager 에서 가져옴). MCP 는 설치하지 않고 CLI 만 설정 (Claude 가 Bash 로 aws 직접 호출).
aws --version, 없으면 brew install awscli)aws configure — 기본 프로필, 기본 리전 ap-northeast-2 (서울)aws sts get-caller-identity 로 인증 검증데컨팀 GCP 리소스(특히 Cloud Storage) 접근이 필요한 경우만. AWS 와 동일 패턴 — MCP 없이 gcloud CLI 만 설정 (Claude 가 Bash 로 gcloud storage 직접 호출). 전제 조건 없음 (독립).
gcloud CLI 설치 확인 (gcloud --version)
brew install --cask google-cloud-sdk 또는 https://cloud.google.com/sdk/docs/installgcloud auth login → 브라우저에서 @madup.com 구글 계정 로그인gcloud auth application-default login (Python google-cloud-storage 등 SDK 경유 시 필수, gcloud auth login 과 별개 credential)gcloud projects list → gcloud config set project <PROJECT_ID> (프로젝트 자주 전환 시 named configuration 활용)gcloud auth list + gcloud config get-value project + gcloud storage buckets list --limit=5gsutil 대신 gcloud storage 사용 (2~5배 빠름). 서비스 계정 JSON 키 지양 — 개인 계정 인증으로 대체, 키 파일 커밋 금지ls -r / cross-region 전송은 과금 — 테스트는 항상 --limit 사용개인 DM, 채널 조회, 메시지 전송이 필요한 경우만. 공식 @modelcontextprotocol/server-slack + AWS Secrets Manager prod/gen-ai/slack 봇 토큰 사용 (D 단계 AWS CLI 선행 필수).
refresh-slack-token.sh 실행 — aws secretsmanager get-secret-value 로 토큰 fetch 후 jq 로 ~/.claude.json 의 mcpServers.slack 키만 병합npx -y slack-mcp-server 1회 실행 (첫 연결 타임아웃 방지, "Loaded users from cache" 출력 시 Ctrl+C)@매도비 권한 확인 (chat:write, im:write) — private 채널은 /invite @매도비 선행/dct-refresh-slack 로 갱신RTK(Rust Token Killer)는 Bash 명령 출력을 자동 압축해 토큰 소비를 60~90% 줄여주는 CLI 프록시. Claude Code PreToolUse hook 으로 git status → rtk git status 처럼 투명하게 rewrite 한다.
brew install rtk
Homebrew 없으면: curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | shrtk --versionrtk init -g
기존 hook 이 있으면 RTK hook 을 추가 (덮어쓰지 않음)rtk init --show~/.zshrc 에 export RTK_TELEMETRY_DISABLED=1 추가Read, Grep, Glob)에는 영향 없음 — Bash 도구 셸 명령에만 적용jq '.mcpServers | keys' ~/.claude.json 로 MCP 목록 확인 (값은 출력 금지, 반드시 ~/.claude.json 대상)gh auth status 로 GitHub 인증 확인aws sts get-caller-identity 로 인증 확인gcloud auth list + gcloud config get-value project + gcloud storage buckets list --limit=5 로 확인~/.claude/CLAUDE.md 와 ~/.claude/rules/ 존재 확인/dct-plan DCTC-TEST 같은 명령으로 스모크 테스트 (실제 카드가 없어도 MCP 호출 흐름 확인 가능)~/.claude.json 을 Read 도구로 전체 출력 금지 — 토큰이 세션 로그에 남는다. 검증은 jq '.mcpServers | keys' 또는 grep -c 로만cp ~/.claude/settings.json.bak-<ts> ~/.claude/settings.json)settings-example.json 커밋 방지 — 토큰 채운 후 반드시 git checkout settings-example.jsonjq . ~/.claude/settings.json 으로 JSON 문법 검증, uvx 설치 여부, 토큰 유효성 확인gh 인증 실패 → gh auth logout && gh auth login, SSH 키 등록 상태 확인~/.ssh/config 권한(600), ssh -T [email protected] 테스트~/.aws/credentials, ~/.aws/config 직접 확인 (cat 하지 말고 aws configure list 사용해서 값 노출 최소화)gcloud auth list 로 active 계정 확인, 비었으면 gcloud auth login 재실행. SDK 경유 접근 실패면 gcloud auth application-default login 누락 여부 확인. ~/.config/gcloud/ 는 Read/cat 금지 (credentials 유출 방지)# settings.json 백업에서 복구
cp ~/.claude/settings.json.bak-<timestamp> ~/.claude/settings.json
# CLAUDE.md 백업에서 복구
cp ~/.claude/CLAUDE.md.bak-<timestamp> ~/.claude/CLAUDE.md
사용자가 문제 발생 시 즉시 복원할 수 있도록 백업 생성 시점에 정확한 경로를 알린다.
npx claudepluginhub hnjung-madup/dct-plugin --plugin dct-claude-pluginGuides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.