SuperAPI AI 工具集

sweep

通用与其它

查看项目

更新于 10-16 01:10

技能介绍

用途:Sweep 用于发现并提议安全删除清理候选,包括死代码、孤立文件、未使用导出与依赖、重复文件、陈旧配置、被提交的构建产物,以及周期性清理计划与维护扫描。它强调证据优先于直觉、可回滚优先于速度,并以 0% 死代码率为理想基准。

主要能力:按 SCAN → ANALYZE → CATEGORIZE → PROPOSE → EXECUTE → VERIFY 流程工作。提供 dead、orphan、unused、tidy、imports、comments、types 等子命令。检测工具按语言选择:TS/JS 用 knip(npx knip --reporter compact),Python 用 vulture(vulture src/ --min-confidence 80),Go 用 staticcheck(staticcheck -checks U1000 ./...),Rust 与 Java 依据项目已装工具与配置。每条候选需至少 2 个独立信号(grep、git 历史、框架约定、配置、测试)交叉验证。置信度按引用数、文件年龄、Git 活动、工具一致性、文件位置加权评分,分为 Very High(90-100)、High(70-89)、Medium(50-69)、Low(30-49)、Very Low(0-29);仅 ≥90 才可批量删除,且每批 ≤10 个文件。删除前需建备份分支,删除后运行构建与测试,测试通过率需不低于基线。

限制:绝不直接修改代码;无用户确认不得删除;不扫描 node_modules/、.git/、vendor/、.venv/、.cache/ 等排除目录;不删除 LICENSE*、lockfile、.env*、.gitignore、.github/ 等受保护文件;删除源代码或依赖前须先询问。死代码仍可能影响全局状态,删除前须验证无副作用。孤立判断中 pages/、app/、路由文件、配置、stories 与测试属高风险误报。动态引用与框架约定优先于静态工具结果,工具输出仅视为证据而非权威。

适用场景:单 PR 变更文件与陈旧导入清理、冲刺末全量扫描与趋势对比、季度深度扫描与依赖审计。多语言单仓库且每种语言超过 500 个文件时,可并行启动语言专用扫描子代理后合并去重。

使用方式:解析用户输入首个词匹配子命令,未匹配则默认 dead;按要求输出执行摘要、分类汇总表、逐项证据(路径、类别、风险、最后修改时间、证据、建议、置信度)及清理后构建/测试验证结果。维护模式需在 .agents/sweep.md 记录 SCAN_BASELINE YAML。

未能从资料确认的内容:具体收费、价格与平台支持情况暂未提供。