figma-daily-resume

Figma tägliche Zusammenfassung

Verwandelt „Was habe ich heute in Figma geändert?“ in eine kurze Liste tatsächlicher Änderungen, indem die letzte gespeicherte Version der Datei vor heute mit der neuesten gespeicherten Version verglichen wird, Seite für Seite. Figma hat kein benutzerspezifisches Aktionsprotokoll, daher ist dieser Diff die einzige Möglichkeit, Änderungen auf Bearbeitungsebene zu erhalten.

Helfer: scripts/figma_resume.py neben dieser Datei (stdlib Python, JSON-Ausgabe). Konfiguration befindet sich in ~/.config/figma-daily-resume/ (config.json, token).

Welcher Modus?

• Kein config.json oder kein Token → Einrichtung.
• Benutzer sagt „ausführen“, „zusammenfassung“, „heute“ oder ein Planer hat dich aufgerufen → Tägliche Ausführung.
• Benutzer sagt „neu konfigurieren“ / „Seiten/Dateien ändern“ → wiederhole die relevanten Einrichtungsfragen.

Einrichtung

Stelle jeweils eine Frage nach der anderen, in dieser Reihenfolge. Fahre erst fort, wenn die aktuelle Frage geklärt ist.

1. Token

Erkläre, wie man einen erhält, und lass den Benutzer ihn selbst speichern:

1. Figma → Kontomenü (oben links) → Einstellungen → Sicherheit → Persönliche Zugriffstokens → Neues Token generieren.
2. Benenne es daily-resume, Ablauf nach Belieben, und gewähre schreibgeschützte Berechtigungen: file_content:read, file_metadata:read, file_versions:read, file_comments:read.
3. Kopiere es sofort; Figma zeigt es nur einmal an.
4. Speichere es in einer Datei, die nur der Benutzer sehen kann. Gib ihm Folgendes zum Ausführen in seinem eigenen Terminal (ein Editor vermeidet, dass der Token im Shell-Verlauf bleibt): mkdir -p ~/.config/figma-daily-resume && chmod 700 ~/.config/figma-daily-resume && touch ~/.config/figma-daily-resume/token && chmod 600 ~/.config/figma-daily-resume/token && open -e ~/.config/figma-daily-resume/token dann füge den Token ein, speichern, schließen.

Eine Datei wird anstelle einer Umgebungsvariable verwendet, weil geplante Ausführungen ~/.zshrc nicht laden. Frage niemals nach dem Token im Chat und zeige oder cat ihn niemals. Wenn der Benutzer ihn trotzdem einfügt, sage das klar, fahre fort und empfehle, ihn am Ende zu widerrufen und neu zu generieren. Überprüfe mit python3 scripts/figma_resume.py whoami (gibt Handle/E-Mail aus, niemals den Token).

2. Dateien

Frage nach der/den Figma-Datei-URL(s) (figma.com/design/<KEY>/...). Führe für jede figma_resume.py pages <url> aus und notiere den Dateinamen.

3. Seiten

Zeige die Seitenliste jeder Datei und frage, welche Seiten der Benutzer aktiv bearbeitet. Erkläre den Aufwand: Eine große Seite kann über 100 MB groß sein und dauert etwa eine Minute zum Diffen, daher nur Seiten, an denen wirklich gearbeitet wird. Frage höchstens ein paar auf einmal; schlage zuerst die Design-/UI-Seiten vor, wenn die Namen es nahelegen.

4. Ausgabe

Nur Terminal, eine Markdown-Datei (Standard ~/Documents/figma-resumes/YYYY-MM-DD.md) oder eine Notion-Seite (nur anbieten, wenn ein Notion-Tool verbunden ist). Speichere die Auswahl.

5. Zeitplan

Frage nach der Uhrzeit für jeden Tag. Geplante Ausführungen müssen lokal sein, da Token und Konfiguration auf diesem Rechner liegen und Cloud-Routinen sie nicht sehen können. Wähle in dieser Reihenfolge:

1. Geplanter Task in Claude Desktop (lokal): Lasse den Benutzer einen täglichen Task mit dem Prompt /figma-daily-resume run erstellen. Wenn du sehen kannst, wie das von hier aus erstellt wird, tue es; wenn nicht, gib die genauen Schritte und den Prompt an, anstatt die Benutzeroberfläche zu erraten.
2. Fallback mit macOS launchd/cron, der claude -p "/figma-daily-resume run --unattended" ausführt.
3. Verwende nicht CronCreate: Es ist nur sitzungsbasiert und läuft nach 7 Tagen ab.

