MakionDocs ← makion.dev

Methodik

Im Methodik-Reiter definiert ein Admin, wie der Agent in einem Projekt arbeitet — die Standards, die er stets befolgt, die Methodik für jede Rolle und die Referenzdateien, die er bei jedem Lauf liest. So bringen Sie Makion dazu, der exakten Arbeitsweise Ihres Teams zu folgen, in Ihren Worten, statt generischer ABAP-Voreinstellungen.

Alles auf diesem Reiter ist nur von einem Projekt-Admin oder Superadmin bearbeitbar. Alle anderen sehen den Reiter in schreibgeschützter Form mit dem Hinweis „Schreibgeschützt — ein Administrator bearbeitet dies.", sodass sie die Standards sehen können, an die der Agent gebunden ist, ohne sie ändern zu können.

Die Methodik ist pro Projekt. Wenn zwei Teams an verschiedenen SAP-Systemen mit verschiedenen Standards arbeiten, geben Sie ihnen getrennte Projekte — siehe Projekte konfigurieren — und stimmen Sie die Methodik jedes Projekts unabhängig ab.

Wie die Schichten zusammenwirken#

Makion steuert den Agenten aus drei Schichten auf einmal. Bei jedem Lauf werden sie zu dem Kontext kombiniert, aus dem der Agent arbeitet:

  1. Basisregeln — immer angewendet, für jede Aufgabe im Projekt.
  2. Die Methodik der gewählten Rolle — der System-Prompt für die Rolle, die der Entwickler im Chat ausgewählt hat (zum Beispiel eine Build-Rolle vs. eine schreibgeschützte Review-Rolle).
  3. Dateien der Wissensdatenbank — Standards und Beispiele, die bei jedem Lauf in den Kontext des Agenten materialisiert werden.

So wird eine einzelne Anfrage geformt durch Basisregeln + die gewählte Rolle + die Wissensdatenbank, zusammen. Basisregeln setzen die Grundwahrheit für das ganze Projekt; die Rolle grenzt sie auf den Aufgabentyp ein; die Wissensdatenbank liefert die konkreten Muster und Beispiele.

Die drei Blöcke#

Block Was er enthält Wer bearbeiten darf
Basisregeln Die Methode & Standards, die der Agent in diesem Projekt immer befolgt Projekt-Admin / Superadmin
Rollen Die Methodik für jede Rolle, die der Entwickler im Chat wählen kann Projekt-Admin / Superadmin
Wissensdatenbank Dateien, die der Agent beim Arbeiten liest Projekt-Admin / Superadmin

Basisregeln#

Basisregeln sind die Methode und Standards, die der Agent in diesem Projekt immer befolgt, egal welche Rolle gewählt ist. Eine Statuszeile sagt Ihnen, woher die aktuellen Regeln stammen:

Steuerelement Was es tut
Basisregeln-Textfeld Ein großer Editor mit dem vollständigen Basisregeltext, den der Agent immer anwendet.
Basisregeln speichern Speichert Ihre Änderungen und schaltet den Status auf „Für dieses Projekt angepasst."

Schreiben Sie Basisregeln in natürlicher Sprache: Namenskonventionen, Clean-Core-Erwartungen, Transportdisziplin, Review-Gewohnheiten — was auch immer der Agent bei jeder Aufgabe beachten muss.

Rollen#

Der Block Rollen definiert die Methodik für jede Rolle, die der Entwickler im Chat wählen kann. Eine Rolle ist zugleich eine Berechtigungsgrenze und eine Arbeitsweise: Schreibgeschützte Rollen können SAP nicht ändern, und diese Grenze wird in den Werkzeugen durchgesetzt, die dem Agenten gegeben werden, nicht nur im Text beschrieben. Das vollständige Bild, wie Rollen den Agenten eingrenzen, finden Sie unter So funktionieren Rollen und Entwickler-Rollen.

Rollen erscheinen als Reiter — einer pro Rolle. Eine angepasste Rolle zeigt eine „angepasst"-Markierung, sodass Sie auf einen Blick erkennen, welche Rollen Sie maßgeschneidert haben und welche noch auf Standardwerten stehen.

Für die ausgewählte Rolle können Sie bearbeiten:

Steuerelement Was es tut
Bezeichnung Der Anzeigename der Rolle, wie er in der Rollenauswahl im Chat erscheint.
Beschreibung Eine kurze Zeile, die beschreibt, wann diese Rolle zu verwenden ist.
Darf SAP ändern (Schreiben) Ob diese Rolle in SAP schreiben darf. Nicht aktiviert = schreibgeschützt: Dem Agenten werden nur Lesewerkzeuge übergeben, und er kann SAP physisch nicht ändern.
Inhalt-Textfeld Die Methodik / der System-Prompt der Rolle — wie der Agent diesen Aufgabentyp angehen soll.
Rolle speichern Speichert Bezeichnung, Beschreibung, Schreib-Flag und Inhalt für diese Rolle.
Auf Standard zurücksetzen Stellt bei einer angepassten eingebauten Rolle Makions ausgelieferten Standard wieder her. Entfernt die „angepasst"-Markierung.

Darf SAP ändern (Schreiben) entscheidet, ob der Agent Ihr System in dieser Rolle verändern kann. Lassen Sie es für alles, was nur untersuchen oder prüfen soll, deaktiviert. Schreibgeschützt bedeutet schreibgeschützt — die Schreibwerkzeuge werden dem Agenten nie übergeben.

Rollen abzustimmen ist der wirkungsvollste Teil des Methodik-Reiters: So kodiert ein Admin „genau so bauen, prüfen und supporten wir ABAP" in jedes Gespräch. Beginnen Sie bei Projekte konfigurieren, wenn Sie die Methodik eines neuen Projekts aufsetzen.

Wissensdatenbank#

Die Wissensdatenbank enthält Dateien, die der Agent beim Arbeiten liest — Ihre Standards, Muster und durchgearbeiteten Beispiele. Diese Dateien werden bei jedem Lauf in den Kontext des Agenten materialisiert, sodass alles, was Sie hier ablegen, Referenzmaterial ist, auf das sich der Agent direkt stützen kann.

Steuerelement Was es tut
Dateiliste Alle Wissensdateien des Projekts, nach Pfad.
Add Eine neue Datei anlegen. Geben Sie ihr einen Pfad wie knowledge/patterns/my-rule.md.
Editor Der Inhalt der ausgewählten Datei.
Edit Die ausgewählte Datei zum Ändern öffnen.
Save Den Inhalt der aktuellen Datei speichern.
Delete Die ausgewählte Datei aus der Wissensdatenbank entfernen.

Verwenden Sie Ordner im Pfad (zum Beispiel knowledge/patterns/… oder knowledge/examples/…), um die Basis organisiert zu halten, während sie wächst. Gute Kandidaten: ein kanonisches Beispiel „wie wir einen Report strukturieren", ein bevorzugtes Muster zur Fehlerbehandlung, ein Spickzettel für Namenskonventionen, eine Checkliste, die der Agent vor dem Abschluss durchgehen soll.

Basisregeln eignen sich am besten für kurze, immer wahre Prinzipien. Die Wissensdatenbank eignet sich am besten für längeres Referenzmaterial und konkrete Beispiele, die der Agent nachahmen soll. Zusammen erlauben sie es Ihnen, „den Standard mit der Zeit wachsen zu lassen", ohne die Basisregeln aufzublähen.

Wie es weitergeht#