Страница помогает выбрать практическое руководство. Это каталог документации, а не обещание, что каждому руководству соответствует отдельный идентификатор runtime dispatcher. Откройте выбранную статью и используйте только те команды и поверхности, которые в ней сверены с текущими исходниками.
Как пользоваться каталогом
- Начните с задачи, которую нужно решить.
- Выберите одно основное руководство; добавляйте второе только при реальном пересечении областей.
- До изменений проверьте проект, ревизию исходников и read-only-диагностику.
- Считайте находки доказательствами для проверки, а не автоматическим продуктовым решением.
- Для изменений сохраняйте тесты, согласование, rollback и delivery-доказательства вашего процесса.
Изучить кодовую базу
| Задача | Руководство | Ожидаемый результат |
|---|---|---|
| Зафиксировать контекст проекта и найти первые точки входа | 01 — Онбординг | Ограниченная карта нужных модулей и символов |
| Создать или проверить документацию по исходникам | 03 — Документация | Документ с разрешимыми ссылками на код |
| Проверить границы модулей и зависимости | 11 — Архитектура | Архитектурная находка с явной областью влияния |
| Проследить поведение между зарегистрированными репозиториями | 10 — Кросс-репозиторный анализ | Пути с идентичностью репозитория и незакрытые пробелы границ |
| Найти доступные интерфейсы и поверхность атаки | 16 — Точки входа | Проверенный перечень внешних точек входа |
| Найти повторяющийся структурный шаблон | Поиск шаблонов | Результаты поиска, отделённые от изменения кода |
Безопасность и compliance
| Задача | Руководство | Ожидаемый результат |
|---|---|---|
| Проверить security-находки без исправлений | 02 — Аудит безопасности | Находки с расположением и контекстом severity |
| Выполнить явно согласованный autofix | 02 — Autofix аудита безопасности | Preview, граница согласования, patch и проверка |
| Провести инженерную compliance-проверку | 08 — Compliance | Пробелы доказательств и квалифицированная оценка |
| Исследовать security incident | 14 — Реагирование на инцидент | Область, затронутые пути, containment и follow-up |
Изменение и review
| Задача | Руководство | Ожидаемый результат |
|---|---|---|
| Выбрать безопасное место для функции | 04 — Разработка функции | Кандидат размещения и затронутые контракты |
| Изменить структуру без намеренного изменения поведения | 05 — Рефакторинг | Влияние до и после, тесты и решение оставить либо откатить |
| Проверить ограниченный срез изменений | 09 — Code review | Находки, связанные с точным diff и базовой ревизией |
| Спланировать массовую миграцию API или символов | 13 — Массовый рефакторинг | Явный набор совпадений, preview и rollback |
| Объединить проверки качества, безопасности и производительности | 18 — Оптимизация кода | Раздельные результаты направлений вместо непрозрачного балла |
| Сверить изменение с правилами кодирования | 19 — Проверка стандартов | Находки по конкретным правилам и их проверка |
| Составить процесс из поддерживаемых сценариев | Составные процессы | Трассируемые входы и результаты каждого компонента |
Диагностика и качество
| Задача | Руководство | Ожидаемый результат |
|---|---|---|
| Исследовать проблему производительности | 06 — Производительность | Измеряемая гипотеза о hotspot и план проверки |
| Найти пробелы тестового покрытия | 07 — Тестовое покрытие | Доказательства непокрытых путей и цели для тестов |
| Выделить технический долг | 12 — Технический долг | Приоритизированные элементы с привязкой к коду |
| Проследить наблюдаемую ошибку | 15 — Отладка | Воспроизведение, предполагаемый путь и проверенная причина |
| Проверить структуру и риски зависимостей | 20 — Зависимости | Прямые и транзитивные связи и следующий шаг |
Граница публикации
Прежний сценарий редактирования файлов снят с публикации: операции apply и undo исключены из поддерживаемого пользовательского контракта. Для изменения используйте руководство конкретной области, где есть preview, авторизация, тесты и rollback.
Результат сценария формирует часть evidence. Продуктовая приёмка включает требования, выполненные тесты, ответственный review, security-доказательства и принятый delivery-процесс.