MCP HubMCP Hub
SKILL·C3B9F5

ax-add-ingest-stage

Necmttn
Actualizado 28 days ago
4 vistas
104
12
104
Ver en GitHub
Desarrolloai

Acerca de

Esta habilidad de Claude proporciona una lista de verificación para desarrolladores que añaden nuevas etapas de ingesta o tablas de SurrealDB al sistema de gráficos ax. Codifica requisitos específicos de registro que provocarán fallos en la integración continua si se omiten, incluyendo el registro obligatorio de tablas en SCHEMA_TABLES. Úsela al crear nuevas etapas de ingesta etiquetadas con derive o nuevas tablas de base de datos para evitar errores comunes.

Instalación rápida

Claude Code

Recomendado
Principal
npx skills add Necmttn/ax -a claude-code
Comando PluginAlternativo
/plugin add https://github.com/Necmttn/ax
Git CloneAlternativo
git clone https://github.com/Necmttn/ax.git ~/.claude/skills/ax-add-ingest-stage

Copia y pega este comando en Claude Code para instalar esta habilidad

Documentación

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

  1. Add the DEFINE TABLE ... SCHEMAFULL + fields to packages/schema/src/schema.surql (top-level fields explicit; nested objects → JSON-encoded string; datetimes via JS Date).
  2. Register it in SCHEMA_TABLES (apps/axctl/src/queries/insights.ts) - a mirror test diffs DEFINE TABLE names vs SCHEMA_TABLES and fails CI if missing.
  3. In a worktree, run bun install so @ax/schema resolves to the worktree copy (not the main tree's symlink) before the mirror test will pass.

New derive-tagged ingest stage

  1. Co-locate the StageDef at the bottom of the stage file (mirror apps/axctl/src/ingest/derive-opportunities.ts): export const FooKey = Schema.Literal("foo") + fooStage.
  2. Register in apps/axctl/src/ingest/stage/registry.ts: add the import, add FooKey to the IngestStageKey Schema.Union([...]), add fooStage to ALL_STAGES.
  3. Update apps/axctl/src/cli/effect-cli.test.ts: bump the resolveIngestStages: default runs every stage .toHaveLength(N) by 1, and add your key (sorted) to the --derive-only list. CI fails otherwise.
  4. Isolate failures: wrap the stage body in Effect.catchCause returning 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 → use Schema.Literals([...]).
  • Schema.Date doesn't JSON round-trip → use Schema.DateFromString.check(Schema.isDateValid()).

Repositorio GitHub

Necmttn/ax
Ruta: .ax/skills/ax-add-ingest-stage
0
agent-memoryagent-observabilityai-agentsbunclaude-codecodex
FAQ

Preguntas frecuentes

¿Qué es el Skill ax-add-ingest-stage?

ax-add-ingest-stage es un Skill de Claude creado por Necmttn. Los Skills agrupan instrucciones y recursos que Claude carga cuando los necesita para realizar tareas relacionadas con ax-add-ingest-stage sin indicaciones adicionales.

¿Cómo instalo ax-add-ingest-stage?

Usa los comandos de instalación de esta página: añade ax-add-ingest-stage a Claude Code como plugin o clona su repositorio en tu directorio de skills y reinicia Claude para cargarlo.

¿A qué categoría pertenece ax-add-ingest-stage?

ax-add-ingest-stage pertenece a la categoría Desarrollo.

¿Se puede usar ax-add-ingest-stage gratis?

Sí. ax-add-ingest-stage aparece en AIMCP y se puede instalar gratis.

Habilidades relacionadas

qmd
Desarrollo

qmd es una herramienta CLI de búsqueda e indexación local que permite a los desarrolladores indexar y buscar en archivos locales mediante búsqueda híbrida que combina BM25, embeddings vectoriales y reranking. Es compatible tanto con uso desde la línea de comandos como con modo MCP (Model Context Protocol) para integración con Claude. La herramienta utiliza Ollama para los embeddings y almacena los índices localmente, lo que la hace ideal para buscar documentación o bases de código directamente desde la terminal.

Ver habilidad
subagent-driven-development
Desarrollo

Esta habilidad ejecuta planes de implementación asignando un nuevo subagente para cada tarea independiente, con revisión de código entre tareas. Permite una iteración rápida mientras mantiene controles de calidad a través de este proceso de revisión. Úsala cuando trabajes en tareas mayormente independientes dentro de la misma sesión para garantizar un progreso continuo con verificaciones de calidad integradas.

Ver habilidad
mcporter
Desarrollo

La habilidad mcporter permite a los desarrolladores gestionar y llamar servidores del Protocolo de Contexto de Modelo (MCP) directamente desde Claude. Proporciona comandos para listar servidores disponibles, llamar a sus herramientas con argumentos, y manejar la autenticación y el ciclo de vida del daemon. Utiliza esta habilidad para integrar y probar la funcionalidad de servidores MCP en tu flujo de trabajo de desarrollo.

Ver habilidad
adk-deployment-specialist
Desarrollo

Esta habilidad despliega y orquesta agentes Vertex AI ADK utilizando el protocolo A2A, gestionando el descubrimiento de AgentCard, el envío de tareas y soportando herramientas como el Sandbox de Ejecución de Código y el Banco de Memoria. Permite construir sistemas multiagente con patrones de orquestación secuencial, paralela o en bucle en Python, Java o Go. Úsela cuando se le solicite desplegar agentes ADK u orquestar flujos de trabajo de agentes en Google Cloud.

Ver habilidad