关于 technical-deslop
technical-deslop 是一项面向代码仓库的技能,用于整理暂存区或分支差异并保持行为不变。它帮助开发者在评审前删减冗余代码,并使改动符合仓库规范。
主要功能
- 01仅整理已修改代码块
- 02删除冗余注释和防御分支
- 03检查类型转换与代码风格
- 04除非明确要求,否则保持行为不变
- 05提供简短的整理说明
适用场景
- 01为代码评审或 PR 整理差异
- 02规范自动生成后的代码
- 03清理过度解释或风格不一致的改动
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ vincentkoc/ dotskills --skill technical-deslop安装后在 Claude Code 中输入/technical-deslop确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/playbook.mdslop-patterns.md详细介绍
Technical Deslop
目的
清理分支和暂存区中的差异,移除 AI 风格的冗余内容,并恢复与仓库一致的风格,同时不改变行为。
使用时机
- 差异内容解释过多、防御性过强,或与周边代码风格不一致。
- 需要在审查或创建 PR 前进行最后一轮清理。
- 想在自动生成代码后统一风格。
工作流
- 使用
git diff --cached和git diff $(git merge-base origin/main HEAD)..HEAD确定范围。 - 只关注变更的代码块(或用户指定的文件)。
- 按照
references/playbook.md中的顺序进行清理。 - 移除冗余注释、不必要的防御性分支、不符合惯用写法的类型转换以及风格偏差等冗余内容。
- 再次检查行为边界:除非用户明确要求,否则不改动逻辑。
- 用 1 到 3 句话简要总结所做的清理。
阅读 references/slop-patterns.md 了解检测规则,并阅读 references/playbook.md 了解执行顺序。
输入
- 可选的文件范围(
FILES)或用户明确指定的文件。 - 当前分支差异和暂存区差异。
- 本地说明和配置中的仓库规范。
输出
- 清理已修改文件,同时保持行为不变。
- 简要总结统一了哪些内容以及涉及的位置。
评论
支持 Markdown