wiki-qa
Получайте мгновенные ответы о вашей кодовой базе
Прекратите искать по файлам, чтобы понять, как работает ваш код. Этот навык читает ваш исходный код и предоставляет ответы, основанные на доказательствах, со встроенными ссылками на конкретные файлы и номера строк.
Скачать ZIP навыка
Загрузить в Claude
Перейдите в Settings → Capabilities → Skills → Upload skill
Включите и начните использовать
Протестировать
Использование «wiki-qa». How does the data validation work?
Ожидаемый результат:
Валидация данных выполняется через многоуровневый подход:
1. **Валидация схемы** - Входные данные проверяются против JSON-схем (src/validators/schema.ts:15-42)
2. **Бизнес-правила** - Пользовательские валидаторы проверяют ограничения предметной области (src/validators/business.ts:8-25)
3. **Санитизация** - Пользовательский ввод очищается перед сохранением (src/utils/sanitize.ts:12-18)
Ключевые файлы:
| Файл | Роль |
|------|------|
| src/validators/schema.ts | Определение схемы и валидация |
| src/validators/business.ts | Правила предметной области |
| src/utils/sanitize.ts | Очистка входных данных |
Использование «wiki-qa». Where is the API client configured?
Ожидаемый результат:
API-клиент настроен в `src/api/client.ts:22-45`. Он использует:
- Базовый URL из переменных окружения (строка 28)
- Таймаут 30 секунд (строка 32)
- Логику повторных попыток для неудачных запросов (строки 38-42)
Клиент инициализируется в `src/app.ts:15` и передаётся сервисам через внедрение зависимостей.
Использование «wiki-qa». What happens when a user uploads a file?
Ожидаемый результат:
Загрузка файла следует этому рабочему процессу:
1. **Запрос получен** - Роутер маршрутизирует POST /upload к обработчику (src/routes/upload.ts:12)
2. **Валидация** - Проверяются размер и тип файла (src/middleware/validate.ts:45-52)
3. **Хранение** - Файл сохраняется во временную директорию (src/services/storage.ts:78-92)
4. **Обработка** - Фоновая задача обрабатывает файл (src/jobs/process.ts:15-30)
Примечание: Проверка на вирусы упомянута в комментариях, но не реализована (src/services/storage.ts:85).
Аудит безопасности
БезопасноStatic analysis detected 4 potential issues that are all false positives upon manual review. The skill is a legitimate documentation/Q&A tool that reads source code files and answers questions based on file content. No actual code execution, external commands, or cryptographic operations are present.
Оценка качества
Что вы можете построить
Адаптация нового разработчика
Быстро поймите, как работают конкретные компоненты, задавая вопросы на естественном языке о структуре и реализации кодовой базы.
Исследование устаревшего кода
Эффективно перемещайтесь по незнакомым кодовым базам, задавая вопросы о том, где определены функции и как взаимодействуют различные модули.
Документация архитектуры
Генерируйте объяснения архитектуры системы и взаимосвязей компонентов на основе фактических доказательств из исходного кода.
Попробуйте эти промпты
How does authentication work in this project?
Where is the user validation logic defined?
How do the frontend and backend communicate in this application?
What could cause the payment processing to fail based on the error handling code?
Лучшие практики
- Задавайте конкретные вопросы об определённых компонентах, функциях или возможностях для получения наиболее детальных ответов
- Изучайте таблицу ключевых файлов, чтобы понять, какие файлы относятся к вашему вопросу
- Следуйте встроенным ссылкам для более глубокого изучения конкретных деталей реализации
- Используйте дополнительные вопросы для изучения связанных компонентов или понимания того, как различные части соединяются
Избегать
- Задавать вопросы о темах, не связанных с кодовой базой (этот навык анализирует только файлы репозитория)
- Ожидать анализа поведения во время выполнения без просмотра файлов тестов или трассировок выполнения
- Предполагать, что ответы включают информацию из внешней документации или API
- Запрашивать выполнение кода или тестирование функциональности (это анализ только для чтения)