Agent-almanac format-citations
git clone https://github.com/pjt222/agent-almanac
T=$(mktemp -d) && git clone --depth=1 https://github.com/pjt222/agent-almanac "$T" && mkdir -p ~/.claude/skills && cp -r "$T/i18n/de/skills/format-citations" ~/.claude/skills/pjt222-agent-almanac-format-citations-c449ab && rm -rf "$T"
i18n/de/skills/format-citations/SKILL.mdZitate formatieren
Zitate und Literaturverzeichnisse über verschiedene akademische Stile hinweg formatieren unter Verwendung von CSL-Definitionen und citeproc-Verarbeitung in R, mit Regeln für Autorenformatierung, Datumsstile, Kursivschrift und DOI-Einbindung.
Wann verwenden
- Umstellung eines Manuskripts von einem Zitierstil auf einen anderen (z.B. APA zu Vancouver)
- Erzeugung eines stilkonformen Literaturverzeichnisses für Zeitschrifteneinreichung
- Prüfung, ob Zitate korrekt nach einem bestimmten Stil formatiert sind
- Erstellung konsistenter In-Text-Zitate und korrespondierender Literaturverzeichniseinträge
- Anpassung eines CSL-Stils für besondere Zeitschriftenanforderungen
Eingaben
- Erforderlich: Bibliographiedaten (BibTeX .bib-Datei oder BibEntry-Objekt)
- Erforderlich: Zielzitierstil (APA 7., Chicago Autor-Jahr, Vancouver, IEEE oder benutzerdefinierte CSL-Datei)
- Optional: Spezifische zu formatierende Zitierschlüssel (Standardmäßig werden alle Einträge formatiert)
- Optional: Dokumentkontext (Quarto .qmd, R Markdown .Rmd oder eigenständig)
- Optional: Sprachgebiet für lokalisierte Formatierung (z.B. Deutsch: „und" statt „and")
Vorgehensweise
Schritt 1: Stilregeln und CSL-Definition laden
Den Zielzitierstil vorbereiten:
- Vordefinierten Stil identifizieren: Standardstile im CSL-Repository unter https://github.com/citation-style-language/styles finden.
- CSL-Datei herunterladen oder lokalisieren: Sicherstellen, dass die .csl-Datei für das Projekt zugänglich ist. Häufige Stile:
| Stil | CSL-Dateiname | In-Text-Format |
|---|---|---|
| APA 7. Auflage | | (Nachname, Jahr) |
| Chicago Autor-Jahr | | (Nachname Jahr) |
| Vancouver | | Nummern [1] |
| IEEE | | Nummern [1] |
| Nature | | Hochgestellte Nummern |
- Sprachgebiet prüfen: CSL-Stile verwenden Sprachgebietsdateien für lokalisierte Begriffe. Sicherstellen, dass das richtige Sprachgebiet konfiguriert ist.
- Benutzerdefinierte Änderungen: Falls der Zielstil von einem Standard-CSL-Stil abweicht, die CSL-XML-Datei bearbeiten oder eine Kopie erstellen.
Erwartet: Die CSL-Stildatei ist geladen und alle stilspezifischen Regeln sind dokumentiert.
Bei Fehler: Falls kein exakter CSL-Stil verfügbar ist, den nächstliegenden Stil als Basis verwenden und die benötigten Änderungen dokumentieren. Häufige Anpassungen: Reihenfolge der Autoren, Datumsformat, Verwendung von Kursivschrift vs. Anführungszeichen für Titel.
Schritt 2: Stilregeln auf Einträge anwenden
Jeden Bibliographieeintrag gemäß den CSL-Regeln formatieren:
-
Autorenformatierung:
- APA: Nachname, Initiale(n). Format, „&" vor dem letzten Autor, max. 20 Autoren
- Vancouver: Nachname Initialen, Komma-getrennt, max. 6 dann „et al."
- Chicago: Erster Autor invertiert, nachfolgende in normaler Reihenfolge
-
Titelformatierung:
- APA: Satzmäßige Großschreibung für Artikeltitel, titelgemäße Großschreibung für Bücher/Zeitschriften
- Vancouver: Satzmäßige Großschreibung, keine Kursivschrift für Artikeltitel
- Zeitschriftennamen je nach Stil abgekürzt oder ausgeschrieben
-
Datum und Volumen:
- APA: (Jahr). Vor dem Titel
- Vancouver: Jahr;Volumen(Ausgabe):Seiten
- IEEE: vol. X, no. Y, S. Z–W, Mon. Jahr
-
DOI/URL-Einbindung:
- APA 7: DOI als
(immer einschließen)https://doi.org/10.xxxx - Vancouver: DOI nach Seitenangaben, optional
- Einige Stile erfordern „Verfügbar unter:" vor URLs
- APA 7: DOI als
-
Seitenangaben und Identifikatoren: Seitenbereiche, Artikelnummern und elektronische Standorte korrekt formatieren.
Erwartet: Jeder Eintrag ist vollständig im Zielstil formatiert mit korrekter Autorenreihenfolge, Zeichensetzung und Typografie.
Bei Fehler: Falls ein Eintrag vom Stil nicht unterstützte Felder hat (z.B. Softwarezitat im Vancouver-Stil), auf den nächsten unterstützten Eintragstyp zurückfallen und die Abweichung dokumentieren.
Schritt 3: In-Text-Zitate generieren
Die in den Dokumenttext eingebetteten Zitationsverweise erstellen:
-
Autor-Jahr-Stile (APA, Chicago):
- Einzelner Autor: (Müller, 2024)
- Zwei Autoren: (Müller & Schmidt, 2024)
- Drei oder mehr: (Müller et al., 2024)
- Narrativ: Müller (2024) berichtet, dass...
- Seitenverweis: (Müller, 2024, S. 45)
-
Nummerierte Stile (Vancouver, IEEE):
- Sequenziell nummeriert in Reihenfolge des ersten Erscheinens: [1], [2], [3]
- Bereiche: [1–3], [1, 3, 5]
- Hochgestellt (Nature): ¹, ²⁻⁴
-
Mehrdeutigkeiten auflösen: Wenn mehrere Einträge zur gleichen Zitation zusammenfallen (gleicher Autor, gleiches Jahr), Buchstabensuffixe hinzufügen: (Müller, 2024a), (Müller, 2024b).
Erwartet: In-Text-Zitate stimmen exakt mit dem Literaturverzeichnis überein und folgen den Regeln des Zielstils.
Bei Fehler: Falls Mehrdeutigkeitsregeln den Stil überkomplizieren, die spezifischen Stilrichtlinien für die Disambiguierung konsultieren (einige Stile verwenden Initialen des Vornamens statt Buchstabensuffixe).
Schritt 4: Literaturverzeichnis zusammenstellen
Die vollständige Literaturliste generieren:
-
Sortierreihenfolge: Nach Stil sortieren:
- APA: Alphabetisch nach Nachname des ersten Autors, dann Jahr
- Vancouver: In Reihenfolge des ersten Erscheinens im Text
- Chicago: Alphabetisch nach Nachname
-
Formatierung: Jeden formatierten Eintrag mit korrekten hängenden Einzügen, Abständen und Trennzeichen zusammenstellen.
-
Überschrift: Geeignete Abschnittsüberschrift verwenden:
- APA: „Literatur" (englisch: „References")
- Chicago: „Bibliographie" oder „Zitierte Werke"
- Vancouver: „Literatur"
-
Ausgabe rendern: Für Quarto/R Markdown den CSL-Prozessor die Formatierung übernehmen lassen. Für eigenständige Ausgabe formatierten Text oder HTML erzeugen.
Erwartet: Ein vollständiges, korrekt geordnetes und formatiertes Literaturverzeichnis, das zum gewählten Stil passt.
Bei Fehler: Falls die Sortierreihenfolge falsch ist, die Sprachgebiet-Einstellungen des CSL-Prozessors prüfen (betrifft die Alphabetisierung in nicht-englischen Namen). Falls Einträge fehlen, sicherstellen, dass alle zitierten Schlüssel in der .bib-Datei vorhanden sind.
Schritt 5: Ausgabe validieren und exportieren
Die formatierte Ausgabe prüfen und liefern:
- Stichprobenprüfung: 3–5 Einträge manuell gegen die Stilrichtlinien prüfen: Autorformat, Interpunktion, Kursivschrift, DOI-Format.
- Querverweis: Sicherstellen, dass jedes In-Text-Zitat einen korrespondierenden Literaturverzeichniseintrag hat und umgekehrt.
- Exportformate: Ausgabe in dem für den Arbeitsablauf benötigten Format liefern:
- Quarto/R Markdown: YAML-Header mit
undbibliography:
konfigurierencsl: - Eigenständig: Formatierten Text, HTML oder Word-Dokument erzeugen
- LaTeX: Formatierten .bbl-Dateiabschnitt erzeugen
- Quarto/R Markdown: YAML-Header mit
Erwartet: Validierte, stilkonforme Zitate und Literaturverzeichnis, bereit für die Einreichung oder Veröffentlichung.
Bei Fehler: Falls die Validierung Inkonsistenzen findet, die CSL-Stilregeln (Schritt 1) mit den stilspezifischen Transformationen (Schritt 2) abgleichen. Häufige Probleme: Groß-/Kleinschreibungsregeln, die vom Bibliographiemanager nicht durchgesetzt werden, fehlende Felder, die zu unvollständigen Einträgen führen.
Validierung
- CSL-Stildatei korrekt geladen und Stilregeln dokumentiert
- Autorenformatierung entspricht den Regeln des Zielstils
- Titel, Daten, Volumina und Seitenangaben korrekt formatiert
- DOIs/URLs gemäß Stilanforderungen eingebunden
- In-Text-Zitate stimmen mit Literaturverzeichniseinträgen überein
- Sortierreihenfolge des Literaturverzeichnisses entspricht dem Stil
- Stichprobenprüfung repräsentativer Einträge gegen Stilrichtlinien bestanden
- Querverweisüberprüfung: keine verwaisten Zitate und keine nicht zitierten Einträge
Häufige Fehler
- CSL-Stile variieren in subtilen Details: Zwei „APA"-Stildateien aus verschiedenen Quellen können unterschiedliche Ergebnisse liefern. Immer das offizielle CSL-Repository (citation-style-language/styles) als Autoritätsquelle verwenden.
- Groß-/Kleinschreibungsregeln zwischen Stilen verwechseln: APA verwendet Satzmäßige Großschreibung für Artikeltitel, aber titelgemäße Großschreibung für Zeitschriftennamen. Eine globale Anwendung einer Groß-/Kleinschreibungsregel erzeugt in den meisten Stilen falsche Ergebnisse.
- Autorenmehrdeutigkeiten nicht auflösen: Wenn zwei Einträge den gleichen Erstautor und das gleiche Jahr haben, erfordern die meisten Stile eine Disambiguierung (Buchstabensuffixe oder zusätzliche Autoreninitialen). Fehlende Disambiguierung hinterlässt mehrdeutige Zitate.
- Sprachgebiet ignorieren: Deutsche Bibliographien brauchen „und" statt „and", „Hrsg." statt „Eds." und passende Datumsformate. Die Sprachgebietskonfiguration im CSL-Prozessor muss zum Dokumentsprachgebiet passen.
- Annehmen, dass alle Zitierstile „Nachname, Jahr" sind: Nummerierte Stile (Vancouver, IEEE) haben grundlegend andere Sortier- und Referenzierungsregeln. In-Text-Zitat-Generierung und Sortierung des Literaturverzeichnisses müssen zum Stiltyp passen.
Verwandte Skills
-- Bibliographiedateien erstellen und bereinigen, bevor die Formatierung angewendet wirdmanage-bibliography
-- Zitate gegen externe Quellen prüfen, bevor sie formatiert werdenvalidate-references
-- Quarto-Dokumente erstellen, die formatierte Zitate konsumierencreate-quarto-report
-- spezialisierte APA-7-Formatierung für Berichte und Manuskripteformat-apa-report