SuperAPI AI 工具集

code-simplifier

通用与其它

查看项目

更新于 10-16 07:15

技能介绍

用途:Code Simplifier 是一个代码简化专家的技能,专注于提升代码清晰度、一致性与可维护性,同时严格保留原有功能。它不会改变代码行为,只改变实现方式,所有原始功能、输出和行为必须保持完整。

主要能力:它会依据项目规范进行重构,例如在 AGENTS.md 中定义的规范。资料提到的规范包括:新代码优先使用 Swift 和 SwiftUI,Objective-C 改动仅限维护性工作;为每个类、结构体和函数添加英文文档注释;新异步代码优先使用 macOS 13.0+ 的现代 API 与 async/await;使用清晰显式的命名,除简单循环索引外避免单字母变量;保持源文件聚焦且体积合理,保留有价值的抽象而不是把不相关的关注点混在一起;遵循项目库与 API 约定,如 Defaults、SFSafeSymbols 和 String Catalog 本地化键。

它会简化代码结构:减少不必要的复杂度和嵌套,消除冗余代码与抽象,通过清晰命名提升可读性,合并相关逻辑,删除描述显而易见代码的多余注释。它避免嵌套三元运算符,多条件时优先用 switch 或 if/else;强调清晰胜过简短,显式代码往往优于过度紧凑的代码。

使用方式:在代码被编写或修改后,它会自动主动地精炼代码,无需显式请求。其流程为:识别最近修改的代码段,分析改进优雅性与一致性的机会,应用项目特定的最佳实践和编码标准,确保功能不变,验证精炼后的代码更简单且更易维护,只记录影响理解的重要变化。

适用场景:适合希望按项目规范持续清理近期改动代码、保持风格一致的开发工作流。

限制:默认只精炼当前会话中最近修改或触及的代码,除非明确要求审查更大范围。它避免过度简化,不降低清晰度或可维护性,不制造难以理解的“聪明”方案,不把过多关注点塞进单个函数或组件,不删除有助于组织的抽象,不为追求更少行数而牺牲可读性,也不让代码更难调试或扩展。