Průvodce · Agenti AI · · od Stefana Tsezarova
Dejte svému agentovi druhý názor, než začne jednat
Požádáte svého kódovacího agenta o opravu sestavení. Přečte si soubor README, zkontroluje vlákno problému a najde návrh:
Věrohodná oprava. Jedna malá změna. Agent připraví instalační příkaz.
Ale na chybějící pomlčce záleží. crossenv byl skutečně škodlivý balíček, odstraněný ze npm v roce 2017 poté, co bylo zjištěno, že kradl proměnné prostředí – místo, kde vývojáři často uchovávají klíče a tokeny.
Výše uvedená výměna je příkladem. Balíček nebyl.
01 Když se návrh stane příkazem
Kódovací agenti čtou spoustu textu, který možná nikdy neuvidíte: dokumentaci, komentáře k vydání, webové stránky a chybové zprávy. Tento kontext jim pomáhá řešit problémy. Může je také nasměrovat ke špatné závislosti.
Instalace balíčku si zaslouží zvláštní péči. Balíčky npm mohou obsahovat skripty, které se spouštějí během instalace, takže kód se může spustit dříve, než si jej budete moci prohlédnout.
SaveSaveSaveSave’s předinstalační kryt v tomto bodě přidá kontrolu. Než se spustí podporovaný instalační příkaz, vyhledá balíček a použije zásadu, kterou jste zvolili.
02 Co se stane s instalací?
Zvažte tři příkazy, které může agent navrhnout.
Balíček registru, který nevyvolává žádné příznaky
npm install cross-env
Strážný umožňuje pokračování příkazu. Stále platí vaše obvyklá výzva ke schválení. To znamená, že kontroly nenašly žádný důvod k námitkám; není to záruka, že je balíček bezpečný.
Balíček označený jako škodlivý
cd app && npm install --save-dev crossenv
Strážný odmítne příkaz a řekne agentovi proč. Rozpozná instalaci, i když následuje jiný příkaz.
Kód načtený přímo z GitHubu
npx github:someone/setup-script
Ve výchozím režimu strážný žádá o kontrolu člověkem. Adresa URL Git nespadá pod kontroly registru npm, takže nemůže poskytnout stejné hodnocení.
Mezi podporované příkazy patří install through npm, pnpm, yarna bun, spolu s npx, npm ci, příkazové řetězce pomocí &&a příkazy zabalené v bash -c "…".
03 Vy zvolíte pravidla
Sken poskytuje důkazy: co zkontroloval, co našel a co nedokázal posoudit. Zásady spuštěné na vašem počítači určují, co se stane dál.
Vyberte si jeden ze tří režimů:
| Režim | Hlášeno jako škodlivé | Pozor nebo nedostatečná data | Kontrola se nezdařila nebo je zdroj mimo registr |
|---|---|---|---|
| observe | Povolte a nahlaste | Povolte | Povolte |
| Ochranný kryt · výchozí | Odmítnout | Zeptejte se člověka | Zeptejte se člověka |
| strict | Odmítnout | Odmítnout | Odmítnout |
Použijte pozorujte , abyste viděli, jak se strážce chová ve vašem pracovním postupu. Vyberte guard pro blokování známých škodlivých balíčků a kontrolu nejistých případů. Zvolte striktní , pokud by neprůkazný výsledek měl instalaci zastavit.
Čistý výsledek nikdy neodstraní schválení, které by jinak váš agent vyžadoval.
04 Přidejte to do svého pracovního postupu
Pro Claude Code přidejte tento háček do .claude/settings.json vašeho projektu. Pokud soubor již obsahuje nastavení, slučte do nich háček.
{
"hooks": {
"PreToolUse": [
{
"matcher": "Bash",
"hooks": [
{
"type": "command",
"command": "npx -y savesavesavesave@0.1.5 hook claude-code --mode observe"
}
]
}
]
}
}
Hák kontroluje navrhované Bash příkazy. Příkazy bez rozpoznané instalace projdou.
U jiného agenta nebo skriptu umístěte ochranu před příkaz install:
npx savesavesavesave@0.1.5 guard --mode guard -- npm install some-package
Jeho výstupní kódy říkají vaší integraci, jak postupovat:
0: povolit1: Vyžádejte si kontrolu člověkem2: popřít
Vaše integrace musí tyto výsledky respektovat.
Dosavadní stav techniky Agenti s podporou MCP mohou také přímo požadovat kontroly. Pokyny pro nastavení klienta jsou na stránce Pro agenty .
Není vyžadován žádný účet nebo API klíč. Příklady připínají verzi, abyste si mohli konkrétní vydání před použitím prohlédnout.
05 Vědět, na co se šek vztahuje
Strážný čte informace publikované registrem npm a OSV.dev. Nestahuje ani nespouští balíček a aktuálně pokrývá balíčky npm, nikoli ekosystémy, jako je PyPI nebo crates.io.
To ponechává několik praktických omezení:
- Kontroluje podporované příkazy, které přijímá. Instalace skryté v souborech skriptů, nepodporovaní správci balíčků nebo stažené binární soubory mohou být mimo jeho zobrazení. Přísnější omezení vyžadují kontroly přístupu k síti a souborovému systému agenta.
- Nehlášená hrozba může projít. „Žádná námitka“ znamená, že dostupné kontroly nezjistily žádné známé riziko.
- Hák musí běžet, aby politika fungovala. Pokud používáte přísný režim, postupujte podle pokynů balíčku README pro blokování příkazů, když se samotný hák nespustí.
Kódovací prostředek může rychle opravit sestavení. Dokáže také rychle jednat na základě přesvědčivého návrhu od někoho, koho neznáte.
Než tento návrh získá přístup k vašemu stroji, poskytněte mu druhý názor.
Váš další krok: přidejte háček v režimu pozorování, zkontrolujte jeho výsledky a vyberte politiku, která vyhovuje vašemu pracovnímu postupu.