关于 deslop
面向开发者的规范化代码清理技能,可审查明确选定的 Git 差异。它会分类变更、执行最小编辑、保留暂存边界,并验证结果,不创建提交或扩大范围。
主要功能
- 01选择暂存区、工作区或提交范围
- 02分类每个变更代码块
- 03执行受约束的最小编辑
- 04保留索引与暂存边界
- 05通过针对性测试验证编辑
适用场景
- 01清理暂存变更中的冗余代码
- 02审查并整理指定提交范围的差异
- 03依据范围哈希恢复清理工作
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ prathamdby/ skills --skill deslop安装后在 Claude Code 中输入/deslop确认已加载。
附带文件REFERENCE.md
详细介绍
Deslop
范围
默认检查已暂存内容(git diff --cached)。未暂存内容/工作区 → git diff;
相对于/自 以来 → 已提交的三点差异。范围冲突、
缺少基准或值不明确时,阻止执行。范围为空时绝不切换。
1. 锁定
捕获状态、选定的差异、排序后的路径、原始索引,以及
范围名称和完整差异的 SHA-256。记录
scope/hash | file | checked hunks | kept instances | verification | terminal。
范围为空 → NO_CHANGES,并指出其他层,但不触碰它们。已暂存目标
存在未暂存代码块时,阻止整个运行;以已提交内容为基准的目标存在暂存/
未暂存改动时,也阻止运行。当可编辑字节和暂存边界固定后,完成。
2. 分类
读取每个已更改文件,以及每个模块最多两个同目录的规范设定邻近文件。
对每个代码块应用 REFERENCE.md 中的全部六个类别。
记录路径/行号、主要类别、本地证据、最小原子编辑;
只有在涉及另一项编辑时,才记录次要类别。每处理完一个文件,就更新已排序文件的进度。
恢复运行时重新计算哈希;若当前工作已更改,则重新开始;仅保留未更改代码块的已完成条目。
每个代码块都覆盖六个类别后,分类完成;
没有实例时 → CLEAN。
3. 编辑
应用所有参考守则;舍弃不确定的实例。采用本地已确立的最小形式,同时保留逻辑、时序、错误、附带效应、验证、API 和有用的抽象。 未暂存内容/基准内容绝不暂存。仅当已证明原先没有预存未暂存改动时,才暂存已暂存范围内经过编辑的目标。 每个保留的实例都已消除,且除获准更新的已暂存目标外,原始索引均保持不变后,编辑完成。
4. 验证
重新检查选定的差异/状态,确认没有新增冗余代码,也没有将范围外的层级移入范围内。 可执行代码/类型/控制流/错误处理/验证/API 编辑必须运行覆盖范围最窄的测试;缺少必需测试或测试失败时,阻止执行。文档/注释/空白字符可仅通过差异审查来验证。报告范围、文件、类别计数、暂存内容保留情况、审查和测试。每项编辑和暂存不变量都得到证明后,验证完成。
终止状态:SUCCESS、CLEAN、NO_CHANGES、BLOCKED。不得提交,也不得扩大范围。