dsh-desktop-kit 1.0.0 → 2.0.1

package/skills/content-writing/references/quick-recipes.md

@@ -0,0 +1,99 @@
+> Часть навыка content-writing. ≈2k токенов. Читать, когда: нужен быстрый пост на один экран, короткий бриф или отчёт, либо приёмка «P0/P1/P2» перед сдачей.
+
+# Быстрые рецепты и приёмка
+
+> Для коротких задач и финальной проверки. Полный порядок работы — `process.md`; доменные детали —
+> в тематических references.
+
+## 1. Лайт-режим: пост на один экран (10 минут)
+
+Когда нужен быстрый пост, а не лонгрид:
+
+1. **Кому и зачем** — одно предложение, без брифа на страницу.
+2. **Один факт/мысль** — остальное в комментарии или в следующем посте.
+3. **Хук** — первая строка: конкретика, цифра, вопрос по делу, мини-сцена. Не «Друзья, сегодня…».
+4. **Тело** — 3–6 коротких абзацев или 4–6 пунктов; одна мысль на абзац.
+5. **Факт-чек на бегу** — имя, дата, цифра, телефон, ссылка. Всё открывается.
+6. **CTA** — один: записаться, прочитать, поделиться.
+7. **Картинка** — по смыслу, 1080×1350, текст на картинке читается на телефоне.
+8. **Проверка** — прочитай вслух, убери канцелярит и штампы, проверь орфографию и ссылки.
+9. **Канал** — адаптируй длину и формат под площадку (`social-media.md` §2).
+
+Готовые шаблоны постов — `assets/templates/post-vk.md`, `post-telegram.md`; форматы и хуки — `social-media.md`.
+
+## 2. Короткий бриф
+
+```
+Задача:            <что за текст и где публикуем>
+Аудитория:         <кто, что знает, чего боится, как говорит>
+Цель:              <одно действие/понимание>
+Канал и объём:     <сайт / ВК / Telegram / Дзен / релиз; знаки или экраны>
+Тон:               <нейтральный / тёплый / официальный / научпоп>
+Факты от заказчика: <что дали: цифры, имена, документы, цитаты>
+Чего не хватает:   <что надо найти/уточнить/согласовать>
+Ограничения:       <юридика, реклама, нельзя говорить, обязательные ссылки>
+CTA:               <куда ведём читателя>
+Дедлайн/согласование: <кто утверждает и когда>
+```
+
+Полный бриф — `templates.md` §1 и `assets/templates/brief.md`.
+
+## 3. Отчёт
+
+```
+## Текст: <название/тема> · <канал>
+Аудитория и цель: <1–2 строки>
+Что сделано: <формат, объём, структура, ключевые ходы>
+Факты: <N проверено; источники: <список 3–5 главных>; что осталось непроверенным и почему>
+Риски: <юридические/медицинские/репутационные/согласования>
+Визуал: <какая картинка, права/генерация, alt>
+SEO: <title/description/H1, перелинковка — если сайт>
+Что дальше: <1–3 шага: согласовать, дополнить, опубликовать, обновить>
+```
+
+Без отчёта работа не сдана: он фиксирует, что проверено, а что осталось на совести заказчика.
+
+## 4. Гейт P0/P1/P2
+
+**P0 — без этого не сдавать:**
+
+- [ ] Понятно, кому и зачем текст; формат соответствует каналу; CTA один.
+- [ ] Все факты, цифры, имена, даты, должности проверены; источник может быть предъявлен.
+- [ ] Цитаты дословны и атрибутированы; пересказы без кавычек; анонимок без причины нет.
+- [ ] Нет выдуманных исследований, отзывов, кейсов, фото.
+- [ ] Заголовок и лид не обещают того, чего нет в тексте.
+- [ ] Медицина: автор/рецензент, даты, источники, дисклеймер, нет обещаний излечения.
+- [ ] Права на все изображения есть; пациенты/дети/ПДн — согласия.
+- [ ] Ссылки открываются; нет `[ПРОВЕРИТЬ]` и заглушек.
+- [ ] Нет опечаток, битой типографики, «ё» и чисел по стилю издания.
+- [ ] Для сайта: `title`, `description`, один `H1`, alt, даты, автор, JSON-LD (см. `seo`).
+
+**P1 — сильно улучшает:**
+
+- [ ] Первый абзац цепляет конкретикой, а не «в современном мире».
+- [ ] Текст читается вслух без спотыканий; ритм предложений неровный.
+- [ ] 3–6 контекстных ссылок/переходов; есть «что дальше».
+- [ ] Картинка по смыслу, подпись и alt; превью проверено на телефоне.
+- [ ] Отчёт заказчику: источники, непроверенное, риски.
+
+**P2 — полировка:**
+
+- [ ] Единый стиль терминов и оформления (`editing.md`).
+- [ ] Абзацы 2–5 предложений; подзаголовки-вопросы.
+- [ ] Нет AI-штампов из `process.md` §4 и симметричных конструкций.
+- [ ] Проверено в реальной вёрстке/канале.
+
+Дублирующий отраслевой чек-лист — `assets/checklists/publish.md` (факты, медицина, права, SEO, соцсети).
+
+## 5. Связка с другими скиллами
+
+- **`seo`** — обязателен для любого текста на сайте: интент, title/description, H1/H2, перелинковка,
+  структурированные данные, E-E-A-T. `seo-content.md` — только мост, не замена.
+- **`img`** — генерация иллюстраций: FLUX.1-schnell (качество) / RealVisXL (скорость), промпты по формуле,
+  проверка глазами. `images.md` — как выбрать, снять права и вписать в публикацию.
+- **`wow-design`** — если текст идёт в вёрстку/лендинг: композиция, типографика, ритм.
+- **`office`** — если материал сдаётся в Word/PowerPoint/PDF.
+- **`requirements-and-planning`** — если задача «сделать контент-план/серию материалов»: цели, аудитории,
+  рубрики, риски, критерии приёмки.
+- **`code-review-checklist`** — если правится код публикации/шаблона, а не только текст.
+- **`web-research`** — если нужны свежие внешние факты: дата, два источника, ссылки.

