CommunitySchreiben & Editierengithub.com

Deno – Agentische Tools für KI-Agenten

Teilbare Fähigkeiten und Werkzeuge für KI-Agenten, speziell für moderne Deno-Projekte mit Hybrid- und Migrationsszenarien.

Was ist Deno – Agentische Tools für KI-Agenten?

Diese Fertigkeit bietet standardisierte Konfigurationen und Best Practices für moderne Deno-Projekte, insbesondere wenn Codebasen Deno mit Node-orientierten Tools mischen, Migrationspfade von älteren Deno-Mustern benötigen oder Deno in ein bestehendes TypeScript- oder Node-Repository integriert werden. Sie unterstützt Plattformen wie Claude Code, Cursor und Codex und legt den Fokus auf klare Ownership-Grenzen zwischen Deno und Node, die Verwendung von `deno.json` als zentrale Konfigurationsquelle und die Bevorzugung nativer Deno-Tools (`deno check`, `deno task`, `deno fmt`, `deno lint`) gegenüber Ad-hoc-Wrappern. Die Fertigkeit behandelt typische Herausforderungen wie die Koexistenz von `tsconfig.json` mit `deno.json`, die Migration von ESLint zu `deno lint`, die Handhabung von npm-CLIs in Deno-Repositories und die bewusste Verwaltung von Berechtigungen. Sie enthält praktische Task-Framing-Tabellen, Kernregeln, Gotchas und ValidierungsChecklisten, um konsistente und sichere Deno-Workflows zu gewährleisten.

Funktioniert mit~Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add swiftpostlabs/agentic-tools

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

Deno

Zweck

Bietet portable Standardwerte für moderne Deno-Projekte, insbesondere wenn die Codebasis Deno mit Node-orientierten Tools mischt, einen sauberen Migrationspfad von älteren Deno-Mustern benötigt oder Deno in ein bestehendes TypeScript- oder Node-Repository integriert wird.

Wann diese Fertigkeit verwendet werden sollte

  • Schreiben von Deno-Skripten, Servern oder Edge-Code.
  • Konfigurieren von deno.json, Aufgaben und Abhängigkeitsquellen.
  • Anpassen bestehender tsconfig.json- oder eslint.config.*-Dateien für die Koexistenz mit Deno.
  • Mischen von Deno-Code mit Node- oder TypeScript-Code in einem Repository.
  • Überprüfen von Deno-Berechtigungen, Tests oder Laufzeitmustern.

