Post-processing tool that removes excessive AI-generated comments. Use after code generation to make it look human-written.
AI가 생성한 코드에서 과도한 주석을 제거하는 Post-Processor.
AI 생성 코드의 흔한 문제:
# ❌ 과도한 주석
def calculate_total(items):
# 총합을 저장할 변수 초기화
total = 0
# 각 아이템을 순회
for item in items:
# 가격 더하기
total += item.price
# 결과 반환
return total
scripts/check-comments.py 실행하여 자명한 주석 제거:
# ✅ 정리 후
def calculate_total(items):
total = 0
for item in items:
total += item.price
return total
코드 생성 완료 후:
bash .agent/scripts/run-comment-check.sh또는 직접 실행:
# 분석만 (dry-run)
python scripts/check-comments.py src/
# 자동 수정
python scripts/check-comments.py src/ --auto-fix
# 주석 비율 임계값 설정
python scripts/check-comments.py src/ --threshold 0.2
.agent/artifacts/comment-check-report.md - 분석 결과 리포트자동으로 감지하는 자명한 주석 패턴:
.agent/rules/comment-rules.md에서 추가 패턴 정의 가능:
remove_patterns:
- "변수 선언"
- "값 할당"
preserve_patterns:
- "HACK:"
- "SECURITY:"
- "PERFORMANCE:"
이 Skill은 다음 상황에서 자동으로 활성화됩니다:
/build 워크플로우 완료 시v1.0 (2026-01-24)