dsh-desktop-kit 2.0.1 → 2.1.0

package/skills/project-deep-dive/SKILL.md

@@ -9,21 +9,22 @@ user-invocable: true
 > ≈1 600 токенов. Понимание проекта → локальное досье; детали — по ссылкам.
 
 ## 0. Контракт
-1. `project_memory(action="status")` — первым, до чтения проекта.
-2. Только локально: код, конфиги, пути, серверы, БД и логи не уходят в `web_fetch`/`web_search`/внешние API.
-3. Секреты и PII (пароли, токены, ключи, DSN, e-mail, телефоны, ФИО, адреса) не пишем; можно «секрет в `.env`, `DB_PASSWORD`».
-4. Секции — только `update_section`; досье и `INDEX.json` руками не правь.
-5. Финал: записанные секции + проверенные факты + «неясно»; без последнего отчёт неполон.
+1. `project_memory(action="status")` и `action="brief"` — первыми, до чтения проекта; `brief` — карточка стека/команд/путей на один экран.
+2. Проект и автоскан уже сделаны плагином: не сканируй заново без нужды; блоки `AUTO-SCAN` в секциях правит только сканер.
+3. Только локально: код, конфиги, пути, серверы, БД и логи не уходят в `web_fetch`/`web_search`/внешние API.
+4. Секреты и PII (пароли, токены, ключи, DSN, e-mail, телефоны, ФИО, адреса) не пишем; можно «секрет в `.env`, `DB_PASSWORD`».
+5. Секции — только `update_section`; досье и `INDEX.json` руками не правь.
+6. Финал: записанные секции + проверенные факты + «неясно»; без последнего отчёт неполон.
 
 ## 1. Когда и API
 - «Глубоко проанализируй/запомни», «составь досье», `/remember` (`PROJECT`, `ARCHITECTURE`, `CODE-MAP`, `RUNBOOK`); перед крупной работой в незнакомом проекте.
 - Устарело: `lastAnalyzedAt` >~30 дней, `git.head` ≠ HEAD, другая ветка. Не нужно при актуальном досье и точечном вопросе.
-- API: `project_memory(...)`; `status` → `register(name, root, stack?)` → `read`/`search` → `update_section`/`append_journal`; `file` — секция досье, `mode` — replace/append, `maxChars` 500–30000 (12000), `project` — текущий по умолчанию.
+- API: `project_memory(...)`; `status`/`brief` → `read`/`search` → `update_section`/`append_journal`; `scan` — обновить локальный автоскан; `file` — секция, `mode` — replace/append, `maxChars` 500–30000 (12000), `project` — текущий по умолчанию. Пользовательские команды: `/memory brief|scan|on|off|projects`.
 
 ## 2. Алгоритм
-1. **Статус.** `status`; нет проекта — `register`; неясно — спроси, не угадывай; устарело — предупреди, старое помечай `[устарело]`.
-2. **Известное.** `read` (6000–8000), не дублируй; конфликт — перепроверь код: победитель в досье, проигравший `[устарело]`.
-3. **Разведка.** Только чтение: `AGENTS.md` → `README*` → манифесты → структура → git; изменяющих команд нет.
+1. **Статус.** `status` + `brief`; проекта нет — зарегистрируй или открой папку (авто-регистрация), неясно — спроси, не угадывай; устарело — предупреди, старое помечай `[устарело]`.
+2. **Известное.** Автоскан уже дал стек/команды/точки входа; `read` (6000–8000) только нужных секций, не дублируй; конфликт — перепроверь код: победитель в досье, проигравший `[устарело]`.
+3. **Разведка.** Только чтение: `AGENTS.md` → `README*` → манифесты → структура → git; изменяющих команд нет. Если `scan` устарел — `project_memory action=scan`.
 4. **Потоки.** Вход → маршрут → обработчик → домен → данные → тесты; фиксируй только объясняющее запуск, логику, данные и хрупкие места.
 5. **Секции.** `PROJECT` → `ARCHITECTURE` → `CODE-MAP` → `INVARIANTS` → `GOTCHAS` → `RUNBOOK`; каждая отдельным `update_section` + `read`. Минимумы: 8–15 строк / 15+ / 10+ записей / 5+ / 3+ / 5+ команд; малый проект — пропорционально.
 6. **Теги.** `[проверено]` — источник + `path:line`; `[выведено]` — логический вывод; `[устарело]` — было верно раньше. Без кода, логов и дампов.
@@ -38,8 +39,8 @@ user-invocable: true
 | Полный API, детали шагов, антипаттерны | `references/tool-and-process.md` | ≈2 950 |
 
 ## 4. Гейт перед сдачей
