What problem does it solve? Codebases accumulate missing, inaccurate, or outdated comments that mislead maintainers, but fixing them by hand risks accidentally touching logic. This Skill provides a disciplined workflow that supplements and corrects comments while guaranteeing every change stays strictly inside comment blocks. ## Core Features & Use Cases - Three-category audit: Marks each location as missing, inaccurate, or outdated against a judgment checklist, with code as the sole source of truth. - Iron-clad safety rules: Never modifies business logic, signatures, annotations, default values, or enum values; ambiguous intent goes into a confirmation list for the user instead of being guessed. - Self-verification before commit: Uses git diff hunk-by-hunk review, git diff -w, and a compile/build check to prove all changes landed inside comments, then commits with a docs-type conventional message. - Use Case: Ask it to review a module's Java classes; it flags missing Javadoc, fixes parameter descriptions that no longer match implementations, lists uncertain items for your confirmation, and commits only comment changes. ## Quick Start Use the comment-supplement skill to fill in missing comments and fix outdated descriptions in the src/services directory.