package/skills/content-writing/references/rules.md

@@ -0,0 +1,85 @@
+> Часть навыка content-writing. ≈2.8k токенов. Читать, когда: нужен полный контракт, правила достоверности и список антипаттернов — факт-чек, юридические и медицинские риски, спор о качестве текста.
+
+# Контракт, достоверность, антипаттерны
+
+> Свод правил, которые нельзя нарушать. Порядок работы — `process.md`; отраслевые детали —
+> `government-medical.md`, `fact-checking.md`, `science-popular.md`, `anti-ai-style.md`.
+
+## 1. Контракт: десять правил
+
+1. **Не выдумывать.** Нет источника — нет утверждения. Нет точной цитаты — нет кавычек. Нельзя «слегка
+   поправить» имя, дату, цифру, название исследования или должность. Выдуманные факты, цитаты, исследования
+   и отзывы — брак, а не «допущение».
+2. **Каждый факт проверяем.** Цифры, даты, имена, должности, организации, нормы, дозировки — сверить
+   с источником, а не «по памяти»; в черновике фиксировать, откуда факт.
+3. **Медицина и наука — YMYL.** Ни обещаний излечения, ни «гарантии результата»: автор-врач, даты
+   публикации/проверки, источники, дисклеймер; ограничения исследований не вырезать (`government-medical.md`
+   §5, `science-popular.md`).
+4. **Честность про неопределённость.** «Данных мало», «причина неизвестна», «это гипотеза» — нормальные
+   слова. Уверенный тон без оснований — обман.
+5. **Приватность.** Пациенты, врачи, дети, сотрудники: фото, истории, диагнозы, документы — только
+   с письменного согласия (152-ФЗ, врачебная тайна 323-ФЗ). Лишние ПДн не публиковать.
+6. **Авторское право.** Не копировать чужие тексты, фото, графику. Цитата — в необходимом для смысла
+   объёме, с атрибуцией и ссылкой; изображение — с правом использования или сгенерированное.
+7. **Не обходить академическую честность и «детекторы ИИ».** Задача — качество и человеческий голос,
+   а не маскировка; просьба выдать сгенерированное за живое — повод сказать прямо и предложить честный вариант.
+8. **Публичный текст = репутация заказчика.** Госсайт, больница, релиз: ошибка бьёт по доверию и бывает
+   юридически значимой. Сомнительное — на согласование.
+9. **Живой язык — не украшательство.** Красивость без смысла, метафоры вместо фактов, «энергичный» тон
+   в тексте про диагноз — такие же ошибки, как канцелярит.
+10. **Отчёт обязателен.** Что написано, для кого, откуда факты, что не проверено, риски. Без отчёта
+    работа не сдана.
+
+## 2. Жёсткие правила достоверности
+
+1. **Два источника для спорного.** Сенсация, обвинение, конфликт, «впервые в мире», «учёные доказали» —
+   два независимых подтверждения или первоисточник + комментарий специалиста.
+2. **Первоисточник важнее пересказа.** Пресс-релиз вуза ≠ статья; реферат новости ≠ исследование.
+   DOI/полный текст, а не заголовок агрегатора.
+3. **Цифра без контекста — манипуляция.** От чего процент, за какой период, на какой выборке, в каком
+   регионе. «Риск вырос вдвое» — от 1 на 100 000 до 2 на 100 000 тоже «вдвое».
+4. **Корреляция ≠ причинность.** «Люди, которые X, чаще Y» ≠ «X вызывает Y»; формулировка обязана это
+   отражать.
+5. **Цитата — только дословно.** Сокращать многоточием можно, менять слова — нельзя. Пересказ — без кавычек,
+   с атрибуцией «по словам…».
+6. **Анонимный источник — исключение:** нужна причина, проверка, согласование с редактором. «Источники
+   сообщают» без объяснений — не журналистика.
+7. **Заголовок не врёт.** В тексте «возможно» — в заголовке не «доказано». Кликбейт, не подтверждённый
+   текстом, — обман читателя и репутационный риск.
+8. **Даты и сроки.** «С 1 сентября» — какого года, по какому документу. «Недавно», «в ближайшее время» —
+   только если срок реально неизвестен.
+9. **Право и медицина — с оговоркой.** Ссылка на норму/источник и пометка «не является юридической/
+   медицинской консультацией», где уместно.
+10. **Проверка на выходе.** `assets/checklists/publish.md`: факты, имена, цифры, ссылки, права на фото,
+    согласования, дата и автор.
+
+## 3. Антипаттерны
+
+### AI-штампы
+
+«В современном мире», «в эпоху цифровизации», «важно отметить», «стоит подчеркнуть», «не только… но и»,
+«играет важную роль», «является неотъемлемой частью», «широкий спектр возможностей», «индивидуальный
+подход», «динамично развивающийся», «инновационные решения», «ключевой фактор успеха», «таким образом,
+можно сделать вывод», «в заключение хочется сказать», «данный», «осуществляется», «в рамках данного»,
+буллеты ради буллетов, симметричные абзацы «плюсы/минусы/вывод», тройные перечисления «быстро,
+качественно, надёжно», пустые обещания, вопросы-заглушки «А знаете ли вы, что…?», эмодзи вместо смысла,
+заголовки с двоеточием ради драматизма, «это не просто X, это Y». Полный список и замены — `anti-ai-style.md` §2.
+
+### Журналистские
+
+Непроверенная сенсация, заголовок-обманка, цитата «из головы», анонимка без причины, «источники сообщают»,
+пересказ пресс-релиза как расследование, отсутствие второй стороны конфликта, оценочные ярлыки без фактов,
+хронология вместо смысла, лид-вода «в последнее время всё чаще говорят», неподписанные фото, «мы поговорили
+с экспертом» без имени и должности.
+
+### Медицинские и гос
+
+Обещания излечения и «гарантированный результат», запугивание, «врачи скрывают», диагноз по интернету,
+дозировки без назначения врача, отзывы-выдумки, «до/после» без согласия, реклама медуслуг без предупреждения
+о противопоказаниях (ст. 24 ФЗ «О рекламе»), персональные данные пациентов, официальная публикация без
+согласования и даты.
+
+### SEO
+
+Ключевики ради плотности, одинаковые title на страницах, текст «для роботов», дубли страниц, каннибализация,
+ссылки «здесь/подробнее», статьи без автора и даты, свежие даты «на всякий случай». Полный SEO-гейт — `seo`.