Mache den Zeitplan zuletzt, damit ein defekter Token oder eine falsche Seiten-ID gefunden wird, bevor etwas automatisiert wird. Führe dann einen echten Lauf durch (siehe unten), damit der Benutzer ein Ergebnis sieht, bevor er fertig ist.

config.json

{"files": [{"key": "DEIN_DATEI_KEY", "name": "Meine App",
            "pages": [{"id": "0:1", "name": "Helles Design"}]}],
 "output": {"type": "file", "path": "~/Documents/figma-resumes"},
 "schedule": "18:00"}

Tägliche Ausführung

1. Frage zuerst die Ziele ab (überspringe nur bei --unattended oder wenn niemand antwortet): Zeige die gespeicherten Dateien/Seiten und frage „wie beim letzten Mal oder etwas ändern?“. Akzeptiere Hinzufügungen/Entfernungen („auch Dashboard de cambios“, „Sakura heute überspringen“). Einmalige Änderungen gelten nur für heute, es sei denn, der Benutzer sagt, sie zu speichern.
2. Für jede Datei, für jeden ausgewählten Seitensatz: führe python3 scripts/figma_resume.py diff <key> --pages <ids> aus (füge --date für einen vergangenen Tag hinzu). Führe Dateien im Hintergrund aus und frage nach, da jede Seite etwa eine Minute dauert. Führe auch comments <key> für heute geschriebene oder aufgelöste Kommentare aus.
3. Lese den status:
   • no_versions_today: Figma hat heute keine Version gespeichert, also sage „keine gespeicherten Änderungen“ für diese Datei. Speicherungen erfolgen periodisch (Leerlaufzeit oder manuell), daher können aktuelle Änderungen noch nicht gespeichert sein.
   • no_baseline: Die Datei hat keine Version vor heute, also gibt es nichts zu diffen; sage das.
   • ok: Fasse die changes zusammen.
4. Schreibe die Zusammenfassung und liefere sie an die konfigurierte Ausgabe.

Zusammenfassung schreiben

Gruppiere nach Datei → Seite → übergeordneter Frame (frame). Ein Aufzählungspunkt pro Änderung, in den eigenen Worten des Benutzers, mit den exakten Zeichenfolgen aus den Daten. Reduziere Rauschen; der Punkt ist, überfliegbar zu sein.

Figma Zusammenfassung, 2026-09-21
Meine App / Helles Design UI
  Insights
  • getippt: "Brekdown by member" -> "Breakdown by member"
  • Farbe geändert auf "Card bg": #ffffff -> #f5f5f5
  • Frame "Empty state" hinzugefügt (12 Knoten)
Kommentare: 2 geschrieben, 1 aufgelöst

Regeln, die es ehrlich halten:

• Arten: text = getippt, fill/stroke = Farbe geändert, renamed = umbenannt, resized = größe geändert, added/deleted = hinzugefügt/gelöscht (Teilbaumwurzeln mit Knotenanzahlen, nicht jedes Kind).
• Viele ähnliche Änderungen (gleiche Farbe bei 40 Knoten getauscht): ein Aufzählungspunkt mit der Anzahl.
• Es ist ein Netto-Diff zwischen zwei gespeicherten Versionen. Sage einmal „Nettoänderungen“, da Änderungen, die zwischen Speicherungen gemacht und rückgängig gemacht wurden, unsichtbar sind. Beanspruche keine höhere Genauigkeit.
• Erfinde niemals eine Absicht („Hierarchie verbessert“). Beschreibe nur, was sich geändert hat.
• Wenn editors jemand anderen enthält, erwähne, dass einige Änderungen möglicherweise nicht vom Benutzer stammen.
• Leerer Diff an einem Tag mit Speicherungen: „gespeicherte Versionen, aber keine sichtbaren Unterschiede auf diesen Seiten“ (die Bearbeitung könnte auf einer anderen Seite sein – biete an, die Seiten zu erweitern).

Fehlerbehandlung

• HTTP 401/403: Token abgelaufen, widerrufen oder fehlende Berechtigung. Sende den Benutzer zurück zu Einrichtung Schritt 1.
• Zeitüberschreitung bei einer großen Seite: Einmal wiederholen, dann melden, welche Seite fehlgeschlagen ist, anstatt sie stillschweigend fallen zu lassen.
• Drucke niemals den Token und schreibe ihn niemals in eine andere Datei als ~/.config/figma-daily-resume/token.