SuperAPI AI 工具集

code-refiner

编程与开发

查看项目

更新于 10-16 00:20

技能介绍

用途:将复杂、冗长或纠缠的代码重构为清晰、地道、可维护的实现,且不改变代码行为。核心原则是行为等价、降低认知负担、提升维护杠杆;清晰优先于简短。

主要能力:按五阶段工作流执行——侦察(确定范围、识别语言与生态、读取项目约定、了解测试覆盖、记录复杂度基线)、结构分析(按严重度分类死代码、冗余操作、深层嵌套、上帝函数、重复代码、命名不清等问题)、重构执行(删除冗余、扁平化结构、提取与命名、运用语言惯用法、收紧类型)、验证(跑测试、跑 linter/类型检查、手工追踪、副作用审计)、报告(按文件列出改动、复杂度变化与风险评估)。

使用方式:默认 standard 模式,也可指定 quick、standard、deep、surgical 四种模式控制范围与严重度阈值。范围未指定时可用 git diff --name-only HEAD~5 或 git diff --staged --name-only 检测。量化复杂度需 Python 3.10+ 运行 scripts/complexity_report.py。语言惯用法参考 references/python.md、go.md、typescript.md、rust.md。

适用场景:Python、Go、TypeScript、Rust 代码的日常清理与重构。

限制:绝不改变可观察行为、不删除错误处理、不引入新依赖、不越界重构、保持公共 API、尊重现有测试;无测试的深度重构建议先写测试;自动生成代码应改生成器;热路径简化需权衡性能。验证要求 linter 与类型检查通过,如 ruff check + mypy --strict 或 tsc --noEmit + eslint。