CommunitySchreiben & Editierengithub.com

AIKONG2024/paper-translate-agent-skill

Portable Agent-Fähigkeit für aktive Chat-Modell-PDF-Übersetzung mit fortsetzbaren Batch-Vorgängen und layouttreuer Darstellung.

Was ist paper-translate-agent-skill?

Diese Fähigkeit ermöglicht es einem AI-Agenten (wie z. B. Claude Code), PDF-Dokumente mithilfe eines aktiven Chat-Modells zu übersetzen, wobei die Layout-Treue erhalten bleibt. Der Agent übernimmt die Übersetzung selbst, während lokale Skripte das PDF vorbereiten, Übersetzungsbatches verwalten und die Ausgabe rendern und validieren. Besonders nützlich für wissenschaftliche Arbeiten oder mehrseitige Dokumente: Der Prozess kann pausiert und fortgesetzt werden – der Job-Ordner speichert den Fortschritt, sodass keine Arbeit verloren geht. Der Workflow umfasst Schritte wie Doctor (Systemprüfung), Setup (Abhängigkeiten installieren), Prepare (PDF in Batches aufteilen), Next (nächsten Batch abrufen), Submit (Übersetzung einreichen), Render (Ausgabe erstellen) und Validate (Qualitätsprüfung). Die Fähigkeit erfordert lokalen Dateizugriff, Python, Shell-Zugriff und UTF-8-Lese-/Schreibrechte; fehlende Fähigkeiten werden gemeldet. Unterstützt optionale Glossare und akademischen Stil, sowie zweisprachige oder reine Übersetzungsausgabe. Standardmäßig wird nur der übersetzte Text ausgegeben.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add AIKONG2024/paper-translate-agent-skill

Installed? Explore more Schreiben & Editieren skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

PDF-Übersetzung

Das aktive Chat-Modell ist der Übersetzer. Gebündelte Skripte bereiten lediglich lokale PDF-Arbeiten vor, persistieren, rendern und validieren sie; sie rufen niemals ein Modell, eine Provider-API oder einen authentifizierten Dienst auf. Die Standardausgabe ist die reine Übersetzung.

Kompatibilitätsgrenze

Überprüfe vor dem Start, ob der Host über lokalen PDF-Zugriff, UTF-8-Datei-Lese-/Schreibzugriff, Python-Prozessausführung, Shell-Zugriff und die Berechtigung zur erstmaligen Einrichtung von Abhängigkeiten verfügt. Fehlt irgendeine Fähigkeit, stoppe und melde: Unsupported host: pdf-translate requires local files, UTF-8 read/write, Python, shell access, and first-run setup. Versuche keinen Fallback.

Arbeitsablauf

Entnimm die Zielsprache und den Seitenbereich aus der Anfrage. Leite eine fehlende Quellsprache von der ersten textbehafteten Seite ab; frage nur nach, wenn eine der Sprachen mehrdeutig ist. Verwende ein beschreibbares <job-verzeichnis> und führe aus:

<python> pdf-translate/scripts/run.py doctor --json
<python> pdf-translate/scripts/run.py setup --json
<python> pdf-translate/scripts/run.py prepare --source <pdf> --job-dir <job-verzeichnis> --source-lang <code> --target-lang <code> [--pages <bereich>] [--output-mode translated|bilingual] [--glossary <datei>] [--style academic]
<python> pdf-translate/scripts/run.py next --job-dir <job-verzeichnis> --json
<Das aktive Chat-Modell liest batch_path und schreibt nur {"translations":[{"id":"...","text":"..."}]} in das zurückgegebene, job-eigene response_path>
<python> pdf-translate/scripts/run.py submit --job-dir <job-verzeichnis> --input <batch-antwort-pfad>
<Wiederhole next/submit, bis der Status READY_TO_RENDER ist>
<python> pdf-translate/scripts/run.py render --job-dir <job-verzeichnis> --json
<python> pdf-translate/scripts/run.py validate --job-dir <job-verzeichnis> --json

Für einen vorhandenen Job führe <python> pdf-translate/scripts/run.py status --job-dir <job-verzeichnis> --json anstelle von prepare aus und fahre mit der nächsten Aktion fort. Befolge diesen Entscheidungsbaum genau: doctor/setup -> prepare oder status -> next -> aktive Modellübersetzung -> submit -> wiederholen -> render -> validate -> PDF zurückgeben. render bereitet die Ausgabe nur vor; validate veröffentlicht sie erst, nachdem alle blockierenden strukturellen Prüfungen bestanden sind. Gib nur den nicht-konfliktierenden endgültigen PDF-Pfad zurück, der von einem erfolgreichen validate gemeldet wird, zusammen mit linguistischen Warnungen und den Vorschaupaaren (erste/mittlere/letzte) zur visuellen Inspektion. Lies die Übersetzungsrichtlinie vor dem Übersetzen und das Job-Format vor dem Verarbeiten von Job-JSON. Wenn die Arbeit vor dem Abschluss endet, melde das <job-verzeichnis>, damit eine spätere Aufgabe von Dateien und nicht vom Transkriptverlauf fortgesetzt werden kann.

Verwandte Skills