Ihr erster Arbeitsablauf

Diese Anleitung zeigt anhand einer Check-in-Belohnung, wie Sie Ihre erste Absicht formulieren, sie prüfen oder implementieren und eine neue Entscheidung festhalten. Sie lernen, anhand des tatsächlichen Projektcodes und der Prüfergebnisse zu beurteilen, ob eine Anforderung erfüllt ist.

Sie benötigen Noea mit einem Agenten im Status „Bereit“ und ein lokales Projekt. Falls es keine Check-in-Funktion besitzt, verwenden Sie eine andere, ebenso konkrete Regel.

Codeprojekt öffnen

Wählen Sie im Arbeitsbereich Ordner öffnen… oder Ablage → Implementierungsordner öffnen… und den Ordner mit Ihrem Code.

Beim ersten Öffnen dieses Ordners erstellt Noea ein verknüpftes Projekt. Ein bestehendes Projekt öffnet sich direkt; sind mehrere verknüpft, werden Sie zur Auswahl aufgefordert. Weitere Möglichkeiten finden Sie unter Projekte öffnen und verwalten.

Die erste Absicht schreiben

Klicken Sie in der Seitenleiste auf Neue Absicht und nennen Sie sie „Tägliche Check-ins“. Noea ergänzt die Dateiendung .noea.md und öffnet das Dokument. Schreiben Sie:

# Tägliche Check-ins

Nutzer können einmal pro Tag einchecken. Nach 7 aufeinanderfolgenden Tagen mit Check-in erhält der Nutzer eine Belohnung.

Sichern Sie unter macOS mit ⌘S, unter Windows / Linux mit Ctrl+S. Beginnen Sie mit dem, was bereits entschieden ist; Sie müssen noch nicht jeden Sonderfall auflisten.

Untersuchung oder Implementierung wählen

Erläutern prüft projektweit Inhalte, deren Erläuterungen Aufmerksamkeit benötigen. Die Aktion Untersuchung eines Absatzes prüft nur diesen Inhalt. Beide untersuchen die Implementierung und erzeugen oder aktualisieren Erläuterungen; sie ändern keinen Code.

Wenn Check-ins bereits existieren, klicken Sie in der Seitenleiste auf Erläutern. Um nur diesen Absatz zu prüfen, bewegen Sie den Zeiger darüber und wählen Sie links Untersuchung.

Wenn die Regel noch implementiert werden muss, starten Sie einen neuen Chat, geben Sie @ ein, wählen Sie das Absichtsdokument und senden Sie:

Implementiere die Check-in-Belohnung in diesem Projekt gemäß der referenzierten Absicht. Untersuche zuerst den vorhandenen Code, halte dich an die Projektstruktur und überprüfe sowohl eine Serie von 7 Tagen als auch einen verpassten Check-in.

Sie können auch die Schaltfläche Umsetzen in der Seitenleiste nutzen, wenn sie verfügbar ist; siehe Mit einem Agenten implementieren. Während der Agent arbeitet, zeigt der Chat Antworten, Werkzeugaufrufe und Dateiänderungen.

Klicken Sie nach der Implementierung auf Erläutern, falls es nicht automatisch startet. Nicht jede Codeänderung in einem normalen Chat löst eine Aktualisierung aus.

Eine Implementierungserläuterung lesen

Kehren Sie zum Absichtsdokument zurück und klicken Sie innerhalb des Absatzes auf eine freie Fläche außerhalb des Texts, um die Randnotiz zu öffnen. Lesen Sie diese Bereiche:

• Umsetzung: wie der Code aufeinanderfolgende Tage zählt und Belohnungen vergibt.
• Nachweis: Code, Befehlsausgaben oder Testunterlagen, auf die sich die Erläuterung stützt.
• Hinweise: Lücken, Implementierungsentscheidungen, Risiken oder Vorschläge, die Ihre Beurteilung erfordern.

Vielleicht stellt sich heraus, dass die Implementierung Kalendertage anhand der Gerätezeitzone definiert. Prüfen Sie, was das Projekt tatsächlich tut und ob es Ihren Anforderungen entspricht. Öffnen Sie die Verweise, um zu beurteilen, wie weit die Nachweise die Erläuterung stützen.

Eine abgeschlossene Erläuterung bedeutet nicht, dass Tests erneut ausgeführt wurden. Unterscheiden Sie Testcode, frühere Ergebnisse und Prüfungen dieses Durchlaufs; siehe Erläuterungen und Nachweise lesen. Erfüllt die Implementierung die ursprüngliche Anforderung nicht, beheben Sie sie, statt die Regel an den Code anzupassen.

Nachfragen und eine Entscheidung festhalten

Bewegen Sie den Zeiger über den Absatz und wählen Sie links Hierzu fragen. Noea fügt einen Verweis in die Chateingabe ein. Ergänzen und senden Sie Ihre Frage:

Wie behandelt die aktuelle Implementierung Reisen über Zeitzonengrenzen? Können Check-ins an zwei Orten die Serie beeinflussen? Erkläre es anhand des Codes.

Wenn Sie das Verhalten verstanden haben, entscheiden Sie, ob Sie die Berechnung einschränken möchten. Falls ja, senden Sie:

Ergänze in dieser Absicht: „Ein Tag richtet sich nach dem Kalenderdatum am aktuellen Aufenthaltsort des Nutzers.“ Schlage mir die Absichtsänderung zuerst zur Prüfung vor.

Wenn der Agent einen Vorschlag einreicht, klicken Sie auf Änderungen ansehen und lesen Sie Einfügungen und Ersetzungen. Bearbeiten Sie bei Bedarf die neue Formulierung und wählen Sie Meine Änderungen annehmen, oder ohne Bearbeitung Annehmen.

Erfordert der Vorschlag Implementierungsarbeit, wird diese nach der Annahme im selben Chat fortgesetzt. Erfüllt die bestehende Implementierung ihn bereits, ist kein neuer Implementierungslauf nötig. Prüfen Sie anschließend die Ergebnisse der Erläuterungsaufgabe oder untersuchen Sie bei Bedarf manuell.

Das Gelernte prüfen

Sichern Sie zum Abschluss das Dokument und prüfen Sie, ob die Erläuterung die aktuelle Formulierung abdeckt. Versuchen Sie, vier Fragen in eigenen Worten zu beantworten:

1. Wie ist diese Anforderung implementiert, und welche Nachweise stützen diese Schlussfolgerung?
2. Welche wichtige Entscheidung hat der Agent getroffen, die nicht in der Absicht stand?
3. Verstehe und akzeptiere ich diese Entscheidung? Soll sie eine dauerhafte Bedingung werden?
4. Welchen Satz würde ich ändern, wenn ich dieses Verhalten künftig ändern möchte?

Sie sollten beispielsweise erklären können, wie ein Tag definiert ist, die Nachweise finden und „7 aufeinanderfolgende Tage“ als Belohnungsbedingung nennen. Bleibt eine Antwort unklar, fragen Sie zum betreffenden Absatz nach.

Sie müssen nicht beim ersten Mal jede Regel erfassen. Ergänzen Sie die nächste bewahrenswerte Entscheidung, sobald sie Ihnen begegnet.

Lesen Sie anschließend Wichtige Absichten formulieren und Erläuterungen und Nachweise lesen.