project-butler — скилл
Скилл ведет память проекта в обычных Markdown-файлах: журнал сессий, вики, правила, список дел и заметка о том, откуда продолжить
- 374 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Создает и обновляет файлы в корне проекта, включая CLAUDE.md, а по команде `organize files` переносит новые файлы по правилам структуры
- Складывает в папку log пересказы сессий, поэтому в них могут оказаться детали вашего кода и решений
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/project-butlerОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Создает и обновляет файлы в корне проекта, включая CLAUDE.md, а по команде `organize files` переносит новые файлы по правилам структуры
- Складывает в папку log пересказы сессий, поэтому в них могут оказаться детали вашего кода и решений
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
project-butler учит Claude Code, Cursor и Codex помнить проект между сессиями. Команда `/project-butler` один раз создает в корне проекта набор обычных Markdown-файлов: CLAUDE.md с правилами, PROJECT.md с текущей вики, STRUCTURE.md с правилами размещения файлов, UPDATE_LOG.md с вехами, DOCS.md с индексом документов, session-handoff.md и TODO.md. Рядом лежат папка log для журналов сессий и служебные файлы в .claude. Дальше работа идет обычными фразами. Фраза `end session` сохраняет прогресс, обновляет следующие шаги и записывает важные изменения. Фраза `continue` в новой сессии возвращает контекст без повторных объяснений, а `status` показывает состояние проекта и ближайший шаг. После долгого перерыва или смены ассистента `continue full context` восстанавливает всю траекторию. Кандидаты в правила, которые агент замечает по ходу работы, попадают в отдельный файл и становятся долгосрочными только после вашей проверки командой `review claude`. Для проектов с жесткими требованиями к продукту, архитектуре или дорожной карте при настройке можно создать профиль проекта: он решает, какие документы важны и какие разделы защищены, а обычное и полное закрытие сессии обновляют их по ограниченному плану. Команды `organize files` и `change language` наводят порядок в файлах по STRUCTURE.md и переключают язык файлов между английским, китайским и двуязычным режимом.
Для кого. Для разработчиков, которые часто начинают новые сессии с Claude Code, Cursor или Codex и устали каждый раз заново объяснять архитектуру, решения и правила проекта.
Подходит, если
- В каждой новой сессии приходится заново описывать архитектуру проекта, и вы хотите, чтобы агент читал это из файлов
- Решения вроде соглашений об именах теряются в истории чата, и их нужно хранить рядом с кодом
- README и список дел расходятся с реальностью, и вы хотите обновлять их при закрытии сессии
- Вы переключаетесь между Claude Code, Cursor и Codex и нужен общий источник правды в обычных файлах
- После долгого перерыва нужен полный разбор траектории проекта командой `continue full context`
Не подходит, если
- Проект одноразовый и умещается в одну сессию: набор файлов управления только добавит шума
- Вы не хотите, чтобы агент создавал в корне проекта служебные файлы вроде PROJECT.md и session-handoff.md
- Нужна автоматическая память с поиском по базе: здесь все лежит в Markdown, а поиска по индексу нет
- Вы работаете в Cursor или Codex и ждете такой же нативной работы, как в Claude Code: там скилл подключается через сгенерированные правила и поддержка идет без гарантий
Пример запроса к агенту
/project-butler настрой память проекта, а в конце работы я скажу `end session`Ограничения
- В Claude Code скилл работает нативно. Для Cursor он генерирует `.cursor/rules/project-system.mdc`, для Codex файл AGENTS.md, и поддержка без гарантий, с зеркалом основных триггеров.
- Скилл раз в сутки выполняет `git fetch` в собственной папке и предлагает обновиться. Проверка идет по инструкции скилла и срабатывает не всегда. Отключает ее переменная `PROJECT_BUTLER_NO_UPDATE_CHECK=1`.
- Правила в CLAUDE.md появляются только после вашей проверки, агент сам их не закрепляет.
- Документация и триггеры частично написаны по-китайски, при этом язык файлов проекта переключается между английским, китайским и двуязычным режимом.
- Скилл поддерживает много служебных файлов, поэтому на маленьком проекте набор может оказаться тяжелым.
Как отключить. Удалите папку ~/.claude/skills/project-butler, и скилл перестанет срабатывать. Созданные им файлы в проекте (CLAUDE.md, PROJECT.md, TODO.md, log и другие) остаются обычными файлами, их можно оставить или удалить вручную.
Частые вопросы
Как поставить project-butler в Claude Code?
Выполните git clone https://github.com/JamesShi96/project-butler.git ~/.claude/skills/project-butler, откройте проект и введите /project-butler. Скилл задаст вопросы о проекте и создаст файлы памяти. Дальше хватает фраз `end session`, `continue` и `status`.
Какие файлы создает project-butler?
В корне проекта появляются CLAUDE.md, PROJECT.md, STRUCTURE.md, UPDATE_LOG.md, DOCS.md, session-handoff.md и TODO.md, а также папки docs и log. В папке .claude лежат candidates.md с кандидатами в правила, project-profile.json, profile-pending.json и снимок файлов.
Работает ли project-butler в Cursor и Codex?
Да, но без гарантий полной поддержки. Скилл может сгенерировать `.cursor/rules/project-system.mdc` для Cursor или AGENTS.md для Codex, и они направляют ассистента на те же файлы памяти. Любой ассистент, который читает файлы проекта, может использовать их как общий контекст.
Чем project-butler отличается от файла CLAUDE.md?
CLAUDE.md здесь только верхний слой со стабильными правилами, которые вы проверяете вручную. Под ним лежат вики текущего состояния, журналы сессий, список дел и точка продолжения, а скилл сам обновляет их при завершении сессии.
Как отключить проверку обновлений?
Выставьте переменную PROJECT_BUTLER_NO_UPDATE_CHECK=1: сработает только значение 1, а 0, false или пустое значение проверку не отключат. Скилл раз в сутки выполняет `git fetch` в собственной папке и спрашивает, обновляться ли, а сам обновляется только после вашего согласия.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыObsidian и Claude Code PKM
Obsidian + Claude Code PKM
Шаблон хранилища Obsidian для Claude Code: команды /daily, /weekly, /monthly и /project связывают цели на три года с задачами на сегодня
Table Skills: project-handoff
Table Skills (project-handoff)
Скилл project-handoff сохраняет цели, решения и следующий шаг в PROJECT_STATE.md для новой сессии Codex или Claude Code
Claude Code Toolkit (robertguss)
Claude Code Toolkit
Набор скиллов и хуков для Claude Code: брейншторм, ведение проекта воркерами, вики, конвейер книги.
Плагин Claude Code, который ловит ваши поправки в диалоге и после проверки записывает их в CLAUDE.md и AGENTS.md
Скилл Claude Code собирает контекст продукта в Markdown и связывает решения с интервью, документами и гипотезами
Готовое хранилище Obsidian со скиллами для Claude Code: проекты, задачи, клиенты и обзоры, старт командой /setup-memory.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| project-butler (эта карточка) | нет | 374 | |
| Operator Memory | нет | 498 | память для агента в обычных Markdown-файлах: спецификации, решения и уроки |
| Citadel | нет | 927 | слой управления для Claude Code и Codex с одной командой /do и памятью проекта |
| LLM Wiki | нет | 1 509 | базы знаний, которые компилирует ИИ: темы, импорт и проверки |
Коротко о README
README предлагает четыре базовых действия и быструю установку, затем рассказывает об автопроверке обновлений и о том, зачем нужна такая память. Дальше идут таблицы основных и расширенных команд, схема создаваемых файлов, поддержка инструментов, слои памяти и система профилей проекта.
Бейдж для README
Исходный SKILL.md
---
name: project-butler
description: "Project memory workflow for init/upgrade, profile-aware setup, end session, normal/full close, file organization, document archiving, language switching, versioned update logs, rule review, status, wiki sync, and context recovery. Use for /project-butler, setup/初始化, foundation setup, profile setup, end session/收工, normal close, full close, foundation repair, organize files/整理文件, change language/切换语言, continue/接着上次, continue full context/全面回顾, review claude, sync wiki, status. Maintains project memory files. Runs version freshness check before trigger routing."
---
# Project Butler — Project Memory Stack
Initialize standardized project memory:
```
上层（稳定原则）
┌─────────────────────────────────────┐
│ CLAUDE.md（项目宪法）← 人工确认 │
│ ↑ candidates（AI 自动收集候选） │
└─────────────────────────────────────┘
↑ 抽象沉淀
中层（当前快照）
┌─────────────────────────────────────┐
│ PROJECT.md（项目 Wiki）← AI 自动同步 │
│ 概览 / 结构 / 模块状态 / 文件索引 │
│ STRUCTURE.md（文件管理规则）← AI 自动│
│ 目录规则 / 匹配条件 / 整理历史 │
│ UPDATE_LOG.md（里程碑变化）← AI 自动 │
│ DOCS.md（文档索引 + 元数据）← AI 自动 │
│ .claude/project-profile.json（画像配置）│
│ .claude/profile-pending.json（画像待处理）│
└─────────────────────────────────────┘
↑ 状态汇总
下层（事实流水）
┌────────────────────┐ ┌────────────────────┐
│ log/（会话日志） │ │ TODO.md（执行清单）│
│ raw + summaries │ │ owner/deadline/ │
│ + archive（分级） │ │ deps │
└────────────────────┘ └────────────────────┘
↓
session-handoff.md（下次接手点）
```
Core idea: bottom feeds top, top constrains bottom. Logs and TODOs are raw facts. Handoff marks the next resume point. Wiki is the current snapshot. Structure manages file organization. Docs index manages document output. Update Log records versioned milestone changes. Constitution is stable principles.
Supports 3 language modes: English (`en`), Chinese (`zh`), or bilingual. All content adapts to the selected language.
---
## Step -1: Version Freshness Check (always run first)