Clarity Developer Academy · 24 Minuten

Tool Design & Review

Ein deklaratives Clarity Tool entwerfen, prüfen und zur menschlichen Freigabe einreichen.

Alle Lernpfade ‹
Developer arbeiten gemeinsam an der technischen Aufgabe dieses Lernpfads

Guided implementation

Von der Grenze zum überprüfbaren Ergebnis.

  1. 01

    Wirkung vor Oberfläche definieren

    C0 liest oder zeigt, C1 schlägt vor, C2 bereitet eine echte Änderung erst nach ausdrücklichem Ja vor. Höhere Klassen sind für Drittanbieter geschlossen.

  2. 02

    Deklaratives Display beschreiben

    Wähle eines der sechs unterstützten Layouts und nur dokumentierte Spaltentypen.

    {
      "schema": "clarity.tool/v1",
      "name": "Study outline",
      "entry": "study.outline",
      "consequenceClass": "C1",
      "permissions": [
        "profile.read"
      ],
      "display": {
        "layout": "list",
        "icon": "list.bullet.rectangle",
        "color": "blue",
        "columns": [
          {
            "name": "Outline item",
            "type": "text"
          },
          {
            "name": "Done",
            "type": "toggle"
          }
        ]
      }
    }
  3. 03

    Serverseitig validieren

    Die Sandbox lehnt unbekannte Layouts, Typen und Berechtigungen deterministisch ab. Eine Preview führt nichts aus.

  4. 04

    Review mit Begründung

    Reiche Name, Version, Zusammenfassung, Manifest und Konsequenzklasse ein. Eine Freigabe ist eine menschliche Entscheidung und bleibt widerrufbar.

Fertig, wenn …

  • Nur profile.read oder sessions.read beantragt
  • Keine Secrets im Manifest
  • Leerer und fehlerhafter Zustand beschrieben
  • C2 enthält Vorschau und ausdrückliche Freigabe
Tool Design & Review — Clarity Developer Learn — Clarity