package/skills/content-writing/references/sources.md

@@ -0,0 +1,49 @@
+> Часть навыка content-writing. ≈0.8k токенов. Читать, когда: нужен первоисточник по журналистским стандартам, медицинскому праву, доступности или лимитам площадок; проверка актуальности требований.
+
+# Стандарты, законы, площадки: первоисточники и дата проверки
+
+Проверено 04.11.2026. При использовании требований законов и платформ **перепроверяй актуальную редакцию**
+на дату публикации: нормы меняются, лимиты площадок обновляются.
+
+## Редакционные стандарты и фактчекинг
+
+- Reuters. Standards & Values — https://reutersagency.com/about/standards-values/
+- BBC Editorial Guidelines — https://www.bbc.co.uk/editorialguidelines/
+- Science Media Centre. 10 best practice guidelines for reporting science & health stories —
+  https://www.sciencemediacentre.org/publications/publications-for-journalists/
+- Poynter/IFCN. Code of Principles — https://ifcncodeofprinciples.poynter.org/
+- Retraction Watch — https://retractionwatch.com/
+
+## Право РФ
+
+- ФЗ от 13.03.2006 № 38-ФЗ «О рекламе», ст. 24 (мед. услуги) и ст. 18.1 (маркировка рекламы) —
+  https://www.consultant.ru/document/cons_doc_LAW_10338/
+- ФЗ от 21.11.2011 № 323-ФЗ «Об основах охраны здоровья граждан в РФ» (врачебная тайна, ст. 13;
+  информированное согласие, ст. 20) — https://www.consultant.ru/document/cons_doc_LAW_121895/
+- ФЗ от 27.07.2006 № 152-ФЗ «О персональных данных» — https://www.consultant.ru/document/cons_doc_LAW_61801/
+- Правила предоставления платных медицинских услуг (постановление Правительства РФ от 11.05.2023 № 1006);
+  приказ Минздрава России от 30.12.2014 № 956н — проверять актуальную редакцию.
+- Официальное опубликование правовых актов — publication.pravo.gov.ru
+
+## Медицина и наука
+
+- Клинические рекомендации Минздрава России — https://cr.minzdrav.gov.ru/
+- Государственный реестр лекарственных средств — https://grls.rosminzdrav.ru/
+- PubMed — https://pubmed.ncbi.nlm.nih.gov/ · Cochrane Library — https://www.cochranelibrary.com/
+- Росздравнадзор (реестр лицензий) — https://roszdravnadzor.gov.ru/
+- Росстат — https://rosstat.gov.ru/ · ЕМИСС — https://fedstat.ru/
+
+## Доступность и площадки
+
+- ГОСТ Р 52872-2019 (доступность интернет-ресурсов) —
+  https://protect.gost.ru/gost/details/2d10ff38-d609-4dcc-899f-c18b77ac0b75
+- Telegram Bot API (лимит 4096 знаков) — https://core.telegram.org/bots/api#sendmessage
+- Дзен. Помощь: требования к статье — https://dzen.ru/help/ru/channel/article.html
+- ВКонтакте, Одноклассники, Rutube, MAX — лимиты и форматы проверять в справке площадки на дату публикации.
+
+## Про детекторы ИИ
+
+- OpenAI. AI text classifier (снят с эксплуатации) —
+  https://openai.com/index/new-ai-classifier-for-indicating-ai-written-text/
+- Liang et al. GPT detectors are biased against non-native English writers // Patterns, 2023 —
+  https://doi.org/10.1016/j.patter.2023.100779

