Przejdź do treści
Biblioteka skilli
Programowanie · Przegląd i audyt

ship-checklist

/ship-checklist

Daje listę kontrolną definicji ukończenia dla nowego zapisu, sygnału, tabeli, krawędzi lub zapytania w grafie ax w SurrealDB, z odczytem na żądanie, odczytem proaktywnym i dokumentacją.

Repozytorium
ax ↗
Licencja
AGPL-3.0
Ostatnia zmiana repozytorium
07.10.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 07.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

AGPL-3.0, copyleft: przeróbki udostępniane innym muszą mieć tę samą licencję.

Co robi i kiedy

Daje listę kontrolną definicji ukończenia dla nowego zapisu, sygnału, tabeli, krawędzi lub zapytania w grafie ax w SurrealDB, z odczytem na żądanie, odczytem proaktywnym i dokumentacją.

Wyzwalacze z opisu

shipnew signalnew table/edgenew lens/querywire this upis this done
Oryginalny opis (EN)

Definition-of-done checklist for shipping a new write, signal, table, edge, or query to the ax graph. Use when adding a SurrealDB table/edge/field, an ingest derive-stage, a new analytic query, or any new ax capability - before opening the PR. Ensures every write gets an on-demand read AND a proactive (agent-facing) read AND docs/distribution, not just the write. Triggers on "ship", "new signal", "new table/edge", "new lens/query", "wire this up", "is this done", or finishing an ax feature branch.

Jak działa

  1. A. Write
  2. B. Read - on-demand
  3. C. Read - proactive (the usually-missed half)
  4. D. Documentation
  5. E. Onboarding / distribution
  6. F. Verify (evidence, not assertion)
  7. How to use
Sekcje z nagłówków SKILL.md, w oryginale · 56 linii, 532 słów
Podgląd SKILL.md
---
name: ship-checklist
description: Definition-of-done checklist for shipping a new write, signal, table, edge, or query to the ax graph. Use when adding a SurrealDB table/edge/field, an ingest derive-stage, a new analytic query, or any new ax capability - before opening the PR. Ensures every write gets an on-demand read AND a proactive (agent-facing) read AND docs/distribution, not just the write. Triggers on "ship", "new signal", "new table/edge", "new lens/query", "wire this up", "is this done", or finishing an ax feature branch.
---

# 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 in `SCHEMA_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)
- [ ] `--json` envelope 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 recommend` generator - 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 `ln` skill routes visual judgment to subagents off `ax cost images`)

## D. Documentation
- [ ] `CLAUDE.md` command/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/version` capability 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.

Wersje

RepozytoriumWynikLicencja
Ta strona · Necmttn/ax90AGPL-3.0
AbrasiveUnit/ship-checklist87MIT

Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.

Migawka bazy z 13.11.2026 · wersja paczki b3c868573cd6 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 90ax-add-ingest-stage
    Dodaje nowy etap ingestu lub nową tabelę SurrealDB do grafu ax, uwzględniając pułapki rejestracji, które powodują błąd CI.
  • 100surrealdb-js
    Łączy aplikacje Node, Deno, Bun i przeglądarkę z SurrealDB przez SDK surrealdb: uwierzytelnianie, CRUD i zapytania na żywo.
  • 95surrealdb-python
    Łączy się z SurrealDB z Pythona przez SDK, w trybie serwera przez WebSocket lub wbudowanym, z operacjami CRUD.
  • 100surrealdb
    Pomaga w SurrealDB 3: modelowanie danych, zapytania SurrealQL, grafy, wektory, uprawnienia, wdrożenia i integracje SDK.
  • 100adding-a-feature
    Podaje czteroobszarową listę kontrolną każdej nowej funkcji, integracji lub możliwości, aby agent i interfejs zachowały parytet.
  • 100create-release-checklist
    Generuje listę kontrolną wydania, gdy trzeba przygotować release, plan wydania lub wypuścić wersję.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.