Claude Code clean-comments 技能:删除复述代码的注释
EnglishClaude Code 安装步骤
- 打开 GitHub 固定提交的 `.claude/skills/clean-comments/SKILL.md`,核对内容与使用条件。
- 在自己的项目中创建 `.claude/skills/clean-comments/`,把核对后的文件保存为 `.claude/skills/clean-comments/SKILL.md`。
- 在该项目根目录启动 Claude Code,在斜杠菜单中选择 `/clean-comments`。
中文摘要
检查代码注释是否帮助读者理解业务缘由或边界行为,删除重复描述,同时保留未来维护需要的上下文。
SKILL.md 中文导读
可复现示例
准备一个标签选择函数,上方分别写赋值说明和空标签在辅助技术中需要后备文字的原因。要求 clean-comments 只改注释。
`choose_label.py` · `label = raw_label or "Untitled"` · `# Assign the label`工作步骤
- 圈定文件范围,单次处理至多 15 个文件。
- 逐段检查注释,标记复述实现的内容与说明设计缘由的内容。
- 删除或精简重复处,并用差异对比确认输出符合注释清理目标。
验收方法
差异中删除 `# Assign the label`,保留辅助技术的解释与 `label = raw_label or "Untitled"` 赋值语句。
GitHub 原文 · 更新日期
适用环境
在 Claude Code 中打开练习仓库,选一个 Python 文件作为输入。先保留原始 diff,准备只比较这次注释修改。
常见问题
如何区分应保留的注释?
先看变量名和表达式能否直接告诉你发生了什么。若注释解释了界面约束、兼容需求或边界原因,保留该解释。