ship-checklist — скилл для Claude Code: чек-лист перед PR
Скилл-чек-лист готовности: проверяет, что у новой записи в графе ax есть путь чтения, который найдёт агент, а не только ручной запуск CLI.
npx skills add Necmttn/ax --skill ship-checklist -a claude-codeЧто делает ship-checklist
Скилл закрывает повторяющийся промах в проекте ax: пишут запись и команду чтения по требованию, а проактивную поверхность для агента забывают. Сигнал, который видно только при ручном запуске CLI, для петли самоулучшения не существует. Поэтому новая запись не считается готовой, пока агент не найдёт её сам.
Внутри шесть разделов: запись, чтение по требованию, проактивное чтение, документация, онбординг и проверка. В разделе записи — схема в schema.surql и регистрация в SCHEMA_TABLES, идемпотентный ингест с учётом since, денормализация без дереференса записей внутри агрегатов. Отдельный пункт про бэкфилл: история получит сигнал или только новые данные.
Раздел C — тот, ради которого скилл и сделан: MCP-инструмент в apps/axctl/src/mcp/tools.ts, генератор ax improve recommend, привязка к ax insights, пункт повестки dojo и скилл, который учит агента действовать по сигналу. Пропустить строку можно, но в PR нужно написать, какую и почему. Запускать до открытия PR.
Какие задачи решает
- проверить, что у новой записи в графе есть путь чтения для агента
- не забыть MCP-инструмент и генератор предложений для нового сигнала
- отметить, что сигнал не появится в истории без повторного ингеста
- собрать доказательства проверки на живой базе в тело PR
- пройтись по разделам A–F перед открытием пул-реквеста
Примеры запросов агенту
- Пройди ship-checklist по новой таблице
signal_eventsперед PR - Добавил новый сигнал — проверь раздел C и скажи, чего не хватает
- Это готово к мержу? Прогони чек-лист ship-checklist
Как установить ship-checklist
1Через Skills CLI (Vercel)
npx skills add Necmttn/ax --skill ship-checklist -a claude-code2Вручную: положить файлы
~/.claude/skills/ship-checklist/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/ship-checklist/
1Через Skills CLI (Vercel)
npx skills add Necmttn/ax --skill ship-checklist -a codex2Вручную: положить файлы
.agents/skills/ship-checklist/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Necmttn/ax --skill ship-checklist -a cursor2Вручную: положить файлы
.cursor/skills/ship-checklist/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Necmttn/ax ship-checklist2Вручную: положить файлы
.github/skills/ship-checklist/SKILL.md1Через Skills CLI (Vercel)
npx skills add Necmttn/ax --skill ship-checklist -a gemini-cli2Командой платформы
gemini skills install https://github.com/Necmttn/ax --path skills/ship-checklistВручную: положить файлы
.devin/skills/ship-checklist/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add Necmttn/ax --skill ship-checklist -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о ship-checklist
Как установить ship-checklist в Claude Code?
Выполните npx skills add Necmttn/ax --skill ship-checklist -a claude-code. Скилл окажется в ~/.claude/skills/ship-checklist/SKILL.md.
Что делает ship-checklist?
Это чек-лист готовности для новой возможности в графе ax. Он требует, чтобы у каждой записи было чтение по требованию, проактивное чтение и поверхность для агента, а не только сама запись.
Что будет, если пропустить пункт чек-листа?
Пропускать строки можно, но в PR нужно указать, какую именно и почему. Молчаливый пропуск скилл не одобряет.
