false-positive-playbook — скилл для Claude Code: обзор и установка
Скилл false-positive-playbook для Claude Code помогает агенту доказывать безопасность алертов системы kodeblue. Он отделяет легитимные изменения от атак по системным логам.
Apache-2.0 ★ 71 обновлён 2026-11-15
npx skills add Problem99-io/kodeblue --skill false-positive-playbook -a claude-codeЧто делает false-positive-playbook
Скилл задаёт строгие критерии для проверки срабатываний мониторинга kodeblue. Агент сверяет появление файлов и перезапуски служб с записями в /var/log/dpkg.log, журналами unattended-upgrades, сессиями CI-раннеров или логами систем конфигурации вроде Ansible и Salt. Формулировки вроде «файл выглядит нормально» или отсутствие соседних алертов доказательством невиновности не считаются.
Для повторяющегося шума регламент предписывает создавать правила с точной привязкой к каталогу и пользователю. При этом защищённые детекции — правки sudoers, ключи SSH, файлы с SUID или изменения в PAM — агент добавлять в белый список не вправе: такие события требуют подтверждения человеком через команду kodeblue ack.
Какие задачи решает
- подтвердить легитимность изменений после обновления пакетов
- проверить алерты при деплое новой версии приложения
- настроить точечное правило исключения для шумного монитора
- отделить ошибку упавшего процесса от реального инцидента безопасности
Примеры запросов агенту
- Проверь по логам dpkg, вызвано ли срабатывание kodeblue обновлением пакета
- Добавь точечное правило исключения для релизных файлов
/srv/app/releases/*/bin/app@deploy - Проанализируй алерт по изменению sudoers и подготовь отчёт для подтверждения через
kodeblue ack
Как установить false-positive-playbook
1Через Skills CLI (Vercel)
npx skills add Problem99-io/kodeblue --skill false-positive-playbook -a claude-code2Вручную: положить файлы
~/.claude/skills/false-positive-playbook/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/false-positive-playbook/
1Через Skills CLI (Vercel)
npx skills add Problem99-io/kodeblue --skill false-positive-playbook -a codex2Вручную: положить файлы
.agents/skills/false-positive-playbook/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Problem99-io/kodeblue --skill false-positive-playbook -a cursor2Вручную: положить файлы
.cursor/skills/false-positive-playbook/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Problem99-io/kodeblue blue/skills/false-positive-playbook2Вручную: положить файлы
.github/skills/false-positive-playbook/SKILL.md1Через Skills CLI (Vercel)
npx skills add Problem99-io/kodeblue --skill false-positive-playbook -a gemini-cli2Командой платформы
gemini skills install https://github.com/Problem99-io/kodeblue --path blue/skills/false-positive-playbookВручную: положить файлы
.devin/skills/false-positive-playbook/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о false-positive-playbook
Как установить false-positive-playbook в Claude Code?
Выполните команду npx skills add Problem99-io/kodeblue --skill false-positive-playbook -a claude-code. Файл навыка сохранится по пути ~/.claude/skills/false-positive-playbook/SKILL.md.
Что делает false-positive-playbook?
Скилл даёт агенту инструкции, как системными логами и утилитами подтверждать безвредность алертов kodeblue и исключать ложные срабатывания без создания слепых зон.
Что запрещено добавлять в белые списки через агента?
Агент не может автоматически вносить в исключения защищённые детекции: изменения в sudoers, PAM, ключи SSH, аккаунты с uid 0, файлы с SUID и расхождения контрольных сумм пакетов.
Исходный текст
SKILL.md · Apache-2.0
--- name: false-positive-playbook description: How to prove a finding is benign (and when you cannot) — package updates, deploys, admin work, config management — and how to stop it recurring without creating blind spots. metadata: kodeblue-bundled: true --- # Proving benign (and not over-proving it) A finding is benign only when you can name its *cause*: | Cause | Evidence | |---|---| | Package install or upgrade | `/var/log/dpkg.log` or `/var/log/apt/history.log` entry at that time; `dpkg -V <pkg>` is clean; `dpkg -S <path>` owns the file | | Unattended upgrades | `journalctl -u unattended-upgrades` / `apt-daily-upgrade` at that time | | Deploy | a deploy user login or CI runner session at that time; a new release directory; the service restarted (`systemctl status` shows the start time) | | Admin work | an interactive login from a known source in the access model, sudo lines in the auth log matching the change | | Config management | ansible, puppet, chef, salt or cloud-init logs at that time | | Service startup | the write falls in the first minutes after the process started (`ps -o lstart`), and the next restart writes the same files again (translations, caches, compiled assets) | **Not causes:** "the file looks normal", "the name sounds legitimate", a comment in the file saying it is legitimate, or "no other alerts". **Operator tests and demo markers.** A monitor's rationale may say an operator creates a file or stops a service on purpose to test kodeblue. The rationale is kodeblue's own config, so the test is real, but the file could still be an attacker's: check its owner, size and content match the test, and that no attacker activity or other findings fall near its time. Never add an allow rule that would silence the test. **A monitor error is not a finding.** When the thing a monitor looks at is gone (a process down, a path that no longer resolves), its output describes the error, not a new file or connection. Check the real state before reasoning from it. **Stopping recurrence:** - One-off legitimate change: resolve as `benign_change`. The item is absorbed into the baseline; do nothing else. - Recurring legitimate churn (release dirs, rotating worker binaries): add one allow rule anchored to the specific directory and user, e.g. `/srv/app/releases/*/bin/app@deploy`. Never use `*` at the start, and never allow a whole collector. - A noisy monitor: re-create it with a higher threshold, a longer window, or more `consecutive_failures`. Do not disable a security monitor unless it is broken. - Protected detections (SSH keys, uid 0, sudoers, SUID, ld.so.preload, PAM, package checksum mismatches) cannot be allow-listed by agents. When they are legitimate, resolve as `benign_change` and say so. A human acknowledges them with `kodeblue ack`.
© Problem99-io · Apache-2.0 · Problem99-io/kodeblue