AvdLee/SwiftUI-Agent-Skill

해결하는 문제

이 프로젝트는 AI 코드 도구가 SwiftUI 코드를 작성하고 검토하며 최적화하는 데 도움이 되는 전문가 수준의 안내를 제공합니다. 상태 관리, 뷰 구성, 성능과 관련된 최선의 실천 방법을 구조화된 라이브러리로 제공함으로써 AI 에이전트가 오래된 API나 비효율적인 패턴을 사용하지 않도록 방지합니다.

작동 방식

이 프로젝트는 "에이전트 스킬"(에이전트 스킬 오픈 포맷을 따름)로 패키지되어 있으며, AI 어시스턴트용 이식 가능한 플러그인으로 작동합니다. 에이전트의 컨텍스트 창을 과도하게 확장하지 않고, 필요 시 로드할 수 있는 참조 파일 세트를 제공합니다. 또한 xctrace를 래핑하는 Python 기반 도구 체인도 포함되어 있어, AI 에이전트가 Instruments 트레이스를 기록하고 분석하여 데드락이나 훅킹과 같은 성능 문제를 진단할 수 있습니다.

대상 사용자

• SwiftUI 애플리케이션을 개발하기 위해 AI 코드 어시스턴트(예: Claude Code, Cursor, ChatGPT 등)를 사용하는 개발자 및 팀.
• SwiftUI 뷰와 데이터 흐름을 검토하거나 리팩터링하는 엔지니어.
• SwiftUI에서 리스트, 스크롤, 네비게이션의 성능을 최적화해야 하는 개발자.

주요 특징

• 포괄적인 SwiftUI 커버리지: @Observable, Swift Charts, macOS 멀티윈도우 시나리오, 최신 SDK 27 변경 사항에 대한 안내 포함.
• 자동 성능 분석: AI 에이전트가 .trace 파일을 기록하고 분석할 수 있는 Python 도구 체인을 제공하며, CPU 제한과 메인 스레드 차단 문제를 구분 가능.
• 광범위한 도구 호환성: Claude Code, Cursor, Codex 등 에이전트 플러그인 사양을 지원하는 다른 도구와 호환.
• 요청 시 참조: 모듈식 구조를 사용하여 에이전트는 현재 작업에 필요한 특정 안내만 로드합니다.