Project Butler

Mémoire de projet inter-sessions pour les agents de codage IA : journaux de session, transfert, TODO, wiki, statut

par JamesShi96 · JamesShi96/project-butler

Testé · Fonctionne ★ 8.8/10

Project Butler — Mémoire de projet inter-sessions pour les agents de codage IA : journaux de session, transfert, TODO, wiki, statut

Ce que fait

Maintient une pile de mémoire de projet standardisée (CLAUDE.md, wiki PROJECT.md, transfert de session, TODO, journaux de session, journal de mise à jour, index de documentation, configuration de profil) afin que les agents de codage reprennent les projets sans ré-explication. Se déclenche sur /project-butler, "end session"/"收工", "continue"/"接着上次", "status", "organize files"/"整理文件", "sync wiki", "review claude", et le changement de langue. Inclut une vérification quotidienne de la fraîcheur de la version basée sur git qui propose de se mettre à jour automatiquement.

Rapport de test

SKILL.md racine a été récupéré ; references/update-check.md, scripts/check-update.sh, references/file-templates.md, references/project-profile-system.md ont été vérifiés (tous HTTP 200). J'ai lu check-update.sh entièrement : il ne fait que git fetch/pull sur son propre répertoire et greppe CLAUDE.md pour un token de langue — pas de curl|sh, base64, ou exfiltration ; limité à une fois toutes les 24h avec une variable d'environnement d'opt-out. Déclencheur : j'ai jugé "end session", "整理文件", "status where are we" comme des chargements et "what's the current git status", "set up a new React project with Vite" comme des non-chargements (5/5, bien que "status"/"setup" comportent un léger risque de collision de mots-clés). Test de sortie : j'ai écrit /private/tmp/.../scratchpad/baseline.md (prose de 9 lignes, 0 en-tête, pas de champs par tâche) vs skill-log.md suivant strictement le format de journal de session (29 lignes, 7 en-têtes canoniques, chaque tâche en attente avec l'échafaudage Owner|Deadline|Dependencies obligatoire, plus un candidat CLAUDE.md mis en évidence que la ligne de base avait omis).

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

Installation

git clone --depth 1 https://github.com/JamesShi96/project-butler.git ~/.claude/skills/project-butler
# SKILL.md sits at the repo root, so clone straight into the skill dir.
# No API keys or external deps. Optional: the skill runs scripts/check-update.sh
# (a daily `git fetch` against its own repo) to offer self-updates; set
# PROJECT_BUTLER_NO_UPDATE_CHECK=1 to silence it. Works with Claude Code, and
# Cursor (.cursor/rules) / Codex (AGENTS.md) via templates it can generate.

Commandes et exemples de prompts

/project-butlerMémoire de projet inter-sessions pour les agents de codage IA : journaux de session, transfert, TODO, wiki, statut

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) :

Set up project memory for this new project
Close out this session and update the log
Organize the files in this project folder

Rapport complet →