# phpstan-fixer

Скилл phpstan-fixer обучает агента устранять ошибки статического анализатора PHPStan через PHPDoc и строгие типы, запрещая глушить предупреждения без спроса.

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

## Что делает

Скилл задаёт для ИИ чёткие рамки работы с PHP: агент обязан устранять первопричину ошибок статического анализа, а не скрывать их в `phpstan.neon`. Менять уровни проверки или директиву `ignoreErrors` разрешено только после прямого подтверждения пользователем. Файлы в каталоге `vendor/` агент не трогает вовсе — для сторонних библиотек правила требуют использовать стабы.

Перед правками агент исследует контекст проекта через `composer.json` и `phpstan.neon`, определяя фреймворк (например, Laravel или Symfony) и уровень строгости от 0 до 10. Далее он разбирает идентификаторы ошибок вроде `missingType.parameter` или `argument.type`, добавляет нативные тайпхинты, формы массивов через `@param array{...}` или аннотации свойств `@property`. После любых изменений агент прогоняет `vendor/bin/phpstan analyse` для проверки результата.

Для работы скилла в самом проекте уже должен быть установлен и настроен PHPStan.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add marcelorodrigo/agent-skills --skill phpstan-fixer -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add marcelorodrigo/agent-skills --skill phpstan-fixer -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add marcelorodrigo/agent-skills --skill phpstan-fixer -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install marcelorodrigo/agent-skills skills/phpstan-fixer
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add marcelorodrigo/agent-skills --skill phpstan-fixer -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/marcelorodrigo/agent-skills --path skills/phpstan-fixer
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add marcelorodrigo/agent-skills --skill phpstan-fixer -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/marcelorodrigo/agent-skills/tree/HEAD/skills/phpstan-fixer/SKILL.md

## Когда брать
- добавить нативные типы и PHPDoc для параметров или возвращаемых значений
- исправить ошибки несовпадения аргументов и типов массивов
- описать динамические свойства и методы моделей через аннотации
- устранить предупреждения анализатора без правок файлов в `vendor/`

## Примеры запросов агенту
- Исправь ошибки PHPStan после анализа файла `app/Services/UserService.php`
- Разбери предупреждения `missingType.return` в контроллерах
- Запусти `vendor/bin/phpstan analyse` и добавь нужные PHPDoc в модуль заказов

## Похожие
- [wp-phpstan](https://affpapa.org/nevibecode/skills/wp-phpstan.md) — скилл · 5300 установок
- [php-pro](https://affpapa.org/nevibecode/skills/httpsgithubcomjeffallan-php-pro.md) — скилл · 16400 установок
- [go-interfaces](https://affpapa.org/nevibecode/skills/go-interfaces.md) — скилл · 1400 установок
- [laravel-verification](https://affpapa.org/nevibecode/skills/laravel-verification.md) — скилл · 6400 установок
- [sast-devils-advocate](https://affpapa.org/nevibecode/agents/sast-devils-advocate.md) — субагент · ★ 1298 у репозитория
- [typescript-discriminated-unions](https://affpapa.org/nevibecode/skills/typescript-discriminated-unions.md) — скилл · 4200 установок

Из того же набора: [marcelorodrigo/agent-skills](https://affpapa.org/nevibecode/by/marcelorodrigo/agent-skills.md) — 4 карточки

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

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