Project Butler

Mezisesní projektová paměť pro AI kódovací agenty: logy relací, předání, TODO, wiki, stav

od JamesShi96 · JamesShi96/project-butler

Otestováno · Funguje ★ 8.8/10

Project Butler — Mezisesní projektová paměť pro AI kódovací agenty: logy relací, předání, TODO, wiki, stav

Co umí

Udržuje standardizovaný zásobník projektové paměti (CLAUDE.md, PROJECT.md wiki, session-handoff, TODO, logy relací, log aktualizací, index dokumentů, konfigurace profilu), takže kódovací agenti mohou pokračovat v projektech bez opětovného vysvětlování. Spouští se na /project-butler, "end session"/"收工", "continue"/"接着上次", "status", "organize files"/"整理文件", "sync wiki", "review claude" a přepínání jazyků. Zahrnuje denní kontrolu aktuálnosti verze založenou na gitu, která nabízí samoaktualizaci.

Testovací report

Načten kořenový SKILL.md; namátkově zkontrolovány references/update-check.md, scripts/check-update.sh, references/file-templates.md, references/project-profile-system.md (vše HTTP 200). Přečten check-update.sh kompletně: provádí pouze git fetch/pull ve svém vlastním adresáři a grepuje CLAUDE.md pro jazykový token – žádné curl|sh, base64 nebo exfiltrace; omezeno na jednou za 24 hodin s proměnnou prostředí pro odhlášení. Spouštěč: "end session", "整理文件", "status where are we" posouzeny jako načtení a "what's the current git status", "set up a new React project with Vite" jako nenačtení (5/5, ačkoli "status"/"setup" nesou mírné riziko kolize klíčových slov). Výstupní test: napsán /private/tmp/.../scratchpad/baseline.md (9řádková próza, 0 záhlaví, žádná pole pro úkoly) vs. skill-log.md striktně podle formátu Session Log (29 řádků, 7 kanonických záhlaví, každý čekající úkol s povinným Owner|Deadline|Dependencies scaffoldem, plus odhalený kandidát CLAUDE.md, který baseline vynechala).

Testováno: 2026-07-31 · Claude Code 2.x (agent harness)

Instalace

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.

Příkazy a ukázkové prompty

/project-butlerMezisesní projektová paměť pro AI kódovací agenty: logy relací, předání, TODO, wiki, stav

Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):

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

Kompletní testovací report (anglicky) →