用途:让代码在半年后被人冷启动阅读时也能几秒看懂。适用于用户希望简化代码、提升可读性的场景。
主要能力:按顺序执行多轮处理——扁平化控制流(用提前返回和守卫子句替代嵌套条件);去除噪音(删除复述代码的注释、冗余类型标注、一次性中间变量,仅保留解释“为什么”的注释);简化逻辑(合并琐碎 if/else、用 map/filter/first 等替代布尔标志、内联一次性短辅助函数);改进命名(避免 data、result、temp 等模糊名,遵循语言命名约定);把声明移到首次使用附近;拆分做多件事的长函数。
使用方式:需生成子代理执行审查,只传入这些指令和目标文件,让代理从干净上下文开始。若用户未指定文件或目录,先询问要审查什么。代理应直接修改而非列建议,批量编辑,编辑后尽可能运行项目的 lint 或构建命令验证仍可编译/解析,最后简要列出改动。
限制:不新增原本没有的注释、文档字符串或类型标注;不重构架构或跨模块移动文件;不更改公共 API 签名(除非名称严重误导);不追求取巧。若拆分需传递大量参数或逻辑深度交织,则不强行拆分,仅标记为可读性问题。所有改动须保留原有功能与行为。具体支持语言、安装方式与平台暂未提供。