specsfy-aux-database — скилл для Claude Code: карта данных проекта
Ведёт .specsfy/DATABASE.md с таблицами баз, схем, полей, связей и миграций, чтобы карта данных не расходилась с кодом.
npx skills add promovaweb/specsfy --skill specsfy-aux-database -a claude-codeЧто делает specsfy-aux-database
Скилл обходит схемы, миграции, модели и конфиги проекта и собирает из них табличный инвентарь в .specsfy/DATABASE.md. Таблицы Markdown выбраны не для красоты: по ним удобно искать и сравнивать. Связи, индексы, ограничения, владельца, сроки хранения и назначение, которые по коду не выводятся однозначно, скилл помечает как неизвестные, а не додумывает.
Перед запуском обязательно загрузите $specsfy-setup в корне проекта и не продолжайте, если он показывает незакрытую задачу. Дальше скилл читает локальные инструкции, PROJECT.md, STACK.md и весь DATABASE.md, запускает node scripts/update_database.mjs --project <raiz> и сверяет найденное с исполняемыми источниками. Всё, что лежит вне блока specsfy:database, остаётся нетронутым, поэтому ваши заметки и решения переживут обновление.
Скилл работает без вопросов: если данных не хватает, он ставит пометку для следующего шага, а не прерывает работу. Правка схемы считается незаконченной, пока DATABASE.md не отражает новую структуру и тесты не зелёные. Строки подключения, пароли, токены и значения из .env в отчёт не попадают — это важно, если документация уходит в общий репозиторий.
Какие задачи решает
- собрать табличный инвентарь баз, схем и полей из кода
- проверить, совпадает ли карта данных с текущими миграциями
- отметить связи, индексы и ограничения, которые не выводятся автоматически
- обновить
DATABASE.md, не затерев заметки и решения команды - закрыть задачу по схеме только после зелёных тестов
Примеры запросов агенту
- обнови карту данных в
.specsfy/DATABASE.md - проверь, соответствует ли инвентарь базы текущим миграциям
- добавил таблицу и миграцию — обнови документацию персистентности
Как установить specsfy-aux-database
1Через Skills CLI (Vercel)
npx skills add promovaweb/specsfy --skill specsfy-aux-database -a claude-code2Вручную: положить файлы
~/.claude/skills/specsfy-aux-database/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/specsfy-aux-database/
1Через Skills CLI (Vercel)
npx skills add promovaweb/specsfy --skill specsfy-aux-database -a codex2Вручную: положить файлы
.agents/skills/specsfy-aux-database/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add promovaweb/specsfy --skill specsfy-aux-database -a cursor2Вручную: положить файлы
.cursor/skills/specsfy-aux-database/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install promovaweb/specsfy specsfy-aux-database2Вручную: положить файлы
.github/skills/specsfy-aux-database/SKILL.md1Через Skills CLI (Vercel)
npx skills add promovaweb/specsfy --skill specsfy-aux-database -a gemini-cli2Командой платформы
gemini skills install https://github.com/promovaweb/specsfy --path skills/specsfy-aux-databaseВручную: положить файлы
.devin/skills/specsfy-aux-database/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add promovaweb/specsfy --skill specsfy-aux-database -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о specsfy-aux-database
Как установить specsfy-aux-database в Claude?
Выполните npx skills add promovaweb/specsfy --skill specsfy-aux-database -a claude-code. Скилл появится в ~/.claude/skills/specsfy-aux-database/SKILL.md.
Что делает specsfy-aux-database?
Собирает и поддерживает .specsfy/DATABASE.md: таблицы баз, схем, таблиц, полей, связей и миграций, сверенные с кодом.
Что нужно перед запуском скилла?
Загрузить $specsfy-setup в корне проекта и убедиться, что он не показывает незакрытую задачу. При автоматической передаче скилл загружает его заново.
