deslop

移除 AI 生成的冗余代码

检查与 main 的差异，并移除分支中引入的 AI 生成冗余内容。

触发时机

完成更改后、提交前，或觉得代码过度设计时使用。

命令

git fetch origin main
git diff origin/main...HEAD --stat
git diff origin/main...HEAD

工作流

1. 运行差异命令，查看分支上的所有更改。
2. 根据下方的重点检查区域找出冗余模式。
3. 进行最少且有针对性的编辑，移除冗余内容。
4. 重新运行 git diff origin/main...HEAD，确认只移除了冗余内容。
5. 运行测试或类型检查，确认行为未变：npm test -- --changed --passWithNoTests 2>&1 | tail -10
6. 总结清理的内容。

重点检查区域

• 说明显而易见内容，或与本地风格不一致的额外注释
• 在受信任的内部代码路径中，不符合惯例的防御性 try/catch 代码块
• 仅用于绕过类型问题的 any 类型断言
• 为一次性操作设计过度复杂的抽象（过早引入辅助函数、工厂）
• 可通过提前返回简化的深层嵌套代码
• 向后兼容变通方案（重命名 _vars、重新导出、// removed 注释）
• 超出请求范围的功能、重构或“改进”
• 为未更改的代码新增文档字符串、类型注释或注释
• 针对受信任的内部路径中不可能出现的情况添加错误处理

注意事项

• 除非是在修复明确的错误，否则保持行为不变。
• 优先进行最少且有针对性的编辑，避免大范围重写。
• 三行相似代码胜过过早抽象。
• 移除内容前，先确认确实没有使用。
• 最终总结保持简洁（1 至 3 句）。

Skill 文件模式

当目标是 SKILL.md（而非代码差异）时，按照同样的冗余检查思路审查其文本。在推广技能前运行此检查。标记：

• 过时内容 - 不再符合技能当前功能的旧版本指引。删除。
• 臃肿 - 技能篇幅超过一屏，包含应移至关联参考文档的细节。将其移出：先移到技能内部的步骤，再移到技能内部的参考部分，最后放到通过指针链接的外部文件。
• 无效句子 - 删除后不会产生任何影响的句子。删除。
• 重复内容 - 同一指引在多个位置重复，导致编辑时内容逐渐不一致。只保留一个权威来源。
• 过早结束 - 方法在工作完成前就结束（提出问题，却未记录答案；完成清理，却未验证）。
• 锚点薄弱 - 没有明确的核心概念。读者无法用一个词概括的技能，其触发和执行所需的令牌也会更多。
• 缺少调用意图 - 未说明由人手动运行还是自动触发。参见 rules/skill-conventions.mdc。
• 写入操作错误 - 会改变状态的技能未说明是新增、更新还是追加，或重复运行时会重复生成输出。

**Skill 文件模式输出：**按行列出发现的问题、已应用的编辑、清理总结，以及该技能是否已准备好推广。

输出（代码模式）

• 列出发现的冗余模式及其文件位置
• 列出已应用的编辑
• 用一句话总结清理的内容