package/skills/context-economy/SKILL.md

@@ -0,0 +1,60 @@
+---
+name: context-economy
+description: "Экономия токенов и контекста: какие навыки и references грузить, как читать файлы и логи без перерасхода, когда сжимать сессию. Применять при длинных задачах, больших файлах, отладке и любых вопросах про расход токенов."
+whenToUse: "Когда задача длинная или многофайловая, когда контекст приближается к лимиту, когда нужно загрузить навык/справочник, или когда пользователь спрашивает про расход токенов."
+user-invocable: true
+---
+
+# Контекст-экономика — ядро
+
+> ≈1k токенов. Это ядро; приёмы и цифры — в `references/`.
+
+## 0. Когда применять
+- Длинная/многошаговая задача, работа с большими файлами и логами.
+- Контекст > 50–60% окна, приближается компакция.
+- Выбор, какой навык или reference загрузить.
+- Вопросы «почему так дорого», «сколько токенов», «как сократить расход».
+
+## 1. Правила загрузки навыков
+1. Сначала **ядро** навыка (`SKILL.md`). References — только когда без них нельзя принять решение.
+2. Не более **3 навыков** на задачу; если тянет больше — выбери 1–2 главных, остальные по мере надобности.
+3. Не грузи навык «на всякий случай» и не перезагружай уже загруженный.
+4. Каждый reference читай **целиком один раз**, а не по кускам; если файл > 40 КБ — сначала оглавление/заголовки.
+5. Если ядро и reference противоречат — побеждает более специфичный документ, но безопасность важнее.
+
+## 2. Чтение файлов и данных
+1. Сначала `grep`/`glob` — потом `read` только нужного диапазона (`offset`/`limit`).
+2. Не читай файл повторно, если он не менялся; держи в голове номера строк.
+3. Для больших логов/JSON — сначала структура (ключи, размеры), потом выборка.
+4. Не выводи в контекст целые деревья каталогов: `glob` по шаблону точнее.
+5. Перед чтением 100 КБ спроси: «какое решение это изменит?» Нет ответа — не читай.
+
+## 3. Экономия на инструментах
+1. Один точный вызов лучше трёх «на всякий случай».
+2. Долгие операции — в фон, результат забирай один раз.
+3. Для проверки — минимальный воспроизводимый тест, а не весь набор.
+4. Не дублируй результат инструмента в ответе целиком: цитируй 1–3 значимые строки.
+
+## 4. Сжатие и память
+1. При 60–70% окна: зафиксируй состояние в память проекта (решения, файлы, следующий шаг), затем сжимай.
+2. В памяти — ссылки на файлы и выводы, а не копии кода.
+3. После компакции первым делом перечитай свой план и список изменённых файлов, а не всю переписку.
+4. Не храни в контексте промежуточные версии текста — только финальные.
+
+## 5. Ответы
+1. Пиши плотно: решение, проверка, риск. Без пересказа задания.
+2. Длинные листинги — в файл/артефакт, в чат — сводка.
+3. Не повторяй один и тот же факт в плане, ходе и итоге.
+
+## 6. Куда грузить дальше
+| Нужно | Файл | ≈токенов |
+|---|---|---|
+| Цифры, лимиты, формулы оценки | `references/token-math.md` | ≈1k |
+| Приёмы для конкретных инструментов | `references/tool-recipes.md` | ≈1k |
+| Чек-лист длинной сессии | `references/long-session.md` | ≈0.8k |
+
+## 7. Гейт перед сдачей
+- [ ] Загружены только нужные навыки и references.
+- [ ] Нет повторных чтений неизменённых файлов.
+- [ ] Контекст не превышает 70% без плана сжатия.
+- [ ] Итог содержит решение и проверку, а не пересказ.

