Kimi Code
Apothem-Harness-Adapter für Kimi Code (GA).
Anbieter: Moonshot
Installationsname: kimi-code
Status: GA
Native Konfiguration: <project>/AGENTS.md, <project>/.kimi-code/skills/, <project>/.kimi-code/agents/ und <project>/.kimi-code/.apothem/support/
Installation
apothem install --harness kimi-code --project /path/to/projectDer Adapter schreibt die gemeinsame Governance-Oberfläche von Apothem als durch
Sentinels begrenzten verwalteten Block in die AGENTS.md im
Projektstammverzeichnis (vom Operator verfasste Prosa außerhalb der Sentinels
bleibt erhalten). Er installiert Skills sowie als Skills verpackte Commands im
nativen Projekt-Skills-Verzeichnis von Kimi Code, <project>/.kimi-code/skills/,
und die Helfer von Apothem als Kimi-Code-Subagenten in
<project>/.kimi-code/agents/ (siehe Subagenten). Die übrigen
Kohorten bleiben im Apothem-eigenen Unterstützungs-Teilbaum unter
<project>/.kimi-code/.apothem/support/.
Eine Projekt-AGENTS.md wird außer von Kimi Code von vielen weiteren
Coding-Werkzeugen gelesen, daher wird der Block als projektweite Anleitung
geschrieben, die kein einzelnes Werkzeug als ihren Leser nennt.
Kimi Code liest die Anweisungsdatei AGENTS.md im Projektstammverzeichnis gemäß
der universellen AGENTS.md-Konvention, und die Projektkonfiguration liegt unter
<project>/.kimi-code/. Kimi Code betrachtet als Projektstammverzeichnis das
nächstgelegene Verzeichnis, das .git enthält, und sucht dabei vom
Arbeitsverzeichnis aus aufwärts; übergeben Sie daher das Repository-Stammverzeichnis
als --project. Die Oberfläche <project>/.kimi-code/mcp.json gehört
dem Operator; Apothem benennt sie, verfasst aber keine Einträge.
Geschriebene Dateien: <project>/AGENTS.md (verwalteter Block), die Skills und
die Commands (als Skills) unter <project>/.kimi-code/skills/, eine
<project>/.kimi-code/agents/<name>.md für jeden Apothem-Helfer sowie die
Kohorten Hooks, Regeln und Templates unter <project>/.kimi-code/.apothem/support/.
Subagenten
Kimi Code liest einen Subagenten aus einer Markdown-Datei in .kimi-code/agents/
(oder .agents/agents/), laut der
Kimi-Code-Dokumentation zu benutzerdefinierten Subagenten.
Die Installation schreibt für alle vierzehn Helfer je eine Datei pro Apothem-Helfer
in <project>/.kimi-code/agents/. Sie installiert nur für das Projekt und schreibt
keinen Ordner ~/.kimi-code/agents/.
Jede Datei behält die Anweisungen des Helfers unverändert bei und trägt diese Frontmatter-Schlüssel:
| Schlüssel | Was Apothem schreibt |
|---|---|
name, description | Name und Beschreibung des Helfers. |
tools | Die erlaubten Werkzeuge des Helfers, als Liste von Kimi-Code-Werkzeugnamen. |
disallowedTools | Die verweigerten Werkzeuge des Helfers, als Liste von Kimi-Code-Werkzeugnamen. Kimi Code wendet sie nach tools an. |
Kimi Code gleicht Werkzeugnamen exakt ab, einschließlich Großbuchstaben, und warnt
bei einem Namen, für den es kein Werkzeug hat. Daher benennt die Installation die
beiden Werkzeuge um, die Kimi Code anders schreibt, WebFetch in FetchURL und
TodoWrite in TodoList, und lässt die Namen weg, für die Kimi Code kein Werkzeug
hat: MultiEdit, NotebookEdit, PowerShell, Monitor, Artifact, TaskCreate
und TaskUpdate. Ein verweigertes Werkzeug bleibt verweigert. Fallen auf diese
Weise alle erlaubten Werkzeuge eines Helfers weg, trägt die Datei tools: [], was
kein Werkzeug erlaubt; ein weggelassenes tools würde jedes Werkzeug erlauben.
Die Installation schreibt nie model (Kimi Code hat keinen Modellschlüssel für
einen Subagenten, der das Modell der Hauptsitzung oder das [secondary_model] in
config.toml verwendet), override (damit könnte eine Projektdatei einen
eingebauten Subagenten ersetzen), subagents, whenToUse oder die Apothem-Schlüssel
maxTurns, version, updated und portability.
Gut zu wissen:
- Die Subagenten-Dateien sind gewöhnliche Projektdateien. Committen Sie sie mit
dem Projekt oder tragen Sie
.kimi-code/agents/in.gitignoreein; Apothem entscheidet das nicht für Sie. - Kimi Code verwendet einen Helfer, wenn eine Delegation angefordert wird. Seit
seinem Release vom 2026-10-25 erledigt es Aufgaben standardmäßig selbst, statt
von sich aus Subagenten zu starten; fordern Sie einen Helfer daher mit Namen an,
in einer Nachricht oder in
AGENTS.md. Die Seite des Anbieters zu benutzerdefinierten Subagenten beschreibt noch eine automatische Zuteilung, daher kann sich das ändern. - Eine Datei auf Projektebene in
.kimi-code/agents/hat Vorrang vor einer gleichnamigen Definition auf der Extra-, Benutzer- und Plugin-Ebene. Geben Sie Ihren eigenen Helfern Namen, die sich von denen von Apothem unterscheiden. Der Code von Kimi Code liest außerdem.kimi-code/agents/vor dem gemeinsamen Ordner.agents/agents/, den Apothem nie schreibt, und behält die erste von zwei gleichnamigen Dateien; die Dokumentation sagt dazu nichts. - Eine eigene Datei mit dem Namen eines Apothem-Helfers wird unter
~/.apothem/backups/gesichert und dann ersetzt. Die Deinstallation stellt sie nicht wieder her. Dateien mit anderen Namen werden nie angefasst. - Frühere Releases legten die Helferdateien im Unterstützungs-Teilbaum ab, unter
.kimi-code/.apothem/support/agents/, wo Kimi Code sie nicht lud. Einapothem updateoderapothem uninstallentfernt diese Kopie, nachdem es sie unter~/.apothem/backups/gesichert hat.
Zuordnung von Profil zu nativer Konfiguration
Der Adapter liest Apothems gemeinsames Profil und rendert die Anweisungsoberfläche
AGENTS.md im Projektstammverzeichnis bei jedem Lauf von apothem install oder
apothem update. Die Verhaltensregeln und der Governance-Korpus landen im
verwalteten Block der AGENTS.md. Jeder Skill und jeder als Skill verpackte
Command landet unter .kimi-code/skills/<name>/SKILL.md, einem
Projekt-Skills-Verzeichnis, das Kimi Code lädt. Der Adapter schreibt nur diesen
Kimi-spezifischen Ordner und nie .agents/skills/, das auch andere Werkzeuge
lesen. Skills, die Sie selbst unter anderen Namen in .kimi-code/skills/
hinzufügen, bleiben bei Installation, Aktualisierung und Deinstallation erhalten.
Ein Skill dort mit demselben Namen wie ein Apothem-Skill wird ersetzt: Installation
und Aktualisierung überschreiben ihn, die Deinstallation entfernt ihn, jeweils nach
einer mit Zeitstempel versehenen Kopie unter ~/.apothem/backups/, und die
Installation gibt keinen Hinweis auf die Kollision aus. Geben Sie Ihren eigenen
Skills Namen, die sich von denen von Apothem unterscheiden.
Die Kohorten Hooks, Regeln und Templates werden unter
.kimi-code/.apothem/support/ abgelegt und von der Anweisungsoberfläche
referenziert. Kimi Code lädt sie nicht aus dem Unterstützungs-Teilbaum; die
dortigen Apothem-Kopien sind daher Referenzmaterial, auf das der
AGENTS.md-Block verweist. Der Block endet mit einem Abschnitt zu den
Apothem-Unterstützungsdateien, der relativ zum Projektstammverzeichnis das
Verzeichnis unter .kimi-code/.apothem/support/ nennt, gegen das jeder Verweis im
Repository-Stil (rules/<name>.md, templates/..., hooks/...) aufgelöst wird,
sodass eine committete AGENTS.md keinen maschinenspezifischen Pfad enthält.
(Verhalten von Kimi Code gemäß seinen Anpassungsseiten zu
Skills,
Helferdefinitionen und
Hooks, gelesen
am 2026-10-24 für Skills und Hooks, am 2026-10-27 für Helferdefinitionen.)
Nicht nativ installiert
Kimi Code dokumentiert einen nativen Ort für Hooks. Der Adapter schreibt noch nicht dorthin, und zwar aus diesen Gründen.
- Hooks. Kimi Code liest Hooks aus dem
[[hooks]]-Array in~/.kimi-code/config.toml($KIMI_CODE_HOME/config.toml, wenn diese Variable gesetzt ist). Apothem schreibt keine. Diese Datei gilt auf Benutzerebene, während dieser Adapter unter das Projektstammverzeichnis schreibt; ein Eintrag erlaubt nur vier Felder (eventundcommanderforderlich,matcherundtimeoutoptional), und ein zusätzliches Feld verhindert das Laden der Konfiguration; und Apothem hat keine TOML-Zusammenführung, die später nur seine eigenen Einträge entfernen könnte. Die Hook-Hilfsskripte bleiben im Unterstützungs-Teilbaum. - Skill-Frontmatter. Die Seite des Anbieters dokumentiert die
SKILL.md-Schlüsselnameunddescription(beide erforderlich),type,whenToUse,disableModelInvocation(auch alsdisable-model-invocationakzeptiert) undarguments. Für andere Schlüssel nennt sie keine Regel. Skills werden mit dem Frontmatter installiert, das sie in der Apothem-Quelle haben, sodass Schlüssel wieversion,updated,archetype,userInvocable,argument-hint,portabilityundallowed-toolsKimi Code erreichen, das sie möglicherweise ignoriert oder ablehnt. - Gleichnamige Skills. Kimi Code gibt der Projektebene Vorrang vor der
Benutzerebene, sodass ein Skill in
<project>/.kimi-code/skills/Vorrang vor einem gleichnamigen Skill in~/.agents/skills/hat, den ein anderer Apothem-Adapter schreibt. Die Seite des Anbieters sagt nicht, wie.kimi-code/skills/und.agents/skills/innerhalb der Projektebene zueinander gewichtet werden.
Kompatibilitätshinweise
Kimi Code liest Projektanweisungen aus AGENTS.md oder
.kimi-code/AGENTS.md und erkennt .kimi-code/mcp.json als die dem Operator
gehörende MCP-Oberfläche; Apothem benennt diese Oberfläche, verfasst aber keine
Einträge darin. Von den beiden Anweisungsdateien schreibt der Adapter nur die
AGENTS.md im Projektstammverzeichnis, die Kimi Code als Projektanweisungen
liest; die Kimi-Code-Dokumentation sagt nicht, welche der beiden Dateien Vorrang
hat, wenn beide existieren. Kimi Code stellt keine Dateioberfläche für
Statuszeilen oder Output-Styles bereit, daher werden diese Kohorten nicht
materialisiert.
Kimi Code läuft auf der Kimi-Modellfamilie von Moonshot; das aktuelle Modell und die aktuelle Konfigurationsoberfläche finden Sie in der Konfigurationsreferenz des Anbieters.
Verifizierung
apothem verify --harness kimi-code --project /path/to/projectDer Befehl verify bestätigt Folgendes:
- Die native Konfiguration existiert am erwarteten Pfad.
- Jedes verwaltete Ziel existiert, einschließlich der Skills- und
Subagenten-Verzeichnisse; verwaltete Dateien sind nicht leer, und
JSON- oder YAML-Konfigurationen lassen sich parsen. Fügen Sie
--profile PATHhinzu, um außerdem zu bestätigen, dass die installierten Dateien zu diesem Profil passen. Für.kimi-code/agents/wird geprüft, dass der Ordner existiert, nicht dass jede Helferdatei darin liegt; der Befehlapothem diff --harness kimi-code --project /path/to/projectlistet die Helferdateien auf, die fehlen oder veraltet sind. - Die adapterspezifische Verifizierungsroutine meldet Erfolg.
Aktualisierung
apothem update --harness kimi-code --project /path/to/projectLeitet den verwalteten Block der AGENTS.md im Projektstammverzeichnis, die
Skills, die Subagenten-Dateien und die Unterstützungskohorten aus dem aktuellen
Zustand des gemeinsamen Profils neu ab. Eine Aktualisierung über eine
Installation, die erstellt wurde, bevor die Skills nach .kimi-code/skills/
umzogen, entfernt das alte Verzeichnis
<project>/.kimi-code/.apothem/support/skills/, sodass jeder Skill nur einmal
vorhanden ist. Eine Aktualisierung über eine Installation aus der Zeit, bevor die
Helfer nach .kimi-code/agents/ umzogen, entfernt das alte Verzeichnis
<project>/.kimi-code/.apothem/support/agents/ auf dieselbe Weise. Zuvor wird
von jedem entfernten Verzeichnis eine mit Zeitstempel versehene Kopie unter
~/.apothem/backups/ gespeichert.
Deinstallation
apothem uninstall --harness kimi-code --project /path/to/projectEntfernt den Apothem-Block aus der AGENTS.md im Projektstammverzeichnis und
behält jeden Text außerhalb der Sentinels. Die Datei wird nur gelöscht, wenn
darin nichts anderes übrig bleibt. Entfernt außerdem die Skills, die Apothem
unter <project>/.kimi-code/skills/ abgelegt hat (Skills, die Sie dort unter
anderen Namen hinzugefügt haben, bleiben erhalten), die Subagenten-Dateien unter
<project>/.kimi-code/agents/ (Dateien, die Sie dort unter anderen Namen
hinzugefügt haben, bleiben erhalten, und der Ordner wird entfernt, wenn er leer
zurückbleibt) sowie die Unterstützungsdateien unter
<project>/.kimi-code/.apothem/support/, einschließlich der alten Verzeichnisse
skills/ und agents/ im Unterstützungs-Teilbaum einer Installation, die nie
aktualisiert wurde. Vor der Änderung wird von jeder Datei eine mit Zeitstempel
versehene Kopie unter ~/.apothem/backups/ gespeichert; im Projekt bleibt keine
Sicherungsdatei zurück. Die YAML-Datei des gemeinsamen Profils und die
Apothem-Engine bleiben unberührt.
Konformitäts-Gate
python -m apothem.conformity.gate --all .Fehlerbehebung
| Symptom | Behebung |
|---|---|
| Konfigurationsdatei nicht gefunden | Führen Sie apothem install --harness kimi-code --project /path/to/project erneut aus |
| Verifizierung fehlgeschlagen | Führen Sie apothem update --harness kimi-code --project /path/to/project aus und verifizieren Sie dann erneut |
| Skills oder Helfer fehlen in Kimi Code | Prüfen Sie, dass --project das Repository-Stammverzeichnis nennt (das Verzeichnis, das .git enthält), und führen Sie dann die Installation erneut aus |
| Kimi Code verwendet nie einen Helfer | Fordern Sie ihn mit Namen an. Kimi Code erledigt Aufgaben selbst, sofern keine Delegation angefordert wird |
| Unerwarteter Konfigurationsinhalt | Prüfen Sie ~/.config/apothem/profile.yaml oder --profile PATH und führen Sie dann apothem update --harness kimi-code --project /path/to/project erneut aus |
Konfigurationsschalter
| Flag | Standard | Beschreibung |
|---|---|---|
--dry-run | false | Vorschau der Installation, ohne Dateien zu schreiben. |
Siehe auch
- 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