Archive

Écrit les apprentissages de session dans .archive/AAAA-MM-JJ/ avec un frontmatter étiqueté et un index MEMORY.md

par ReScienceLab · ReScienceLab/opc-skills

Testé · Fonctionne ★ 8.8/10

Archive — Écrit les apprentissages de session dans .archive/AAAA-MM-JJ/ avec un frontmatter étiqueté et un index MEMORY.md

Ce que fait

Archive capture ce qu'une session de travail a produit — une correction de bug, un déploiement, une migration — sous forme de fichier markdown daté dans .archive/AAAA-MM-JJ/ avec un frontmatter YAML (tags, category, related) plus une entrée d'une ligne ajoutée à un index .archive/MEMORY.md. Elle se déclenche lorsqu'une tâche significative est terminée, lorsqu'un bug délicat est résolu, lorsque l'utilisateur dit "archive this", ou lorsqu'il demande si un problème a été résolu lors d'une session précédente. Un hook SessionStart inclus lit .archive/MEMORY.md dans le contexte afin que les notes passées soient disponibles dans les sessions ultérieures.

Rapport de test

SKILL.md récupéré (HTTP 200, 55 lignes, frontmatter contient name+description) et ses trois fichiers groupés vérifiés ponctuellement : references/TEMPLATE.md 200, hooks/hooks.json 200, hooks/load-memory.py 200 — tous existent, pas de chemins machine codés en dur, pas de curl|sh, pas de base64, pas d'exfiltration de secrets ; load-memory.py ne lit que $CLAUDE_PROJECT_DIR/.archive/MEMORY.md et l'imprime comme SessionStart additionalContext (donc tout ce qui se trouve dans ce fichier entre dans le contexte — le garder local et fiable). Déclenchement noté 5/5 sur : DEVRAIT se déclencher — "Archiver cette session, nous avons enfin corrigé les permissions du groupe de logs CloudWatch", "Nous venons de terminer le déploiement ECS, sauvegarder les apprentissages pour que les futures sessions ne répètent pas cela", "Avons-nous déjà rencontré cette erreur de migration Alembic ? vérifier les notes de sessions passées" ; NE DEVRAIT PAS se déclencher — "Compresser le répertoire de logs dans une archive tar.gz et le déplacer vers les sauvegardes" (sens différent du mot), "Ajouter une entrée CHANGELOG pour la version 1.2" (fichier de dépôt, pas notes .archive). Pour la sortie, j'ai exécuté une tâche deux fois dans un projet scratch : la base de référence a donné un seul docs/session-notes-2026-07-21.md de forme libre sans index, sans tags, sans commandes exactes, commité dans le dépôt ; l'exécution suivie par la compétence a donné .archive/2026-07-21/vercel-deploy-node-version-lockfile.md avec un frontmatter tags/category, un bloc Key Changes contenant la vraie variable d'environnement et les commandes pnpm/git, une entrée d'index MEMORY.md et une ligne `.archive/` dans .gitignore — `grep -ri "tags:.*lockfile" .archive/` l'a récupéré alors que la base de référence n'avait pas d'index pour y accéder. Documentation pénalisée d'un point : l'installation rapide du README commence par /plugin marketplace add, pourtant archive est absent de .claude-plugin/marketplace.json et livre .factory-plugin/plugin.json à la place, donc la route du plugin et son enregistrement automatique de hook ne fonctionnent pas dans Claude Code.

Testé le: 2026-07-21 · Claude Code 2.x (agent harness)

Installation

# Recommended (works with Claude Code, Cursor, Droid, Codex):
npx skills add ReScienceLab/opc-skills --skill archive -a claude   # user-level
npx skills add ReScienceLab/opc-skills --skill archive              # project-level

# Manual (no npx):
git clone --depth 1 https://github.com/ReScienceLab/opc-skills /tmp/opc-skills
mkdir -p ~/.claude/skills
cp -R /tmp/opc-skills/skills/archive ~/.claude/skills/archive

# Optional SessionStart auto-load of .archive/MEMORY.md: register
# ~/.claude/skills/archive/hooks/load-memory.py as a SessionStart command hook
# in settings.json. Note `/plugin install archive@opc-skills` does NOT resolve —
# archive is missing from the repo's .claude-plugin/marketplace.json.

# First use: add `.archive/` to your project .gitignore (the skill requires this).

Commandes et exemples de prompts

/archiveÉcrit les apprentissages de session dans .archive/AAAA-MM-JJ/ avec un frontmatter étiqueté et un index MEMORY.md

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

Archive this session's learnings for later reuse
Save this debugging solution for later reuse
Log this deployment in the archive

Rapport complet →