hunt-comments
Use when hunting down verbose, narrative, or dead comments in the codebase to reduce comment noise and character counts.
소스 정보
- 저장소
- dealfluence/adeu
- 최근 소스 활동
- 2026년 8월 22일 16:40
- 감지된 SKILL.md 언어
- 영어
- 스타
- 168
- 포크
- 25
설치 방법
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
소스 파일 검토
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
SKILL.md 표시 중
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`
GitHub에서 보기