Standardwerte

  • Verwenden Sie deno.json als die maßgebliche Quelle für Deno.
  • Bevorzugen Sie deno check, deno task, deno fmt, deno lint und deno test gegenüber Ad-hoc-Wrappern, wenn Deno den Workflow besitzt.
  • Die nativen Tools von Deno sind für Deno-eigenen Code ausreichend; verwenden Sie Yarn nur, wenn das Repository auch Node-verwaltete Pakete oder Skripte außerhalb der Deno-Grenze enthält.
  • Behalten Sie tsconfig.json nur für Node-eigene Pfade oder für TypeScript-Projektgraph-Fälle, die Deno-Arbeitsbereiche und Verzeichnisbereiche nicht sauber ausdrücken können.
  • Denken Sie daran, dass modernes Node TypeScript auch direkt durch integriertes Type-Stripping ausführt; wählen Sie Deno wegen seines Laufzeit-, Berechtigungs-, Abhängigkeits- und Tooling-Modells, nicht nur um tsc oder ts-node zu vermeiden.
  • Bevorzugen Sie deno lint und deno fmt für Deno-eigene Dateien; fügen Sie ESLint nur hinzu, wenn das Repository oder der Editor wirklich das ESLint-Ökosystem benötigt.
  • Wenn Sie ESLint durch deno lint ersetzen, prüfen Sie die bestehende ESLint-Intention und übertragen Sie sie in die Includes, Excludes, Lint-Regeln oder dokumentierte Ausnahmen von deno.json, anstatt die Konfiguration vollständig zu verwerfen.
  • Wenn Sie tsc durch deno check ersetzen, prüfen Sie die vorhandene tsconfig.json und übersetzen Sie relevante Compiler-Optionen, Includes, Excludes, Libs und Strenge-Erwartungen in deno.json oder eine klar abgegrenzte beibehaltene tsconfig.json.
  • Wenn npm-gestützte Editor-Tools wie ESLint in einem Deno-Repository ausgeführt werden müssen, setzen Sie nodeModulesDir: "auto" und umschließen Sie den Befehl mit deno task.
  • Wenn Deno das Abhängigkeitsmanagement besitzt, installieren Sie Abhängigkeiten mit deno add, nicht indem Sie deno run npm:<package> als Ersatz für die Installation behandeln. Verwenden Sie deno add --dev npm:<package> für reine Entwicklungs-CLIs und Tools.
  • Für installierte CLI-Tools benennen Sie die deno task nach dem Tool und rufen Sie die installierte Binärdatei beim Namen auf, z. B. nach deno add --dev npm:sample-tool fügen Sie "sample-tool": "sample-tool" hinzu.
  • Bevorzugen Sie standardmäßig .ts-Module in Deno-eigenem Code; wechseln Sie nicht zu JavaScript, nur um einen Build-Schritt zu vermeiden, den Deno nicht benötigt.
  • Bevorzugen Sie JSR-Pakete, npm:-Spezifizierer oder explizite Import-Map-Einträge gegenüber verstreuten Legacy-URL-Imports.
  • Wenn eine npm-gestützte CLI ein Installations- oder Postinstall-Verhalten hat, das nicht sauber mit einmaliger Ausführung zusammenarbeitet, bevorzugen Sie nodeModulesDir: "auto", erlauben Sie das Paket in allowScripts, fügen Sie die Abhängigkeit mit deno add oder deno add --dev hinzu und rufen Sie die installierte Binärdatei aus einem deno task auf.
  • Deno 2 ist absichtlich kompatibel mit package.json, npm-Paketen und Node-Builtins; behalten Sie Deno-spezifische Konfiguration in deno.json, anstatt zu versuchen, tsconfig.json beide Welten tragen zu lassen.
  • Bevorzugen Sie Web-Standard-APIs und Deno.serve für Server.
  • Behandeln Sie Berechtigungen als Designentscheidung, nicht als nachträglichen Einfall.

Aufgabenrahmen

Befehl oder AktionWasWarumWannErwartetes Ergebnis
Übernahme von tsconfig.json und ESLint sorgfältigEntscheiden, was in der Node-eigenen Konfiguration bleibt und was in deno.json übergeht.Hybride Repos werden schnell laut, wenn beide Toolchains dieselben Dateien besitzen wollen.Wenn Deno in eine bestehende TypeScript- oder Node-Codebasis eingeführt wird.Deno- und Node-Tools haben explizite Eigentumsgrenzen.
Konfigurieren von deno.jsonDefinieren von Aufgaben, Compiler-Optionen und Abhängigkeitskonventionen in Denos Konfigurationsdatei.Deno sollte seinen eigenen Workflow besitzen, anstatt Node-zentrierte Konfiguration versehentlich zu übernehmen.Beim Starten oder Umstrukturieren eines Deno-Projekts.Deno-Befehle und Editor-Verhalten sind konsistent.
Installieren einer Deno-eigenen npm-CLIFühren Sie deno add --dev npm:<package> für Entwicklungstools aus, fügen Sie dann eine gleichnamige Aufgabe hinzu, die die installierte Binärdatei aufruft.Die Abhängigkeit, Lockdatei, lokale Binärdatei und der Aufgaben-Einstiegspunkt bleiben unter Denos Paketmanager abgestimmt.Beim Hinzufügen von Tools wie Codegeneratoren, Browser-Automatisierungs-CLIs, Linter oder Formatierer zu einem Deno-eigenen Workflow.deno.json und die Lockdatei zeichnen die Abhängigkeit auf, und deno task <tool> führt die installierte CLI aus.
Festlegen hybrider GrenzenTrennen Sie Deno-eigene Pfade von Node-eigenen Pfaden in gemischten Repositories.Tooling-Konflikte sind einer der häufigsten Fehler in Hybrid-Repos.Wenn Deno-Code neben Node- oder TS-Tools lebt.Editoren und Befehle kämpfen nicht um dieselben Dateien.
Überprüfen von BerechtigungenWählen Sie explizite Berechtigungen und Aufgaben-Wrapper für den Laufzeitzugriff.Denos Sicherheitsmodell hilft nur, wenn Berechtigungen bewusst gewählt werden.Bevor Sie neue Skripte ausführen oder einen Deno-CLI-Workflow bereitstellen.Dateisystem-, Netzwerk- und Umgebungszugriff sind absichtlich und prüfbar.
Fehlerbehebung bei Deno-WorkflowsVerwenden Sie Deno-native Prüfungen, Debugger-Flags und Modul-Graph-Tools, bevor Sie raten.Viele Deno-Probleme sind Konfigurations-, Berechtigungs- oder Eigentumsprobleme und keine Code-Fehler.Wenn ein Hybrid-Repo oder eine migrierte Toolchain unerwartet reagiert.Die Grundursache wird auf Konfiguration, Berechtigungen oder Laufzeitverhalten eingegrenzt.

