AIKraft/AI/Войти
AIKraft/Skills/trailmark-review-gate

trailmark-review-gate

Выполняет структурный обзор через Trailmark-review-gate для выявления новых точек входа, уязвимых путей и роста радиуса поражения. Применяется при ревью PR, веток или коммитов для проверки безопасности до слияния.

TOBTrail of Bits official Разработка ★ 7.4k

Что делает навык

Skill применяет детерминированные правила безопасности к структурным изменениям кода (diff evidence) для выявления новых точек входа, уязвимых путей и роста радиуса поражения. Он не заменяет построчный ревью, а формирует компактный структурный пакет с графическими доказательствами, который ревьюеры используют для проверки безопасности до слияния.

Когда применять

  • Ревью веток, pull request'ов, релизных диффов или коммитов с исправлениями.
  • Проверка того, не расширяет ли изменение поверхность атаки (attack surface).
  • Поиск удалённой валидации или авторизации на достижимых путях.
  • Сравнение сигналов taint, границ привилегий, радиуса поражения (blast-radius) или сложности до и после изменений.
  • Создание графических доказательств для дифференциального ревью.

Как работает

  1. Шаг 1: Разрешить входные данные (до/после) через git diff, git show или git worktrees, не проверяя ветки unnecessarily.
  2. Шаг 2: Запустить анализ эволюции графов (graph-evolution) для обоих снимков, выполнив engine.preanalysis() для получения сигналов taint, границ привилегий и радиуса поражения.
  3. Шаг 3: Нормализовать доказательства, выделив добавленные/удалённые узлы и рёбра, изменения множеств точек входа, taint, границ привилегий, радиуса поражения, сложности и новых достижимых чувствительных стоков.
  4. Шаг 4: Применить правила из references/gate-rules.md для вынесения вердикта: FAIL, WARN, PASS или UNKNOWN.
  5. Шаг 5: Сформировать пакет вывода согласно references/output-format.md и передать его ревьюеру ветки.

Примеры запросов агенту

Проведи структурный обзор через trailmark-review-gate для этого pull request, чтобы проверить, не расширился ли радиус поражения.
Проверь безопасность коммита с помощью trailmark-review-gate, выявив новые точки входа и удалённую авторизацию.
Примени правила gate к диффу между ветками, чтобы получить структурный пакет для ревью до слияния.

Что понадобится

  • Инструменты Trailmark (включая engine.preanalysis() и анализ эволюции графов).
  • Доступ к git (для работы с diff, show, worktrees).
  • Файлы конфигурации и правил: references/gate-rules.md, references/output-format.md, references/review-integration.md.

Описание составлено по SKILL.md навыка, сверено 09.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «trailmark-review-gate» из репозитория: # https://github.com/trailofbits/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r trailmark-review-gate/ ~/.claude/skills/trailmark-review-gate/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.