SuperAPI AI 工具集

distill

通用与其它

查看项目

更新于 10-16 06:19

技能介绍

用途:distill 是 axiom 后端质量插件中的简化技能,覆盖 DIM-5(Hygiene,卫生)与 DIM-1(Topology,拓扑)两个维度,目标是通过识别死代码、残留模式和不必要的复杂度,把代码精简到本质形态。

触发方式:用户说“simplify code”“find dead code”“clean up”,或运行 /axiom:distill;也适用于重构后的清理、降低模块认知负担。不适用场景:需要改进错误处理或安全加固时应改用 axiom:harden;性能优化不在 axiom 范围内。

主要能力与流程:先加载 @skills/backend-quality/references/dimensions.md 中的相关质量维度;再运行 axiom:scan 做确定性检查,产出机器可验证的发现,包括未使用的导出与导入、不可达代码路径、循环依赖、模块扇出过多;随后叠加人工判断的定性评估,涵盖死代码识别(return/throw 之后的不可达分支、导出但从未被导入的符号、注释掉的代码、长期关闭的特性开关代码)、残留模式检测(部分迁移导致的分歧实现、已无适配需求的适配层、已移除特性的配置)、接线简化(可简化的手动依赖注入、不必要的间接层、过度抽象的工厂/建造者模式、无价值的注册仪式)、抽象审计(过早抽象、过度工程、单次使用的辅助函数)以及代码考古(已修复缺陷的临时绕过、废弃 API 的兼容垫片、已不可能触发的防御代码)。

输出:所有发现按 @skills/backend-quality/references/findings-format.md 格式化,每条包含维度(DIM-5 或 DIM-1)、严重级别(HIGH、MEDIUM、LOW)、位置(文件与行范围)、描述与建议操作;何时简化、何时删除可参考 @skills/distill/references/simplification-guide.md,死代码检测启发式与误报指引见 @skills/distill/references/dead-code-patterns.md。

错误处理:若目标范围内无匹配文件,输出说明信息并建议用户核对路径或范围参数;若分析完成但零发现,报告干净结果而非静默失败。

限制:性能剖析与安全加固不在本技能范围内;具体安装方式、收费与平台支持情况暂未提供。