Zed

Anbieter: Zed Industries Installationsname: zed Status: GA Native Konfiguration: <project>/.rules

InstallationCopy Anchor Link

apothem install --harness zed --project /path/to/project

Der Adapter schreibt aus der gemeinsamen Regel- und Governance-Oberfläche von Apothem eine Zed-Anweisungsdatei mit Projektgeltungsbereich. Zed liest eine einzige Projekt-Anweisungsdatei, nämlich den ersten Treffer in dieser Liste:

.rules
.cursorrules
.windsurfrules
.clinerules
.github/copilot-instructions.md
AGENT.md
AGENTS.md
CLAUDE.md
GEMINI.md

Es gibt kein werkzeugspezifisches Regelverzeichnis, daher landet die gesamte Apothem-Oberfläche in der flachen Datei .rules an der Spitze dieser Liste.

Außerdem schreibt er die Skills von Apothem sowie die Regeln und Templates, auf die sie verweisen, in Ihr Home-Verzeichnis, bevor er das Projekt anfasst (siehe Dateien außerhalb des Projekts).

Geschriebene Dateien:

• <project>/.rules, die Anweisungsdatei.
• ~/.agents/skills/<name>/SKILL.md für jeden Apothem-Skill und -Befehl, in Ihrem Home-Verzeichnis.
• ~/.config/apothem/rules/ und ~/.config/apothem/templates/, in Ihrem Home-Verzeichnis.

Dateien außerhalb des ProjektsCopy Anchor Link

Die Installation schreibt außerdem die Skills von Apothem in Ihr Home-Verzeichnis, bevor sie irgendetwas im Projekt ändert:

Diese Ordner werden gemeinsam genutzt. Sie gehören nicht exklusiv zum Projekt:

• Jedes Projekt, in das Sie zed installieren, und jede andere Apothem-Installation, die den Ordner nennt, nutzt dieselbe Kopie und schreibt dieselben Dateien, daher spielt die Reihenfolge Ihrer Installationen keine Rolle. Mehrere andere Werkzeuge lesen ~/.agents/skills/ ebenfalls; die Harness-Registry listet sie auf.
• --project legt fest, welche Anweisungsdatei geschrieben wird und zu welchem Projekt die Installation gehört. Es ändert nicht, wohin die Skills gehen.
• Die Installation fügt Ihrem Repository keine Skill- oder Regeldatei hinzu. Das Projekt erhält die Anweisungsdatei sowie den Datenordner .apothem/, den jede Projektinstallation anlegt.
• Die Home-Ordner werden zuerst geschrieben. Schlägt das fehl, etwa weil ein Ordner im Pfad ein Link ist, der aus Ihrem Home-Verzeichnis herausführt (einem Link, der darin bleibt, wird gefolgt), oder nicht beschreibbar ist, bricht die Installation mit dem Fehler ab, bevor sich im Projekt etwas ändert.
• Ein Skill-Ordner mit dem Namen eines Apothem-Skills, den Apothem nicht geschrieben hat, bleibt unangetastet, und die Installation gibt eine Warnung aus, die ihn nennt. Benennen Sie ihn um oder verschieben Sie ihn und führen Sie dann apothem update aus. apothem verify schlägt fehl, solange dieser Name belegt ist.
• Die Dateien umfassen zusammen einige Megabyte.

Die Installation gibt einen Hinweis aus, der die Ordner nennt, die sie außerhalb von --project schreibt, und --dry-run listet sie auf.

Zuordnung von Profil zu nativer KonfigurationCopy Anchor Link

Der Adapter liest Apothems gemeinsames Profil und rendert die Projektdatei .rules bei jedem Lauf von apothem install oder apothem update. Das gemeinsame Profil ist die Quelle der Wahrheit; eine bereits vorhandene .rules (oder projektlokale Änderungen an der generierten Datei) wird gesichert, bevor die nächste Synchronisierung den von Apothem verwalteten Inhalt ersetzt.

KompatibilitätshinweiseCopy Anchor Link

Zed nennt AGENTS.md seine primäre Anweisungsdatei und behält die Projektdatei .rules als unterstützte Kompatibilitätsdatei bei (Zed-Anweisungen). Weil Zed nur den ersten Treffer liest, verdeckt eine neue .rules eine AGENTS.md, eine CLAUDE.md oder jede andere weiter unten in der Liste stehende Datei, auf die sich das Projekt bereits stützt. Die Installation bearbeitet diese Dateien niemals. Wenn .rules nur den Apothem-Block enthält und eine Datei mit niedrigerer Priorität Ihren Text enthält, geben Installation und Aktualisierung eine Warnung aus, die die verdeckte Datei nennt; kopieren Sie die Anweisungen, die Sie benötigen, außerhalb des Apothem-Blocks in .rules, damit sie in Zed erhalten bleiben.