Kernregeln

TypeScript, tsconfig.json und Bibliotheken

  • Legen Sie Deno-Compiler-Einstellungen in deno.json unter compilerOptions fest; kopieren Sie keine vollständige Node-tsconfig.json, nur um deno check auszuführen.
  • Bestehende Node- plus TypeScript-Arbeitsbereiche können tsconfig.json behalten; Deno prüft sie, wenn ein Verzeichnis auch deno.json oder package.json enthält.
  • Wenn ein übergeordnetes deno.json compilerOptions definiert, haben diese Vorrang vor überlappenden tsconfig.json-Optionen.
  • Wenn das Ziel darin besteht, tsc zu ersetzen, inventarisieren Sie zunächst das aktuelle tsconfig.json-Verhalten. Bewahren Sie sinnvolle Strenge, Modulauflösung, JSX, Bibliotheks-, Include- und Exclude-Entscheidungen in der Deno-Konfiguration oder dokumentieren Sie, warum sie nicht mehr gelten.
  • Verwenden Sie compilerOptions.lib in deno.json, um die tatsächliche Laufzeitoberfläche zu modellieren. Für SSR- oder Browser- plus Deno-Code bevorzugen Sie Kombinationen wie ["dom", "dom.iterable", "dom.asynciterable", "deno.ns"]; für Deno-Worker bevorzugen Sie ["deno.worker"].
  • Verwenden Sie compilerOptions.checkJs, // @ts-check, @ts-types, @ts-self-types oder compilerOptions.types, wenn JavaScript-Module eine explizite Typprüfung oder Deklarationen benötigen.
  • Behalten Sie tsconfig.json nur, wenn Node-eigene Ordner, TS-Projektreferenzen oder Include- oder Exclude-Granularität es weiterhin erfordern.

Linting, Formatierung und ESLint

  • Verwenden Sie deno lint und den Abschnitt lint in deno.json als Standard-Lint-Eigentümer für Deno-eigenen Code.
  • Verwenden Sie deno fmt und den Abschnitt fmt in deno.json als Standard-Formatierung für Deno-eigenen Code.
  • deno lint deckt bereits ein empfohlenes Regelset ab, das von ESLint inspiriert ist; behalten Sie ESLint nicht aus Gewohnheit.
  • Wenn das Ziel darin besteht, ESLint zu ersetzen, inventarisieren Sie zunächst das aktuelle eslint.config.*-Verhalten. Bewahren Sie sinnvolle Dateibereiche, Globals, Ignores und Regelabsichten in der Deno-Lint/Fmt-Konfiguration oder dokumentieren Sie, welche Regeln absichtlich fallen gelassen werden, weil Deno sie bereits abdeckt oder ablehnt.
  • Wenn benutzerdefinierte Deno-spezifische Regeln erforderlich sind, ziehen Sie lint.plugins in Betracht; beachten Sie, dass die Lint-Plugin-API experimentell ist und Deno 2.2 oder neuer erfordert.
  • Wenn das Repository oder der Editor weiterhin ESLint benötigt, machen Sie es zu einem expliziten sekundären Tool: setzen Sie nodeModulesDir: "auto", erstellen Sie eslint.config.js und umschließen Sie den Aufruf mit deno task, z. B. deno task eslint.
  • Behalten Sie nach Möglichkeit einen Lint-Eigentümer pro Dateisatz. Wenn sowohl deno lint als auch ESLint auf denselben Dateien ausgeführt werden, dokumentieren Sie warum oder rechnen Sie mit doppelten und widersprüchlichen Diagnosen.

