SuperAPI AI 工具集

speckit-review-simplify

编程与开发

查看项目

更新于 10-16 03:11

技能介绍

用途:该技能面向代码简化与可维护性审查,在保留全部原有功能、输出与行为的前提下,改善代码清晰度与一致性,遵循项目既定编码规范。

主要能力:降低不必要的复杂度与嵌套层级,删除冗余代码与抽象,改进变量与函数命名,合并相关逻辑,去掉描述显而易见代码的注释;避免嵌套三元表达式,建议改用 switch 或 if/else 链;在简洁与可读性之间取平衡,不追求“行数更少”,也不做难以理解的取巧写法或把过多职责塞进单个函数。

确定改动文件:若用户已给出文件列表或明确的取文件方式,直接遵循;否则必须执行 .specify/scripts/bash/detect-changed-files.sh 并带 --json 参数检测变更文件,不要自行用 git 命令或手动读取 git 状态。脚本输出 JSON,含 branch、default_branch、mode、changed_files 等字段,会自动选择检测模式:特性分支模式以 merge-base 对比当前分支与默认分支(main/master),并叠加暂存与未暂存改动;工作目录模式在没有特性分支时回退为暂存加未暂存改动。脚本所在目录可能未纳入版本控制或被搜索索引隐藏,仍需定位并执行。

使用方式:审查范围限于本次会话中最近修改或触及的代码,除非明确要求扩大范围;审查后应用项目规范(如 .specify/memory/constitution.md、CLAUDE.md、.github/copilot-instructions.md 等等效文件),并确认功能不变、代码更简单可维护,仅记录影响理解的重要改动。

适用场景:提交前或开发过程中对新增、修改代码做简化与一致性检查,提升可读性、可调试性与可扩展性。

限制:仅提供建议,属于提示性质,不替代功能测试;不得改变代码行为;不应对范围外代码擅自重构;脚本调用方式为强制要求。