feat(agenten): Vorlage in vier Bausteine, Anbindungsanleitung, Tooltips (#75)
VORLAGE ZERLEGT
docs/AGENT_PROMPT_TEMPLATE.md war ein Block von 300 Zeilen, den jedes Projekt
vollstaendig einkopierte - auch die, in denen der MCP-Adapter laeuft und die
Werkzeuge ihre Beschreibung selbst mitbringen. Jetzt vier Bausteine:
A Grundhaltung, gilt immer. Vier Regeln, kurz.
B Mit MCP-Adapter: die Reihenfolge, die in keiner Werkzeugbeschreibung
steht - erst nachsehen, dann uebernehmen, dann arbeiten.
C Ohne MCP: der REST-Weg, vollstaendig. Nur wo kein Adapter laeuft.
D Auf der Test-VM.
Ein Projekt mit Adapter traegt damit eine halbe Seite statt zweihundert Zeilen,
die das Modell nie liest und die auseinanderlaufen, sobald sich die
Schnittstelle aendert. Loest #75 (vormals C4).
NEU: docs/AGENTEN_ANBINDEN.md
Was einmalig je Projekt zu tun ist - fuer den Menschen, nicht fuer den Agenten:
Werkbank-Token, Adapter, welche Bausteine, Roadmap-Uebernahme, Test-VM. Dazu
zwei Abschnitte, die sonst gefehlt haetten:
- Was NICHT an die anderen Projekte geht: Testinstanz und tests/e2e gehoeren
zum Deploymentcenter und werden nicht je Projekt nachgebaut. Uebernehmen
laesst sich die Haltung dahinter - Befund bekommt Item UND Testfall,
bekannte Befunde blockieren nicht, fehlende Voraussetzung heisst
uebersprungen und nicht rot.
- Vier Pruefragen an den Agenten nach der Einrichtung. Antwortet er auf
"was steht als Naechstes an" mit dem Inhalt einer Markdown-Datei, fehlt
Baustein A oder der Adapter laeuft nicht.
WEBUI
Die Spaltenkoepfe der Bereichsuebersicht waren Zeichen ohne Erklaerung - wer
die Legende nicht gelesen hat, und das ist der Normalfall, riet was 🧊 heisst.
Jetzt title= samt Fragezeichen-Zeiger und gepunkteter Linie, damit ueberhaupt
erkennbar ist, dass da etwas zu holen ist. Auch Rang, Item, Ziel, Wer und Doku
in der Vorhabenliste, und der Fortschritt mit dem Hinweis, warum
Zurueckgestelltes und Verworfenes nicht in den Nenner zaehlt.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 5
parent
c9bad697e5
commit
93aabfece3
+32
-8
@@ -2281,6 +2281,15 @@ $csrfField = Csrf::field();
|
||||
border-bottom-color: #9cc4ff;
|
||||
}
|
||||
|
||||
/*
|
||||
Spaltenkopf mit Erklärung.
|
||||
|
||||
Ein title= allein findet niemand - es gibt keinen Hinweis darauf,
|
||||
dass da etwas zu holen wäre. Der Fragezeichen-Zeiger und die
|
||||
gepunktete Linie sind die übliche Anzeige dafür und kosten nichts.
|
||||
*/
|
||||
.hilfe { cursor: help; border-bottom: 1px dotted rgba(255,255,255,0.28); }
|
||||
|
||||
.tab-content, .subtab-content { display: none; }
|
||||
.tab-content.active, .subtab-content.active { display: block; }
|
||||
</style>
|
||||
@@ -4035,9 +4044,19 @@ chmod +x update-agent
|
||||
<tr>
|
||||
<th style="width:60px;">Kürzel</th><th>Bereich</th>
|
||||
<?php if ($rmProject === 'all'): ?><th>Projekt</th><?php endif; ?>
|
||||
<th style="width:220px;">Fortschritt</th>
|
||||
<th style="width:90px;">📋</th><th style="width:90px;">🔨</th>
|
||||
<th style="width:90px;">✅</th><th style="width:90px;">🧊 / ❌</th>
|
||||
<!--
|
||||
Spaltenköpfe aus Zeichen brauchen eine Erklärung.
|
||||
Wer die Legende oben nicht gelesen hat - und das ist
|
||||
der Normalfall - rät sonst, was 🧊 bedeutet.
|
||||
title= genügt: ein eigenes Bedienelement für vier
|
||||
Wörter wäre mehr Aufwand als Nutzen.
|
||||
-->
|
||||
<th class="hilfe" style="width:220px;"
|
||||
title="Erledigt im Verhältnis zum tatsächlichen Umfang. Zurückgestelltes und Verworfenes zählt nicht mit — ein Bereich, in dem die Hälfte verworfen wurde, ist nicht zur Hälfte fertig, er ist kleiner geworden.">Fortschritt</th>
|
||||
<th class="hilfe" style="width:90px;" title="Offen — geplant, noch niemand dran">📋</th>
|
||||
<th class="hilfe" style="width:90px;" title="In Arbeit — ein Agent oder Mensch hält das Item gerade">🔨</th>
|
||||
<th class="hilfe" style="width:90px;" title="Erledigt und ausgeliefert">✅</th>
|
||||
<th class="hilfe" style="width:90px;" title="Zurückgestellt (mit benanntem Auslöser) / Verworfen (mit Begründung, nicht erneut vorschlagen)">🧊 / ❌</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
@@ -4107,14 +4126,19 @@ chmod +x update-agent
|
||||
<table>
|
||||
<thead>
|
||||
<tr>
|
||||
<th style="width:60px;">Rang</th>
|
||||
<th style="width:70px;">Item</th>
|
||||
<th class="hilfe" style="width:60px;"
|
||||
title="Reihenfolge in Zehnerschritten. Die Lücken sind Absicht: So lässt sich etwas dazwischenschieben, ohne alles neu zu nummerieren. Ein Strich heißt "keine Meinung" — solche Einträge stehen hinten.">Rang</th>
|
||||
<th class="hilfe" style="width:70px;"
|
||||
title="Die Item-Nummer im Bugtracker. Sie ist zugleich die Kennung, unter der die Begründung in der Projektdatei steht.">Item</th>
|
||||
<th>Vorhaben</th>
|
||||
<th style="width:90px;">Bereich</th>
|
||||
<th style="width:150px;">Stand</th>
|
||||
<th style="width:100px;">Ziel</th>
|
||||
<th style="width:120px;">Wer</th>
|
||||
<th style="width:60px;">Doku</th>
|
||||
<th class="hilfe" style="width:100px;"
|
||||
title="Geplante Zielfassung. Bei erledigten Einträgen die Fassung, in der es tatsächlich gelandet ist.">Ziel</th>
|
||||
<th class="hilfe" style="width:120px;"
|
||||
title="Wer das Item gerade exklusiv hält. Frei heißt: übernehmbar über ?action=next bzw. dc_next_task.">Wer</th>
|
||||
<th class="hilfe" style="width:60px;"
|
||||
title="Steht die Begründung in der Projektdatei? Blatt = doc_anchor gesetzt, Strich = es gibt nur den Zustand. Bei Zurückgestelltem und Verworfenem sollte hier nie ein Strich stehen.">Doku</th>
|
||||
<th style="width:120px;"></th>
|
||||
</tr>
|
||||
</thead>
|
||||
|
||||
Reference in New Issue
Block a user