# ship-checklist

Скилл-чек-лист готовности: проверяет, что у новой записи в графе ax есть путь чтения, который найдёт агент, а не только ручной запуск CLI.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 121
- Автор: Necmttn
- Лицензия: AGPL-3.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/Necmttn/ax/tree/HEAD/skills/ship-checklist/SKILL.md
- Обновлён: 2026-10-07
- HTML: https://affpapa.org/nevibecode/skills/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.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Necmttn/ax --skill ship-checklist -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/ship-checklist/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/ship-checklist/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Necmttn/ax --skill ship-checklist -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/ship-checklist/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Necmttn/ax --skill ship-checklist -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/ship-checklist/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Necmttn/ax ship-checklist
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/ship-checklist/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Necmttn/ax --skill ship-checklist -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/Necmttn/ax --path skills/ship-checklist
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/ship-checklist/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add Necmttn/ax --skill ship-checklist -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/Necmttn/ax/tree/HEAD/skills/ship-checklist/SKILL.md

## Когда брать
- проверить, что у новой записи в графе есть путь чтения для агента
- не забыть MCP-инструмент и генератор предложений для нового сигнала
- отметить, что сигнал не появится в истории без повторного ингеста
- собрать доказательства проверки на живой базе в тело PR
- пройтись по разделам A–F перед открытием пул-реквеста

## Примеры запросов агенту
- Пройди ship-checklist по новой таблице `signal_events` перед PR
- Добавил новый сигнал — проверь раздел C и скажи, чего не хватает
- Это готово к мержу? Прогони чек-лист ship-checklist

## Похожие
- [review-and-ship](https://affpapa.org/nevibecode/skills/review-and-ship.md) — скилл · 2500 установок
- [pr-quality-checklist](https://affpapa.org/nevibecode/skills/pr-quality-checklist.md) — скилл · 337 установок
- [ship-mate](https://affpapa.org/nevibecode/plugins/ship-mate.md) — плагин · ★ 41823
- [code-review-checklist](https://affpapa.org/nevibecode/skills/code-review-checklist.md) — скилл · 365 установок
- [verify-and-ship](https://affpapa.org/nevibecode/skills/verify-and-ship.md) — скилл · 843 установки
- [design-qa-checklist](https://affpapa.org/nevibecode/skills/design-qa-checklist.md) — скилл · 2200 установок

Из того же набора: [necmttn/ax](https://affpapa.org/nevibecode/by/necmttn/ax.md) — 3 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md