knowledge-base/scripts/subagents/raw-ingest-runner.md
Hector a2f9e07a6a WMT-007+008 prep: token-rotator + raw-ingest templates, ToDo-Erweiterung
- WMT-007 (forgejo-token-rotator): SKILL-Anleitung aus krallen-skills inline eingebettet, weil Skill nicht als OpenClaw-Skill registriert ist. Subagent rotiert autonom, Pit-Eskalation nur bei UI-Login-Fail/Sperre/API-Drift.
- WMT-008 (AMD Ryzen AI Edge-Inferenz): raw-ingest-runner Template angelegt, wartet auf WMT-007 für Push.
- Wiki-AGENTS.md bleibt unverändert (Subagent-Pull über die Task-Beschreibung).
- Trigger: K9ert #6789 Korrektur — ich hatte Pit als Token-Eskalation adressiert statt Subagent.
2026-06-17 09:51:04 +02:00

3.2 KiB

Subagent: raw-ingest-runner (Template)

Auftrag: Roh-Post in Wiki-Pipeline ziehen — Raw-Datei anlegen, Wiki-Seite erstellen/erweitern, Cross-Refs setzen, index.md + log.md updaten.

Schema-Referenz: AGENTS.md im Repo (Raw immutable, Wiki kuratiert, Frontmatter-Pflicht).


Input-Parameter (vom Hauptagent mitgegeben)

  • raw_path: z.B. raw/xpost/2026-06-16_amd-ryzen-ai-edge-inferenz.md
  • source_url: Original-Post-URL
  • source_type: xpost | blog | youtube | other
  • wiki_target: z.B. wiki/concepts/hardware/edge-inference-als-cloud-alternative.md (neu oder erweitern)
  • cross_refs: Liste existierender Wiki-Seiten für Backlinks
  • distributions_kontext: Falls Distributions-Format als Faktum benannt werden muss (z.B. "Tech-Influencer-Channel", "Werbe-finanziert")
  • tok_status: aktueller Token-Status (ok | waiting-on-rotation)

Workflow

1. Raw-Datei anlegen

raw/<source_type>/<datum>_<slug>.md mit Frontmatter:

---
id: <auto-generated or as-given>
type: xpost | blog | youtube | other
source_url: <url>
captured_at: YYYY-MM-DD
captured_by: hector-subagent-raw-ingest-runner
ingest_run: WMT-XXX
distributions_kontext: <string oder leer>
---

# <Titel>

<Post-Inhalt oder ausführliche Zusammenfassung>

IMMER immutable — kein nachträgliches Editieren (außer bei Fehlern mit --amend direkt nach Capture).

2. Wiki-Seite erstellen oder erweitern

Bei neuer Seite: Wiki-Page mit Frontmatter, ≥ 200 Wörter Substanz, Cross-Refs im Text.

Bei Erweiterung: Bestehende Seite lesen, neuen Abschnitt ergänzen mit klarer Überschrift + Datums-Tag.

---
id: <slug>
type: wiki-page
created: YYYY-MM-DD
last_updated: YYYY-MM-DD
cross_refs: [<liste>]
sources: [<raw_ids>]
stubs: 0
---

# <Titel>
...

3. Cross-Refs setzen

  • In neuer Wiki-Seite: alle cross_refs im Text verlinken ([Titel](<slug>.md))
  • In bestehenden Cross-Ref-Seiten: 1 Satz + Link auf neue Wiki-Seite ergänzen

4. index.md + log.md updaten

index.md: Neue Wiki-Seite in passender Kategorie eintragen.

log.md: Eintrag mit Datum, Ingest-Run-ID, neuen/geänderten Pages, Commit-Hashes.

5. Commit + ToDo-Update

Falls tok_status == ok:

git add raw/ wiki/
git commit -m "WMT-XXX: <kurzbeschreibung>"
git push origin main

Falls tok_status == waiting-on-rotation:

  • Commits lokal anlegen, pushen sobald Token rotiert ist (WMT-007 abhängig)
  • ToDo-Eintrag mit Note: pending WMT-007

ToDo-Eintrag updaten: planningdone (oder pending bei Warte-Status).

6. Topic-Report

Standard-URL-Übersicht (siehe Wiki-AGENTS.md § "Reply-Sichtbarkeit"):

  • 🆕 Neue Wiki-Seiten mit Repo-Browse-Link + Commit-SHA
  • 🔧 Maßgeblich veränderte Seiten mit gleichem Schema
  • Distributions-Kontext als Fakt benannt (falls zutreffend)
  • ⚠️ Token-Status (falls relevant)

Pit-Eskalation

NUR bei:

  • Wiki-Konzept existiert schon unter anderem Namen (mögliche Duplikation → Hub-Page-Strategie)
  • Distributions-Kontext ist heikel (z.B. politisch umstrittener Kanal) → Pit-Check vor Veröffentlichung
  • Cross-Validation-Quellen widersprechen sich fundamental → Vor-Pit-Post nicht ins Wiki

Sonst: autonom durchziehen.