Que fait pm-tasks-core ?
Noyau partagé pour tous les adaptateurs pm-tasks-<outil>. Définit les phases d'extraction, la structure de carte générique, le vocabulaire CRUD, le contrat du mode autonome, les règles de recherche de configuration et le format du journal d'audit. Les adaptateurs référencent ce skill par chemin – aucun mécanisme de dépendance formel dans la spécification.
Routage
Les adaptateurs invoquent ce skill AVANT d'appliquer leur mise en forme spécifique à l'outil. Le pointeur exact est documenté dans references/contract.md.
Phases
| Phase | Objectif | Référence |
|---|---|---|
| 1 | Identifier l'entrée (fichier plan vs colle en ligne vs implicite) | references/contract.md § 1 |
| 2 | Extraire les sections par intention (objectif, prérequis, tâches, condition de succès) | references/contract.md § 2 |
| 2.5 | Porte des anti-patrons | anti-patterns/core.md |
| 3 | Construire la carte générique | references/generic-card.md |
Les adaptateurs exécutent ensuite les Phases 4+ selon leur propre SKILL.md.
Vocabulaire CRUD (verbes implémentés par les adaptateurs)
Voir references/crud-vocabulary.md. Six verbes, tous idempotents (avec des règles clientToken pour les cas non naturels).
Mode autonome
Voir references/autonomous-mode.md. Activé uniquement par la sentinelle [autonomous] / --auto / env LLODEV_PM_TASKS_AUTONOMOUS=1. Nécessite une liste d'autorisation explicite + périmètre + limite de débit dans la configuration de l'outil. Jamais inféré.
Configuration
Ordre de recherche : <racine-git>/.<outil>.json → ~/.config/llodev/pm-tasks/<outil>.json → abandon. Les secrets ne figurent JAMAIS dans le JSON (variables d'environnement / trousseau système uniquement).
Journal d'audit
Fichier JSONL en ajout seul à ~/.local/share/llodev/pm-tasks/<outil>/audit.log. Schéma dans references/audit-log-format.md. Sert également d'index de recherche pour la résolution de <task-ref>.
Aide à l'initialisation
Les adaptateurs exposent npx @llodev/pm-tasks-<outil> init. Expérience utilisateur partagée dans references/init-ux.md. Bibliothèque d'implémentation à @llodev/pm-tasks-core/init-lib (code source TypeScript sous ./src/init-lib.ts ; compilé dans ./dist/init-lib.js).
Vérification de santé (doctor)
pm-tasks-core-doctor valide une configuration d'espace de travail, la liste d'autorisation autonome, la capacité d'écriture du journal d'audit et l'accessibilité réseau. Matrice de vérification et codes de sortie dans references/doctor.md – pm-tasks-core-doctor catalogue de vérifications + codes de sortie.
Recours autonome
Ce skill n'est pas utile sans adaptateur. S'il est activé seul, indiquez à l'utilisateur d'installer au moins un package pm-tasks-<outil>.