К основному содержанию
скилл CX Codex

threat-patch — скилл для Claude Code: патчи по находкам

Скилл threat-patch берёт находки сканера или модель угроз и превращает их в небольшие патчи кода с описанием правок и шагами проверки.

MIT 232 установок ★ 227 обновлён 2026-08-15

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add pproenca/dot-skills --skill threat-patch -a claude-code
Открыть на GitHub

Что делает threat-patch

Скилл читает находки из findings.json, CSV от Codex, файла THREAT-MODEL.md или из описания уязвимости в чате и готовит патч под каждую. Перед правкой он открывает указанные пути и проверяет, что проблема ещё жива в HEAD, затем показывает план: какие файлы меняются и каким способом. Код правится только после согласования.

Если один и тот же баг повторяется в нескольких местах, скилл выносит общий хелпер вместо отдельной заплатки в каждом. Для CSV сначала запускается scripts/parse-findings.sh <csv-path>, на выходе структурированный список находок.

Работу лучше вести в git: без коммитов откат делается через git checkout -- <files>, а если правки уже закоммичены — через git revert. Хуки PreToolUse на Edit и Write спрашивают подтверждение на каждое изменение файла. Три справочника в скилле задают методику по шагам, шаблоны для классов уязвимостей и формат итоговой записи.

Какие задачи решает

  • закрыть уязвимости из findings.json по одной, начиная с критичных
  • превратить CSV-выгрузку сканера в готовые патчи
  • убедиться, что находка ещё воспроизводится в HEAD, до правки
  • заменить несколько одинаковых заплаток одним общим хелпером
  • задокументировать правку и команду проверки для ревью

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

  • Залатай уязвимости из findings.json, начни с самых серьёзных.
  • Разбери CSV сканера: прогони scripts/parse-findings.sh security.csv и предложи патчи.
  • Вот описание дыры в обработчике входа в API — предложи минимальную правку, код вокруг не трогай.

Как установить threat-patch

1Через Skills CLI (Vercel)

npx skills add pproenca/dot-skills --skill threat-patch -a claude-code

2Вручную: положить файлы

~/.claude/skills/threat-patch/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/threat-patch/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о threat-patch

Как установить threat-patch в Claude Code?

Выполните npx skills add pproenca/dot-skills --skill threat-patch -a claude-code. Файл скилла появится по пути ~/.claude/skills/threat-patch/SKILL.md.

Что делает threat-patch?

Сопоставляет находку с конкретными файлами и функциями, проверяет её наличие в текущей ветке и пишет небольшую правку. После согласования добавляет краткое описание и команды для тестов.

Как откатить правки, если патч не подошёл?

Пока правки не закоммичены, используйте git checkout -- <files>. Если коммиты уже сделаны — git revert.

Исходный текст

SKILL.md · MIT
---
name: threat-patch
description: Remediate security findings by producing minimal, surgical code patches. Triggers on 'patch security findings', 'fix vulnerabilities', 'remediate findings', 'threat patch', or when the user provides a findings.json (from threat-model), a Codex security findings CSV, a THREAT-MODEL.md, or individual vulnerability descriptions and wants them fixed. Also trigger when reviewing code flagged by a security scanner and the user wants actionable fixes rather than just reports.
---
# Threat Patch

Reads security findings and produces minimal, surgical code patches with structured documentation. Fixes are code-grounded — each patch targets specific files and functions identified in the finding. Output includes a summary, validation steps, and the code changes.

## When to Apply

- User provides a `findings.json` (from threat-model) and wants fixes
- User provides a Codex security findings CSV and wants fixes
- User has a THREAT-MODEL.md and wants to remediate identified risks
- User describes a specific vulnerability and wants a patch
- Reviewing security scanner output and needs actionable fixes
- After a security audit, turning findings into code changes

## Input Sources (priority order)

| Source | What It Provides | How to Use |
|--------|-----------------|-----------|
| **findings.json** (from threat-model) | Structured findings with data flow traces, systemic groupings, exploit chains, and severity ratings | Read directly — richest input, already triaged and grouped |
| **Codex CSV** | Title, description, severity, relevant_paths per finding | Run `scripts/parse-findings.sh <csv-path>` to extract structured output |
| **THREAT-MODEL.md** | Human-readable threat model | Extract findings from Criticality Calibration section |
| **Inline description** | User describes a specific vulnerability | Parse from conversation context |

When `findings.json` is available, it's the preferred input — it includes data flow traces (entry → chain → sink) that directly inform where to apply fixes, and systemic groupings that suggest centralized fixes over individual patches.

## Workflow Overview

```
1. Ingest Findings   → Read findings.json / CSV / descriptions
2. Triage & Group    → Sort by severity, use systemic groupings if available
3. For each finding:
   a. Read Code      → Open relevant_paths, understand the pattern
   b. Confirm        → Verify issue is still present in HEAD
   c. Design Fix     → Determine minimal fix approach
   d. Implement      → Write the code changes
   e. Document       → Summary + Validation + Attack-path (if needed)
   f. Test           → Run relevant tests
4. Output            → Per-patch deliverable with summary and diff
5. Update State      → Mark patched findings in findings.json (if present)
```

## How to Use

