foundation-models-on-device
작성자 affaan-mfoundation-models-on-device는 iOS 26+에서 Apple FoundationModels 기능을 구현할 수 있도록 도와줍니다. 온디바이스 텍스트 생성, @Generable 기반 가이드 출력, tool calling, snapshot streaming, 그리고 프라이버시 우선 앱을 위한 사용 가능성 확인까지 지원합니다.
이 스킬은 100점 만점에 78점으로, 실용적인 Apple FoundationModels 온디바이스 가이드를 찾는 디렉터리 사용자에게 충분히 유망한 목록입니다. 저장소에는 설치를 정당화할 만한 워크플로 콘텐츠가 담겨 있지만, 플랫폼별 제약과 자동화된 도우미 스크립트가 없다는 점은 감안해야 합니다.
- Apple Intelligence의 온디바이스 활용 사례를 위한 명확한 적용 대상이 있으며, 텍스트 생성, 구조화된 출력, tool calling, streaming까지 포괄합니다.
- 운영 가이드가 구체적입니다. 높은 수준의 설명에 그치지 않고 사용 가능성 확인과 예시 Swift 코드가 포함되어 있습니다.
- 본문 콘텐츠와 워크플로/제약 섹션이 충분히 있어 교육 밀도가 높고, 일반적인 프롬프트보다 에이전트 실행에 유리합니다.
- 설치 명령, 스크립트, 지원 파일이 없어 실제 활용은 전적으로 markdown 스킬 내용을 읽는 데 의존합니다.
- 범위가 iOS 26+의 Apple FoundationModels로 매우 좁아, 해당 환경에서 작업하는 에이전트에만 유용합니다.
foundation-models-on-device 스킬 개요
foundation-models-on-device가 하는 일
foundation-models-on-device 스킬은 iOS 26+에서 로컬로 실행되는 Apple FoundationModels 기능을 설계하고 구현하는 데 도움을 줍니다. 사용자 데이터를 클라우드 모델로 보내지 않고도 텍스트 생성, @Generable을 활용한 구조화된 출력, 툴 호출, 스냅샷 스트리밍이 필요한 앱에 특히 적합합니다.
누가 사용해야 하나요
iPhone 또는 iPad용 AI 기능을 만들고 있고, 프라이버시, 오프라인 복원력, 또는 Apple Intelligence 통합이 필요하다면 foundation-models-on-device 스킬을 사용하세요. 앱 쪽에서 어떤 계약이 필요한지 먼저 이해한 뒤 서버 로직을 붙이고 싶은 제품 팀, iOS 엔지니어, 백엔드 관점 개발자에게 잘 맞습니다.
도입 전에 무엇을 확인해야 하나요
핵심 판단 기준은 디바이스와 OS 지원입니다. 이 워크플로는 Apple Intelligence 사용 가능 여부와 iOS 26+의 FoundationModels 프레임워크에 의존합니다. 폭넓은 디바이스 커버리지, 클라우드 폴백, 모델에 구애받지 않는 프롬프트 도구가 필요하다면, 이 스킬은 전체 해법이 아니라 솔루션의 한 부분만 다루게 됩니다.
foundation-models-on-device 스킬 사용 방법
설치하고 올바른 파일 열기
다음 명령으로 foundation-models-on-device 스킬을 설치하세요:
npx skills add affaan-m/everything-claude-code --skill foundation-models-on-device
먼저 SKILL.md부터 열고, 코드를 수정하기 전에 파일 전체를 읽으세요. 이 repo에는 추가 스크립트나 참고용 폴더가 없으므로, 스킬 내용 자체가 사실상의 기준 문서입니다.
대략적인 목표를 실제로 쓸 수 있는 프롬프트로 바꾸기
foundation-models-on-device 사용은 기능, 입력 형태, 기대 출력 형태를 분명히 적을 때 가장 잘 동작합니다. 예를 들어 “지원 가능 여부를 확인하고, 지원될 때만 세션을 시작하며, 작업 노트용 구조화된 JSON 유사 출력을 반환하는 SwiftUI 화면”처럼 요청하세요. 이 방식은 “앱에 AI를 추가해줘”보다 훨씬 낫습니다. 이 스킬이 지원 가능 여부 확인, 세션 설정, 구조화 생성, 스트리밍을 중심으로 설계되어 있기 때문입니다.
스킬을 구현 방식에 맞춰 연결하기
foundation-models-on-device를 백엔드 개발 관점에서 볼 때 유용한 사고방식은 계약 우선입니다. 주변 API를 설계하기 전에, 앱이 무엇을 생성·검증·스트리밍해야 하는지 먼저 정의하세요. 이미 백엔드 엔드포인트가 있다면, 온디바이스 모델을 초안 작성, 요약, 분류, UI 보조 중 어디에 쓸지 정하고 서버의 역할은 좁게 유지하세요.
먼저 이 패턴부터 읽기
우선순위는 스킬의 핵심 패턴입니다: 사용 가능 여부 확인, 기본 세션 흐름, @Generable을 활용한 가이드형 생성, 툴 호출. 이 부분들은 foundation-models-on-device 가이드에서 신호가 가장 높은 영역입니다. 해당 코드가 지원 디바이스에서 실제로 동작하는지, 그리고 출력이 프로덕션에서 쓸 수 있을 만큼 구조화되어 있는지를 결정하기 때문입니다.
foundation-models-on-device 스킬 FAQ
foundation-models-on-device는 iOS 앱에만 해당하나요?
네. 이 스킬은 Apple의 온디바이스 FoundationModels 프레임워크를 중심으로 구성되어 있어, 주로 iOS 26+ 앱 개발에 관련됩니다. 웹, Android, 서버 측 LLM 지원이 필요하다면 다른 스킬을 사용하세요.
Apple Intelligence를 켜야 하나요?
대체로 그렇습니다. foundation-models-on-device 스킬에서 가장 먼저 확인하는 것 중 하나가 모델 사용 가능 여부입니다. 기기가 지원 대상이 아니거나, Apple Intelligence가 꺼져 있거나, 모델이 아직 다운로드 중이면 기능을 사용할 수 없을 수 있기 때문입니다.
일반 프롬프트와 무엇이 다른가요?
일반 프롬프트는 모델에게 무엇을 할지 지시합니다. 반면 foundation-models-on-device 스킬은 구현 경로를 알려줍니다. 언제 활성화할지, 사용 가능 여부를 어떻게 게이트할지, @Generable로 출력을 어떻게 맞출지, 온디바이스에서 어떻게 안전하게 스트리밍하거나 툴을 호출할지를 다룹니다.
초보자도 쓰기 쉬운가요?
기본적인 Swift 또는 SwiftUI를 알고 있다면 초보자도 접근할 수 있습니다. 다만 앱 아키텍처를 아직 배우는 중이라면 적합도가 떨어집니다. 어려운 부분은 프롬프트 자체가 아니라, 모델 사용 가능 여부, 구조화된 응답, UI 상태를 올바르게 통합하는 일이기 때문입니다.
foundation-models-on-device 스킬 개선 방법
해야 할 일을 정확히 지정하기
입력이 좋을수록 결과도 좋아집니다. 막연한 “AI 채팅” 대신, 사용자 동작과 결과를 구체적으로 적으세요. 예를 들어 “메모를 세 개의 bullet로 요약하기”, “영수증에서 필드 추출하기”, “캘린더 데이터에 접근하는 툴을 써서 답장 초안 작성하기”처럼 요청하는 편이 좋습니다.
제약 조건을 먼저 밝히기
대상 디바이스, 최소 OS, 오프라인 동작 필요 여부, 구조화 출력 필요 여부를 미리 적으세요. 이런 제약은 foundation-models-on-device에서 중요합니다. 기능이 아예 노출되어야 하는지, 그리고 구현이 일반 생성, @Generable, 툴 호출 중 무엇을 써야 하는지를 바꾸기 때문입니다.
잘되는 경로만 말하지 말고 실패 경로도 요청하기
이 스킬은 사용 가능 여부 처리, 폴백 UI, 입력 검증을 한 번에 요청할 때 가장 강합니다. 좋은 반복 요청은 “지원 디바이스 흐름과 함께, 미지원·비활성·준비 안 됨 상태까지 포함해 달라”처럼 적어, 데모용이 아니라 실제 출시 가능한 결과를 얻는 방식입니다.
생성된 코드는 모델 경계를 기준으로 검토하기
가장 흔한 실패는 온디바이스 모델이 제품 로직까지 대체할 수 있다고 가정하는 것입니다. 이 스킬은 초안 작성, 추출, UI 보조를 개선하는 데 활용하고, 인증, 저장, 핵심 비즈니스 규칙은 모델 경로 밖에 두세요.