Project Butler

Projektminne över sessioner för AI-kodningsagenter: sessionsloggar, överlämning, TODO, wiki, status

av JamesShi96 · JamesShi96/project-butler

Testad · Fungerar ★ 8.8/10

Project Butler — Projektminne över sessioner för AI-kodningsagenter: sessionsloggar, överlämning, TODO, wiki, status

Vad den gör

Upprätthåller en standardiserad projektminnesstack (CLAUDE.md, PROJECT.md wiki, sessionsöverlämning, TODO, sessionsloggar, uppdateringslogg, dokumentindex, profilkonfiguration) så att kodningsagenter återupptar projekt utan omförklaring. Utlöses på /project-butler, "end session"/"收工", "continue"/"接着上次", "status", "organize files"/"整理文件", "sync wiki", "review claude", och språkbyte. Inkluderar en daglig git-baserad versionsfriskhetskontroll som erbjuder att självuppdatera.

Testrapport

Hämtade root SKILL.md; stickprovskontrollerade references/update-check.md, scripts/check-update.sh, references/file-templates.md, references/project-profile-system.md (alla HTTP 200). Läste check-update.sh fullständigt: den utför endast git fetch/pull i sin egen katalog och greppar CLAUDE.md efter en språktoken – inga curl|sh, base64 eller exfiltrering; begränsad till en gång var 24:e timme med en opt-out miljövariabel. Trigger: bedömde "end session", "整理文件", "status where are we" som laddningar och "what's the current git status", "set up a new React project with Vite" som icke-laddningar (5/5, även om "status"/"setup" medför en mild risk för nyckelordskollision). Utdata-test: skrev /private/tmp/.../scratchpad/baseline.md (9-radig prosa, 0 rubriker, inga fält per uppgift) kontra skill-log.md som strikt följde Session Log Format (29 rader, 7 kanoniska rubriker, varje väntande uppgift med den obligatoriska Owner|Deadline|Dependencies-byggnadsställningen, plus en framtagen CLAUDE.md-kandidat som baseline utelämnade).

Testad: 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.

Kommandon och exempelprompter

/project-butlerProjektminne över sessioner för AI-kodningsagenter: sessionsloggar, överlämning, TODO, wiki, status

Skills triggas av vanliga förfrågningar — inga kommandon att memorera. Efter installationen aktiverar prompter som dessa skillen (på engelska):

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

Läs hela rapporten →