Project Butler

Pamięć projektu między sesjami dla agentów kodujących AI: logi sesji, przekazywanie, TODO, wiki, status

Autor: JamesShi96 · JamesShi96/project-butler

Testowano · Działa ★ 8.8/10

Project Butler — Pamięć projektu między sesjami dla agentów kodujących AI: logi sesji, przekazywanie, TODO, wiki, status

Co robi ten skill

Utrzymuje ustandaryzowany stos pamięci projektu (CLAUDE.md, wiki PROJECT.md, przekazywanie sesji, TODO, logi sesji, log aktualizacji, indeks dokumentów, konfiguracja profilu), dzięki czemu agenci kodujący wznawiają projekty bez ponownego wyjaśniania. Uruchamia się na /project-butler, "end session"/"收工", "continue"/"接着上次", "status", "organize files"/"整理文件", "sync wiki", "review claude" oraz przełączanie języka. Zawiera codzienne sprawdzanie świeżości wersji oparte na git, które oferuje samoaktualizację.

Raport z testu

Pobrano root SKILL.md; sprawdzono references/update-check.md, scripts/check-update.sh, references/file-templates.md, references/project-profile-system.md (wszystkie HTTP 200). Przeczytano check-update.sh w całości: wykonuje tylko git fetch/pull w swoim własnym katalogu i przeszukuje CLAUDE.md w poszukiwaniu tokenu językowego — brak curl|sh, base64 lub eksfiltracji; ograniczony do raz na 24h z zmienną środowiskową opt-out. Wyzwalacz: oceniono "end session", "整理文件", "status where are we" jako ładowania, a "what's the current git status", "set up a new React project with Vite" jako nie-ładowania (5/5, choć "status"/"setup" niosą łagodne ryzyko kolizji słów kluczowych). Test wyjścia: napisano /private/tmp/.../scratchpad/baseline.md (9-liniowa proza, 0 nagłówków, brak pól dla poszczególnych zadań) vs skill-log.md ściśle według formatu Session Log (29 linii, 7 kanonicznych nagłówków, każde oczekujące zadanie z wymaganym szablonem Owner|Deadline|Dependencies, plus ujawniony kandydat CLAUDE.md, który bazowy pominął).

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

Instalacja

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.

Komendy i przykładowe prompty

  • /project-butlerPamięć projektu między sesjami dla agentów kodujących AI: logi sesji, przekazywanie, TODO, wiki, status

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

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