ck

Présentation générale de ck skill

Ce que fait ck

ck est une skill de mémoire de projet pour Claude Code qui stocke un contexte réutilisable en dehors de la conversation en cours. Elle est conçue pour les personnes qui travaillent sur plusieurs dépôts et veulent conserver la continuité entre les sessions sans devoir réécrire à chaque fois le même historique de fond. Le besoin principal est simple : enregistrer un projet une seule fois, puis sauvegarder, reprendre, inspecter, lister et oublier le contexte via des commandes Node.js déterministes.

Qui devrait installer la skill ck

La meilleure cible pour ck skill est celle des développeurs qui utilisent Claude Code pour un travail récurrent sur des dépôts, surtout lorsque les objectifs, contraintes et décisions doivent survivre d’une session à l’autre. C’est aussi un excellent choix pour ck for Context Engineering, car la skill sépare la mémoire projet durable de l’historique ponctuel des prompts. Si vous faites surtout des prompts isolés ou n’utilisez pas le système local de skills de Claude Code, ck sera moins utile.

Pourquoi ck diffère d’un prompt classique

Un prompt standard peut résumer un dépôt une fois. ck ajoute une structure persistante : un registre de projets dans ~/.claude/ck/projects.json, une source de vérité context.json propre à chaque projet, un CONTEXT.md généré, et un hook de démarrage de session capable de charger automatiquement le contexte du projet. Le vrai différenciateur est la cohérence : les commandes appellent des scripts locaux, donc le flux de travail dépend moins du modèle que d’une demande vague du type « souviens-toi de ça ».

Comment utiliser la skill ck

Contexte d’installation et fichiers à lire en premier

Pour ck install, passez par le mécanisme de skills de Claude Code, puis examinez d’abord skills/ck/SKILL.md. Ensuite, lisez :

• commands/init.mjs
• commands/save.mjs
• commands/resume.mjs
• commands/info.mjs
• hooks/session-start.mjs

Cet ordre de lecture compte. init.mjs montre quelles métadonnées ck essaie de déduire du dépôt actuel, save.mjs définit les schémas JSON exacts, et resume.mjs / info.mjs montrent ce que vous récupérerez réellement à l’usage.

Comment ck s’utilise en pratique

Le modèle d’utilisation de ck repose sur des commandes. Les principales sont :

• /ck:init pour enregistrer le projet actuel
• /ck:save pour sauvegarder l’état de session
• /ck:resume pour charger un briefing complet
• /ck:info pour un aperçu rapide
• /ck:list pour voir tous les projets enregistrés
• /ck:forget pour retirer un projet
• /ck:migrate pour convertir d’anciennes données v1

Détail d’implémentation important : ck s’attend à ce que l’assistant exécute les scripts Node sous ~/.claude/skills/ck/commands/ et présente proprement la sortie standard. Pour l’initialisation, il ne faut pas sauvegarder immédiatement ; il faut d’abord rédiger les détails détectés du projet, puis attendre la confirmation de l’utilisateur avant d’envoyer le JSON validé vers save.mjs --init.

Quels inputs donnent de meilleurs résultats

ck fonctionne mieux si vous fournissez les faits projet que la détection automatique n’arrive pas à inférer correctement. Les bons inputs pour /ck:init incluent :

• un nom de projet clair
• une description en une phrase
• la stack principale
• l’objectif actuel
• des contraintes explicites ou des « ne pas faire »
• l’URL du dépôt, si elle est disponible

Pour /ck:save, un bon input de session ressemble plutôt à :

• summary : ce qui a changé pendant la session
• leftOff : le point d’arrêt exact
• nextSteps : 2 à 5 actions de suivi concrètes
• decisions : ce qui a été décidé et pourquoi
• blockers : les points de blocage non résolus

