SuperAPI AI 工具集

find-similar

编程与开发

查看项目

更新于 10-16 06:19

技能介绍

用途:在代码库中查找相似或类比性的代码模式,回答“我们是否在别处做过类似的事”“哪些现有模式与之匹配”等问题。该技能是事实性的、非规定性的,只帮助发现并报告已存在的内容,不推荐是否使用、忽略或修改所找到的结果。

主要能力:区分四类相似性——词法相似(相同名称、关键字、标识符)、结构相似(代码形状相同但命名不同)、类比相似(不同领域中的相同角色)、概念相似(相同目的但可能采用不同方法)。提供分级搜索策略:1 直接搜索,搜索目标本身或明显变体;2 同级/对等发现,查找承担相同角色的文件;3 引用追踪,沿依赖图追踪定义与使用者;4 概念扩展,用同义词、相关术语和跨领域类比拓宽搜索。

使用方式:借助 Grep、Glob、Read、Bash(git 命令)等工具执行搜索。开始前先确定哪种相似类型重要,从窄范围起步,必要时逐步扩大,不要一开始就搜索整个代码库;利用文件组织作为信号,同级文件常揭示本地约定;git 历史可帮助发现常一起变更的相关文件。

结果记录:对每项发现记录位置(文件路径与行范围)、相似类型、置信度(高:精确或近乎精确匹配;中:结构或目的相似但存在差异;低:概念相关或部分匹配)、相似原因简述。影响因素包括同一目录/领域、相同命名约定、相同导入/依赖会提高置信度,结构或方法不同则降低。对于否定结果,记录搜索过的内容以便核查覆盖范围。

适用场景:需要复用现有实现、保持代码一致性、寻找参考模式或理解局部约定时。

限制:该技能只发现和报告,不判断优劣、不给出采用建议,也不保证搜索覆盖完整;搜索范围与置信度依赖使用者对相似类型的判断。资料未提供安装命令、收费、价格或平台等信息。