AGENTS.md-Überprüfung
Die Urteile wenden den Test in agents-md an: mehr als eine billige Feedback-Runde, um etwas zu entdecken und zu beheben, und nicht in einem Skill oder einer Always-Read-Datei festgehalten.
Überprüfen, dann klassifizieren
Überprüfen Sie die Datei, wie sie gegeben ist, und geben Sie die Version an. Überprüfen Sie jeden Block anhand der Realität, bevor Sie ihn beurteilen; ein Beweisstück pro Urteil ist ausreichend.
- Beispiele und Formate gegen das Tool, das sie konsumiert (Changelog-Generator, Release-Tooling, CI-Workflows): Falsch. Das Lesen der Tool-Konfiguration reicht aus; was es falsch darstellen würde, ist falsch, unabhängig davon, ob die fehlerhafte Ausgabe bereits ausgeliefert wurde.
- Listen gegen den Baum und den Remote-Standard-Branch: Veraltet.
- Behauptete Konventionen gegen die History gemergter PRs: Nie eine Konvention, wenn niemand sie befolgt und der Maintainer bestätigt, dass niemand sie beschlossen hat. Ein Maintainer kann die Regel bewusst einführen, und ein menschlicher Committer beweist nichts darüber, wer sie beschlossen hat. Eine nicht befolgte Regel, zu der der Maintainer keine Entscheidung getroffen hat, kommt auf die Liste der menschlichen Entscheidungen.
- Regeln gegen die installierten Skills und Always-Read-Dateien: Doppelt.
- Alles andere gegen den obigen Test: Auffindbar, Inhaltsleer oder Einfacher Befehl.
- Ein immer geladener Verweis auf eine lange Anleitung: Fehlplatziert; es gehört in den Skill, der sie benötigt.
Ein Block kann mehr als ein Urteil erhalten, jedes mit eigenem Beweis; führen Sie mit dem Urteil, das keine menschliche Bestätigung benötigt, damit das Beschneiden beginnen kann, bevor der Maintainer antwortet.
Achten Sie auch auf das, was Fehlt: Richtlinien, die die Organisation anderswo anwendet (Intent-Datei-Regeln, Schreibkonventionen, Kommentarmarkierungen), nicht standardmäßige Layouts ohne Verweis und eine AGENTS.md ohne symbolischen Link auf eine Schwesterdatei CLAUDE.md.
agents-md/references/before-after.md ist die ausgearbeitete Antwort eines Repositorys; überprüfen Sie jede Zeile erneut gegen das vor Ihnen liegende Repository, fügen Sie sie niemals einfach ein.
Bericht
| Block | Urteil | Beweis |
|---|---|---|
| `Issue: #456`, `Issue: N/A` als gültige Fußzeilen | Falsch, Nie eine Konvention | `cliff.toml` macht jeden `Issue:`-Wert zu einem Jira-Link; Maintainer bestätigt, dass keiner beschlossen wurde |
| Tests treiben das CLI-Binary, nicht die Bibliothek; siehe `testsuite/AGENTS.md` | Behalten | die Neuerstellung einer Bibliotheks-Testsuite ist mehr als eine Runde; kein Skill gibt sie vor |
Schlagen Sie dann die vollständige bereinigte Datei vor, listen Sie auf, was in einen Skill oder eine verschachtelte AGENTS.md verschoben wurde, und listen Sie auf, was eine menschliche Entscheidung benötigt.
Wenden Sie die Änderungen nicht an, es sei denn, Sie werden dazu aufgefordert.