Node-Kompatibilität und hybride Repositories

  • Deno 2 versteht package.json, node_modules, npm-Arbeitsbereiche und Node-Builtins; hybride Repos sind ein unterstützter Pfad, keine Problemumgehung.
  • Modernes Node kann TypeScript auch direkt ausführen. Entscheiden Sie in hybriden Repos über Node- versus Deno-Eigentum anhand von Berechtigungen, Abhängigkeitsmodell, Task-Runner und Bereitstellungsziel, nicht nur anhand der TypeScript-Ausführung.
  • Wenn eine package.json existiert und Sie möchten, dass Deno node_modules automatisch erstellt und aktualisiert, setzen Sie nodeModulesDir: "auto". Mit package.json standardmäßig Deno 2 sonst auf "manual".
  • nodeModulesDir ist eine Arbeitsbereichs-Stamm-Einstellung; versuchen Sie nicht, sie pro Arbeitsbereichsmitglied zu setzen.
  • Verwenden Sie deno install oder deno add, wenn Deno den Abhängigkeitsaktualisierungsfluss besitzt. Gehen Sie nicht vom automatischen Installationsverhalten von Deno 1 aus.
  • Verwenden Sie deno add --dev npm:<package> für reine Entwicklungs-npm-CLIs in Deno-eigenen Repositories. Nach dem Hinzufügen machen Sie die Binärdatei über einen deno task verfügbar, z. B. "sample-tool": "sample-tool" anstelle von "sample-tool": "deno run -A npm:sample-tool".
  • Checken Sie die durch deno add erstellten Manifest- und Lockdatei-Updates ein; ein Task-Alias allein ist keine Abhängigkeitsinstallation.
  • Aktivieren Sie Deno-Tooling nicht für einen gesamten gemischten Arbeitsbereich, wenn nur ein Teilbaum Deno ist.
  • Bevorzugen Sie pfadbasierte Editor-Aktivierung wie deno.enablePaths, damit Node- und Deno-Tools nicht um dieselben Dateien kämpfen.
  • Halten Sie die Deno-Grenze in der Ordnerstruktur, in Aufgaben und in der Dokumentation explizit.

Berechtigungen, Umgebung und Sicherheit

  • Bevorzugen Sie enge --allow-*-Flags oder benannte Berechtigungssätze in deno.json gegenüber -A.
  • Verwenden Sie -P oder --permission-set=<name>, wenn das Repository Berechtigungssätze in deno.json definiert.
  • Verwenden Sie --env-file, wenn die CLI .env-Dateien laden soll, oder @std/dotenv, wenn das Programm sie selbst laden muss; beide benötigen dennoch explizite Umgebungs- und Dateiberechtigungen.
  • Bevorzugen Sie das Prinzip der geringsten Rechte für Anwendungscode und halten Sie Umgebungs-, Dateisystem-, Netzwerk- und Unterprozesszugriff in Aufgaben und Beispielen offensichtlich.
  • Behandeln Sie --allow-run und --allow-ffi als Sandbox-Ausweichmöglichkeiten. Vermeiden Sie --allow-run=deno, es sei denn, volles Vertrauen ist ausdrücklich beabsichtigt.
  • Verwenden Sie zur Berechtigungsdebugging oder -prüfung DENO_TRACE_PERMISSIONS=1 und DENO_AUDIT_PERMISSIONS=<pfad>.

