Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

necro-dev

/necro-dev

Zmienia samo narzędzie necronomicon: silnik, CLI, wyszukiwarki, paczki reguł i specyfikację, z przypadkami zgodności.

Repozytorium
necronomicon ↗
Licencja
Apache-2.0
Ostatnia zmiana repozytorium
10.11.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 10.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

Co robi i kiedy

Zmienia samo narzędzie necronomicon: silnik, CLI, wyszukiwarki, paczki reguł i specyfikację, z przypadkami zgodności.

Oryginalny opis (EN)

Change necronomicon itself, its engine, CLI, finders, packs or spec. Use when adding or changing a necro.yaml key, a finder (necro <name>), a built-in pack rule, output wording, or a conformance case in this repo.

Jak działa

  1. Writing a case
  2. Adding a rule key
  3. Adding a finder
  4. Adding a pack rule
  5. Changing a shipped skill
  6. Before committing
Sekcje z nagłówków SKILL.md, w oryginale · 42 linii, 494 słów
Podgląd SKILL.md
---
name: necro-dev
description: Change necronomicon itself, its engine, CLI, finders, packs or spec. Use when adding or changing a necro.yaml key, a finder (necro <name>), a built-in pack rule, output wording, or a conformance case in this repo.
metadata:
  internal: true
---

# Developing necronomicon

The order is always spec, then cases, then engine. The spec ([spec/v0.md](../../../spec/v0.md)) says what necro does; the cases in `tests/conformance/cases/` prove it; the engine follows.

## Writing a case

A case is one behavior, `cases/<area>/<name>.case`, in the format [tests/conformance/README.md](../../../tests/conformance/README.md) describes: a `#` line saying what it shows, `spec:` naming the section, `args:`, `exit:`, then files and the expected `@stdout`, `@stderr` or `@config-error`.

- Hits sort by rule name, then path, line and column; `rust-style/…` sorts before `rust/…`, since `-` comes before `/`.
- `--format terse` keeps expectations short; use the full format only when the layout is what the case shows.
- `@config-error` lines are `file:line:col: key.path`, the position of the key or value at fault.
- Run one area while working: `uv run --script tests/conformance/run.py -k <area> -- target/debug/necro` (pass `--engine-version <x.y.z>` when a case prints the version). `make test` runs everything.

## Adding a rule key

The key goes in `RULE_KEYS` (`src/config.rs`), `load_rule` parses and validates it, and the spec's rule table gains a row. Add cases for the key working, for a bad value (a config error at the right position), and for `--explain` if it shows the key.

## Adding a finder

- `src/finders/<name>.rs` with a `run(args) -> Result<Vec<String>, String>` that returns hit lines, `path[:line[:col[-endcol]]][: label]`, sorted; register it in `FINDERS` (`src/finders/mod.rs`).
- A finder that reads files belongs in `FILE_FINDERS` (`src/run.rs`), so a narrowed run passes it `--files-from`; take that option and keep only the listed files.
- A finder that can fix belongs in `FIX_FINDERS` (`src/config.rs`) with the option that marks a fixable command; `--fix` adds `--write` and `--only-at <file>`.
- Errors are usage errors (`Err`), never hits. A tool it runs that's missing says how to install it.
- A spec section under Finders gives its usage line and each check's hit format.

## Adding a pack rule

- Packs are `src/packs/<pack>.yaml` (only `rules:`), registered in `src/packs/mod.rs`; `Cargo.toml`'s `include` must cover the file.
- Commands use only finders. Give every rule `files:` so a narrowed run skips it, and make limits `params:` a repo can override.
- Opinions go in an opt-in companion pack (`<lang>-style`), not in the core one.
- Pack text can't spell the allow syntax, or the tracked YAML parses as an allow: say "an allow comment".
- Check a new rule against a real adopter before shipping it: count its hits and read a few.

## Changing a shipped skill

`necro`, `necro-rules` and `necro-adopt` are read in other repos: links are absolute GitHub URLs, and the allow syntax is written with placeholders (`<rule>`), since these files are under this repo's root. `necro` and `necro-rules` are embedded by `src/skills.rs` and listed in `Cargo.toml`'s `include`. Don't run `necro skills install` here; it would stamp the sources.

## Before committing

`make necro-fix`, `make test`, `make necro`; `make check` runs every hook as CI does. One concern per commit; a change that touches the spec, cases and engine for one behavior is one concern.

Wersje

W bazie nie ma innych skilli o nazwie necro-dev.

Migawka bazy z 13.11.2026 · wersja paczki dee758c68d6f (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

  • 85necro-adopt
    Wdraża narzędzie necro w repozytorium jako kontrole przed commitem i zamienia skrypty lint oraz konwencje AGENTS.md w reguły.
  • 85necro-adopt
    Wdraża narzędzie necro w repozytorium jako kontrole przed commitem i zamienia skrypty lint oraz konwencje AGENTS.md w reguły.

Uwagi i zgłoszenia

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