AIKraft/AI/Войти
AIKraft/Skills/Trailmark: структурный

Trailmark: структурный

Runs full Trailmark structural analysis by building a graph, running `preanalysis()`, and reporting hotspots, taint, blast radius, privilege boundaries, attack surface, and version-gated Trailmark 0.4+/0.5+ data such as proxy counts, subgraph edges, type/reference summaries, and entrypoint attributes. Use when vivisect needs detailed structural data for a target. Triggers: structural analysis, bla

trailofbits official Данные

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

Навык выполняет полный структурный анализ кодовой базы с помощью Trailmark, строя граф и запуская preanalysis() для вычисления горячих точек, taint, радиуса поражения и границ привилегий. Он предоставляет детальные данные о поверхности атаки, proxy-узлах, сводках типов и версионно-зависимых атрибутах (v0.4+/0.5+).

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

  • Когда фазе Vivisect 1 требуются полные структурные данные для приоритизации аудита.
  • Для получения детальных результатов проходов preanalysis в рамках конкретного диапазона целей.
  • При необходимости оценить сложность и данные taint для определения приоритетов.
  • Для инспекции количества proxy, рёбер подграфов или сводок типов/ссылок (при наличии Trailmark 0.4.0+).
  • Для анализа версионно-зависимых данных, таких как атрибуты точек входа в Trailmark 0.5.0+.

Как работает

  1. Проверить доступность команды trailmark (через систему или uv run); если недоступна, сообщить об этом и завершить работу.
  2. Определить поддерживаемые языки с помощью API detect_languages из trailmark.parse или trailmark.query.api.
  3. Инициализировать QueryEngine.from_directory для целевой директории и запустить engine.preanalysis().
  4. Собрать сводные данные: summary, attack_surface, hotspots, proxy_nodes и информацию о подграфах (subgraphs).
  5. При наличии метода type_references добавить выборку ссылок на типы для узлов графа.
  6. Вернуть полный JSON-пейлоад, включая версионно-зависимые поля (например, attributes в attack_surface для v0.5.0+).

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

Выполни полный структурный анализ проекта в директории /src, чтобы получить данные о горячих точках и taint.
Запусти preanalysis для целевой директории и покажи сводку по proxy-узлам и границам привилегий.
Проанализируй структуру кода через Trailmark, включая подграфы и ссылки на типы, для аудита безопасности.

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

  • Установленный Trailmark (v0.2.x, 0.3.x, 0.4+ или 0.5.0+)
  • Python 3
  • Доступ к целевой директории с кодом

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

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

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

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