Zum Hauptinhalt springen

ideon write [idea]

Was dieser Befehl macht

ideon write [idea] führt die vollständige Ideon-Pipeline aus, um eine erforderliche primäre Ausgabe plus optionale sekundäre Ausgaben zu generieren, mit optionalem Bildrendering, wenn Artikel-Ausgabe ausgewählt ist.

Verwendung

ideon write [idea] [--idea <idea>] [--audience <description>] [--job <path>] [--primary <type=1>] [--secondary <type=count> ...] [--style <style>] [--intent <intent>] [--length <size-or-words>] [--no-interactive] [--dry-run] [--enrich-links] [--link <expression->url>] [--unlink <expression>] [--max-links <n>]

Argumente und Optionen

Flag/ArgumentKurzformErforderlichTypStandardErlaubte WerteBeschreibung
[idea]KeinNeinZeichenfolgen/aBeliebiger natürlichsprachlicher TextPositionaler Ideenprompt, wenn --idea nicht bereitgestellt wird.
--idea <idea>-iNeinZeichenfolgen/aBeliebiger natürlichsprachlicher TextExpliziter Ideenprompt. Hat Vorrang vor positionaler Idee.
--audience <description>KeinNeinZeichenfolgeAllgemeines nicht-spezifisches PublikumBeliebiger natürlichsprachlicher TextPublikumshinweis, der von der Shared-Plan-Planung verwendet wird.
--job <path>-jNeinZeichenfolge (Pfad)n/aGültiger JSON-DateipfadLädt Job-Definition aus Datei.
--primary <type=1>KeinJa im nicht-interaktiven ModusZeichenfolgeTTY-Eingabeaufforderung im interaktiven Modusarticle, blog-post, linkedin-post, newsletter, press-release, reddit-post, science-paper, x-post, x-thread mit Anzahl 1Erforderliches primäres Ziel. Die primäre Anzahl muss genau 1 betragen.
--secondary <type=count>KeinNeinWiederholbare ZeichenfolgeKeineGleiche Zieltypen wie primär, Anzahl >= 1Optionale wiederholbare sekundäre Ziele.
--style <style>KeinNeinEnumprofessionalacademic, analytical, authoritative, conversational, empathetic, friendly, journalistic, minimalist, persuasive, playful, professional, storytelling, technicalSchreibstil, der auf alle generierten Inhalte angewendet wird.
--intent <intent>KeinJa im nicht-interaktiven ModusEnumTTY-Eingabeaufforderung im interaktiven Modusannouncement, case-study, cornerstone, counterargument, critique-review, deep-dive-analysis, how-to-guide, interview-q-and-a, listicle, opinion-piece, personal-essay, roundup-curation, tutorialInhaltsabsicht, die Struktur und Argumentform über alle generierten Ausgaben steuert.
--length <size-or-words>KeinNeinEnum oder Ganzzahlmedium-Alias (900 Wörter)small, medium, large oder positive GanzzahlZiel-Inhaltslänge in Wörtern. Aliase ordnen small=500, medium=900, large=1400 zu.
--no-interactiveKeinNeinBooleschfalsetrue oder weggelassenDeaktiviert alle Eingabeaufforderungen und schlägt schnell fehl, wenn erforderliche Eingaben fehlen.
--dry-runKeinNeinBooleschfalsetrue oder weggelassenFührt Orchestrierung ohne Anbieter-API-Aufrufe aus.
--enrich-linksKeinNeinBooleschfalsetrue oder weggelassenFührt die Link-Anreicherungsstufe nach der Markdown-Generierung aus.
--link <expression->url>KeinNeinWiederholbare ZeichenfolgeKeine"text->https://..."Fügt einen benutzerdefinierten Link in die Sidecar hinzu oder aktualisiert ihn. Format: expression->url. Wiederholbar. Benutzerdefinierte Links haben Vorrang vor generierten.
--unlink <expression>KeinNeinWiederholbare ZeichenfolgeKeineBeliebiger AusdrucksstringEntfernt einen benutzerdefinierten Link nach Ausdruck. Wiederholbar.
--max-links <n>KeinNeinPositive GanzzahlAbgeleitet von --lengthBeliebige positive GanzzahlBegrenzt die Anzahl der generierten Links. Gilt nicht für benutzerdefinierte Links. Erfordert --enrich-links.
--publication <slug>KeinNeinZeichenfolgen/aGültiger Veröffentlichungs-SlugVeröffentlichungs-Slug für Standardwerte und redaktionelle Richtlinie.
--series <slug>KeinNeinZeichenfolgen/aGültiger Serien-SlugSerien-Slug für Standardwerte und thematischen Kontext. Serie überschreibt Veröffentlichungs-Standardwerte.
--from-queueKeinNeinBooleschfalsetrue oder weggelassenDen nächsten ausstehenden Artikel aus der Warteschlange entnehmen und schreiben. Mit --publication wird nach Veröffentlichung gefiltert.