-- [ ] `status` первым, slug определён; секции прочитаны, дублей нет.
-- [ ] Каждая секция — `update_section` + `read`; минимумы и ≤ 40 KB.
+- [ ] `status` + `brief` первыми, slug определён; автоскан свежий (или `scan` выполнен); секции прочитаны, дублей нет.
+- [ ] Блоки `AUTO-SCAN` не правились руками; каждая секция — `update_section` + `read`; минимумы и ≤ 40 KB.
 - [ ] Нет секретов/PII (перечитано), кода, логов и дампов.
 - [ ] Теги и `path:line`; противоречия разобраны, старое помечено.
 - [ ] JOURNAL дописан; отчёт: «Записано» и «Неясно»; в сеть ничего.

package/skills/project-memory-maintenance/SKILL.md

@@ -8,18 +8,18 @@ user-invocable: true
 # Project-memory-maintenance
 
 ## 0. Контракт
-1. Журнал — после значимой сессии, до ответа.
-2. В секции — долговечное; ход работы — в журнал.
-3. Перед записью `search`; дубликат — в существующий.
+1. Перед работой — `brief` (карточка стека/команд) и `status`; перед записью — `search`.
+2. Журнал — после значимой сессии, до ответа; рутинные шаги плагин пишет сам.
+3. В секции — долговечное; ход работы — в журнал. Блоки `AUTO-SCAN` правит только сканер: не редактируй их вручную, дополняй текст вне маркеров.
 4. Секреты, PII, код, дампы — не в досье, журнале, `INDEX.json`.
-5. Только `project_memory`; файлы не правь.
+5. Только `project_memory`; файлы не правь. Пользовательские команды: `/memory brief|scan|on|off|projects`.
 
 ## 1. Что значимо и API
 - Значимо: код/схема, решение, исправленный баг с проверкой, инвариант/ловушка, деплой, deep-dive; тривиальное — нет (сомневаешься — короткая запись).
-- API: `project_memory(...)`; `file` — секция, `mode` — replace/append, `maxChars` 500–30000.
+- API: `project_memory(...)`; `brief` — карточка, `status` — свежесть, `scan` — локальный автоскан, `file` — секция, `mode` — replace/append, `maxChars` 500–30000.
 
 ## 2. Конец сессии
-1. `status` — проект/свежесть.
+1. `status` — проект, свежесть и цена дайджеста; `brief` — если нужен контекст.
 2. `search` 1–3 темы с синонимами (`maxChars=4000`).
 3. `append_journal` в `JOURNAL/YYYY-MM.md`; связанные шаги — одна запись.
 4. `update_section` — только долговечное, одна секция — один вызов.
@@ -37,9 +37,9 @@ user-invocable: true
 1–3 термина (модуль, команда, ошибка, синонимы); `search` каждый; найдено — `read` + дополни, нет — добавь; после — `read`: дубля, секрета, мёртвой ссылки нет.
 Секция ≤ 40 KB; пункт 1–3 строки; детали — `docs`/README, в секции `path:line`. Раздуто — вынеси, оставь ссылки; журнал по месяцам, повторяющиеся выводы — в секции.
 
-## 6. Свежесть и INDEX.json
-`INDEX.json` — машинный, руками нельзя. `lastAnalyzedAt` — только полный анализ; `git.branch`/`head` — на чём; `confidence` — высокая/средняя/низкая по `[проверено]`/смеси/`[устарело]`.
-`status` в начале; branch/HEAD разошлись — устарело: перечитай, обнови, старое помечай. Полный анализ — коммит в отчёт; частичная правка не выглядит полной. `confidence` — по тегам. Расхождение `status` — в отчёт, файл не правь.
+## 6. Свежесть, автоскан и INDEX.json
+`INDEX.json` — машинный, руками нельзя. `lastAnalyzedAt` — только полный анализ; `lastScanAt` — локальный автоскан; `git.branch`/`head` — на чём; `confidence` — высокая/средняя/низкая по `[проверено]`/смеси/`[устарело]`.
+`status` в начале; branch/HEAD разошлись или `scan` устарел (>24 ч) — `scan`, затем перечитай и обнови досье; старое помечай. Полный анализ — коммит в отчёт; частичная правка не выглядит полной. Расхождение `status` — в отчёт, файл не правь.
 
 ## 7. Куда грузить дальше
 | Нужно | Файл | ≈токенов |
@@ -49,7 +49,7 @@ user-invocable: true
 | Правила секций | `references/section-rules.md` | ≈1 750 |
 
 ## 8. Гейт перед сдачей
-- [ ] `status`; проект; `search` до записи, дублей нет.
-- [ ] JOURNAL дописан (5 пунктов); досье обновлено; `git.head` сверен; старое помечено.
+- [ ] `status`/`brief`; проект; автоскан свежий; `search` до записи, дублей нет.
+- [ ] JOURNAL дописан (5 пунктов); досье обновлено; блоки `AUTO-SCAN` не тронуты; `git.head` сверен; старое помечено.
 - [ ] Нет секретов/PII/кода; теги/`path:line`; ≤ 40 KB.
 - [ ] В отчёт — что записано.