ship-checklist
О программе
Этот навык предоставляет чек-лист критериев готовности для разработчиков, добавляющих новые операции записи или запросы к графу ax, гарантируя, что каждая запись имеет как путь чтения по запросу, так и проактивный путь чтения, доступный агенту. Он активируется по ключевым словам, таким как "выпустить", "новый сигнал" или "подключить это", и используется перед открытием PR для новых таблиц SurrealDB, этапов приёма данных или аналитических запросов. Основной принцип заключается в том, что функция не считается завершённой, пока агент не сможет автономно обнаруживать новые данные и действовать на их основе.
Быстрая установка
Claude Code
Рекомендуетсяnpx skills add Necmttn/ax -a claude-code/plugin add https://github.com/Necmttn/axgit clone https://github.com/Necmttn/ax.git ~/.claude/skills/ship-checklistСкопируйте и вставьте эту команду в Claude Code для установки этого навыка
Документация
ship-checklist - every write needs a read path an agent can find
The recurring miss in ax: we ship the write + an on-demand CLI read, and skip the proactive / agent-facing read. A signal only visible on a manual CLI run is invisible to the self-improvement loop. ax's whole thesis is that agents discover and act on signals - so a new write is not done until an agent can find it without being told.
Organizing rule: every write needs (B) an on-demand read AND (C) a proactive read AND an agent-facing surface (MCP/skill). Most features do A+B and stop.
Run this before opening the PR. Skipping a row is fine - but say so in the PR and why, don't skip silently.
A. Write
- Schema in
schema.surql+ registered inSCHEMA_TABLES(CI mirror guard) - Ingest idempotent + incremental (since-aware) + deref-free denormalization for reads (no record derefs inside aggregates - they hang prod)
- Backfill: does history get the signal, or only new data? Note "dark until re-ingest" if so
- Stage
deps= every producer of the input table
B. Read - on-demand
- CLI: a command or a facet on an existing one (consistent family)
-
--jsonenvelope for scripting - Dashboard/studio surface (if visual)
C. Read - proactive (the usually-missed half)
- MCP tool so an agent can query it in-context (
apps/axctl/src/mcp/tools.ts) -
ax improve recommendgenerator - mint a proposal when the signal crosses a threshold (agent gets the suggestion unprompted) -
ax insights/ dashboard next-actions wiring (if it implies an action) - dojo agenda item (if the overnight loop should act on it)
- Skill: a cognitive pattern teaching an agent to act on the signal (e.g. the
lnskill routes visual judgment to subagents offax cost images)
D. Documentation
-
CLAUDE.mdcommand/section docs (there is a docs gate for new subcommands) - llms.txt / site docs / README, if user-facing
- CHANGELOG + release notes (release-please)
- Spec in
docs/superpowers/specs/for non-trivial features
E. Onboarding / distribution
- Onboarding prompt (
@ax/onboarding-prompt) - should a day-1 user/agent know it exists? - Marketing coverage (site page / blog / X), if a user-facing capability
-
/api/versioncapability flag, if relevant
F. Verify (evidence, not assertion)
- Tests: unit on pure helpers + schema-mirror guard + CLI command-list test
- Live-verified against the real DB - paste the actual output in the PR
- "Dark until data" honesty: state if it needs backfill/telemetry to light up
How to use
Create a TodoWrite item per relevant row, or paste the A-F headers into the PR body as a checked list. The point is the C section - if a new signal has no MCP tool, no improve generator, and no skill, an agent will never surface it on its own, and the feature is half-built no matter how clean the write is.
GitHub репозиторий
Часто задаваемые вопросы
Что такое Skill ship-checklist?
ship-checklist — это Claude Skill от Necmttn. Skills объединяют инструкции и ресурсы, которые Claude загружает по мере необходимости, чтобы выполнять задачи, связанные с ship-checklist, без дополнительных запросов.
Как установить ship-checklist?
Используйте команды установки на этой странице: добавьте ship-checklist в Claude Code как плагин или клонируйте репозиторий в каталог skills, затем перезапустите Claude, чтобы загрузить Skill.
К какой категории относится ship-checklist?
ship-checklist относится к категории Документация.
Можно ли использовать ship-checklist бесплатно?
Да. ship-checklist размещён на AIMCP и доступен для бесплатной установки.
Похожие навыки
Этот навык получает актуальную документацию Railway, чтобы отвечать на вопросы о функциях, возможностях или конкретных URL-адресах документации. Он гарантирует, что разработчики получают точную и современную информацию напрямую из официальных источников Railway. Используйте его, когда пользователи спрашивают, как работает Railway, или ссылаются на документацию Railway.
Этот навык Claude предоставляет экспертные рекомендации по написанию кода Python в узлах Code платформы n8n, в частности, по использованию стандартной библиотеки Python и работе со специальным синтаксисом n8n, таким как `_input`, `_json` и `_node`. Он помогает разработчикам понять ограничения Python в среде n8n и рекомендует использовать JavaScript для большинства рабочих процессов, предлагая решения на Python для конкретных задач по преобразованию данных.
Навык Archon предоставляет семантический поиск на основе RAG и управление проектами через REST API. Используйте его для запросов к документации, управления иерархическими проектами/задачами и выполнения поиска информации с возможностью загрузки документов. Всегда в первую очередь обращайтесь к Archon при поиске во внешней документации, прежде чем использовать другие источники.
Этот навык Claude предоставляет экспертные рекомендации по написанию кода JavaScript в узлах Code платформы n8n. Он охватывает важный синтаксис, специфичный для n8n, включая переменные `$input`/`$json`, HTTP-хелперы и работу с DateTime, а также помогает в устранении распространённых ошибок. Используйте его при разработке рабочих процессов в n8n, требующих кастомной обработки JavaScript в узлах Code.