AI Memory Skillpack — скилл
Скиллы ведут память проекта в папке docs/ai: короткие файлы с лимитом размера, одна страница передачи дел и проверка установки
- 491 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Установщик выполняет сам агент: он правит глобальные `AGENTS.md` и `CLAUDE.md` и создает симлинки скиллов
- Файлы `docs/ai/` лежат в репозитории и вместе с содержимым памяти могут попасть в публичный git
- Запрет на запись секретов держится на правилах и очистке по шаблонам, полной гарантии нет
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/ai-memory-skillpackОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Установщик выполняет сам агент: он правит глобальные `AGENTS.md` и `CLAUDE.md` и создает симлинки скиллов
- Файлы `docs/ai/` лежат в репозитории и вместе с содержимым памяти могут попасть в публичный git
- Запрет на запись секретов держится на правилах и очистке по шаблонам, полной гарантии нет
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
AI Memory Skillpack превращает папку `docs/ai/` в репозитории в память проекта с жесткими лимитами размера. В ней лежат карточка проекта до 60 строк, архитектура до 250, регламент запуска до 150, список ловушек до 300, решения ADR до 80 строк каждое и файл `handoff.md` до 120 строк. `handoff.md` каждый раз заменяется целиком, а историю хранит git: отдельных журналов изменений нет. Файлы делятся на три уровня чтения. Карточку проекта и `handoff.md` агент читает целиком в начале сессии, архитектуру, регламент и ловушки ищет по ключевым словам через `rg`, а каталог `history/` открывает только по прямой просьбе. Перед заменой `handoff.md` скилл перечитывает его заголовок и берет блокировку `flock`, чтобы два агента не затерли друг друга. Каждая правка подписывается автором в формате `harness/model`. В пакете три скилла. `ai-project-memory` ставится всегда, `llm-wiki` и `project-mastery-coach` только при наличии локальной вики. Установщик `INSTALL.md` написан для агента: он подстраивает пути, объединяет глобальные правила `AGENTS.md` и `CLAUDE.md` и записывает квитанцию установки. Результат проверяет `VERIFY.md` по кодам выхода, целостность файлов задает `SHA256SUMS`.
Для кого. Мейнтейнерам и одиночным разработчикам на Codex CLI, иногда с Claude Code, которые хотят, чтобы следующая сессия знала проект без перечитывания горы заметок.
Подходит, если
- Вторая и третья сессия на одном репозитории тратят десятки тысяч токенов на вчерашние заметки
- Работу передают между Codex и Claude Code: оба читают один `handoff.md` и подписывают правки своим именем
- Значения секретов не должны попадать в память: `SYSTEM.md` запрещает их записывать
- Установленную память обновляют до новой версии пакета, и свои правки надо сохранить: сверка по хэшам квитанции их не трогает
- Результат установки проверяют скриптом: `VERIFY.md` и `sha256sum -c SHA256SUMS` дают коды выхода
Не подходит, если
- Нужен сервер памяти с поиском по смыслу: здесь файлы и поиск через `rg`, а серверы памяти есть в каталоге, например Basic Memory
- Компьютер на Windows без WSL: установщику нужны Linux или WSL, bash 4.4 и новее, `git`, `rg` и `sha256sum`
- Память должна быть на русском: скилл по умолчанию велит писать прозу по-китайски, команды и идентификаторы остаются английскими
- Проект лежит вне git: установка идет в урезанном режиме, а правила про коммиты не действуют
Пример запроса к агенту
Заведи docs/ai для этого репозитория и запиши в handoff, на чем мы остановились и какие тесты еще падаютОграничения
- Основной агент пакета Codex CLI, а Claude Code поддерживается вторым клиентом через симлинки на те же файлы скиллов.
- В скиллы вписаны примерные пути и имена авторов правок (`claude-code/fable-5`, `codex/gpt-5.6-sol-pro`), установщик подстраивает их под вашу машину.
- На macOS нужны GNU `sha256sum`, `flock`, `readlink -f` и свежий bash, иначе установщик останавливается.
- Скрипты вики в репозитории не лежат, поэтому `llm-wiki` и `project-mastery-coach` без собственной вики не включаются.
Как отключить. Установка обратима, откат описан в `INSTALL.md`, а квитанция с хэшами показывает, что поставил пакет. Вручную уберите секции памяти из `AGENTS.md` и `CLAUDE.md`, симлинки скиллов у второго клиента и каталоги скиллов пакета. Папки `docs/ai/` в репозиториях удаляйте по одному проекту.
Частые вопросы
Как поставить AI Memory Skillpack?
Склонируйте репозиторий, выполните в нем `sha256sum -c SHA256SUMS` и скажите Codex: «Прочитай INSTALL.md из этого пакета и установи по нему систему памяти на этот компьютер». Графического установщика нет: установщик написан для агента.
Работает ли пакет в Claude Code?
Да, как второй клиент. Файлы скиллов лежат у основного агента, Claude Code получает симлинки на них, а правила памяти для него пишутся в `CLAUDE.md` отдельно, потому что настройки клиентов по умолчанию различаются.
Что будет, если я правил файлы памяти вручную?
Обновление сверяет хэши файлов из квитанции. Файлы, которые вы изменили, остаются, а расхождения установщик показывает отчетом.
Нужна ли локальная вики?
Нет. Без вики установщик пропускает `llm-wiki` и `project-mastery-coach` и ставит только `ai-project-memory`.
Куда агент пишет память проекта?
В папку `docs/ai/` репозитория: `project-card.md`, `architecture.md`, `runbook.md`, `handoff.md`, `gotchas.md` и каталоги `diagrams/`, `decisions/` и `history/`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Скиллыai-memory сохраняет опыт сессий в Markdown-вики, подключает поиск через MCP и передает контекст между агентами и машинами.
Долговременная память для ИИ-агентов: файлы Markdown как источник истины, индекс SQLite как кэш, общая у Claude Code, Codex и других
Постоянная память проекта в Markdown: решения, требования и ограничения лежат в репозитории, и новый сеанс агента их читает.
Плагин для Claude Code и Codex: общая доска задач, память проекта, отчеты и панель, где видна работа агентов из разных сессий
Agentic Substrate
Agentic Substrate (claude-user-memory)
Короткий обратимый набор правил для агента: исследуй неясное, планируй соразмерно, проверяй результат и храни выверенные знания
Переносимая папка .agent с памятью, скиллами и протоколами, которая подключается к разным кодовым агентам и не теряет знания при смене инструмента
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| AI Memory Skillpack (эта карточка) | нет | 491 | ||
| Basic Memory | нет | не нужна | 4 495 | локальный сервер с MCP, заметками в Markdown и смысловым поиском, а пакет держит память файлами в `docs/ai/` |
| Claude-Mem | нет | 113 534 | плагин сохраняет наблюдения из сессий и подставляет их в новые, а пакет ограничивает размер файлов памяти |
Коротко о README
Главная страница подает память как три уровня чтения и сравнивает ее с обычными заметками, которые только растут. Дальше идут состав пакета, архитектура из четырех слоев, требования безопасности и качества, принципы проекта и таблица скиллов. Отдельно разобраны установка в трех случаях (чистая, обновление, миграция), требования к системе и состав репозитория.
Бейдж для README
Исходный SKILL.md
--- name: ai-project-memory description: Maintain bounded, durable AI project memory in a repository's docs/ai/ pack. Use when Codex or Claude Code needs to create, read, update, or audit project memory (project-card, architecture, diagrams, runbook, handoff, gotchas, ADRs), install AGENTS.md memory rules, or sync a lightweight central LLM Wiki project entity for user-owned projects. --- # AI Project Memory ## Core Rule 每个仓库的 `docs/ai/` 是该项目记忆的唯一事实源;**git 提交是唯一账本**(change-log 类文件已于 2026-07-28 停用,历史封存于 `docs/ai/history/`,不得重建)。 ```text docs/ai/ ├── project-card.md # 卡片:≤60 行,替换 ├── architecture.md # 架构入口:≤250 行,替换/局部更新 ├── diagrams/ # README ≤60 行 + *.mmd(一图一文件) ├── runbook.md # 操作手册:≤150 行,替换/局部更新 ├── handoff.md # 单快照:≤120 行,替换 ├── gotchas.md # 耐久陷阱:≤300 行,追加 + 定期精选 ├── decisions/ADR-*.md # 单篇 ≤80 行,新篇追加,旧篇冷存 └── history/ # 封存区,默认不读 ``` 记忆散文默认中文;命令、路径、代码标识符、config key、版本号保持英文。不写 secret 值。预算上限见上方结构图;仓库 `AGENTS.md` 只可声明更严(更小)的上限,不得放宽——VERIFY 硬门按固定常量执行,不识别放宽。 ## 读取纪律(检索先行) - **HOT(开机整读,口径 = 字节÷3)**:仓库 `AGENTS.md`、`CLAUDE.md`、`project-card.md`、`handoff.md`——四文件自身目标 ≤7k tokens;四文件 + 当前触发的 skill 正文合计 ≤10k。 - **WARM(按需定向,禁止整读)**:`architecture.md`、`runbook.md`、`gotchas.md`、`diagrams/README.md`、`decisions/`(现行 ADR)——用任务关键词(路径、symbol、config key、报错信息)`rg` 定位小节后只读该节。 - **COLD(默认不读)**:`history/`、`reports/`、`screenshots/`、`learning/`、旧 ADR(Status: superseded/deprecated)。仅任务明确要求追溯时才进,读到的内容必须与当前代码交叉核对后才能引用。 - **非分层新条目**:向 `docs/ai/` 一级新增任何文件/目录,必须同时在仓库 `AGENTS.md` 声明其层级;未声明即 COLD 且属违规(VERIFY 白名单断言会拦)。 ## 写入纪律 1. **谁干活谁写**:Codex 与 Claude Code 均可写,完成实质任务的一方负责更新。 2. **强制署名**,actor 只有两个拼法:`claude-code/fable-5`、`codex/gpt-5.6-sol-pro`。 - `handoff.md` 头部两行,固定列表项形式:`- updated: <ISO8601>`、`- updated_by: <actor>`(守卫与工具用 `grep -m1 '^- updated: '` 读取基线) - 追加条目(gotchas / ADR)末行:`— by <actor> · YYYY-MM-DD` - git 提交:Co-Authored-By trailer 对应同一 actor 3. **状态用替换**:`handoff.md` 永远是单快照 replace-in-place,不追加历史;追加语义仅限 gotchas 条目与新 ADR。