Die fuenf SKILL.md sind untereinander strukturell inkonsistent: Kommandolisten und Beispielbloecke #78

Closed
opened 2026-09-09 09:02:53 +00:00 by torben · 1 comment
Owner

Erledigt in 11d64e6, Version 4.8.0-beta.11

Beide Punkte behoben, ein Publish. Der Abgleich wurde bei der Umsetzung mit einem eigenen Skript in beide Richtungen wiederholt und foerderte mehr zutage als die urspruengliche Messung.

1. Kommandolisten

Benutzt, aber nicht gelistet — ergaenzt:

Skill ergaenzt Fundstelle
wiki-ingest cite add, types describe Schritt 7 bzw. Schritt 6 (source_type-Werte kommen daraus)
wiki-manage cite add Schritt 5
wiki-lint xref add, publish Schritt 1 (schwache Kante umlabeln) bzw. Decision Point
wiki-query publish Decision Point

types describe, xref add und publish kamen erst beim Nachmessen dazu; das Skript aus der Analyse hatte nur Vorkommen mit tools/wikitool-Praefix gezaehlt und Decision Points nicht erfasst.

Gelistet, aber in keinem Schritt — gestrichen: rm und log status aus wiki-lint, lint --markdown aus wiki-lint, lint --json aus wiki-status.

Die beiden erstgenannten stehen jetzt als Absatz **Deliberately absent:** unter der Liste, mit Grund: ein Lint-Lauf loescht nie eine Seite (das ist page-lifecycle.md), und log status entscheidet zwar den Trigger dieses Skills, gelaufen wird es von wiki-ingests letztem Schritt. Ohne diesen Absatz traegt sie jemand aus Vollstaendigkeit wieder ein.

Bewusst gelistet geblieben: publish, log append, index rebuild, sources rebuild-index, wo ein Skill sie ueber publish-cycle.md delegiert. Dazu xref remove in wiki-manage, das zum Unlinking-Fall gehoert, den der Skill als Ganzes an page-lifecycle.md abgibt — auch das steht jetzt als Satz unter der Liste statt als stille Annahme.

2. Beispielbloecke

wiki-manage traegt jetzt **Example triggers:** mit zwei Zeilen (je einer pro Ablauf, Anlegen und Aktualisieren), wiki-status ein einzeiliges **Example trigger:** wie wiki-ingest und wiki-lint. Alle fuenf Skills schliessen damit gleich.

Die offene Frage ist mit ja beantwortet — als #83

Ob instructions verify den Abgleich kuenftig selbst macht: ja, ausgelagert nach #83. Trivial ist er nicht, und das ist der Wert dieses Laufs fuer das Folge-Issue — die drei Ausnahmeklassen sind jetzt benannt und, wo moeglich, verankert:

  1. Delegation ueber publish-cycle.md,
  2. benannte Delegation an eine andere Instruction (xref removepage-lifecycle.md),
  3. bewusste Abwesenheit (**Deliberately absent:**).

Nur die dritte hat heute einen maschinenlesbaren Anker — den Absatz, den dieser Lauf eingefuehrt hat. Ein naiver Parser wuerde alle drei bei jedem Lauf melden.

Akzeptanzkriterien

  • Fuer jeden der fuenf Skills gilt: jedes Kommando, das ein Schritt oder ein Decision Point aufruft, steht in „wikitool commands used" — und jedes dort gelistete kommt in einem Schritt, einem Decision Point oder einer ausdruecklich benannten Delegation vor. Per Skript in beide Richtungen nachgemessen.
  • rm steht nicht mehr in wiki-lints Liste; die Streichung ist begruendet statt stillschweigend.
  • wiki-manage und wiki-status tragen einen Beispielblock in derselben Form wie die drei anderen.
  • tools/wikitool instructions verify laeuft ohne neue Findings, instructions sync ist gelaufen.

Zusaetzlich geprueft: docs verify OK, pytest 1076 passed.

Geaendert

