Skip to content
This repository was archived by the owner on Aug 12, 2026. It is now read-only.

v1.2.0 — Der Platz in der Familie, und zwei Wächter

Choose a tag to compare

@malkreide malkreide released this 01 Aug 10:39
· 60 commits to main since this release

Documentation and guards, no change to the procedure itself — the four
disciplines and their steps are as in 1.1.0. What changes is that the skill names
its place in the family correctly, and that two things which nothing checked
before now fail loudly.

Added

  • Die Verwandte-Repos-Tabelle nennt jetzt alle fünf Skills in einer
    Reihenfolge
    — builder, probe, fidelity, transport-hardening, audit —, damit
    die Familie sich aus jedem Repo gleich liest. Zwei der fünf fehlten hier ganz:
    mcp-data-fidelity stand nur in der Companion-Sektion weiter oben,
    mcp-builder überhaupt nicht — obwohl die Rahmung dieses Skills «vor dem Bau»
    ist und die anderen damit voraussetzt.

    mcp-continuous-auditor und termdat-mcp sind aus der Tabelle in einen Satz
    darunter gewandert: Keiner von beiden ist ein Skill der Familie, und in einer
    Tabelle mit Rollenverteilung lasen sie sich, als wären sie welche.

    Dabei fiel ein Sachfehler auf: Der Schlusssatz lautete «Wer nach diesem Skill
    baut, besteht die FID-Checks». Die bestehen aber, wer nach mcp-data-fidelity
    baut — dieser Skill liefert die Ground Truth, an der jene Regeln gemessen
    werden, er ersetzt sie nicht. Korrigiert.

  • Contributing section in both READMEs. The same standard the procedure applies
    to data sources applies to the procedure itself: a proposed step should come
    from a source that actually behaved that way, and name it, so the next person
    can re-probe. The smallest useful contribution is one line in the default
    matrix, with the parameter description that proves it.

  • .gitattributes pinning *.sh, *.py, *.yml, *.yaml, *.md and *.txt
    to LF, matching the other repositories in the portfolio. This one had been the
    exception, and it is the repository where it matters most: it ships a shell
    script, and CRLF chokes bash. The CI's frontmatter check is the second reason —
    its regex expects \n-only fences. The index was already LF-clean, so this
    changes no content; it prevents a Windows checkout from introducing CRLF later.

Changed

  • CI checks the version badge against the CHANGELOG. It was the last figure
    in the README with nothing behind it, and it is the one most likely to be
    forgotten: the release is cut, the badge stays. In mcp-audit-skill it sat
    three releases behind before anyone noticed.

    Source is the topmost ## [X.Y.Z] heading — [Unreleased] carries no version
    and is skipped by the pattern. The READMEs come from glob("README*.md")
    rather than a maintained list, so a third language is covered automatically.
    Both anchors are asserted separately: a CHANGELOG without a release heading and
    a README without a badge each fail, because a check that finds nothing is green.

    Mutation-tested four ways. One of them changed the design: removing the topmost
    release heading does not report a missing anchor, it silently falls back to the
    next release and blames the badge. The check still goes red, but the diagnosis
    pointed at the wrong file — so the failure message now names the CHANGELOG line
    it derived the expected version from, and says that either side may have moved.

  • reference/response_envelope.py zeigt das Usage-Beispiel ohne Decorator.
    Der Repo-Validator meldete my_tool als «nicht im README dokumentiertes Tool»
    — dieses Repo hat gar keine Tools. Seine E1-Prüfung sucht per Regex ein
    @x.tool(...) unmittelbar über einem def im Rohtext einer .py-Datei
    und kann Code nicht von einem Docstring-Beispiel unterscheiden. Das Beispiel
    stand genau in dieser Form im Modul-Docstring.

    Behoben nicht durch Umbenennen, sondern durch Weglassen: Der Decorator war nie
    der Gegenstand des Beispiels — es geht um die Rückgabe-Hülle. Er ist raus, mit
    einem Absatz darunter, der festhält warum, damit ihn niemand «zur
    Vollständigkeit» wieder einfügt. Eine Referenzdatei, die ein Tool
    dokumentiert, sollte nicht wie eines aussehen.

    Damit ist das einzige Vorkommen dieser Form im Portfolio erledigt; die
    patterns.py der beiden anderen Skills tragen keinen Decorator. Repo-Validator:
    0 ERROR, 0 WARN.