ax-add-ingest-stage
À propos
Cette compétence de Claude fournit une liste de contrôle pour les développeurs ajoutant de nouvelles étapes d'ingestion ou des tables SurrealDB au système de graphe ax. Elle encode des exigences d'enregistrement spécifiques qui entraîneront des échecs d'intégration continue si elles sont omises, y compris l'enregistrement obligatoire des tables dans SCHEMA_TABLES. Utilisez-la lors de la création de nouvelles étapes d'ingestion marquées "derive" ou de tables de base de données pour éviter les pièges courants.
Installation rapide
Claude Code
Recommandé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-stageCopiez et collez cette commande dans Claude Code pour installer cette compétence
Documentation
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()).
Dépôt GitHub
Questions fréquentes
Qu’est-ce que le Skill ax-add-ingest-stage ?
ax-add-ingest-stage est un Skill Claude créé par Necmttn. Un Skill regroupe des instructions et des ressources que Claude charge à la demande pour effectuer des tâches liées à ax-add-ingest-stage sans consigne supplémentaire.
Comment installer ax-add-ingest-stage ?
Utilisez les commandes d’installation de cette page : ajoutez ax-add-ingest-stage à Claude Code comme plugin ou clonez son dépôt dans votre dossier skills, puis redémarrez Claude pour charger le Skill.
À quelle catégorie appartient ax-add-ingest-stage ?
ax-add-ingest-stage appartient à la catégorie Développement.
ax-add-ingest-stage est-il gratuit ?
Oui. ax-add-ingest-stage est référencé sur AIMCP et son installation est gratuite.
Compétences associées
qmd est un outil CLI de recherche et d'indexation locale qui permet aux développeurs d'indexer et de rechercher dans des fichiers locaux en utilisant une recherche hybride combinant BM25, des embeddings vectoriels et du reranking. Il prend en charge à la fois une utilisation en ligne de commande et un mode MCP (Model Context Protocol) pour l'intégration avec Claude. L'outil utilise Ollama pour les embeddings et stocke les index localement, ce qui le rend idéal pour rechercher dans de la documentation ou des bases de code directement depuis le terminal.
Cette compétence exécute des plans de mise en œuvre en déployant un nouveau sous-agent pour chaque tâche indépendante, avec une revue de code entre les tâches. Elle permet une itération rapide tout en maintenant des contrôles de qualité grâce à ce processus de revue. Utilisez-la lorsque vous travaillez sur des tâches principalement indépendantes au sein d'une même session pour assurer une progression continue avec des vérifications de qualité intégrées.
La compétence mcporter permet aux développeurs de gérer et d'appeler des serveurs Model Context Protocol (MCP) directement depuis Claude. Elle fournit des commandes pour lister les serveurs disponibles, appeler leurs outils avec des arguments, et gérer l'authentification ainsi que le cycle de vie du démon. Utilisez cette compétence pour intégrer et tester les fonctionnalités des serveurs MCP dans votre flux de travail de développement.
Cette compétence déploie et orchestre des agents Vertex AI ADK en utilisant le protocole A2A, gérant la découverte d'AgentCard, la soumission de tâches, et prenant en charge des outils tels que le bac à sable d'exécution de code et la banque de mémoire. Elle permet de construire des systèmes multi-agents avec des modèles d'orchestration séquentiels, parallèles ou en boucle en Python, Java ou Go. Utilisez-la lorsqu'on vous demande de déployer des agents ADK ou d'orchestrer des flux de travail d'agents sur Google Cloud.
