ax-add-ingest-stage — скилл для Claude Code: как установить
Помогает добавить новую стадию обработки данных или таблицу SurrealDB в проект ax. Предотвращает ошибки в тестах и пайплайнах CI.
npx skills add Necmttn/ax --skill ax-add-ingest-stage -a claude-codeЧто делает ax-add-ingest-stage
Скилл содержит регламент для кодовой базы репозитория ax. При создании таблицы SurrealDB он предписывает внести DEFINE TABLE ... SCHEMAFULL в packages/schema/src/schema.surql, перевести вложенные объекты в JSON-строки и сразу зарегистрировать имя в SCHEMA_TABLES. Без этого упадёт зеркальный тест в CI. В отдельном git worktree перед проверками обязательно нужен bun install, иначе сборщик цепляет симлинк из главного дерева.
Для стадий импорта скилл требует объявить StageDef рядом с кодом логики и прописать ключ в apps/axctl/src/ingest/stage/registry.ts. Также необходимо скорректировать проверку длины списка стадий в effect-cli.test.ts. Ошибки внутри стадии положено изолировать через Effect.catchCause, чтобы единичный сбой не останавливал весь процесс. Дополнительно описаны нюансы Effect v4 beta, включая работу с Schema.Literals и датами.
Какие задачи решает
- добавить новую таблицу SurrealDB в схему ax по правилам проекта
- зарегистрировать стадию импорта данных в реестре ALL_STAGES
- обновить тесты CLI для флага --derive-only при расширении пайплайна
- актуализировать документацию сабкоманд в файлах llms.txt и cli.md
Примеры запросов агенту
- Помоги добавить новую таблицу SurrealDB для сессий пользователей в
packages/schema/src/schema.surqlи зарегистрируй её - Создай новую стадию импорта derive-events в axctl и обнови реестр стадий
- Добавь новую подкоманду в CLI axctl и обнови документацию для прохождения CI
Как установить ax-add-ingest-stage
1Через Skills CLI (Vercel)
npx skills add Necmttn/ax --skill ax-add-ingest-stage -a claude-code2Вручную: положить файлы
~/.claude/skills/ax-add-ingest-stage/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/ax-add-ingest-stage/
1Через Skills CLI (Vercel)
npx skills add Necmttn/ax --skill ax-add-ingest-stage -a codex2Вручную: положить файлы
.agents/skills/ax-add-ingest-stage/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Necmttn/ax --skill ax-add-ingest-stage -a cursor2Вручную: положить файлы
.cursor/skills/ax-add-ingest-stage/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Necmttn/ax ax-add-ingest-stage2Вручную: положить файлы
.github/skills/ax-add-ingest-stage/SKILL.md1Через Skills CLI (Vercel)
npx skills add Necmttn/ax --skill ax-add-ingest-stage -a gemini-cli2Командой платформы
gemini skills install https://github.com/Necmttn/ax --path .ax/skills/ax-add-ingest-stageВручную: положить файлы
.devin/skills/ax-add-ingest-stage/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add Necmttn/ax --skill ax-add-ingest-stage -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о ax-add-ingest-stage
Как установить ax-add-ingest-stage в Claude Code?
Запустите в терминале команду npx skills add Necmttn/ax --skill ax-add-ingest-stage -a claude-code.
Для чего нужен скилл ax-add-ingest-stage?
Он содержит пошаговый чек-лист для добавления сущностей в проект ax. Скилл следит за обязательной регистрацией таблиц и стадий, чтобы изменения не ломали сборку в CI.
Что нужно сделать при добавлении новой стадии Effect?
Нужно разместить StageDef в файле стадии, добавить ключ в реестр apps/axctl/src/ingest/stage/registry.ts и обновить тест effect-cli.test.ts. Тело стадии оборачивают в Effect.catchCause, чтобы изолировать сбои.
