# comment-analyzer

Субагент разбирает комментарии и docstring в коде: сверяет их с реализацией, находит устаревшее и лишнее. Пригодится перед pull request.

- субагент · `type=agent` · Claude Code · ★ 44770
- Автор: Anthropic · официальный репозиторий Anthropic
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/anthropics/claude-plugins-official/tree/HEAD/plugins/pr-review-toolkit/agents/comment-analyzer.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/agents/comment-analyzer

## Что делает

Агент читает комментарии глазами разработчика, который откроет этот код через год и без контекста. Каждое утверждение в комментарии он сверяет с реализацией: совпадают ли параметры и возвращаемые типы с сигнатурой, соответствует ли описанное поведение логике, существуют ли упомянутые типы и переменные, обработаны ли заявленные краевые случаи. Отдельно смотрит на полноту: записаны ли предпосылки, неочевидные побочные эффекты, важные ошибки, объяснён ли подход в сложных алгоритмах.

Дальше — оценка на перспективу. Комментарии, которые пересказывают очевидный код, помечаются на удаление. Те, что объясняют «почему», ценнее описывающих «что». Отдельная категория — то, что вводит в заблуждение: двусмысленные формулировки, ссылки на отрефакторенный код, примеры, разошедшиеся с реализацией, забытые TODO и FIXME.

Ответ приходит разделами: сводка, критичные проблемы, возможности улучшения, рекомендованные удаления и удачные примеры. Для каждой находки указано место вида `file:line` и предложенная правка. Сам агент код не трогает — он только советует, вносить изменения придётся вам. Модель наследуется от текущей сессии, так что отдельная настройка не нужна.

## Установка

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

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin install pr-review-toolkit@claude-plugins-official
```

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

### Codex

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

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/anthropics/claude-plugins-official/tree/HEAD/plugins/pr-review-toolkit/agents/comment-analyzer.md

## Когда брать
- сверить свежие docstring с фактической сигнатурой функций
- пройтись по всему диффу перед открытием pull request
- найти комментарии, которые устареют при ближайшем изменении кода
- отличить полезное объяснение «почему» от пересказа очевидного кода
- вычистить забытые TODO и FIXME, которые уже неактуальны

## Примеры запросов агенту
- Проверь комментарии в `auth/handler.py`, которые я только что дописал
- Пройдись по диффу и отметь неточные или устаревшие комментарии
- Найди в `src/parser.ts` комментарии, которые вводят в заблуждение

## Похожие
- [comment-code-generate-a-tutorial](https://affpapa.org/nevibecode/skills/comment-code-generate-a-tutorial.md) — скилл · 8900 установок
- [lean-comments](https://affpapa.org/nevibecode/skills/lean-comments.md) — скилл · 17 установок
- [code-reviewer](https://affpapa.org/nevibecode/agents/voltagent-community-code-reviewer.md) — субагент · 31050 установок
- [debugger](https://affpapa.org/nevibecode/agents/debugger.md) — субагент · 13459 установок

Из того же набора: [anthropics/claude-plugins-official](https://affpapa.org/nevibecode/by/anthropics/claude-plugins-official.md) — 145 карточек

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

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