apple-skills

claude-config

Claude Code의 agent / skill 을 여러 맥에서 공유하기 위한 개인 설정 저장소. Swift / iOS (TCA + Clean Architecture) 프로젝트 기준으로 정리되어 있다.

📱 사용 환경

• 타겟 스택: Swift 6, SwiftUI, TCA 1.25+, Tuist 4
• 테스트: Swift Testing (@Test, @Suite)
• DI: WeaveDI 3.4.1
• 네비게이션: TCAFlow @FlowCoordinator
• 사용 프로젝트: Attendance_iOS, Picke-iOS 등

🗂 구성

claude-config/
├── agents/                       # 에이전트
│   ├── code-reviewer.md          # 10년차 시니어 Swift/iOS 리뷰어 (read-only)
│   ├── code-simplifier.md        # 기능 변경 없는 리팩터링
│   ├── test-engineer.md          # Swift Testing 기반 테스트 작성
│   ├── test-auto-pr-agent.md     # 도메인별 자동 테스트 + PR 파이프라인
│   └── ios-performance-optimizer/ # PFW 통합 iOS 성능 최적화
├── skills/                       # 스킬 (자체 + 외부 통합)
│   ├── 자체:                      # commit, tdd
│   ├── 성능/SwiftUI:              # ios-performance, ios-performance-pfw,
│   │                               ios-performance-uikit-guide, swiftui-auditor,
│   │                               swiftui-uikit-interop, swiftui-liquid-glass
│   ├── 아키텍처:                   # tca-optimizer, clean-architecture
│   ├── Swift/iOS 일반:             # swift-ios-skills, ios-uikit-expert,
│   │                               apple-design-system, apple-skills
│   ├── Hudson "Pro" 시리즈 (twostraws):  swiftui-pro, swiftdata-pro,
│   │                                    swift-testing-pro, swift-concurrency-pro
│   ├── Concurrency (AvdLee):       # swift-concurrency
│   ├── 신규 영역:                  # swift-api-design-guidelines,
│   │                                ios-accessibility, swift-security-expert,
│   │                                ios-simulator
│   └── Dimillian/Skills:           # swiftui-ui-patterns, swiftui-view-refactor,
│                                    app-store-changelog, ios-debugger-agent
├── docs/
│   ├── agent/                    # iOS 프로젝트용 가이드 13종 (TCA/SwiftUI/DI/성능/Git/Dev 등)
│   ├── external-swift-agent-skills.md       # twostraws 카탈로그 인덱스
│   └── external-agents-md/SwiftAgents.md    # Hudson AGENTS.md 템플릿
└── ATTRIBUTIONS.md                          # 외부 자산 출처/라이선스

🔌 사용 중인 플러그인

plugins/installed_plugins.json · plugins/known_marketplaces.json 기준. (마켓플레이스 = 설치 소스)

플러그인	마켓플레이스	소스 repo	용도
oh-my-claudecode	omc	Yeachan-Heo/oh-my-claudecode	멀티 에이전트 오케스트레이션(OMC) — autopilot/ultrawork/team 등
superpowers	superpowers-dev	obra/superpowers	스킬 발견/실행 프레임워크
agent-council	team-attention-plugins	team-attention/agent-council	다중 에이전트 합의/심의
developer-kit-typescript	developer-kit	giuseppe-trisciuoglio/developer-kit	NestJS/React/Expo TS 개발 전문 에이전트
warp	claude-code-warp	warpdotdev/claude-code-warp	Warp 터미널 연동
swift-lsp	claude-plugins-official	anthropics/claude-plugins-official	Swift LSP 통합
code-review	claude-plugins-official	〃	코드 리뷰 명령
commit-commands	claude-plugins-official	〃	커밋 자동화 명령
gitlab	claude-plugins-official	〃	GitLab 연동
agent-sdk-dev	claude-plugins-official	〃	Agent SDK 앱 검증
frontend-design	claude-plugins-official	〃	프런트엔드 디자인
figma	claude-plugins-official	〃	Figma 연동 (MCP)

플러그인 소스/캐시(165MB) 는 추적하지 않고 매니페스트 json 만 공유한다. 새 맥에서는 각 마켓플레이스를 추가 후 재설치한다.

🪝 Hooks

hooks/ — Claude Code 훅 스크립트.

훅	설명
session-start.mjs	세션 시작 시 컨텍스트/상태 주입
pre-tool-use.mjs · post-tool-use.mjs	도구 사용 전/후 처리
post-tool-use-failure.mjs	도구 실패 시 후처리
block-dangerous.sh · block-git-push.sh	위험 명령 / git push 차단
auto-format.sh · type-check.sh	저장 후 자동 포맷 / 타입 체크
scripts/sync-skills.sh (Stop 훅)	세션 종료 시 로컬 ~/.claude/skills 변경을 이 repo 로 자동 동기화 (변경 있을 때만 commit+push, .env/node_modules/깨진 symlink 제외)
context-engineering.sh · handoff-on-failure.sh	컨텍스트 엔지니어링 / 실패 핸드오프
keyword-detector.mjs · persistent-mode.mjs · code-simplifier.mjs	키워드 감지 / 지속 모드 / 코드 단순화

⚙️ 전역 설정

• CLAUDE.md — 전역 지침(모델 라우팅 · 토큰 절약 · MCP 자동 사용 규칙 등)
• settings.json — 권한 / 모델 / 훅 / statusline 설정
• mcp_servers.example.json — MCP 서버 설정 예시. 실제 mcp_servers.json(API 키 포함)은 .gitignore 로 제외. 사용 시 복사 후 FIGMA_API_KEY 등 본인 키 입력.

🚀 새 맥에 적용

옵션 A. 복사 (단발성)

git clone [email protected]:Roy-wonji/claude-config.git ~/claude-config
cp -R ~/claude-config/agents/. ~/.claude/agents/
cp -R ~/claude-config/skills/.  ~/.claude/skills/

옵션 B. 심볼릭 링크 (자동 동기화 권장)