--- name: agent-prompt-kit description: "Из законченной работы — в специализированное окружение. По команде /agent-prompt-kit навык читает текущую сессию и связанные сессии рантайма, выводит карточку задачи и карточку домена (модули M1, M2), создаёт каталог нового Workspace или сохранённого агента с правилами AGENTS.md, навыком-специализацией, разобранными примерами, критерием приёмки и хранилищем прежней работы, затем называет шаг регистрации и отдаёт стартовый промпт. Загружать, когда класс работ повторяется и следующий раз должен начинаться с готовой среды: «сделай специалиста под эту тему», «создай воркспейс под такие задачи», «мы это уже делали — подготовь рабочее место», «проанализируй сессию и собери среду»." license: MIT version: 1.2.2 upstream: https://github.com/paulmann/agent-prompt-kit --- # `/agent-prompt-kit` — из сессии в специализированное окружение Одна команда = один результат: **каталог, в котором аналогичная работа выполняется качественно с первого шага** — потому что в нём уже лежат правила, специализация, разобранные примеры, критерий приёмки и найденный прошлый опыт. Это **не** «надеть на текущую сессию другой характер». Смена роли в текущем окне — побочный режим (см. §7). Основное действие — создать рабочее место, зарегистрировать его и передать в него задачу. ## 1. Материал: текущая сессия и связанные Источники в порядке доверия: | # | Источник | Что даёт | |---|---|---| | 1 | Контекст текущей сессии | что просили, что сделали, что проверили, где сломались | | 2 | Индекс всех сессий рантайма (если есть) | то же по прошлым сессиям и другим окружениям | | 3 | Транскрипты и файлы сессий | подробности, если индекс обрезал текст | | 4 | Рабочее дерево проекта и `memory/` | действующие правила и прежние записи опыта | Правила: - Цитируй сессию, а не впечатление: «в сессии `` пробовали X, получили Y». - **Фильтруй шум индекса.** В индексе лежат инъекции контекста, транскрипты инструментов и дампы окружения. Вывод «это обсуждалось» делается только по сообщениям пользователя. - Прошлая сессия — свидетельство о том, что было, а не о том, что верно сейчас. Проверяй заново. ## 2. Карточки: что за класс работ ```text КАРТОЧКА ЗАДАЧИ Тема · Результат · Адресат · Успех значит · Ограничения · Неизвестно · Вне рамок КАРТОЧКА ДОМЕНА Практик · Словарь (5-9 терминов) · Набор навыков (3-6) · Проверить (3-5 фактов) · Источники истины · Типичный провал · Готово, когда · Анти-паттерны ``` Чего нет в материале — пиши `неизвестно`. Догадка вместо факта — дефект: следующий агент примет её за правило. ## 3. Окружение: что именно создать ```text <корень нового окружения>/ AGENTS.md правила этого класса работ (сжато: инварианты + доменные запреты) DOMAIN-CARD.md карточка домена; внутри — критерий приёмки, проверяемый ревьюером .dsh/skills/<тема>/SKILL.md специализация: видна в палитре только внутри этого окружения examples/ два-три разобранных случая: обычный и провальный memory/ хранилище опыта (M13): recipes/, failures/, tasks/, artifacts/ README.md что это, как пользоваться, версия и дата ``` Требования к содержимому: | Файл | Обязательно внутри | |---|---| | `AGENTS.md` | правила безопасности, запрет секретов, шаг проверки каждой работы, границы домена | | `DOMAIN-CARD.md` | критерий приёмки одной фразой, проверяемой без вопросов к автору | | `SKILL.md` | когда загружать, что делать, чем проверять; доменные анти-паттерны | | `examples/` | минимум один провал с причиной — иначе примеры учат только happy path | | `memory/` | хотя бы один рецепт или запись провала, прошедшая `experience.py check` | ## 4. Регистрация: честно про каждый рантайм Окружение становится рабочим только когда рантайм о нём знает. Это единственный шаг, который агент часто не может сделать сам, — и его запрещено изображать выполненным. | Рантайм | Что делает модель | Что делает человек | Проверка | |---|---|---|---| | **HARNESS** | создаёт каталог целиком со всеми файлами | добавляет каталог как Workspace (левая панель → добавить Workspace) | каталог появился в списке Workspace | | **AutoClaw2** | пишет навык в `<профиль>\.pi\agent\skills\` и файл команды в `...\prompts\` | перезагружает приложение, чтобы снимок ресурсов пересобрался | команда видна в палитре `/`, навык — в списке | | **SagaAI / другой** | зависит от наличия API регистрации | по обстановке | назови шаг, а не подразумевай | Формулировка для отчёта: «каталог создан по пути X; остался один шаг, который я сделать не могу: <точное действие>». ## 5. Передача: стартовый промпт Последний выход — готовый текст для нового окна, а не «теперь идите работайте»: ```text Окружение: <путь> Правила: AGENTS.md этого окружения — читать первым. Задача: <первая конкретная задача класса> Критерий приёмки: <из DOMAIN-CARD.md> С чего начать: python tools/experience.py search "<слова задачи>" --root . ``` ## 6. Проверка результата - Каждый файл существует по названному пути; ни один чужой файл не перезаписан. - `python tools/experience.py check --root <окружение>` → `PASS`. - Критерий приёмки в `DOMAIN-CARD.md` проверяем без вопросов к автору. - Шаг регистрации назван, и его результат можно увидеть (запись в списке Workspace, команда в палитре). - В отчёте есть строка ворот: `ворота 12/12` или `ворота N/12 — провалы: <причины>`. ## 7. Побочный режим: специализация текущей сессии Если окружение не нужно — например, задача разовая, — навык работает как промпт на сессию: карточка задачи и карточка домена до действий, метки `[факт]`/`[вывод]`/`[предположение]`, ворота из 12 проверок строкой. Это тот же каркас, но без шагов 3–5. Смешивать режимы нельзя: обещав окружение, отдай каталог, а не настроение. ## 8. Безопасность 1. Секреты, токены, ключи, cookies, данные сессий не попадают ни в окружение, ни в `memory/`. Заполнители: ``, ``, ``, ``, ``, ``. 2. Персональные данные и содержимое заказчика не сохраняются: хранится форма решения. 3. Записи опыта не удаляются — только `deprecated` со ссылкой на замену. 4. Не перезаписывай существующие файлы: при совпадении пути — бэкап рядом и строка в отчёте. ## 9. Файлы набора | Файл | Что это | |---|---| | `PROMPT.md` / `PROMPT.ru.md` | каркас: 14 модулей, 14 строк `Check`, 10 инвариантов, ворота 12 | | `docs/INSTALL.md` | установка в AutoClaw2, HARNESS, SagaAI с проверкой | | `docs/ADAPTATION.md` | как заполнять карточку домена | | `skills/experience-reuse/` | M13: шаблоны записей, примеры, политика | | `tools/experience.py` | хранилище опыта: `search`, `add`, `check`, `deprecate`, `selftest` | | `tools/install.py` | установка навыка и команды в рантайм, с `--check` | Версия 1.2.0 · MIT · https://github.com/paulmann/agent-prompt-kit