package/skills/context-economy/references/long-session.md

@@ -0,0 +1,35 @@
+# long-session — часть навыка context-economy
+
+≈0.8k токенов. Читать перед сжатием длинной сессии или при приближении к лимиту.
+
+## Порог
+- 60% окна — план сжатия.
+- 75% — сжимай на ближайшем безопасном шаге (после завершённого действия, не посреди правки).
+
+## Протокол сжатия
+1. Собери **handoff** (5–9 строк):
+   - цель и критерий готовности;
+   - что уже сделано (файлы/артефакты);
+   - что проверено и каким тестом;
+   - открытые вопросы и риски;
+   - следующий конкретный шаг.
+2. Запиши handoff в память проекта (journal) или в файл `HANDOFF.md`.
+3. Только потом запускай компакцию.
+4. После сжатия перечитай handoff и список изменённых файлов; не перечитывай переписку.
+
+## Что нельзя терять
+- Пути к ключевым файлам и команды запуска.
+- Результаты тестов/аудита (числа, а не «всё ок»).
+- Принятые решения и почему отвергнуты альтернативы.
+- Незакоммиченные изменения и бэкапы.
+
+## Признаки, что пора сжимать
+- Ответы становятся общими, теряются детали.
+- Приходится повторно читать те же файлы.
+- Контекст > 90k токенов, а задача ещё не закончена.
+- Появились длинные простыни логов в истории.
+
+## Дешёвая альтернатива сжатию
+- Закрыть завершённую подзадачу коротким итогом.
+- Удалить из истории промежуточные версии текста (оставить финал).
+- Перейти на узкую задачу: «сейчас только тест X».

package/skills/context-economy/references/token-math.md

@@ -0,0 +1,42 @@
+# token-math — часть навыка context-economy
+
+≈0.9k токенов. Читать, когда нужно оценить расход, сравнить варианты или посчитать бюджет.
+
+## Оценка без токенизатора
+| Материал | Символов на токен | Байт на токен |
+|---|---|---|
+| Русский текст | ≈2.2–2.8 | ≈4.4–5.6 (UTF-8, 2 байта/буква) |
+| Английский текст | ≈3.8–4.2 | ≈3.8–4.2 |
+| Код (JS/PHP/SQL) | ≈3.0–3.5 | ≈3.0–3.5 |
+| Markdown с таблицами | ≈2.5–3.0 | — |
+
+Практическое правило: **токены ≈ байты / 3.2** для смешанного русского markdown; это оценка сверху, погрешность 10–20%.
+
+Пример: SKILL.md 12 КБ → ≈3 800 токенов (12 000 / 3.2). Если такой файл грузится в каждой задаче — это ≈3.8k на задачу.
+
+## Бюджеты
+| Объект | Комфортно | Предел |
+|---|---|---|
+| Ядро навыка (`SKILL.md`) | 2–4k токенов | 6k |
+| Один reference | 1–4k | 8k |
+| Навыков на задачу | 1–3 | 5 |
+| Дайджест памяти проекта | 500–900 | 2 000 |
+| Ответ агента | 300–800 | 2 000 |
+
+## Контекстное окно
+- Типичное окно DeepSeek: **128 000** токенов; у части моделей — 64k.
+- Рабочий порог: 60% (≈77k) — начинай думать о сжатии; 75% (≈96k) — сжимай.
+- Запас нужен на ответ и инструменты: не заходи за 85%.
+- Стоимость запроса растёт линейно с контекстом: каждый лишний 1k в системном промпте умножается на число шагов.
+
+## Что реально экономит
+1. Компактные ядра навыков: −60–70% против полного текста.
+2. Загрузка references по требованию, а не сразу.
+3. Чтение диапазонов вместо файлов целиком.
+4. Один фон-джоб вместо серии синхронных вызовов.
+5. Компакция с записанным состоянием, а не «забыть и начать заново».
+
+## Чего не делать
+- Не считать «страницу = 500 токенов»: страница плотного текста — 800–1200.
+- Не экономить на проверке безопасности/данных — цена ошибки выше токенов.
+- Не резать references, которые меняют решение: это ложная экономия.

