Feedback
Du kannst dem Autor des Templates als Feedback melden, was der Arbeitsweise gutgetan hat oder fehlte. Feedback ist freiwillig, betrifft nur die Arbeitsweise, nie dein Projekt, und alles, was den Rechner verlässt, wird auch lokal aufbewahrt.
Der Test für jeden Eintrag: Würde das jemandem helfen, der dein Projekt nie sieht? Eine Regel, die du ergänzen musstest, weil das Template sie nicht hatte, ein Ablauf, der immer wieder scheiterte, ein Script, das sich verallgemeinern lässt: Das ist Feedback. Eine Tatsache über dein Projekt (sein Name, sein Stack, eine Zahl, ein Zitat aus seiner Doku) ist es nicht.
Drei Schlüssel im Abschnitt Feedback von docs/ai/config.md steuern das:
feedback |
Verhalten |
|---|---|
off |
nichts wird von selbst gesendet |
confirm |
der Assistent zeigt dir die Nutzlast und fragt |
automatic |
die Nutzlast wird ohne Rückfrage gesendet |
manual |
Einträge werden gesammelt, aber nie von selbst gesendet; nur der Skill act-feedback sendet |
local |
nichts wird je an den Autor des Templates gesendet; Befunde werden Backlog-Einträge in deinem Projekt |
Neue Projekte starten mit confirm, wenn niemand wählt: bei einem Lauf ohne Terminal (so laufen act-setup und act-adopt), einer leeren Antwort oder dreimal ungültiger Eingabe; off bleibt eine Änderung entfernt. Eine config.md ohne den Schlüssel zählt weiterhin als off. python .act/scripts/feedback.py --enable [--mode off|confirm|automatic|manual|local] setzt den Modus; --enable ohne --mode bedeutet automatic, das ohne Rückfrage sendet; --disable schaltet es ab.
Modus local
Abschnitt betitelt „Modus local“Mit feedback: local sendet das Projekt nie etwas: feedback.py --send (auch mit --force), --direct und --add verweigern und verweisen auf das Backlog, --plan zeigt nichts, und Erinnerungen werden nie fällig. Was sonst hinausginge, wird ein Backlog-Eintrag in deinem Projekt (entries.py new backlog): ein Fehler in der Vorlage selbst, ein Satz, den du hinter feedback: schreibst (in deinen Worten, unverändert), und die wiederkehrenden Befunde, die die Feedback-Regel nennt (eine unpraktische Regel oder ein unpraktisches Format, ein fehlender Ablauf, eine nötige Umgehung); sie legt der Assistent ohne Rückfrage an. /act-config feedback local setzt ihn ebenfalls. Die folgenden Abschnitte gelten für die anderen Modi.
Takt und Scope
Abschnitt betitelt „Takt und Scope“feedback-cadence ist eine Obergrenze, nie eine Pflicht: manual, immediate, hourly, daily, weekly (der übliche Wert) oder adaptive, das daraus lernt, wie oft auf Erinnerungen reagiert oder sie verschoben werden. Gibt es nichts zu melden, wird nichts gesendet, egal wie kurz der Takt ist. Bei immediate sendet feedback.py --add jeden Eintrag gleich beim Hinzufügen (Einwilligung und Modus gelten weiter; --help sagt das), darum sendet --send mit leerem Ausgang nichts und sagt es; --send --force sendet trotzdem.
feedback-scope sagt, was der Assistent von sich aus sammeln darf:
| Scope | Sammelt |
|---|---|
a |
Kennzahlen |
b |
Regel- und Strukturänderungen |
c |
Werkzeugnutzung: wie viele Agenten, Skills und Scripts es gibt und wie oft jeder Skill und jedes Script des Templates seit dem letzten Senden benutzt wurde (auch ein Skill, der durch Eintippen seines Slash-Befehls gestartet wurde, zählt). Deine eigenen Skills und Scripts erscheinen nur als eine own-Zahl je Art, nie mit Namen. Ein Senden zählt außerdem die festgehaltenen Gründe für nachgearbeitete oder eskalierte Worker-Ergebnisse je Rolle und Tier des Templates seit dem letzten Senden; eine eigene Rolle oder ein eigenes Tier geht nur als own / other mit, nie mit Namen. Namen von MCP-Servern werden nicht gesendet. |
Die Kennzahlen von Scope a zählen nur die Dateien des Projekts (git ls-files); ein Vendor-, IDE- oder Medienordner, den git ignoriert, geht also nicht ein; außerhalb eines git-Checkouts wird ein Ordner oder Link, der sich nicht lesen lässt, übersprungen. Ein von Hand geschriebener Befund landet immer im Ausgang, egal welcher Scope gilt.
Zwei Wege zum Senden
Abschnitt betitelt „Zwei Wege zum Senden“- Ein Satz nach dem Auslöser, zum Beispiel
feedback: das Update hat eine Datei liegen lassen. Dieser Satz ist die Nachricht selbst, unverändert gesendet, auch mitfeedback: off. Nur der Text, der eigene Commit-Hash des Templates und eine zufällige Projekt-Kennung verlassen das Projekt, in jedem Modus, nie die Repository-URL oder sonst etwas. Mit der Projekt-Kennung lassen sich mehrere Nachrichten desselben Projekts unterscheiden. Wenn du eine Antwort möchtest, nenne in derselben Anfrage eine Antwortadresse: Der Assistent gibt sie mitfeedback.py --direct "<text>" --contact <adresse>mit. Sie geht nur mit dieser einen Nachricht und bleibt in deren lokaler Kopie, wird nie für eine spätere Nachricht wiederverwendet und nie anderswo hergenommen, etwa aus deinen Git-Einstellungen. - Der Auslöser allein (der Skill
act-feedback). Der Assistent geht durch.act/, die erzeugten Dateien unddocs/ai/, schreibt pro Befund einen Eintrag (zwei bis sechs Sätze), zeigt den Stapel mitfeedback.py --planvorab und sendet ihn nach deinem Modus und Takt. Auch eine Regel, die immer wieder verletzt wird, ist einen Eintrag wert: melde sie als Kandidat für eine mechanische Prüfung.
Ein Fehler im Template selbst (ein Script oder Skill, der fehlschlägt, zwei Regeln, die sich widersprechen, eine Regel, die nie greift) wird gespeichert und, wo die Einwilligung es erlaubt, sofort gesendet, am Takt vorbei. Die Einwilligung umgeht er trotzdem nie: Mit feedback: off bleibt er im Ausgang.
Was nie gesendet wird
Abschnitt betitelt „Was nie gesendet wird“Jede Zeichenkette, die das Projekt verlassen könnte, läuft zuerst durch eine Datenschutzprüfung: zugangsdatenähnliche Wörter, Mailadressen (einzige Ausnahme ist eine Antwortadresse, die du selbst genannt hast; sie muss die schlichte Form name@host.tld haben), IP-Adressen, absolute Pfade, lange Hex-Werte und jede URL außer dem Feedback-Endpunkt oder github.com. Ein Treffer wird nicht stillschweigend entfernt. Es wird nichts gesendet, und der Grund wird gemeldet, damit der Eintrag ohne diesen Teil neu geschrieben werden kann. Nichts über dein Projekt gehört ohnehin in einen Eintrag: keine Namen, Pfade, Zahlen, kein Code und keine Personen, und kein Lob, nur was konkret geholfen hat oder fehlte.
Die lokale Kopie
Abschnitt betitelt „Die lokale Kopie“- Jedes Senden schreibt eine vollständige Kopie seiner Nutzlast nach
.act-local/feedback/sent/(per gitignore ausgeschlossen, verlässt nie deinen Checkout). Wartende Einträge und Buchführung liegen daneben in.act-local/feedback/. - Messwerte der Worker (
usage.py --estimates) bleiben in.act-local/usage.jsonund sind nie Teil einer Nutzlast; nur die Zählungen der Gründe aus Scopecgehen mit, als Zahlen ohne eigene Namen. - Das Journal des Projekts bekommt einen Eintrag pro Tag,
<date>-feedback-sent.md, mit einer Zeile pro Senden: Uhrzeit, Art des Sendens (Sammelversand oder Direktnachricht) und bei einem Sammelversand die Anzahl der Einträge sowie Art und Titel jedes Eintrags. Der Text eines Eintrags und einer Direktnachricht wird nie festgehalten.
Das lokale Incident-Log
Abschnitt betitelt „Das lokale Incident-Log“Getrennt vom Feedback und nie gesendet: echte Fehler (eine zurückgesetzte geschützte Datei, eine abgestürzte Prüfung, ein Modellwechsel, ein warn-Treffer, der ein Schreiben, ein Löschen oder das Lesen einer geheimen Datei durchließ) werden auf diesem Rechner in .act-local/incidents.jsonl festgehalten und kommen beim Sitzungsstart als ein Inbox-Bericht pro Tag an. Festgehalten werden nur Kennungen, nie ein Befehl oder ein Pfad. ACT_INCIDENT_LOG=off in der Umgebung pausiert das Log für einen Lauf.
Ablehnungen der Sicherheitsprüfungen werden nur gezählt, je Prüfung und Rolle (in .act-local/usage.json). Hat eine Prüfung Worker innerhalb von 7 Tagen mindestens 3-mal abgelehnt, legt doctor.py --inbox eine Frage an: Sie schlägt einen Satz für die Rollendatei oder den Auftragskopf vor, der Workern vorab sagt, was diese Prüfung nicht erlaubt.
Siehe auch die Konfigurationsreferenz für die drei Schlüssel und Konfiguration dafür, wie die Datei funktioniert.