Project Butler

Memoria de proyecto entre sesiones para agentes de codificación de IA: registros de sesión, traspaso, TODO, wiki, estado

Por JamesShi96 · JamesShi96/project-butler

Probado · Funciona ★ 8.8/10

Project Butler — Memoria de proyecto entre sesiones para agentes de codificación de IA: registros de sesión, traspaso, TODO, wiki, estado

Qué hace

Mantiene una pila de memoria de proyecto estandarizada (CLAU.md, wiki PROJECT.md, traspaso de sesión, TODO, registros de sesión, registro de actualizaciones, índice de documentos, configuración de perfil) para que los agentes de codificación reanuden proyectos sin volver a explicarlos. Se activa con /project-butler, "end session"/"收工", "continue"/"接着上次", "status", "organize files"/"整理文件", "sync wiki", "review claude" y cambio de idioma. Incluye una verificación diaria de frescura de versión basada en `git` que ofrece autoactualizarse.

Informe de la prueba

Se obtuvo el SKILL.md raíz; se verificaron references/update-check.md, scripts/check-update.sh, references/file-templates.md, references/project-profile-system.md (todos HTTP 200). Se leyó `check-update.sh` completamente: solo hace `git fetch`/`pull` en su propio directorio y busca en CLAUDE.md un token de idioma — sin `curl|sh`, `base64` o exfiltración; limitado a una vez cada 24h con una variable de entorno de exclusión. Activación: se juzgaron "end session", "整理文件", "status where are we" como cargas y "what's the current git status", "set up a new React project with Vite" como no cargas (5/5, aunque "status"/"setup" conllevan un leve riesgo de colisión de palabras clave). Prueba de salida: escribí /private/tmp/.../scratchpad/baseline.md (prosa de 9 líneas, 0 encabezados, sin campos por tarea) vs skill-log.md siguiendo estrictamente el formato de registro de sesión (29 líneas, 7 encabezados canónicos, cada tarea pendiente con el andamiaje obligatorio Owner|Deadline|Dependencies, más un candidato CLAUDE.md que la línea base omitió).

Probado el: 2026-07-31 · Claude Code 2.x (agent harness)

Instalación

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.

Comandos y prompts de ejemplo

/project-butlerMemoria de proyecto entre sesiones para agentes de codificación de IA: registros de sesión, traspaso, TODO, wiki, estado

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

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

Informe completo →