# typescript-refactor-expert

Субагент typescript-refactor-expert проводит рефакторинг кода на TypeScript и современном JavaScript без изменения поведения программы. Применяет принципы SOLID и чистой архитектуры после написания фич.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 372 у репозитория
- Автор: Giuseppe Trisciuoglio
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/giuseppe-trisciuoglio/developer-kit/tree/HEAD/plugins/developer-kit-typescript/agents/typescript-refactor-expert.md
- Обновлён: 2026-09-10
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/typescript-refactor-expert

## Что делает

Субагент на базе модели `sonnet` анализирует файлы проекта с помощью встроенных инструментов `Read`, `Glob` и `Grep`. Он выявляет запахи кода, заменяет небезопасные типы `any` строгими интерфейсами, сужает типы защитниками и выносит магические значения в именованные константы.

Перед изменениями субагент проверяет файл `CLAUDE.md`, правила которого имеют наивысший приоритет над встроенными инструкциями. Правки вносятся пошагово через `Edit` и `Write`. После каждого шага агент подтверждает корректность кода запуском тестов через `Bash`, поэтому скрытые регрессии исключены.

## Установка

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

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add giuseppe-trisciuoglio/developer-kit
```
В чате агента (не в терминале):
```text
/plugin install developer-kit-typescript@developer-kit
```

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

### Codex

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

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/giuseppe-trisciuoglio/developer-kit/tree/HEAD/plugins/developer-kit-typescript/agents/typescript-refactor-expert.md

## Когда брать
- избавиться от типов `any` и небезопасных приведений
- перевести цепочки промисов и колбэки на `async`/`await`
- заменить громоздкие enum на строгие union-типы
- разбить крупные методы на небольшие функции

## Примеры запросов агенту
- Проведи рефакторинг файла `src/services/user.ts` и избавься от `any`.
- Упрости сложные условия и вынеси магические числа в `src/order.ts`.
- Перепиши модуль авторизации с учётом SOLID и запусти тесты.

## Похожие
- [typescript-clean-code](https://affpapa.org/nevibecode/skills/typescript-clean-code.md) — скилл · 669 установок
- [typescript-refactor](https://affpapa.org/nevibecode/skills/typescript-refactor.md) — скилл · 808 установок
- [09_typescript_refactor](https://affpapa.org/nevibecode/prompts/09-typescript-refactor.md) — промпт · ★ 2744 у репозитория
- [typescript](https://affpapa.org/nevibecode/skills/mindrally-typescript.md) — скилл · 1000 установок
- [migrate-js-to-modern-typescript](https://affpapa.org/nevibecode/skills/migrate-js-to-modern-typescript.md) — скилл · 145 установок
- [clean-code](https://affpapa.org/nevibecode/prompts/clean-code.md) — промпт · ★ 788 у репозитория

Из того же набора: [giuseppe-trisciuoglio/developer-kit](https://affpapa.org/nevibecode/by/giuseppe-trisciuoglio/developer-kit.md) — 191 карточка

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

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