文件差异对比

要解决什么问题

代码库或文档目录里常出现同名改版、拷贝残留、仅空白/注释不同的多份文件。人工逐个打开对比成本高，diff 命令又需要你知道具体路径对。这个技能面向「给定目录或文件集合」，系统化找出重复与相似项，并把差异写进可留档的报告，而不是只在对话里贴一段文本。

技能如何工作

1. 收集范围与规则：确认对比路径、是否忽略空格/注释/编码差异，以及报告格式（默认 Markdown）。
2. 读取与对比：用 read_file 拉取目标内容；对需要精确比对的部分通过 execute_command 调用系统 diff（或等价工具）做逐文件对比。
3. 产出文件：用 write_to_file 生成 Markdown 差异报告（高亮不同之处）和 去重后文件清单/合并建议，便于你按清单执行删除或合并。
4. 交付摘要：汇总生成文件路径、关键发现与建议；可结合 note-organizer 等技能做进一步归类。

按文件类型（代码/文档/表格）可调整对比策略；验收上要求文件读全、重复检测可靠、差异展示清晰、建议可执行。

适用边界

• 报告必须落盘，不能替代你在关键变更上的最终人工确认。
• 依赖真实读取与命令输出；数据缺失时应标注「数据不可用」，不应臆造对比结果。
• 大规模目录或二进制文件可能需要你事先缩小范围或说明忽略规则。