ship-checklist
À propos
Cette compétence fournit une checklist de définition de fini pour les développeurs déployant de nouvelles écritures ou requêtes de données sur le graphe ax, garantissant que chaque écriture dispose à la fois d'un chemin de lecture à la demande et d'un chemin de lecture proactif destiné aux agents. Elle se déclenche sur des mots-clés tels que "déployer", "nouveau signal" ou "connecter ceci" et est utilisée avant l'ouverture d'une PR pour de nouvelles tables SurrealDB, des étapes d'ingestion ou des requêtes analytiques. Le principe fondamental est qu'une fonctionnalité n'est pas terminée tant qu'un agent ne peut pas découvrir et agir de manière autonome sur les nouvelles données.
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/ship-checklistCopiez et collez cette commande dans Claude Code pour installer cette compétence
Documentation
ship-checklist - every write needs a read path an agent can find
The recurring miss in ax: we ship the write + an on-demand CLI read, and skip the proactive / agent-facing read. A signal only visible on a manual CLI run is invisible to the self-improvement loop. ax's whole thesis is that agents discover and act on signals - so a new write is not done until an agent can find it without being told.
Organizing rule: every write needs (B) an on-demand read AND (C) a proactive read AND an agent-facing surface (MCP/skill). Most features do A+B and stop.
Run this before opening the PR. Skipping a row is fine - but say so in the PR and why, don't skip silently.
A. Write
- Schema in
schema.surql+ registered inSCHEMA_TABLES(CI mirror guard) - Ingest idempotent + incremental (since-aware) + deref-free denormalization for reads (no record derefs inside aggregates - they hang prod)
- Backfill: does history get the signal, or only new data? Note "dark until re-ingest" if so
- Stage
deps= every producer of the input table
B. Read - on-demand
- CLI: a command or a facet on an existing one (consistent family)
-
--jsonenvelope for scripting - Dashboard/studio surface (if visual)
C. Read - proactive (the usually-missed half)
- MCP tool so an agent can query it in-context (
apps/axctl/src/mcp/tools.ts) -
ax improve recommendgenerator - mint a proposal when the signal crosses a threshold (agent gets the suggestion unprompted) -
ax insights/ dashboard next-actions wiring (if it implies an action) - dojo agenda item (if the overnight loop should act on it)
- Skill: a cognitive pattern teaching an agent to act on the signal (e.g. the
lnskill routes visual judgment to subagents offax cost images)
D. Documentation
-
CLAUDE.mdcommand/section docs (there is a docs gate for new subcommands) - llms.txt / site docs / README, if user-facing
- CHANGELOG + release notes (release-please)
- Spec in
docs/superpowers/specs/for non-trivial features
E. Onboarding / distribution
- Onboarding prompt (
@ax/onboarding-prompt) - should a day-1 user/agent know it exists? - Marketing coverage (site page / blog / X), if a user-facing capability
-
/api/versioncapability flag, if relevant
F. Verify (evidence, not assertion)
- Tests: unit on pure helpers + schema-mirror guard + CLI command-list test
- Live-verified against the real DB - paste the actual output in the PR
- "Dark until data" honesty: state if it needs backfill/telemetry to light up
How to use
Create a TodoWrite item per relevant row, or paste the A-F headers into the PR body as a checked list. The point is the C section - if a new signal has no MCP tool, no improve generator, and no skill, an agent will never surface it on its own, and the feature is half-built no matter how clean the write is.
Dépôt GitHub
Questions fréquentes
Qu’est-ce que le Skill ship-checklist ?
ship-checklist 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 à ship-checklist sans consigne supplémentaire.
Comment installer ship-checklist ?
Utilisez les commandes d’installation de cette page : ajoutez ship-checklist à 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 ship-checklist ?
ship-checklist appartient à la catégorie Documentation.
ship-checklist est-il gratuit ?
Oui. ship-checklist est référencé sur AIMCP et son installation est gratuite.
Compétences associées
Cette compétence récupère la documentation actuelle de Railway pour répondre aux questions sur les fonctionnalités, le fonctionnement ou des URL spécifiques de la documentation. Elle garantit que les développeurs reçoivent des informations précises et à jour directement depuis les sources officielles de Railway. Utilisez-la lorsque les utilisateurs demandent comment fonctionne Railway ou font référence à la documentation de Railway.
Cette compétence Claude offre un accompagnement expert pour écrire du code Python dans les nœuds Code de n8n, en particulier pour utiliser la bibliothèque standard de Python et travailler avec la syntaxe spéciale de n8n comme `_input`, `_json` et `_node`. Elle aide les développeurs à comprendre les limites de Python dans n8n et recommande d'utiliser JavaScript pour la plupart des workflows, tout en proposant des solutions Python pour des besoins spécifiques de transformation de données.
La compétence Archon offre une recherche sémantique alimentée par RAG et une gestion de projet via une API REST. Utilisez-la pour interroger la documentation, gérer des projets/tâches hiérarchiques et effectuer de la recherche de connaissances avec des capacités de téléchargement de documents. Priorisez toujours Archon en premier lors de la recherche dans une documentation externe avant d'utiliser d'autres sources.
Cette compétence Claude fournit des conseils d'expert pour écrire du code JavaScript dans les nœuds Code d'n8n. Elle couvre la syntaxe essentielle spécifique à n8n comme les variables `$input`/`$json`, les assistants HTTP et la gestion des DateTime, tout en résolvant les erreurs courantes. Utilisez-la lors du développement de workflows n8n nécessitant un traitement JavaScript personnalisé dans les nœuds Code.