Fehlerbehebung und Migration

  • Greifen Sie zu deno check, deno check --all oder deno run --check, wenn Laufzeiterfolg und Typprüfungsverhalten auseinandergehen.
  • Verwenden Sie deno info <einstiegspunkt>, um den Modulgraphen zu inspizieren und das Import-, Cache- und Berechtigungsverhalten zu verstehen.
  • Verwenden Sie deno lint --fix für allgemeine Migrationsbereinigung, bevor Sie jedes Lint-Problem manuell bearbeiten.
  • Verwenden Sie für die Debugger-Einrichtung --inspect-brk, wenn der Prozess kurzlebig ist, --log-level=debug wenn der Inspektor oder die Modulauflösung verwirrend ist, und --strace-ops, wenn die Laufzeit hängt oder unerwartet langsam ist.
  • Verwenden Sie CPU-Profiling-Flags wie --cpu-prof, --cpu-prof-md oder --cpu-prof-flamegraph, wenn es bei der Fehlerbehebung wirklich um die Leistung geht.
  • Migrationshinweise sollten die Deno 2-Standardwerte widerspiegeln: nodeModulesDir verwendet jetzt "none" | "auto" | "manual", deno cache wurde zu deno install --entrypoint, deno vendor wurde zu "vendor": true, Deno.run() sollte zu new Deno.Command() werden und Deno.serveHttp() sollte zu Deno.serve() werden.
  • Verwenden Sie Import-Attribute wie with { type: "json" } anstelle von veralteten Import-Assertions.

Fallstricke

  • Wenn Deno- und Node-Tools dieselben Dateien beanspruchen, werden Editor-Diagnosen laut und irreführend.
  • Wenn package.json existiert, standardmäßig Deno 2 nodeModulesDir auf "manual"; dies zu vergessen ist ein häufiger Grund, warum npm-gestützte Tools halb installiert aussehen.
  • Wenn die VS Code ESLint-Erweiterung Teil des Workflows ist, wird sie Pakete nicht allein aus dem globalen Deno-Cache auflösen; sie benötigt ein lokales node_modules-Verzeichnis.
  • deno run überspringt standardmäßig die Typprüfung, also ist ein erfolgreicher Lauf kein Beweis dafür, dass deno check bestanden wird.
  • Ein deno task, der zu deno run npm:<package> auslagert, ist eine einmalige Ausführungsabkürzung, keine ordnungsgemäße Abhängigkeitsinstallation. Verwenden Sie es nicht als Standardantwort auf "Installiere und richte diese CLI ein" in einem Deno-eigenen Repo.
  • -A ist für vertrauenswürdige Tools akzeptabel, aber es ist der falsche Standard für gewöhnlichen Anwendungscode.
  • Einige npm-CLIs, einschließlich Supabase in echten gemischten Laufzeit-Repos, verlassen sich auf Installationszeitverhalten, das durch deno run npm:... weniger zuverlässig sein kann als durch eine installierte Binärdatei unter node_modules.
  • Alte URL-Import- und gesamte Arbeitsbereichsaktivierungsmuster sind Übergangshilfen, keine modernen Standardwerte.

Validierung

  • deno.json besitzt die Deno-Konfiguration und -Aufgaben.
  • Jede beibehaltene tsconfig.json- oder ESLint-Eigentumsverhältnisse sind explizit und auf die richtigen Dateien beschränkt.
  • Das Ersetzen von ESLint oder tsc bewahrt das nützliche Verhalten aus der vorhandenen Konfiguration oder dokumentiert, warum es absichtlich fallen gelassen wurde.
  • Die Deno- und Node-Teile eines Hybrid-Repos kämpfen nicht um Tooling.
  • Abhängigkeitsspezifizierer sind modern und explizit.
  • Deno-eigene npm-CLIs werden mit deno add oder deno add --dev hinzugefügt, im Manifest und der Lockdatei aufgezeichnet und über Aufgaben ausgeführt, die installierte Binärdateinamen aufrufen.
  • nodeModulesDir, Editor-Aktivierung und jedes npm-gestützte Deno-Tooling sind bewusst konfiguriert.
  • Wenn eine npm-CLI aus Deno-Aufgaben gesteuert wird, konfiguriert das Repository bewusst nodeModulesDir und allowScripts, anstatt sich auf zufällige Installationsnebenwirkungen zu verlassen.
  • Berechtigungen sind absichtlich und dokumentiert, wo sie wichtig sind.
  • Die Fehlerbehebungsanleitung beginnt mit Deno-nativen Prüfungen, bevor auf generische Node- oder TypeScript-Debugging-Ratschläge zurückgegriffen wird.

Referenzen

Verwandte Skills