package/skills/context-economy/references/tool-recipes.md

@@ -0,0 +1,34 @@
+# tool-recipes — часть навыка context-economy
+
+≈1k токенов. Читать, когда нужны конкретные приёмы экономии в инструментах DSH.
+
+## Поиск и чтение
+```
+grep  pattern: "class Foo|function bar"  include: "*.php"     # сначала границы
+read  file_path  offset: 120  limit: 40                      # диапазон, не весь файл
+glob  pattern: "src/**/*.test.ts"                            # файлы, не каталоги
+```
+- 3–5 точных grep дешевле одного чтения 100-КБ файла.
+- После правки перечитывай только изменённый участок.
+- Если файл уже менялся в сессии — помни номера строк; повторное чтение только после внешней правки.
+
+## Команды и логи
+- Длинный вывод: `... | Select-Object -Last 80` или `2>&1 | Select-String "error"`.
+- Для сборки/тестов проси краткий формат (`--reporter=dot`, `--no-progress`).
+- Повторяющиеся проверки — в один скрипт, а не в пять команд.
+- Фоновые задачи: запусти, продолжай работу, забери результат один раз.
+
+## Веб
+- `web_search` — 1–4 запроса за вызов, не по одному.
+- Повторно не тяни тот же URL; сохрани нужные цитаты сразу.
+- `web_fetch` — только конкретная страница, не «весь сайт».
+
+## Плагины и конфиги
+- `cordis_inspect_query` точечно: один сервис/слот, а не весь каталог.
+- Не запрашивай типы, если хватает сигнатуры метода.
+- Перед правкой плагина проверь его `package.json` и точку входа.
+
+## Долгие сессии
+- Каждые 10–15 шагов фиксируй: что сделано, какие файлы изменены, следующий шаг.
+- Перед компакцией — короткий handoff в 5 строк.
+- После компакции не восстанавливай всю переписку: план + изменённые файлы + последний тест.

package/skills/database-safety/SKILL.md

@@ -1,31 +1,47 @@
 ---
 name: database-safety
-description: "Универсальная безопасность баз данных — бэкапы, запрещённые команды, миграции, проверка обновлений на копии, восстановление."
-whenToUse: "Перед любыми миграциями, сидами, массовыми изменениями, релизами с БД и при инцидентах с данными."
+description: "Безопасность БД: бэкап и проверка, запрет destructive без разрешения, аддитивные миграции, копия живой базы, восстановление."
+whenToUse: "Перед миграциями, сидами, массовыми UPDATE/DELETE, импортом, восстановлением и релизом с изменениями схемы или данных."
 user-invocable: true
 ---
 
-# Безопасность БД (универсально: PostgreSQL, MySQL, SQLite)
+# Безопасность БД
 
-## Золотые правила
+## 0. Когда применять
+- Миграции, сиды, импорт, массовые `UPDATE/DELETE`, восстановление, релиз со схемой/данными, инцидент.
+
+## 1. Главное
+
+**Железные правила:**
 - **Боевая БД неприкосновенна для экспериментов.** Тесты — отдельная БД на той же СУБД, что прод.
