OntoShip — плагин
Плагин gitmark для Claude Code: база знаний проекта из markdown и git с поиском FTS5, графом ссылок и циклом dev-flow
- 126 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Команда /ship ведет изменение через ветки dev и main до продакшена и запускает агентов с правом записи.
- Индексатор читает все markdown-файлы репозитория и пишет локальный индекс.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/ontoshipОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Команда /ship ведет изменение через ветки dev и main до продакшена и запускает агентов с правом записи.
- Индексатор читает все markdown-файлы репозитория и пишет локальный индекс.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
OntoShip превращает документацию проекта в базу знаний из обычных markdown-файлов, README-индексов и git. Плагин gitmark несет три скилла и пять команд. Скилл `kb-search` ищет по базе вместо слепого grep, `kb-curate` задает легкие правила онтологии для документов, `dev-flow` ведет цикл разработки: исследование, задачи, спецификация, изолированный git worktree, реализация, тесты, независимое ревью, выкладка. Команды: `/kb` ищет и отвечает по лучшим находкам, `/kb-map` строит HTML-граф ссылок, `/doc` пишет или обновляет один документ, `/onto-doc` собирает всю базу силами параллельных агентов, `/ship` запускает dev-flow. Ядро — `gitmark`, один файл на стандартной библиотеке Python без зависимостей: SQLite FTS5, поиск с триграммами и нечеткостью, запросы по frontmatter, линтер.
Для кого. Командам, которые ведут документацию проекта в markdown и хотят дать агентам быстрый поиск по ней и порядок в документах без отдельного сервиса.
Подходит, если
- Агент перерывает документацию через grep, а нужный документ находит не с первого раза.
- В репозитории нет документации, и ее надо собрать с нуля параллельными агентами.
- Нужна карта связей между документами в одном HTML-файле для обсуждения с командой.
- Функцию надо довести до продакшена по циклу со спецификацией, ревью и тестами.
Не подходит, если
- Знания живут в вики или Notion: плагин рассчитан на markdown в репозитории.
- Нужен семантический поиск на эмбеддингах: gitmark обходится без них.
- Команда не готова к автоматическому прохождению цикла до основной ветки командой /ship.
Пример запроса к агенту
/kb как проверяется подпись вебхука биллингаОграничения
Для gitmark нужен Python 3.7 и выше с SQLite FTS5, а триграммный токенизатор требует SQLite 3.34 и новее, иначе нечеткий поиск и поиск по подстроке недоступны. Индекс лежит в каталоге `.gitmark/`, его добавляют в `.gitignore`. Команда `/ship` проводит изменение через запрос на слияние в ветку dev и затем в main, поэтому права и процесс веток нужно настроить заранее. Заметка автора: защитный хук `destructive-guard` вынесен в отдельный репозиторий. Бенчмарк автора на 198 вопросах дал 69 процентов точных попаданий против 30 у grep.
Как отключить. Выполните `/plugin uninstall gitmark@ontoship` либо удалите скопированные `skills` и `commands` из `.claude/`. Каталог `.gitmark/` с индексом удаляется вручную.
Частые вопросы
Как установить плагин?
Командами `/plugin marketplace add vakovalskii/ontoship` и `/plugin install gitmark@ontoship`. Без маркетплейса достаточно скопировать `skills` и `commands` в `.claude/` репозитория.
Нужны ли эмбеддинги или база данных?
Нет. Источник правды — markdown, а индекс SQLite FTS5 пересобирается из файлов командой `gitmark index`. Ни сервиса, ни облака, ни эмбеддингов.
Как писать запрос к /ship?
Опишите, что сделать, зачем и по каким критериям считать задачу готовой, и назовите сервис или файл. Фраза вроде `/ship fix search` слабая, потому что агенту приходится угадывать цель.
Что делает /onto-doc?
Собирает или пересобирает всю документацию: разбивает репозиторий на области, запускает по куратору на область параллельно, затем линтует, индексирует и строит граф.
Работает ли поиск с кириллицей?
Да. Триграммный токенизатор и нечеткий поиск находят слова с опечатками и подстроки, в том числе на русском.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныПлагин Claude Code для проектов по фазам: план, параллельные агенты с TDD, проверка безопасности и качества, затем выпуск.
Маркетплейс плагинов Claude Code от Frad LEE: Git и GitFlow, GitHub, рефакторинг, память, исследования, изображения и работа с интерфейсами
Задачи, документы, спецификации и решения проекта лежат файлами Markdown в репозитории, а агент читает их через CLI и MCP
Плагины Claude Code: команды плана, работы и ревью, субагенты, хуки и скиллы письма в духе практичного минимализма.
Плагины для git, Python и доступности в одном месте: более 400 скиллов, субагенты и хуки против опасных команд.
Плагин Claude Code создает и поддерживает CLAUDE.md: оценка от 0 до 100, лимит 150 строк и проверка устаревших ссылок
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| OntoShip (эта карточка) | нет | 126 | ||
| RepoWiki | нет | 306 | генерирует вики по репозиторию; OntoShip ищет по вашей markdown-документации и ведет цикл dev-flow | |
| LLM Wiki Memory | нет | не нужна | 130 | память агента в форме вики; OntoShip опирается на README-индексы и git без сервиса |
Коротко о README
Показано, как выглядит база знаний на четырех уровнях увеличения: от графа документов до одной строки frontmatter. Необязательная онтология описывает типы документов, свойства и типизированные ссылки.