chisle-audit

Chisle Audit

扫描目标（差异、文件或仓库树），并从两个维度报告可以删减的内容。一次性完成。只读：绝不编辑、绝不写入标记、绝不应用修复。

范围

• 未提供参数 → 审查当前的 git diff（暂存区 + 未暂存区）。差异为空 → 审查 HEAD~1..HEAD。
• 提供路径 → 审查该文件或目录。
• “repo” / “whole repo” → 遍历整个目录树（跳过 vendored/generated/node_modules/dist/lockfiles）。

标记内容

代码（YAGNI 维度）：

• 重新实现标准库功能（手写 debounce、deep-clone、groupBy、重试循环、日期运算）
• 只有一种实现的抽象（针对单一情形的接口/工厂/包装器）
• 为少数几行代码或已安装的依赖就能实现的功能引入新依赖
• 永不变化的配置/选项/标记
• 没有当前调用方的“留待以后”脚手架
• 原生平台功能（CSS、DB 约束、<input type>）就能实现，却写得冗长的代码

文字（压缩维度），这是纯代码审查器常忽略的一半：

• 重述代码的注释（i += 1 // increment i）
• 充斥填充内容、含糊措辞、繁文缛节或重复内容的文档字符串/README
• 用一句精炼的话就能表达清楚，却写成多段的说明
• 只增加字数、不增加信息的装饰性表格/表情符号/标题
• 无用文字：TODO 坟场、过时的“另请参阅”链接、废弃章节

不要标记的内容

信任边界处的输入验证、防止数据丢失的错误处理、安全性、无障碍性、已有文档说明的刻意 // chisle: / // ponytail: 捷径，以及解释 原因（而不是 内容）的领域注释。

输出

按重要性排序的单一列表，最值得删减的排在最前。每行一条发现。不写开场白，不予称赞。

path:line  [code|prose]  <what's bloated> → <the lean replacement>. (~N lines/tokens)

最后以两行摘要结尾：

N findings: X code, Y prose. Est. removable: ~A lines code, ~B lines prose.
Biggest win: <the single highest-impact cut>.

不确定时如实说明：如果删减某项可能会丢失无法从片段中确认的行为，就为该项标记 (check)。优先选择数量较少、可信度较高的发现，而不是列出一长串推测。