-- Перед изменениями — **бэкап** и проверка, что он читается.
-- Деструктивные команды — только с явного разрешения: `DROP/TRUNCATE`, `db:wipe`/`drop database`, `migrate:fresh/reset`, массовые `UPDATE/DELETE` без WHERE, пересоздание контейнера БД.
-- Миграции — **аддитивные** (add table/column/index), с `down()`; не редактировать старые миграции.
-- Изменения схемы на проде — только после проверки на копии; при риске — maintenance-режим.
-
-## Перед миграцией/релизом
-1. Сравнить наборы миграций старой и новой версии; прочитать новые (drop/rename/NOT NULL/типы).
-2. `migrate --pretend` (или SQL-дамп плана) на копии.
-3. Бэкап: `pg_dump -Fc` / `mysqldump --single-transaction` / копия SQLite-файла; файл — скачать себе.
-4. Прогнать обновление на копии живой БД: см. скилл `pg-upgrade-verify` (PostgreSQL) — принцип тот же для других СУБД.
-5. Только потом выкатывать; желательно — maintenance-режим.
-
-## Восстановление
-- Останавливать приложение перед восстановлением; `restore` в пустую БД; проверить целостность и ключевые счётчики.
-- После восстановления — прогон smoke-тестов и сверка данных.
-
-## Гигиена
-- Секреты БД — только в `.env`/секрет-хранилище, не в коде/гите/логах.
-- PII не выносить в тестовые данные/скриншоты; для тестов — фабрики/анонимизация.
-- Регулярность: ежедневный бэкап + проверка восстановлением + вторая копия вне сервера.
+- **Destructive — только с явным разрешением пользователя И проверенным бэкапом; без обоих запрещено:** `DROP/TRUNCATE`, `db:wipe`, `drop database`, `migrate:fresh/reset/refresh`, `migrate:rollback` без плана, массовые `UPDATE/DELETE` без WHERE, пересоздание контейнера БД.
+- Бэкап без проверки = бэкапа нет: `pg_restore --list`, `PRAGMA integrity_check` или тестовое восстановление.
+- Миграции аддитивные (таблица/колонка/индекс), с `down()`; применённые не редактировать; схема на проде — после копии, при риске — maintenance.
+- Многозаписные — в транзакции; гонки — `lockForUpdate()`; массовые — батчами; тяжёлые — `EXPLAIN`.
+- Инспекция прода — только read-only; не запускай прод-команды с dev-машины.
+
+**Бэкап (проверь восстановлением):**
+- PostgreSQL: `pg_dump -Fc -f backup_$(date +%F_%H%M).dump "$DATABASE_URL"` → `pg_restore --list backup.dump | head`.
+- MySQL: `mysqldump --single-transaction --routines --triggers db > backup.sql`.
+- SQLite: `sqlite3 app.db ".backup 'backup.db'"` → `PRAGMA integrity_check;`.
+- Копия вне сервера; `php artisan migrate:status`, `php artisan migrate --pretend` — до изменений.
+
+**Перед миграцией/релизом:**
+1. Сравни наборы миграций старой/новой версии, прочитай новые (drop/rename/NOT NULL/типы).
+2. `--pretend`/SQL-план + прогон на копии живой БД (`pg-upgrade-verify`).
+3. Бэкап и проверка.
+4. Выкатка (maintenance при риске) → smoke + сверка счётчиков.
+
+**Восстановление:** останови приложение; восстанавливай в пустую БД; проверь целостность, счётчики, smoke; живую не перезаписывай без разрешения, старый бэкап не удаляй до проверки.
+
+**Гигиена:** секреты — в `.env`/хранилище, не в коде/гите/логах; PII — не в тестовых данных/скриншотах (фабрики/анонимизация); ежедневный бэкап + проверка + копия вне сервера, минимум прав. Инцидент: стоп записи, снимок, не затирать бэкапы, зафиксировать, сообщить.
+
+## 2. Куда грузить дальше
+Смежные: `pg-upgrade-verify`, `service-desk-db-safety`, `release-and-deploy`.
+
+## 3. Гейт перед сдачей
+- [ ] На destructive — явное разрешение и проверенный бэкап.
+- [ ] Боевая не тронута; эксперименты на отдельной БД.
+- [ ] Миграции аддитивные, с `down()`, проверены на копии; `--pretend` прочитан.
+- [ ] План отката/восстановления проверен; maintenance при риске.
+- [ ] После — smoke, счётчики, чистые логи; секреты и PII не утекли.

package/skills/debugging-playbook/SKILL.md

@@ -1,39 +1,42 @@
 ---
 name: debugging-playbook
-description: "Систематическая отладка — воспроизведение, факты, изоляция, гипотезы, минимальный фикс и регрессионный тест."
-whenToUse: "Когда что-то не работает, падает тест, ошибка в логах или поведение не совпадает с ожидаемым."
+description: "Отладка бага: воспроизведение, факты и логи, изоляция, одна гипотеза, фикс в причине, регрессионный тест и проверка."
+whenToUse: "Когда что-то не работает: падает тест, ошибка в логах, поведение не совпадает с ожидаемым или баг только на проде."
 user-invocable: true
 ---
 
 # Плейбук отладки
 
