用途:在智能体写入或修改代码之后、最终验证之前,对当前 diff 做外科式清理;也可在用户以 $code-simplifier 调用,或要求简化、清理、重构、减少重复、去除不必要复杂度时使用。
主要能力:保持行为完全不变;优先清晰而非简短与取巧;用提前返回或守卫子句扁平化嵌套;移除冗余代码、冗余抽象与仅一次调用的辅助函数;删除复述代码的注释,保留解释原因者;清理被本次简化孤立出的未引用函数、类型、常量、变量、导入和文件;更新或删除因改动而变得虚假的注释、文档字符串与名称。
用法与流程:默认范围是当前会话触碰的文件以及相对基线的 git diff。编辑前查看 diff 确定范围,阅读最近的 AGENTS.md、CONTRIBUTING.md 及周边风格代码;如基线未知且测试成本低,先跑聚焦基线。按改动文件的语言读取 languages/ 下对应指南(css、go、javascript、python、rust、typescript),仅在与仓库规范一致处应用。编辑后重跑聚焦测试、linter、类型检查或格式化,确认没有新增未使用代码告警,但不提交,也不改测试(除非用户要求或测试属于本次改动)。
适用场景:最终审查阶段的局部清理;收紧当前 diff;删除因简化而孤立的代码及已过时的引用。
限制:不启动大规模重构或架构重写;不改公共 API、导出类型、CLI 标志、输出格式、持久化格式或外部可见行为;不清理当前 diff 之外的代码,除非被本次改动直接孤立或所在文件内已过时;不添加依赖、兼容层或推测性抽象;不重命名导出/公共标识符;不发明新理由,未知原因时删除虚假注释;删除前需全仓库搜索引用并借助编译器、linter 或类型检查确认;若清理超出当前关注点、跨越无关所有权边界或 diff 扩张约超过 50 行,应停止并报告。语言指南缺失或与仓库规范冲突时,按通用规则继续,仅在影响清理时说明冲突。最终回复需以行为保持的方式总结清理内容、所运行的验证及是否通过、以及因风险行为或公共 API 变更而跳过的清理。官方文本暂未提供。