ByteFlow
← 全部笔记
NOTE 02 / 工具手记

让一个工具,只做好一件小事

从一次重复操作出发,而不是从一张功能清单出发。

一个工具的开始,可以非常具体:把几份文件按规则改名,将一段杂乱的文本整理成表格,或者从一堆记录里找到某个时间点。

问题足够小,输入和输出就容易说清楚。工具有没有帮助,也不需要复杂的指标:下一次遇到同样的事情,是否愿意再次打开它?

先想清楚输入与输出

动手之前,先写一组例子。输入是什么样,输出希望变成什么样;遇到空内容、重复项或不认识的格式时,又应该发生什么。

这些例子不仅帮助实现,也能成为日后修改时的参照。它们比“支持各种情况”这样的目标更加具体。

让操作容易预览

如果工具会修改文件,可以先显示准备修改的内容,再执行实际动作。比如改名工具先列出旧文件名与新文件名,让人一眼看出规则是否符合预期。

  • 一次只处理一个明确的范围。
  • 让输入路径和输出位置清楚可见。
  • 遇到冲突时说明原因,不悄悄覆盖。

给简单留一点空间

工具好用之后,很容易继续增加功能。新的需求当然值得记录,但不必立刻合并进去。有些工作适合由另一个小工具完成,再通过文件或文本连接起来。

少一个选项,有时意味着少一次犹豫。

一个小工具的价值,可以只是稳定地省下几分钟。它不一定需要变成一个平台。