Was macht align?
Verwenden Sie $align, um den Kontext vor einer Aktion anzugleichen. Der Skill ist für Aufgaben gedacht, bei denen
Mensch, Projektagent, WebGPT, $scillm, $ask, $dogpile, $memory oder
$project-knowledge jeweils unterschiedliche Fakten kennen. Er erzeugt eine
alignment_lock.json, von der spätere Skills ausführen können.
Verwenden Sie $align nicht zum Implementieren, Rendern, Refaktorisieren oder Überprüfen endgültiger Arbeiten. Es ist
ein Tor vor der Ausführung. Kein Code, keine Infografik, kein Dashboard, keine Plan-Iterate-Phase oder
Projekt-Infografik-Rendering sollte beginnen, bis der Ausrichtungs-Lock ready_for_execution: true anzeigt.
Kernregel
Die Ausrichtung ist erst abgeschlossen, wenn alle blockierenden Fragen beantwortet sind und der Lock Folgendes aufzeichnet:
- vereinbartes Ziel
- vereinbarte Nicht-Ziele
- Quellenkontext
- Teilnehmerfakten
- verbleibende Annahmen und Risiken
- Ausgabeform
- Abnahmekriterien
- explizite Bereit/Nicht-Bereit-Entscheidung
Wenn Uneinigkeit besteht, bleibt der Lock auf ready_for_execution: false.
Teilnehmer
Verwenden Sie nur die Teilnehmer, die für die Aufgabe relevant sind:
| Teilnehmer | Rolle |
|---|---|
human | Absicht, Präferenzen, Bereichsnuancen, Abnahmebarriere |
project_agent | Lokaler Repository-Zustand, Einschränkungen, ausführbare nächste Schritte |
project_knowledge | Dauerhafte Projekthistorie und Übernahmenotizen |
memory | Frühere Lektionen und ähnliche gelöste Probleme |
scillm | Direkte Modellkritik über den lokalen LLM-Proxy |
ask | Ask/Oracle/Deep-Review-Laufzeit mit Artefakten; besitzt WebGPT-Routing |
dogpile | Frische externe Recherche, wenn der lokale Kontext unzureichend ist |
webgpt | Browser-/sitzungssichtbarer Kontext und menschliches Urteil |
WebGPT-Aufrufe müssen über $ask webgpt geleitet werden; $ask besitzt bereits das WebGPT-Oracle-Backend und verwendet surf webgpt.submit --no-activate gegen den authentifizierten ChatGPT-Tab des Benutzers. $align ruft surf nicht direkt auf. Senden Sie keine WebGPT-Anfragen über $scillm; $scillm ist für direkte Modellaufrufe wie gpt-5.5, Gemini, Claude oder OpenCode Go gedacht. Behalten Sie die Tab-ID bei, wenn der Mensch sie bereitstellt.
Verwenden Sie $dogpile nur, wenn die Ausrichtung durch fehlendes externes/aktuelles Wissen blockiert wird. Verwenden Sie es nicht für Fakten, die $project-knowledge oder $memory bereits beantworten.
Laufzeit-Routing
+-----------------------+
| $align init |
| Ziel, Ausgabe, Quellen |
+-----------+-----------+
|
v
+-----------------+-----------------+
| Runde N: alignment_brief |
| Teilnehmer teilen Fakten, Lücken, |
| Widersprüche und Fragen |
+-----------------+-----------------+
|
+-----------------+-----------------+
| compile-round extrahiert Fragen |
| Frage[blockierend/nichtblock]: |
+-----------------+-----------------+
|
offene blockierende Fragen?
| ja | nein
v v
+----------------+----------------+ +-------+--------+
| leite jede Frage an Eigentümer | | lock --ready |
| mensch/projekt/memory/prüfer | | schreibt Lock |
+----------------+----------------+ +----------------+
|
v
+----------------+----------------+
| add-response / answer-question |
| aktualisiere brief, erhöhe Runde|
+----------------+----------------+
|
v
Runde N+1
Prüfer-Routen sind optionale Eingaben für eine Runde:
+----------------+
| Runde N brief |
+-------+--------+
|
+-----------------------------+-----------------------------+
| | |
v v v
+--------------------+ +--------------------+ +--------------------+
| WebGPT via $ask | | $scillm direkt | | $ask review/oracle |
| prepare-review | | prepare-review | | prepare-review |
| --reviewer webgpt | | --reviewer scillm | | --reviewer ask |
+---------+----------+ +---------+----------+ +---------+----------+
| | |
v v v
skills/ask/run.sh ask webgpt runde-N-scillm-request.json runde-N-ask-request.md
--webgpt-tab-id <id> modell: gpt-5.5 skills/ask/run.sh ask
| reasoning_effort: hoch --deep-review
v optionales Persona-Prompt
$ask -> surf webgpt.submit |
--no-activate v
| POST localhost:4001/v1/chat/completions
v
authentifizierter ChatGPT-Tab
Externe/aktuelle Recherche:
prepare-review --reviewer dogpile -> runde-N-dogpile-request.md
Nur verwenden, wenn fehlende externe Fakten die Ausrichtung blockieren.
Runden-Schleife
Jede Runde folgt derselben Sequenz:
- Verteile das aktuelle Ausrichtungs-Briefing an die ausgewählten Teilnehmer.
- Jeder Teilnehmer teilt mit, was er glaubt, was die Aufgabe ist.
- Jeder Teilnehmer listet Fakten auf, die er kennt, die andere möglicherweise nicht kennen.
- Jeder Teilnehmer listet Annahmen, Widersprüche und Fragen auf.
- Fasse Fragen zu blockierenden und nicht-blockierenden Mengen zusammen.
- Leite Fragen an die Partei weiter, die sie beantworten kann.
- Aktualisiere das Briefing.
- Stoppe nur, wenn blockierende Fragen gelöst sind oder die maximale Anzahl an Runden erreicht ist.
Wenn die maximale Anzahl an Runden mit offenen blockierenden Fragen erreicht ist, stoppe mit
ready_for_execution: false und lege die kleinste menschliche Entscheidung dar, die benötigt wird.
CLI
WebGPT-Tab-Bindung (CLI-Parität)
Bevorzugen Sie flagloses $ask webgpt aus einem registrierten Arbeitsverzeichnis. /ask erstellt
$browser-oracle automatisch. init und prepare-review persistieren Bindungshinweise in
.align/state.json und geben dieselben Flags auf generierten runde-*-webgpt-ask-command.sh aus.
| Flag | Wann verwenden |
|---|---|
| (keins) | Aktuelles Arbeitsverzeichnis hat Walk-up-Registry + Bindung – bevorzugt |
--browser-oracle-from <verz> | Walk-up-Wurzel überschreiben (Monorepo-Unterverzeichnis) |
--webgpt-project <name> | Explizites Projekt; überspringt YAML-Walk-up |
--webgpt-tab-id <id> | Einmalige Überschreibung; überspringt Walk-up |
--webgpt-url <url> | Nach Konversations-URL auflösen; überspringt Walk-up |
Auflösungsreihenfolge (identisch mit $ask / $surf): --webgpt-tab-id → --webgpt-url →
$browser-oracle Walk-up → --webgpt-project → ein chatgpt.com-Tab (fail-closed).
Einrichtung: $browser-oracle register + bind + doctor --from <verz>. Siehe $browser-oracle
und $ask SKILL.md WebGPT-Tab-Bindung-Abschnitte.
Führen Sie den Skill aus dem Repository oder Projektstammverzeichnis aus, das die Aufgabe besitzt:
skills/align/run.sh init \
--ziel "Eine klare Plan-Iterate-Infografik-Anfrage erstellen" \
--ausgabe-form "Quellenabgeleitetes Storyboard und Web-Infografik-Anfrage" \
--teilnehmer human \
--teilnehmer project_agent \
--teilnehmer project_knowledge \
--teilnehmer scillm \
--teilnehmer ask \
--teilnehmer dogpile \
--teilnehmer webgpt
# Bevorzugen Sie flaglos aus einem registrierten Verzeichnis oder persistieren Sie die Walk-up-Wurzel:
# --browser-oracle-from skills/oc-subagent/personas/mathematics
# Legacy explizite Überschreibung:
# --webgpt-tab-id 837343529
Teilnehmerantworten aufzeichnen:
skills/align/run.sh add-response \
--teilnehmer project_agent \
--runde 1 \
--text "Aufgabe: Den Workflow vor dem Rendern angleichen. Fakt: Die vorherige Visualisierung ist fehlgeschlagen, weil es kein genehmigtes Storyboard gab. Frage[blockierend]: Welches genaue Beispielprojekt soll die Visualisierung verankern?"
Die Runde kompilieren:
skills/align/run.sh compile-round --runde 1
Nur sperren, nachdem blockierende Fragen gelöst sind:
skills/align/run.sh lock --ready --genehmigt-von human
Prüfer-Anfragegenerierung
prepare-review erstellt wiederverwendbare Anfrage-Artefakte für Prüfer. Es ruft
den Prüfer nicht selbst auf.
skills/align/run.sh prepare-review --runde 1 --prüfer scillm
skills/align/run.sh prepare-review --runde 1 --prüfer ask
skills/align/run.sh prepare-review --runde 1 --prüfer dogpile
skills/align/run.sh prepare-review --runde 1 --prüfer webgpt --browser-oracle-from skills/oc-subagent/personas/mathematics
# oder: --webgpt-tab-id 837343529
Verwenden Sie WebGPT, wenn die Überprüfung die authentifizierte ChatGPT-Browser-Sitzung des Menschen
oder browser-sichtbaren Kontext benötigt. Verwenden Sie $scillm, wenn die Überprüfung ein direkter,
wiederverwendbarer Modellaufruf sein soll, z. B. GPT-5.5 mit hohem Reasoning und einem
Persona/System-Prompt:
skills/align/run.sh prepare-review \
--runde 1 \
--prüfer scillm \
--scillm-modell gpt-5.5 \
--reasoning-aufwand hoch \
--persona-prompt "Sie sind ein skeptischer Produktausrichtungs-Prüfer. Konzentrieren Sie sich auf nicht übereinstimmende Annahmen und fehlende Abnahmekriterien."
Empfohlene Aufrufe nach prepare-review:
# scillm direkte Überprüfung
.align/reviews/runde-001-scillm-command.sh
# ask Deep Review oder WebGPT Oracle
skills/ask/run.sh ask "Überprüfen Sie die Ausrichtungsanfrage unter .align/reviews/runde-001-ask-request.md" \
--deep-review --deep-review-target .align/reviews/runde-001-ask-request.md
skills/ask/run.sh ask webgpt "Überprüfen Sie die Ausrichtungsanfrage unter .align/reviews/runde-001-webgpt-request.md" \
--browser-oracle-from skills/oc-subagent/personas/mathematics --oracle-iterationen 1
# dogpile Recherche nur, wenn die Ausrichtung durch fehlende externe Fakten blockiert ist
skills/dogpile/run.sh search "Fakten, die benötigt werden, um diese Ausrichtung zu entsperren" \
--context-datei ".align/reviews/runde-001-dogpile-request.md"
Speichern Sie den resultierenden Prüfertext mit add-response. Prüferbelege sind
Eingaben für die Ausrichtung; sie sind keine Ausführungsgenehmigung an sich.
Live-Kompositions-Integritätsprüfung
sanity.sh ist die schnelle lokale Prüfung. Sie beweist die Runden-Schleife, die blockierenden
Fragen-Schranke, die Prüfer-Anfragegenerierung und das Lock-Schema ohne externes
Kontingent zu verbrauchen.
sanity-live.sh ist die erforderliche reale E2E-Prüfung, bevor $align als
zusammengesetzter Skill bereit erklärt wird. Sie ist opt-in, da sie lebende nachgelagerte Systeme aufruft:
$memory recall --briefüber den echten Memory-Skill- Projektagent-Antwortaufnahme über
$align add-response $dogpile searchmit der generierten Ausrichtungsanfrage als Kontext$ask webgptgegen den authentifizierten browserbasierten WebGPT-Pfad- endgültige
alignment_lock.json-Erstellung erst, nachdem diese Belege validiert wurden
Führen Sie sie nur aus, wenn die lokale Workstation Memory, dogpile-Anmeldeinformationen/Suche, Chrome und eine authentifizierte ChatGPT-Sitzung hat:
ALIGN_LIVE_E2E=1 skills/align/sanity-live.sh
Optionale Steuerungen:
ALIGN_LIVE_E2E=1 \
ALIGN_WEBGPT_TAB_ID=837343529 \
ALIGN_LIVE_AUSGABE_ROOT=/mnt/storage12tb/skills/align/live-e2e \
skills/align/sanity-live.sh
Wenn keine ALIGN_WEBGPT_TAB_ID oder ALIGN_WEBGPT_PROJECT angegeben ist, übergibt die
Live-Prüfung --webgpt-create-tab an $ask; dies erfordert dennoch ein gültiges lokales
Chrome/WebGPT-Setup. Das Nachweis-Artefakt ist standardmäßig
/mnt/storage12tb/skills/align/live-e2e/<zeitstempel>/report.json.
Übersprungene Live-Prüfungen begründen keine Bereitschaft.
Artefakt-Layout
.align/
alignment_state.json
alignment_brief.md
alignment_lock.json
rounds/
round-001/
participant-human.md
participant-project_agent.md
participant-scillm.md
round_summary.md
questions.json
reviews/
round-001-scillm-request.json
round-001-scillm-command.sh
round-001-ask-request.md
round-001-dogpile-request.md
round-001-webgpt-request.md
round-001-webgpt-ask-command.sh
/mnt/storage12tb/skills/align/live-e2e/<zeitstempel>/
report.json
memory.stdout
dogpile.stdout
webgpt.stdout
ask-runs/<ask_id>/
Stopp-Bedingungen
Setzen Sie ready_for_execution: true nur, wenn:
- keine blockierenden Fragen mehr offen sind
- das vereinbarte Ziel und die Nicht-Ziele explizit sind
- die Ausgabeform konkret ist
- die Abnahmekriterien testbar oder überprüfbar sind
- der Quellenkontext benannt ist
- der Mensch oder der delegierte Eigentümer den Lock genehmigt hat
Setzen Sie ready_for_execution: false, wenn:
- blockierende Fragen offen bleiben
- WebGPT,
$scillm,$askoder Projektkenntnisse dem Briefing widersprechen - die Ausgabeform noch abstrakt ist
- ein Teilnehmer fehlende Quellbeweise aufgedeckt hat
- der angeforderte nächste Schritt eher einen Beleg als die Lösung der eigentlichen Aufgabe produzieren würde
Häufige Fehler
- Verwenden Sie
$alignnicht als Ersatz für$interview; verwenden Sie Interview, wenn die fehlende Information rein menschliche Präferenz oder Abnahmekriterien sind. - Verwenden Sie
$alignnicht als Ersatz für$review-code,$review-planoder$plan-iterate; die Ausrichtung findet vor diesen Skills statt. - Fassen Sie WebGPT oder
$asknicht manuell zusammen. Verwenden Sie deren echte Laufzeiten und speichern Sie Artefaktpfade oder Prüfertexte. - Erklären Sie einen Ausrichtungs-Lock nicht für abgeschlossen, weil ein Prüfer ihn bestanden hat. Der Projektagent muss das Ergebnis zusammenführen und blockierende Fragen klären.