Ein mehrzeiliger Kommentarblock, der in Prosa durchgeht, was die Funktion tut. Die Signatur sagt es bereits; die Prosa ist Dekoration.
Jedes Beispiel zeigt genau die Codeform, nach der die Regel sucht, und dann die kleinste Version, die die Absicht bewahrt, ohne Risiken zu verstecken oder Rauschen hinzuzufügen.
// This function takes a user ID and a list of orders,
// filters the orders to only those belonging to the user,
// then sums the total amount across them and returns it.
function sumUserOrders(userId: string, orders: Order[]): number {
return orders
.filter(o => o.userId === userId)
.reduce((sum, o) => sum + o.amount, 0)
}Deterministisches Parsen von Kommentarblöcken: beanstandet aufeinanderfolgende Kommentarzeilen, die die direkt folgende Deklaration paraphrasieren.
function sumUserOrders(userId: string, orders: Order[]): number {
return orders
.filter(o => o.userId === userId)
.reduce((sum, o) => sum + o.amount, 0)
}Lösche die Prosa, die den Code wiederholt, und lass die Implementierung über Namen und Struktur lesbar sein. Behalte einen Kommentar nur, wenn er Absicht, eine Einschränkung oder einen externen Vertrag erklärt, den der Code nicht ausdrücken kann.
Agenten sind darauf trainiert, Code zu „erklären“. Sie polstern Funktionsrümpfe mit erklärenden Vorreden auf, selbst wenn Signatur, Parameternamen und Operatorkette schon dieselbe Geschichte erzählen.
ai-slop/narrative-comment
ai-slop
Deterministisches Parsen von Kommentarblöcken: beanstandet aufeinanderfolgende Kommentarzeilen, die die direkt folgende Deklaration paraphrasieren.
WARUM-Kommentare, Lizenz-Header, Doc-Kommentare zu öffentlichen API-Verträgen und Kommentare, die eine nicht offensichtliche Einschränkung benennen, werden nicht beanstandet.
Die Geschwätzigkeits-Signale stammen aus SlopCodeBench, das aufgeblähte Kommentare in langen Coding-Aufgaben gemessen hat, und tauchten im ersten öffentlichen Scan-Batch wiederholt auf.