# posix-shell-pro

Субагент posix-shell-pro, который пишет портируемые shell-скрипты без bash-специфики. Работает на dash, ash, sh и bash в POSIX-режиме.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 42780 у репозитория
- Автор: Ryan Snodgrass
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/wshobson/agents/tree/HEAD/plugins/shell-scripting/agents/posix-shell-pro.md
- Обновлён: 2026-10-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/posix-shell-pro

## Что делает

posix-shell-pro — это субагент для строгого POSIX sh-скриптинга. Он пишет код, который запускается на любой POSIX-совместимой оболочке: dash, ash, sh и bash с флагом --posix. Пригодится, когда скрипт должен работать на Debian, Alpine, BSD или Solaris без переделок.

Субагент запрещает себе массивы, `[[ ]]`, process substitution, `local`, `+=`, подстановки `${var//...}` и команду `source`. Вместо этого использует позиционные параметры, `[ ]` для проверок, `case` для разбора аргументов, `printf` вместо `echo` и `mktemp` с trap для временных файлов. Шебанг всегда `#!/bin/sh`, переменные всегда в кавычках: `"$var"`, а не `$var`.

Скрипты тестируются через ShellCheck в POSIX-режиме и checkbashisms. Для CI автор предлагает матрицу из dash, ash, bash --posix и yash на Linux, macOS и Alpine. Без `set -eu` в начале скрипта субагент просто не начнёт писать — это его базовое требование к любому коду.

## Установка

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

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add wshobson/agents
```
В чате агента (не в терминале):
```text
/plugin install shell-scripting@claude-code-workflows
```

2. **Вручную: положить файлы**
- Файл: `.claude/agents/posix-shell-pro.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/posix-shell-pro.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/posix-shell-pro.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/wshobson/agents/tree/HEAD/plugins/shell-scripting/agents/posix-shell-pro.md

## Когда брать
- писать скрипты, которые запускаются на dash, ash, sh и bash --posix без правок
- убирать bash-специфику из готовых скриптов
- разбирать аргументы без getopts и массивов
- настроить безопасную работу с временными файлами через mktemp и trap
- проверять портируемость через ShellCheck и checkbashisms

## Примеры запросов агенту
- Перепиши этот bash-скрипт под строгий POSIX sh, убери все массивы и [[ ]]
- Напиши скрипт с разбором аргументов через while и case, шебанг #!/bin/sh
- Проверь мой скрипт на портируемость и покажи, что сломается на dash

## Похожие
- [shell-scripting-pro](https://affpapa.org/nevibecode/agents/shell-scripting-pro.md) — субагент · 1479 установок
- [shell](https://affpapa.org/nevibecode/skills/shell.md) — скилл · 713 установок
- [shell-expert](https://affpapa.org/nevibecode/skills/shell-expert.md) — скилл · 141 установка
- [shell-integration](https://affpapa.org/nevibecode/skills/shell-integration.md) — скилл · 123 установки
- [shell-review](https://affpapa.org/nevibecode/skills/shell-review.md) — скилл · 1 установка
- [bun-shell](https://affpapa.org/nevibecode/skills/bun-shell.md) — скилл · 413 установок

Из того же набора: [wshobson/agents](https://affpapa.org/nevibecode/by/wshobson/agents.md) — 513 карточек

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

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