SwiftUI API 업데이트
Apple의 개발자 문서(WWDC 세션 포함)를 Sosumi MCP를 통해 체계적으로 스캔하여 더 이상 사용되지 않는 SwiftUI API와 그 최신 대체 API를 식별하고, swiftui-expert-skill/references/latest-apis.md를 업데이트합니다.
필수 조건
- Sosumi MCP가 활성화되고 사용 가능해야 함 (
searchAppleDocumentation,fetchAppleDocumentation,fetchAppleVideoTranscript,fetchExternalDocumentation제공) - 이 저장소(또는 포크)에 대한 쓰기 권한
워크플로우
1. 현재 적용 범위 이해
swiftui-expert-skill/references/latest-apis.md를 읽어 다음을 파악합니다:
- 이미 문서화된 사용 중단 → 최신 전환 목록
- 사용 중인 버전 세그먼트(iOS 15+, 16+, 17+, 18+, 26+)
- 하단의 빠른 조회 테이블
2. 스캔 매니페스트 로드
references/scan-manifest.md(이 스킬 기준 상대 경로)를 읽습니다. 여기에는 스캔할 API 영역, 문서 경로, 검색 쿼리 및 WWDC 비디오 경로의 분류 목록이 포함되어 있습니다.
3. Apple 문서 스캔
매니페스트의 각 카테고리에 대해:
searchAppleDocumentation을 호출하여 나열된 쿼리로 관련 페이지를 검색합니다.fetchAppleDocumentation을 호출하여 특정 문서 경로로 전체 API 세부 정보를 가져옵니다.- 사용 중단 알림, "Deprecated" 레이블 및 "Use ... instead" 지침을 찾습니다.
- 최신 대체 API가 사용 가능해진 iOS 버전을 기록합니다.
- 선택적으로 API 변경 사항을 발표하는 WWDC 세션에 대해
fetchAppleVideoTranscript를 호출합니다.
관련 검색은 효율성을 위해 함께 배치합니다. latest-apis.md에 아직 없는 새로운 사용 중단을 찾는 데 집중합니다.
4. 비교 및 변경 사항 식별
찾은 내용을 기존 항목과 비교합니다. 결과를 분류합니다:
- 새로운 사용 중단:
latest-apis.md에 아직 문서화되지 않은 API - 수정 사항: 업데이트가 필요한 기존 항목(잘못된 버전, 더 나은 대체 API)
- 새로운 버전 세그먼트: 새로운 iOS 버전이 사용 중단을 도입하는 경우 새 섹션 추가
5. latest-apis.md 업데이트
기존 형식을 정확히 따릅니다. 각 항목에는 다음이 포함되어야 합니다:
섹션 배치 -- 올바른 버전 세그먼트 아래에 배치:
- 오래 사용 중단된 API는 "항상 사용(iOS 15+)"
- 버전 제한 변경 사항은 "iOS 16+" / "17+" / "18+" / "26+" 대상 시"
항목 형식:
**`modernAPI()`를 항상 `deprecatedAPI()` 대신 사용하세요.**
\```swift
// 최신
View()
.modernAPI()
// 사용 중단됨
View()
.deprecatedAPI()
\```
빠른 조회 테이블 -- 파일 하단에 행 추가:
| `deprecatedAPI()` | `modernAPI()` | iOS XX+ |
파일 상단의 기여자 표시줄을 유지합니다:
Apple의 문서를 Sosumi MCP를 사용하여 비교한 결과, 사용할 최신 권장 API를 찾았습니다.
6. 풀 리퀘스트 열기
main에서update/latest-apis-YYYY-MM이라는 이름의 브랜치를 생성합니다(현재 연도와 월 사용).swiftui-expert-skill/references/latest-apis.md에 변경 사항을 커밋합니다.gh pr create를 통해 PR을 엽니다:- 제목: "최신 SwiftUI API 업데이트(연월)"
- 본문: 새/변경된 항목 요약, Sosumi MCP에 대한 기여자 정보
Sosumi MCP 도구 참조
| 도구 | 매개변수 | 반환값 |
|---|---|---|
searchAppleDocumentation | query (문자열) | results[]에 title, url, description, breadcrumbs, tags, type이 포함된 JSON |
fetchAppleDocumentation | path (문자열, 예: /documentation/swiftui/view/foregroundstyle(_:)) | 마크다운 문서 내용 |
fetchAppleVideoTranscript | path (문자열, 예: /videos/play/wwdc2025/10133) | 마크다운 대본 |
fetchExternalDocumentation | url (문자열, 전체 https URL) | 마크다운 문서 내용 |
팁
searchAppleDocumentation쿼리로 광범위하게 시작한 다음fetchAppleDocumentation으로 특정 경로를 자세히 살펴보세요.- Apple의 사용 중단 문서는 일반적으로 페이지에 "Deprecated"라고 표시되고 대체 API로 연결됩니다.
- WWDC "What's new in SwiftUI" 세션은 새로 도입된 대체 API의 가장 좋은 소스입니다.
- 사용 중단의 정확한 iOS 버전이 확실하지 않은 경우, 가져온 문서에서 "Availability" 섹션을 확인하여 확인하세요.
- API가 사용 중단되었지만 직접적인 대체 API가 없는 경우, 잘못된 대안을 제안하지 말고 이를 기록하세요.