SuperAPI AI 工具集

defrag

通用与其它

查看项目

更新于 10-20 09:51

技能介绍

defrag 是一个整理类技能,用于把某一机制、概念或职责重新梳理清楚,使实现、说明和目录归属彼此对应。其目标是降低理解、查找和修改成本,保留仍有效的行为、设计意图和必要依据;删除数量或目录整齐度并不是目标。

主要产物是清楚的维护归属,以及闭合的入口、引用和实现关系。整理过程可能暴露设计问题,但不能用合并文件、删除名称或移动目录来代替判断某份责任是否仍然需要。

主流程分为四步。一是界定问题:从用户请求中确定一个待回答的问题、范围、必须保留的行为和交付结果;大范围工作先选一个能独立闭合的局部,不必先建立全仓地图。二是恢复关系:找到实际入口、消费者、维护位置、注册或动态加载、构建发布及相关说明,先读能改变当前判断的片段,区分当前实现、目标设计、派生视图、生成物和历史依据。三是判断碎片:用来源证据判断对象是残留、重复、分散还是错位,同时记录最有力的保留理由、影响和未知;没有引用、很久未改或文件很短都不足以证明失效。四是处置并收束:用户只要求 review 时交付发现和建议,要求整理时执行最小的完整修改,补齐入口、引用、构建和测试关系,并沿同一问题复查,说明已确认、未确认和验证边界。

支持文档按需读取:判断证据和归属时读 evidence.md,组织交付内容时读 report.md,实际改动时读 change-and-verify.md。这些是操作参考,不是项目权威文档;项目级约定以当前仓库的 AGENTS.md、模块 README 和实际源码为准,不应加载与问题无关的整套文档。

不变量包括:保留他人的未完成改动,修改前后检查工作区状态和差异;不删除用户数据、未确认失效的入口或仍承担回归价值的测试;实现证明当前行为,设计说明目标,两者冲突时核对迁移状态;机械检查、运行时观察和用户验收分别报告,没有证据就保留未知。已授权的局部整理可直接推进,只有超出范围、改变公开契约或涉及不可逆动作时才停在边界说明。

完成条件:原问题可回到负责位置、相关引用已闭合、必要修改和验证完成,并写清未决依赖与重开条件。若发现新的产品需求或更大范围争议,记录关联而不在本轮扩张范围。需要决定各单元职责或组合拆分时可按需使用 architecture;既有机制的必要性或核心选择被反例击穿时使用 design-forge,不要先清理再论证;争议涉及重复校验保护不同边界还是误阻工作时使用 assurance-review。