SuperAPI AI 工具集

deslop

编程与开发

查看项目

更新于 11-13 11:35

技能介绍

Deslop 是一个专注于清理代码库中冗余内容的技能,其核心目标是移除那些制造工作但不服务于支持目的的冗余材料,并整合属于同一概念的内容,使所选系统更易于理解、操作和维护。

用途

Deslop 用于识别和清理“slop”——即不必要的、冗余的、推测性的或过时的材料,这些材料具有可证明的成本,例如误导性指导、相互竞争的权威、可避免的间接性、重复调查或无有用行为的维护。该技能强调,AI 来源、年龄、大小、文件数量和个人品味本身并不构成成本证据。无论创建者是谁,都应保留合理的设计和有用的文档。

主要能力

  • 理解所选系统:通过有界搜索检查作者来源,构建紧凑的系统地图,涵盖目的、所有权、行为、操作和知识等方面。
  • 选择有证据支持的清理项:针对每个候选,先确定所需行为,再判断其实现。优先删除而非简化,当删除能保留所需契约时。
  • 处理逻辑与结构:移除推测性层、未使用配置和一次性抽象,但仅在它们不提供支持价值时。应用删除测试于传递包装器。合并共同变化的内聚概念和共享不变量到其现有所有者。
  • 处理命名:每个概念使用一个规范领域术语,不同概念使用不同术语。仅在结果能消除歧义时重命名,避免同义词频繁变动。
  • 处理文档、注释和代理指导:保留有意义的理由、约束、例外、恢复步骤、精确命令、格式、许可证和工具指令。移除通用教程、明显叙述、过时计划、报告、占位符和冗余指令,但仅在证据表明它们不必要时。将具有相同受众、生命周期和权威的指导合并到其权威所有者。
  • 处理测试:识别每个受影响测试保护的行为。移除无法检测合理实现缺陷的同义反复。在删除测试前,证明其行为已过时或确定保留的测试覆盖了它。绝不仅仅为了使检查通过而移除失败或不稳定的测试。
  • 证明移除并执行:在删除源代码、行为或工件之前,检查其实际消费者,包括导入、导出、运行时注册、构建配置、模式、生成消费者、公共接口、持久化格式、外部调用者、支持的兼容性和迁移、操作恢复路径和回退行为。仅缺少文本引用不足以证明死代码。

使用方式

用户指令优先于该技能的默认设置。应用现有授权而无需再次询问。使用提供的显式路径或分配的仓库,否则使用当前仓库。阅读适用指令并识别受保护文件、生成源、所有权和所需协调。保持未分配依赖在写入范围之外。将清理调用视为对本地可逆编辑的授权,包括有证据的过时源代码和文档移除。遵守现有的破坏性操作和外部写入边界。对于仅评估请求、计划模式或 --dry-run,仅检查并报告而不编辑文件。对于文档或设计清理,完成授权的文档更改,将运行时更改标记为提议。如果某项操作缺乏授权,在请求该操作之前准备具体候选和证据,同时继续独立的授权工作。在编辑之前,说明所选边界、材料假设和验证目标。自行解决可发现的事实。不要计划后添加默认批准检查点。

适用场景

Deslop 适用于需要清理代码库、移除冗余内容、整合相关逻辑和指导、淘汰过时行为的场景。特别适用于用户请求执行“deslop”或类似清理任务时。也适用于文档或设计清理,以及整个仓库的清理请求。

限制

该技能不适用于仅评估请求、计划模式或 --dry-run 场景下的文件编辑。它要求有证据支持清理决策,不能仅凭 AI 来源、年龄、大小、文件数量或个人品味判断冗余。在删除源代码、行为或工件之前,必须检查实际消费者。如果使用情况未知,应保留候选直到解决,并报告确切的不确定性和解决所需的证据。不要仅仅为了使检查通过而移除失败或不稳定的测试。不要添加推测性框架、文档系统或清理过程。不要为常规进度创建自定义账本、持久报告或辅助工件。报告时需区分文档更改与提议的运行时工作,披露失败、跳过和未运行的检查,不得虚构节省或强加清理配额。