hunt-comments
/hunt-comments
Wyszukuje rozwlekłe, narracyjne i martwe komentarze w kodzie, aby ograniczyć szum komentarzy i liczbę znaków.
- Autor
- dealfluence ↗
- Repozytorium
- adeu ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 16.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 16.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Wyszukuje rozwlekłe, narracyjne i martwe komentarze w kodzie, aby ograniczyć szum komentarzy i liczbę znaków.
Oryginalny opis (EN)
Use when hunting down verbose, narrative, or dead comments in the codebase to reduce comment noise and character counts.
Jak działa
- Workflow
Podgląd SKILL.md
---
name: hunt-comments
description: Use when hunting down verbose, narrative, or dead comments in the codebase to reduce comment noise and character counts.
---
# Hunt Comments Skill
This skill provides a systematic approach to finding and reducing comment density and character bloat across source code files.
## Workflow
1. **Run the Comment Density Spotter**:
Execute `python scripts/count_comment_chars.py` to rank files by comment character count:
```bash
uv run python scripts/count_comment_chars.py -n 25
```
2. **Target High-Density Files**:
Focus on top-ranked files with high comment ratios (>20% comment characters).
3. **Identify & Remove Non-Essential Commentary**:
- Delete narrative historical explanations ("Why we added this in 2024...", "Fix for issue #123 where...").
- Strip redundant docstrings that simply restate function signatures, types, or obvious operations.
- Collapse multi-paragraph block comments into brief 1-line "why" notes or remove them entirely if code is self-explanatory.
- Retain only essential architectural invariants (e.g., OPC part boundaries, Word signed int32 overflow rules, security guards).
4. **Verify Behavior**:
Always run test suites to verify zero functional or formatting regressions:
- Python: `uv run pytest` & `uv run mypy src`
- Node: `npm run build && npm test`
- LangChain: `uv run pytest` in `langchain`
Wersje
W bazie nie ma innych skilli o nazwie hunt-comments.
Migawka bazy z 13.11.2026 · wersja paczki 6667df8a70e5 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100code-comment-style
Pisze i skraca komentarze w kodzie tak, by w 1-3 linijkach podawały powód lub niezmiennik. - 90no-comments
Audytuje komentarze w diffie lub plikach przed przeglądem, usuwa martwe i narracyjne, a ukryte obejścia zamienia na kod. - 100code-comments
Pisze, przegląda i usuwa komentarze w kodzie oraz komentarze dokumentacyjne, także w diffach. - 100comments-docs
Ocenia jakość komentarzy i praktyk dokumentacyjnych: cztery typy komentarzy, kolejność komentarze najpierw oraz psucie się komentarzy z czasem. - 100comment-cleanup
Czyści komentarze w plikach lub folderach: usuwa zbędne, powtarzające kod i kronikujące stare zmiany. - 100comment-sweep
Porządkuje lub audytuje komentarze w gałęzi lub diffie przed recenzją: usuwa zbędne i martwe komentarze, zostawia wartościowe.