mcpField
T
technical-deslop

technical-deslop

github.com/vincentkoc开发11190 次安装2 天前更新
代码仓库

关于 technical-deslop

technical-deslop 是一项面向代码仓库的技能,用于整理暂存区或分支差异并保持行为不变。它帮助开发者在评审前删减冗余代码,并使改动符合仓库规范。

主要功能

  1. 01仅整理已修改代码块
  2. 02删除冗余注释和防御分支
  3. 03检查类型转换与代码风格
  4. 04除非明确要求,否则保持行为不变
  5. 05提供简短的整理说明

适用场景

  1. 01为代码评审或 PR 整理差异
  2. 02规范自动生成后的代码
  3. 03清理过度解释或风格不一致的改动

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/vincentkoc/dotskills --skill technical-deslop

安装后在 Claude Code 中输入/technical-deslop确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
playbook.md
slop-patterns.md

详细介绍

Technical Deslop

目的

清理分支和暂存区中的差异,移除 AI 风格的冗余内容,并恢复与仓库一致的风格,同时不改变行为。

使用时机

  • 差异内容解释过多、防御性过强,或与周边代码风格不一致。
  • 需要在审查或创建 PR 前进行最后一轮清理。
  • 想在自动生成代码后统一风格。

工作流

  1. 使用 git diff --cached 和 git diff $(git merge-base origin/main HEAD)..HEAD 确定范围。
  2. 只关注变更的代码块(或用户指定的文件)。
  3. 按照 references/playbook.md 中的顺序进行清理。
  4. 移除冗余注释、不必要的防御性分支、不符合惯用写法的类型转换以及风格偏差等冗余内容。
  5. 再次检查行为边界:除非用户明确要求,否则不改动逻辑。
  6. 用 1 到 3 句话简要总结所做的清理。

阅读 references/slop-patterns.md 了解检测规则,并阅读 references/playbook.md 了解执行顺序。

输入

  • 可选的文件范围(FILES)或用户明确指定的文件。
  • 当前分支差异和暂存区差异。
  • 本地说明和配置中的仓库规范。

输出

  • 清理已修改文件,同时保持行为不变。
  • 简要总结统一了哪些内容以及涉及的位置。

评论

支持 Markdown