Project Butler

Memoria di progetto cross-sessione per agenti di codifica AI: log di sessione, handoff, TODO, wiki, stato

di JamesShi96 · JamesShi96/project-butler

Promosso ★ 8.8/10

Project Butler — Memoria di progetto cross-sessione per agenti di codifica AI: log di sessione, handoff, TODO, wiki, stato

Cosa fa

Mantiene uno stack di memoria di progetto standardizzato (CLAUDE.md, wiki PROJECT.md, handoff di sessione, TODO, log di sessione, log di aggiornamento, indice docs, configurazione profilo) in modo che gli agenti di codifica riprendano i progetti senza ri-spiegazioni. Si attiva su /project-butler, "end session"/"收工", "continue"/"接着上次", "status", "organize files"/"整理文件", "sync wiki", "review claude" e cambio lingua. Include un controllo giornaliero della freschezza della versione basato su git che offre di auto-aggiornarsi.

Rapporto di test

Recuperato SKILL.md root; controllato a campione references/update-check.md, scripts/check-update.sh, references/file-templates.md, references/project-profile-system.md (tutti HTTP 200). Letto check-update.sh completamente: esegue solo git fetch/pull nella propria directory e cerca CLAUDE.md per un token di lingua — nessun curl|sh, base64 o esfiltrazione; limitato a una volta ogni 24 ore con una variabile d'ambiente di opt-out. Trigger: giudicato "end session", "整理文件", "status where are we" come carichi e "what's the current git status", "set up a new React project with Vite" come non carichi (5/5, anche se "status"/"setup" comportano un lieve rischio di collisione di parole chiave). Test di output: scritto /private/tmp/.../scratchpad/baseline.md (prosa di 9 righe, 0 intestazioni, nessun campo per attività) vs skill-log.md seguendo rigorosamente il formato del log di sessione (29 righe, 7 intestazioni canoniche, ogni attività in sospeso con lo scaffold Owner|Deadline|Dependencies obbligatorio, più un candidato CLAUDE.md evidenziato che il baseline aveva omesso).

Testato il: 2026-07-31 · Claude Code 2.x (agent harness)

Installazione

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.

Comandi e prompt di esempio

  • /project-butlerMemoria di progetto cross-sessione per agenti di codifica AI: log di sessione, handoff, TODO, wiki, stato

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

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