Swift와 AI 개발 도구: 이번 주 소식

핵심 요약

1. AskHIG는 질문에 맞는 Human Interface Guidelines 가이드만 에이전트에 제공해, 158개 가이드 전체를 컨텍스트에 넣을 때 발생하는 최대 54만 토큰 사용을 줄이도록 설계됐다.
2. Swift 개발용 에이전트 skill과 테스트 감사 도구가 소개됐고, SF Symbols CLI는 심볼 검색·필터링·내보내기를 지원해 에이전트가 존재하지 않는 심볼을 사용하는 일을 막는다.
3. Xcode 27.1에는 iPhone Duo용 resizability skill이 포함됐으며, Xcode 27.2에는 프로젝트를 에이전트가 다루기 쉬운 JSON 형식으로 변환하는 옵션이 추가됐다.

도입

이번 주 소식은 Swift 개발 에이전트의 컨텍스트를 필요한 정보로 좁히는 도구와 Apple의 Xcode·SF Symbols 지원에 집중한다. AskHIG는 질문에 관련된 HIG 가이드만 전달하고, 여러 Agent Skill은 SwiftUI 코드 작성과 정리, 테스트 개선을 돕는다. Apple 도구 쪽에서는 SF Symbols CLI와 Xcode의 skill 내보내기 및 JSON 프로젝트 형식이 소개됐다.

상세 요약

컨텍스트와 에이전트 지침 관리

글쓴이는 Opus 5.5를 사용하면서 여러 작업을 병렬로 진행하고, 한 프로젝트를 넘어 재사용 가능한 도구와 프레임워크를 만드는 데 집중하게 됐다고 설명한다. 그 사례가 AskHIG CLI와 에이전트 플러그인이다. Human Interface Guidelines(HIG)는 158개 가이드로 구성되어 전체를 제공하면 최대 540,000토큰이 들 수 있다. AskHIG는 에이전트의 질문을 먼저 받아 관련 답을 담은 가이드만 반환한다. 예를 들어 탭 타깃 크기를 물으면 해당 내용이 포함된 가이드를 찾아 전달한다. 글쓴이는 저장소 접근 권한을 요청받아 제공한다고 밝혔으며, 공개 저장소로 배포하지 않는 이유로 Apple과의 문제 가능성을 언급했다.

토큰 사용량을 줄이는 방법은 Claude Code·Codex·Cursor의 토큰 사용량을 줄이는 방법에서 확인할 수 있다. 글쓴이는 해당 글의 기법을 Claude에 적용해 Mac의 공간을 많이 확보했다고 덧붙였다.

Swift 개발용 Agent Skill과 테스트

• Antoine van der Lee의 Swift Concurrency Agent Skill은 글쓴이가 코드 정리 작업에 사용한다고 소개됐다.
• Paul Hudson의 SwiftUI Agent Skill은 최신 API 사용, 성능, 접근성 등 SwiftUI 코드 작성에서 흔한 실수를 찾아 수정하도록 돕는다. 자세한 내용은 SwiftUI Agent Skill 설치와 활용법을 참고할 수 있다.
• 글쓴이는 에이전트가 단위 테스트를 과도하게 작성하고, 상수 문자열이 같은 문자열인지 확인하는 것처럼 쓸모가 적은 테스트도 만든다고 지적한다. 이를 개선하는 도구로 openclaw test-audit skill을 언급한다.

글쓴이는 기본 상태의 에이전트가 좋은 Swift 코드를 항상 작성하는 것은 아니지만, skill과 도구를 조합하고 적절한 컨텍스트를 제공하면 Opus 5.5를 잘 활용할 수 있다고 평가한다. 에이전트가 사람의 피드백 없이 얼마나 오래 작업할 수 있는지를 ‘autonomy radius’라는 표현으로 소개한 글도 함께 언급했다.

Apple 도구의 변화

SF Symbols 27 CLI는 이름·카테고리·코드 포인트로 심볼을 검색하고, 배포 대상 기준으로 필터링할 수 있다. 심볼 이름 변경 정보도 필터에 포함된다. 가중치, 색상, 렌더링 모드를 지정해 PNG 또는 PDF로 내보내는 기능도 제공한다. 글에서는 에이전트가 존재하지 않는 심볼을 선택하지 않도록 하는 용도와 설정 안내가 함께 소개됐다.

Xcode 27의 Agent Skill은 xcrun agent skills export --output-dir <디렉터리> 명령으로 내보낼 수 있다. Xcode 27.1에는 iPhone Duo용 resizability skill이 포함됐다. 기존 skill을 교체하려면 xcrun agent skills export --replace-existing를 실행하고, 에이전트에도 새 skill을 사용하도록 알려야 한다고 설명한다.

프로젝트 형식도 언급됐다. Xcode 27.2에는 프로젝트를 JSON 형식으로 변환하는 옵션이 제공된다. 글쓴이는 Xcode 27.1에서도 새 프로젝트가 JSON 형식으로 생성되는 것을 확인했다고 밝혔다. 원문은 이 형식이 에이전트가 사용하기 더 쉽다고 설명하지만, 변환 절차의 세부 단계는 본문에서 다루지 않는다.

결론

소개된 도구의 공통점은 에이전트가 사용할 맥락과 작업 지침을 구체적으로 관리한다는 것이다. AskHIG는 관련 HIG만 제공하고, SF Symbols CLI는 존재하는 심볼을 확인하게 하며, SwiftUI·Concurrency·테스트 skill은 작업별 지침을 보완한다. Xcode의 skill 내보내기와 JSON 프로젝트 형식도 에이전트 활용에 연결되는 변경 사항으로 제시됐다.