instructions/wiki-ingest/SKILL.md, instructions/wiki-lint/SKILL.md, instructions/wiki-manage/SKILL.md, instructions/wiki-query/SKILL.md, instructions/wiki-status/SKILL.md — jeweils der Abschnitt „wikitool commands used", dazu die Beispielbloecke in den letzten beiden bzw. wiki-manage/wiki-status.

Herkunft

Analyse aus #65, Sitzung 2026-09-09. Beide Punkte kamen bei der Volltext-Sichtung aller fuenf Skills dazu; in #65 nicht enthalten. Umgesetzt in derselben Sitzung wie #70, #74 und #75 — dieselben Dateien, ein Publish.

## Erledigt in `11d64e6`, Version `4.8.0-beta.11` Beide Punkte behoben, ein Publish. Der Abgleich wurde bei der Umsetzung mit einem eigenen Skript in beide Richtungen wiederholt und foerderte mehr zutage als die urspruengliche Messung. ### 1. Kommandolisten **Benutzt, aber nicht gelistet — ergaenzt:** | Skill | ergaenzt | Fundstelle | |---|---|---| | `wiki-ingest` | `cite add`, `types describe` | Schritt 7 bzw. Schritt 6 (`source_type`-Werte kommen daraus) | | `wiki-manage` | `cite add` | Schritt 5 | | `wiki-lint` | `xref add`, `publish` | Schritt 1 (schwache Kante umlabeln) bzw. Decision Point | | `wiki-query` | `publish` | Decision Point | `types describe`, `xref add` und `publish` kamen erst beim Nachmessen dazu; das Skript aus der Analyse hatte nur Vorkommen mit `tools/wikitool`-Praefix gezaehlt und Decision Points nicht erfasst. **Gelistet, aber in keinem Schritt — gestrichen:** `rm` und `log status` aus `wiki-lint`, `lint --markdown` aus `wiki-lint`, `lint --json` aus `wiki-status`. Die beiden erstgenannten stehen jetzt als Absatz **`**Deliberately absent:**`** unter der Liste, mit Grund: ein Lint-Lauf loescht nie eine Seite (das ist `page-lifecycle.md`), und `log status` entscheidet zwar den *Trigger* dieses Skills, gelaufen wird es von `wiki-ingest`s letztem Schritt. Ohne diesen Absatz traegt sie jemand aus Vollstaendigkeit wieder ein. **Bewusst gelistet geblieben:** `publish`, `log append`, `index rebuild`, `sources rebuild-index`, wo ein Skill sie ueber `publish-cycle.md` delegiert. Dazu `xref remove` in `wiki-manage`, das zum Unlinking-Fall gehoert, den der Skill als Ganzes an `page-lifecycle.md` abgibt — auch das steht jetzt als Satz unter der Liste statt als stille Annahme. ### 2. Beispielbloecke `wiki-manage` traegt jetzt `**Example triggers:**` mit zwei Zeilen (je einer pro Ablauf, Anlegen und Aktualisieren), `wiki-status` ein einzeiliges `**Example trigger:**` wie `wiki-ingest` und `wiki-lint`. Alle fuenf Skills schliessen damit gleich. ## Die offene Frage ist mit ja beantwortet — als #83 Ob `instructions verify` den Abgleich kuenftig selbst macht: ja, ausgelagert nach **#83**. Trivial ist er nicht, und das ist der Wert dieses Laufs fuer das Folge-Issue — die drei Ausnahmeklassen sind jetzt benannt und, wo moeglich, verankert: 1. Delegation ueber `publish-cycle.md`, 2. benannte Delegation an eine andere Instruction (`xref remove` → `page-lifecycle.md`), 3. bewusste Abwesenheit (`**Deliberately absent:**`). Nur die dritte hat heute einen maschinenlesbaren Anker — den Absatz, den dieser Lauf eingefuehrt hat. Ein naiver Parser wuerde alle drei bei jedem Lauf melden. ## Akzeptanzkriterien - [x] Fuer jeden der fuenf Skills gilt: jedes Kommando, das ein Schritt oder ein Decision Point aufruft, steht in „wikitool commands used" — und jedes dort gelistete kommt in einem Schritt, einem Decision Point oder einer ausdruecklich benannten Delegation vor. Per Skript in beide Richtungen nachgemessen. - [x] `rm` steht nicht mehr in `wiki-lint`s Liste; die Streichung ist begruendet statt stillschweigend. - [x] `wiki-manage` und `wiki-status` tragen einen Beispielblock in derselben Form wie die drei anderen. - [x] `tools/wikitool instructions verify` laeuft ohne neue Findings, `instructions sync` ist gelaufen. Zusaetzlich geprueft: `docs verify` OK, `pytest` 1076 passed. ## Geaendert `instructions/wiki-ingest/SKILL.md`, `instructions/wiki-lint/SKILL.md`, `instructions/wiki-manage/SKILL.md`, `instructions/wiki-query/SKILL.md`, `instructions/wiki-status/SKILL.md` — jeweils der Abschnitt „wikitool commands used", dazu die Beispielbloecke in den letzten beiden bzw. `wiki-manage`/`wiki-status`. ## Herkunft Analyse aus #65, Sitzung 2026-09-09. Beide Punkte kamen bei der Volltext-Sichtung aller fuenf Skills dazu; in #65 nicht enthalten. Umgesetzt in derselben Sitzung wie #70, #74 und #75 — dieselben Dateien, ein Publish.
torben added the prio/plannedsize/Marea/processkind/defect labels 2026-09-09 09:02:53 +00:00
Author
Owner

