personal-guide-start · v1.4.0 · 2026-10-24 · sha256 47f8f4c32aaa8998

personal-guide-start v1.4.0A

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

---
name: personal-guide-start
description: Подготавливает или проверяет приватный DS-personal-guide и отдельно проверяет доступность материалов. Не устанавливает скиллы в личный репозиторий и не обещает немедленную генерацию.
argument-hint: "[необязательно: override домена — knowledge-worker / generic]"
experimental: true
sunset: "после DONE WP-222 (Портной, ~июнь 2026) и WP-149 Ф6 (книга ЛР v3)"
related: [personal-guide-render, repo-new, WP-245, WP-222, WP-149, WP-527, PD.FORM.089, PD.CAT.003]
version: 1.4.0
layer: L1
status: active
browser_safe: false
triggers:
slash: [/personal-guide-start]
phrases: []
routing:
executor: sonnet
deterministic: false
agents: single
interaction: multi-step
gates_required: []
gates_enforced: []
gates_rationale: "операционный скилл; WP Gate применим только при создании нового РП, не для операционных вызовов"
---

# Запуск персонального руководства

## When to use

Пользователь просит создать персональное руководство или завершить прежнюю
настройку. Повторный запуск проверяет существующий репозиторий и материалы;
он не должен пересоздавать репозиторий или перезаписывать историю.

## Контракт

- **Вход:** запрос пользователя, подключённый GitHub, доступ к общим инструкциям
и разрешённое чтение личного источника. Создание требует авторизации `/repo-new`.
- **Выход:** отдельно подтверждены подключение приватного репозитория, доступность
материалов за период и состояние генерации. Создание репозитория не означает,
что руководство уже собрано.
- **Сохранность:** не изменять пользовательские `CLAUDE.md`, историю, планы и
шаблоны рефлексии. Не удалять ранее установленные скиллы.
- **Повтор:** одинаковые проверки после создания и подключения существующего
репозитория; отсутствие материалов не является поводом создать его заново.

## Algorithm

## Шаг 0. Загрузить общие инструкции и проверить возможности канала

Этот скилл и `/personal-guide-render` доставляются обычным обновлением IWE.
В MCP-клиенте общий текст можно получить через
`personal_load_skill(skill_name="personal-guide-start")` и
`personal_load_skill(skill_name="personal-guide-render")` (либо опубликованный
в этом клиенте общий псевдоним `knowledge_load_skill`). Это загрузка инструкции,
не автоматическое выполнение её шагов.

**Не копировать SKILL.md в `DS-personal-guide/.claude/skills/`.** Не использовать
`personal_write` или другой транспорт для обхода запрета dotfiles. `lesson`,
`lesson-close`, `connect-guide` не являются зависимостями настройки: не искать их
в авторской рабочей папке и не требовать их установки. Личный репозиторий хранит
материалы и историю, а общие инструкции имеют свой источник в шаблоне.

Полный путь создания пока имеет `browser_safe: false`: `/repo-new` требует
проверяемой авторизации и локальных средств учёта. Загрузка текста через MCP не
заменяет политику или файловый замок. Если эти средства недоступны, создание
остановить с конкретной причиной и предложить продолжить в локальном IWE.
Проверку уже подключённых материалов можно выполнить через доступный только
для чтения `/personal-guide-render`; не объявлять при этом полный запуск готовым.

## Шаг 1. Разрешить источник и подтвердить владельца

Вызови `github_status` в этом запуске. Не используй логин из памяти или локального
`gh auth status`: локальный GitHub-клиент может быть подключён к другому аккаунту.
Если подключение отсутствует — предложи `github_connect` и дождись авторизации.

Найди `DS-personal-guide` среди подключённых источников. При
`github_owner_mismatch: true` не читать и не писать через этот источник: требуется
переподключение к выбранному аккаунту. Отсутствие источника в списке не доказывает
отсутствие репозитория на GitHub. Для уже существующего, но неподключённого репо
используй подключение GitHub, а не создание нового.

Для изменения или подтверждения готовности нужны факты из актуальных метаданных
GitHub: полный owner/name совпадает с выбранным пользователем аккаунтом и
`private: true`. Один `github_owner_mismatch: false` не доказывает приватность;
`github_status` может вообще не возвращать поле private. Нет способа проверить
метаданные — сообщи «приватность не подтверждена», не выполняй запись и не
объявляй настройку завершённой. Публичный или чужой репозиторий автоматически
не мигрировать и не менять его видимость.

