no-comments · michael-denyer — скилл для Claude Code: что делает и как установить
Запускает субагента comment-sicko для чистки бесполезных комментариев и подавлений линтера, превращая реальные ограничения в код тестов или типов.
npx skills add michael-denyer/pstack-claude --skill no-comments -a claude-codeЧто делает no-comments
Скилл передаёт контекст файлов или текущий diff ветки субагенту pstack:comment-sicko. Тот находит мусорные пояснения, мёртвые ветки кода и подавления TypeScript или линтера. Если директива отключает проверку безопасности или корректности, она помечается на обязательное удаление. Простые замечания агент устраняет сразу: вырезает неиспользуемые параметры и переключает вызовы на прямой API.
Когда правка затрагивает архитектуру, скилл запускает команду /architect для создания эскиза решения, но оставляет саму реализацию за последующим шагом. Для комментариев с явными запретами вроде do not remove агент предлагает закодировать ограничение через тип, рантайм-проверку или тест. Без подтверждения пользователя такие изменения не внедряются.
Инструмент тесно завязан на правила poteto-mode и команды вроде /how или /why, поэтому без этой экосистемы скилл спотыкается на разборе спорных пометок.
Какие задачи решает
- вычистить устаревшие комментарии и мёртвые ветки кода
- перевести словесные запреты вроде
do not removeв автоматические тесты или типы - убрать необоснованные подавления линтера и TypeScript
- найти первопричину обходных путей вместо накопления временных заплаток
Примеры запросов агенту
- /no-comments
- Проверь текущий diff против main через /no-comments
- Запусти /no-comments для файла src/index.ts
Как установить no-comments
1Через Skills CLI (Vercel)
npx skills add michael-denyer/pstack-claude --skill no-comments -a claude-code2Вручную: положить файлы
~/.claude/skills/no-comments/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/no-comments/
1Через Skills CLI (Vercel)
npx skills add michael-denyer/pstack-claude --skill no-comments -a codex2Вручную: положить файлы
.agents/skills/no-comments/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add michael-denyer/pstack-claude --skill no-comments -a cursor2Вручную: положить файлы
.cursor/skills/no-comments/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install michael-denyer/pstack-claude no-comments2Вручную: положить файлы
.github/skills/no-comments/SKILL.md1Через Skills CLI (Vercel)
npx skills add michael-denyer/pstack-claude --skill no-comments -a gemini-cli2Командой платформы
gemini skills install https://github.com/michael-denyer/pstack-claude --path plugins/pstack/skills/no-commentsВручную: положить файлы
.devin/skills/no-comments/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add michael-denyer/pstack-claude --skill no-comments -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о no-comments
Как установить no-comments в Claude Code?
Выполните в терминале команду npx skills add michael-denyer/pstack-claude --skill no-comments -a claude-code. Также можно вручную сохранить файл по пути ~/.claude/skills/no-comments/SKILL.md.
Зачем нужен скилл no-comments?
Он запускает субагента pstack:comment-sicko, чтобы убрать из репозитория комментарии-пояснения и подавления линтеров. Скилл устраняет первопричины проблем, а не маскирует их новыми проверками симптомов.
Как скилл обрабатывает комментарии с запретом на удаление?
Если комментарий содержит фразу do not remove или do not change wording, агент предлагает заменить его проверкой типов, рантайм-валидацией или тестом. После одобрения пользователем он внедряет проверку и удаляет текст комментария.
Исходный текст
SKILL.md · MIT
--- name: no-comments description: "Spawn the comment-sicko subagent, fix accepted findings, and offer encodings for claimed constraints." --- # No comments On Codex, read the [platform mapping](../poteto-mode/references/codex-tools.md), including its per-skill notes, before following this skill. On GitHub Copilot, read the [platform mapping](../poteto-mode/references/copilot-tools.md), including its per-skill notes, before following this skill. On Muse, read the [platform mapping](../poteto-mode/references/muse-tools.md), including its per-skill notes, before following this skill. Spawn comment-sicko. Act on accepted findings. Defer to comment-sicko's fresh perspective. ## Scope Use the caller's files or diff. Otherwise use the current diff against the base branch, default `main`, including the working tree. ## Steps 1. Spawn `Agent` with `subagent_type: "pstack:comment-sicko"`. Pass the scope. Pick each subagent's reasoning level for the job, per the Subagents section of the **poteto-mode** skill. Do not restate its rules. 2. Inspect its report and diff. Reject application-code edits, scope escapes, exception-protected deletions, misstated `MUST KILL` reasons, and flags that treat kept intentional code as guilty. Reshape flags on our-code surprises stay actionable. Do not restore those comments. A keep survives only with proof it is about something we cannot change. Audit missed scoped lint and TypeScript suppressions. Correctness or safety suppressions stay actionable `MUST KILL`s. Restore deletions only with exact exceptions and scoped proof. Before accepting thin `IMPORTANT` or `do not remove` kills or keeps, run `/how` or `/why` on their symbol. If a kill is ambiguous, do not restore. If a keep is refuted or still ambiguous, delete it. Revert and rerun one rejected report with the failure named. Reject a second, report it open, and fail `/no-comments`. 3. Fix trivial accepted flags directly by deleting a dead path, dropping a parameter, or using the real API. If any fix needs a shape, run `/architect` once for the accepted set and surrounding code. Stop at the sketch. Architect shapes. Step 4 implements. 4. Implement the smallest root-cause fix in scope. Remove every named workaround. If the root cause is out of scope, land the smallest in-scope fix and report the rest open. The **principle-fix-root-causes** and **principle-redesign-from-first-principles** skills guide intent only. Neither authorizes widening the fence nor fixing instances outside it. Never bolt on symptom guards. 5. Constraint comments say `do not remove`, `do not change wording`, or `talk to X before changing`. Leave keeps about things we cannot change. Offer the cheapest in-scope type, runtime, test, or CI lint. Wait for interactive approval. Unattended and eval require caller pre-approval. If approved, encode then delete. Otherwise delete, report the constraint open, and sketch out-of-scope work. 6. Report the deletion count, restored comments, reruns, architect sketch, fixes, encoding offers, encodings, unenforced constraints, and other open work.
© michael-denyer · MIT · michael-denyer/pstack-claude
Похожие скиллы
Всё по теме «Код-ревью и рефакторинг» →Сначала — no-comments от других авторов.