用途:audit-comment-residue 是一个只读分类器,专门识别代码注释中的“残留”内容,即只有在产生该注释的会话、计划或变更语境下才有意义的文字。它不评判注释好坏的正向问题,只负责标出失败于“注释应记录代码无法表达的信息”这一原则的注释。
主要能力:识别四种残留形态。history-narration 叙述代码过去的状态(如 used to、no longer、renamed from X);plan-reference 引用工作计划、会话或变更集(如 Task 2 replaces、as planned、in this PR);conversational-antecedent 面向需求方或对话(如 per your request、as you asked);ticket-pr-residue 回溯读者无法跟进的工单、PR 或分支(如 see PR #45、JIRA-123)。默认分两级:Tier 1 建议删除,Tier 2 需人工复核,其中 TODO(#issue) 这类追踪真实待办工作的标记属于豁免例外,不会被标记。检测仅针对一行的注释部分,出现在标识符或字符串字面量中的残留形态词不会被标记;行上或前一行有 comment-residue-ignore 时跳过。
使用方式:默认无参数时,若有未提交的代码文件则批量审计这些文件;无未提交代码文件时以退出码 0 友好退出并提示传入文件或目录。传入文件路径做单文件审计,传入目录做批量审计(文件名按字典序排序以保证输出确定性)。也支持显式 audit 形式。审计通过 bash "${CLAUDE_SKILL_DIR}/scripts/detect.sh" 在目标上运行,检测结果按每文件分级表输出,包含层级、形态、行号、摘录和处置建议,批量结束后给出汇总统计。输出按行号排序,无时间戳。
适用场景:在提交或整理代码前,检查注释是否携带了应属于版本控制的历史叙述、仅限当前会话的计划引用、面向对话方的措辞,以及无实质意义的来源回溯。
限制:完全只读,不使用 Edit、Write 或变更性 Bash 操作,删除由作者手动执行。只处理代码文件,Markdown 由 /audit-noise 负责,传入 .md 目标不会产生结果。它是分类器而非清理工具,与 /code-tidying:tidy 关注的清理不同。发行方为 melodic-software/claude-code-plugins,具体收费、平台与安装步骤资料未提供。