Changelog: Body auf den Endstand umgeschrieben. Der Abgleich wurde bei der Umsetzung per eigenem Skript in beide Richtungen wiederholt und fand mehr als die Erstmessung: zusaetzlich fehlten types describe (wiki-ingest), xref add (wiki-lint) und publish (wiki-lint, wiki-query) — das Analyse-Skript hatte nur Vorkommen mit tools/wikitool-Praefix gezaehlt und Decision Points nicht erfasst. Neu gegenueber dem Befund: die beiden Streichungen in wiki-lint stehen als **Deliberately absent:**-Absatz mit Grund unter der Liste, und xref remove in wiki-manage ist als benannte Delegation ausgeschrieben — beides, damit die Abwesenheit bzw. Anwesenheit nicht als Fehler gelesen und "korrigiert" wird. Die offene Frage ist mit ja beantwortet und als #83 ausgelagert, mit den drei Ausnahmeklassen als Vorarbeit. Alle vier Akzeptanzkriterien abgehakt. Umgesetzt in 11d64e6, 4.8.0-beta.11. Geschlossen.

**Changelog:** Body auf den Endstand umgeschrieben. Der Abgleich wurde bei der Umsetzung per eigenem Skript in beide Richtungen wiederholt und fand mehr als die Erstmessung: zusaetzlich fehlten `types describe` (`wiki-ingest`), `xref add` (`wiki-lint`) und `publish` (`wiki-lint`, `wiki-query`) — das Analyse-Skript hatte nur Vorkommen mit `tools/wikitool`-Praefix gezaehlt und Decision Points nicht erfasst. Neu gegenueber dem Befund: die beiden Streichungen in `wiki-lint` stehen als `**Deliberately absent:**`-Absatz mit Grund unter der Liste, und `xref remove` in `wiki-manage` ist als benannte Delegation ausgeschrieben — beides, damit die Abwesenheit bzw. Anwesenheit nicht als Fehler gelesen und "korrigiert" wird. Die offene Frage ist mit **ja** beantwortet und als #83 ausgelagert, mit den drei Ausnahmeklassen als Vorarbeit. Alle vier Akzeptanzkriterien abgehakt. Umgesetzt in `11d64e6`, `4.8.0-beta.11`. Geschlossen.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: torben/chemenu#78