ax-add-ingest-stage
О программе
Этот навык Claude предоставляет контрольный список для разработчиков, добавляющих новые этапы приёма данных или таблицы SurrealDB в систему графа ax. Он кодирует конкретные требования к регистрации, несоблюдение которых приведёт к сбоям в CI, включая обязательную регистрацию таблиц в SCHEMA_TABLES. Используйте его при создании новых этапов приёма данных с тегом derive или таблиц базы данных, чтобы избежать распространённых ошибок.
Быстрая установка
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/ax-add-ingest-stageСкопируйте и вставьте эту команду в Claude Code для установки этого навыка
Документация
Adding an ingest stage / table to ax
Hard-won checklist - each step below has a CI gate that fails if you skip it.
New SurrealDB table
- Add the
DEFINE TABLE ... SCHEMAFULL+ fields topackages/schema/src/schema.surql(top-level fields explicit; nested objects → JSON-encodedstring; datetimes via JSDate). - Register it in
SCHEMA_TABLES(apps/axctl/src/queries/insights.ts) - a mirror test diffsDEFINE TABLEnames vsSCHEMA_TABLESand fails CI if missing. - In a worktree, run
bun installso@ax/schemaresolves to the worktree copy (not the main tree's symlink) before the mirror test will pass.
New derive-tagged ingest stage
- Co-locate the
StageDefat the bottom of the stage file (mirrorapps/axctl/src/ingest/derive-opportunities.ts):export const FooKey = Schema.Literal("foo")+fooStage. - Register in
apps/axctl/src/ingest/stage/registry.ts: add the import, addFooKeyto theIngestStageKeySchema.Union([...]), addfooStagetoALL_STAGES. - Update
apps/axctl/src/cli/effect-cli.test.ts: bump theresolveIngestStages: default runs every stage.toHaveLength(N)by 1, and add your key (sorted) to the--derive-onlylist. CI fails otherwise. - Isolate failures: wrap the stage body in
Effect.catchCausereturning a zero-row stat, so a stage error never aborts the surrounding ingest.
New CLI subcommand
Document it in BOTH cli-reference gates or CI fails: docs/cli.md (or README) + apps/site/public/llms.txt (scripts/check-cli-reference.ts), AND a card in apps/site/app/routes/docs/-cli-reference.data.ts (scripts/check-site-cli-reference.test.ts).
Effect v4 beta gotchas
- Multi-arg
Schema.Literal(...)collapses → useSchema.Literals([...]). Schema.Datedoesn't JSON round-trip → useSchema.DateFromString.check(Schema.isDateValid()).
GitHub репозиторий
Часто задаваемые вопросы
Что такое Skill ax-add-ingest-stage?
ax-add-ingest-stage — это Claude Skill от Necmttn. Skills объединяют инструкции и ресурсы, которые Claude загружает по мере необходимости, чтобы выполнять задачи, связанные с ax-add-ingest-stage, без дополнительных запросов.
Как установить ax-add-ingest-stage?
Используйте команды установки на этой странице: добавьте ax-add-ingest-stage в Claude Code как плагин или клонируйте репозиторий в каталог skills, затем перезапустите Claude, чтобы загрузить Skill.
К какой категории относится ax-add-ingest-stage?
ax-add-ingest-stage относится к категории Разработка.
Можно ли использовать ax-add-ingest-stage бесплатно?
Да. ax-add-ingest-stage размещён на AIMCP и доступен для бесплатной установки.
Похожие навыки
qmd — это локальный инструмент командной строки для поиска и индексирования, который позволяет разработчикам индексировать и осуществлять поиск по локальным файлам с использованием гибридного поиска, сочетающего BM25, векторные эмбеддинги и реранкинг. Он поддерживает как использование через командную строку, так и режим MCP (Model Context Protocol) для интеграции с Claude. Инструмент использует Ollama для создания эмбеддингов и хранит индексы локально, что делает его идеальным для поиска по документации или кодовой базе прямо из терминала.
Этот навык выполняет планы реализации, создавая нового суб-агента для каждой независимой задачи, проводя проверку кода между задачами. Он позволяет быстро итерировать, сохраняя контроль качества через этот процесс ревью. Используйте его при работе в основном с независимыми задачами в рамках одной сессии, чтобы обеспечить непрерывный прогресс со встроенными проверками качества.
Навык mcporter позволяет разработчикам управлять и вызывать серверы Model Context Protocol (MCP) напрямую из Claude. Он предоставляет команды для вывода списка доступных серверов, вызова их инструментов с аргументами, а также для обработки аутентификации и управления жизненным циклом демона. Используйте этот навык для интеграции и тестирования функциональности серверов MCP в вашем рабочем процессе разработки.
Этот навык развертывает и оркестрирует агентов Vertex AI ADK с использованием протокола A2A, управляя обнаружением AgentCard, отправкой задач и поддерживая инструменты, такие как песочница для выполнения кода и Memory Bank. Он позволяет создавать мультиагентные системы с последовательными, параллельными или циклическими схемами оркестрации на Python, Java или Go. Используйте его, когда требуется развернуть агентов ADK или оркестрировать рабочие процессы агентов в Google Cloud.
