SuperAPI AI 工具集

code-simplify

编程与开发

查看项目

更新于 10-16 03:16

技能介绍

用途:对最近修改的代码做简化,清理、重构以提升清晰度、降低复杂度、改善可读性与可维护性,同时保持行为、公开契约与副作用不变。默认执行完整简化流程并输出报告。

主要能力:解析作用范围(指定路径、模式、提交/范围或自然语言子集;否则仅限本会话修改的文件,再回退到全部未提交文件);建立行为基线,识别不可变的函数签名、导出 API、状态转换、副作用、持久化/网络行为与错误语义;按控制流、命名与意图、重复、数据塑形、类型与契约清晰度依次应用简化;执行安全约束,如不擅自同步转异步、不改错误传播策略、不删除日志/遥测/守卫/重试;最后做验证与报告。

使用方式:参数可传路径、模式、提交/范围或范围短语;--no-report 跳过完整报告,返回简要工作笔记;--no-verify 跳过验证(由上层编排器另行验证)。默认执行完整简化、验证被触及行为并输出完整报告。需在 git 仓库中运行,先执行 git rev-parse --git-dir 校验。

适用场景:清理近期改动、重构提升可读性、降低复杂度、整理命名与意图、消除明显重复。

限制:不改变运行时行为;优先项目既有约定;只做小而可逆的编辑;不添加未要求的功能或抽象;只清理自身改动产生的无用代码;生成、vendored、批量与低信号文件默认排除,除非明确要求;遇到需改公开 API、需求不清、无法确认行为一致、代码因领域约束而有意复杂、或范围暗示更大重构时应停止并询问。验证运行最窄检查(格式化/lint、针对性测试、类型检查、不变量检查),并说明跳过的检查及原因。具体收费、价格、平台与效果资料暂未提供。