Was macht pm-tasks-core?
Gemeinsamer Kern für alle pm-tasks-<tool>-Adapter. Definiert die Extraktionsphasen, die generische Kartenstruktur, das CRUD-Vokabular, den Vertrag für den autonomen Modus, die Regeln zur Konfigurationssuche und das Format des Audit-Logs. Adapter referenzieren diesen Skill per Pfad – es existiert kein formaler Abhängigkeitsmechanismus in der Spezifikation.
Weiterleitung
Adapter rufen diesen Skill AUF, bevor sie ihre tool-spezifische Formatierung anwenden. Der genaue Verweis ist in references/contract.md dokumentiert.
Phasen
| Phase | Zweck | Referenz |
|---|---|---|
| 1 | Identifiziere die Eingabe (Plan-Datei vs. Inline-Einfügen vs. implizit) | references/contract.md § 1 |
| 2 | Extrahiere Abschnitte nach Absicht (Ziel, Voraussetzungen, Aufgaben, Erledigt-Wenn) | references/contract.md § 2 |
| 2.5 | Anti-Pattern-Prüfung | anti-patterns/core.md |
| 3 | Erstelle die generische Karte | references/generic-card.md |
Adapter führen dann Phasen 4+ gemäß ihrer eigenen SKILL.md aus.
CRUD-Vokabular (von Adaptern implementierte Verben)
Siehe references/crud-vocabulary.md. Sechs Verben, alle idempotent (mit clientToken-Regeln für nicht-idempotente Fälle).
Autonomer Modus
Siehe references/autonomous-mode.md. Wird nur durch den Sentinel [autonomous] / --auto / env LLODEV_PM_TASKS_AUTONOMOUS=1 aktiviert. Erfordert eine explizite Erlaubnisliste, einen Umfang und eine Ratenbegrenzung in der Konfiguration des Werkzeugs. Wird niemals implizit angenommen.
Konfiguration
Suchreihenfolge: <git-root>/.<tool>.json → ~/.config/llodev/pm-tasks/<tool>.json → Abbruch. Geheimnisse NIEMALS in JSON (nur Umgebungsvariablen / OS-Schlüsselspeicher).
Audit-Log
Anhängendes JSONL unter ~/.local/share/llodev/pm-tasks/<tool>/audit.log. Schema in references/audit-log-format.md. Dient gleichzeitig als Suchindex für die <task-ref>-Auflösung.
Initialisierungshelfer
Adapter bieten npx @llodev/pm-tasks-<tool> init. Gemeinsame Benutzererfahrung in references/init-ux.md. Implementierungsbibliothek unter @llodev/pm-tasks-core/init-lib (TypeScript-Quelle unter ./src/init-lib.ts; kompiliert nach ./dist/init-lib.js).
Gesundheitscheck (doctor)
pm-tasks-core-doctor validiert eine Workspace-Konfiguration, die autonome Erlaubnisliste, die Beschreibbarkeit des Audits und die Netzwerkerreichbarkeit. Prüfmatrix und Exit-Codes in references/doctor.md - Katalog der Prüfungen und Exit-Codes von pm-tasks-core-doctor.
Eigenständiger Fallback
Dieser Skill ist ohne einen Adapter nicht sinnvoll nutzbar. Wenn er allein aktiviert wird, teile dem Benutzer mit, dass mindestens ein pm-tasks-<tool>-Paket installiert werden muss.