# subprocess-safety

Скилл subprocess-safety задаёт правила для вызовов дочерних процессов. Подключайте его, когда пишете или проверяете код со spawn, spawnSync или child_process.

- скилл · `type=skill` · Claude Code, Codex, OpenCode, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 539 у репозитория
- Автор: ZaxbyHub
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/ZaxbyHub/opencode-swarm/tree/HEAD/.agents/skills/subprocess-safety/SKILL.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/subprocess-safety

## Что делает

Скилл задаёт требования к вызовам дочерних процессов: передавайте аргументы массивом, задавайте `cwd` и таймаут, ограничивайте вывод и завершайте процесс в `finally`. Для `execFileSync` отдельно требуется настроить `stdio`, чтобы дочерний процесс не унаследовал ввод родителя. Это важно для запуска на Windows с Bun.

Для Windows скилл советует разрешать путь к `.cmd`-обёртке явно, а не включать `shell: true`. При работе с `gh api --paginate` добавляйте `--slurp`, иначе несколько страниц могут привести к ошибке разбора JSON или потере результатов. Перед изменениями нужно прочитать `AGENTS.md` и `docs/engineering-invariants.md`; для тестов и переноса моков предусмотрены дополнительные материалы.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ZaxbyHub/opencode-swarm --skill subprocess-safety -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/subprocess-safety/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/subprocess-safety/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ZaxbyHub/opencode-swarm --skill subprocess-safety -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/subprocess-safety/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ZaxbyHub/opencode-swarm --skill subprocess-safety -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/subprocess-safety/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ZaxbyHub/opencode-swarm .agents/skills/subprocess-safety
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/subprocess-safety/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ZaxbyHub/opencode-swarm --skill subprocess-safety -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/ZaxbyHub/opencode-swarm --path .agents/skills/subprocess-safety
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/subprocess-safety/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add ZaxbyHub/opencode-swarm --skill subprocess-safety -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/ZaxbyHub/opencode-swarm/tree/HEAD/.agents/skills/subprocess-safety/SKILL.md

## Когда брать
- проверить вызов дочернего процесса на отсутствие таймаута
- передать аргументы без shell-строки
- задать рабочую директорию процесса явно
- обработать пагинацию `gh api` без потери результатов
- проверить запуск `.cmd`-обёртки на Windows

## Примеры запросов агенту
- Проверь вызов `spawn` в этом файле по правилам `subprocess-safety`.
- Добавь запуск дочернего процесса с таймаутом и очисткой в `finally`.
- Проверь, что запрос `gh api --paginate` корректно обрабатывает все страницы.

## Похожие
- [bun-shell](https://affpapa.org/nevibecode/skills/bun-shell.md) — скилл · 413 установок
- [powershell-security-hardening](https://affpapa.org/nevibecode/agents/powershell-security-hardening.md) — субагент · 194 установки
- [Aletheia Runtime Safety & Scope Creep Filter](https://affpapa.org/nevibecode/mcp/aletheia-runtime-safety-scope-creep-filter.md) — MCP-сервер · ★ 12 у репозитория
- [ntwarden-windows-analysis-toolkit](https://affpapa.org/nevibecode/skills/ntwarden-windows-analysis-toolkit.md) — скилл · 450 установок
- [windows-hardening](https://affpapa.org/nevibecode/skills/windows-hardening.md) — скилл · 435 установок
- [safety-guard](https://affpapa.org/nevibecode/skills/safety-guard.md) — скилл · 6200 установок

Из того же набора: [zaxbyhub/opencode-swarm](https://affpapa.org/nevibecode/by/zaxbyhub/opencode-swarm.md) — 121 карточка

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
