MCP HubMCP Hub
SKILL·C3B9F5

ax-add-ingest-stage

Necmttn
Mis à jour 27 days ago
4 vues
104
12
104
Voir sur GitHub
Développementai

À 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é
Principal
npx skills add Necmttn/ax -a claude-code
Commande PluginAlternatif
/plugin add https://github.com/Necmttn/ax
Git CloneAlternatif
git clone https://github.com/Necmttn/ax.git ~/.claude/skills/ax-add-ingest-stage

Copiez 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

  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()).

Dépôt GitHub

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

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
Développement

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.

Voir la compétence
subagent-driven-development
Développement

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.

Voir la compétence
mcporter
Développement

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.

Voir la compétence
adk-deployment-specialist
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.

Voir la compétence