### Если репозиторий нужно создать

Выполни Plan → Decision Gate → Execute по `/repo-new` с параметрами:

- `repo_class: personal-subscriber`, name `DS-personal-guide`, `template_type: notes`;
- privacy `private`, owner — выбранный пользователем аккаунт, сверенный с живым
`github_status`; description «Персональное руководство пилота программы МИМ»;
- данные — личные материалы; владелец и писатель правок — пользователь;
серверный генератор публикует руководство только в пределах разрешённого доступа;
- учёт личного источника — через GitHub/MCP, без реестра репозиториев экосистемы.

Для автоматического создания по `personal-subscriber-onboarding-v1` выполнить
все проверки политики и учёт под замком из Step 5 `/repo-new`. Отсутствующая или
истёкшая политика не даёт разрешения: не переключаться на иной вид авторизации
молча. Явный разовый проход возможен только по новому решению пользователя.
Серверные проверки согласия, выбранного аккаунта и прав доступа не обходить.

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

Ссылка OAuth ещё не подтверждает создание. После завершения авторизации повтори
проверку источника и метаданных. При 409 существующий репозиторий можно использовать
только после проверки owner/private и назначения по README/структуре. Отсутствие
`inbox/` после прежней настройки руководства само по себе не повод пересоздавать
репозиторий. Новый и существующий репозитории далее проходят одни и те же шаги.

## Шаг 2. Проверить доступность репозитория

Прочитай `README.md` через
`personal_get_document(source="DS-personal-guide", filename="README.md", include_sha=true)`.
Это чтение актуальной версии из GitHub; при больших ответах соблюдай пагинацию.
Поиск можно использовать для обнаружения пути, но пустой индекс не доказывает
отсутствие файла. Ошибку доступа, задержку индекса и подтверждённое отсутствие
сообщать различно. Не заменять README и не создавать персональные данные для
маскировки неудачного чтения.

Наличие README подтверждает доступ к репозиторию, а не полноту руководства.
`bootstrap_completed` — записанная отметка, а не проверка файлов; не менять её
на основании одного README, ответа скилла или загрузки общих инструкций.
Необязательные памятки и шаблоны рефлексии не являются условием этого шага.

## Шаг 3. Проверить материалы через `/personal-guide-render`

Загрузи актуальную общую инструкцию и выполни её проверку за выбранную дату.
В локальном клиенте используй доступный механизм запуска скилла; без него
прочитай поставленный `SKILL.md` и следуй существующим шагам. Не ссылаться на
устаревшие «Шаги 1–7» и не вызывать отсутствующий `render_personal_guide`.

Этот шаг проверяет материалы, а не гарантирует запуск генератора. Не создавать
вместо него шесть файлов вручную, не придумывать профиль или оценки пользователя.
Если материалов нет, определить доступные сведения о существующей генерации:
подтверждённое задание / подтверждённая ошибка / запуск не подтверждён. Отсутствие
доступа к очереди не означает, что задание существует или что генерация сломана.

## Шаг 4. Сообщить проверенный результат

Назови отдельно:

1. Репозиторий: подключён и приватность подтверждена / что не подтверждено.
2. Материалы: какие конкретные файлы за период доступны / отсутствуют /
не удалось проверить — по результату `/personal-guide-render`.
3. Генерация: запуск подтверждён / ошибка подтверждена / запуск не подтверждён.

«Настройка репозитория выполнена» допустимо после проверки источника, владельца,
приватности и чтения README. «Руководство доступно» — только после проверки
материала за выбранный период **и** табло. Найденные файлы не означают, что они
сгенерированы этим вызовом. При отсутствии материалов полная пользовательская
приёмка остаётся открытой; сообщи конкретный следующий шаг диагностики или
обращения в поддержку, без обещания «появится утром».

Если пользователь хочет работать локально и существование репозитория
подтверждено, предложи клонировать его по проверенному URL в свой IWE.
Создание через OAuth само по себе не создаёт локальную копию.

## Verification

Проверь новый, существующий пустой и существующий кастомизированный репозиторий;
отказ для чужого/публичного источника; задержку индекса; повторный запуск.
Ни в одном сценарии не должно быть установки скиллов в dotfiles, удаления
пользовательских файлов или ложного сообщения о готовых материалах.