用途:review-simplicity 是一个只读的代码审查技能,专门找出比实际需要更复杂的代码,识别过度工程、过早抽象、过早优化、镀金功能与不必要的认知复杂度,并建议更简单的替代写法。
主要能力:按严重程度分类报告问题,包括推测性通用化、框架套框架、配置驱动一切、过早抽象、过深继承、工厂的工厂、参数过多、无必要设计模式、过早优化、包装器综合征、接口爆炸等;输出包含范围、状态、总体评估、各级问题、统计与前三项简化机会的报告。
使用方式:先确定审查范围,用户指定文件或目录则审查这些路径,否则默认对比 origin/main 或 origin/master,例如 git diff origin/main...HEAD && git diff;范围不明确或无变更时先向用户确认。审查时读取完整文件而非仅看 diff,评估复杂度、做 YAGNI 检查、审计抽象层,并通过可操作性过滤。
适用场景:适合在代码评审中检查某次改动是否引入不必要的复杂度,或按用户指定路径审计既有代码。
限制:该技能为只读,不修改任何代码;默认只报告本次改动引入的简单性问题,既有复杂度不在范围内,除非用户明确指定路径。只报告高置信度、确实无价值且能给出具体更简单替代方案的问题;不处理 bug、DRY 违规、死代码、类型安全、文档、测试覆盖与 AGENTS.md 合规等,这些由其他技能负责。不虚构问题,代码足够简单时直接报告无问题。