v2.0.0 to v2.1.0

19 added, 32 removed. Audit A to A.

---

name: personal-guide-render

- description: Тонкий клиент — собирает персональное руководство пилота через облачный сервер (mcp__aisystant__render_personal_guide). Используй когда пилот просит «пересобери руководство», «обнови мой план», «собери руководство на сегодня».

+ description: Персональное руководство пилота собирается автоматически на сервере платформы по расписанию. Используй когда пилот просит «пересобери руководство», «обнови мой план», «собери руководство на сегодня» — скилл объясняет текущее состояние и проверяет, что руководство доехало.

argument-hint: "[необязательно: дата в формате YYYY-MM-DD, по умолчанию сегодня]"

- experimental: false

+ experimental: true

related: [WP-149, personal-guide-start, DP.SC.187]

- version: 2.0.0

+ version: 2.1.0

layer: L1

- status: active

- supersedes: "v1.0.0 (personal-guide-render-v1-archive.md в inbox/WP-149/)"

+ status: awaiting-server-tool

+ supersedes: "v2.0.0 (вызов mcp render_personal_guide — инструмент не опубликован на сервере платформы, см. «Текущее состояние»)"

triggers:

slash: [/personal-guide-render]

phrases: []

routing:

executor: sonnet

deterministic: true

agents: single

interaction: single-step

gates_required: []

gates_enforced: []

gates_rationale: "операционный скилл; WP Gate применим только при создании нового РП, не для операционных вызовов"

---

- # Render персонального руководства (v2 — тонкий клиент)

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

- > ⚡ **Три шага, без диалога.** Выполни 0→1→2→3 последовательно. Вся логика сборки — на сервере (render-pilot-guides.py, вызывается через облачный MCP-сервер aisystant).

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

- ## When to use

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

- Тонкий клиент — собирает персональное руководство пилота через облачный сервер (`mcp__aisystant__render_personal_guide`). Используй когда пилот просит «пересобери руководство», «обнови мой план», «собери руководство на сегодня».

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

- ## Контракт скилла

+ ## When to use

- - **Вход:** дата (аргумент или сегодня). Репо `personal-guide` под аккаунтом пилота должно существовать (создаётся через `/personal-guide-start`).

- - **Выход:** файлы `guide/<date>.md` и `panel/<date>.md` обновлены в репо `personal-guide`.

- - **Время:** ≤3 мин (включая LLM-генерацию на сервере).

- - **Не делает:** не читает Память.Derived, не выбирает заготовки, не пишет profile.md/worldview.md/methods.md — всё это делает render-pilot-guides.py на сервере.

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

## Algorithm

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

Вызови `personal_search(source: "personal-guide", path: ".claude/skills/personal-guide-start/SKILL.md")`.

Если файл **не найден** → сообщить пилоту:

```

Скиллы не установлены или установка не завершена.

Запусти /personal-guide-start для первичной настройки.

```

Стоп (не переходить к Шагу 1).

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

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

- ## Шаг 2. Запустить сборку

- Вызови `mcp__aisystant__render_personal_guide(date=<date>)`.

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

- ## Шаг 3. Отчёт пилоту

+ Проверь в репо `personal-guide` пилота наличие файлов `guide/<date>.md` (по понедельникам) или `lesson/<date>.md` (в остальные дни) и `panel/<date>.md`.

- **Если OK:**

+ **Если файлы есть:**

```

- Руководство готово.

+ Руководство за <date> уже собрано автоматически.

guide/<date>.md — учебный текст (содержание)

panel/<date>.md — табло (форма, статистика, повестка)

```

- **Если ошибка:**

+ **Если файлов нет:**

```

- Сборщик вернул ошибку: <текст ошибки>

- Повтори попытку. Если ошибка повторяется — обратись в поддержку платформы.

+ Руководство собирается на сервере платформы автоматически (утром по расписанию).

+ Ручной пересбор из чата пока недоступен — серверный инструмент в разработке.

+ Если руководства нет к середине дня — сообщи в поддержку платформы.

```

- ## Failure modes

- | Симптом | Причина | Решение |

- |---------|---------|---------|

- | Шаг 0: файл не найден | /personal-guide-start не запускался | Запустить /personal-guide-start |

- | render_not_configured | PILOT_GITHUB_OWNER не задан на сервере | Проверить настройку через /personal-guide-start |

- | Таймаут >3 мин | LLM не отвечает на сервере | Повторить попытку позже |

- | guide/<date>.md не появился | Ошибка git push на сервере | Повторить попытку; при повторении — в поддержку платформы |