К основному содержанию
скилл CX Codex

generating-swift-package-docs — скилл Claude Code: обзор и установка

Скилл generating-swift-package-docs генерирует справочную документацию по Swift-пакетам прямо из DerivedData проекта при анализе незнакомых библиотек.

MIT ★ 233 обновлён 2026-01-18

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineering
Открыть на GitHub

Что делает generating-swift-package-docs

Скилл помогает разбираться с незнакомыми зависимостями в кодовой базе на Swift. Когда в файле встречается непонятный import или возникает вопрос о возможностях конкретного модуля, ассистент не гадает по чужому коду, а формирует точную документацию по API.

Внутри работает скрипт ./scripts/generate_docs.py "<module_name>" "<path_to.xcodeproj>". Он извлекает описания символов из скомпилированных бинарников через утилиту interfazzle, сохраняет результат в кеш и читает готовый файл с выжимкой.

Без предварительной сборки проекта в Xcode генерация не сработает: утилите нужен каталог DerivedData и установленный CLI-инструмент interfazzle.

Какие задачи решает

  • разобрать назначение незнакомого импорта в файле Swift
  • исследовать публичный API стороннего пакета без поиска в браузере
  • извлечь описания символов модуля напрямую из DerivedData

Примеры запросов агенту

  • Что делает импорт import Alamofire в этом проекте?
  • Объясни назначение библиотеки KeychainAccess для проекта MyApp.xcodeproj
  • Сгенерируй документацию по публичным методам модуля Swinject

Как установить generating-swift-package-docs

1Через маркетплейс плагинов

/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineering

Команда ставит плагин swift-engineering целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add johnrogers/claude-swift-engineering --skill generating-swift-package-docs -a claude-code

3Вручную: положить файлы

~/.claude/skills/generating-swift-package-docs/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/generating-swift-package-docs/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о generating-swift-package-docs

Как установить generating-swift-package-docs в Claude Code?

Выполните в терминале команду npx skills add johnrogers/claude-swift-engineering --skill generating-swift-package-docs -a claude-code или добавьте каталог маркетплейса /plugin marketplace add johnrogers/claude-swift-engineering и установите плагин /plugin install swift-engineering@claude-swift-engineering.

Что делает generating-swift-package-docs?

Скилл запускает скрипт генерации API-документации для подключённых Swift-библиотек, читая метаданные скомпилированных модулей.

Что требуется подготовить для корректной работы скилла?

Проект в Xcode нужно собрать хотя бы один раз, чтобы сгенерировалась папка DerivedData, а в системе должен быть установлен CLI-инструмент interfazzle.

Исходный текст

SKILL.md · MIT
---
name: generating-swift-package-docs
description: Use when encountering unfamiliar import statements, exploring dependency APIs, or when user asks "what's import X" or "what does X do". Generates on-demand API documentation for Swift package dependencies.
---

# Swift Package Documentation Generator

Generates API documentation for Swift package dependencies on-demand, extracting symbol information from Xcode's DerivedData to answer "what does this library do?"

## Overview

When exploring unfamiliar dependencies, generate their documentation automatically instead of guessing from code. This tool uses `interfazzle` to extract symbol information from compiled modules.

## How to Use

When asked about an unfamiliar Swift module import:

1. Run: `./scripts/generate_docs.py "<module_name>" "<path_to.xcodeproj>"`
2. Script outputs path to cached documentation file
3. Read the file and provide relevant information

Prerequisites: Project must be built once (DerivedData exists), `interfazzle` CLI installed.

See [reference.md](reference.md) for error handling and details.

© John Rogers (@johnrogers) · MIT · johnrogers/claude-swift-engineering

Похожие скиллы

Все скиллы по теме «Мобильная разработка» →
swift-testing dpearson2699 Пишет тесты на Swift Testing и переводит на них существующие проверки XCTest, подсказывая, что оставить в XCTest и XCUITest. CX Codex +1 4 700установок axiom-apple-docs CharlesWiltgen Скилл axiom-apple-docs находит официальные markdown-руководства Apple и разъяснения ошибок компилятора Swift внутри локального Xcode. CX Codex +1 1 600установок swift-lsp официальный Anthropic Плагин swift-lsp подключает языковой сервер SourceKit-LSP к Claude Code. Помогает агенту точнее разбирать код и типы в проектах на Swift. ★ 47 914звёзд репо apple-docs-index Prisma-Labs-Dev Скилл apple-docs-index для Claude Code помогает находить API SwiftUI, UIKit и SwiftData по локальным индексам документации Apple без лишних поисковых запросов в сеть. CX Codex +1 882установок clerk-swift clerk Скилл clerk-swift для Claude Code настраивает UI аутентификации Clerk в нативных приложениях Swift на iOS и macOS. Помогает внедрить готовые экраны ClerkKitUI или собрать собственный флоу через ClerkKit. CX Codex +1 15 200установок swift-testing-pro Paul Hudson Скилл swift-testing-pro для Claude Code, Codex, Cursor и других агентов: пишет, проверяет и правит тесты на Swift Testing по актуальным API Swift 6.2. Покрывает async-тесты, миграцию с XCTest и новые фичи фреймворка. CX Codex +1 10 900установок

Из того же набора33

Весь набор →
swift-style Скилл swift-style для Claude Code, Codex, Cursor и других платформ ИИ-кодинга, который задаёт стиль Swift-кода: именование, отступы, порядок секций, guard-паттерны. Включается автоматически при работе с .swift-файлами. CX Codex +1 1 500установок restore-snapshot Команда restore-snapshot восстанавливает контекст работы из .claude/snapshot.md, кратко подводит итог и спрашивает, на чём сосредоточиться дальше. Пригодится при переходе между сессиями. CX Codex +1 ★ 233звёзд репо snapshot Команда создаёт краткую выписку о проделанной работе и сохраняет её в файл .claude/snapshot.md. Пригодится, чтобы быстро восстановить контекст в следующей сессии через команду resume-snapshot. CX Codex +1 ★ 233звёзд репо five-whys Правило five-whys проводит разбор первопричины через пять вопросов «почему». Подходит для поиска системной причины сбоя, а не только его симптома. CX Codex +1 ★ 233звёзд репо swift-test-creator Субагент swift-test-creator для Claude Code и Codex пишет юнит- и интеграционные тесты на Swift Testing с @Test, #expect и #require. Создаёт тесты для готовой реализации. CX Codex ★ 233звёзд репо swift-documenter Субагент swift-documenter генерирует и обновляет файлы README и документирующие комментарии в коде на Swift. Пригодится после завершения фичи или при пересмотре документации пакета. CX Codex ★ 233звёзд репо swift-modernizer Субагент swift-modernizer находит устаревшие конструкции Swift и переносит их на async/await, современные API и SwiftUI. Он пригодится при поэтапной модернизации старого кода. CX Codex ★ 233звёзд репо reflect Команда reflect для Claude Code разбирает историю чата и настройки, а затем предлагает правки инструкций, команд и конфигурации. CX Codex +1 ★ 233звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой