SuperAPI AI 工具集

lean-review

设计与创作

查看项目

更新于 10-16 09:30

技能介绍

用途:lean-review 用于保守式简化审查,核心问题是“每处结构现在是否值得其成本”。它不是为极简而极简,不会移除能实质提升可读性、命名、局部推理或所有权边界的结构。

主要能力:审查变更文件、邻近接口及相关测试或文档,区分必要结构、当前即回本的可读性结构、以及为假设未来而加的推测性低价值结构。信号包括:当前行为未真正使用的额外数据库列、JSON 字段、DTO 属性或配置键;主要转发调用而不改善命名、边界或复用的辅助函数或包装器;为想象未来添加的扩展点、策略对象、插件钩子或标志;强制重复映射的泛化抽象;单一具体路径却多层间接;实际仅一种有效情况的选项、枚举或模式开关;无具体消费者、生产者或不变量的状态或持久化;增加查找而非理解的模块拆分或目录嵌套。

使用方式:先锚定真实代码,阅读变更文件、邻近接口和受影响测试或文档;再检查结构是否回本,问额外层现在带来什么,如更清晰命名、更强类型边界、更清晰所有权边界、减少重复分支或胶水代码、更简单不变量、隔离外部细节、更清晰文件级理解。若答案薄弱或假设性,则视为简化候选。保持高简化门槛:不因抽象就建议移除,不惩罚显式代码,不把可读性结构当浪费。

输出结构:Findings 列出有代码支持的具体推测性或低价值复杂度问题,说明为何当前不回本,必要时嵌入短片段;Keep As-Is 指出看似重但值得保留的选择及其当前收益;Simplification Candidates 仅含达标改动,说明最小合理简化、移除或合并什么、获得什么、可能失去什么、为何现在合适或不合适;Open Questions 列出可能证明当前形状合理的缺失约束或未来需求;Verdict 以“Already lean enough”“Small simplification is justified”或“Broader simplification may help, but only after clarifying constraints”结尾。片段规则:优先嵌入片段而非编辑器行号,首行注释写源文件路径,保持紧凑。沟通规则:直接具体,默认最小有用建议,区分可读性收益与推测性复杂度,若已足够精简就明说,弱支持担忧标为观察项,不制造简化机会。

适用场景:用户问“这是否过度工程”“是否真需要这些额外字段和辅助函数”“能否审查此 diff 的推测性代码或不必要抽象”“希望实现保持精简,应移除什么”“检查新 schema 和辅助层是否回本”。

限制:资料未提供安装命令、平台支持、收费或价格信息;具体使用方式依赖技能运行环境,暂未提供。