/autoformat

Простым языком

Код как текст в Word — у каждого свои привычки: кто-то делает отступ двумя пробелами, кто-то четырьмя, кто-то табом. Когда работаешь с разными источниками, стиль смешивается. /autoformat приводит весь код к единому виду — как «выровнять текст» одной кнопкой.

Напиши /autoformat — Claude отформатирует весь проект по его настройкам и скажет сколько файлов изменилось. Обычно это делается автоматически, но иногда нужно запустить вручную.

Что делает

/autoformat запускает форматирование кода на весь проект или конкретные файлы. Prettier для JavaScript/TypeScript, ruff для Python. Использует конфиги проекта (.prettierrc, pyproject.toml). Показывает сколько файлов изменено и что именно исправлено.

Синтаксис

# Форматировать весь проект
/autoformat

# Конкретный файл
/autoformat src/api/auth.ts

# Директория
/autoformat src/components/

# Только проверка без изменений (dry-run)
/autoformat --check

Пошаговый процесс

1. Определяет язык по расширениям файлов в указанном пути
2. Для JS/TS: находит .prettierrc или prettier в package.json, запускает npx prettier --write
3. Для Python: находит pyproject.toml с [tool.ruff], запускает ruff format . и ruff check --fix .
4. Для смешанных проектов — запускает оба инструмента
5. Показывает список изменённых файлов с количеством строк
6. Если изменений нет — "всё уже отформатировано"

Примеры использования

После вставки кода из ChatGPT

Вставили большой блок кода с другим стилем кавычек и отступами. Вместо ручного исправления — /autoformat приводит всё к единому стилю.

/autoformat src/lib/telegram.ts

# Вывод:
Prettier 3.2.5
Форматирование src/lib/telegram.ts...

  Изменено: 34 → 31 строка (удалены лишние пробелы)
  Кавычки: двойные → одинарные (по .prettierrc)
  Trailing comma: добавлены в 8 местах

1 файл отформатирован.

Форматирование всего проекта перед деплоем

Перед крупным деплоем убеждаетесь что весь код имеет одинаковый стиль. Особенно важно если работали несколько сессий.

/autoformat

# Вывод:
Prettier 3.2.5 (TypeScript/JavaScript)

Изменено файлов: 12 из 89
  src/components/FeedCard.tsx
  src/api/feed/route.ts
  src/seed/data/tools-commands.ts
  ... (ещё 9 файлов)

Без изменений: 77 файлов

Автоматизация

Хук post-edit-format.sh запускает prettier автоматически после каждого Edit или Write. /autoformat нужен для случаев вне Edit-хука: вставка больших блоков, исправление накопившегося, форматирование перед деплоем.

# Хук срабатывает автоматически:
PostToolUse (Edit/Write) → prettier/black на изменённый файл

# /autoformat нужен когда:
- вставили большой блок кода снаружи
- форматирование накопилось за несколько сессий
- хотите проверить что всё чисто перед PR

# .prettierrc пример:
{
  "semi": false,
  "singleQuote": true,
  "tabWidth": 2,
  "trailingComma": "all"
}

Форматирование — это не стиль. Это отсутствие шума в git diff при код-ревью.