dengruihan/Claw_agenda

Agenda

Agenda besitzt die persönliche Aufgabenliste und den Ausführungsplan. Die Website nimmt Erledigungs- und Rückgängigmachungs-Feedback des Benutzers entgegen; das agenda-Tool bleibt der einzige Planeditor. Verwenden Sie das Tool zum Lesen und Ändern von Plänen; bearbeiten Sie nicht seine SQLite-Datenbank, schreiben Sie parallelen JSON-Status oder verwenden Sie Browser-Automation, um diesen Kalender zu ändern.

Desktop-Feedback und Neuplanung

• Lesen Sie mit includeCompleted: true, einschließlich blockProgress und feedback. Verarbeiten Sie Feedback ohne undoneBy und mit Status pending/queued/running; Fehler-Einträge können bei einem späteren Durchlauf, wenn das Ergebnis bekannt ist, abgeglichen werden. Ignorieren Sie adjusted/unchanged-Einträge und bereits rückgängig gemachtes Feedback. Folgern Sie niemals Erfolg aus dem Einreihen in die Warteschlange oder aus einem vorherigen Durchlauf, der beendet wurde.
• complete_block bedeutet nur, dass dieser Zeitblock beendet ist. Behalten Sie sein geplantes Intervall als Historie bei und verwenden Sie completedAt als die vom Benutzer beobachtete Endzeit. Es beendet nicht die Aufgabe und beweist nicht die tatsächliche Dauer oder den verbleibenden Aufwand. Verschieben/löschen Sie abgeschlossene Blöcke nicht, erstellen Sie sie nicht als zukünftige Arbeit neu oder öffnen Sie ihren Fortschritt erneut. Bewerten Sie für eine unerledigte Aufgabe konservativ den nächsten Schritt.
• complete_task ist eine benutzerbestätigte Gesamterledigung der Aufgabe. Behalten Sie den Status done und completedBy=user bei, bewahren Sie die Historie und stoppen Sie die zukünftige Ausführung für diese Aufgabe. undo hat den entsprechenden Erledigungsstatus bereits wiederhergestellt; bewerten Sie den aktuellsten Plan neu, anstatt einen veralteten Zeitplan wiederherzustellen oder das Rückgängigmachen zu wiederholen.
• Überprüfen Sie die aktuelle Pekinger Zeit zu Beginn dieses Durchlaufs und erneut vor dem Anwenden eines Plans nach längerer Arbeit. Respektieren Sie bestehende Planungsdurchlauf-Regeln, aktuelle Quellenabdeckung, echte Fristen, Schlaf- und feste Verpflichtungen. Wählen Sie den notwendigen zukünftigen Planungshorizont; es gibt kein festes 7/14-Tage-Limit. Passen Sie nur das an, was betroffen ist. Frühere Fertigstellung kann Ruhe oder das Vorziehen einer anderen Aufgabe rechtfertigen. Abgeschlossene freigeschaltete Arbeit gibt ihre verbleibende geplante Zeit ab dem gemeldeten Ende frei; dies schaltet feste Verpflichtungen nicht frei oder verschiebt sie.
• Fügen Sie feedbackResults: [{id, status, summary}] in dasselbe apply wie die Planänderungen ein. Verwenden Sie adjusted nur für inhaltliche Änderungen, unchanged wenn der aktuelle Plan noch angemessen ist, und error wenn die Bewertung nicht abgeschlossen werden kann. Zusammenfassungen sind prägnant auf Chinesisch, erklären Änderungen oder bewusste Nicht-Änderungen und nennen Abdeckungslücken oder Aufgaben, die nicht passen. Eine reine Ergebnisbestätigung ist ein sinnvoller Schreibvorgang, auch wenn sich keine Ausführungsblöcke ändern.
• Ein Konflikt bedeutet, aktuelle Fakten erneut zu lesen und neu zu planen, einschließlich neuen Feedbacks. Gleichen Sie unbekannte Apply-Ergebnisse anhand der operationId ab, bevor Sie einen weiteren Batch ausgeben. Überschreiben Sie keine neueren Erledigungen. Normale Agent-Schreibvorgänge fordern nie eine sofortige Neuplanung an. Der bestehende Sentinel ist der einzige Planungsbesitzer; Desktop-Ergebnisse erfordern keine routinemäßige externe Nachricht oder zusätzliche Automation.

Lesen, planen, übernehmen