-## 1. Зафиксировать симптом
-- Что ожидалось / что произошло; где (URL/экран/команда); как воспроизвести (шаги).
-- Собрать факты: полный текст ошибки, стектрейс, логи (`laravel.log`, journalctl), состояние БД, версия кода/конфига.
-- Проверить окружение: кэши (`config:clear`, `view:clear`), права, порты, переменные `.env`.
+## 0. Когда применять
+- Ошибка, красный тест, «не работает» без деталей; поведение ≠ ожидаемое.
+- Баг только на проде/у части пользователей; нужна причина, а не маскировка симптома.
 
-## 2. Сузить область
-- Воспроизвести минимально: один тест/один запрос/один сценарий.
-- Бинарный поиск: отключить middleware/события/кеши; сравнить «работает/не работает».
-- Проверить недавние изменения: `git log`, `git diff`, даты файлов, миграции.
-- Проверить данные: валидность строк, NULL, кодировки, FK, права.
+## 1. Главное
+1. **Симптом:** ожидалось / произошло; где (URL, экран, команда), шаги, частота, окружение, версия.
+2. **Факты, а не догадки:** полный текст ошибки и стек; логи (`storage/logs/laravel.log`, `journalctl -u <service> -n 200 --no-pager`, браузер); состояние БД; конфиг; недавние изменения (`git log --oneline -10`, `git diff`, `git status`).
+3. **Минимальное воспроизведение:** один тест/запрос/сценарий; убери лишнее; не воспроизводится — собери факты, не меняй код наугад.
+4. **Сузить область:** бинарный поиск (отключай middleware/события/кеш, комментируй блоки, `git bisect`); сравни «работает / не работает»; проверь кеши (`php artisan config:clear`, `route:clear`, `view:clear`, `cache:clear`), порты, данные (NULL, кодировки, FK), права, `.env`, версии.
+5. **Гипотеза → проверка:** одна за раз, «если …, то …»; подтверждай логом/дампом/тестом.
+6. **Фикс:** минимальный, в причине, а не в симптоме. Добавь **регрессионный тест**: без фикса красный, с фиксом зелёный.
+7. **Проверка:** исходный сценарий на реальных данных/экране; соседние сценарии; полный набор тестов.
+8. **Закрыть:** причина и фикс — в память/CHANGELOG; как предотвратить повтор (валидация, guard, тест, алерт).
 
-## 3. Гипотеза → проверка
-- Одна гипотеза за раз; формулировать «если …, то …».
-- Подтверждать фактом (лог/дамп/тест), а не догадкой.
-- Не менять код «наугад» — только после подтверждения причины.
+**Стоп-правила:**
+- Не отлаживай на боевой БД; только чтение или копия. Деструктивные эксперименты запрещены.
+- Не отключай auth/CSRF/права, чтобы «проверить»; не коммить `dd`/`var_dump`/временные логи; не удаляй улики.
+- Прод-баг: сравни конфиг, версию, данные и кеши с локалью; не воспроизводи на живых пользователях.
 
-## 4. Фикс
-- Минимальный, в причине, а не в симптоме.
-- Добавить **регрессионный тест**, который без фикса падает.
-- Проверить соседние сценарии (не сломал ли другое), прогнать полный набор.
+**Частые ловушки:**
+- «Помогло после очистки кеша» / «после перезапуска» — причина в кеше, состоянии или деплое.
+- Только на проде — конфиг/версия/данные/права.
+- Тест зелёный, баг есть — тест проверяет не то поведение.
 
-## 5. Закрыть
-- Убедиться, что исходный симптом исчез на реальных данных/экране.
-- Записать причину и фикс в память проекта/CHANGELOG.
-- Если проблема в данных/окружении — описать, как предотвратить повтор.
+## 2. Куда грузить дальше
+Смежные: `testing-strategy`, `code-review-checklist`.
 
-## Частые ловушки
-- «Помогло после очистки кеша» — значит проблема в кэше, а не в коде.
-- Ошибка воспроизводится только на проде — сравнить конфиг/версию/данные.
-- Тест зелёный, а баг есть — тест не проверяет нужное поведение.
+## 3. Гейт перед сдачей
+- [ ] Есть воспроизведение и подтверждённая причина (факт, не догадка).
+- [ ] Фикс в причине, минимальный; симптом исчез на реальном сценарии.
+- [ ] Регрессионный тест падает без фикса и проходит с ним; полный набор зелёный.
+- [ ] Соседние сценарии проверены; нет временного кода/логов/`dd`.
+- [ ] Причина, фикс и профилактика записаны в память/CHANGELOG.