reference-hunt

参考实现调研

有些需求过于复杂或不言自明，难以写下来，但某处已有代码实现了它们。最好的参考不是截图或描述，而是源代码。把它当作规范来阅读，然后重新实现其语义，而非语法。

步骤

1. 获取参考：仓库路径、随附目录、库名称，或底层代码可供阅读的网站。询问具体要从中提取什么——行为、结构、视觉系统、API 形式——以免模仿错了方面。
2. 阅读参考，并在编写任何代码之前整理一份语义摘要：
   • 它实现的行为和保证（时序、顺序、错误处理、边缘情况），
   • 看起来是刻意为之的设计决策与偶然形成的部分，
   • 无法迁移到目标语言或技术栈的内容，以及拟议的等效方案。
3. 请用户确认语义摘要。这是以较低成本发现误读的时机。
4. 在目标技术栈中重新实现：保持相同语义，采用原生惯用写法。不要逐行转换，也不要逐字复制许可证不允许复制的参考代码——如果许可证不明确，请注明。
5. 形成闭环：列出摘要中的每项行为及新实现如何遵循该行为，并说明任何有意偏离之处及原因。

注意事项

• 参考定义“做什么”；目标代码库的惯例定义“怎么做”。
• 如果参考本身存在缺陷或前后不一致，应指出来，而不是照搬缺陷。
• 尊重许可证：提取语义没有问题，但不能复制不兼容的代码。