Die globale Anweisungsdatei ~/.config/zed/AGENTS.md und der MCP-Context-Server-Block (.zed/settings.json context_servers) gehören dem Operator; Apothem schreibt sie nicht.

Zed lädt globale Skills nur aus ~/.agents/skills/, in einem flachen Layout mit einem Ordner pro Skill; das ist das Layout, das die Installation schreibt. Zed macht projektlokale Skills von einem vertrauenswürdigen Worktree abhängig, und seine Dokumentation knüpft keine solche Bedingung an den globalen Ordner. Ein Bericht nannte eine Größenbegrenzung für den Skill-Katalog, den Zed an das Modell sendet; Apothem hat sie nicht bestätigt, ebenso wenig, ob ein Skill, der den Modellaufruf abschaltet, darauf angerechnet wird. Die Namen und Beschreibungen der Skills von Apothem umfassen zusammen etwa 20 KB. Apothem hat außerdem nicht bestätigt, wie Zed einen Header-Schlüssel in SKILL.md behandelt, den es nicht aufführt.

VerifizierungCopy Anchor Link

apothem verify --harness zed --project /path/to/project

Der verify-Befehl bestätigt, dass:

1. Die native Konfiguration liegt am erwarteten Pfad.
2. Jedes verwaltete Ziel existiert; verwaltete Dateien sind nicht leer, und JSON- oder YAML-Konfigurationen lassen sich parsen. Fügen Sie --profile PATH hinzu, um außerdem zu bestätigen, dass die installierten Dateien zu diesem Profil passen.
3. Jeder Apothem-Skill-Ordner ist mit einer SKILL.md vorhanden, gleich welche Installation ihn geschrieben hat, und kein Skill-Ordner mit einem Apothem-Namen gehört zu etwas, das Apothem nicht geschrieben hat. Eine fehlgeschlagene Prüfung nennt die fehlenden oder fremden Ordner.
4. Die adapterspezifische Verifizierungsroutine meldet Erfolg.

AktualisierungCopy Anchor Link

apothem update --harness zed --project /path/to/project

Leitet die Projektdatei .rules aus dem aktuellen Zustand des gemeinsamen Profils neu ab.

Die Aktualisierung schreibt außerdem jeden Skill-Ordner neu, dessen Dateien von den aktuellen abweichen. Wenn Sie mit einem früheren Release installiert haben, das keine Skills schrieb, fügt die Aktualisierung sie hinzu.

DeinstallationCopy Anchor Link

apothem uninstall --harness zed --project /path/to/project

Entfernt den verwalteten Block von Apothem aus der nativen Konfigurationsdatei .rules und lässt Ihren eigenen Text stehen. Die Datei wird nur gelöscht, wenn darin nichts anderes mehr übrig bleibt. Vor der Änderung wird eine Kopie der Datei mit Zeitstempel unter ~/.apothem/backups/ gespeichert; im Projekt bleibt keine Sicherungsdatei zurück. Die YAML-Datei des gemeinsamen Profils und die Apothem-Engine bleiben unberührt.

Die Deinstallation entfernt außerdem die Skill-Ordner, die sie in ~/.agents/skills/ geschrieben hat, sowie die Regeln und Templates in ~/.config/apothem/, aber nur, wenn keine andere Apothem-Installation sie noch nutzt. Ein anderes Projekt oder ein anderes Werkzeug, das den Ordner teilt, kann das tun. In diesem Fall behält die Deinstallation die Ordner, gibt aus, welche Installation sie nutzt, und die letzte Deinstallation entfernt sie. Dateien, die Sie diesen Ordnern hinzugefügt haben, bleiben bestehen, und ein leer zurückbleibender Ordner wird entfernt. Jeder Ordner wird unter ~/.apothem/backups/ gesichert, bevor er entfernt wird.

Konformitäts-GateCopy Anchor Link

python -m apothem.conformity.gate --all .

FehlerbehebungCopy Anchor Link

KonfigurationsschalterCopy Anchor Link

Siehe auchCopy Anchor Link

• Alle Harnesses — der vollständige Katalog der unterstützten Werkzeuge
• Installationsanleitung — Apothem in diesen Harness installieren
• Referenz zu apothem harnesses — Adapter über die CLI auflisten und untersuchen