Skip to content

Commit 3cf6301

Browse files
committed
Add blog post and for project AI-gestützter Ebook-Creator Workflow"
1 parent 4a740f2 commit 3cf6301

15 files changed

Lines changed: 7359 additions & 10749 deletions
613 KB
Loading
1.85 MB
Loading
1.86 MB
Loading
1.62 MB
Loading
1.75 MB
Loading

config/_default/hugo.toml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,7 @@ summaryLength = 20
1717
# prevent build failures when using Hugo's Instagram shortcode due to deprecated Instagram API.
1818
# See https://github.com/gohugoio/hugo/issues/7228#issuecomment-714490456
1919
ignoreErrors = ["error-remote-getjson"]
20+
ignoreLogs = ["warning-goldmark-raw-html"]
2021

2122
timeout = "190s"
2223

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
---
2+
author: d.o.
3+
title: "AI-gestützter Ebook-Creator Workflow"
4+
description: "Dreiteilige Serie zum Setup, Workflow und QA/Publikation mit dem d.o. Ebook-Creator Toolkit"
5+
date: 2025-09-15T09:30:00Z
6+
lang: de-DE
7+
tags:
8+
- AI
9+
- Ebook
10+
- Automation
11+
- Roo Code
12+
- Workflow
13+
- Tutorial
14+
- Web
15+
categories:
16+
- Developer Tools
17+
nested: true
18+
---
19+
Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
---
2+
author: d.o.
3+
title: "Übersicht: AI-gestützter Ebook-Creator Workflow"
4+
description: Komplette Übersicht zur dreiteiligen Serie über Setup, Workflow und QA/Publikation des d.o. Ebook-Creator Toolkits
5+
date: 2025-09-16
6+
lang: de-DE
7+
tags:
8+
- AI
9+
- Ebook
10+
- Automation
11+
- Roo Code
12+
- Workflow
13+
- Tutorial
14+
categories:
15+
- Developer Tools
16+
thumbnail:
17+
url: /img/blog/ubersicht-ai-gestutzter-ebook-creator-workflow.png
18+
author: Gemini 2.5 Flash Image
19+
slug: ubersicht-ai-gestutzter-ebook-creator-workflow
20+
---
21+
22+
{{< alert color="info" >}}
23+
**Repository:** [ebook-roo-code-creator @ Codeberg](https://codeberg.org/d-oit/ebook-roo-code-creator)
24+
**Wiki:** [Projekt-Wiki & Dokumentation](https://codeberg.org/d-oit/ebook-roo-code-creator/wiki)
25+
**Lizenz:** MIT
26+
**Demo-Buch:** "Der Lärm der Gier" – Ein 40.000 Wörter umfassender deutscher Roman
27+
{{< /alert >}}
28+
29+
## Über diese Serie
30+
31+
Diese dreiteilige Serie führt Sie durch den kompletten Workflow des d.o. Ebook-Creators - einem Multi-Agents-Toolkit für AI-gestützte Ebook-Erstellung mit Roo Code und OpenCode CLI (angefangen noch nicht fertig aktuell).
32+
33+
Die Idee dazu hatte ich schon länger. Einige Anfänge Bücher, die nie zu Ende geschrieben worden sind. Gleichzeitig kam mit openrouter/sonoma-sky-alpha und openrouter/sonoma-dusk-alpha 2 kostenlose 2M-Context-Modelle die Möglichkeit, die Idee kostenlos umzusetzen und zu testen. Da das Buch, das nur für die Testerstellung hergestellt wurde, ziemlich unsinnig in Teilen sein wird – gerade der Code ist ziemlich unsinnig. Mir ging es um den grundsätzlichen Workflow und etwas zu haben, das leicht zu demonstrieren und zu erklären ist. Angepasst an OpenCode / Claude Code / andere oder komplett eine eigene Anwendung daraus zu erstellen, ist dann viel einfacher und hat durch die Parallel-Sessions oder Swarm auch gleich mehr Optimierungsmöglichkeiten.
34+
35+
**Sonoma AI**: All prompts and completions for this model are logged by the provider and may be used to improve the model.
36+
37+
Falls jemand Interesse daran haben sollte, gerne melden :-)
38+
39+
## Serie-Übersicht
40+
41+
1. **[Setup & Einrichtung](/de/blog/do-ebook-creator-workflow/setup-ai-ebook-creator)**
42+
- Projekt-Überblick und Struktur
43+
- Voraussetzungen und Installation
44+
- Roo Code und OpenCode CLI Setup
45+
- Konfiguration und Validierung
46+
47+
2. **[Workflow & Agenten](/de/blog/do-ebook-creator-workflow/workflow-ai-ebook-creator)**
48+
- Planung und Recherche mit MCP-Tools
49+
- Drafting-Phase mit ebook-writer
50+
- Rewriting und Expansion
51+
- Best Practices und Kommando-Referenz
52+
53+
3. **[QA & Publikation](/de/blog/do-ebook-creator-workflow/qa-publishing-ai-ebook-creator)**
54+
- Automatisierte Qualitätssicherung
55+
- Schwarm-Analyse mit multi-perspektivischen Bewertungen
56+
- Batch-Verarbeitung und Automatisierung
57+
- Finale Publikation in EPUB, MOBI, PDF
58+
59+
## Key Features
60+
61+
- **Multi-Agenten System:** Spezialisierte Modi für jede Workflow-Phase
62+
- **Qualitäts-Gates:** 95% Erfolgsrate vor Finalisierung
63+
- **Automatisierung:** 70% weniger manuelle Arbeit
64+
- **Research Integration:** MCP-Tools für Tavily und Context7
65+
- **Logging & Metrics:** Detaillierte Nachverfolgbarkeit
66+
67+
## Verwendete Technologien
68+
69+
- **Roo Code:** VS Code Erweiterung für Agenten-Modi
70+
- **OpenCode CLI:** Terminal-Automatisierung
71+
- **LLM APIs:** Anthropic Claude, OpenRouter Modelle
72+
- **Python Skripte:** Workflow-Automatisierung und Validierung
73+
- **Pandoc:** Ebook-Format-Konvertierung
74+
75+
## Zielgruppe
76+
77+
- **Autoren und Content-Creator**, die VS Code verwenden
78+
- **Technik-affine Schriftsteller**, die Automatisierung schätzen
79+
- **Solo-Creatoren**, die Produktionszeit reduzieren wollen
80+
- **Entwickler**, die AI-gestützte Workflows erkunden möchten
Lines changed: 169 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,169 @@
1+
---
2+
lang: de-DE
3+
title: "Teil 3: Qualitätssicherung und Publikation mit dem d.o. Ebook-Creator"
4+
description: "Automatisierte QA, Schwarm-Analyse und finale Ebook-Publikation mit dem AI-Toolkit"
5+
date: 2025-09-12T09:30:00Z
6+
tags:
7+
- AI
8+
- Ebook
9+
- Quality Assurance
10+
- Automation
11+
- Publishing
12+
- Roo Code
13+
author: d.o.
14+
thumbnail:
15+
url: /img/blog/qa-publishing-ai-ebook-creator.png
16+
author: Gemini 2.5 Flash Image
17+
categories:
18+
- Developer Tools
19+
slug: qa-publishing-ai-ebook-creator
20+
21+
---
22+
23+
{{< alert color="info" >}}
24+
**Fortsetzung von:** [Teil 2: Workflow](/de/blog/do-ebook-creator-workflow/workflow-ai-ebook-creator)
25+
**Repository:** [ebook-roo-code-creator @ Codeberg](https://codeberg.org/d-oit/ebook-roo-code-creator)
26+
{{< /alert >}}
27+
28+
## Qualitätssicherung mit Multi-Agenten-System
29+
30+
Die QA-Phase ist entscheidend für die Produktion hochwertiger Ebooks. Der d.o. Ebook-Creator verwendet ein mehrstufiges System aus automatisierten Checks und Schwarm-Analyse.
31+
32+
### Automatisierte QA-Agenten
33+
34+
```bash
35+
# Grammatik-Check
36+
/switch-mode ebook-grammar-checker
37+
/review type:grammar file:book/expanded/kapitel-1.md priority:high
38+
39+
# Rechtschreibungs-Check
40+
/switch-mode ebook-spellchecker
41+
/review type:spell file:book/expanded/kapitel-1.md
42+
43+
# Logik- und Konsistenz-Check
44+
/switch-mode ebook-logic-checker
45+
/review type:logic file:book/expanded/kapitel-1.md focus:"Charakter-Konsistenz, Plot-Löcher"
46+
```
47+
48+
Jeder Check generiert detaillierte Logs in den entsprechenden Unterordnern:
49+
50+
- `logs/grammar/grammar-kapitel-1.md`
51+
- `logs/spellcheck/spellcheck-kapitel-1.md`
52+
- `logs/logic/logic-kapitel-1.md`
53+
54+
### Schwarm-Analyse für narrative Qualität
55+
56+
Die ebook-analysis-swarm verwendet multiple Persönlichkeiten für ganzheitliche Bewertung:
57+
58+
```bash
59+
/switch-mode ebook-analysis-swarm
60+
/analyze-narrative file:book/expanded/kapitel-1.md personas:RYAN,FLASH,SOCRATES
61+
62+
# Oder spezifische Analyse
63+
/analyze file:book/expanded/kapitel-1.md aspect:"Emotionale Tiefe, Themen-Konsistenz"
64+
```
65+
66+
Die Schwarm-Analyse erzeugt umfassende Berichte in `logs/analysis/` mit multi-perspektivischen Einschätzungen.
67+
68+
## Qualitäts-Gates und Metriken
69+
70+
Kapitel müssen 95% der Qualitäts-Gates bestehen bevor sie finalisiert werden:
71+
72+
**Key Metrics:**
73+
74+
- **Fehlerrate:** < 5% (grammatikalisch, logisch)
75+
- **Lesbarkeit:** Flesch-Kincaid Grade Level 8-12
76+
- **Wortzahl:** ±10% vom Ziel
77+
- **Themen-Konsistenz:** > 90% Alignment mit SPARC
78+
79+
```bash
80+
# Metriken überprüfen
81+
python scripts/verify_word_count.py --file book/expanded/kapitel-1.md --target 4000
82+
python scripts/performance-monitor.py --report --days 7
83+
```
84+
85+
## Automatisierung und Batch-Verarbeitung
86+
87+
Für effiziente Verarbeitung mehrerer Kapitel:
88+
89+
```bash
90+
# Batch-Rewriting für mehrere Kapitel
91+
python scripts/workflow-automation.py --batch-rewrite --chapters 1-12
92+
93+
# Performance-Monitoring
94+
python scripts/performance-monitor.py --report --days 7 --format json
95+
96+
# Log-Konsolidierung
97+
python scripts/log-consolidator.py --consolidate --days 7 --format markdown
98+
99+
# Validierung aller Agenten-Konfigurationen
100+
python scripts/validate_agent_configs.py --verbose
101+
```
102+
103+
### Skript-Übersicht
104+
105+
- **`workflow-automation.py`** - Automatisiert Workflow-Schritte
106+
- **`performance-monitor.py`** - Überwacht Ausführungszeiten und Ressourcen
107+
- **`log-consolidator.py`** - Konsolidiert Logs für bessere Übersicht
108+
- **`config-validator.py`** - Validiert YAML-Konfigurationen
109+
- **`assemble_ebook.py`** - Assembliert finale Ebook-Dateien
110+
111+
## Finale Publikation
112+
113+
### Formatierung und Zusammenstellung
114+
115+
```bash
116+
/switch-mode ebook-publication-formatter
117+
118+
# Formatierung für finale Publikation
119+
/format-ebook input:book/expanded/ output:book/final/ format:markdown
120+
121+
# Generierung des Inhaltsverzeichnisses
122+
/generate-toc input-dir:book/final/ output:book/final/TOC.md
123+
124+
# Zusammenstellung des kompletten Ebooks
125+
python scripts/assemble_ebook.py --input-dir book/final/ --output book/final/complete-ebook.md
126+
```
127+
128+
### Ebook-Formate
129+
130+
Das Toolkit unterstützt verschiedene Ausgabeformate:
131+
132+
```bash
133+
# EPUB-Generierung (über Pandoc)
134+
pandoc book/final/complete-ebook.md -o book/published/sdg-hack-hort.epub
135+
136+
# MOBI-Generierung (Kindle)
137+
pandoc book/final/complete-ebook.md -o book/published/sdg-hack-hort.mobi
138+
139+
# PDF-Generierung
140+
pandoc book/final/complete-ebook.md -o book/published/sdg-hack-hort.pdf
141+
```
142+
143+
## Troubleshooting und Best Practices
144+
145+
### Häufige Probleme
146+
147+
- **Agenten-Modus Probleme:** Überprüfe .roomodes; neuinstalliere Roo Code
148+
- **MCP-Fehler:** Prüfe API-Schlüssel/Rate Limits; aktiviere Caching in config
149+
- **Validierungsfehler:** Führe config-validator.py aus; stelle Verzeichnisberechtigungen sicher
150+
- **Workflow-Lücken:** Verwende workflow-automation.py --validate; setze von Checkpoints fort
151+
- **Qualitäts-Fails:** Gehe zurück zu drafts/; Schwarm-Analyse für Root-Cause
152+
153+
### Best Practices für Produktion
154+
155+
- **Wöchentliche Log-Reviews:** Analysiere Logs regelmäßig für Prozessverbesserungen
156+
- **Quarterly Process Improvements:** Passe Workflows basierend auf Metriken an
157+
- **Single-Chapter Focus:** Konzentriere dich auf ein Kapitel zur Zeit für beste Qualität
158+
- **Research Integration:** Verwende [SDG-Goal] Platzhalter für automatische Integration
159+
- **Custom Modes:** Erstelle benutzerdefinierte Modi via create-mode agent
160+
161+
## Fazit und Ausblick
162+
163+
Der d.o. Ebook-Creator automatisiert 70% der Bearbeitungs- und QA-Arbeit und reduziert die Produktionszeit von Wochen auf Tage. Die hohe Machbarkeit für Solo-Creatoren macht das System ideal für Autoren, die VS Code verwenden.
164+
165+
**Kosten-Nutzen:** ROI durch wiederverwendbare Workflows; erweiterbar für Englisch/Sachbücher durch Anpassung von config.language.
166+
167+
**Zukunft:** Integration weiterer MCP-Tools für Multimedia, verbesserte Schwarm-Analyse und erweiterte Automatisierung.
168+
169+
*Artikel-Genese: Dieser Beitrag wurde mit .roomodes, rode-digitaler-co-autor, rode-blog-generator und menschlichem Copy-Editing von Silke Buchta erstellt. AI unterstützte bei Recherche, Codebase-Analyse und Struktur; redaktionelle Feinabstimmung wurde manuell vorgenommen.*
Lines changed: 112 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,112 @@
1+
---
2+
lang: de-DE
3+
title: "Teil 1: Setup der AI-gestützte Ebook-Erstellung"
4+
description: Einrichtung des Multi-Agenten-Toolkits für Ebook-Erstellung mit Roo Code
5+
date: 2025-09-14T09:30:00Z
6+
tags:
7+
- Hugo
8+
- AI
9+
- Ebook
10+
- Automation
11+
- Roo Code
12+
- Setup
13+
author: d.o.
14+
layout: docs
15+
thumbnail:
16+
url: /img/blog/setup-ai-ebook-creator.png
17+
author: Gemini 2.5 Flash Image
18+
categories:
19+
- Developer Tools
20+
slug: setup-ai-ebook-creator
21+
aliases: /de/do-ebook-creator-workflow/setup-ai-ebook-creator
22+
---
23+
24+
{{< alert color="info" >}}
25+
**Repository:** [ebook-roo-code-creator @ Codeberg](https://codeberg.org/d-oit/ebook-roo-code-creator)
26+
**Wiki:** [Projekt-Wiki & Dokumentation](https://codeberg.org/d-oit/ebook-roo-code-creator/wiki)
27+
**Lizenz:** MIT
28+
**Demo-Buch:** "Der Grüne Hort: Hackerin gegen Konzern-Gier" – Ein 27872 Wörter umfassender deutscher Roman über Unternehmensgier, Hacking und persönliche Gesundheitskämpfe. Basierend auf SDGs – die 17 Nachhaltigkeitsziele der UN zum Veranschaulichen von Recherche, Code Überprüfung im Buch, Buchzusammenstellung, Grammatik und Logik Ablauf.
29+
{{< /alert >}}
30+
31+
## Projekt-Überblick
32+
33+
Der d.o. Ebook-Creator mit AI ist ein Demonstrations-Toolkit, das Multi-Agenten-KI für die Ebook-Entwicklung zeigt. Es erstellt "Der Lärm der Gier" aus Originalinhalten von Dominik Oswald, erweitert durch LLM-APIs zu einem vollständigen Roman. Kernwerkzeuge sind Roo Code (VS Code-Erweiterung für Agenten-Modi) und OpenCode CLI (Terminal-Automatisierung). Das System gewährleistet narrative Konsistenz, Qualitätskontrollen (Fehlerrate <5%) und Nachverfolgbare durch Logs.
34+
35+
**Machbarkeit:** Ideal für Autoren, die VS Code verwenden; Einrichtungskosten sind niedrig (API ~$0,01-0,05 pro Seite – oder kostenlose Modelle nutzen), mit hohem Nutzen (3-5x schnellere QA durch Automatisierung). **Einschränkungen:** LLM-Halluzinationen erfordern menschliche Überprüfung; skalierbar für Sachbücher mit benutzerdefinierten Modi.
36+
37+
Hinweis: Mit Roo Code ist es leider nicht so einfach mit Nicht-Claude Modellen komplett flüssig zu arbeiten. Das aktuell Project mit Roo Code ist nur ein Proof of Concept (Machbarkeitsnachweis).
38+
39+
## Projekt-Struktur
40+
41+
```bash
42+
book/ # Inhalts-Stadien
43+
├── drafts/ # Initiale Kapitel (kapitel-{N}.md)
44+
├── rewritten/ # Verbesserte Versionen
45+
├── final/ # Publikationsreif
46+
└── assets/ # Recherche, Diagramme, SPARC-Spezifikationen
47+
logs/ # Agenten-Ausgaben
48+
├── grammar/ # Grammatik-Korrekturen
49+
├── spellcheck/ # Rechtschreibungs-Logs
50+
├── logic/ # Konsistenz-Prüfungen
51+
├── review/ # Qualitätsbewertungen
52+
├── analysis/ # Schwarm-Berichte
53+
└── workflow/ # Prozessverfolgung
54+
research/ # Bezogene Materialien
55+
├── sdg/ # Nachhaltige Entwicklungsziele
56+
├── medical/ # Gesundheitsrecherche (z.B. myasthenie-ähnliche Zustände)
57+
└── technical/ # AI/ethische Dokumente
58+
scripts/ # Utilities (config-validator.py, workflow-automation.py)
59+
config/ # ebook-config.yaml (Agenten, Metriken, MCP-Einstellungen)
60+
.roo/ # Agenten-Regeln und Modi
61+
```
62+
63+
## Quickstart
64+
65+
### Voraussetzungen
66+
67+
- **VS Code** (oder Cursor/VSCodium)
68+
- **LLM API-Schlüssel** (Anthropic Claude empfohlen; OpenRouter für kostenlose Optionen)
69+
- **Python 3.8+** (installiere PyYAML und psutil via pip für Skripte)
70+
71+
### Roo Code Setup (Primär)
72+
73+
1. **Installiere Roo Code**: VS Code Extensions → Suche "Roo Code" ([Marketplace](https://marketplace.visualstudio.com/items?itemName=RooVeterinaryInc.roo-cline)).
74+
2. **Konfiguriere**: Füge API-Schlüssel/Modell in den Einstellungen hinzu (OpenRouter oder andere).
75+
3. **Lade Projekt**: Klone das Repo, öffne in VS Code; führe `/init` für automatische Analyse aus (erzeugt AGENTS.md).
76+
77+
### OpenCode CLI Install (Optional)
78+
79+
```bash
80+
curl -fsSL https://opencode.ai/install | bash
81+
opencode auth login
82+
cd /pfad/zum/projekt
83+
opencode /init
84+
```
85+
86+
### Konfiguration & Validierung
87+
88+
Bearbeite `config/ebook-config.yaml`, um benutzerdefinierte Einstellungen zu konfigurieren (z.B. `target_word_count: 40000`, `quality.metrics.track_error_rate: true`).
89+
90+
```bash
91+
python scripts/config-validator.py config/ebook-config.yaml --verbose
92+
python scripts/config-validator.py --save-schema config/schema.json
93+
```
94+
95+
## Verwendete LLM APIs
96+
97+
Das Projekt unterstützt verschiedene LLM-APIs für Agenten-Operationen, wurde aber mit folgenden spezifischen Modellen entwickelt:
98+
99+
| Modell | Anbieter | Zweck |
100+
|--------|----------|-------|
101+
| openrouter/sonoma-dusk-alpha * | OpenRouter | Fortgeschrittenes Denken und Analyse-Aufgaben |
102+
| openrouter/sonoma-sky-alpha * | OpenRouter | Kreatives Schreiben und Inhaltsgenerierung |
103+
| zai-org/GLM-4.5-Air | Zai.org | Allgemeine AI-Aufgaben und Code-Analyse |
104+
| openrouter/R1 | OpenRouter | Denken / AI-Code / Schwarm-Analyse |
105+
106+
- Kostenlose Testmodelle mit 2 Millionen Kontext-Fenster. Das gesamte Projekt war ursprünglich ein Test für diese Modelle und entwickelte sich zu diesem Projekt.
107+
108+
## Nächste Schritte
109+
110+
Im [Teil 2: Workflow](/de/blog/do-ebook-creator-workflow/workflow-ai-ebook-creator) gehen wir auf den eigentlichen Workflow ein: Drafting, Rewriting und Expansion der Kapitel mit den verschiedenen Agenten-Modi.
111+
112+
*Artikel-Genese: Dieser Beitrag wurde mit .roomodes, rode-digitaler-co-autor, rode-blog-generator und menschlichem Copy-Editing von Silke Buchta erstellt. AI unterstützte bei Recherche, Codebase-Analyse und Struktur; redaktionelle Feinabstimmung wurde manuell vorgenommen.*

0 commit comments

Comments
 (0)