1. Rufen Sie agenda mit action: "read" und query: {includeCompleted: true} auf. Behalten Sie die zurückgegebene Revision, Artikel-IDs, Quellenidentitäten, feste Ereignisse und gesperrte Blöcke bei. Lesen Sie das bestehende Planungsdurchlauf-Skill für persönliche Regeln.
2. Lesen Sie die benötigten externen Quellen mit ihren vorhandenen Skills. OSH, Yungu, DingTalk-Kalender, E-Mails, Besprechungsnotizen und direkte Benutzeranfragen bleiben Quellnachweise; die Website ruft sie nicht ab. Registrieren Sie eine Quelle vor oder im selben Batch wie ihre Einträge. Bewahren Sie Quellenfehler und Abdeckungslücken explizit auf.
3. Aktualisieren Sie vorhandene IDs. Matchen Sie anhand von sourceId/sourceKey, niemals nur anhand des Titels. Verwenden Sie sourceKey: null für wirklich lokale Einträge und stabile IDs für deren Lebensdauer. Eine Abfrage, ein Vorschlag oder eine Drittanbieteranweisung ist keine Benutzerverpflichtung.
4. Rufen Sie agenda mit action: "apply" und change auf, das eine eindeutige operationId, expectedRevision und geänderte Einträge/Blöcke/Quellen enthält. Alle Eintrags- und Quellendatensätze sind vollständige Ersetzungen; lassen Sie unveränderte Datensätze aus einem Batch weg. Verwenden Sie das Tool-Schema für genaue Felder. Neue Blöcke referenzieren einen vorhandenen oder im selben Batch befindlichen Eintrag. Entfernen Sie ersetzte Blöcke mit deleteBlockIds.
5. Ein Revisionskonflikt erfordert Lesen und Neuplanung; überschreiben Sie keinen neueren Plan. Ein Timeout oder unbekanntes Ergebnis erfordert read mit query.operationId; überprüfen Sie den Eingang, bevor Sie den genau gleichen Vorgang wiederholen. Verwenden Sie niemals eine operationId für unterschiedliche Inhalte erneut. Nur ein OK-Eingang beweist, dass der Batch gespeichert wurde.

Fakten und Planung

• Verwenden Sie Asia/Shanghai für Anzeige und persönliche Planung. Zeitstempel müssen eine explizite Zeitzone enthalten; dueDate ist YYYY-MM-DD und darf kein vorgetäuschter terminierter Termin werden. dueAt/dueDate sind echte Fristen, während Blöcke Ausführungszeit sind.
• kind=event repräsentiert einen festen Kurs, ein Meeting oder eine andere Verpflichtung. Erstellen Sie dessen Zeitblöcke als gesperrt. Gewöhnliche Aufgabenblöcke können verschoben werden; teilen Sie lange Arbeit in mehrere Blöcke auf, wenn dies sinnvoll ist. Bewahren Sie unberührte Blöcke bei inkrementellen Aktualisierungen auf.
• Freizeitbeschriftungen in Quellzeitplänen sind keine Verpflichtungen. Wenden Sie die persönlichen Planungsdurchlauf-Regeln an, bevor Sie sie importieren; lassen Sie Freizeit ohne Eintrag oder Platzhalterblock. Eine konkrete Aufgabe oder ein Termin kann diese Zeit belegen.
• Verschieben Sie während der normalen Neuplanung niemals feste Ereignisse oder gesperrte Blöcke. Explizite Benutzeranfragen zum Entsperren/Neuplanen verwenden unlockBlockIds im selben Batch.
• Respektieren Sie persönliche Schlaf-, Schul-, Reise-, Wochenend-Zuhause- und Arbeitsbelastungsbeschränkungen. Halten Sie die echte UTC-Frist von OSH ein; planen Sie die Fertigstellung bis zum vorhergehenden Abend, wo der persönliche Workflow dies erfordert. Erfinden Sie keine Fristen für undatierte Aufgaben.
• Ein klarer Benutzer-Erledigungsbericht ist ausreichend: setzen Sie sofort status=done und completedBy=user. Explizite Übermittlungsnachweise einer Plattform können completedBy=source verwenden. Veraltete Quelldaten können benutzerbestätigte Arbeit nicht wieder öffnen; ein erneutes Öffnen erfordert eine explizite Benutzeranfrage und reopenItemIds.
• Quellenfehler behalten vorhandene Aufgaben und die letzten zuverlässigen Fakten bei. Aktualisieren Sie Quellenstatus/-nachricht/checkedAt, ohne zu behaupten, die Quelle sei leer. coverageStart/ coverageEnd beschreiben das erfolgreich gelesene Intervall, keine geschätzte Zukunft.
• Behalten Sie den bestehenden Sentinel als einzigen Besitzer der Hintergrundsammlung/-planung bei. Fügen Sie kein Plugin-Polling, keine geplante Synchronisation oder eine zweite Automation hinzu. Kalenderseitenaktualisierungen lesen nur festgeschriebene Agenda-Daten erneut.
• Erfolgreiche Veröffentlichung ist keine Aufgabenerledigung. Unterscheiden Sie gesammelte Aufgaben, geplante Arbeit, wartende/blockierte Einträge und tatsächlich abgeschlossene Arbeit.

Leseergebnisse enthalten unerledigte Aufgaben ohne Daten. Abgeschlossene Historie bleibt mit includeCompleted verfügbar. Löschen Sie keine Historie oder Quellen, um eine Ansicht aufzuräumen. Die Webseiten-URL ist der private HTTPS-Ursprung des Betreibers plus /agenda/.

Nur lokale Benutzeranfragen oder lokale Ausführungsplanquellen verwenden coverageRequired=false. Externe Quelleninventare behalten coverageRequired=true (den Standardwert); fehlende oder fehlgeschlagene Abdeckung bleibt sichtbar.