personal-guide-render v2.1.0A

Immutable. This exact content never changes and is served at /api/v1/blob/c142ad023dbffdf6.

---
name: personal-guide-render
description: Персональное руководство пилота собирается автоматически на сервере платформы по расписанию. Используй когда пилот просит «пересобери руководство», «обнови мой план», «собери руководство на сегодня» — скилл объясняет текущее состояние и проверяет, что руководство доехало.
argument-hint: "[необязательно: дата в формате YYYY-MM-DD, по умолчанию сегодня]"
experimental: true
related: [WP-149, personal-guide-start, DP.SC.187]
version: 2.1.0
layer: L1
status: awaiting-server-tool
browser_safe: true
supersedes: "v2.0.0 (вызов mcp render_personal_guide — инструмент не опубликован на сервере платформы, см. «Текущее состояние»)"
triggers:
  slash: [/personal-guide-render]
  phrases: []
routing:
  executor: sonnet
  deterministic: false
agents: single
interaction: single-step
gates_required: []
gates_enforced: []
gates_rationale: "операционный скилл; WP Gate применим только при создании нового РП, не для операционных вызовов"
---

# Персональное руководство: как оно собирается

## Текущее состояние (2026-07-29)

Сборка руководства — облачная возможность платформы: она читает данные пилота из баз платформы, обращается к LLM по ключу платформы и публикует результат в GitHub-репозиторий руководства. Всё это происходит **на сервере платформы автоматически по расписанию** — каждое утро появляется новый урок, по понедельникам пересобирается полный комплект.

Ручной пересбор из чата («пересобери сейчас») пока недоступен: серверный MCP-инструмент для этого ещё не опубликован. Когда он выйдет, этот скилл начнёт вызывать его напрямую — следите за обновлениями шаблона.

## When to use

Пилот просит «пересобери руководство», «обнови мой план», «собери руководство на сегодня» — либо спрашивает, почему руководства за сегодня нет.

## Algorithm

## Шаг 0. Проверить предусловие (setup завершён)

Вызови `personal_search(source: "DS-personal-guide", path: "README.md")`.

> #503: раньше здесь проверялся платформенный путь `.claude/skills/...` —
> он живёт в шаблоне (слой L1) и в пользовательский репозиторий DS-personal-guide
> не копируется никогда, проверка гарантированно возвращала пусто и блокировала
> все следующие шаги. Реальный признак завершённого bootstrap — README.md:
> его создаёт сам bootstrap при создании репозитория (notes-структура
> Gateway: inbox/, docs/, README.md), т.е. он существует ДО первого рендера.

Если файл **не найден** → сообщить пилоту:
```
Скиллы не установлены или установка не завершена.
Запусти /personal-guide-start для первичной настройки.
```
Стоп (не переходить к Шагу 1).

## Шаг 1. Определить дату

`date` = аргумент скилла если передан (формат YYYY-MM-DD), иначе сегодня.

Определи ISO-неделю выбранной даты в формате `YYYY-Www`, используя год ISO-недели (он может отличаться от календарного года около Нового года).

## Шаг 2. Проверить, доехало ли руководство

Проверь в репо `DS-personal-guide` пилота наличие `guide/<ISO-неделя>.md` (недельный материал), `guide/<date>.md` (дневной материал) и `panel/<date>.md` (табло). Первые два пути — кандидаты для разных режимов: не требуй наличия обоих и не определяй режим только по дню недели.

Если доступен `guide.json`, сверяй явно указанные пути в `sections.weekly` и `days` с выбранным периодом. Подтверждай режим только при явной ссылке на соответствующий материал; иначе укажи, что режим не подтверждён. Оглавление не является маркером полноты: не требуй несуществующих полей `mode`, `complete` или ссылки на табло.

**Сообщи результат отдельно для каждого проверенного пути:**
```
Проверены файлы за <date>:
<путь учебного материала> — найден / отсутствует.
panel/<date>.md — найден / отсутствует.
Режим: недельный / дневной (подтверждён оглавлением) / не подтверждён.
```

Наличие файлов подтверждает их доступность, но не новый успешный запуск генератора или актуальность содержимого. Не объявляй комплект полным по одному файлу или одному оглавлению.

**Если для выбранного периода не найден ни один учебный материал или отсутствует табло:**
```
Руководство собирается на сервере платформы автоматически (утром по расписанию).
Ручной пересбор из чата пока недоступен — серверный инструмент в разработке.
Если руководства нет к середине дня — сообщи в поддержку платформы.
```

<!-- USER-SPACE -->
<!-- /USER-SPACE -->