Project Butler

Projektgedächtnis über Sitzungen hinweg für KI-Codierungsagenten: Sitzungsprotokolle, Übergabe, TODO, Wiki, Status

von JamesShi96 · JamesShi96/project-butler

Getestet · Funktioniert ★ 8.8/10

Project Butler — Projektgedächtnis über Sitzungen hinweg für KI-Codierungsagenten: Sitzungsprotokolle, Übergabe, TODO, Wiki, Status

Was es kann

Pflegt einen standardisierten Projektgedächtnis-Stack (CLAUDE.md, PROJECT.md Wiki, Sitzungsübergabe, TODO, Sitzungsprotokolle, Update-Protokoll, Dokumentenindex, Profilkonfiguration), damit Codierungsagenten Projekte ohne erneute Erklärung fortsetzen können. Wird ausgelöst bei /project-butler, „end session“/„收工“, „continue“/„接着上次“, „status“, „organize files“/„整理文件“, „sync wiki“, „review claude“ und Sprachwechsel. Enthält eine tägliche Git-basierte Versionsfrischeprüfung, die ein Selbst-Update anbietet.

Testbericht

Root SKILL.md abgerufen; references/update-check.md, scripts/check-update.sh, references/file-templates.md, references/project-profile-system.md stichprobenartig überprüft (alle HTTP 200). check-update.sh vollständig gelesen: Es führt nur git fetch/pull im eigenen Verzeichnis aus und grept CLAUDE.md nach einem Sprach-Token – kein curl|sh, base64 oder Exfiltration; auf einmal/24h gedrosselt mit einer Opt-out-Umgebungsvariable. Trigger: „end session“, „整理文件“, „status where are we“ als Ladevorgänge und „what's the current git status“, „set up a new React project with Vite“ als Nicht-Ladevorgänge bewertet (5/5, obwohl „status“/„setup“ ein geringes Keyword-Kollisionsrisiko bergen). Ausgabe-Test: /private/tmp/.../scratchpad/baseline.md (9-zeilige Prosa, 0 Header, keine pro-Aufgabe-Felder) vs. skill-log.md, das dem Session Log Format strikt folgt (29 Zeilen, 7 kanonische Header, jede ausstehende Aufgabe mit dem vorgeschriebenen Owner|Deadline|Dependencies-Gerüst, plus ein aufgetauchter CLAUDE.md-Kandidat, den die Baseline wegließ).

Getestet am: 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.

Befehle & Beispiel-Prompts

/project-butlerProjektgedächtnis über Sitzungen hinweg für KI-Codierungsagenten: Sitzungsprotokolle, Übergabe, TODO, Wiki, Status

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

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

Vollständiger Testbericht (Englisch) →