MCP HubMCP Hub
SKILL·C3B9F5

ax-add-ingest-stage

Necmttn
Aktualisiert 27 days ago
4 Ansichten
104
12
104
Auf GitHub ansehen
Entwicklungai

Über

Diese Claude-Fähigkeit bietet eine Checkliste für Entwickler, die neue Ingest-Stufen oder SurrealDB-Tabellen zum ax-graph-System hinzufügen. Sie kodiert spezifische Registrierungsanforderungen, die bei Nichtbeachtung zu CI-Fehlern führen, einschließlich der obligatorischen Tabellenregistrierung in SCHEMA_TABLES. Nutzen Sie sie bei der Erstellung neuer mit "derive" gekennzeichneter Ingest-Stufen oder Datenbanktabellen, um häufige Fallstricke zu vermeiden.

Schnellinstallation

Claude Code

Empfohlen
Primär
npx skills add Necmttn/ax -a claude-code
Plugin-BefehlAlternativ
/plugin add https://github.com/Necmttn/ax
Git CloneAlternativ
git clone https://github.com/Necmttn/ax.git ~/.claude/skills/ax-add-ingest-stage

Kopieren Sie diesen Befehl und fügen Sie ihn in Claude Code ein, um diese Fähigkeit zu installieren

Dokumentation

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

GitHub Repository

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

Häufig gestellte Fragen

Was ist der Skill ax-add-ingest-stage?

ax-add-ingest-stage ist ein Claude Skill von Necmttn. Skills bündeln Anweisungen und Ressourcen, die Claude bei Bedarf lädt, um Aufgaben rund um ax-add-ingest-stage ohne zusätzliche Eingaben auszuführen.

Wie installiere ich ax-add-ingest-stage?

Verwende die Installationsbefehle auf dieser Seite: Füge ax-add-ingest-stage als Plugin zu Claude Code hinzu oder klone das Repository in dein Skills-Verzeichnis. Starte Claude danach neu, damit der Skill geladen wird.

Zu welcher Kategorie gehört ax-add-ingest-stage?

ax-add-ingest-stage gehört zur Kategorie Entwicklung.

Kann ich ax-add-ingest-stage kostenlos nutzen?

Ja. ax-add-ingest-stage ist auf AIMCP gelistet und kann kostenlos installiert werden.

Verwandte Skills

qmd
Entwicklung

qmd ist ein lokales Such- und Indexierungs-CLI-Tool, das Entwicklern ermöglicht, lokale Dateien mittels Hybridsuche zu indexieren und zu durchsuchen, die BM25, Vektoreinbettungen und Neuordnung kombiniert. Es unterstützt sowohl die Kommandozeilennutzung als auch den MCP-Modus (Model Context Protocol) zur Integration mit Claude. Das Tool verwendet Ollama für Einbettungen und speichert Indizes lokal, was es ideal für die direkte Suche in Dokumentationen oder Codebasen vom Terminal aus macht.

Skill ansehen
subagent-driven-development
Entwicklung

Diese Fähigkeit führt Implementierungspläne aus, indem für jede unabhängige Aufgabe ein neuer Subagent bereitgestellt wird, mit Code-Review zwischen den Aufgaben. Sie ermöglicht schnelle Iterationen, während Qualitätssicherungsschritte durch diesen Review-Prozess gewahrt bleiben. Nutzen Sie sie, wenn Sie überwiegend unabhängige Aufgaben innerhalb derselben Sitzung bearbeiten, um kontinuierlichen Fortschritt mit integrierten Qualitätsprüfungen zu gewährleisten.

Skill ansehen
mcporter
Entwicklung

Die mcporter-Skill ermöglicht es Entwicklern, Model Context Protocol (MCP)-Server direkt aus Claude heraus zu verwalten und aufzurufen. Sie bietet Befehle, um verfügbare Server aufzulisten, deren Tools mit Argumenten aufzurufen sowie Authentifizierung und Daemon-Lebenszyklus zu handhaben. Nutzen Sie diese Skill, um MCP-Server-Funktionalität in Ihren Entwicklungs-Workflow zu integrieren und zu testen.

Skill ansehen
adk-deployment-specialist
Entwicklung

Diese Fähigkeit stellt Vertex AI ADK-Agenten über das A2A-Protokoll bereit und orchestriert sie, verwaltet die AgentCard-Erkennung, Aufgabenübermittlung und unterstützende Tools wie die Code Execution Sandbox und Memory Bank. Sie ermöglicht den Aufbau von Multi-Agenten-Systemen mit sequenziellen, parallelen oder Schleifen-Orchestrierungsmustern in Python, Java oder Go. Verwenden Sie sie, wenn Sie aufgefordert werden, ADK-Agenten bereitzustellen oder Agenten-Workflows auf Google Cloud zu orchestrieren.

Skill ansehen