kodeblue-self-integrity — скилл для Claude Code: установка и суть
Скилл kodeblue-self-integrity для Claude Code расследует изменения бинарников, движка и конфигов kodeblue. Проверяет возможное вмешательство злоумышленника при остановке или модификации агента.
Apache-2.0 ★ 71 обновлён 2026-11-15
npx skills add Problem99-io/kodeblue --skill kodeblue-self-integrity -a claude-codeЧто делает kodeblue-self-integrity
Скилл анализирует оповещения об изменении бинарников /usr/local/bin/kodeblue, движка в /usr/local/lib/kodeblue/engine или конфигурации в каталоге /etc/kodeblue. Легитимные обновления через install.sh открывают десятиминутное окно обслуживания, поэтому плановая замена файлов попадает в журнал и не вызывает тревогу. Любая правка вне этого окна расценивается как возможное вмешательство.
Для расследования агент сверяет владельца и права доступа (root, 0755), вычисляет SHA-256 через host_exec, смотрит процессы kodeblue run и kodeblue mcp, а также журналы авторизации и активность sudo. Изменения во время активных атак получают наивысшую строгость.
Агент никогда не помечает такие находки как безопасные самостоятельно. Он выставляет статус inconclusive и запрашивает подтверждение оператора через команду kodeblue ack <finding id>.
Какие задачи решает
- расследовать изменения бинарников и конфигурации kodeblue
- проверить контрольные суммы SHA-256 и права файлов kodeblue
- отличить штатный апгрейд в окне обслуживания от ручной правки
- подтвердить инцидент целостности командой kodeblue ack
Примеры запросов агенту
- Проверь оповещение об изменении бинарника kodeblue
- Выясни, почему kodeblue останавливался во время инцидента
- Сверь хеш /usr/local/bin/kodeblue с журналом целостности
Как установить kodeblue-self-integrity
1Через Skills CLI (Vercel)
npx skills add Problem99-io/kodeblue --skill kodeblue-self-integrity -a claude-code2Вручную: положить файлы
~/.claude/skills/kodeblue-self-integrity/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/kodeblue-self-integrity/
1Через Skills CLI (Vercel)
npx skills add Problem99-io/kodeblue --skill kodeblue-self-integrity -a codex2Вручную: положить файлы
.agents/skills/kodeblue-self-integrity/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Problem99-io/kodeblue --skill kodeblue-self-integrity -a cursor2Вручную: положить файлы
.cursor/skills/kodeblue-self-integrity/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Problem99-io/kodeblue blue/skills/kodeblue-self-integrity2Вручную: положить файлы
.github/skills/kodeblue-self-integrity/SKILL.md1Через Skills CLI (Vercel)
npx skills add Problem99-io/kodeblue --skill kodeblue-self-integrity -a gemini-cli2Командой платформы
gemini skills install https://github.com/Problem99-io/kodeblue --path blue/skills/kodeblue-self-integrityВручную: положить файлы
.devin/skills/kodeblue-self-integrity/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о kodeblue-self-integrity
Как установить kodeblue-self-integrity в Claude Code?
Выполните команду npx skills add Problem99-io/kodeblue --skill kodeblue-self-integrity -a claude-code.
Что делает kodeblue-self-integrity?
Скилл проверяет модификации компонентов kodeblue, сравнивает хеши и права доступа к файлам и не даёт агенту закрывать инциденты целостности без оператора.
Почему скилл не закрывает инцидент целостности автоматически?
Любое вмешательство в защитный агент может быть попыткой злоумышленника отключить наблюдение. Скилл ставит статус inconclusive, пока оператор не подтвердит изменение командой kodeblue ack <finding id>.
Исходный текст
SKILL.md · Apache-2.0
---
name: kodeblue-self-integrity
description: Findings about kodeblue itself — its binaries, engine, config or state changing, or kodeblue having stopped — and why they are never benign without an operator.
metadata:
kodeblue-bundled: true
---
# kodeblue's own integrity
An attacker who controls the machine wants to blind or tamper with its
watcher. A change to kodeblue itself is therefore treated as tampering until an
operator confirms it.
## What a legitimate change looks like
- **Upgrades** through `install.sh` (a hub-driven upgrade or an operator
re-running the installer) open a journaled 10-minute maintenance window first,
so swapping kodeblue's binaries inside it is absorbed and does not alert.
`stats` shows the recent journal. A finding on kodeblue's binaries usually means
the change happened **outside** such a window: a manual copy, a build pushed by
hand, or someone else.
- **Config** in `/etc/kodeblue` is root-owned; a change there is an operator's
action or a root compromise.
## Check
1. `host_exec ["stat","/usr/local/bin/kodeblue"]` (and
`/usr/local/lib/kodeblue/engine`): owner, mode, change time. Owner and mode
must match the install (root, 0755).
2. `host_exec ["sha256sum","/usr/local/bin/kodeblue"]`: the integrity collector
records the same SHA-256 (findings may show it shortened), so you can match the
finding's old and new values.
3. `ps -eo pid,user,lstart,cmd`: the agent restarted shortly after the change
and runs cleanly (`kodeblue run`, `kodeblue mcp`, the engine). Old instances may
linger as zombies for a moment.
4. Who could have written it: logins and sudo around the change time
(`last`, the auth log), and other files changed then
(`find /etc /root /home /tmp /var/tmp /usr/local -newermt <time> -type f`).
5. Attack context: was an attacker active (request log, open incidents) near the
change time? A change during an active attack keeps high severity until an
operator confirms it.
Notes:
- The integrity baseline keeps the old hash until a finding is resolved, so a
second change the same day reports against the original value. Line the values
up before concluding there was only one change.
- A finding on kodeblue's binaries that is still open, waiting for an operator or
resolved `inconclusive` keeps those paths out of maintenance absorption: until
the operator acks it, every later upgrade alerts again. Say so when you ask for
the ack, and check for such an older finding when an upgrade alerted.
- `kodeblue upgrade` itself runs as root from the binary its installer replaces
(in the `kodeblue-upgrade.service` unit), which kodeblue recognises and
journals as `absorb.upgrade` instead of reporting a deleted executable.
- A gap finding ("kodeblue was not running for …") is the same question: was it
a planned restart or upgrade, or did something stop it?
## Verdict
Never `benign_change` on your own judgement, even when the pattern looks exactly
like an upgrade. Resolve `inconclusive`, send an alert asking whether someone deployed a
build at that time, and let the operator acknowledge it with
`kodeblue ack <finding id>`.
Without that answer, treat a change during attacker activity as a true_positive.
© Problem99-io · Apache-2.0 · Problem99-io/kodeblue