Beispiele

Minimaler Glückspfad
ideon write "How AI changes technical publishing"
Häufiger realer Pfad
ideon write "How small editorial teams scale content" --primary article=1 --secondary x-thread=2 --style technical --intent how-to-guide --length large
Mit Serienverknüpfung
ideon write "Deep dive into transformer architectures" --primary article=1 --series ki-tiefenanalysen --publication tech-blog
Sicherheits- und Debug-Pfad
ideon write --dry-run "How to test Ideon pipeline changes" --primary article=1
One-Shot-Agenten-sicherer Pfad
ideon write --no-interactive --idea "How to productionize docs operations" --primary article=1 --style technical --intent tutorial --length 1200
Aus der Warteschlange schreiben
ideon write --from-queue
Aus der Warteschlange für eine bestimmte Veröffentlichung
ideon write --from-queue --publication tech-blog

Nicht-interaktives Verhalten

Wenn --no-interactive gesetzt ist, fragt Ideon nicht nach fehlenden Werten, auch nicht in TTY-Umgebungen.

  • Fehlende Ideeneingabe schlägt sofort fehl.
  • Fehlende --primary, --style, --intent oder --length im nicht-interaktiven Modus schlagen sofort mit umsetzbaren Fehlern fehl.
  • --length akzeptiert Aliase (small, medium, large) oder eine positive Ganzzahl-Wortanzahl.
  • Dies ist der empfohlene Modus für One-Shot-Agenten- und CI-Workflows.
  • Link-Anreicherung ist ein Generierungsnachgang-Vorschlagsdurchlauf für berechtigte Langform-Markdown-Ausgaben.
  • Ideon wählt linkbare Ausdrücke aus, relevante Quell-URLs mit Modell + Websuche auf und schreibt Ergebnisse in *.links.json-Sidecar-Dateien.
  • Die ursprünglichen Markdown-Dateien werden durch diesen Schritt nicht umgeschrieben.
  • Während ideon write wird die Anreicherung nur ausgeführt, wenn --enrich-links bereitgestellt wird.
  • Kurzform-Kanäle wie x-post und x-thread werden übersprungen.
  • Verwenden Sie --link "expression->url", um benutzerdefinierte Links hinzuzufügen, die separat gespeichert und immer einbezogen werden (siehe ideon links für vollständige benutzerdefinierte Link-Semantik).
  • Verwenden Sie --max-links <n>, um die Anzahl der generierten Links zu begrenzen; Standardwerte sind 5 / 8 / 12 basierend auf --length.

Ausgabe und Beendigungscodes

Bei Erfolg schreibt Ideon Generierungsausgaben unter output/<timestamp>-<slug>/ und druckt Pipeline-Abschluss-Details.

BeendigungscodeBedeutung
0Schreiben erfolgreich abgeschlossen.
1Validierungs- oder Laufzeitfehler aufgetreten.
130Befehl wurde durch Ctrl+C unterbrochen.

Verwandte Befehle

Versionierung und Veraltungshinweise

  • Aktuelles Verhalten gilt für Ideon 0.1.6.
  • Veraltete --target-Syntax wurde durch --primary und wiederholbare --secondary ersetzt.