1. Read [workflow](references/workflow.md) for the detailed patching methodology at each step
2. Read [fix patterns](references/fix-patterns.md) when designing fixes — common patterns by vulnerability class
3. Read [output format](references/output-format.md) for the documentation template per patch
4. If input is findings.json: read it directly — it's already structured
5. If input is Codex CSV: run `scripts/parse-findings.sh <csv-path>` to extract structured output

## Key Principles

- **Minimal diff**: Fix the vulnerability, don't refactor surrounding code. The smallest correct patch is the best patch
- **Centralize over duplicate**: When multiple code paths share the same vulnerability pattern, extract a shared helper rather than patching each site independently
- **Explicit error paths**: Add specific error types for rejected inputs with clear operator feedback, not silent failures or generic errors
- **Confirm before fixing**: Always verify the finding is still present in HEAD — code may have moved or been refactored since the finding was detected
- **User approval before edits**: Present the fix design (files to change, approach) and wait for approval before modifying source code. Hooks gate Edit/Write tool calls for additional safety
- **Document even failures**: When a fix can't be tested due to environment limitations, document the test command and the limitation

## Guardrails

This skill modifies source code. Safety measures:
- **PreToolUse hooks** on Edit and Write tools prompt for confirmation before each file change
- **Confirmation gate** in the workflow between fix design and implementation
- **Revert path**: Without commits (default), use `git checkout -- <files>` to undo. With commits, use `git revert`

## Output Modes

**Code patch** — when a fix is implemented:
- Summary of what was confirmed and what the fix does
- Testing section with build/test commands
- The actual code changes

**Analysis only** — when the fix needs user decision or architectural changes:
- Summary of what was confirmed
- Validation checklist
- Attack-path analysis (path, likelihood, impact, assumptions, controls, blindspots)

## References

| File | When to Read |
|------|-------------|
| [references/workflow.md](references/workflow.md) | Before starting — detailed approach for each patching phase |
| [references/fix-patterns.md](references/fix-patterns.md) | When designing fixes — patterns by vulnerability class |
| [references/output-format.md](references/output-format.md) | When documenting — templates for both output modes |

© pproenca · MIT · pproenca/dot-skills

Похожие скиллы

Все скиллы по теме «Безопасность» →
mantis-patch официальный google Скилл mantis-patch создаёт минимальные исправления безопасности в изолированном окружении, накладывает патчи и проверяет результат на воспроизведённых уязвимостях. CX Codex +1 1 600установок implement-patch trailofbits Скилл implement-patch для Claude Code организует исправление подтверждённых багов на уровне нарушенных инвариантов. Формирует регрессионный тест, единый локальный коммит и файлы патчей. CX Codex +1 677установок fix-finding официальный OpenAI Скилл fix-finding для Codex и других платформ исправляет и верифицирует уязвимости безопасности. Запускается по явному запросу для устранения конкретной бреши. CX Codex GP ChatGPT +1 27установок prove-patch trailofbits Скилл prove-patch для Claude Code проверяет локальный security patch commit независимыми тестами и трёхсторонним сравнением. Запускается для scoped proof исправления. CX Codex +1 676установок patch официальный anthropics Скилл patch готовит патчи для подтверждённых уязвимостей без изменения кода в репозитории. CX Codex +1 1 200установок meta-apply wanshuiyin Скилл meta-apply применяет проверенные патчи самооптимизации к корпусу скиллов после вердикта жюри моделей и явного подтверждения пользователя. CX Codex +1 383установок

Из того же набора139

Весь набор →
graph-schema Скилл graph-schema для Claude Code помогает проектировать, проверять и перерабатывать схемы графовых баз данных. Он включается при моделировании узлов и связей или переносе предметной области в граф. CX Codex +1 239установок clean-code-ts-react Скилл clean-code-ts-react переносит принципы Clean Code Роберта Мартина на TypeScript 5.x и React 19. Помогает на код-ревью, при рефакторинге и проектировании компонентов или функций. CX Codex +1 238установок cli-for-agents Скилл cli-for-agents для Claude Code помогает проектировать и проверять CLI, которым пользуются ИИ-агенты и автоматизация. Он включается при работе с подкомандами, флагами, справкой и сообщениями об ошибках. CX Codex +1 237установок eval-mcp Скилл eval-mcp проверяет схемы MCP-сервера и точность выбора инструментов моделью. Находит пересечения в описаниях и тестирует вызовы на синтетических запросах. CX Codex +1 234установок diagram-quality Скилл diagram-quality задаёт правила отрисовки PlantUML на холсте agent-uml, предотвращая ошибки HTTP 400 и пустые схемы при работе с инструментами дизайна. CX Codex +1 230установок drizzle-sqlite Скилл drizzle-sqlite помогает писать и проверять Drizzle ORM для SQLite: схемы, миграции, запросы, транзакции и типы. Подходит для рефакторинга SQLite-кода. CX Codex +1 221установок cli-review-runner Скилл cli-review-runner для Claude Code проверяет CLI-команду по 45 правилам каталога cli-for-agents и оценивает, может ли агент безопасно использовать её в пайплайне. CX Codex +1 219установок openai-codex-rust-patterns Скилл openai-codex-rust-patterns добавляет 63 инженерных правила для разработки на Rust из кодовой базы агента OpenAI Codex. Помогает писать надёжный async-код, изолировать подпроцессы и проектировать enum-ошибки. CX Codex +1 219установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой