Table Skills: project-handoff
Table Skills (project-handoff)
Скилл project-handoff сохраняет цели, решения и следующий шаг в PROJECT_STATE.md для новой сессии Codex или Claude Code
- 453 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Скилл пишет `PROJECT_STATE.md` в проект и перечитывает его при восстановлении, поэтому сомнительные записи в нем стоит проверять
- Необязательные хуки запускают Python-скрипты на каждом сообщении и при сжатии контекста
- В Codex скилл по вашему подтверждению сам создает новое задание и отправляет в него сообщения
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/table-skills-project-handoffОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Скилл пишет `PROJECT_STATE.md` в проект и перечитывает его при восстановлении, поэтому сомнительные записи в нем стоит проверять
- Необязательные хуки запускают Python-скрипты на каждом сообщении и при сжатии контекста
- В Codex скилл по вашему подтверждению сам создает новое задание и отправляет в него сообщения
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
В репозитории два раздела, действующий из них один: project-handoff. Скилл собирает для долгой задачи материал для передачи в новую сессию. В него входят цель, принятые решения, ключевые файлы, реальный прогресс и следующий шаг. Записывается только то, что влияет на продолжение, а полную переписку агент не копирует. Материал лежит в файле `PROJECT_STATE.md` в корне проекта или в уже существующем у проекта хранилище состояния. Если собеседник просит только сохранить, скилл отдает путь к файлу и текст для первого сообщения в новой сессии. По прямому разрешению на новое задание и продолжение в Codex скилл сам создает новую сессию, проверяет записанное и продолжает с первого шага. Вторая функция: скилл оценивает, пора ли предложить передачу. Он смотрит на безопасный момент, ясный следующий шаг и конкретную пользу от новой сессии. Подсказка идет в начале итогового ответа. Дополнительные хуки считают автоматические сжатия контекста и напоминают после третьего. Соседний раздел web-stand-in автор объявил устаревшим и оставил как заметки по идее, устанавливать его не нужно.
Для кого. Разработчикам и исследователям, которые ведут долгие задачи в Codex или Claude Code, часто упираются в сжатие контекста и теряют решения при смене сессии.
Подходит, если
- Сессия разрослась, и перед переходом в новую надо зафиксировать, что решено и что отвергнуто
- Работа остановилась на полпути, а завтра ее продолжит другая сессия с чистым контекстом
- Агент уже несколько раз сжимал контекст, и вы хотите получить подсказку, когда стоит сменить сессию
- В проекте несколько задач, и состояние каждой должно лежать в своем блоке общего файла без перезаписи соседних
Не подходит, если
- Нужна постоянная память между всеми проектами: скилл сохраняет состояние одной задачи, для общей памяти есть AI Memory Skillpack
- Нужно хранить полную историю переписки: скилл сохраняет только то, что влияет на продолжение
- Нужен автоматический перенос в Claude Code: он пока не умеет создавать и открывать новое задание, поэтому доступны только сохранение и текст первого сообщения
- Нужно переносить установки, коммиты или публикации: сохранение к ним отношения не имеет и их не выполняет
Пример запроса к агенту
Сохрани прогресс по задаче через project-handoff и дай текст первого сообщения для новой сессии, новую пока не создавайОграничения
Автор ориентируется на Codex для Windows, где проверен хук. Адаптер для Claude Code (`scripts/claude_hook.py`) подсчет сжатий и подмену состояния уже показал в работе, а полную цепочку напоминаний гоняли на смоделированных событиях. До третьего настоящего автосжатия в живой сессии Claude Code она не доходила.
Хук включают отдельно: пути из шаблона заменяют, конфигурацию объединяют с вашей и подтверждают доверие в клиенте. Скилл не добавляет хук сам и не умеет подставить недостающие инструменты и права.
Инструкции написаны по-китайски, агент объясняет их по ходу. Копировать нужно папку скилла целиком: одного `SKILL.md` мало.
Как отключить. Удалите папку project-handoff из каталога скиллов агента и уберите добавленные записи хука из конфигурации Codex или `~/.claude/settings.json`. Достаточно сказать агенту «本任务不再主动提醒交接», чтобы отключить напоминания в текущей задаче. Файл `PROJECT_STATE.md` остается, его удаляют вручную.
Частые вопросы
Как вызвать project-handoff в Codex и в Claude Code?
В Codex командой `$project-handoff`, в Claude Code командой `/project-handoff`. Можно написать и обычной фразой: «сохрани прогресс» или «открой новую сессию и продолжи». Нечеткая просьба «передай задачу» приводит только к сохранению.
Создает ли скилл новую сессию без разрешения?
Нет. Напоминание, сохранение и создание новой сессии идут как отдельные действия, и для последнего нужно ваше подтверждение конкретного плана: сохранить, открыть новую сессию в указанной папке, сверить и продолжить. Обычное «продолжай» разрешением не считается.
Куда скилл записывает состояние?
В `PROJECT_STATE.md` в корне проекта либо в уже существующее хранилище состояния проекта. Блок каждой задачи заключен в метки BEGIN и END с номером передачи, чтобы несколько задач не затирали друг друга.
Когда скилл напоминает о передаче?
После третьего автоматического сжатия контекста, если момент безопасный и следующий шаг понятен. Следующие напоминания требуют нового этапа, конкретной пользы и еще трех сжатий после предыдущего. Без хука напоминания зависят от самопроверки агента.
Нужно ли ставить web-stand-in?
Нет. Автор объявил этот раздел устаревшим: от него остался файл с идеей `web-stand-in/思路.md`, а установочной точки нет.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл ведет память проекта в обычных Markdown-файлах: журнал сессий, вики, правила, список дел и заметка о том, откуда продолжить
Скилл допрашивает план до начала работы: вопросы раундами с рекомендованным ответом, без правок до вашего подтверждения
Личная коллекция скиллов cafe3310: ведение проекта по спецификации, обзор кода, отчеты, браузер, 3D и видео в одном репозитории
Семь скиллов для Claude Code: из ссылки на видео, статью или PDF получается текст и план действий, плюс скрам-коуч, журнал сессий и разбор застрявших задач
CLI превращает сессию кодинг-агента в страницу с разговором, инструментами и патчем, которую можно передать коллеге.
Около сотни скиллов для Claude Code: встречи и расшифровки, исследования, публикации, TDD, Telegram, почта и личная аналитика
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Table Skills: project-handoff (эта карточка) | нет | 453 | |
| AI Memory Skillpack | нет | 491 | ведет постоянную память проекта в папке docs/ai; project-handoff сохраняет состояние одной задачи для следующей сессии |
| Claude Code Memory Setup — память на Obsidian | нет | 1 059 | память между сессиями через хранилище Obsidian и команды /save и /resume; здесь файл состояния и отдельные разрешения |
Коротко о README
Страница на китайском описывает репозиторий как собрание рабочих приемов с ИИ. Действующий раздел один, project-handoff, а web-stand-in оставлен как заметки. Дальше идут установка ссылкой для агента, примеры фраз для сохранения, передачи и восстановления, правила напоминаний, описание необязательных хуков и просьба сообщать при ошибках хост, систему и шаги, скрыв личные данные.
Бейдж для README
Исходный SKILL.md
--- name: project-handoff description: 项目交接：把长任务的目标、有效决定、真实进度、关键文件和下一步整理成接手材料，让新对话核对后继续，避免重述和两边同时改。用户说“保存一下进度”“整理交接”“开个新对话接着做”“读 PROJECT_STATE 继续上次”时使用；宿主注入 project-handoff 压缩计数、到达压缩检查点、准备交付一个可验收阶段、发现已核实的目标或版本混淆时，也用它评估是否建议交接。提醒、保存、新建接续是三个独立动作，互不授权。 --- # 项目交接 让接手对话拿到当前成果、有效决定和明确的第一步，不用用户重述，也不会两个对话同时改。适用于代码、文档、研究和媒体制作。提醒、保存、新建接续是三个动作，各有各的授权：提醒不写文件，保存不开新对话，新建只在用户确认了具体提议之后。