用途:ln-review 用于审计代码质量,探索代码库并指出结构性改进机会,强调观点明确。适合在一轮密集开发之后,当代码库结构需要检查时使用。
主要能力:以 Ousterhout 的深度测试审视模块,判断接口小但隐藏复杂度的模块是否合格;用删除测试识别浅模块;把接口视为测试面,检查调用方或测试是否被迫绕过接口;执行接缝纪律,通常一个适配器只是假设接缝,两个适配器才构成真实接缝;检查函数核心与命令外壳边界,标记纯函数出现副作用或参数膨胀;追求让无效状态不可表示,拆分可选字段并用品牌类型区分领域值。
资料还描述命名与 oracle 覆盖检查:若存在 memory/SPEC.md,会检查其中 §Lexicon 术语在符号、注释、文件路径与文档中的一致性,并把偏差按命名分类记录;若存在 §Oracle Strategy by Loop Tier,会核对近期工作是否实现了 memory/PLAN.md 前沿定义中声明的 oracle,例如 schema 校验、差分 oracle、往返 oracle,以及被承认盲点是否需要升级为需要 oracle。
使用方式:输入为 $ARGUMENTS,指定要审查的范围;若为 "recent" 或未指定,则聚焦最近修改的文件。先读 memory/SPEC.md,使用其词汇表与架构登记;触及活跃前沿工作时读 memory/PLAN.md;若相关区域存在 ADR 或设计文档,作为支持性上下文,但不默认新增 ADR 或旁路决策日志。输出编号候选发现,普通发现用紧凑格式,深模块或弱接缝机会用深化候选格式,并推荐影响最高的改进。
限制:ln-review 不提出详细接口设计,选定的深化候选应路由到 ln-design,再进入 scoping 或重构;资料未提供独立的收费、价格、平台或效果信息。