Input faible : « travaillé sur l’auth ».
Input fort : « Mise en place de la rotation des refresh tokens, arrêt sur des tests d’intégration en échec dans apps/api/tests/auth.spec.ts, prochaine étape : corriger la gestion du domaine des cookies, décision : conserver pour l’instant la révocation côté serveur, car les clients mobiles ne sont pas prêts. »

Workflow recommandé pour de vrais projets

Un flux de travail ck guide pragmatique est le suivant :

1. À la racine du dépôt, lancez /ck:init.
2. Relisez et corrigez le brouillon détecté avant de confirmer.
3. À la fin d’un travail significatif, lancez /ck:save.
4. À la session suivante, utilisez /ck:resume pour un contexte complet ou /ck:info pour un contrôle rapide.
5. Utilisez /ck:list lorsque vous passez d’un projet à l’autre.

Si vous adoptez ck for Context Engineering, considérez-le comme votre couche de briefing projet durable. Gardez le brainstorming de courte durée dans le chat, mais transférez les faits stables, les décisions et les prochaines étapes dans ck afin que les sessions futures repartent d’un état plus propre.

FAQ sur la skill ck

ck est-il adapté aux débutants ?

Globalement oui, si vous êtes déjà à l’aise avec Claude Code et l’exécution de commandes locales. Le concept est simple, mais la skill est plus opérationnelle que conversationnelle. Les débutants devront peut-être lire attentivement SKILL.md pour comprendre l’étape de confirmation, le passage de relais via JSON et l’emplacement de stockage des données.

Quand ck est-il meilleur qu’un prompt classique ?

ck est plus pertinent quand le même projet revient sur plusieurs jours ou plusieurs semaines. Ce n’est pas seulement un modèle de prompt plus intelligent ; il garde une mémoire projet structurée sur disque et peut la recharger de manière fiable. Si votre travail est temporaire ou limité à une seule session, un prompt standard suffit souvent et va plus vite.

Quelles sont les principales limites ou les principaux risques ?

La limite majeure est simple : ck vaut autant que ce qu’on y enregistre. Si les utilisateurs sautent /ck:save, la couche mémoire devient vite obsolète. Autre contrainte : cet outil est conçu autour des skills locales de Claude Code et de conventions système de fichiers comme ~/.claude/ck/. Ce n’est pas un service de mémoire cloud générique. Enfin, CONTEXT.md est généré : le modifier à la main n’est pas la bonne manière d’entretenir la vérité.

Comment améliorer la skill ck

Donnez à ck de meilleurs inputs d’enregistrement de projet

Le levier le plus important pour ck est la qualité de l’initialisation. La détection automatique à partir de package.json, du contenu du README ou des métadonnées git est utile, mais souvent incomplète. Corrigez le brouillon sans hésiter au moment de /ck:init. Un objectif précis et des contraintes explicites rendent ensuite les sorties de /ck:resume bien plus exploitables que de simples étiquettes de stack.

Évitez les modes de défaillance les plus courants

Les problèmes typiques de ck sont assez prévisibles :

• enregistrer le projet depuis le mauvais répertoire
• sauvegarder des résumés trop vagues
• oublier de mettre à jour les prochaines étapes
• considérer le Markdown généré comme source de vérité
• supprimer un contexte sans confirmer d’abord l’identité du projet

Si les résultats semblent faibles, vérifiez si le context.json sous-jacent contient réellement assez de détails. La plupart des problèmes de qualité viennent d’un état sauvegardé trop pauvre, pas des scripts de commandes eux-mêmes.

Itérez après la première sortie

Pour améliorer ck usage, ne traitez pas le premier contexte sauvegardé comme définitif. Après /ck:resume, demandez-vous : qu’est-ce qui me manquerait demain si je n’avais plus aucun historique de chat ? Puis sauvegardez à nouveau avec des décisions plus nettes, des blocages mieux formulés et un point d’arrêt plus précis. Les meilleurs montages ck skill évoluent vers des briefings compacts et à forte valeur, plutôt que vers de longs journaux de bord.