C4 Context Level: System Context
Создание документации архитектуры системы C4 System Context
Команды разработки ПО сталкиваются с трудностями при создании понятной архитектуры документации, ориентированной на стейкхолдеров, которая описывает границы системы и внешние зависимости. Этот навык генерирует комплексную документацию уровня C4 Context, включая персоны, пользовательские сценарии, функции системы и диаграммы Mermaid.
Скачать ZIP навыка
Загрузить в Claude
Перейдите в Settings → Capabilities → Skills → Upload skill
Включите и начните использовать
Протестировать
Использование «C4 Context Level: System Context». Создайте документацию C4 Context для платформы электронной коммерции
Ожидаемый результат:
Документация контекста системы включает: персону Клиента, просматривающего товары и совершающего покупки, персону Администратора, управляющего инвентарем и заказами, внешнюю систему Платежного шлюза для обработки транзакций, Систему управления инвентарем для отслеживания запасов и Почтовый сервис для уведомлений. Диаграмма Mermaid показывает границу системы со всеми взаимодействиями пользователей и подключениями к внешним API с четкими метками.
Использование «C4 Context Level: System Context». Документируйте пользовательские сценарии для портала пациента в здравоохранении
Ожидаемый результат:
Сценарий пациента: Вход по учетным данным, просмотр расписания приемов, запрос нового приема, получение подтверждения. Сценарий врача: Доступ к медицинским записям пациентов, обновление истории болезни, назначение лекарств, подача страховых требований. Каждый сценарий включает точки принятия решений, критерии успеха и пути восстановления после ошибок.
Аудит безопасности
БезопасноStatic analysis scanned 0 files with 0 lines of executable code. This is a prompt-only documentation skill containing templates and instructions for creating C4 system context diagrams. No security risks detected: no executable code, network calls, filesystem operations, or external command execution. Safe for publication.
Оценка качества
Что вы можете построить
Документация новой системы
Создание комплексной документации C4 Context для новой системы для передачи стейкхолдерам и командам разработки.
Анализ устаревшей системы
Генерация документации контекста системы для существующей кодовой базы для улучшения понимания командой и адаптации новых сотрудников.
Коммуникация со стейкхолдерами
Создание понятной для стейкхолдеров документации архитектуры для нетехнической аудитории, включая бизнес-руководителей.
Попробуйте эти промпты
Создайте документацию уровня C4 Context для [тип системы], которая [основное назначение]. Включите основные персоны пользователей и перечислите топ-3 внешних системных зависимостей.
Сгенерируйте комплексную документацию C4 Context, включая: краткое и развернутое описание системы, все персоны (человеческие и программные), полный список функций, карты пользовательских сценариев для каждой ключевой функции, зависимости внешних систем и диаграмму Mermaid C4Context.
Для [название системы] с [количество] ключевыми функциями создайте детальные карты пользовательских сценариев для каждой персоны. Покажите пошагово, как каждая персона взаимодействует с системой для достижения своих целей. Включите пути обработки ошибок.
Проанализируйте внешние зависимости этой системы и создайте комплексную документацию. Для каждой внешней системы документируйте: тип (база данных/API/сервис), метод интеграции, направление потока данных, требования к аутентификации и влияние на сбой. Сгенерируйте диаграмму Mermaid, показывающую все внешние взаимодействия.
Лучшие практики
- Фокусируйтесь на людях и программных системах, а не на технологиях и протоколах в диаграммах Context
- Включайте как человеческих, так и программных пользователей в документацию персон для полного представления системы
- Сохраняйте диаграммы C4 Context понятными для стейкхолдеров, избегая технических деталей реализации
Избегать
- Отображение технологий, протоколов или деталей инфраструктуры в диаграммах уровня Context
- Исключение программных пользователей и внешних систем, взаимодействующих с системой
- Смешивание уровней C4 путем включения деталей компонентов или контейнеров в документацию Context