109 lines
3.2 KiB
Markdown
109 lines
3.2 KiB
Markdown
|
# 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:
|
||
|
|
|
||
|
|
```yaml
|
||
|
|
---
|
||
|
|
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.
|
||
|
|
|
||
|
|
```yaml
|
||
|
|
---
|
||
|
|
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`:
|
||
|
|
```bash
|
||
|
|
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: `planning` → `done` (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.
|