SuperAPI AI 工具集

crank-deslop

编程与开发

查看项目

更新于 10-15 20:12

技能介绍

用途:crank-deslop 在一个声明的代码范围内,生成一份精简的修复计划,目标是清理 AI 写代码留下的残留(slop)、可让整段分支或层级消失的结构重构(code-judo),以及代码已经不再需要的注释、docstring 和相关文档。

主要能力:它并行派出三个查找器,分别对应三个层级——slop(依据 SLOP-BRIEF.md)、结构(依据 STRUCTURE-BRIEF.md)、文字(依据 PROSE-BRIEF.md),各自对全部范围读一遍。计划强调高置信度的可执行改动而非罗列观察,但文字部分是例外:每一处非承重的注释或 docstring 都会成为一行。硬性规则包括:接受计划前保持只读;除明确标注的 bug 修复外不得改变行为;不做 linter 能抓到的事或口味之争;信任边界校验、数据丢失与错误路径、安全检查、无障碍特性属于必需行为,不删。

使用方式:先声明范围,四种形态之一——PR(gh pr view <n> --json headRefName,baseRefName 后 gh pr diff <n>)、分支差异(git diff <default-branch>...HEAD,必要时加 git diff HEAD 与 git status --short 的未跟踪文件)、逻辑区域(用 git ls-files <path> 清点)、整个代码库(git ls-files)。随后派发查找器、合并各层结果并渲染计划,向用户呈现后询问是全部应用还是部分应用;结构级的大改动可改为 /crank plan 交接。获批后应用,结构改动逐个进行、slop 清理批量进行,最后跑项目的格式、lint、类型检查和测试并修复造成的破坏。

适用场景:清理 agent 生成的代码库、做减法式重构、梳理过时注释与文档。

限制:计划阶段只读;需要用户先指定范围,否则先询问;计划不含 linter/编译器/格式化器能发现的问题;必需行为不可删除。具体模型层级解析方式、指令文件偏好等细节请参见其引用的 SUBAGENT-TIERS.md 等文档。