用途:在 Epicenter 这类 TypeScript 框架代码库中,周期性发现重复出现的代码异味,并界定清理所需的范围。适用于定期审计、清理 PR、重构后复查,以及相关代码评审。
主要能力:按类别给出可复用的 grep 检测模式,每类附真实示例与“为何重要”的说明,帮助判断命中项是真实异味还是预期情况。涵盖的类别包括:系统边界处的鸭子类型、Promise 形状仪式(.then(() => {}))、库代码中的非结构化日志、作为联合类型变动信号的穷尽 never 检查、单方法 Pick 依赖、复制的 TypeScript 边界形状、非穷尽联合折叠(该用 switch 却用 if/else)。同时列出经测试判定为“非异味”的项,避免误报。
使用方式:对相关范围(单个包、整个 monorepo 或近期改动文件)运行对应 grep;对每个命中项阅读上下文约 ±5 行,判定为合理、需重构或误报;按类别与影响分组后再修复,避免零散逐个改;在单个 PR 中连同审计日志记录修复。相关技能包括 post-implementation-review、refactoring、one-sentence-test、define-errors、logging。
适用场景:TypeScript 框架代码库的周期性审计、清理 PR、重构后复查。
限制:这些类别针对特定代码库验证,并非通用风格建议;部分检测模式存在规避情况(如直接调用 consoleSink 或在 warn/error 中传入 new Error),需额外 grep;资料未提供安装命令、收费、价格或平台信息。