ponytail-review 是一款代码审查技能,审查范围刻意收窄,只针对“过度工程化”。它的目标不是让代码更完善,而是让 diff 更短:判断一段改动里有哪些复杂度是多余的,可以删掉。
用途 用于审查代码 diff,找出不必要的复杂度。按照资料说明,diff 最好的结果是变得更短。
主要能力
- 识别重复实现标准库的手写代码,并指出标准库中对应的函数。
- 识别依赖或代码在做平台本身已提供的事,并指出平台特性。
- 识别只有一种实现的抽象、没人设置的配置、只有一个调用方的分层。
- 识别死代码、无人使用的灵活性、臆测性功能。
- 识别可用更少行数表达的同逻辑写法。
输出格式 每条发现一行:L<行号>: <标签> <问题>. <替代方案>.;多文件 diff 用 <文件>:L<行号>: ... 的形式。 标签含义:
- delete:死代码、未使用的灵活性、臆测性功能,替代方案为“无”。
- stdlib:手写的、标准库已自带的东西,需点名对应函数。
- native:依赖或代码在做平台已做的事,需点名对应特性。
- yagni:只有一种实现的抽象、没人设置的配置、只有一个调用方的层。
- shrink:同样的逻辑用更少行数,需给出更短的写法。
资料给出的示例包括:把 27 行邮箱校验类改为用标准库一行判断、用 Intl.DateTimeFormat 替代为一次格式化调用引入的 moment.js、把只有一个实现的 AbstractRepository 内联、删除幂等本地调用外层的重试包装、用 dict(zip(keys, values)) 替代手工循环构建字典。
评分 结尾只给一个指标:net: -<N> lines possible,即可减少的行数。若没有可删内容,则输出“Lean already. Ship.”并结束。
使用方式 以代码审查技能的形式对 diff 给出上述逐行结论;资料未提供具体安装命令或调用参数。
适用场景 适合在代码合并前做“减负”审查,尤其是发现抽象过早、依赖偏多、实现重复的改动。
限制与边界 只处理复杂度问题;正确性缺陷、安全漏洞和性能问题不在此列,交由常规审查。单个冒烟测试或基于 assert 的自检属于 ponytail 的最低要求,不算臃肿,不得建议删除。该技能只列出问题,不实际应用修改。输入“stop ponytail-review”或“normal mode”可切换回详细审查风格。